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:

Adobe Workfront plan*
Pro or higher
Adobe Workfront license*
Plan, Work
Adobe Workfront Fusion license**

Current license requirement: No Workfront Fusion license requirement.

Or

Legacy license requirement: Workfront Fusion for Work Automation and Integration

Product

Current product requirement: If you have the Select or Prime Adobe Workfront Plan, your organization must purchase Adobe Workfront Fusion as well as Adobe Workfront to use functionality described in this article. Workfront Fusion is included in the Ultimate Workfront plan.

Or

Legacy product requirement: Your organization must purchase Adobe Workfront Fusion as well as Adobe Workfront to use functionality described 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.

Connect Azure DevOps to Workfront Fusion connect-azure-devops-to-workfront-fusion

  1. Add an Azure DevOps module to your scenario.

  2. Click Add next to the Connection field.

  3. 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.
  4. 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.
  5. 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.

Webhook

Select or add a webhook for the module.

For more information on webhooks in trigger modules, see Instant triggers (webhooks) in Adobe Workfront Fusion.

For information on how to create a webhook, see Webhooks.

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.

Connection
For instructions about connecting your Azure DevOps account to Workfront Fusion, see Connect Azure DevOps to Workfront Fusion in this article.
Base URL
Select or map the base URL that you use to connect to your Azure DevOps account
Relative URL

Enter the relative URL that you want to connect to for this API call.

Example: {organization}/_apis[/{area}]/{resource}

API Version
Select or map the version of the Azure DevOps API that you want to connect to for this API call. If no version is selected, Workfront Fusion connects to Azure DevOps API version 5.1.
Method
Select the HTTP request method you need to configure the API call. For more information, see HTTP request methods in Adobe Workfront Fusion.
Headers

Add the headers of the request in the form of a standard JSON object.

For example, {"Content-type":"application/json"}

Query String

Add the query for the API call in the form of a standard JSON object.

For example: {"name":"something-urgent"}

Body

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.

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.

Connection
For instructions about connecting your Azure DevOps account to Workfront Fusion, see Connect Azure DevOps to Workfront Fusion in this article.
Record type

Select whether you want to read a project or a work item

  • Project: Select the project that you want to read..

  • Work item: Select the project that contains the work item you want to read, then select the work item type.

Outputs
Select the information you want included in the output bundle for this module. Available fields depend on the work item type.
ID
Enter or map the ID of the record you want to read.

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.

Connection
For instructions about connecting your Azure DevOps account to Workfront Fusion, see Connect Azure DevOps to Workfront Fusion in this article.
Record type

Select whether you want to create a work item or a project.

  • Project

    Fill in the following fields:

    • Name:Enter or map a name for the new project.

    • Description:Enter or map a description for the new project.

    • Visibility: Select whether you want your project to be public or private. Users must be signed into your organization and must have been granted access to the project in order to interact with a private project. Public projects are visible to users who are not signed in to your organization.

    • Version control: Select whether you want the project to use Git or Team Foundation Version Control (TFCV) for version control.

    • Work item process: Select the work process that you want to use for the project. Options are Basic, Scrum, Capability Maturity Model Integration (CMMI), and Agile.

      For more information on Azure DevOps processes, see Choose a Process in the Azure DevOps Documentation.

  • Work item

    Fill in the following fields:

    • Project: Select the project where you want to create the work item.

    • Work item type: Select the type of work item you want to create.

    • Other fields:In these fields, enter the value that you want the work item to have for a given property. Available fields depend on the work item type.

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.

Connection
For instructions about connecting your Azure DevOps account to Workfront Fusion, see Connect Azure DevOps to Workfront Fusion in this article.
Project
Select the project that contains the work item you want to update.
Work Item Type
Select the type of work item that you want to update.
Other Fields
In each of these fields, enter the value that you want the work item to have for a given property. Available fields depend on the work item type.
Work item ID
Enter or map the ID of the work item that you want to update.

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.

Connection
For instructions about connecting your Azure DevOps account to Workfront Fusion, see Connect Azure DevOps to Workfront Fusion in this article.
Project
Select the project where you want to upload an attachment.
Work item ID
Enter or map the ID of the work item where you want to upload an attachment.
Comment
Enter the text of a comment that you want to add to the uploaded attachment.
Source file
Select a source file from a previous module, or enter or map the source file's name and content.

Download an attachment

This action module downloads an attachment.

The module returns the file content of the attachment.

Connection
For instructions about connecting your Azure DevOps account to Workfront Fusion, see Connect Azure DevOps to Workfront Fusion in this article.
Attachment URL
Enter or map the URL of the attachment that you want to download.

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.

Connection
For instructions about connecting your Azure DevOps account to Workfront Fusion, see Connect Azure DevOps to Workfront Fusion in this article.
Work item ID
Enter or map the ID of the main work item item that you want to link another work item to.
Linked work item ID
Enter or map the ID of the work item that you want to link to the main work item.
Link Type

Define the relationship between the work items that you want to link.

For more information, see Link Type Reference in the Azure DevOps Documentation.

Comment
Enter or map the text of a comment. This is useful for explaining the reasoning or intention of the link.

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.

Connection
For instructions about connecting your Azure DevOps account to Workfront Fusion, see Connect Azure DevOps to Workfront Fusion in this article.
Project
Select the project that you want to retrieve work items from.
Work item type
Select the type of work item that you want to retrieve.
Outputs
Select the properties that you want to appear in the module's output. The available fields depend on the type of work item you want to retrieve. You must select at least one property.
Limit
Enter or map the maximum number of work items that Workfront Fusion returns during one execution cycle.
recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43