The workflow is currently only an enumeration of commands with no real meaning, so let’s give it just that. We want the workflow to take a user input, check if that input is „Hello World“ and print the result.

All data in PAK passes the so called datastore. The datastore can essentially be seen as a collection of key-value pairs. Assuming the user types „Hello World“ in the text prompt, the datastore would contain a pair of the form (outputText → „Hello World“).

The keys which a command generates can be retrieved by hovering over the respective box in the editor. All generated keys will be listed under Output. Respectively, all keys that a command consumes are to be found under Input.

Not all parameters are necessary for a command to run, the Dataflow Analysis tab of the Bpmn Editor informs us about the minimum keys required for the workflow to be locked and loaded.

The first command we’ll look into is Simple Text Input. When comparing the inputs with the warnings in the Dataflow Analysis tab, we can see that this command does not require any additional data to function. However, we still want to modify the optional descriptiveText input as this specific key is telling the users about what they need to do.

In order to provide the mapping we first left click the Simple Text Input (Fig 4. 1) and hit the Add Input Mapping button or the plus sign on the right sight of Input (Fig 4. 2). Select descriptiveText from the key dropdown (Fig 5.) and press the Constant Mapping button (Fig 4. 4) and type the desired description (Fig 4. 5), in our case „Input your text here“. For mandatory keys this should resolve any dataflow analysis warning about missing or empty keys.

Let’s look at the Check Equals command next. By hovering over the command we can see that it needs two inputs, namely inputA and inputB. As mentioned in

inputB should contain the value that was generated as output by the Simple Text Input. Thus, in order to transfer the user input to field inputB of the Check Equals command use the Key Mapping, which is described in the following.

Key mappings define a binding between an input parameter and a value residing in the datastore. Recalling 3.3, we found out that Simple Text Input writes a pair with the key outputText to the datastore. We now need to somehow reference this key in the Check Equals command.

In order to do so, simply select Key Mapping instead of Constant Mapping (Fig 8. 4) and select the outputText-key (Fig 8. 5). This essentially means that instead of providing a hard-coded value for this input it will be fetched dynamically while the workflow is running. The key inputB is now mapped to outputText and will be replaced by it.

To print the result of our comparison we can either repeat the steps above and map logOutput of Log Value to result or map the output key of Check Equals as described below.

With the Key Mapping you also have the possibility to change a parameter name of a command. This way you can define a customized key for the datastore and create a better overview in a larger workflow.
In our example we can achieve this by clicking the command Check Equals, clicking on the Add Output Mapping button or the plus sign on the right of Output (Fig 4. 2), selecting the output field result (Fig 9. 1) and specifying the customized key in the text field (Fig 9. 2). In this case logOutput.