Root definition | Developer Documentation

Usage

field-name : element-definition

field-name : wrapped-list-definition

Parameters

Parameter	Description
field-name (required)	The identifier of the root element in workflow scripts.
element-definition	An element definition.
wrapped-list-definition	A wrapped list definition.

Remarks

Samples

Root element sample

Integration message schema

rootSample.dacsem

schema rootSample meta 'rockyJupiter:rootSample'
namespace "http://schemas.rockyjupiter.com/rootSample"
antelope: element {
  baboon: element {
    chinchilla: attribute of type string;
    donkey: content of type int;
  }
}

Sample schema-conformant XML

rootSample.xml

<antelope xmlns="http://schemas.rockyjupiter.com/rootSample">
  <baboon chinchilla="elephant">64</baboon>
</antelope>

Accessing the root element in a workflow script

rootSampleRead.rfs

server program rootSampleRead for dacs rootSample
{
  trace dacs.antelope.baboon;
  trace dacs.antelope.baboon.chinchilla;
}

Adding new elements and attributes to a root element

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

rootSampleWrite.rfs

server program rootSampleWrite for form bonnie
using dacs rootSample;
{
  var msg = messages.rootSample.New();
  msg.antelope.baboon.donkey = 18180;
  msg.antelope.baboon.chinchilla = "lumberjack";
}

wrapped list root element

Integration message schema

wrappedrootSample.dacsem

schema wrappedrootSample meta 'rockyJupiter:wrappedrootSample' namespace "http://schemas.rockyjupiter.com/wrappedrootSample"
crab: wrapped list of element dog {
  elephant: attribute of type int;
}

Sample schema-conformant XML

wrappedrootSample.xml

<crab xmlns="http://schemas.rockyjupiter.com/wrappedrootSample">
  <dog elephant="43"/>
  <dog elephant="44"/>
  <dog elephant="45"/>
  <dog elephant="46"/>
</crab>

Accessing the values in a wrapped list root element

wrappedrootSampleRead.rfs

server program wrappedrootSampleRead for dacs wrappedrootSample
{
  foreach(var elephant in dacs.crab) trace elephant;
}

Setting the values in a wrapped list root element

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

wrappedrootSampleWrite.rfs

server program wrappedrootSampleWrite for form ronnie
using dacs wrappedrootSample;
{
  var msg = messages.wrappedrootSample.New();
  msg.crab.AddNew().elephant = 25;
  msg.crab.AddNew().elephant = 39;
}