_designer_excerpts_asl

Arrays of arrays are not supported by the Designer.

You can create arrays using the create statement (see action script example below):

create anArray;
append "Hello World!" to anArray;

Most of the time the xUML Runtime will create the array implicitly on appending the first item. There is one exception to this rule, though: Arrays that contain array elements having a complex type with multiplicity.

Let's assume you have an array of complex type ArrayElement and this complex type has a property subArray with multiplicity 0..*.

• What you can do, if subArray is NULL:

  set array1[0].subArray = anotherArray;

  The reference subArray is changed to point to anotherArray.

• What you can't do, if subArray is NULL:

  append "something" to array1[0].subArray;

  In this case (get statement on the right side of a statement), the Runtime will throw a get error for array1[0].subArray.

A blob represents base64-encoded arbitrary binary data.

This is calculated e.g. as follows:

1. 31.01.2017 + 1 month = 31.02.2017
2. The resulting date 31.02.2017 is normalized to 03.03.2017.

Within this context TimeTicks are UNIX timestamps.
Unix time, or POSIX time, is a system for describing points in time: it is the number of seconds elapsed since midnight UTC of January 1, 1970, not counting leap seconds. It is widely used not only on Unix-like operating systems but also in many other computing systems.

Boolean values represent binary-valued logic (true, false).

CCYY-MM-DDThh:mm:ss[.sss] [Z|[+|-]hh:mm]

Whereas "Z" stands for the time zone: Coordinated Universal Time (UTC). The W3C value space of DateTime is closely related to the dates and times described in ISO 8601.

A float corresponds to the IEEE single-precision 32-bit floating-point type.

Lexical representation: [white spaces] [+|-][nnn][.nnn][e|E[+|-]nnn] (where white spaces are any tab or space character; nnn may be any number of digits)

The W3C defines integers as "decimal", which represents arbitrary precision decimal numbers.

A string is a set of finite-length sequences of a character set (the Bridge uses UTF-8 internally).

Use writeTypeDiscriminator to suppress the generation of xUML type properties ("e2e:type") to the generated JSON. If this option is true, the Runtime will write the original xUML type to the generated JSON in form of "e2e:type": "<name of the original xUML type>" if the type being serialized does not match the expected metadata.

Find below a list of all Base Types of the Designer together with their type string as returned by typeOf() and staticTypeOf().

Other, e.g. model specific, types can be referenced via their path in the service panel, e.g. a class Customer that has been defined in a package Service/Classes/Customer would have the following type string: "urn:Service.Classes.Customer".

xmlToClass() offers an optional parameter of type XMLComposeOptions.

Its attributes are:

By default the following mapping rules apply:

• Class attributes are mapped to XML attributes.
• Association ends are mapped to XML elements.

These default rules can be overridden by using the stereotypes XMLElement, XMLAttribute, and XMLCharacters on  class properties.
More about these mapping rules, stereotypes and tagged values (e.g. for number and date & time formatting) can be found on Controlling the XML Serialization With Stereotypes.

xmlToClass() offers an optional parameter of type XMLParseOptions. It has various attributes to control schema and DTD location and validation:

Be aware that by default, schemas are parsed, but documents are not validated against them. Set the validation attribute to true if you want to enforce validation beyond well-formedness.
For example, assume that you want to validate your document against a schema called CustomerData.xsd having the namespace http://acme.com/customer. In this case, you need to set the following parse options:

If the XML document refers a schema file (.xsd) with filename (and optional path), it is sufficient to upload the file to the Integration (Bridge) as a resource. It will be automatically loaded from there.

If the XML document refers no schema, or you would like to provide another than the referred one, use the XMLParseOptions structure and set externalSchemaLocation (or externalNonamespaceSchemaLocation) accordingly. As above, missing or relative paths will be redirected to the resource folder of the Integration (Bridge). The same applies also for validating against DTDs. Be aware that validation is turned off by default (see option validation below).

Optional variable or object attribute having the type Basic Components.Basic Behavior.NumbersLocale.

This parameter can be used to define the following properties: