×
 
 

 

This documentation supports the 19.02 version of Remedy Action Request System.

To view the latest version, select the version from the Product version menu.

BMC Remedy Action Request System 19.02 ... Developing an API program Integrating AR System forms with a third-party application by using REST API Learning about the REST API

Retrieving field metadata using REST API

The details of the Get operation to fetch field metadata are tabulated below: 

getField

DescriptionRetrieves field metadata for a single field on specified form as defined in the criteria.
URL qualifier

/fields/{formName}/{fieldId}

formName - The form for which an entry is to be created.

field_id - Indicates the list of field IDs for which details are required.

Syntax/api/arsys/v1.0/fields/{formname}/{field_ids}?field_criteria=
criteria1, criteria2, ... 
Example

Retrieve metadata for the field with Field ID 1 on _Form1

http://<Server Name>:<port>/api/arsys/v1.0/fields/_Form1/1

Retrieve limited metadata for the field with Field ID 1 on _Form1, that matches the LAST_MODIFIED_BY criteria.

http://<Server Name>:<port>/api/arsys/v1.0/fields/_Form1/1?field_criteria=LAST_MODIFIED_BY

MethodGET
Headers
HeaderValue
Authorizationtoken
Content-Typeapplication/json
(optional) X-AR-Client-TypeClient Type ID
(optional) X-AR-RPC-QueueRPC queue to which the client calls are routed
(optional) X-AR-Timeout

Timeout (in seconds) for REST request

Default value —120 seconds

Parameters
NameDescription
field_criteria

The API returns the requested data if you provide the criteria. Use the following values:

  • FIELD_MAP
  • DEFAULT_VALUE, PERMISSION
  • LIMIT, DISPLAY_INSTANCE
  • CHANGE_DIARY
  • OWNER
  • LAST_MODIFIED_BY
  • ASSIGNED_GROUP_LIST
  • PROPERT_YLIST
  • TIME_STAMP
ReturnsField metadata in JSON format
All possible error codes

If the request is not successful, one of the following error codes is returned:

400 - Request body is incorrect

403 - Forbidden

404 - Form does not exist

500 - Internal Server Error

Example

Retrieve field metadata of a single field on a form 

{ 
"id": 536870913,   
"name": "Character Field",   
"help_text": "",   
"last_update_time": "2019-01-28T09:12:18.786+0000",   
"owner": "Demo",   
"last_changed_by": "Demo",   
"field_option": "OPTIONAL",   
"audit": "NONE",   
"create_mode": "PROTECTED_AT_CREATE",   
"field_mapping": {       
"mapping_type": "REGULAR"   
},   
"datatype": "CHAR",   
"limit": {       
"length_unit": "AR_LENGTH_UNIT_BYTE",       
"storage_option_for_clob": "DEFAULT",       
"max_length": 255,       
"menu_style": "OVERWRITE",       
"char_menu": "",       
"qbe_match": "ANYWHERE",       
"full_text_options": {           
"index_for_fts": "None",           
"literal_fts_index": false       
},       
"pattern": ""   
},   
"display_properties": {       
"Default Administrator View": {           
"BBOX": [               
{                   
"x": 38357,                   
"y": 8400               
},              
{                   
"x": 65353,                   
"y": 10500               
}           
],           
"VISIBLE": 1,           
"ENABLE": 2,           
"Z_ORDER": 2147483648,           
"HIDE_WEBHELP": 1,           
"LABEL": "Character Field",           
"LABEL_BBOX": [               
{                  
"x": 0,                   
"y": 400               
},               
{                   
"x": 8323,                   
"y": 2100               
}           
],           
"DATA_ROWS": 1,           
"DATA_EXPAND_BBOX": [     
          {                   
"x": 24634,                  
"y": 0               
},               
{                   
"x": 26996,                   
"y": 2100               
}           
],           
"TAB_ORDER": 4294967295,           
"DATA_BBOX": [               
{                   
"x": 8886,                   
"y": 0               
},               
{                   
"x": 24071,                  
"y": 2100              
}          
],           
"DISPLAY_PARENT": 0,           
"MANAGE_EXPAND_BOX": 0,           
"FIELD_HIGHLIGHT": 0,           
"FIELD_HIGHLIGHT_START_COLOR": "0x00",           
"FIELD_HIGHLIGHT_END_COLOR": "0x00",           
"ALIGNED": 0,           
"SHOWURL": 0       
}   
},   
"_links": { 
      "self": [           
{              
"href": "http://<localhost>:<jettyport>/api/arsys/v1.0/fields/<form name>/<field ID>"           
}       
]  
}
}

getFields

DescriptionRetrieves field metadata for specified fields on specified form as defined in the criteria.
URL qualifier

/fields/{formname}

