Attribute definition

Defines an attribute for an element in an integration message.

Usage

attribute xml-nametype-definition

Parameters

Parameter	Description
xml-name	The name of the attribute's XML node in the integration message.
type-definition (required)	The type definition for the attribute.

Remarks

Attributes marked optional in the schema have a starting value of null, just like optional elements.

For optional XML nodes that do not have child nodes, such as attributes or text node elements, you only need the script to explicitly check for a null value if a null value would break the solution.

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.

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

Related links

Element definition

Content definition