Chilkat Online Tools

SQL Server / Creatio API / Get an object collection instance by Id

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

    EXEC sp_OAMethod @http, 'SetRequestHeader', NULL, 'ForceUseSession', 'true'
    EXEC sp_OAMethod @http, 'SetRequestHeader', NULL, 'BPMCSRF', '{{BPMCSRF}}'

    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://myserver.com/0/odata/Collection1(Id)', @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)

    -- {
    --   "@odata.context": "https://myserver.com/0/odata/$metadata#Employee/$entity",
    --   "Id": "c31c7862-fe33-4a13-9bbc-0943fa08fd02",
    --   "CreatedOn": "2017-03-30T14:50:04Z",
    --   "CreatedById": "76929f8c-7e15-4c64-bdb0-adc62d383727",
    --   "ModifiedOn": "2020-02-14T06:30:46.234Z",
    --   "ModifiedById": "410006e1-ca4e-4502-a9ec-e54d922d2c00",
    --   "ProcessListeners": 0,
    --   "ContactId": "227aab3b-7c0c-4181-abf9-81585563ab23",
    --   "Name": "William Walker",
    --   "OrgStructureUnitId": "d436a9ce-9690-4415-9e03-e8061d7cabb5",
    --   "Notes": "",
    --   "JobId": "11d68189-ced6-df11-9b2a-001d60e938c6",
    --   "FullJobTitle": "Developer",
    --   "OwnerId": "76929f8c-7e15-4c64-bdb0-adc62d383727",
    --   "CareerStartDate": "2019-09-08T00:00:00Z",
    --   "CareerDueDate": "0001-01-01T00:00:00Z",
    --   "ProbationDueDate": "2020-01-09T00:00:00Z",
    --   "ReasonForDismissalId": "00000000-0000-0000-0000-000000000000",
    --   "AccountId": "a0bf3e92-f36b-1410-0499-00155d043204",
    --   "ManagerId": "3e5bd47e-1ebd-41db-a9a6-a3560dcee3cb"
    -- }

    -- Sample code for parsing the JSON response...
    -- Use this online tool to generate parsing code from sample JSON: Generate JSON Parsing Code

    DECLARE @odata_context nvarchar(4000)
    EXEC sp_OAMethod @jResp, 'StringOf', @odata_context OUT, '"@odata.context"'
    DECLARE @Id nvarchar(4000)
    EXEC sp_OAMethod @jResp, 'StringOf', @Id OUT, 'Id'
    DECLARE @CreatedOn nvarchar(4000)
    EXEC sp_OAMethod @jResp, 'StringOf', @CreatedOn OUT, 'CreatedOn'
    DECLARE @CreatedById nvarchar(4000)
    EXEC sp_OAMethod @jResp, 'StringOf', @CreatedById OUT, 'CreatedById'
    DECLARE @ModifiedOn nvarchar(4000)
    EXEC sp_OAMethod @jResp, 'StringOf', @ModifiedOn OUT, 'ModifiedOn'
    DECLARE @ModifiedById nvarchar(4000)
    EXEC sp_OAMethod @jResp, 'StringOf', @ModifiedById OUT, 'ModifiedById'
    DECLARE @ProcessListeners int
    EXEC sp_OAMethod @jResp, 'IntOf', @ProcessListeners OUT, 'ProcessListeners'
    DECLARE @ContactId nvarchar(4000)
    EXEC sp_OAMethod @jResp, 'StringOf', @ContactId OUT, 'ContactId'
    DECLARE @Name nvarchar(4000)
    EXEC sp_OAMethod @jResp, 'StringOf', @Name OUT, 'Name'
    DECLARE @OrgStructureUnitId nvarchar(4000)
    EXEC sp_OAMethod @jResp, 'StringOf', @OrgStructureUnitId OUT, 'OrgStructureUnitId'
    DECLARE @Notes nvarchar(4000)
    EXEC sp_OAMethod @jResp, 'StringOf', @Notes OUT, 'Notes'
    DECLARE @JobId nvarchar(4000)
    EXEC sp_OAMethod @jResp, 'StringOf', @JobId OUT, 'JobId'
    DECLARE @FullJobTitle nvarchar(4000)
    EXEC sp_OAMethod @jResp, 'StringOf', @FullJobTitle OUT, 'FullJobTitle'
    DECLARE @OwnerId nvarchar(4000)
    EXEC sp_OAMethod @jResp, 'StringOf', @OwnerId OUT, 'OwnerId'
    DECLARE @CareerStartDate nvarchar(4000)
    EXEC sp_OAMethod @jResp, 'StringOf', @CareerStartDate OUT, 'CareerStartDate'
    DECLARE @CareerDueDate nvarchar(4000)
    EXEC sp_OAMethod @jResp, 'StringOf', @CareerDueDate OUT, 'CareerDueDate'
    DECLARE @ProbationDueDate nvarchar(4000)
    EXEC sp_OAMethod @jResp, 'StringOf', @ProbationDueDate OUT, 'ProbationDueDate'
    DECLARE @ReasonForDismissalId nvarchar(4000)
    EXEC sp_OAMethod @jResp, 'StringOf', @ReasonForDismissalId OUT, 'ReasonForDismissalId'
    DECLARE @AccountId nvarchar(4000)
    EXEC sp_OAMethod @jResp, 'StringOf', @AccountId OUT, 'AccountId'
    DECLARE @ManagerId nvarchar(4000)
    EXEC sp_OAMethod @jResp, 'StringOf', @ManagerId OUT, 'ManagerId'

    EXEC @hr = sp_OADestroy @http
    EXEC @hr = sp_OADestroy @sbResponseBody
    EXEC @hr = sp_OADestroy @jResp