Syntax/api/arsys/v1.0/fields/{formname}/?field_ids=
fieldid1, fieldid2 & field_criteria=
criteria1, criteria2 .. & field_type=
fieldtype1, fieldtype2, ...
Examples
  • Retrieve field metadata for all fields on a form
    http://<Server Name>:<port>/api/arsys/v1.0/fields/_Form1/
  • Retrieve data for field with field IDs 1,2, and 3
    http://<Server Name>:<port>/api/arsys/v1.0/fields/_Form1?field_ids=1,2,3
  • Retrieve limited data for field with field IDs 1,2, and 3, that matches the IME_STAMP criteria.
    http://<Server Name>:<port>/api/arsys/v1.0/fields/_Form1?field_ids=1,2,3&field_criteria=TIME_STAMP
  • Retrieve all the data fields on the form.
    http://<Server Name>:<port>/api/arsys/v1.0/fields/_Form1/?field_type=DATA
MethodGET
Headers
HeaderValue
Authorizationtoken
Content-Typemultipart/form-data
(optional) X-AR-Client-TypeClient Type ID
(optional) X-AR-RPC-QueueRPC queue to which the client calls are routed
(optional) X-AR-Timeout

Timeout (in seconds) for REST request

Default value —120 seconds

Parameters
ParmeterDescription
field_idsIndicates the list of field ids for which details are required.
field_criteria

The API returns the requested data if you provide the criteria. Use the following values:

  • FIELD_ID
  • NAME, FIELD_MAP
  • DATATYPE
  • OPTIONS
  • CREATE_MODE, DEFAULT_VALUE
  • PERMISSION
  • LIMIT, DISPLAY_INSTANCE
  • HELP_TEXT, TIME_STAMP
  • OWNER, LAST_MODIFIED_BY
  • CHANGE_DIARY, AUDIT_OPTIONS
  • ASSIGNED_GROUP_LIST, PROPERTY_LIST
field_type

Indicates the list of field types for which field details are to be returned. 
Use the following values as field_type:

  • DATA
  • TRIM
  • CONTROL
  • PAGE
  • PAGEHOLDER
  • TABLE
  • COLUMN
  • ATTACH
  • ATTACHPOOL

Warning:

You can either provide the field_type or field_ids.

ReturnsField metadata of request fields in JSON format
All possible error codes

If the request is not successful, one of the following error codes is returned:

400 - Request body is incorrect

403 - Forbidden

404 - Form does not exist

500 - Internal Server Error

Example: Retrieve field metadata for specific fields

[   
{       
"id": 536870913,       
"name": "Character Field",       
"help_text": "",       
"last_update_time": "2019-01-28T09:12:18.786+0000",       
"owner": "Demo",       
"last_changed_by": "Demo",       
"field_option": "OPTIONAL",      
"audit": "NONE",       
"create_mode": "PROTECTED_AT_CREATE",       
"field_mapping": { 
          "mapping_type":
"REGULAR"      
},      
"datatype": "CHAR",      
"limit": {           
"length_unit": "AR_LENGTH_UNIT_BYTE",           
"storage_option_for_clob": "DEFAULT",          
"max_length": 255,           
"menu_style": "OVERWRITE",          
"char_menu": "",          
"qbe_match": "ANYWHERE",           
"full_text_options": {               
"index_for_fts": "None",              
"literal_fts_index": false           
},           
"pattern": ""      
},      
"display_properties": {           
"Default Administrator View": {               
"BBOX": [                  
{                       
"x": 38357,                       
"y": 8400                   
},                  
{                       
"x": 65353,                      
"y": 10500                  
}               
],              
"VISIBLE": 1,              
"ENABLE": 2,              
"Z_ORDER": 2147483648,              
"HIDE_WEBHELP": 1,          
     "LABEL": "Character Field",              
"LABEL_BBOX": [                  
{                      
"x": 0,                       
"y": 400                   
},                   
{                       
"x": 8323,                      
"y": 2100                   
}               
],              
"DATA_ROWS": 1,               
"DATA_EXPAND_BBOX": [                   
{                       
"x": 24634,                      
"y": 0                  
},                   
{                       
"x": 26996,                      
"y": 2100                  
}             
],               
"TAB_ORDER": 4294967295,             
"DATA_BBOX": [                
{                      
"x": 8886,              
        "y": 0                 
},                  
{                     
"x": 24071,                     
"y": 2100                  
}              
],              
"DISPLAY_PARENT": 0,              
"MANAGE_EXPAND_BOX": 0,      
        "FIELD_HIGHLIGHT": 0,              
"FIELD_HIGHLIGHT_START_COLOR": "0x00",              
"FIELD_HIGHLIGHT_END_COLOR": "0x00",             
"ALIGNED": 0,             
"SHOWURL": 0         
}     
},     
"_links": {          
"self": [              
{                 
"href": "http://clm-pun-t43rv6:8008/api/arsys/v1.0/fields/form99/536870913"               
}          
]     
}  
},  
{     
"id": 536870914,      
"name": "Drop-Down List Field",      
"help_text": "",     
"last_update_time": "2019-01-28T11:28:00.947+0000",      
"owner": "Demo",       
"last_changed_by": "Demo",       
"field_option": "OPTIONAL",       
"audit": "NONE",       
"create_mode": "PROTECTED_AT_CREATE",   
    "default_value": "Veg",       
"field_mapping": {           
"mapping_type": "REGULAR"       
},       
"datatype": "ENUM",       
"limit": {           
"selection_values": [               
{                   
"name": "Non-Veg",             
      "id": 1               
},               
{                   
"name": "Egg",                   
"id": 2               
},               
{                   
"name": "Veg",                   
"id": 0               
},               
{                   
"name": "Fruit",                   
"id": 3               
},               
{                   
"name": "Milk",                  
"id": 4              
}           
],           
"list_style": "REGULAR"       
},      
"display_properties": {           
"Default Administrator View": {               
"BBOX": [                   
{                       
"x": 43419,                       
"y": 14600                   
},                   
{                       
"x": 63666,                       
"y": 16700                   
}               
],               
"VISIBLE": 1,               
"ENABLE": 2,               
"Z_ORDER": 2147483649,               
"HIDE_WEBHELP": 1,               
"LABEL": "Drop-Down List Field",               
"LABEL_BBOX": [                   
{                       
"x": 0,                       
"y": 400                   
},                   
{                       
"x": 11361,
      
                 "y":2100                   
}               
],               
"DATA_ROWS": 1,               
"DATA_RADIO": 0,               
"TAB_ORDER": 4294967295,               
"DATA_BBOX": [                   
{                       
"x": 11923,                       
"y": 0                   
},                   
{                       
"x": 20246,                       
"y": 2100                   
}               
],               
"DISPLAY_PARENT": 0,               
"ENUM_LABELS": "5\\0\\Egg\\1\\Fruit\\2\\Milk\\3\\Dessert\\4\\Soda",               
"FIELD_HIGHLIGHT": 0,               
"FIELD_HIGHLIGHT_START_COLOR": "0x00",               
"FIELD_HIGHLIGHT_END_COLOR": "0x00",               
"ALIGNED": 0           
}       
},      
"_links": {           
"self": [               
{                   
"href": "http://<LocalHost>:<Jetty Port>/api/arsys/v1.0/fields/<form name>/<Field ID>"               
}           
]       
}   
}
]


