FlowmageDocs

List custom field values

BetaReads dataVersion 2

Lists the values stored in Teamtailor custom fields.

Settings

SettingWhat it is
ConnectionRequiredThe Teamtailor connection the step signs in with.
Custom field idThe List custom fields node gives you the id.
Field typeFor example CustomField::Text or CustomField::Select.
Also fetchRelated records to fetch with each row, comma separated. They arrive folded into the row.
Sort byA minus in front turns the order around.
Rows per call1 to 30 — Teamtailor's own maximum is 30.
Fetch every pageFollows Teamtailor's own next-page link, and refuses past 5,000 values rather than answering a short list.
CursorPaste a previous run's Next cursor to read the page after it.
Technical details
KeyValue
connectiontexta connection id from `requires.connections` (provider `teamtailor`)
customFieldIdtext
fieldTypetext
includetext, by default "custom-field,owner"
sorttext
pageSizenumber, by default 30
returnAlltrue/false, by default false
cursortext

Output

FieldType
itemsValuesarray
itemCountValues in this answernumber
recordCountValues matching the filter (all pages)number
hasMoreMore rows are waiting behind this pageboolean
nextUrlTeamtailor's own next-page addressstring
rawThe untouched JSON:API answerobject
nextCursorCursor for the next pagestring
Sample output, and the expression for each field
  • hasMorefalse
  • itemCount0
  • items[]
  • nextUrl""
  • raw
    • data[]
    • included[]
    • linksnull
    • metanull
  • recordCount0

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>",
    "cursor": "",
    "customFieldId": "",
    "fieldType": "",
    "include": "custom-field,owner",
    "pageSize": 30,
    "returnAll": false,
    "sort": ""
  },
  "label": "List custom field values",
  "type": "teamtailor.listCustomFieldValues",
  "version": 2
}

Older versions

A flow that already has this version keeps running it. A new step always gets the newest.

Version 1
SettingWhat it is
ConnectionRequiredThe Teamtailor connection the step signs in with.
Custom field idThe List custom fields node gives you the id.
Field typeFor example CustomField::Text or CustomField::Select.
Also fetchRelated records to fetch with each row, comma separated. They arrive folded into the row.
Sort byA minus in front turns the order around.
Rows per call1 to 30 — Teamtailor's own maximum is 30.
Fetch every pageFollows Teamtailor's own next-page link, and refuses past 5,000 values rather than answering a short list.
Technical details
KeyValue
connectiontexta connection id from `requires.connections` (provider `teamtailor`)
customFieldIdtext
fieldTypetext
includetext, by default "custom-field,owner"
sorttext
pageSizenumber, by default 30
returnAlltrue/false, by default false