Mnemonic | Valid Values | Description | Examples |
---|---|---|---|
usage= | "REQ" | Indicates that the element should be included in the request schema only. When specified for a group or list element the value applies to the entire container. A specific element in the container may override the container default. | <customerName usage="REQ" /> |
"RESP" | Indicates that the element should be included in the response schema only. When specified for a group or list element the value applies to the entire container. A specific element in the container may override the container default. | <customerId usage="RESP" /> | |
"BOTH" | Indicates that the element should be included in both request and response schema definitions. This is the default value When specified for a group or list element the value applies to the entire container. A specific element in the container may override the container default. | <customerName usage="BOTH" /> | |
"EXCL" | Indicates that the element should not be included in either the request or the response schema definitions. When specified for a group or list element the value applies to the entire container. A specific element in the container may override the container default. | <httpMethod usage="EXCL" /> | |
mapTo= | "internal element name" | Maps a web service element to an internal element. By default the internal element name is assumed to be the same as the web service element name. Use this attribute to assign an external facing element name in the operation schema and map it to a corresponding internal element. Note that this is not an XPath expression but rather a reference to a valid element name that corresponds to the structure of the expanded internal schema. The owner of the element must be the same as the owner of the web service schema. If an operation’s underlying schema was extended (using dynamic data area extension) then the extending owner may only reference their elements on their web service schema extension for the operation. | Internal schema element: <toDoPriority .../> Operation schema element: <priority mapTo="toDoPriority"/> |
role= | "FKGP" | Establishes a group structure that represents a foreign key to an entity. The element itself does not exist in the internal schema. It groups together the foreign key value element(s) along with a corresponding _link element that at run time provides the endpoint URL of that entity’s GET operation. Consumers of the web service may use the link to get the data for the entity. | Internal schema element: <user .../> Operation schema group: <user role="FKGP"> <user> <_link getOperation="mo:'USER';pk1:user;"/> </user> |
"COLL" | Establishes a group structure that represents a collection of entities that corresponds to an internal service list. The element itself does not exist in the internal schema. It groups together the internal list mapped to a _data element along with a corresponding _link element that at run time provides the endpoint URL for the collection's GET operation. Consumers of the web service may use the link to get a more detailed set of information for each entity in the list. By default all the elements in the referenced list are included in the operation schema. You may explicitly reference and define attributes for specific elements as needed. | Internal schema element: <alerts type="list"> <alert/> <startDate /> <endDate /> <version /> </_data> </alerts> Operation schema group: <alerts role="COLL"> <_link getOperation="... "/> <_data mapTo="alerts"> <version usage="EXCL"/> </_data> </alerts> | |
getOperation= | “expression” Expression components: • mo:’<maintenance object>’; • pk1:<relative xpath to an element in the internal schema>; • pk2:...; • pk3:...; • pk4:...; • pk5:...; Parameters pk2–5 are required to match the maintenance object’s prime key definition. | Only valid on _self and _link elements. The attribute is used to reference the default GET operation for an entity as defined by its maintenance object or business object. The application determines the GET operation to use as follows: • If the entity’s business object references an operation using the GET Operation option then it is used. • If the entity’s maintenance object references an operation using the GET Operation option then it is used. • If a GET operation is found that references the maintenance object then it is used. If a GET operation cannot be determined for the entity a standard text indicating that a link is not available is returned instead. | <_link getOperation="mo:'TO DO ENTRY';pk1:toDoEntryId;"/> |
“expression” Expression components: • iws:’<inbound web service name>’; • operation:’<operation name>’; • parms:[<external reference as defined on the GET operation record>:<relative xpath of an element name in the internal schema that holds the value>; <another external reference name>:<another relative xpath>;...]; | Only valid on _self and _link elements. The attribute is used to reference a specific GET operation along with the information needed to compose its path parameters. | <_self getOperation="iws:'F1-ToDoEntry'; operation:'getToDoEntry'; parms:[toDoEntryId:toDoEntryId;]"/> |
Element Name | Description | Examples |
---|---|---|
<_self .../> | Response payloads may include a "_self" element that contains the endpoint URL of the GET operation related to the entity returned in the response. This is an optional element and only one may exist in an operation schema. Refer to getOperation= schema definition attributes for more information. | <_self getOperation="mo:'TO DO ENTRY';pk1:toDoEntryId;"/> |
<_link .../> | Response payloads may include foreign keys and for those entities, the response includes a "_link" element that contains the endpoint URL of the GET operation for that entity (if it exists). Refer to role= and getOperation= schema definition attribute for more information. | <_link getOperation="mo:'TO DO ENTRY';pk1:toDoEntryId;"/> |
<_data .../> | Provides a standard reference to a list of entities in the internal schema. Refer to role=”COLL” schema definition attribute for more information. | <alerts role="COLL"> <_link getOperation="... "/> <_data mapTo="alerts"> </_data> </alerts> |
Mnemonic | Valid Values | Description | Examples |
---|---|---|---|
helpText= | “help text field name” | Associates an element with a specific help text record defined for the Inbound Web Service. If the element is included in both request and response schema the same help text is used in both. If this attribute is not specified, and a single Help Text Field record exists for the Field associated with the internal element, that help text record is used. If more than one such Help Text Field record exists the one where the help text name is the same as the Field name is used. Note that an internal element is associated with a Field name via the mdField= attributes, if any, else via the mapField= attribute. No valid for _self and _link elements. | <toDoEntryId usage="BOTH" helpText="TD_ENTRY"/> In this example the inbound web service defines a help text field name “TD_ENTRY” that provides help text for this element. The same help text is included for the element in both request and response schema. |
helpTextResponse= | “help text field name” | Associates an element that is included in both request and response schema with a specific help text record to be used in the context of the response schema. Follows same rules as the helpText= attribute. | <toDoEntryId usage="BOTH" helpText="TD_ENTRY" helpTextResponse="TD_ENTRY_RESP"/> In this example the inbound web service defines the following help text records: • Help text field name “TD_ENTRY” describes the element sent in the request schema. • Help text field name “TD_ENTRY_RESP” describes the element populated in the response schema. |