Related topics

Was this page helpful? Yes No Submitting... Thank you
Last modified by Anagha Deshpande on Oct 11, 2019

Comments

  1. Lonnie Murray

    Is there a way to return dynamic dropdown list values using the REST API?

    Jul 25, 2019 01:36
    1. Anagha Deshpande

      Hello Lonnie,

      We are working on your query. We will respond soon.

      Regards,

      Anagha

      Jul 25, 2019 09:45
      1. Anagha Deshpande

        Hello Lonnie,

        Currently, we can fetch only static metadata for DDL using the REST API.

        Regards,

        Anagha

        Aug 27, 2019 11:06
  2. Mark C

    Hello - Is there a way to return every field's metadata without having to input each fieldID? In other words, I would like to get the metadata for each field within a form.

    Sep 09, 2019 09:17
    1. Anagha Deshpande

      Hello Mark,

      We are working on your query. We will respond soon.

      Regards,

      Anagha

      Sep 09, 2019 11:37
      1. Anagha Deshpande

        Hello Mark,

        You can fetch field metadata for each field on a form by using the following URL:

        api/arsys/v1.0/fields/<Form name>

        Regards,

        Anagha




        Sep 10, 2019 12:24
  3. Arturo Melendez

    Hello If I am trying to get the field ID of the form of HPD_IncidentServiceInterface, should I put in the URL that name. Also in the header field -> Authorization the token is my username ?, thank U

    Oct 31, 2019 04:19
    1. Anagha Deshpande

      Hello Arturo,

      We are working on your query.

      We will respond soon.

      Regards,

      Anagha

      Oct 31, 2019 11:53
      1. Anagha Deshpande

        Hello Arturo,

        When you enter the form name in URL, you will get field metadata for all fields.
        The authorization token is generated by using api/jwt/login.

        Hope this helps.

        Regards,

        Anagha

        Nov 03, 2019 11:32
Retrieving an association using REST API
Merging an entry using REST API
© Copyright 1991-2021 BMC Software, Inc. © Copyright 1991-2021 BladeLogic, Inc.
Legal notices

Powered by Atlassian Confluence and Scroll Viewport

© Copyright 2005-2021 BMC Software, Inc. Use of this site signifies your acceptance of BMC’s Terms of Use . BMC, the BMC logo, and other BMC marks are assets of BMC Software, Inc. These trademarks are registered and may be registered in the U.S. and in other countries.