FlowmageDocs

List attendances

BetaReads data

Lists Personio work and break periods for people, projects or a date range.

Settings

SettingWhat it is
ConnectionRequiredThe Personio connection the step signs in with.
Employee idsOne or more Personio person ids, comma-separated.
Attendance idstext
Project idsThe List projects node gives you these ids.
Starting on or aftertext
Starting on or beforetext
Ending on or aftertext
Ending on or beforetext
Counted fromThe day Personio books the hours on, which is not always the day they started.
Counted untiltext
Changed aftertext
Changed beforetext
Approval status"" or "PENDING" or "CONFIRMED" or "REJECTED"
Sort byComma-separated; a leading minus sorts descending. Allowed: person.id, start.date_time, end.date_time, updated_at, status.
CursorPaste a previous run's Next cursor to read the page after it.
Periods per call1 to 100.
Fetch every pageFollows Personio's next-page cursor, and refuses past 5,000 periods rather than answering a short list.
Technical details
KeyValue
connectiontexta connection id from `requires.connections` (provider `personio`)
personIdstext
idstext
projectIdstext
startFromtext
startUntiltext
endFromtext
endUntiltext
attributionFromtext
attributionUntiltext
updatedAftertext
updatedBeforetext
status"" or "PENDING" or "CONFIRMED" or "REJECTED"
sorttext
cursortext
limitnumber, by default 100
returnAlltrue/false, by default false

Output

FieldType
attendancesWork and break periodsarray
attendanceCountPeriods in this answernumber
hasMoreMore periods are waiting behind this pageboolean
nextCursorCursor for the next pagestring
Sample output, and the expression for each field
  • attendanceCount0
  • attendances[]
  • hasMorefalse
  • nextCursor""

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": {
    "attributionFrom": "",
    "attributionUntil": "",
    "connection": "<connection id>",
    "cursor": "",
    "endFrom": "",
    "endUntil": "",
    "ids": "",
    "limit": 100,
    "personIds": "",
    "projectIds": "",
    "returnAll": false,
    "sort": "",
    "startFrom": "",
    "startUntil": "",
    "status": "",
    "updatedAfter": "",
    "updatedBefore": ""
  },
  "label": "List attendances",
  "type": "personio.listAttendances",
  "version": 1
}