Azure DevOps modules
In an Adobe Workfront Fusion scenario, you can automate workflows that use Azure DevOps, as well as connect it to multiple third-party applications and services.
For instructions on creating a scenario, see the articles under Create scenarios: article index.
For information about modules, see the articles under Modules: article index.
Access requirements
You must have the following access to use the functionality in this article:
| table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header | |
|---|---|
| Adobe Workfront package | Any |
| Adobe Workfront license |
New: Standard Or Current: Work or higher |
| Adobe Workfront Fusion license** |
Current: No Workfront Fusion license requirement. Or Legacy: Workfront Fusion for Work Automation and Integration |
| Product |
New:
Or Current: Your organization must purchase Adobe Workfront Fusion. |
For more detail about the information in this table, see Access requirements in documentation.
For information on Adobe Workfront Fusion licenses, see Adobe Workfront Fusion licenses.
Prerequisites
To use Azure DevOps modules, you must have an Azure DevOps account.
Azure DevOps API information
The Azure DevOps connector uses the following:
Connect Azure DevOps to Workfront Fusion connect-azure-devops-to-workfront-fusion
-
Add an Azure DevOps module to your scenario.
-
Click Add next to the Connection field.
-
In the Connection Type field, select Azure DevOps.
note important IMPORTANT The Azure DevOps (Request All Scopes) connection type will be deprecated in the near future. Therefore, we do not recommend using it. -
Fill out the following fields:
table 0-row-2 1-row-2 layout-auto html-authored no-header Connection name Enter a name for the connection that you are creating. Organization Enter the name of the organization under which you created your Azure DevOps application. -
To enter an Azure DevOps App ID or Client Secret, click Show advanced settings and enter them in the fields that open.
-
Click Continue to finish setting up the connection and continue creating your scenario.
Azure DevOps modules and their fields
When you configure Azure DevOps modules, Workfront Fusion displays the fields listed below. Along with these, additional Azure DevOps fields might display, depending on factors such as your access level in the app or service. A bolded title in a module indicates a required field.
If you see the map button above a field or function, you can use it to set variables and functions for that field. For more information, see Map information from one module to another.
Triggers
Watch for work items
This instant trigger module executes a scenario when a record is added, updated, or deleted in Azure DevOps.
The module returns any standard fields associated with the record, along with any custom fields and values that the connection accesses. You can map this information in subsequent modules in the scenario.
When you are configuring this module, the following fields display.
Actions
Create a record
This action module creates a new project or work item.
The module outputs the object ID for the newly created work item, or the URL and status code of a newly created project.
Custom API Call
This action module lets you make a custom authenticated call to the Azure DevOps API. This way, you can create a data flow automation that can’t be accomplished by the other Azure DevOps modules.
When you are configuring this module, the following fields display.
Enter the relative URL that you want to connect to for this API call.
Example: {organization}/_apis[/{area}]/{resource}
Add the headers of the request in the form of a standard JSON object.
For example, {"Content-type":"application/json"}
Add the query for the API call in the form of a standard JSON object.
For example: {"name":"something-urgent"}
Add the body content for the API call in the form of a standard JSON object.
Note:
When using conditional statements such as if in your JSON, put the quotation marks outside of the conditional statement.
Download an attachment
This action module downloads an attachment.
The module returns the file content of the attachment.
Link work items
This action module links two work items and defines the relationship between them.
Read record
This action module reads data from a single record in Azure DevOps.
You specify the ID of the record.
The module returns the ID of the record and any associated fields, along with any custom fields and values that the connection accesses. You can map this information in subsequent modules in the scenario.
When you are configuring this module, the following fields display.
Update a work item
This action module updates an existing work item using its ID.
The module returns the ID of the updated work item.
Upload an attachment
This action module uploads a file and attaches it to a work item.
The module returns the attachment ID and a download URL for the attachment.
Searches
List work items
This action module retrieves all work items of a specific type in an Azure DevOps project.
The module returns the ID of the main work item and any associated fields, along with any custom fields and values that the connection accesses. You can map this information in subsequent modules in the scenario.
When you are configuring this module, the following fields display.