You are viewing the documentation for Blueriq 17. Documentation for other versions is available in our documentation directory.

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 7 Next »

This page lists the behaviour of the Runtime when creating or parsing XML messages based on XSD schemas (SOAP and REST with schema sets). 


The behaviour is broken down by:

  • whether the message is being sent or being received
  • whether attributes and relations are inside a sequence or a choice
  • whether an element is mapped to an attribute or a relation
  • whether the attribute or relation is single-valued or multi-valued

1. Sending an XML message 

TBD

1.1 Sequences

TBD

1.1.1 Single-Valued Attributes


ValueSourceminOccursnillableResult
unknownsystem0*element not present
unknownsystem> 0*error
unknownuser0falseempty element
unknownuser0truenil element
unknownuser1falseempty element
unknownuser1truenil element
unknownuser> 1falseas many empty elements as required by minOccurs
unknownuser> 1trueas many nil elements as required by minOccurs
known***an element containing the value


1.1.2 Multi-Valued Attributes


ValueSourceminOccursnillableResult
unknownsystem0*no elements present
unknownsystem> 0*error
unknownuser0falseempty element
unknownuser0truenil element
unknownuser> 0falseas many empty elements as required by minOccurs
unknownuser> 0trueas many nil elements as required by minOccurs
known, count < minOccurs**falsecount elements with values, padded with empty elements as required by minOccurs
known, count < minOccurs**truecount elements with values, padded with nil elements as required by minOccurs
known, minOccurs <= count <= maxOccurs***as many elements as there are values, each element containing the corresponding value
known, maxOccurs < count***error


1.1.3 Single-Valued Relations

The source of relations is not used when handing unknown relations. Empty or nil tags are never created for relations, as that would lead to extra, unwanted instances on the receiving side.


ValueminOccursnillableResult
unknown0*element not present
unknown> 0*error
known, attributes and relations do not generate sub-elements*falseempty element
known, attributes and relations do not generate sub-elements*truenil element
known, at least one attribute or relation generates a sub-element**an element with sub-elements according to the rules on this page


1.1.4 Multi-Valued Relations

TBD

ValueminOccursnillableResult
unknown0*no elements present
unknown> 0*error
known, count < minOccurs**error
known, minOccurs <= count <= maxOccurs*falsecount elements
known, minOccurs <= count <= maxOccurs*truecount elements. If any of the instances do not generate sub-elements, the element corresponding to that instance is nil
known, maxOccurs < count**error


1.2 Choices

The behaviour of choices depends on the min/maxOccurs on the choice, the min/maxOccurs of the elements inside the choice, as well as the value and source of the attributes or relations mapped to those elements. 

It is possible to choose multiple times, as required by minOccurs and restricted by maxOccurs on the choice. When choosing a second time, the same element that was chosen on the first choice cannot be chosen again (Petru Galanton : there is a contradiction to this in the single-valued attributes table, see below - in reality an element can be chosen multiple times if it has minOccurs = 0, in that case it chosen 0 times).

Other rules:

  • System-set attributes are never chosen.
  • Unknown relations are never chosen (source doesn't matter)




1.2.1 Single-Valued Attributes

TBD

Petru Galanton : would it be more clear if we had only the following combinations ?

  • unknown/system with all of unknown/system, unknown/user, known
  • unknown/user with unknown/user and known (so leave out unknown/user + unknown/system, as that was covered already by unknown/system + unknown/user)
  • known with known (so leave out known + unknown/system and known + unknown/user, as those were covered already by unknown/system + known and unknown/user + known)
Choice minOccursElement AElement BResultExplanation
ValueSourceminOccursnillableValueSourceminOccursnillable
0unknownsystem**unknownsystem**no element is presentchosen 0 times, or chosen element A 0 times, or chosen element B 0 times
0unknownsystem**unknownuser0false<B/>chosen element B 1 time
0unknownsystem**unknownuser0true<B xsi:nil="true"/>chosen element B 1 time
0unknownsystem**unknownuser1false<B/>chosen element B 1 time
0unknownsystem**unknownuser1true<B xsi:nil="true"/>chosen element B 1 time
0unknownsystem**unknownuser> 1false

<B />

<B/>

chosen as many empty B elements as required by element B minOccurs, chosen 1 time
0unknownsystem**unknownuser> 1true

<B xsi:nil="true"/>

<B xsi:nil="true"/>

chosen as many nil B elements as required by element B minOccurs, chosen 1 time
0unknownsystem**known<= 1**

<B>value</B>


0unknownsystem**known> 1*false

<B>value</B>

<B/>

chosen 1 B element and padded with as many empty elements as required by minOccurs of element B, chosen 1 time
0unknownsystem**known> 1*true

<B>value</B>

<B xsi:nil="true"/>

chosen 1 B element and padded with as many nil elements as required by minOccurs of element B, chosen 1 time
0unknownuser0falseunknownsystem**<A>chosen element A 1 time
0unknownuser0trueunknownsystem**<A xsi:nil="true"/>chosen element A 1 time
0unknownuser1falseunknownsystem**<A>chosen element A 1 time
0unknownuser1trueunknownsystem**<A xsi:nil="true"/>chosen element A 1 time
0unknownuser> 1falseunknownsystem**

<A>value</A>

<A/>

chosen 1 A element and padded with as many empty elements as required by minOccurs of element A, chosen 1 time
0unknownuser> 1trueunknownsystem**

<A>value</A>

<A xsi:nil="true"/>

chosen 1 A element and padded with as many nil elements as required by minOccurs of element A, chosen 1 time
0unknownuser**unknownuser**error
0unknownuser**known***error
0known***unknownsystem**<A>value</A>chosen 1 A element 1 time
0known***unknownuser**error
0known***known***error
1unknownsystem0*unknownsystem0*no element is presentchosen element A 0 times, or chosen element B 0 times
1unknownsystem0*unknownsystem> 0*no element is presentchosen element A 0 times
1unknownsystem0*unknownuser<= 1false<B />chosen element B 1 time
1unknownsystem0*unknownuser<= 1true<B xsi:nil="true"/>chosen element B 1 time
1unknownsystem0*unknownuser> 1false

<B/>

<B/>

chosen element B 1 time, padded with as many empty elements as required by minOccurs of element B
1unknownsystem0*unknownuser> 1true

<B xsi:nil="true" />

<B xsi:nil="true" />

chosen element B 1 time, padded with as many nil elements as required by minOccurs of element B
1unknownsystem0*known*<= 1*<B>value</B>chosen element B 1 time
1unknownsystem0*known*> 1false

<B>value</B>

<B />

chosen element B 1 time, padded with as many empty elements as required by minOccurs of element B
1unknownsystem0*known*> 1true

<B>value</B>

<B xsi:nil="true" />

chosen element B 1 time, padded with as many nil element as required by minOccurs of element B
1unknownsystem> 0*unknownsystem0*no element is presentchosen element B 0 times
1unknownsystem> 0*unknownsystem> 0*errorno element could be chosen
1unknownsystem> 0*unknownuser<= 1false<B/>chosen element B 1 time
1unknownsystem> 0*unknownuser<= 1true<B xsi:nil="true"/>chosen element B 1 time
1unknownsystem> 0*unknownuser> 1false

<B />

<B />

chosen element B 1 time, padded with as many empty elements as required by minOccurs of element B
1unknownsystem> 0*unknownuser> 1true

<B xsi:nil="true" />

<B xsi:nil="true" />

chosen element B 1 time, padded with as many empty elements as required by minOccurs of element B
1unknownsystem> 0*known*<= 1*<B>value</B>chosen element B 1 time
1unknownsystem> 0*known*> 1false

<B>value<B>

<B />

chosen element B 1 time, padded with as many empty elements as required by minOccurs of element B
1unknownsystem> 0*known*> 1true

<B>value</B>

<B xsi:nil="true"/>

chosen element B 1 time, padded with as many nil elements as required by minOccurs of element B
1unknownuser<= 1falseunknownsystem**<A/>chosen element A 1 time
1unknownuser<= 1trueunknownsystem**<A xsi:nil="true" />chosen element A 1 time
1unknownuser> 1falseunknownsystem**

<A/>

<A/>

chosen element A 1 time, padded with as many empty elements as required by minOccurs of element A
1unknownuser> 1trueunknownsystem**

<A xsi:nil="true" />

<A xsi:nil="true" />

chosen element A 1 time, padded with as many nil elements as required by minOccurs of element A
1unknownuser**unknownuser**error
1unknownuser**known***error
1known*<= 1*unknownsystem**<A>value</A>
1known*> 1falseunknownsystem**

<A>value</A>

<A/>

chosen element A 1 time, padded with as many empty elements as required by minOccurs of element A
1known*> 1trueunknownsystem**

<A>value</A>

<A xsi:nil="true" />

chosen element A 1 time, padded with as many nil elements as required by minOccurs of element A
1known***unknownuser**error
1known***known***error
> 1unknownsystem0*unknownsystem0*no element present

Chosen as many times as required by minOccurs of choice.

At each choice, either element A was chosen 0 times, or element B was chosen 0 times

> 1unknownsystem0*unknownsystem> 1*no element present

Chosen as many times as required by minOccurs of choice.

At each choice, element A was chosen 0 times

> 1unknownsystem0*unknownuser<= 1*<B>

Chosen as many times as required by minOccurs of choice.

On the first choice, element B was chosen 1 time.

On the remaining choices, element A was chosen 0 times.

> 1unknownsystem0*unknownuser> 1false

<B>

<B>

Chosen as many times as required by minOccurs of choice.

On the first choice, element B was chosen as many times as required by minOccurs of element B.

On the remaining choices, element A was chosen 0 times

> 1unknownsystem0*unknownuser> 1true

<B xsi:nil="true" />

<B xsi:nil="true" />

Chosen as many times as required by minOccurs of choice.

On the first choice, element B was chosen as many times as required by minOccurs of element B.

On the remaining choices, element A was chosen 0 times

> 1unknownsystem0*known*<= 1*<B>value</B>

Chosen as many times as required by minOccurs of choice.

On the first choice, element B was chosen.

On the remaining choices, element A was chosen 0 times

> 1unknownsystem0*known*> 1false

<B>value</B>

<B/>

Chosen as many times as required by minOccurs of choice.

On the first choice, element B was chosen, padded with as many empty elements as required by minOccurs of element B

On the remaining choices, element A was chosen 0 times

> 1unknownsystem0*known*> 1true

<B>value</B>

<B xsi:nil="true"/>

Chosen as many times as required by minOccurs of choice.

On the first choice, element B was chosen, padded with as many nill elements as required by minOccurs of element B

On the remaining choices, element A was chosen 0 times

> 1unknownsystem> 0*unknownsystem0*no element present

Chosen as many times as required by minOccurs of choice.

On each choice, element B was chosen 0 times

> 1unknownsystem> 0*unknownsystem> 0*errorno element could be chosen
> 1unknownsystem> 0*unknownuser0false<B>

Chosen as many times as required by minOccurs of choice

On the first choice, element B was chosen 1 time

On the remaining choices, element B was chosen 0 times

> 1unknownsystem> 0*unknownuser0true<B xsi:nil="true"/>

Chosen as many times as required by minOccurs of choice

On the first choice, element B was chosen 1 time.

On the remaining choices, element B was chosen 0 times.

> 1unknownsystem> 0*unknownuser> 0*error

Chosen as many times as required by minOccurs of choice

On the first choice, element B was chosen as many times as required by minOccurs of element B

On the remaining choices, no other element could be chosen

> 1unknownsystem> 0*known*0*<B>value</B>

Chosen as many times as required by minOccurs of choice.

On the first choice, element B was chosen 1 time.

On the remaining choices, element B was chosen 0 times (Petru Galanton : this is in contradiction with the statement that the same element cannot be chosen twice)

> 1unknownsystem> 0*known*> 0*error

Chosen as many times as required by minOccurs of choice

On the first choice, element B was chosen as many times as required by minOccurs of element B

On the remaining choices, no other element could be chosen

> 1unknownuser0falseunknownsystem0*<A>

Chosen as many times as required by minOccurs of choice

On the first choice, element A was chosen 1 time

On the remaining choices, element A was chosen 0 times or element B was chosen 0 times

> 1unknownuser0falseunknownsystem> 0*<A>

Chosen as many times as required by minOccurs of choice

On the first choice, element A was chosen 1 time

On the remaining choices, element A was chosen 0 times

> 1unknownuser0falseunknownuser<= 1false

<A>

<B>

Chosen as many times as required by minOccurs of choice

On the first choice, element A was chosen 1 time

On the second choice element B was chosen 1 time

On the remaining choices, element A was chosen 0 times or element B was chosen 0 times

> 1unknownuser0falseunknownuser<= 1true

<A>

<B xsi:nil="true" />

Chosen as many times as required by minOccurs of choice

On the first choice, element A was chosen 1 time

On the second choice element B was chosen 1 time

On the remaining choices, element A was chosen 0 times or element B was chosen 0 times

> 1unknownuser0falseunknownuser> 1false

<A>

<B>

<B>

Chosen as many times as required by minOccurs of choice

On the first choice, element A was chosen 1 time

On the second choice element B was chosen as many times as required by minOccurs of element B

On the remaining choices, element A was chosen 0 times

> 1unknownuser0falseunknownuser> 1true

<A>

<B xsi:nil="true"/>

<B xsi:nil="true"/>

Chosen as many times as required by minOccurs of choice

On the first choice, element A was chosen 1 time

On the second choice element B was chosen as many times as required by minOccurs of element B

On the remaining choices, element A was chosen 0 times

> 1unknownuser0falseknown*<= 1*

<A>

<B>value</A>

Chosen as many times as required by minOccurs of choice

On the first choice, element A was chosen 1 time

On the second choice element B was chosen as many times as required by minOccurs of element B

On the remaining choices, element A was chosen 0 times or element B was chosen 0 times

> 1unknownuser0falseknown*> 1false

<A>

<B>value</B>

<B/>

Chosen as many times as required by minOccurs of choice

On the first choice, element A was chosen 1 time

On the second choice element B was chosen, padded with empty elements as required by minOccurs of element B

On the remaining choices, element A was chosen 0 times or element B was chosen 0 times

> 1unknownuser0falseknown*> 1true

<A>

<B>value</B>

<B xsi:nil="true"/>

Chosen as many times as required by minOccurs of choice

On the first choice, element A was chosen 1 time

On the second choice element B was chosen, padded with nil elements as required by minOccurs of element B

On the remaining choices, element A was chosen 0 times or element B was chosen 0 times

> 1unknownuser0trueunknownsystem0*<A xsi:nil="true"/>

Chosen as many times as required by minOccurs of choice

On the first choice, element A was chosen 1 time

On the remaining choices, element A was chosen 0 times or element B was chosen 0 times

> 1unknownuser0trueunknownsystem> 0*<A xsi:nil="true"/>

Chosen as many times as required by minOccurs of choice

On the first choice, element A was chosen 1 time

On the remaining choices, element A was chosen 0 times

> 1unknownuser0trueunknownuser<= 1false

<A xsi:nil="true">

<B>

Chosen as many times as required by minOccurs of choice

On the first choice, element A was chosen 1 time

On the second choice element B was chosen 1 time

On the remaining choices, element A was chosen 0 times or element B was chosen 0 times

> 1unknownuser0trueunknownuser<= 1true

<A xsi:nil="true"/>

<B xsi:nil="true" />

Chosen as many times as required by minOccurs of choice

On the first choice, element A was chosen 1 time

On the second choice element B was chosen 1 time

On the remaining choices, element A was chosen 0 times or element B was chosen 0 times

> 1unknownuser0trueunknownuser> 1false

<A xsi:nil="true"/>

<B>

<B>

Chosen as many times as required by minOccurs of choice

On the first choice, element A was chosen 1 time

On the second choice element B was chosen as many times as required by minOccurs of element B

On the remaining choices, element A was chosen 0 times

> 1unknownuser0trueunknownuser> 1true

<A xsi:nil="true"/>

<B xsi:nil="true"/>

<B xsi:nil="true"/>

Chosen as many times as required by minOccurs of choice

On the first choice, element A was chosen 1 time

On the second choice element B was chosen as many times as required by minOccurs of element B

On the remaining choices, element A was chosen 0 times

> 1unknownuser0trueknown*<= 1*

<A xsi:nil="true"/>

<B>value</A>

Chosen as many times as required by minOccurs of choice

On the first choice, element A was chosen 1 time

On the second choice element B was chosen as many times as required by minOccurs of element B

On the remaining choices, element A was chosen 0 times or element B was chosen 0 times

> 1unknownuser0trueknown*> 1false

<A xsi:nil="true"/>

<B>value</B>

<B/>

Chosen as many times as required by minOccurs of choice

On the first choice, element A was chosen 1 time

On the second choice element B was chosen, padded with empty elements as required by minOccurs of element B

On the remaining choices, element A was chosen 0 times or element B was chosen 0 times

> 1unknownuser0trueknown*> 1true

<A xsi:nil="true"/>

<B>value</B>

<B xsi:nil="true"/>

Chosen as many times as required by minOccurs of choice

On the first choice, element A was chosen 1 time

On the second choice element B was chosen, padded with nil elements as required by minOccurs of element B

On the remaining choices, element A was chosen 0 times or element B was chosen 0 times

> 1unknownuser> 0falseunknownsystem0falseTBD


1.2.2 Multi-Valued Attributes

TBD

1.2.3 Single-Valued Relations

TBD

1.2.4 Multi-Valued Relations

TBD

2. Receiving an XML message

TBD

2.1 Sequences

TBD

2.1.1 Single-Valued Attributes

TBD

2.1.2 Multi-Valued Attributes

TBD

2.1.3 Single-Valued Relations

TBD

2.1.4 Multi-Valued Relations

TBD


2.2 Choices

TBD

2.2.1 Single-Valued Attributes

TBD

2.2.2 Multi-Valued Attributes

TBD

2.2.3 Single-Valued Relations

TBD

2.2.4 Multi-Valued Relations

TBD

  • No labels