Chilkat Online Tools

C / Support API / Create View

Back to Collection Items

#include <C_CkHttp.h>
#include <C_CkHttpResponse.h>
#include <C_CkStringBuilder.h>
#include <C_CkJsonObject.h>

void ChilkatSample(void)
    {
    HCkHttp http;
    BOOL success;
    HCkHttpResponse resp;
    HCkStringBuilder sbResponseBody;
    HCkJsonObject jResp;
    int respStatusCode;
    int Duis8;
    const char *ullamco_0;
    int officia_13e;
    const char *ipsum_7;
    BOOL in_a8;
    BOOL laborum_a27;
    const char *ea85c;
    int occaecat_04;
    const char *qui82a;
    int velit21;
    const char *ex_f;
    const char *Excepteur_92;
    int cillum4;
    const char *Active;
    const char *Laborum_8;
    int Consequata;
    const char *Created_at;
    const char *Default;
    const char *Description;
    BOOL Deserunt6;
    const char *Eu7df;
    const char *Utd70;
    BOOL Aute_03;
    int Culpa_5b2;
    const char *Id;
    const char *Position;
    const char *Exercitatione1;
    const char *Magna_b_3;
    const char *Title;
    const char *Updated_at;
    int i;
    int count_i;

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

    http = CkHttp_Create();

    CkHttp_putBasicAuth(http,TRUE);
    CkHttp_putLogin(http,"login");
    CkHttp_putPassword(http,"password");

    CkHttp_SetRequestHeader(http,"Accept","application/json");

    resp = CkHttp_QuickRequest(http,"POST","https://example.zendesk.com/api/v2/views");
    if (CkHttp_getLastMethodSuccess(http) == FALSE) {
        printf("%s\n",CkHttp_lastErrorText(http));
        CkHttp_Dispose(http);
        return;
    }

    sbResponseBody = CkStringBuilder_Create();
    CkHttpResponse_GetBodySb(resp,sbResponseBody);

    jResp = CkJsonObject_Create();
    CkJsonObject_LoadSb(jResp,sbResponseBody);
    CkJsonObject_putEmitCompact(jResp,FALSE);

    printf("Response Body:\n");
    printf("%s\n",CkJsonObject_emit(jResp));

    respStatusCode = CkHttpResponse_getStatusCode(resp);
    printf("Response Status Code = %d\n",respStatusCode);
    if (respStatusCode >= 400) {
        printf("Response Header:\n");
        printf("%s\n",CkHttpResponse_header(resp));
        printf("Failed.\n");
        CkHttpResponse_Dispose(resp);
        CkHttp_Dispose(http);
        CkStringBuilder_Dispose(sbResponseBody);
        CkJsonObject_Dispose(jResp);
        return;
    }

    CkHttpResponse_Dispose(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

    // Chilkat functions returning "const char *" return a pointer to temporary internal memory owned and managed by Chilkat.

    Active = CkJsonObject_stringOf(jResp,"view.active");
    Laborum_8 = CkJsonObject_stringOf(jResp,"view.conditions.laborum_8");
    Consequata = CkJsonObject_IntOf(jResp,"view.conditions.consequata");
    Created_at = CkJsonObject_stringOf(jResp,"view.created_at");
    Default = CkJsonObject_stringOf(jResp,"view.default");
    Description = CkJsonObject_stringOf(jResp,"view.description");
    Deserunt6 = CkJsonObject_BoolOf(jResp,"view.execution.deserunt6");
    Eu7df = CkJsonObject_stringOf(jResp,"view.execution.eu7df");
    Utd70 = CkJsonObject_stringOf(jResp,"view.execution.utd70");
    Aute_03 = CkJsonObject_BoolOf(jResp,"view.execution.aute_03");
    Culpa_5b2 = CkJsonObject_IntOf(jResp,"view.execution.culpa_5b2");
    Id = CkJsonObject_stringOf(jResp,"view.id");
    Position = CkJsonObject_stringOf(jResp,"view.position");
    Exercitatione1 = CkJsonObject_stringOf(jResp,"view.restriction.exercitatione1");
    Magna_b_3 = CkJsonObject_stringOf(jResp,"view.restriction.magna_b_3");
    Title = CkJsonObject_stringOf(jResp,"view.title");
    Updated_at = CkJsonObject_stringOf(jResp,"view.updated_at");
    i = 0;
    count_i = CkJsonObject_SizeOfArray(jResp,"columns");
    while (i < count_i) {
        CkJsonObject_putI(jResp,i);
        Duis8 = CkJsonObject_IntOf(jResp,"columns[i].Duis8");
        ullamco_0 = CkJsonObject_stringOf(jResp,"columns[i].ullamco_0");
        officia_13e = CkJsonObject_IntOf(jResp,"columns[i].officia_13e");
        ipsum_7 = CkJsonObject_stringOf(jResp,"columns[i].ipsum_7");
        in_a8 = CkJsonObject_BoolOf(jResp,"columns[i].in_a8");
        i = i + 1;
    }

    i = 0;
    count_i = CkJsonObject_SizeOfArray(jResp,"groups");
    while (i < count_i) {
        CkJsonObject_putI(jResp,i);
        laborum_a27 = CkJsonObject_BoolOf(jResp,"groups[i].laborum_a27");
        ea85c = CkJsonObject_stringOf(jResp,"groups[i].ea85c");
        occaecat_04 = CkJsonObject_IntOf(jResp,"groups[i].occaecat_04");
        qui82a = CkJsonObject_stringOf(jResp,"groups[i].qui82a");
        i = i + 1;
    }

    i = 0;
    count_i = CkJsonObject_SizeOfArray(jResp,"rows");
    while (i < count_i) {
        CkJsonObject_putI(jResp,i);
        velit21 = CkJsonObject_IntOf(jResp,"rows[i].velit21");
        ex_f = CkJsonObject_stringOf(jResp,"rows[i].ex_f");
        Excepteur_92 = CkJsonObject_stringOf(jResp,"rows[i].Excepteur_92");
        cillum4 = CkJsonObject_IntOf(jResp,"rows[i].cillum4");
        i = i + 1;
    }



    CkHttp_Dispose(http);
    CkStringBuilder_Dispose(sbResponseBody);
    CkJsonObject_Dispose(jResp);

    }

Curl Command

curl  -u login:password -X POST
	-H "Accept: application/json"
https://example.zendesk.com/api/v2/views

Postman Collection Item JSON

{
  "name": "Create View",
  "request": {
    "method": "POST",
    "header": [
      {
        "key": "Accept",
        "value": "application/json"
      }
    ],
    "url": {
      "raw": "{{baseUrl}}/api/v2/views",
      "host": [
        "{{baseUrl}}"
      ],
      "path": [
        "api",
        "v2",
        "views"
      ]
    },
    "description": "#### Allowed For\n\n* Agents\n\n#### JSON Format\n\nThe JSON format consists of one property, a `view` object that lists the values to set when the view is created.\n\n**Note**: The request must include at least one condition in the `all` array that checks one of the following fields: `status`, `type`, `group_id`, `assignee_id`, or `requester_id`.\n\n| Name        | Description\n| ----------- | -----------\n| title       | Required. The title of the view\n| all         | Required. An array of one or more conditions. A ticket must meet all of them to be included in the view. See [Conditions reference](/documentation/ticketing/reference-guides/conditions-reference)\n| any         | An array of one or more conditions. A ticket must meet any of them to be included in the view. See [Conditions reference](/documentation/ticketing/reference-guides/conditions-reference)\n| description | The description of the view\n| active      | Allowed values are true or false. Determines if the view is displayed or not\n| output      | An object that specifies the columns to display. Example: `\"output\": {\"columns\": [\"status\", \"description\", \"priority\"]}`. See [View columns](#view-columns)\n| restriction | An object that describes who can access the view. To give all agents access to the view, omit this property\n\nThe `restriction` object has the following properties.\n\n| Name | Comment\n| ---- | -------\n| type | Allowed values are \"Group\" or \"User\"\n| id   | The numeric ID of a single group or user\n| ids  | The numeric IDs of a single or more groups. Recommended for \"Group\" `type`\n\nIf `type` is \"Group\", the `ids` property is the preferred method of specifying the group id or ids.\n\n#### Example Request Body\n\n```js\n{\n  \"view\": {\n    \"title\": \"Kelly's tickets\",\n    \"raw_title\": \"{{dc.tickets_assigned_to_kelly}}\",\n    \"description\": \"Tickets that are assigned to Kelly\",\n    \"active\": true,\n    \"position\": 3,\n    \"restriction\": {\n      \"type\": \"User\",\n      \"id\": \"213977756\"\n    },\n    \"all\": [\n      {\n        \"field\": \"status\",\n        \"operator\": \"less_than\",\n        \"value\": \"solved\"\n      },\n      {\n        \"field\": \"group_id\",\n        \"operator\": \"is\",\n        \"value\": \"24000932\"\n      },\n      {\n        \"field\": \"custom_fields_360011872073\",\n        \"operator\": \"is\",\n        \"value\": \"Canada\"\n      },\n      ...\n    ],\n    \"output\": {\n      \"columns\": [\"status\", \"requester\", \"assignee\"],\n      \"group_by\": \"assignee\",\n      \"group_order\": \"desc\",\n      \"sort_by\": \"status\",\n      \"sort_order\": \"desc\"\n    }\n  }\n}\n```\n\n#### View columns\n\nThe `output` request parameter lets you specify what columns to include in the view in the agent interface. Example: `\"output\": {\"columns\": [\"status\", \"description\", \"priority\"]}`. The following table lists possible columns for views in the agent UI and the corresponding values in the `columns` array.\n\nFor custom fields, specify the id of the custom field in the `columns` array.\n\nYou can specify a total of 10 columns to a view.\n\n| View column title in UI     | Value                |\n|---------------------------- | -------------------- |\n| Assigned                    | `assigned`           |\n| Assignee                    | `assignee`           |\n| Due Date                    | `due_date`           |\n| Group                       | `group`              |\n| ID                          | `nice_id`            |\n| Updated                     | `updated`            |\n| Assignee updated            | `updated_assignee`   |\n| Requester updated           | `updated_requester`  |\n| Updater                     | `updated_by_type`    |\n| Organization                | `organization`       |\n| Priority                    | `priority`           |\n| Requested                   | `created`            |\n| Requester                   | `requester`          |\n| Requester language          | `locale_id`          |\n| Satisfaction                | `satisfaction_score` |\n| Solved                      | `solved`             |\n| Status category             | `status`             |\n| Subject                     | `description`        |\n| Submitter                   | `submitter`          |\n| Ticket form                 | `ticket_form`        |\n| Type                        | `type`               |\n| Brand                       | `brand`              |\n| Ticket status               | `custom_status_id`   |\n\n#### View sorting\n\nYou can group and sort items in the view by adding items to the `output` parameter:\n\n| Attribute                   | Description\n|-----------------------------| -----------\n| `group_by`, `sort_by`       | Sort or group the tickets by a column in the [View columns](#view-columns) table. The `subject` and `submitter` columns are not supported\n| `group_order`, `sort_order` | Either \"asc\" or \"desc\"\n"
  },
  "response": [
    {
      "name": "Success response",
      "originalRequest": {
        "method": "POST",
        "header": [
          {
            "description": "Added as a part of security scheme: basic",
            "key": "Authorization",
            "value": "Basic <credentials>"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/api/v2/views",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "api",
            "v2",
            "views"
          ]
        }
      },
      "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}"
    }
  ]
}