Run a Subprocess

Learn how to call and run a subprocess using the process run widget.

Overview

One of the three ways a parent process can call a subprocess in Kognitos is by using the Process Run Widget. In this setup, the parent process controls the execution and output of the subprocess.

This method is ideal for single-run scenarios where you need to capture the result and status of a subprocess.

How to Call a Subprocess Using the Process Run Widget

1. In your automation, write the keyword run followed by a slash /

2. From the menu that appears, select Process.

3. Click on the Process drop-down menu to select the process you want to call.

4. Click Save.

Passing Data to a Subprocess

Passing data to a subprocess allows the parent process to provide the specific inputs the subprocess needs to do its work. This makes subprocesses more dynamic and reusable, as they don’t depend on hardcoded values. To enable this, the parent process must explicitly pass the required data, and the subprocess must be designed to accept and return values accordingly.

Parent Process

In your parent process, add a new line after run <subprocess>. Indent and reference the data needed for the subprocess run on the new line. If a data element is required but not explicitly provided, Kognitos will raise a question.

Subprocess

In your subprocess, include one of these lines at the end of your automation to return data to the parent process. This syntax informs Kognitos of the subprocess's result so it can be accessed in the parent process.

• For a single result: the result is {result}

• For multiple results: the results are {result 1}, {result 2}, ...

Examples

1. Returning a Single Result

This example shows how a subprocess can be used to calculate a total. The main process, Process an Invoice, calls the subprocess calculate the total and provides the price. The subprocess uses the price to calculate and return the total.

Parent Process (Process an Invoice)

run /calculate the total
    the price is $3
get the above as the total

Subprocess (calculate the total)

2. Returning Multiple Results

This example shows how to return multiple results from a subprocess. Here, the subprocess Split Full Name returns two results: the first name and the last name .

Parent Process (Extracting Names)

run /Split Full Name
  the full name is "Ada Lovelace"
get the above as the results

Subprocess (Split Full Name)

If you need to run multiple instances of a subprocess in parallel, see Starting Parallel Runs for details on using the start a run syntax.