REST API:recordLocator Resource

From AgileApps Support Wiki
Revision as of 18:25, 9 September 2011 by imported>Aeric

Manage Record Locators for an object, to read and to specify fields that are used for Record lookups, searches, and indexing, via the REST API.

Access Permissions

Lock-tiny.gif

Users that have the Customize Objects permission can use the recordLocator Resource in the REST API 

Read a recordLocator Record

Method
GET
URI
https://{domain}/networking/rest/recordLocator/{objectId}
Response

Here's a sample response from the Order object, where:

  • lookupColumns - Record fields the user sees in a grid user when doing a lookup or search.
  • keyColumns - Field(s) displayed as the value of a Lookup field, to identify the record the lookup field points to. When multiple fields are specified, their values are separated by hyphens.)
  • searchColumns - The columns used for searching, internally. (The search is applied to the contenation of those columns.)
<platform>
    <recordLocator>
		<lookupColumns>related_to_Customer</lookupColumns>
		<lookupColumns>order_number</lookupColumns>
		<keyColumns>related_to_Customer</keyColumns>
		<searchColumns>related_to_Customer</searchColumns>
		<searchColumns>order_number</searchColumns>
    </recordLocator>

    <message>
        <code>0</code>
        <description>Success</description>
    </message>
</platform>
See also: REST API:Error Codes

Update a recordLocator Record

Method
PUT
URI
https://{domain}/networking/rest/recordLocator/{objectId}
Request
<platform>
    <recordLocator>
         ...
    </recordLocator>
</platform>
Response
<platform>
    <message>
        <code>0</code>
        <description>Success</description>
    </message>
</platform>
See also: REST API:Error Codes

Fields

Name Type Attribute Required During Add Description Additional Information
objectId String Read Only
date_created Date Read Only UTC Format
created_id Lookup Read Only
date_modified Date Read Only UTC Format
modified_id Lookup Read Only