ÃÛ¶¹ÊÓƵ

ÃÛ¶¹ÊÓƵ I/O Events modules

With the ÃÛ¶¹ÊÓƵ I/O Events modules, you can start an ÃÛ¶¹ÊÓƵ Workfront Fusion scenario based on events in ÃÛ¶¹ÊÓƵ accounts and services that do not have a dedicated Workfront Fusion connector.

Access requirements

You must have the following access to use the functionality in this article:

ÃÛ¶¹ÊÓƵ Workfront plan*
Pro or higher
ÃÛ¶¹ÊÓƵ Workfront license*
Plan, Work
ÃÛ¶¹ÊÓƵ Workfront Fusion license**
Workfront Fusion for Work Automation and Integration
Product
Your organization must purchase ÃÛ¶¹ÊÓƵ Workfront Fusion as well as ÃÛ¶¹ÊÓƵ 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 ÃÛ¶¹ÊÓƵ Workfront Fusion licenses, see ÃÛ¶¹ÊÓƵ Workfront Fusion licenses

Prerequisites

Before you can use the ÃÛ¶¹ÊÓƵ I/O Events connector, you must ensure that the following prerequisites are met:

  • You must have an active ÃÛ¶¹ÊÓƵ account.

ÃÛ¶¹ÊÓƵ I/O Events API information

The ÃÛ¶¹ÊÓƵ I/O Events connector uses the following:

Base URL
https://api.adobe.io/events
API tag
v1.6.7

Create a connection to ÃÛ¶¹ÊÓƵ I/O Events

To create a connection for your ÃÛ¶¹ÊÓƵ I/O Events modules:

  1. Click Add next to the Connection box.

  2. Fill in the following fields:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 layout-auto html-authored no-header
    Connection name Enter a name for this connection.
    Type Select whether you want to connect to a service account or a personal account.
    Additional scopes To add any additional scopes, click Add item and enter the scope.
    Client ID Enter your ÃÛ¶¹ÊÓƵ Client ID. This can be found in the Credentials details section of the ÃÛ¶¹ÊÓƵ Developer Console
    Client Secret Enter your ÃÛ¶¹ÊÓƵ Client Secret. This can be found in the Credentials details section of the ÃÛ¶¹ÊÓƵ Developer Console
    Consumer org ID Enter your Consumer org ID. This can be found in the credential URL of the project: https://developer.adobe.com/console/projects/{consumer org ID}/ {project ID}/credentials/{credential ID}/details
    Credential ID Enter your Credential ID. This can be found in the credential URL of the project: https://developer.adobe.com/console/projects/{consumer org ID}/ {project ID}/credentials/{credential ID}/details
    IMS organization ID Enter your ÃÛ¶¹ÊÓƵ Organization ID. This can be found in the Credentials details section of the ÃÛ¶¹ÊÓƵ Developer Console
    Project ID Enter your project ID. This can be found in the credential URL of the project: https://developer.adobe.com/console/projects/{consumer org ID}/ {project ID}/credentials/{credential ID}/details
    Workspace ID To view your project's Workspace ID, download your project details from the project overview page in ÃÛ¶¹ÊÓƵ Developer Console.
  3. Click Continue to save the connection and return to the module.

ÃÛ¶¹ÊÓƵ I/O Events modules and their fields

When you configure ÃÛ¶¹ÊÓƵ I/O Events modules, Workfront Fusion displays the fields listed below. Along with these, additional ÃÛ¶¹ÊÓƵ I/O Events 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.

Triggers

Create an event registration

This action module uses a webhook to create an event description. You can configure a webhook here. If you are using an existing webhook, the fields in this module are read-only.

To create a webhook:

  1. Click Add next to the Webhook field.

  2. Fill in the following fields:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 html-authored no-header
    Webhook name Enter a name for this webhook.
    Connection For instructions on creating a connection to ÃÛ¶¹ÊÓƵ I/O Events, see Create a connection to ÃÛ¶¹ÊÓƵ I/O Events in this article.
    Webhook description Enter a description for this webhook.
    Event provider Select the product or account that you want to create events from.
    Event type Select the events that you want the webhook to watch. The scenario will trigger when these events occur.
  3. Click Save to save the webhook and return to the module.

Actions

Get all events from a journal

This search module retrieves all events for a registration from a journal.

Connection
For instructions on creating a connection to ÃÛ¶¹ÊÓƵ I/O Events, see Create a connection to ÃÛ¶¹ÊÓƵ I/O Events in this article.
Registration ID
Select the registration that you want to retrieve events for.
Maximum number of returned records
Enter or map the maximum number of records you want the module to return during each scenario execution cycle.
Return events that occur after
Seek
Latest
Enable this option to return the latest event.

Make a custom API call

This action module makes a custom API call to the ÃÛ¶¹ÊÓƵ I/O Events API

Connection
For instructions on creating a connection to ÃÛ¶¹ÊÓƵ I/O Events, see Create a connection to ÃÛ¶¹ÊÓƵ I/O Events in this article.
Path
Enter a path relative to https://api.adobe.io/events
Method
Select the HTTP request method you need to configure the API call. For more information, see HTTP request methods in ÃÛ¶¹ÊÓƵ 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 authorization headers and x-api-key headers automatically.

Query String
Enter the request query string.
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

Get provider and event IDs

This search module gets the ÃÛ¶¹ÊÓƵ I/O Events IDs for the specified provider and events.

Connection
For instructions on creating a connection to ÃÛ¶¹ÊÓƵ I/O Events, see Create a connection to ÃÛ¶¹ÊÓƵ I/O Events in this article.
Event provider
Select the provider that you want to retrieve the ID for.
Event type
Select the events that you want to provide IDs for. Events are available based on the event provider.
recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43