DocumentationWorkfrontWorkfront Guide

Widen modules

Last update: Thu Nov 21 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

CREATED FOR:

  • User

In an Adobe Workfront Fusion scenario, you can automate workflows that use Widen, 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 Widen modules, you must have a Widen account.

Widen API information

The Widen connector uses the following:

API version
v2
API tag
v1.10.11

Connect Widen to Workfront Fusion connect-widen-to-workfront-fusion

You can create a connection to your Widen account directly from inside a Widen module.

  1. In any Widen module, click Add next to the Connection field.
  2. Select the Widen domain that you want to connect to.
  3. Enter the token for your Widen account. For instructions on locating this token, see the Widen API FAQs.
  4. Click Continue to create the connection and go back to the module.

Widen modules and their fields

When you configure Widen modules, Workfront Fusion displays the fields listed below. Along with these, additional Widen 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.

Trigger modules

Watch assets

This trigger module starts a scenario when an asset is created or updated.

Connection
For instructions about connecting your Widen account to Workfront Fusion, see Connect Widen to Workfront Fusionin this article.
Event type
Select whether you want to watch new assets or updated assets.
Expand
Select the properties that you want to include in the module output in addition to the asset fields.
Outputs
Select the fields that you want to include in the module output.
Limit
Enter or map the maximum number of assets you want the module to work with during each scenario execution cycle.

Action Modules

Custom API Call

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

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

Connection
For instructions about connecting your Widen account to Workfront Fusion, see Connect Widen to Workfront Fusionin this article.
API Version
Select whether you want to use the latest version of the Widen API, or Version 1.0
URL
Enter or map the URL for your API call.
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"}

Workfront Fusion adds the authorization headers for you.

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 asset info

This action module retrieves an individual asset by its unique ID.

Connection
For instructions about connecting your Widen account to Workfront Fusion, see Connect Widen to Workfront Fusionin this article.
Asset ID
Enter or map the ID of the asset you want to read information for.
Expand
Select the properties that you want to include in the module output in addition to the asset fields.
Outputs
Select the fields that you want to include in the module output.

Add assets to collections

This action module adds one or more assets to collections.

Connection
For instructions about connecting your Widen account to Workfront Fusion, see Connect Widen to Workfront Fusionin this article.
Collections ID

For each collection that you want to add the assets to:

  1. Click Add.

  2. Enter or map the Collection ID.

  3. Click Add item.

Assets ID

For each asset that you want to add to a collection:

  1. Click Add.

  2. Enter or map the Asset ID.

  3. Click Add item.

Limit
Enter or map the maximum number of assets you want the module to work with during each scenario execution cycle.

Remove assets from collection

This action module removes one or more assets from collections.

Connection
For instructions about connecting your Widen account to Workfront Fusion, see Connect Widen to Workfront Fusionin this article.
Collections ID

For each collection that you want to remove the assets from:

  1. Click Add.

  2. Enter or map the Collection ID.

  3. Click Add item.

Assets ID

For each asset that you want to remove from a collection:

  1. Click Add.

  2. Enter or map the Asset ID.

  3. Click Add item.

Limit
Enter or map the maximum number of assets you want the module to work with during each scenario execution cycle.

Update asset metadata

This action module updates the metadata fields of an asset.

Connection
For instructions about connecting your Widen account to Workfront Fusion, see Connect Widen to Workfront Fusionin this article.
Asset ID
Enter or map the ID of the asset where you want to update metadata.
Metadata type
Select the metadata type for the metadata you want to update.
Metadata
Select the metadata fields that you want to update. For each field, enter the new value for the field.
Limit
Enter or map the maximum number of assets you want the module to work with during each scenario execution cycle.

Download File

This action module downloads an asset from your Widen account.

Connection
For instructions about connecting your Widen account to Workfront Fusion, see Connect Widen to Workfront Fusionin this article.
Asset ID
Enter or map the ID of the asset you want to download.

Upload a file

This action module uploads a file into your Widen account.

Connection
For instructions about connecting your Widen account to Workfront Fusion, see Connect Widen to Workfront Fusionin this article.
Upload Profile
Select the upload profile that you want the module to use.
Upload Method

Select how you want to upload the file.

  • From File

    Select or map the source file from a previous module.

  • By URL

    Enter or map the URL of the file that you want to upload.

File name
Enter or map a name for the uploaded file.
Metadata Type
Select the metadata type for the file you want to upload.
Metadata
Select the metadata fields that you want to include in the file upload. For each field, enter the value for the field.

Search Modules

Read collection assets

This action module retrieves a list of assets within a collection.

Connection
For instructions about connecting your Widen account to Workfront Fusion, see Connect Widen to Workfront Fusionin this article.
Collection ID
Enter or map the ID of the collection that contains the assets you want to read.
Start
Enter or map the number of the first item you want to list. This is a way to paginate the records.
Max
Enter or map the maximum number of records you want the module to return during each scenario execution cycle.
Sort By
Select the property by which you want to sort the assets.
Order
Select whether you want to sort assets ascending or descending.
Outputs
Select the fields that you want to include in the module output.

Search assets

This search module retrieves a list of assets that match the specific search criteria.

Connection
For instructions about connecting your Widen account to Workfront Fusion, see Connect Widen to Workfront Fusionin this article.
Search query
Enter the criteria by which you want to search assets.
Sort By
Select how you want to sort the assets.
Order
Select whether you want to sort assets ascending or descending.
Include deleted
Enable this option to include deleted assets in the search.
Include archived
Enable this option to include archived assets in the search.
Search document text
Enable this option to include document text in your search, or false to include only assets for which the title matches the search criteria.
Limit
Enter or map the maximum number of records you want the module to return during each scenario execution cycle.
Offset
Enter or map the number of the first item you want to retrieve details for. This is a way to paginate the records.
Scroll
Enable this option to allow scrolling.
Expand
Select the properties that you want to include in the module output in addition to the asset fields.
Outputs
Select the fields that you want to include in the module output.
recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43