Create a practice automation scenario in 蜜豆视频 Workfront Fusion
Automation scenarios automate Workfront processes, including data manipulation and transformation. This article takes you through the process of creating a scenario that searches for a project and then returns all of the tasks associated with that project.
Access requirements
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 plan | Any |
蜜豆视频 Workfront license | New: Standard Or Current: Work or higher |
蜜豆视频 Workfront Fusion license | Current: No Workfront Fusion license requirement. Or Legacy: Any |
Product | New: Select or Prime Workfront Plan: Your organization must purchase 蜜豆视频 Workfront Fusion. Ultimate Workfront Plan: 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 Workfront documentation.
For information on 蜜豆视频 Workfront Fusion licenses, see 蜜豆视频 Workfront Fusion licenses.
Create a automation practice scenario
蜜豆视频 Workfront Fusion helps you focus on important tasks by automating repetitive ones. It creates scenarios that automatically manage your data across various apps and services.
Each scenario consists of modules, which guide how data is processed within an app or transferred between different apps and services. For instance, you can create a scenario in Fusion to automatically find a Workfront project and list its tasks. This way, Fusion saves you time and effort by handling routine tasks.
This practice scenario takes you through the process of creating a scenario that searches for a Workfront project and returns the tasks in the project.
Before you begin
Create a project with tasks in workfront you can use for this exercise. You do not need to do any additional configuration outside of adding tasks to the project.
For information about creating a project in Workfornt, see xxx.
1. Create and name the scenario
-
Sign into your Workfront Fusion account.
-
Click Scenarios in the left panel.
note note NOTE If you do not see the left navigation panel or its icons, click the Menu icon. -
In the Folders panel, click the Add folder icon , then type a name like 鈥淧ractice scenarios鈥 for your first folder.
-
Open the folder, then click Create a new scenario in the upper-right corner of the page.
-
For this exercise, select the 蜜豆视频 Workfront app, then click Search near the bottom.
-
Select the New scenario placeholder name in the upper-left corner, then type a name such as 鈥淧ractice scenario 1.鈥
-
Continue with Connect the first module below.
2. Connect the first module
Now, you need to establish an authenticated connection to your Workfront account. Every module you add to a scenario must have a connection to its app.
-
In the Workfront box, under Connection, click Add, then type a name for the connection, such as 鈥淥livia鈥檚 Workfront account,鈥 then click Continue.
-
Authenticate the connection in the window that displays.
The process for authenticating a connection can vary a bit between apps. The following process is specific to Workfront, but the process is similar to many apps:
- Enter your Workfront domain, then click Continue.
- Log into Workfront.
- Examine the access that Workfront Fusion is requesting, then click Allow Access.
If you need help, see Connections overview.
3. Configure the first module
After you connect Workfront Fusion to your Workfront account, you can specify a Workfront project that you have access to and the data that you want the first module to process.
-
In the Record Type box, select Project. This sets the module to search only projects.
note tip TIP You can find Project in the list if you start typing the word 鈥減roject.鈥 -
In the Result Set box, select First Matching Record. This sets the module to return only the first record it finds that meets the criteria. For this example, we need only one record returned.
-
In the Search criteria area, we鈥檒l set up a filter to return the specific project:
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 Field Action Search criteria fields Select the field that you want to search the values of. For this example, select Name. Search criteria In the first drop-down menu, select Name. Basic Operators In the second drop-down, select Contains (case insensitive). This allows the module to find projects with your chosen words in its name, even if you do not enter the entire name, or enter the name with the incorrect case (such as all caps). Text box Enter a word or phrase that you know is in the name of the project you are searching for. accordion Expand to view an on-screen example. -
In the Outputs list, select the fields that you want the module to output. For this example, select the ID and Name fields.
note tip TIP You can use Cmd+F (Mac OS) or Ctrl-F (Windows OS) to find a field quickly. -
Click OK.
note note NOTE Since this is not a trigger module, you do not choose where to start it. When using a trigger module, you would now select where to start it. For more information, see Choose where a trigger module starts in 蜜豆视频 Workfront Fusion. -
Right-click the module, click Rename, then type a name the describes what you want the module to do (such as 鈥淪earch for project),鈥 then click OK.
The name appears just below the module. Below that, Workfront Fusion includes a brief description of the type of action performed by the module.
-
Continue with Add and configure the second module.
4. Add and configure the second module
-
Click the partial circle to the right of the of the module to Add another module.
-
Select Workfront from the list of applications, then choose the search module Read Related Records.
-
In the Connection box, select the connection that you created for the previous module. You must make sure this module is using the same connection as the previous module.
-
Click Record type, then select Project, because we want to read records related to a project.
note tip TIP You can find Project in the list if you start typing the word 鈥減roject.鈥 -
Click the Parent Record ID field. This field requires the Workfront ID of the project that you want to return tasks from.
Clicking the field opens the list of variables that you can use in the Parent Record ID field to identify the project in Workfront.
-
Click the variable ID to add it to the Parent Record ID field. This allows the ID returned from the first module to be used as the identifier for the project that you want to work with in the second module, which ensures that the tasks returned will belong to that project.
-
In the Collections field, select Tasks. This indicates that the module is to return tasks associated with the chosen project.
-
In the Outputs field, select Id and Name.
-
Click OK
Now you have a working scenario.
-
Give the second module a name such as 鈥淩eturn tasks associated with project,鈥 then continue with Test the scenario.
Test the scenario
Before you activate your scenario, it鈥檚 important to test it by running it at least once and viewing the results. This helps you understand how data flows through the scenario and find any errors.
We chose to have 1 project returned, as well as the tasks associated with that project. If you run the scenario, that is what should happen.
-
Click Run once in the lower-left corner of the scenario editor.
-
After the scenario finishes running, click the bubble above the first module.
In the box that appears, you can view information about the bundle of data that the module processed, including the actual data that was pulled from the project that the module returned.
-
Click the execution inspector bubble above the Second module to see the input of information and the output, which is a collection of tasks contained in the project.
You can learn more about how to read scenario execution information in the following articles:
- For general information, see Scenario execution flow in 蜜豆视频 Workfront Fusion.
- For information about processed bundles, see Scenario execution, cycles, and phases in 蜜豆视频 Workfront Fusion.
-
In Workfront Fusion, click Save near the lower-left corner to save your progress on the scenario.
note important IMPORTANT Save often as you hone and test a scenario.
-
Right-click a Workfront module, then click Add a note.
-
In the note that displays, type an overview for the module.
You can add multiple notes for a module.
-
Close the Notes area.
After you add a note to a scenario, an orange dot displays on the Notes icon at the bottom of the scenario editor.
-
Click the Notes icon to view your notes.
Activate the scenario
This example scenario does not have a trigger module. If this were a scenario you would be using for real data it would start with a trigger module, and the last thing you would do is activate it. After you activate a scenario, by default, it runs every 15 minutes. You can change this by defining when and how often you want it to run.
For more information about activating scenarios, see Activate or deactivate a scenario in 蜜豆视频 Workfront Fusion.
For information about schedules, see Schedule a scenario in 蜜豆视频 Workfront Fusion.