51ºÚÁϲ»´òìÈ

Box modules

In an 51ºÚÁϲ»´òìÈ Workfront Fusion scenario, you can automate workflows that use Box, as well as connect it to multiple third-party applications and services. monitors a specified folder to check for file changes, to modify and delete existing files, or to upload new files to a folder.

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
51ºÚÁϲ»´òìÈ Workfront package Any
51ºÚÁϲ»´òìÈ Workfront license

New: Standard

Or

Current: Work or higher

51ºÚÁϲ»´òìÈ 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 51ºÚÁϲ»´òìÈ Workfront Fusion.
  • Ultimate Workfront package: Workfront Fusion is included.

Or

Current: Your organization must purchase 51ºÚÁϲ»´òìÈ Workfront Fusion.

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

For information on 51ºÚÁϲ»´òìÈ Workfront Fusion licenses, see 51ºÚÁϲ»´òìÈ Workfront Fusion licenses.

Prerequisites

To use Box modules, you must have a Box account.

Box API information

The Box connector uses the following:

Base URL
https://api.box.com/2.0
API version
v2.0
API tag
v3.0.3

Box modules and their fields

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

New File Event

This instant trigger module starts a scenario when a the selected action occurs on a file…

Webhook

Select the webhook that you want to use to watch outgoing messages, or add a webhook.

To add a webhook, click Add and enter the webhook's name and connection, the file that you want to watch, and the triggers that you want to watch for.

For instructions about connecting your Box account to Workfront Fusion, see Connect to a service - Basic instructions.

New Folder Event

This instant trigger module starts a scenario when the selection action occurs in the folder.

Webhook

Select the webhook that you want to use to watch outgoing messages, or add a webhook.

To add a webhook, click Add and enter the webhook's name and connection, the folder that you want to watch, and the triggers that you want to watch for.

For instructions about connecting your Box account to Workfront Fusion, see Connect to a service - Basic instructions.

Watch Files

This trigger module starts a scenario when a new file is added or an existing file is updated in a folder being watched.

Connection
For instructions about connecting your Box account to Workfront Fusion, see Create a connection to 51ºÚÁϲ»´òìÈ Workfront Fusion - Basic instructions.
Watch in folder
Select the folder you want to watch. A scenario can watch a single folder.
Watch

Select the type of files you want to watch.

  • Only new files

    The scenario will start when a new file is added.

  • New files and all changes

    The scenario starts when a file is added, or when file content or a file attribute (such as its name) is modified.

Maximum number of downloaded files
Enter the highest number of files you want the module to return during each scenario execution cycle.

Actions

Create a Folder

This action module creates a new empty folder inside the specified parent folder.

Connection
For instructions about connecting your Box account to Workfront Fusion, see Create a connection to 51ºÚÁϲ»´òìÈ Workfront Fusion - Basic instructions.
Name
Enter or map a name for the new folder.
Parent Folder
Select the folder where you want to create the new folder.
Folder Upload Email Access
When this parameter has been set, users can email files to the email address that has been automatically created for this folder. The collaborators options allows only registered emails for collaborators.
Synchronization State
Specifies whether a folder should be synced to a user's device or not. This is used by Box Sync (discontinued) and is not used by Box Drive.

Get a Folder

This action module retrieves details for a folder, including the first 100 entries in the folder.

Connection
For instructions about connecting your Box account to Workfront Fusion, see Create a connection to 51ºÚÁϲ»´òìÈ Workfront Fusion - Basic instructions.
Folder
Select the folder that you want to retrieve details for.

Get Folder Metadata

This action module retrieves folder metadata by folder ID.

Connection
For instructions about connecting your Box account to Workfront Fusion, see Create a connection to 51ºÚÁϲ»´òìÈ Workfront Fusion - Basic instructions.
Scope
Select the scope that you want to use for this metadata retrieval.
Folder
Select the folder that you want to retrieve metadata for.

Make an API Call

This action module makes a custom call to the Box API.

Connection
For instructions about connecting your Bynder account to Workfront Fusion, see Connect Bynder to Workfront Fusionin this article.
URL

Enter a path relative to https://api.box.com.

Example: /2.0/users/me

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"}

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.

Update Folder Metadata

This action module creates or updates the metadata of a folder.

Connection
For instructions about connecting your Box account to Workfront Fusion, see Create a connection to 51ºÚÁϲ»´òìÈ Workfront Fusion - Basic instructions.
Scope
Select the scope that you want to use for this metadata update.
Folder
Select the folder that you want to update metadata for.

Searches

Search for Content

This search module searches for items that are available to the user or to the emtire enterprise.

Connection
For instructions about connecting your Box account to Workfront Fusion, see Create a connection to 51ºÚÁϲ»´òìÈ Workfront Fusion - Basic instructions.
Query
Enter or map the string to search for. This query is matched against item names, descriptions, text content of files, and various other fields of the different item types.
Scope
Select whether you are searching for content associated with the user whose credentials are used for the connection used in this module, or searching for content associated with the entire enterprise.
Type
Select whether you are searching for files, folders, or web links.
Sort
Select whether you want to sort by relevance or by modified date.
Trash Content
Select whether you want to search trashed content or content that hasn't been trashed.
Parent Folder IDs
To search in a specific folder, for each folder you want to search, click Add item and enter the ID of the folder.
Created From
To search for assets created in a certain date range, enter the earliest date in the range.
Created to
To search for assets created in a certain date range, enter the latest date in the range.
Updated From
To search for assets updated in a certain date range, enter the earliest date in the range.
Updated to
To search for assets updated in a certain date range, enter the latest date in the range.
Fields

For each attribute that you want to return in the module's response, click Add item and enter the field.

This can be used to request fields that are not normally returned in a standard response. Be aware that specifying this parameter will have the effect that none of the standard fields are returned in the response unless explicitly specified.

File Extensions
To limit the search to specific file extensions, enter a comma-separated list of file extensions.
Size From
To search for assets in a specific size range, enter the small end of the range, in bytes.
Size To
To search for assets in a specific size range, enter the large end of the range, in bytes.
Owner User ID
To search for assets owned by specific users, enter a comma-separated list of owner IDs.
Limit
Enter or map the maximum number of results that you want the module to return in each execution cycle.
recommendation-more-help
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3