FlowmageDocs

Query records

BetaReads dataVersion 2

Reads Bullhorn records with a database-style where clause.

Settings

SettingWhat it is
ConnectionRequiredThe Bullhorn connection the step signs in with.
EntityRequiredtext
WhereRequiredBullhorn's own JPQL where clause, e.g. id > 0 AND isOpen = true.
FieldsRequiredThe fields you want back, comma-separated. Bullhorn no longer accepts * here.
Order bytext
Total onlytrue/false
Records per call1 to 500.
Skip recordsnumber
Fetch every pagePages with start until a short page, and refuses past 10,000 records.
CursorPaste a previous run's Next cursor to read the page after it.
Technical details
KeyValue
connectiontexta connection id from `requires.connections` (provider `bullhorn`)
entityTypetext
wheretext
fieldstext
orderBytext
totalOnlytrue/false, by default false
countnumber, by default 100
startnumber, by default 0
returnAlltrue/false, by default false
cursortext

Output

FieldType
recordsarray
recordCountRecords in this answernumber
totalHow many Bullhorn countednumber
hasMoreMore records are waiting behind this pageboolean
nextCursorCursor for the next pagestring
Sample output, and the expression for each field
  • hasMorefalse
  • recordCount0
  • records[]
  • total0

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>",
    "count": 100,
    "cursor": "",
    "entityType": "<entity>",
    "fields": "<fields>",
    "orderBy": "",
    "returnAll": false,
    "start": 0,
    "totalOnly": false,
    "where": "<where>"
  },
  "label": "Query records",
  "type": "bullhorn.query",
  "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 Bullhorn connection the step signs in with.
EntityRequiredtext
WhereRequiredBullhorn's own JPQL where clause, e.g. id > 0 AND isOpen = true.
FieldsRequiredThe fields you want back, comma-separated. Bullhorn no longer accepts * here.
Order bytext
Total onlytrue/false
Records per call1 to 500.
Skip recordsnumber
Fetch every pagePages with start until a short page, and refuses past 10,000 records.
Technical details
KeyValue
connectiontexta connection id from `requires.connections` (provider `bullhorn`)
entityTypetext
wheretext
fieldstext
orderBytext
totalOnlytrue/false, by default false
countnumber, by default 100
startnumber, by default 0
returnAlltrue/false, by default false