Primary Articles
Primary articles are
those that are (a) required by the service as input, or reliably
returned as output, (b) have no default value, and (c) whose
data-types (MOBY Class types) are used during the discovery of the
service. Primary articles may be further divided into two types:
Collection articles contain an unordered set
("bag") of MOBY Objects (zero or more of the same object type,
and only that object type).
Article names for Simples and Collections may not contain spaces
or other special characters, like:
- Simple articles contain exactly one MOBY Object
<Simple articleName="NameOfArticle"> <objectType>ObjectOntologyTerm</objectType> <Namespace>NamespaceTerm</Namespace> <Namespace>...</Namespace><!-- one or more... --> </Simple>
Their number/order is not relevant, nor predictable
If order is important to the service provider, then a collection should not be used, rather the collection should be broken into named Simple parameters. This may impose limitations on the the types of services that can be registered in MOBY Central. If it becomes a serious problem, a new Primary article type will be added in a future revision.
The use of more than one Class in a collection is deprecated as per API version 0.86
A collection returned from a service invocation may contain zero or more Objects of the Classe defined in the XML during Service Instance registration.
Here's an example:<Collection articleName="NameOfArticle"> <Simple>......</Simple> <!-- Simple parameter type structure --> </Collection>
~`!@#$%^&*()=+{[]}:;'",.<>?/|\