TOPdeskSettings
| Setting | What it is |
|---|---|
| ConnectionRequired | The TOPdesk connection the step signs in with. |
| Filter | TOPdesk's own FIQL filter, e.g. status==firstLine;caller.dynamicName=="Adams". |
| Sort by | field:asc,field:desc. Sorting on callDate, creationDate, modificationDate, targetDate, closedDate or id is the fast path. |
| Fields to fetch | By default TOPdesk returns every field, which is slow. Name the ones you need. |
| Calls per call | 1 to 10,000. TOPdesk's own default is 10 — this one is 200 so a list is not silently short. |
| Fetch every page | Pages with pageStart until a short page, and refuses past 10,000 calls. Set a sort first — TOPdesk gives no order guarantee across pages. |
Technical details
| Key | Value |
|---|---|
connection | texta connection id from `requires.connections` (provider `topdesk`) |
query | text |
sort | text |
fields | text |
pageSize | number, by default 200 |
returnAll | true/false, by default false |
Output
| Field | Type |
|---|---|
incidentsCalls | array |
incidentCountCalls in this answer | number |
Sample output, and the expression for each field
- incidentCount0
- incidents[]
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": {
"connection": "<connection id>",
"fields": "",
"pageSize": 200,
"query": "",
"returnAll": false,
"sort": ""
},
"label": "List calls",
"type": "topdesk.listIncidents",
"version": 1
}