AgileApps Support Wiki

Difference between revisions of "REST API:recordLocator Resource"

From AgileApps Support Wiki
imported>Aeric
imported>Aeric
Line 65: Line 65:
===Fields===
===Fields===
:{| border="1" cellpadding="5" cellspacing="0"
:{| border="1" cellpadding="5" cellspacing="0"
! Name!!Type!!Attribute!!Required During Add!!Description!!Additional Information
! Name!!Type!!Attribute!!Description!!Additional Information
|-
|-
| lookupColumns || String || ||
| lookupColumns || String ||
| Fields the user sees in a grid user when doing a lookup or search.  
| Fields the user sees in a grid user when doing a lookup or search.  
|  
|  
* Each field is specified in its own element tag.
* Each field is specified in its own element tag.
|-
|-
| keyColumns || String || ||  
| 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.)
| 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.)
|
|
* Each field is specified in its own element tag.
* Each field is specified in its own element tag.
* A Lookup field can be specified (but no more than one).
* One Lookup field can be specified.
* File, Image, Custom Control, Url, Text Area, and Rich Text Area fields are not supported
* File, Image, Custom Control, Url, Text Area, and Rich Text Area fields are not supported
|-
|-
| searchColumns || String || ||
| searchColumns || String ||
| Fields used for searching, internally. (The search is applied to the contenation of those fields.)
| Fields used for searching, internally. (The search is applied to the contenation of those fields.)
|
|
* Each field is specified in its own element tag.
* Each field is specified in its own element tag.
* A Lookup field can be specified (but no more than one).
* One Lookup field can be specified.
* File, Image, Custom Control, Check box, and Roll up Summary fields are not supported.
* File, Image, Custom Control, Check box, and Roll up Summary fields are not supported.
|-
|-
| colspan="6"| 
| colspan="6"| 
|-
|-
| objectId || String || align="center"|Read Only || || ||  
| objectId || String || align="center"|Read Only || ||  
|-
|-
|date_created||Date|| align="center"|Read Only || || || [[UTC Format]]
|date_created||Date|| align="center"|Read Only || || [[UTC Format]]
|-
|-
|created_id||Lookup|| align="center"|Read Only  || || ||
|created_id||Lookup|| align="center"|Read Only  || ||
|-
|-
|date_modified||Date|| align="center"|Read Only || || || [[UTC Format]]
|date_modified||Date|| align="center"|Read Only || || [[UTC Format]]
|-
|-
|modified_id||Lookup || align="center"|Read Only || || ||
|modified_id||Lookup || align="center"|Read Only || ||
|}
|}
<noinclude>
<noinclude>

Revision as of 18:48, 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

Add another column to the search fields: 

<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>
        <searchColumns>date_created</searchColumns>
    </recordLocator>
</platform>
Response
<platform>
    <message>
        <code>0</code>
        <description>Success</description>
    </message>
</platform>
See also: REST API:Error Codes

Fields

Name Type Attribute Description Additional Information
lookupColumns String 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.)
  • Each field is specified in its own element tag.
  • One Lookup field can be specified.
  • File, Image, Custom Control, Url, Text Area, and Rich Text Area fields are not supported
searchColumns String Fields used for searching, internally. (The search is applied to the contenation of those fields.)
  • Each field is specified in its own element tag.
  • One Lookup field can be specified.
  • File, Image, Custom Control, Check box, and Roll up Summary fields are not supported.
 
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
Retrieved from "https://agileappscloud.info/aawiki-src/index.php?title=REST_API:recordLocator_Resource&oldid=12362"