Tasks

Save Data

Saves a new field name into the Stub's data

Basic usage

Task to save the static value of blue into stub.data.favorite_color

Parameters

fieldname

required

string

This is the fieldname to which the data will be written to in stub.data

savevalue

required

string

Data value which we want to save : blue

jsonata

optional

string

A JSONata expression can be used to determine the savevalue for advanced cases.

datatype

optional

string

Will attempt to convert the savevalue to the specified datatype.
Supported types are: text, number, integer, boolean, date, time, datetime and gps.

Result

Properties

fieldname

Name of the field created : favorite_color

savevalue

Data value saveds : blue

Examples

These are some more complex examples

Save Data with Substitution

Savedata using Substitution to derive savevalue

Result

• Below object stored in stubpost.tasks.savedata_favorite_color and favorite_color added to stub.data

Save Data with datatype boolean

Savedata using datatype to convert the savevalue to a boolean, using JS Boolean Constructor

Result

• Value "fieldname": "indemnity_confirmed" stored in stubpost.data.indemnity_confirmed and indemnity_confirmed added to stub.data

Save Data with JSONata

Savedata using JSONata to derive savevalue.

If the field does not exist, a default value of favorite color does not exist is returned, alternatively the value in ~~stub.data.current_favorite_color is returned.

Result

• stub.data.current_favorite color is false

JSONata to Clean Number to E164

Savedata using JSONata to clean a phone number to E164 International Format.

You can also use the JSONata Hashtag Helper to perform this function.

The savedata would look like this:

Try it in the JSONata Exerciser

stub.data.default_country_code

ONLY used if the cellphone number starts with a '0'

REPLACE the stub.data.default_country_code, in line 2, with the static country code as string eg. '1' or with the path to the stub data country code data point.
If the 'default_country_code' does not exist or is not given, it will default to '1' - USA country code.

stub.data.cellphone_number

REPLACE the stub.data.cellphone_number, in line 3, with the path to the stub data cellphone_number data point.

Result