AgileApps Support Wiki Pre Release

REST API:recordLocator Resource

From AgileApps Support Wiki
Revision as of 18:33, 9 September 2011 by imported>Aeric (→‎Read a recordLocator Record)

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:

<syntaxhighlight lang="xml" enclose="div">

<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>
       0
       <description>Success</description>
   </message>

</platform> </syntaxhighlight>

See also: REST API:Error Codes

Update a recordLocator Record

Method
PUT
URI
https://{domain}/networking/rest/recordLocator/{objectId}
Request
<syntaxhighlight lang="xml" enclose="div">

<platform>

   <recordLocator>
        ...
   </recordLocator>

</platform> </syntaxhighlight>

Response
<syntaxhighlight lang="xml" enclose="div">

<platform>

   <message>
       0
       <description>Success</description>
   </message>

</platform> </syntaxhighlight>

See also: REST API:Error Codes

Fields

Name Type Attribute Required During Add Description Additional Information
lookupColumns String Record fields the user sees in a grid user when doing a lookup or search. Each field is specified in its own element tag.
keyColumns String 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 String The columns used for searching, internally. (The search is applied to the contenation of those columns.)
 
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