Edit

Share via

Download assets by using Azure Pipelines

  • Article

You can automate the download of assets from the Asset library in Microsoft Dynamics Lifecycle Services by using the Dynamics Lifecycle Services Asset Download task in Azure DevOps.

This article assumes that you have a working knowledge of Azure Pipelines.

Note

Before you can add these steps to a pipeline, the Dynamics 365 finance and operations Tools extension for Azure DevOps must be enabled and installed in the Azure DevOps organization. For more information about how to install an extension for an organization, see Install extensions.

Note

Versions 1.* and lower of the task are obsolete. Update the task version to the latest available.

Note

(Not required for Version 2.* and later.) Only Version 1.* of the download task requires availability of the MSAL.PS PowerShell library. A task is available to automatically install the tools during pipeline execution. This task can be added anywhere in the stage before the download task. For more information, see Add the MSAL.PS install task to a pipeline.

Add the task to a pipeline

To add the task to the build of your YML or Classic pipeline, search the task list for Dynamics Lifecycle Services Asset Download.

The following table describes the options that are available for this task.

Input name Mandatory Description
Lifecycle Services Connection Yes Select or create a service connection to Lifecycle Services. For more information, see Create an Lifecycle Services connection in Azure Pipelines.
Lifecycle Services Project ID Yes Enter the ID of the project in Lifecycle Services that contains both the asset to deploy and the target environment. You can find the project ID at the end of the URL of your project's dashboard.
Path to download to Yes Enter the path to download the asset to.
Search Pattern Yes Select the type of search pattern that should be used to find the asset in the Asset library in Lifecycle Services. Depending on the value that you select, the following options are available:
  • Asset ID (guid) – If you select this value, in the Lifecycle Services File Asset Id(s) field, enter the asset ID or a semicolon-separated list of asset IDs. Asset IDs are globally unique identifiers (GUIDs).
  • Name – If you select this value, in the Lifecycle Services File Asset Type field, select the asset type. Then, in the Lifecycle Services File Asset Name field, specify the name to search for. You can use an asterisk (*) as a wildcard character in the name. For example, you might enter MyPackage*.

After a successful download, an output variable can be used to capture a list of the file paths. If there are multiple files, a semicolon-separated list of file paths is assigned to the output variable. For more information about output variables in Azure DevOps, see Use output variables from tasks.