Query Input Payloads Structure
Payloads that execute the component's Query method are often referred to as Query payloads and are used to retrieve or export data from SunSystems.
The structure of the <Payload>
element in a query
payload is different to input payloads for other methods. The following shows an Account Query
payload. For brevity, <ErrorContext>
, <User>
and
<SunSystemsContext>
are omitted:
<?xml version="1.0" encoding="UTF-8"?>
<SSC>
<Payload>
<Filter>
<Item name="/Accounts/AccountCode" operator="EQU" value="S0567"/>
</Filter>
<Select>
<Accounts>
<AccountCode/>
<AccountType/>
<Description/>
</Accounts>
</Select>
</Payload>
</SSC>
The <Payload>
element contains two elements:
- A
<Filter>
element in which you specify the selection criteria for the query. - A
<Select>
element in which you specify which particular data items are to be retrieved
Note: If you submit a payload that omits the
<Filter>
and <Select>
elements, all data items and
all data values are returned. As a result, extremely large output payloads may be generated;
these may take considerable time to process. We recommend that all query input payloads have
the <Filter>
and <Select>
elements present. See the
section Performance.