TOPdeskSettings
| Setting | What it is |
|---|---|
| ConnectionRequired | The TOPdesk connection the step signs in with. |
| Caller | "email" or "id" or "unregistered" |
| Caller e-mail | text |
| Caller id | text |
| Caller name | text |
| Brief description | At most 80 characters — TOPdesk refuses a longer one. |
| Request | TOPdesk accepts only <i> <em> <b> <strong> <u> <br> <h5> <h6> and inline base64 <img> up to 450×450. |
| Status | "firstLine" or "secondLine" |
| Category | The value's name as it appears in TOPdesk — the List drop-down values node gives you the exact spelling. |
| Subcategory | The value's name as it appears in TOPdesk — the List drop-down values node gives you the exact spelling. |
| Call type | The value's name as it appears in TOPdesk — the List drop-down values node gives you the exact spelling. |
| Entry type | The value's name as it appears in TOPdesk — the List drop-down values node gives you the exact spelling. |
| Impact | The value's name as it appears in TOPdesk — the List drop-down values node gives you the exact spelling. |
| Urgency | The value's name as it appears in TOPdesk — the List drop-down values node gives you the exact spelling. |
| Priority | The value's name as it appears in TOPdesk — the List drop-down values node gives you the exact spelling. |
| Operator | The value's name as it appears in TOPdesk — the List drop-down values node gives you the exact spelling. |
| Operator group | The value's name as it appears in TOPdesk — the List drop-down values node gives you the exact spelling. |
| Your reference | TOPdesk does not check it for duplicates, so it cannot stop a call being created twice. Search for it before a create if that matters. |
| Optional fields | object of text |
Technical details
| Key | Value |
|---|---|
connection | texta connection id from `requires.connections` (provider `topdesk`) |
callerBy | "email" or "id" or "unregistered", by default "email" |
callerEmail | textused when `callerBy` is "email" |
callerId | textused when `callerBy` is "id" |
callerName | textused when `callerBy` is "unregistered" |
briefDescription | text |
request | text |
status | "firstLine" or "secondLine", by default "firstLine" |
category | text |
subcategory | text |
callType | text |
entryType | text |
impact | text |
urgency | text |
priority | text |
operator | text |
operatorGroup | text |
externalNumber | text |
optionalFields | object of text, by default {} |
Output
| Field | Type |
|---|---|
incidentIdId | string |
numberCall number | string |
incidentCall | object |
status | string |
Sample output, and the expression for each field
- incident{}
- incidentId"1"
- number"C-0001"
- status"firstLine"
Errors
When a step of this node stops a run, the run page shows a code. Look it up:
Example step
The step as a flow file holds it. Replace each value in <…>.
{
"config": {
"briefDescription": "",
"callType": "",
"callerBy": "email",
"callerEmail": "",
"callerId": "",
"callerName": "",
"category": "",
"connection": "<connection id>",
"entryType": "",
"externalNumber": "",
"impact": "",
"operator": "",
"operatorGroup": "",
"optionalFields": {},
"priority": "",
"request": "",
"status": "firstLine",
"subcategory": "",
"urgency": ""
},
"label": "Create call",
"type": "topdesk.createIncident",
"version": 1
}