Chilkat Online Tools

PureBasic / Support API / Execute View

Back to Collection Items

IncludeFile "CkJsonObject.pb"
IncludeFile "CkStringBuilder.pb"
IncludeFile "CkHttp.pb"
IncludeFile "CkHttpResponse.pb"

Procedure ChilkatExample()

    ; This example assumes the Chilkat API to have been previously unlocked.
    ; See Global Unlock Sample for sample code.

    http.i = CkHttp::ckCreate()
    If http.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    success.i

    CkHttp::setCkBasicAuth(http, 1)
    CkHttp::setCkLogin(http, "login")
    CkHttp::setCkPassword(http, "password")

    queryParams.i = CkJsonObject::ckCreate()
    If queryParams.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkJsonObject::ckUpdateString(queryParams,"sort_by","<string>")
    CkJsonObject::ckUpdateString(queryParams,"sort_order","<string>")

    CkHttp::ckSetRequestHeader(http,"Accept","application/json")

    resp.i = CkHttp::ckQuickRequestParams(http,"GET","https://example.zendesk.com/api/v2/views/:view_id/execute",queryParams)
    If CkHttp::ckLastMethodSuccess(http) = 0
        Debug CkHttp::ckLastErrorText(http)
        CkHttp::ckDispose(http)
        CkJsonObject::ckDispose(queryParams)
        ProcedureReturn
    EndIf

    sbResponseBody.i = CkStringBuilder::ckCreate()
    If sbResponseBody.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkHttpResponse::ckGetBodySb(resp,sbResponseBody)

    jResp.i = CkJsonObject::ckCreate()
    If jResp.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkJsonObject::ckLoadSb(jResp,sbResponseBody)
    CkJsonObject::setCkEmitCompact(jResp, 0)

    Debug "Response Body:"
    Debug CkJsonObject::ckEmit(jResp)

    respStatusCode.i = CkHttpResponse::ckStatusCode(resp)
    Debug "Response Status Code = " + Str(respStatusCode)
    If respStatusCode >= 400
        Debug "Response Header:"
        Debug CkHttpResponse::ckHeader(resp)
        Debug "Failed."
        CkHttpResponse::ckDispose(resp)

        CkHttp::ckDispose(http)
        CkJsonObject::ckDispose(queryParams)
        CkStringBuilder::ckDispose(sbResponseBody)
        CkJsonObject::ckDispose(jResp)
        ProcedureReturn
    EndIf

    CkHttpResponse::ckDispose(resp)

    ; Sample JSON response:
    ; (Sample code for parsing the JSON response is shown below)

    ; {
    ;   "columns": [
    ;     {
    ;       "Duis8": -59589120,
    ;       "ullamco_0": "Ut nostrud qui elit dolor"
    ;     },
    ;     {
    ;       "officia_13e": -39842370,
    ;       "ipsum_7": "sunt",
    ;       "in_a8": true
    ;     }
    ;   ],
    ;   "groups": [
    ;     {
    ;       "laborum_a27": false
    ;     },
    ;     {
    ;       "ea85c": 69952708.53230786,
    ;       "occaecat_04": 58869893,
    ;       "qui82a": "L"
    ;     }
    ;   ],
    ;   "rows": [
    ;     {
    ;       "velit21": -89119970
    ;     },
    ;     {
    ;       "ex_f": 92255473.59295204,
    ;       "Excepteur_92": "sunt",
    ;       "cillum4": 24641748
    ;     }
    ;   ],
    ;   "view": {
    ;     "active": "<boolean>",
    ;     "conditions": {
    ;       "laborum_8": 404871.0763479173,
    ;       "consequata": -40432952
    ;     },
    ;     "created_at": "<dateTime>",
    ;     "default": "<boolean>",
    ;     "description": "<string>",
    ;     "execution": {
    ;       "deserunt6": false,
    ;       "eu7df": "veniam",
    ;       "utd70": -40480339.58192083,
    ;       "aute_03": true,
    ;       "culpa_5b2": -78225658
    ;     },
    ;     "id": "<integer>",
    ;     "position": "<integer>",
    ;     "restriction": {
    ;       "exercitatione1": "in",
    ;       "magna_b_3": -90768253.5149942
    ;     },
    ;     "title": "<string>",
    ;     "updated_at": "<dateTime>"
    ;   }
    ; }

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

    Duis8.i
    ullamco_0.s
    officia_13e.i
    ipsum_7.s
    in_a8.i
    laborum_a27.i
    ea85c.s
    occaecat_04.i
    qui82a.s
    velit21.i
    ex_f.s
    Excepteur_92.s
    cillum4.i

    Active.s = CkJsonObject::ckStringOf(jResp,"view.active")
    Laborum_8.s = CkJsonObject::ckStringOf(jResp,"view.conditions.laborum_8")
    Consequata.i = CkJsonObject::ckIntOf(jResp,"view.conditions.consequata")
    Created_at.s = CkJsonObject::ckStringOf(jResp,"view.created_at")
    Default.s = CkJsonObject::ckStringOf(jResp,"view.default")
    Description.s = CkJsonObject::ckStringOf(jResp,"view.description")
    Deserunt6.i = CkJsonObject::ckBoolOf(jResp,"view.execution.deserunt6")
    Eu7df.s = CkJsonObject::ckStringOf(jResp,"view.execution.eu7df")
    Utd70.s = CkJsonObject::ckStringOf(jResp,"view.execution.utd70")
    Aute_03.i = CkJsonObject::ckBoolOf(jResp,"view.execution.aute_03")
    Culpa_5b2.i = CkJsonObject::ckIntOf(jResp,"view.execution.culpa_5b2")
    Id.s = CkJsonObject::ckStringOf(jResp,"view.id")
    Position.s = CkJsonObject::ckStringOf(jResp,"view.position")
    Exercitatione1.s = CkJsonObject::ckStringOf(jResp,"view.restriction.exercitatione1")
    Magna_b_3.s = CkJsonObject::ckStringOf(jResp,"view.restriction.magna_b_3")
    Title.s = CkJsonObject::ckStringOf(jResp,"view.title")
    Updated_at.s = CkJsonObject::ckStringOf(jResp,"view.updated_at")
    i.i = 0
    count_i.i = CkJsonObject::ckSizeOfArray(jResp,"columns")
    While i < count_i
        CkJsonObject::setCkI(jResp, i)
        Duis8 = CkJsonObject::ckIntOf(jResp,"columns[i].Duis8")
        ullamco_0 = CkJsonObject::ckStringOf(jResp,"columns[i].ullamco_0")
        officia_13e = CkJsonObject::ckIntOf(jResp,"columns[i].officia_13e")
        ipsum_7 = CkJsonObject::ckStringOf(jResp,"columns[i].ipsum_7")
        in_a8 = CkJsonObject::ckBoolOf(jResp,"columns[i].in_a8")
        i = i + 1
    Wend
    i = 0
    count_i = CkJsonObject::ckSizeOfArray(jResp,"groups")
    While i < count_i
        CkJsonObject::setCkI(jResp, i)
        laborum_a27 = CkJsonObject::ckBoolOf(jResp,"groups[i].laborum_a27")
        ea85c = CkJsonObject::ckStringOf(jResp,"groups[i].ea85c")
        occaecat_04 = CkJsonObject::ckIntOf(jResp,"groups[i].occaecat_04")
        qui82a = CkJsonObject::ckStringOf(jResp,"groups[i].qui82a")
        i = i + 1
    Wend
    i = 0
    count_i = CkJsonObject::ckSizeOfArray(jResp,"rows")
    While i < count_i
        CkJsonObject::setCkI(jResp, i)
        velit21 = CkJsonObject::ckIntOf(jResp,"rows[i].velit21")
        ex_f = CkJsonObject::ckStringOf(jResp,"rows[i].ex_f")
        Excepteur_92 = CkJsonObject::ckStringOf(jResp,"rows[i].Excepteur_92")
        cillum4 = CkJsonObject::ckIntOf(jResp,"rows[i].cillum4")
        i = i + 1
    Wend


    CkHttp::ckDispose(http)
    CkJsonObject::ckDispose(queryParams)
    CkStringBuilder::ckDispose(sbResponseBody)
    CkJsonObject::ckDispose(jResp)


    ProcedureReturn
