ÃÛ¶¹ÊÓÆµ

Azure Active Directory modules

In an ÃÛ¶¹ÊÓÆµ Workfront Fusion scenario, you can automate workflows that use Azure Active Directory, 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
ÃÛ¶¹ÊÓÆµ Workfront package Any
ÃÛ¶¹ÊÓÆµ Workfront license

New: Standard

Or

Current: Work or higher

ÃÛ¶¹ÊÓÆµ 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 ÃÛ¶¹ÊÓÆµ Workfront Fusion.
  • Ultimate Workfront package: Workfront Fusion is included.

Or

Current: Your organization must purchase ÃÛ¶¹ÊÓÆµ Workfront Fusion.

For more detail about the information in this table, see Access requirements in documentation.

For information on ÃÛ¶¹ÊÓÆµ Workfront Fusion licenses, see ÃÛ¶¹ÊÓÆµ Workfront Fusion licenses.

Prerequisites

To use Azure Active Directory modules, you must have an Azure Active Directory account.

Azure Active Directory API information

The Azure Active Directory connector uses the following:

API version
v1.0
API tag
v1.4.5

Azure Active Directory modules and their fields

When you configure Azure Active Directory modules, Workfront Fusion displays the fields listed below. Along with these, additional Azure Active Directory 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 ÃÛ¶¹ÊÓÆµ Workfront Fusion.

Map toggle

Triggers

Watch records (scheduled)

This polling (scheduled) trigger module executes a scenario when a record in a selected object has been created since the last scheduled run in Azure Active Directory. It also returns all standard fields associated with the record or records, 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 Active Directory account to Workfront Fusion, see Create a connection to ÃÛ¶¹ÊÓÆµ Workfront Fusion - Basic instructions.
Type
Select whether you want to watch User records or Group records.
Maximum Number of Records
Enter or map the maximum number of records you want the module to return during each scenario execution cycle.

Actions

Read Record

This action module reads data from a single record in Azure Active Directory.

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.

You must have sufficient permissions to access the record in Azure Active Directory in order to retrieve this information.

When you are configuring this module, the following fields display.

Connection
For instructions about connecting your Azure Active Directory account to Workfront Fusion, see Create a connection to ÃÛ¶¹ÊÓÆµ Workfront Fusion - Basic instructions.
Record Type
Select whether you want to read a User record or a Group record.
Outputs
Select the information you want included in the output bundle for this module.
ID
Enter or map the unique Azure Active Directory ID of the record that you want the module to read.

Create Record

This action module creates a new user or group record.

You specify the type of the record you want.

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 Active Directory account to Workfront Fusion, see Create a connection to ÃÛ¶¹ÊÓÆµ Workfront Fusion - Basic instructions.
Record Type
Select whether you want to read a User record or a Group record.
Other Fields
Fill in these fields to set the values for the new record.

Custom API Call

This action module lets you make a custom authenticated call to the Azure Active Directory API. This way, you can create a data flow automation that can’t be accomplished by the other Azure Active Directory modules.

When you are configuring this module, the following fields display.

Connection
For instructions about connecting your Azure Active Directory account to Workfront Fusion, see Create a connection to ÃÛ¶¹ÊÓÆµ Workfront Fusion - Basic instructions.
URL
Enter or map a path relative to https://graph.microsoft.com/{version}/{resource}?{query-parameters}
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.

Searches

Search Users

This search module looks for records in an object in Azure Active Directory that match the search query you specify. 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 Active Directory account to Workfront Fusion, see Create a connection to ÃÛ¶¹ÊÓÆµ Workfront Fusion - Basic instructions.
Search Criteria

Enter the criteria that you want to use in your search.

For information about the parameters to use, such as "$filter", see in the Microsoft API documentation.

Outputs
Select the information you want included in the output bundle for this module.
Maximal count of records
Enter or map the maximum number of records you want the module to return during each scenario execution cycle.

Search Users/Groups Delta

This search module looks for records in Azure AD that have been created, updated, or deleted. You can map this information in subsequent modules in the scenario.

Connection
For instructions about connecting your Azure Active Directory account to Workfront Fusion, see Create a connection to ÃÛ¶¹ÊÓÆµ Workfront Fusion - Basic instructions.
Limit
Enter or map the maximum number of records you want the module to return during each scenario execution cycle.
recommendation-more-help
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3