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.
Headers
API key. Value must be formatted like so: lucca application={api_key}
.
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.
1 - 4
elementsIdentifier 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.
1 - 5
elementsPagination: 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.
Sort items by one of their property. Syntax is:
<sort> ::= '-|+'? <property> ( ',' <property> )*
<property> ::= <strictString> ( '.' <strictString> )*
<strictString> ::= ( <char> | <digit> | '_' | '-' )+
["-prioritization.level"]
Response
OK
The response is of type object
.