Web Services Developer's Guide → Web Services API Reference → SBM Application Web Services → Arguments → SectionsOption
SectionsOption indicates the sections that should be returned for a record.
Name | Type | Description |
---|---|---|
SECTIONS-ALL | string | Returns all sections. This is the default value for the sections argument. If no value is specified, ALL is the assumed value. |
SECTIONS-NONE | string | No sections are returned (only the Identifier is returned). Note that the Identifier element is always returned, regardless of the value or values specified in the sections parameter. |
SECTIONS-SPECIFIED | string | Returns sections that you specify. |
Use the sections and specifiedSections arguments to specify which parts of a record should be returned in order to limit the total amount of data that is returned. The sections that are not specified are not included in the response. For example, if the items that you want to return have a large number of item links, notes, URL and file attachments that don't need to be returned in the response, use these parameters to return only the sections of an item you want. If you only need basic user information in the GetUsers response, use the specifiedSections parameter to return only the STANDARD section. If you need basic user information and group information, specify STANDARD and GROUPS.
In the sections parameter, specify one of the following enumeration options:
<urn:sections>SECTIONS-ALL</urn:sections> <urn:specifiedSections></urn:specifiedSections>
<urn:sections>SECTIONS-NONE</urn:sections> <urn:specifiedSections></urn:specifiedSections>
<urn:sections>SECTIONS-SPECIFIED</urn:sections> <urn:specifiedSections>SECTION:EXTENDED</urn:specifiedSections>
You can also use a comma-separated list in specifiedSections to return only the sections of a record that you want. For example:
<urn:specifiedSections>SECTION:FIXED,SECTION:EXTENDED</urn:specifiedSections>
This ensures that only the fixed and extended sections of an item are returned. Below are the sections that you can specify for items:
<urn:specifiedSections>SECTION:ATTACHMENTS</urn:specifiedSections>
Below are the possible sections that you can specify for user records:
The following XML shows SectionsOption in the <urn:sections> element of a typical call.
<urn:options> <urn:extraOption> <urn:name></urn:name> <urn:value></urn:value> </urn:extraOption> <urn:multiOption>CONTINUE-ON-FAILURE</urn:multiOption> <urn:sections>SECTIONS-SPECIFIED</urn:sections> <urn:specifiedSections>SECTION:FIXED</urn:specifiedSections> </urn:limitedField> </urn:options>
Copyright © 2007–2015 Serena Software, Inc. All rights reserved.