In this article we will describe the process for creating a simple workflow from scratch.
For demonstration purposes, we will create a workflow using the “Test” application.
The Test app uses a dummy API that lets you GET and POST some data for testing purposes, but without actually changing data.
...
If you have never set up a workflow before we encourage you to follow the steps in this guide to create a simple workflow with the Test app. Since the Test application just uses dummy data there is no risk involved.
To do so:
Add the Test application to your account, as shown previously in step 1.
The Test app does not require any API credentials to be entered - simply add it to your account.Then proceed to create a new workflow from scratch, and copy the steps shown in this article.
...
Select the app(s) to use in the workflow
When you select choose to create a workflow from scratch you will be presented with the following view, where you can choose select the apps to use in the workflow:
...
Choose the apps you want to connect in the list on the left. In our case we will just be using one app, the Test app, both for getting and posting dataClicking the button (“Use single” in our case, otherwise labeled “Connect”)
Click the “Next“ button to proceed the next step.
Click the “Back“ button to return to step 1 of the Wizard.
Naming your Workflow
In step three you will be asked to name your workflow and give it a description.
...
When you have named your workflow, click the “Finish“ button.
The workflow editor
When you have clicked the “Finish“ button, you will be presented with the workflow editor.
This is where you will build your Workflow.
On the left side you can see the premade blocks available for the applications you have included in your integration. There are generic blocks, and a dropdown for each application that is a part of your workflow.
In the center you have the “Canvas”, You can drag and drop a block from the block menu onto the Canvas and configure them to fit your needs.
On the right hand side you have your settings menu. There is a main settings menu that can be accessed by clicking the blue cog icon on the top of the page.
...
If you click on a block, the settings menu will be changed to one that belongs to that block, not the entire workflow.
...
Adding blocks
You will then be presented with the workflow editor, which we will use to build the workflow. Here we will add the blocks that will make up the workflow logic. As explained previously, a block is a re-usable, modular piece of code that executes one or more tasks.
...
If you click each of the blocks you will see the available block settings (under the “Working Area” tab) for each block, which lets you to customize how the block functions. Some of these settings are marked as required information , with a red *.
...
Configure the following settings:
...
Now is a good time to save the changes you have made. Click the save icon to save your workflow.
...
Next we will look at setting up the mapping, using the mapper block.
...
| Info |
|---|
Please note that the Mapper block is currently a work in progress, so you can expect the Mapper block to gain more features and improve going forward. |
...
When we click on Map Model, the Mapper block will ask the source and target blocks to give examples of the kind of data they use. The mapper block will use this information to dynamically construct a mapping screen. (You will see a green checkmark appear next to the GetEmployees block as data is pulled, before the mapping screen appears.)
...
The mapping screen can be thought of as a spreadsheet with two columns – one for the source application, and one for the target application. By connecting corresponding fields, you are building a map for how data should be transformed. And like in a spreadsheet, you also have the possibility to use functions, to concatenate fields, put things text to upper case, date manipulation, etc.
...
The zip code field has a string type in the source model, but a number type in the target model:
...
To fix this we must change the data type for this field, by clicking the little pencil icon next to the field name.
...
You are now able to also map the Source zip field to the Target zip field.
...