Action Request System 5.1 Developing AR System Applications ...

Developing AR System Applications: AdvancedThe Set Operation Type for Complex DocumentsThe Set (or Modify) operation for complex documents is more complicatedthan that for the simple document. In a simple document, your base formmay have ten fields, all mapped to XML elements. If your modify requestXML is returned with all ten XML elements, the server will modify each ofthe ten fields with data from the ten XML elements. However, if your modifyrequest XML is returned with fewer than ten elements and you have specifiedMinOccurs=0 in the Object Properties dialog box for the XML elements, theserver will only modify the fields that are present in the input request. If yourmodify request XML is returned with fewer than 10 elements, and you haveset MinOccurs to equal other than 0, you will receive an error message.The Get Operation Type for Complex DocumentsFor GetAll (GetList) operations, map the form to a complex type withmaxOccurs=(a number greater than 1 or unbounded) so that the resultingrecords (>1) can be passed on to the user. Instead of mapping the form to theROOT element, which cannot have maxOccurs=unbounded, map toanother element below ROOT which has maxOccurs=unbounded. All thefields on the form for a GetAll operation should be mapped to the childrenof this element rather than being mapped to children of ROOT. The defaultGetList operation already has this element called “getListValues,” however, ifyou are creating custom mappings, ensure that this element exists.Filter Flow for Complex DocumentsWhen a complex document, such as the PurchaseOrder on page 295 isreceived by the AR Server, the AR Server updates the LineItem form bygenerating Push Field actions on the Purchase Order form for every line itemin the Purchase Order document.! For publishing: the Push Fields actions relating to the web service areexecuted before other Push Fields actions on the Purchase Order form areexecuted.! For consuming: the Push Fields actions generated during theconsumption of a web service are executed before other Push Fieldsactions on the Purchase Order form.! For a form with both publishing and consuming web services: the filterflow is as follows:Publishing Push Fields actions > Consuming Push Fields actions > OtherPush Fields actions.Mapping to Simple and Complex Documents ! 299