EndProcedure

Curl Command

curl  -u login:password -G -d "sort_by=%3Cstring%3E"
	-d "sort_order=%3Cstring%3E"
	-H "Accept: application/json"
https://example.zendesk.com/api/v2/views/:view_id/execute

Postman Collection Item JSON

{
  "name": "Execute View",
  "request": {
    "method": "GET",
    "header": [
      {
        "key": "Accept",
        "value": "application/json"
      }
    ],
    "url": {
      "raw": "{{baseUrl}}/api/v2/views/:view_id/execute?sort_by=<string>&sort_order=<string>",
      "host": [
        "{{baseUrl}}"
      ],
      "path": [
        "api",
        "v2",
        "views",
        ":view_id",
        "execute"
      ],
      "query": [
        {
          "key": "sort_by",
          "value": "<string>",
          "description": "The ticket field used for sorting. This will either be a title or a custom field id."
        },
        {
          "key": "sort_order",
          "value": "<string>",
          "description": "The direction the tickets are sorted. May be one of 'asc' or 'desc'"
        }
      ],
      "variable": [
        {
          "key": "view_id",
          "value": "<integer>"
        }
      ]
    },
    "description": "Returns the column titles and the rows of the specified view.\n\nThe `columns` array lists the view's column titles and includes only views parameters.\n\nThe `rows` array lists the values of each column for each ticket and includes parameters from both views and tickets. Though not displayed in the view, a partial ticket object is included with each row object.\n\n**Note**: To get the full ticket objects for a specified view, use [List Tickets from a View](#list-tickets-from-a-view).\n\nThis endpoint is rate limited to 5 requests per minute, per view, per agent.\n\nThe view execution system is designed for periodic rather than high-frequency API usage. In particular, views called very frequently may be cached by Zendesk. This means that the API client will still receive a result, but that result may have been computed at any time within the last 10 minutes.\n\nZendesk recommends using the Incremental Ticket Export endpoint to get the latest changes. You can call it more often, and it returns all the tickets that changed since the last poll. For details and rate limits, see [Incremental Exports](/api-reference/ticketing/ticket-management/incremental_exports/).\n\nView output sorting can be controlled by passing the `sort_by` and `sort_order` parameters in the format described in the table in [Preview Views](#preview-views).\n\n#### Allowed For\n\n* Agents\n"
  },
  "response": [
    {
      "name": "Success response",
      "originalRequest": {
        "method": "GET",
        "header": [
          {
            "description": "Added as a part of security scheme: basic",
            "key": "Authorization",
            "value": "Basic <credentials>"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/api/v2/views/:view_id/execute?sort_by=<string>&sort_order=<string>",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "api",
            "v2",
            "views",
            ":view_id",
            "execute"
          ],
          "query": [
            {
              "key": "sort_by",
              "value": "<string>",
              "description": "The ticket field used for sorting. This will either be a title or a custom field id."
            },
            {
              "key": "sort_order",
              "value": "<string>",
              "description": "The direction the tickets are sorted. May be one of 'asc' or 'desc'"
            }
          ],
          "variable": [
            {
              "key": "view_id"
            }
          ]
        }
      },
      "status": "OK",
      "code": 200,
      "_postman_previewlanguage": "json",
      "header": [
        {
          "key": "Content-Type",
          "value": "application/json"
        }
      ],
      "cookie": [
      ],
      "body": "{\n  \"columns\": [\n    {\n      \"Duis8\": -59589120,\n      \"ullamco_0\": \"Ut nostrud qui elit dolor\"\n    },\n    {\n      \"officia_13e\": -39842370,\n      \"ipsum_7\": \"sunt\",\n      \"in_a8\": true\n    }\n  ],\n  \"groups\": [\n    {\n      \"laborum_a27\": false\n    },\n    {\n      \"ea85c\": 69952708.53230786,\n      \"occaecat_04\": 58869893,\n      \"qui82a\": \"L\"\n    }\n  ],\n  \"rows\": [\n    {\n      \"velit21\": -89119970\n    },\n    {\n      \"ex_f\": 92255473.59295204,\n      \"Excepteur_92\": \"sunt\",\n      \"cillum4\": 24641748\n    }\n  ],\n  \"view\": {\n    \"active\": \"<boolean>\",\n    \"conditions\": {\n      \"laborum_8\": 404871.0763479173,\n      \"consequata\": -40432952\n    },\n    \"created_at\": \"<dateTime>\",\n    \"default\": \"<boolean>\",\n    \"description\": \"<string>\",\n    \"execution\": {\n      \"deserunt6\": false,\n      \"eu7df\": \"veniam\",\n      \"utd70\": -40480339.58192083,\n      \"aute_03\": true,\n      \"culpa_5b2\": -78225658\n    },\n    \"id\": \"<integer>\",\n    \"position\": \"<integer>\",\n    \"restriction\": {\n      \"exercitatione1\": \"in\",\n      \"magna_b_3\": -90768253.5149942\n    },\n    \"title\": \"<string>\",\n    \"updated_at\": \"<dateTime>\"\n  }\n}"
    }
  ]
}