Reference value assignment

Reference values are the response data generated as results when running a test. This data can be used like a variable in the next app in the way the user desires.

Utilizing Tests and Auto-Input

To view the execution results for each task or use auto-input, be sure to run 'Test with 1 data'!

1. When you click the 'Test with 1 data' button on the right side of the Dataflow design window, it executes a single piece of data (or record).

2. After running the test and clicking on an input field, the auto-input feature appears as shown below.

---

Value Types Explanation

Depending on the execution results of each task, the variable value setting type may differ based on whether it is an array or not. The following is an explanation for advanced users.

Object Type

Example Data:

{
    id: 100,
    name: "Roy",
    groupName: "Outcode"
}

Reference Example:

Hello {{a.name}}, Welcome to '{{a.groupName}}'!

Result:

Hello Roy, Welcome to 'Outcode'! 

Array Type

If the variable value is an array, you can directly use the objects inside the array.

When you enter a key from the object within the array as the result, it will automatically iterate through the array and utilize each value.

If you use an array-type result as input for another app, the app will automatically execute repeatedly once for each item in the array.

Only one-dimensional arrays are supported. Nested arrays are not supported. A nested array refers to a case where an array contains another array inside it.

Example Datas:

[
    {
        id: 100,
        name: "Roy",
        groupName: "Outcode"
    },
    {
        id: 101,
        name: "Chris",
        groupName: "Nocode"
    },
    {
        id: 102,
        name: "Soo",
        groupName: "Platform"
    }
]

Reference Example:

Hi {{a.name}}, You're invited to a '{{a.groupName}}'!

Result:

> Hi Roy, You're invited to a 'Outcode'!
> Hi Chris, You're invited to a 'Nocode'!
> Hi Soo, You're invited to a 'Platform'!

Returning Values as Arrays for Multiple Apps

When referencing arrays from multiple apps, the execution is limited to the length of the shorter array.

Example A:

[
    {
        id: 100,
        name: "Roy",
        groupName: "Outcode"
    },
    {
        id: 101,
        name: "Chris",
        groupName: "Nocode"
    },
    {
        id: 102,
        name: "Soo",
        groupName: "Platform"
    }
]

Example B:

[
    {
        id: 200,
        product: "Coke",
        price: 0.5
    },
    {
        id: 201,
        name: "Hotdog",
        groupName: 10
    }
]

Reference Example:

{{a.name}} bought a {{b.product}} for ${{b.price}}.

Result:

Roy bought a coke for $0.5.
Chris bought a coke for $0.5.

---

Using JavaScript

Each task returns the original data from the App as-is. However, situations may arise where the task data needs to be transformed to properly handle the data flow. For such cases, we provide a JavaScript task that allows you to transform the data and reference the transformed result.

Example A:

{
    id: 100,
    name: "Roy",
    groupName: "Outcode"
}

Example of usage in JavaScript:

return a.name;

Result:

Roy

When using a reference value that is an array in JavaScript, the entire array is passed. This allows you to either aggregate the contents of the array or access each index individually.

Example B:

[
    {
        id: 100,
        name: "Roy",
        groupName: "Outcode"
    },
    {
        id: 101,
        name: "Chris",
        groupName: "Nocode"
    },
    {
        id: 102,
        name: "Soo",
        groupName: "Platform"
    }
]

Example of usage in JavaScript:

return b[0].groupName;

Result:

Outcode