Field definition | Developer Documentation

Usage

field-name:element-definition

field-name:attribute-definition

field-name:list-definition

field-name:wrapped-list-definition

field-name:content-definition

Parameters

Parameter	Description
field-name (required)	The workflow script identifier of the field.
element-definition (required)	An element definition.
attribute-definition (required)	An attribute definition.
list-definition (required)	A list definition.
wrapped-list-definition (required)	A wrapped list definition.
content-definition (required)	A simple text-node content definition.

Remarks

See the relevant details of the various types of available XML element fields in the discussion of attributes, content definition, element definition, and lists.

Samples

Sample with an optional and a required attribute

Integration message schema

attributes.dacsem

schema attributes meta 'rockyJupiter:attributes'
  namespace "http://schemas.rockyjupiter.com/attributes"
  beroe: element {
    marly: optional attribute of type string;
    teend: attribute of type dtl (dtf MM"/"dd"/"yyyy);
}

Sample schema-conformant XML

attributes.xml

<beroe
  marly="lumberjack"
  teend="06/19/2013"/>

Accessing an integration message XML element attribute value in a workflow script

attributesRead.rfs

server program attributesRead for dacs attributes
{
  trace dacs.beroe.marly;
  trace dacs.beroe.teend;
}

Assigning a new value to an integration message XML element attributes in a workflow script

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

attributesWrite.rfs

server program attributesWrite for form clyde
using dacs attributes;
{
  var msg = messages.attributes.New();
  msg.beroe.marly = "Büstenhalter";
  msg.beroe.teend = dtl.New(2015, 10, 20, 0, 0, 0, 0);
}

Sample with an attribute and simple text-node content

Integration message schema

elementWithContent.dacsem

schema elementWithContent meta 'rockyJupiter:elementWithContent'
  namespace "http://schemas.rockyjupiter.com/elementWithContent"
  dragee: element {
    biddie: attribute of type dtl (dtf yyyy"-"MM"-"dd);
    feute: content of type int;
}

Sample schema-conformant XML

elementWithContent.xml

<dragee xmlns="http://schemas.rockyjupiter.com/elementWithContent"
  biddie="1976-03-21">16</dragee>

Accessing an integration message XML element value in a workflow script

elementWithContentRead.rfs

server program elementWithContentRead for dacs elementWithContent
{
  trace dacs.dragee;
  trace dacs.dragee.biddie;
  trace dacs.dragee.feute;
}

Assigning a new value to an integration message XML element in a workflow script

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

elementWithContentWrite.rfs

server program elementWithContentWrite for form pinky
using dacs elementWithContent;
{
  var msg = messages.elementWithContent.New();
  msg.dragee.biddie = dtl.New(2015, 10, 20, 0, 0, 0, 0);
  msg.dragee.feute = 76;
}

Element with child element

Integration message schema

elementWithChildren.dacsem

schema elementWithChildren meta 'rockyJupiter:elementWithChildren'
  namespace "http://schemas.rockyjupiter.com/elementWithChildren"
compy: element
{
  cephalo: element
  {
    raip: optional attribute of type float;
  }
  salami: list of element salam of type int;
}

Sample schema-conformant XML

elementWithChildren.xml

<compy>
  <salam>62</salam>
  <salam>431</salam>
  <salam>10</salam>
  <salam>98320</salam>
  <cephalo raip="3.14"/>
</compy>

Accessing an integration message XML element value in a workflow script

elementWithChildrenRead.rfs

server program elementWithChildrenRead for dacs elementWithChildren
{
  trace dacs.compy.cephalo.raip;
  foreach(var salam in dacs.compy.salami) trace salam;
}

Assigning a new value to an integration message XML element in a workflow script

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

elementWithChildrenWrite.rfs

server program elementWithChildrenWrite for form blinky
using dacs elementWithChildren;
{
  var msg = messages.elementWithChildren.New();
  msg.compy.cephalo.raip = 3.6;
  msg.compy.salami.Add(1800);
  msg.compy.salami.Add(10);
  msg.compy.salami.Add(213);
}

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");
}