Zendesk Connector App

This workspace contains the Zendesk Connector App for IXON Cloud. It can be used to present and create machine and user specific service tickets in the IXON Cloud. It is based on the IXON Cloud Custom Component Development Kit and IXON Cloud Backend Component Workspace. Note that this app is built with Svelte, Typescript, SCSS and Python. It requires you to be familiar with the Node.js ecosystem.

Testing locally

Install the dependencies...

npm install

...login to your IXON Cloud account...

npx cdk login

...and run the simulator:

npx cdk simulate zendesk-connector

...this opens the simulator app in a browser and builds the component in watch-mode, which means that any changes to the component source files will trigger a rebuild and will auto-reload the simulator.

To run the Cloud Functions call:

make run

...no additional commands are required, as this is automatically sets up your virtual environment and installs dependencies.

Documentation

To check out docs and examples on how to develop an App, visit Custom Component Development Docs and Cloud Functions Development Docs.

The @ixon-cdk/runner page has a complete overview of all commands that can be run in a component workspace project.

Context config

{
  "values": {
    "zendesk_email": "x",
    "zendesk_token": "y",
    "zendesk_subdomain": "z",
    "custom_fields": [
      {
        "ixon": "comSerial",
        "zendesk": 11910782571793
      }
    ]
  }
}

• zendesk_email: is the email address of the zendesk admin
• zendesk_token: is the token of the zendesk admin: In Admin Center, click Apps and integrations in the sidebar, then select APIs > Zendesk API. Click the Add API token button to the right of Active API tokens. The token is generated and displayed.
• zendesk_subdomain: is the subdomain of the zendesk admin, example: https://ixon.zendesk.com -> ixon
• custom_fields: is used to map IXON custom field to a Zendesk custom field to automatically add the field value to a Zendesk ticket upon creation. You can add multiple mappings to this array.
  • Create Zendesk custom fields in the Admin Center / Objects and rules / Tickets / Fields
  • create IXON ustom fields in the Admin app / Custom fields