Create

The create operation is used to create a new entity on an entity set. It typically has two records as input, one containing the required parameters and one containing optional parameters.

You also have the option to provide custom HTTP headers, if that is applicable.

With the last parameter "Break workflow on error", you can configure how the machine step will behave in the case of an error. If set to "true" - do break workflow - the machine step will stop the execution of the workflow and typically display a dialog with an error message. If set to false - do not break - it is up to the workflow designer to check the StatusCode member of the result (and/or ErrorMessage) and decided whether to abort the workflow, try again, or just ignore it.

There is usually also the option to run the operation in the context of an iterator.

Output

The result (a record) of the operation looks like this:

  • StatusCode - the HTTP status code returned from the OData endpoint, typically 201 if the operation was successful. A value of 0 or -1 indicates a problem in the connector (i.e, no request sent to the OData endpoint)

  • ErrorMessage - has no value if the operation succeeded, otherwise a description of what when wrong

  • HasFailed - simple value containing true if operation failed

  • Entity - a record containing the values of the created entity, including the values of auto-generated columns.

  • Descriptor - is omitted by default, but if included, contains OData-related information about the entity, such as ETag and the identity of the created entity

  • Headers - is omitted by default, but if included, contains all HTTP headers returned by the OData endpoint

Last updated