DocumentationWorkfrontWorkfront Guide

Split.io 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 Split.io, 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 Split.io modules, you must have a Split.io account.

Split.io API information

The Split.io connector uses the following:

Base URL
https://api.split.io/internal/api
API version
v2
API tag
v1.34.1

Connect Split.io to Workfront Fusion connect-split-io-to-workfront-fusion

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

  1. In any Split.io module, click Add next to the Connection field.

  2. Enter a name for the connection.

  3. Enter your Split.io API key.

    For more information on Split.io API keys, see API keys in the Split.io documentation.

  4. Click Continue to create the connection and go back to the module.

Split.io modules and their fields

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

Actions

Custom API Call

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

Connection
For instructions about connecting your Split.io account to Workfront Fusion, see Connect Split.io to Workfront Fusionin this article.
URL
Enter a path relative to https://api.split.io/internal/api/v2/.
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.

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

Get Split

This action module retrieves the split.

Connection
For instructions about connecting your Split.io account to Workfront Fusion, see Connect Split.io to Workfront Fusionin this article.
Workspace ID
Select or map the workspace that contains the split you want to retrieve.
Split Name
Enter or map the name of the split you want to retrieve.

Get Split Definition in Environment

This action module retrieves a specific split definition from the designated environment.

Connection
For instructions about connecting your Split.io account to Workfront Fusion, see Connect Split.io to Workfront Fusionin this article.
Workspace ID
Select or map the workspace that contains the split definition you want to retrieve.
Environment Name or ID
Select or map the environment that contains the split definition you want to retrieve.
Split Name
Enter or map the name of the split that you want to retrieve the split definition for.

Create Split

This action module creates a new split in your organization, given a traffic type.

NOTE
The API does not configure the split in any environment.
Connection
For instructions about connecting your Split.io account to Workfront Fusion, see Connect Split.io to Workfront Fusionin this article.
Workspace ID
Select or map the workspace where you want to create the split.
Traffic Type ID or Name
Select or map the traffic type that you want to use to create the split.
Split Name
Enter or map a name for the split you want to create.
Split Description
Enter or map a split description for the split you want to create.

Delete Split

This action module deletes a split from your organization. This automatically unconfigures the split definition from all environments.

Connection
For instructions about connecting your Split.io account to Workfront Fusion, see Connect Split.io to Workfront Fusionin this article.
Workspace ID
Select or map the workspace where you want to delete the split.
Split Name
Enter or map the name of the split you want to delete.

Create Split Definition in Environment

This action module configures a split definition for a specific environment.

Connection
For instructions about connecting your Split.io account to Workfront Fusion, see Connect Split.io to Workfront Fusionin this article.
Workspace ID
Select or map the workspace where you want to create a split definition.
Environment Name or ID
Select or map the environment where you want to create a split definition.
Split Name
Enter or map the name of the split you want to create a definition for.
Comments
Enter or map any comments that you want to add to the split definition.
Rules

For each targeting rule you want to add to the definition, click Add item, then enter or map the rule.

For more information on targeting rules, see Create split definition in an environment in the Split.io documentation.

Default rule

Enter or map the rule that you want the split to use for the traffic that does not meet specifications for the other rules.

For more information on targeting rules, see Create split definition in an environment in the Split.io documentation.

Default treatment

Enter or map the treatment that you want the split to use if the split is killed or the customer is not included in traffic allocation.

For more information on treatments, see Create split definition in an environment in the Split.io documentation.

Treatments

For each treatment you want to add to the definition, click Add item, then enter or map the treatment.

For more information on treatments, see Create split definition in an environment in the Split.io documentation.

Remove Split Definition from Environment

This action module unconfigures a split definition for a specific environment.

Connection
For instructions about connecting your Split.io account to Workfront Fusion, see Connect Split.io to Workfront Fusionin this article.
Workspace ID
Select or map the workspace where you want to remove a split definition.
Environment Name or ID
Select or map the environment where you want to remove a split definition.
Split Name
Enter or map the name of the split that you want to remove a definition for.
Comments
Enter or map any comments that you want to add to the split definition.

Partial Update Split Definition in Environment

This action module updates a split definition for a specific environment.

Connection
For instructions about connecting your Split.io account to Workfront Fusion, see Connect Split.io to Workfront Fusionin this article.
Workspace ID
Select or map the workspace where you want to update a split definition.
Environment Name or ID
Select or map the environment where you want to update a split definition.
Split Name
Enter or map the name of the split you want to update a definition for.
Update content

For each attribute of the split that you want to update, click Add item and enter or map the desired changes.

For more information, see Partial Update Split Definition in Environment in the Split.io documentation.

Comments
Enter or map any comments that you want to add to the split definition.

Associate Tags

This action module adds tags to the specified object.

Connection
For instructions about connecting your Split.io account to Workfront Fusion, see Connect Split.io to Workfront Fusionin this article.
Workspace ID
Select or map the workspace where you want to add a tag.
Object Name
Enter or map the name of the object you want to add tags to,
Object Type
Enter or map the type of object you want to add tags to.
Tags
For each tag you want to add, click Add item and enter or map the tag.

Searches

Get Workspaces

This search module retrieves the workspaces for an organization.

Connection
For instructions about connecting your Split.io account to Workfront Fusion, see Connect Split.io to Workfront Fusionin this article.
Limit
Enter or map the maximum number of workspaces you want the module to retrieve during each scenario execution cycle.

Get Environments

This search module retrieves a list of environments.

Connection
For instructions about connecting your Split.io account to Workfront Fusion, see Connect Split.io to Workfront Fusionin this article.
Workspace ID
Select or map the workspace that contains the environments you want to list.

Get Splits

This search module retrieves a list of splits.

Connection
For instructions about connecting your Split.io account to Workfront Fusion, see Connect Split.io to Workfront Fusionin this article.
Workspace ID
Select or map the workspace that contains the splits you want to list.
Limit
Enter or map the maximum number of splits you want the module to retrieve during each scenario execution cycle.

List Split Definitions in an Environment

This search module retrieves a list of split definitions in a given environment.

Connection
For instructions about connecting your Split.io account to Workfront Fusion, see Connect Split.io to Workfront Fusionin this article.
Workspace ID
Select or map the workspace that contains the split definitions you want to list.
Environment Name or ID
Select or map the environment that contains the split definitions you want to list.
Limit
Enter or map the maximum number of split definitions you want the module to retrieve during each scenario execution cycle.

Get Traffic Types

This search module retrieves a list of traffic types.

Connection
For instructions about connecting your Split.io account to Workfront Fusion, see Connect Split.io to Workfront Fusionin this article.
Workspace ID
Select or map the workspace that contains the traffic types you want to list.
recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43