OTYSSettings
| Setting | What it is |
|---|---|
| ConnectionRequired | The OTYS connection the step signs in with. |
| ServiceRequired | The OTYS data service, as spelled at ows.otys.nl/info — CandidateService, VacancyService, RelationService. |
| Fields to fetch | The fields you want back, as OTYS's `what` object: a 1 for each field. Ask for what you need — OTYS gets slower and less stable when you take its defaults. |
| Filter | OTYS's condition tree. {"type":"COND","field":…,"op":…,"param":…}, or {"type":"AND","items":[…]}. Operators: EQ NE GE GT LE LT T F LIKE NLIKE. Leave empty for every record. |
| Sort by | {"Person.lastName":"ASC"} — OTYS gives no order guarantee across pages without one. |
| Records per call | 1 to 200 — OTYS never returns more than 200, whatever you ask. |
| Skip records | number |
| Fetch every page | Pages on offset until the total is read, and refuses past 10,000 records rather than answering a short list. |
| Language | Sets the language for THIS call only, through LanguageService.wrapRequest. The connection's own language is never changed. |
| Cursor | Paste a previous run's Next cursor to read the page after it. |
Technical details
| Key | Value |
|---|---|
connection | texta connection id from `requires.connections` (provider `otys`) |
service | text |
what | any JSON |
condition | any JSON |
sort | any JSON |
limit | number, by default 100 |
offset | number, by default 0 |
returnAll | true/false, by default false |
language | text |
cursor | text |
Output
| Field | Type |
|---|---|
records | array |
recordCountRecords in this answer | number |
totalHow many OTYS counted | number |
hasMoreMore records are waiting behind this page | boolean |
nextCursorCursor for the next page | string |
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>",
"cursor": "",
"language": "",
"limit": 100,
"offset": 0,
"returnAll": false,
"service": "<service>"
},
"label": "Search records",
"type": "otys.search",
"version": 2
}Older versions
A flow that already has this version keeps running it. A new step always gets the newest.
Version 1
| Setting | What it is |
|---|---|
| ConnectionRequired | The OTYS connection the step signs in with. |
| ServiceRequired | The OTYS data service, as spelled at ows.otys.nl/info — CandidateService, VacancyService, RelationService. |
| Fields to fetch | The fields you want back, as OTYS's `what` object: a 1 for each field. Ask for what you need — OTYS gets slower and less stable when you take its defaults. |
| Filter | OTYS's condition tree. {"type":"COND","field":…,"op":…,"param":…}, or {"type":"AND","items":[…]}. Operators: EQ NE GE GT LE LT T F LIKE NLIKE. Leave empty for every record. |
| Sort by | {"Person.lastName":"ASC"} — OTYS gives no order guarantee across pages without one. |
| Records per call | 1 to 200 — OTYS never returns more than 200, whatever you ask. |
| Skip records | number |
| Fetch every page | Pages on offset until the total is read, and refuses past 10,000 records rather than answering a short list. |
| Language | Sets the language for THIS call only, through LanguageService.wrapRequest. The connection's own language is never changed. |
Technical details
| Key | Value |
|---|---|
connection | texta connection id from `requires.connections` (provider `otys`) |
service | text |
what | any JSON |
condition | any JSON |
sort | any JSON |
limit | number, by default 100 |
offset | number, by default 0 |
returnAll | true/false, by default false |
language | text |