SharePoint Build and Release Tasks
This extension includes a group of tasks that leverages SharePoint and O365 functionalities for build and release. Note: This project is used with GitHub and VSTS projects features. Where GitHub is used for code and issues, but the complete build pipeline is hosted on VSTS in the background.
Content:Task: Deploy SharePoint ArtifactsTask: PnP PowerShellTask Deploy SharePoint ArtifactsDeploys SharePoint artifacts (e.g. lists, fields, content type...) with the publish PnP PowerShell, which uses the PnP Provisioning Engine. This task works mainly in the same way as described in the documentation of the PnP PowerShell cmdlet Apply-PnPProvisioningTemplate. This PowerShell task allows you to use PnP PowerShell, which will be loaded prior executing any script. The newest releast modules are downloaded from the official PSGallery feed, if not present on the agent. Mandatory FieldsFirst the SharePoint version has to be chosen.
Then you need to fill the web URL to deploy the artifacts to the chosen web and the credentials which have the permissions to do the changes.
Next, you choose if you want to use a file from your build or if you want to use inline xml. A specific xml schema is expected which is parsed by the PnP provisioning engine.
You can include the following XML, which changes the title of the connected web Optional FieldsHandler To Be UsedThen you can optionally give a comma separated list of Handlers (e.g. Lists,Fields). Leave empty if all Handlers should be used. This Allows you to only process a specific part of the template. Notice that this might fail, as some of the handlers require other artifacts in place if they are not part of what your applying. Check for available Handlers. Parameters To Be AddedThe field "Parameters To Be Added" allows you to specify parameters that can be referred to in the template by means of the {parameter:} token. use only one parameter-value pair per line. Example:
See examples on how it works internally. Advanced ParametersClearNavigationOverride the RemoveExistingNodes attribute in the Navigation elements of the template. If you specify this value the navigation nodes will always be removed before adding the nodes in the template. Ignore Duplicate Data Row ErrorsIgnore duplicate data row errors when the data row in the template already exists. Overwrite System Property Bag ValuesSpecify this parameter if you want to overwrite and/or create properties that are known to be system entries (starting with vti_, dlc_, etc.) Provision Content Types To Sub WebsIf set content types will be provisioned if the target web is a subweb. Task PnP PowerShellThis task is inspired by the official PowerShell task for VSTS. The source code is located in GitHub. This PowerShell task allows you to use PnP PowerShell, which will be loaded prior executing any script. The newest releast modules are downloaded from the official PSGallery feed, if not present on the agent. Mandatory FieldsFirst the SharePoint version has to be choosen.
Next, you choose if you want to use a file from your build or if you want to use inline PowerShell. The correct PnP PowerShell library is downloaded and imported automatically.
When the type is choosen, the file or inline PowerShell must be a valid PowerShell. An Example is provided in the following code, where $(UserPassword) and $(UserAccount) must be previously created variables. Optional FieldsErrorActionPreferencePrepends the line $ErrorActionPreference='VALUE' at the top of your script. Possible values are 'STOP', 'CONTINUE' or 'SILENTLYCONTINUE'. Advanced ParametersFail on Standard ErrorIf this is true, this task will fail if any errors are written to the error pipeline, or if any data is written to the Standard Error stream. Otherwise the task will rely on the exit code to determine failure. Working DirectoryWorking directory where the script is run. Change Log2.1.0Minor
2.0.0Mayor changes
1.1.42Minor
1.1.36Bug Fixes
1.0.0
0.1.0
|
