Difference between revisions of "REST API:recordLocator Resource"

From AgileApps Support Wiki
imported>Aeric
imported>Aeric
Line 11: Line 11:


;Response:
;Response:
Here's a sample response from the Order object, where:
Here's a sample response from the Order object:
:* <tt>lookupColumns</tt> - Record fields the user sees in a grid user when doing a lookup or search.
:* <tt>keyColumns</tt> - 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.)
:* <tt>searchColumns</tt> - The columns used for searching, internally. (The search is applied to the contenation of those columns.)
:<syntaxhighlight lang="xml" enclose="div">
:<syntaxhighlight lang="xml" enclose="div">
<platform>
<platform>
Line 63: Line 60:
:{| border="1" cellpadding="5" cellspacing="0"
:{| border="1" cellpadding="5" cellspacing="0"
! Name!!Type!!Attribute!!Required During Add!!Description!!Additional Information
! 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. || rowspan="3"| 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.)
|-
|| colspan="6"|&nbsp;
|-
|-
| objectId || String || align="center"|Read Only || || ||  
| objectId || String || align="center"|Read Only || || ||  

Revision as of 18:31, 9 September 2011

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:

<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
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.)
colspan="6"| 
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