List training-demands
Retrieve a paginated list of training-demands that satisfy the query filters.
The training-demand represents a training request for a given employee. It may be emitted from the employee or from management.
It is subject to a prioritization process, during which management gives it a priority level (high, medium, low) in regards to its conformance to business goals, compliance with safety rules, cost, etc…
Then HR admins analyze the training request and depending on the training managment policy and the budget accept or refuse the request. Accepting the request means adding the request to a training plan which contains training sessions.
Registering an employee on a training-session is represented through setting the relationship between the training-demand and a training-session (c.f. session
and registeredOn
properties).
Once the training session is complete and the HR admins have confirmed the employee’s attendance, then a realized-training resource appears in the corresponding endpoint.
Query Parameters
Identifier of the employee that should attend this training session.
x > 1
Identifier of the training session
x > 1
Only retrieve training-demands at one of the given states.
Invalid
, Requested
, Registered
, Realized
Identifier of the training.
A session is planned for this training. Omit this parameter in order to retrieve all training demands, whether a session is planned or not.
Only retrieve training-demands for employeesthat currently belong to one of the liste of departments IDs.
Only retrieve training-demands for employeesthat currently have a work-contract with one of the listed establishment IDs.
Only retrieve training-demands that were given one of the listed priority levels.
Pagination: number of items per page. @TODO: check maximum value
0 < x < 100
Page to retrieve. Either the page index <int> or the page cursor <string>.
x > 0
Include the total number of items across all pages, as well as pointers to the previous and next pages.
prev
, next
, count
Sort items by one of their property. Syntax is:
<sort> ::= '-|+'? <property> ( ',' <property> )*
<property> ::= <strictString> ( '.' <strictString> )*
<strictString> ::= ( <char> | <digit> | '_' | '-' )+
prioritization.level
, +prioritization.level
, -prioritization.level
, createdAt
, +createdAt
, -createdAt
Response
Total number of items across all pages. You need to include ?fields.root=count to your request to retrieve this.
x > 0
Cursor to the previous page. You need to include ?fields.root=prev in order to retrieve this.
Cursor to the next page. You need to include ?fields.root=next in order to retrieve this.
Was this page helpful?