List definition

Defines a group of elements in the integration message.

Usage

list of element-definition

list of choice-def

list of sequence-definition

Parameters

Parameter	Description
element-definition (required)	An element definition.
choice-def	A choice definition.
sequence-definition	A sequence definition.

Remarks

Integration message list elements are mapped to list objects in workflow scripts; you can access or set their values as any other workflow script list, with a few differences, detailed below.

To get or set integration message list element items' values, use dot notation, the index operator, as well as either the list.GetAt() or the list.SetAt() method.

To populate integration message list elements in workflow scripts, use the AddNew() method to append complex list items, and the list.Add() method to append single-textnode elements.

Samples

Some of the workflow scripts in the samples below are triggered by incoming integration messages. Others are referencing integration message schema so that they can create outgoing integration messages. To try the following samples out for yourself, you'll need to upload an intconf.xml file that defines inbound and outbound integration endpoints and the integration messages and schema that they accept, so that these workflow scripts can reference them. You'll also need to create the inbound and outbound endpoints on your Cloud instance that match the names specified in the intconf.xml file.

list sample

Integration message schema

listSample.dacsem

schema listSample meta 'rockyJupiter:listSample' namespace "http://schemas.rockyjupiter.com/listSample"
esm: element Fremd {
  grapes: list of element grape of type string without whitespace;
}

Sample schema-conformant XML

listSample.xml

<Fremd>
  <grape>"Blauburger"</grape>
  <grape>"Cabernet Franc"</grape>
</Fremd>

Accessing list items in a workflow script

listSampleRead.rfs

server program listSampleRead for dacs listSample
{
  foreach(var grape in dacs.esm.grapes) trace grape;
}

Adding a new list item in a workflow script

Download the shadow.fls.xml trigger form for the script below.

listSampleWrite.rfs

server program listSampleWrite for form shadow
using dacs listSample;
{
  var msg = messages.listSample.New();
  msg.esm.grapes.Add("Aramon Noir");
  msg.esm.grapes.Add("Blaufränkisch");
}

Related links

Content definition

Wrapped list definition