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.
If you need instructions on creating a scenario, see Create a scenario in Adobe Workfront Fusion.
For information about modules, see Modules in Adobe Workfront Fusion.
Access requirements
You must have the following access to use the functionality in this article:
To find out what plan, license type, or access you have, contact your Workfront administrator.
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. -
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 in Adobe Workfront Fusion.
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
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.
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.
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.
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.
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.