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

Expand to view access requirements for the functionality in this article.

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:

  • Select or Prime Workfront package: Your organization must purchase Adobe Workfront Fusion.
  • Ultimate Workfront package: Workfront Fusion is included.

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:

API version
v5.1
API tag
v1.29.33

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. To enter an Azure DevOps App ID or Client Secret, click Show advanced settings and enter them in the fields that open.

  6. 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.

Map toggle

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).

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

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.

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 Default processes and process templates 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.

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.
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.

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.

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 Reference guide for link types 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.

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.

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.

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
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3