Back to Collection Items
-- Important: See this note about string length limitations for strings returned by sp_OAMethod calls.
--
CREATE PROCEDURE ChilkatSample
AS
BEGIN
DECLARE @hr int
-- Important: Do not use nvarchar(max). See the warning about using nvarchar(max).
DECLARE @sTmp0 nvarchar(4000)
-- This example assumes the Chilkat API to have been previously unlocked.
-- See Global Unlock Sample for sample code.
DECLARE @http int
-- Use "Chilkat_9_5_0.Http" for versions of Chilkat < 10.0.0
EXEC @hr = sp_OACreate 'Chilkat.Http', @http OUT
IF @hr <> 0
BEGIN
PRINT 'Failed to create ActiveX component'
RETURN
END
DECLARE @success int
-- Adds the "Authorization: Bearer <access_token>" header.
EXEC sp_OASetProperty @http, 'AuthToken', '<access_token>'
DECLARE @sbResponseBody int
-- Use "Chilkat_9_5_0.StringBuilder" for versions of Chilkat < 10.0.0
EXEC @hr = sp_OACreate 'Chilkat.StringBuilder', @sbResponseBody OUT
EXEC sp_OAMethod @http, 'QuickGetSb', @success OUT, 'https://domain.com/services/data/v{{version}}/ui-api/actions/record/:RECORD_ID/related-list/:RELATED_LIST_IDS', @sbResponseBody
IF @success = 0
BEGIN
EXEC sp_OAGetProperty @http, 'LastErrorText', @sTmp0 OUT
PRINT @sTmp0
EXEC @hr = sp_OADestroy @http
EXEC @hr = sp_OADestroy @sbResponseBody
RETURN
END
DECLARE @jResp int
-- Use "Chilkat_9_5_0.JsonObject" for versions of Chilkat < 10.0.0
EXEC @hr = sp_OACreate 'Chilkat.JsonObject', @jResp OUT
EXEC sp_OAMethod @jResp, 'LoadSb', @success OUT, @sbResponseBody
EXEC sp_OASetProperty @jResp, 'EmitCompact', 0
PRINT 'Response Body:'
EXEC sp_OAMethod @jResp, 'Emit', @sTmp0 OUT
PRINT @sTmp0
DECLARE @respStatusCode int
EXEC sp_OAGetProperty @http, 'LastStatus', @respStatusCode OUT
PRINT 'Response Status Code = ' + @respStatusCode
IF @respStatusCode >= 400
BEGIN
PRINT 'Response Header:'
EXEC sp_OAGetProperty @http, 'LastHeader', @sTmp0 OUT
PRINT @sTmp0
PRINT 'Failed.'
EXEC @hr = sp_OADestroy @http
EXEC @hr = sp_OADestroy @sbResponseBody
EXEC @hr = sp_OADestroy @jResp
RETURN
END
-- Sample JSON response:
-- (Sample code for parsing the JSON response is shown below)
-- {
-- "actions": {
-- "00158000006QBOhAAO": {
-- "actions": [
-- {
-- "actionListContext": "RelatedList",
-- "actionTarget": null,
-- "actionTargetType": "Invoke",
-- "apiName": "NewContact",
-- "externalId": "00D58000000arpq:00158000006QBOhAAO::RelatedList:Desktop:StandardButton:NewContact",
-- "iconUrl": "https://pozil-dev-ed.my.salesforce.com/img/icon/t4v35/action/new_contact_120.png",
-- "id": "0JV4H0000119415WAA",
-- "isMassAction": "false",
-- "label": "New",
-- "lwcComponent": null,
-- "primaryColor": "5867E8",
-- "relatedListRecordId": null,
-- "relatedSourceObject": "Contacts",
-- "section": "Page",
-- "sourceObject": "00158000006QBOhAAO",
-- "subtype": null,
-- "targetObject": "Contact",
-- "targetUrl": null,
-- "type": "StandardButton"
-- }
-- ],
-- "links": [
-- ],
-- "url": "/services/data/v58.0/ui-api/actions/record/00158000006QBOhAAO/related-list/Contacts"
-- }
-- },
-- "eTag": "a20a5831cc59f674f527261d7469d62d",
-- "url": "/services/data/v58.0/ui-api/actions/record/00158000006QBOhAAO/related-list/Contacts"
-- }
-- Sample code for parsing the JSON response...
-- Use this online tool to generate parsing code from sample JSON: Generate JSON Parsing Code
DECLARE @actionListContext nvarchar(4000)
DECLARE @actionTarget nvarchar(4000)
DECLARE @actionTargetType nvarchar(4000)
DECLARE @apiName nvarchar(4000)
DECLARE @externalId nvarchar(4000)
DECLARE @iconUrl nvarchar(4000)
DECLARE @id nvarchar(4000)
DECLARE @isMassAction nvarchar(4000)
DECLARE @label nvarchar(4000)
DECLARE @lwcComponent nvarchar(4000)
DECLARE @primaryColor nvarchar(4000)
DECLARE @relatedListRecordId nvarchar(4000)
DECLARE @relatedSourceObject nvarchar(4000)
DECLARE @section nvarchar(4000)
DECLARE @sourceObject nvarchar(4000)
DECLARE @subtype nvarchar(4000)
DECLARE @targetObject nvarchar(4000)
DECLARE @targetUrl nvarchar(4000)
DECLARE @v_type nvarchar(4000)
DECLARE @v_Url nvarchar(4000)
EXEC sp_OAMethod @jResp, 'StringOf', @v_Url OUT, 'actions.00158000006QBOhAAO.url'
DECLARE @eTag nvarchar(4000)
EXEC sp_OAMethod @jResp, 'StringOf', @eTag OUT, 'eTag'
DECLARE @url nvarchar(4000)
EXEC sp_OAMethod @jResp, 'StringOf', @url OUT, 'url'
DECLARE @i int
SELECT @i = 0
DECLARE @count_i int
EXEC sp_OAMethod @jResp, 'SizeOfArray', @count_i OUT, 'actions.00158000006QBOhAAO.actions'
WHILE @i < @count_i
BEGIN
EXEC sp_OASetProperty @jResp, 'I', @i
EXEC sp_OAMethod @jResp, 'StringOf', @actionListContext OUT, 'actions.00158000006QBOhAAO.actions[i].actionListContext'
EXEC sp_OAMethod @jResp, 'StringOf', @actionTarget OUT, 'actions.00158000006QBOhAAO.actions[i].actionTarget'
EXEC sp_OAMethod @jResp, 'StringOf', @actionTargetType OUT, 'actions.00158000006QBOhAAO.actions[i].actionTargetType'
EXEC sp_OAMethod @jResp, 'StringOf', @apiName OUT, 'actions.00158000006QBOhAAO.actions[i].apiName'
EXEC sp_OAMethod @jResp, 'StringOf', @externalId OUT, 'actions.00158000006QBOhAAO.actions[i].externalId'
EXEC sp_OAMethod @jResp, 'StringOf', @iconUrl OUT, 'actions.00158000006QBOhAAO.actions[i].iconUrl'
EXEC sp_OAMethod @jResp, 'StringOf', @id OUT, 'actions.00158000006QBOhAAO.actions[i].id'
EXEC sp_OAMethod @jResp, 'StringOf', @isMassAction OUT, 'actions.00158000006QBOhAAO.actions[i].isMassAction'
EXEC sp_OAMethod @jResp, 'StringOf', @label OUT, 'actions.00158000006QBOhAAO.actions[i].label'
EXEC sp_OAMethod @jResp, 'StringOf', @lwcComponent OUT, 'actions.00158000006QBOhAAO.actions[i].lwcComponent'
EXEC sp_OAMethod @jResp, 'StringOf', @primaryColor OUT, 'actions.00158000006QBOhAAO.actions[i].primaryColor'
EXEC sp_OAMethod @jResp, 'StringOf', @relatedListRecordId OUT, 'actions.00158000006QBOhAAO.actions[i].relatedListRecordId'
EXEC sp_OAMethod @jResp, 'StringOf', @relatedSourceObject OUT, 'actions.00158000006QBOhAAO.actions[i].relatedSourceObject'
EXEC sp_OAMethod @jResp, 'StringOf', @section OUT, 'actions.00158000006QBOhAAO.actions[i].section'
EXEC sp_OAMethod @jResp, 'StringOf', @sourceObject OUT, 'actions.00158000006QBOhAAO.actions[i].sourceObject'
EXEC sp_OAMethod @jResp, 'StringOf', @subtype OUT, 'actions.00158000006QBOhAAO.actions[i].subtype'
EXEC sp_OAMethod @jResp, 'StringOf', @targetObject OUT, 'actions.00158000006QBOhAAO.actions[i].targetObject'
EXEC sp_OAMethod @jResp, 'StringOf', @targetUrl OUT, 'actions.00158000006QBOhAAO.actions[i].targetUrl'
EXEC sp_OAMethod @jResp, 'StringOf', @v_type OUT, 'actions.00158000006QBOhAAO.actions[i].type'
SELECT @i = @i + 1
END
SELECT @i = 0
EXEC sp_OAMethod @jResp, 'SizeOfArray', @count_i OUT, 'actions.00158000006QBOhAAO.links'
WHILE @i < @count_i
BEGIN
EXEC sp_OASetProperty @jResp, 'I', @i
SELECT @i = @i + 1
END
EXEC @hr = sp_OADestroy @http
EXEC @hr = sp_OADestroy @sbResponseBody
EXEC @hr = sp_OADestroy @jResp
END
GO
Curl Command
curl -X GET
-H "Authorization: Bearer <access_token>"
https://domain.com/services/data/v{{version}}/ui-api/actions/record/:RECORD_ID/related-list/:RELATED_LIST_IDS
Postman Collection Item JSON
{
"name": "Get Related List Actions",
"event": [
{
"listen": "prerequest",
"script": {
"exec": [
""
],
"type": "text/javascript"
}
}
],
"protocolProfileBehavior": {
"disableBodyPruning": true
},
"request": {
"method": "GET",
"header": [
],
"body": {
"mode": "raw",
"raw": ""
},
"url": {
"raw": "{{_endpoint}}/services/data/v{{version}}/ui-api/actions/record/:RECORD_ID/related-list/:RELATED_LIST_IDS",
"host": [
"{{_endpoint}}"
],
"path": [
"services",
"data",
"v{{version}}",
"ui-api",
"actions",
"record",
":RECORD_ID",
"related-list",
":RELATED_LIST_IDS"
],
"query": [
{
"key": "actionTypes",
"value": "",
"description": "The action type (`CustomButton`, `ProductivityAction`, `QuickAction` or `StandardButton`)",
"disabled": true
},
{
"key": "apiNames",
"value": "",
"description": "The API names of one or more actions to be retrieved. Use this parameter only when passing `retrievalMode=All`.",
"disabled": true
},
{
"key": "formFactor",
"value": "",
"description": "The layout display size (`Large` (default), `Medium` or `Small`).",
"disabled": true
},
{
"key": "retrievalMode",
"value": "",
"description": "When the action context is Record, this parameter indicates which actions to retrieve from the record page. Either `All` or `PageLayout` (default).",
"disabled": true
},
{
"key": "sections",
"value": "",
"description": "The section of the user interface that the actions reside in (`ActivityComposer`, `CollaborateComposer`, `Page` or `SingleActionLinks`).",
"disabled": true
}
],
"variable": [
{
"key": "RECORD_ID",
"value": "",
"description": "Record ID"
},
{
"key": "RELATED_LIST_IDS",
"value": "",
"description": "Optional. A related list name, or a comma-delimited list of related list names."
}
]
},
"description": "Get the actions on record detail pages."
},
"response": [
{
"name": "Get Related List Actions",
"originalRequest": {
"method": "GET",
"header": [
],
"body": {
"mode": "raw",
"raw": ""
},
"url": {
"raw": "{{_endpoint}}/services/data/v{{version}}/ui-api/actions/record/:RECORD_ID/related-list/:RELATED_LIST_IDS",
"host": [
"{{_endpoint}}"
],
"path": [
"services",
"data",
"v{{version}}",
"ui-api",
"actions",
"record",
":RECORD_ID",
"related-list",
":RELATED_LIST_IDS"
],
"variable": [
{
"key": "RECORD_ID",
"value": "0014H00002LbR7QQAV",
"description": "Record ID"
},
{
"key": "RELATED_LIST_IDS",
"value": "Contacts",
"description": "A related list name, or a comma-delimited list of related list names."
}
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Date",
"value": "Fri, 06 Oct 2023 11:27:08 GMT"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=63072000; includeSubDomains"
},
{
"key": "X-Content-Type-Options",
"value": "nosniff"
},
{
"key": "X-Robots-Tag",
"value": "none"
},
{
"key": "Cache-Control",
"value": "no-cache,must-revalidate,max-age=0,no-store,private"
},
{
"key": "ETag",
"value": "\"a20a5831cc59f674f527261d7469d62d--gzip\""
},
{
"key": "Content-Type",
"value": "application/json;charset=UTF-8"
},
{
"key": "Vary",
"value": "Accept-Encoding"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
}
],
"cookie": [
],
"body": "{\n \"actions\": {\n \"00158000006QBOhAAO\": {\n \"actions\": [\n {\n \"actionListContext\": \"RelatedList\",\n \"actionTarget\": null,\n \"actionTargetType\": \"Invoke\",\n \"apiName\": \"NewContact\",\n \"externalId\": \"00D58000000arpq:00158000006QBOhAAO::RelatedList:Desktop:StandardButton:NewContact\",\n \"iconUrl\": \"https://pozil-dev-ed.my.salesforce.com/img/icon/t4v35/action/new_contact_120.png\",\n \"id\": \"0JV4H0000119415WAA\",\n \"isMassAction\": \"false\",\n \"label\": \"New\",\n \"lwcComponent\": null,\n \"primaryColor\": \"5867E8\",\n \"relatedListRecordId\": null,\n \"relatedSourceObject\": \"Contacts\",\n \"section\": \"Page\",\n \"sourceObject\": \"00158000006QBOhAAO\",\n \"subtype\": null,\n \"targetObject\": \"Contact\",\n \"targetUrl\": null,\n \"type\": \"StandardButton\"\n }\n ],\n \"links\": [],\n \"url\": \"/services/data/v58.0/ui-api/actions/record/00158000006QBOhAAO/related-list/Contacts\"\n }\n },\n \"eTag\": \"a20a5831cc59f674f527261d7469d62d\",\n \"url\": \"/services/data/v58.0/ui-api/actions/record/00158000006QBOhAAO/related-list/Contacts\"\n}"
}
]
}
