Evaluate

Input data for the evaluation.

This would typically be a reference to an attribute or data area using runtime placeholders.

If you want multiple inputs, pass in an object with multiple placeholders. For example, for an expression that needs to look at both the "template" and "response" data areas, you might code

"data": {
  "template": "%{data:template}",
  "response": "%{data:response}"
}

Data area to which results should be written. If not given, results are not written to a data area.

Whether the response contains file data that should be localized (i.e. a copy made that is accessible to the caller). If dataReference is given, fileData is localized to the dataReference. If dataReference is not given, fileData is localized to temp.

If dataReference is given, fileData will overwrite like-named files.

If dataReference is not given, files will be written to temp.

Attribute to which results should be written. If not given, results are not written to an attribute.

Use "attributeReference":"state" to output to the state attribute used for flow control.

If attributeReference is set to exactly true, then multiple attributes can be set. The properties of the result are considered attribute names, and their values the attribute values. You can use this to set state and another attribute in a single call.

Script to evaluate the data.

This can access the input data as variable data.

Simple scripts be entered on a single line, as in this example which looks at some previously set form data, and sets the "state" attribute to reflect whether the confirmed property was set.

"config": {
  "data":"%{attr:form.data}",
  "script": "data.confirmed ? 'confirmed' : 'unconfirmed'",
  "attributeReference": "state"
}

More complex evaluation will require more complex scripts. These can be passed in in various ways: read from data areas, or read from scripts using the process compiler. More complex scripts can be wrapped in anonymous functions, like the example below which is equivalent to the one-liner above.

function(){
  if ( data.confirmed ) {
    return 'confirmed';
  } else {
    return 'unconfirmed';
  }
}()

Scripts may return objects or arrays, not just single values.

Scripts have no access to the application object or to any data other than the passed-in data.

The script can be passed as an array of lines, which will be concatenated with new lines in between. This can be useful when including "library" code.

Script exception will give runtime errors in the process. Error conditions should be signalled by returning error value of some type.

The script defaults to "null", which returns null. To return the data itself, set the script to "data".

If set to true, log the inputs and output. Config only.