END
GO

Curl Command

curl -X GET
	-H "ForceUseSession: true"
	-H "BPMCSRF: {{BPMCSRF}}"
https://myserver.com/0/odata/Collection1(Id)

Postman Collection Item JSON

{
  "name": "Get an object collection instance by Id",
  "request": {
    "method": "GET",
    "header": [
      {
        "key": "ForceUseSession",
        "type": "text",
        "value": "true"
      },
      {
        "key": "BPMCSRF",
        "type": "text",
        "value": "{{BPMCSRF}}"
      }
    ],
    "url": {
      "raw": "{{BaseURI}}/0/odata/{{CollectionName1}}({{ObjectId1}})",
      "host": [
        "{{BaseURI}}"
      ],
      "path": [
        "0",
        "odata",
        "{{CollectionName1}}({{ObjectId1}})"
      ]
    },
    "description": "Request for getting an object collection instance by Id."
  },
  "response": [
    {
      "name": "[200] Gets objects collection instance by Id",
      "originalRequest": {
        "method": "GET",
        "header": [
          {
            "key": "Accept",
            "type": "text",
            "value": "application/json"
          },
          {
            "key": "Content-Type",
            "type": "text",
            "value": "application/json; charset=utf-8"
          },
          {
            "key": "ForceUseSession",
            "type": "text",
            "value": "true"
          },
          {
            "key": "BPMCSRF",
            "type": "text",
            "value": "{{BPMCSRF}}"
          }
        ],
        "url": {
          "raw": "https://myserver.com/0/odata/Employee(c31c7862-fe33-4a13-9bbc-0943fa08fd02)",
          "protocol": "https",
          "host": [
            "myserver",
            "com"
          ],
          "path": [
            "0",
            "odata",
            "Employee(c31c7862-fe33-4a13-9bbc-0943fa08fd02)"
          ]
        }
      },
      "status": "OK",
      "code": 200,
      "_postman_previewlanguage": "json",
      "header": [
        {
          "key": "Cache-Control",
          "value": "no-cache"
        },
        {
          "key": "Pragma",
          "value": "no-cache"
        },
        {
          "key": "Content-Type",
          "value": "application/json; odata.metadata=minimal"
        },
        {
          "key": "Expires",
          "value": "-1"
        },
        {
          "key": "Server",
          "value": "Microsoft-IIS/10.0"
        },
        {
          "key": "OData-Version",
          "value": "4.0"
        },
        {
          "key": "X-AspNet-Version",
          "value": "4.0.30319"
        },
        {
          "key": "X-Powered-By",
          "value": "ASP.NET"
        },
        {
          "key": "X-Frame-Options",
          "value": "SAMEORIGIN"
        },
        {
          "key": "X-Content-Type-Options",
          "value": "nosniff"
        },
        {
          "key": "Date",
          "value": "Wed, 26 Feb 2020 14:50:08 GMT"
        },
        {
          "key": "Content-Length",
          "value": "877"
        }
      ],
      "cookie": [
      ],
      "body": "{\n    \"@odata.context\": \"https://myserver.com/0/odata/$metadata#Employee/$entity\",\n    \"Id\": \"c31c7862-fe33-4a13-9bbc-0943fa08fd02\",\n    \"CreatedOn\": \"2017-03-30T14:50:04Z\",\n    \"CreatedById\": \"76929f8c-7e15-4c64-bdb0-adc62d383727\",\n    \"ModifiedOn\": \"2020-02-14T06:30:46.234Z\",\n    \"ModifiedById\": \"410006e1-ca4e-4502-a9ec-e54d922d2c00\",\n    \"ProcessListeners\": 0,\n    \"ContactId\": \"227aab3b-7c0c-4181-abf9-81585563ab23\",\n    \"Name\": \"William Walker\",\n    \"OrgStructureUnitId\": \"d436a9ce-9690-4415-9e03-e8061d7cabb5\",\n    \"Notes\": \"\",\n    \"JobId\": \"11d68189-ced6-df11-9b2a-001d60e938c6\",\n    \"FullJobTitle\": \"Developer\",\n    \"OwnerId\": \"76929f8c-7e15-4c64-bdb0-adc62d383727\",\n    \"CareerStartDate\": \"2019-09-08T00:00:00Z\",\n    \"CareerDueDate\": \"0001-01-01T00:00:00Z\",\n    \"ProbationDueDate\": \"2020-01-09T00:00:00Z\",\n    \"ReasonForDismissalId\": \"00000000-0000-0000-0000-000000000000\",\n    \"AccountId\": \"a0bf3e92-f36b-1410-0499-00155d043204\",\n    \"ManagerId\": \"3e5bd47e-1ebd-41db-a9a6-a3560dcee3cb\"\n}"
    }
  ]
}