API · v1 · stabil
CODEMETA OSDeveloper Center
Konsole öffnen
Entity · training_assignments

Training Assignment Schema

Schema-ID
training_assignment
Collection
training_assignments
Permissions
  • Lesentraining_assignment_view
  • Anlegentraining_assignment_create
  • Änderntraining_assignment_edit
  • Löschentraining_assignment_delete

Felder

Training Assignment Schema

training_assignments4 Permissions

Schema for validating training assignment entities (Schulungszuweisungen)

employeeIduuiderforderlich

UUID of the employee profile

assignedUserIduuidoptional

UUID of the user assigned to this training (for scope-based access)

nullable
courseIduuidoptional

UUID of the academy course (null for external trainings)

nullable
isExternalbooleanoptional

Whether this is an external (non-Academy) training

Default: false
externalTrainingNamestringoptional

Name of external training/certification (e.g. Microsoft AZ-900)

max 500 Zeichennullable
externalProviderstringoptional

External training provider (e.g. Microsoft, Cisco)

max 500 Zeichennullable
skillIduuidoptional

Linked skill definition UUID (auto-upgrade on completion)

nullable
typestringerforderlich

Assignment type

MANDATORYRECOMMENDEDVOLUNTARY
statusstringoptional
ASSIGNEDIN_PROGRESSCOMPLETEDOVERDUEEXEMPTEDPENDING_REVIEWREJECTED
Default: "ASSIGNED"
dueDatedateoptional

Deadline for completing the training

nullable
recurrenceMonthsnumberoptional

Recurrence interval in months (e.g. 12 for annual)

1 – 120nullable
completedAtdatetimeoptional
nullable
certificateFileIduuidoptional

UUID of uploaded completion certificate

nullable
certificateExpiresAtdateoptional

Certification expiry date

nullable
costCourseCentsnumberoptional

Course/registration fee in cents (WP-E). Sensitive — gated by training_cost_view.

≥ 0nullable
costLaborCentsnumberoptional

Labor cost (paid working time) in cents (WP-E).

≥ 0nullable
subsidyCentsnumberoptional

Subsidy / funding received in cents, reduces net cost (WP-E).

≥ 0nullable
costCurrencystringoptional

ISO 4217 currency for the cost fields (default EUR, WP-E).

max 3 Zeichennullable
costNotestringoptional

Free-text note on the training cost / funding (WP-E).

max 500 Zeichennullable
fleetDriverIduuidoptional

Fleet driver ID if this assignment was created by the UVV training workflow

nullable
trainingSessionIduuidoptional

Links this assignment to a training_session (Schulungsgruppe). The session is a scheduling wrapper; its participants ARE these assignments (consolidation, supersedes training_session_participant).

nullable
registrationStatusstringoptional

Session registration state (only for session-linked assignments; capacity → WAITLISTED).

REGISTEREDWAITLISTEDCANCELLED
nullable
attendanceStatusstringoptional

Attendance confirmation for a session-linked assignment (Teilnahmebestätigung). ATTENDED additionally sets status=COMPLETED.

PENDINGATTENDEDNO_SHOWEXCUSED
nullable
attendanceConfirmedByuuidoptional

User who confirmed attendance.

nullable
attendanceConfirmedAtdatetimeoptional
nullable
cycleNumbernumberoptional

Which recurrence cycle this assignment represents (1, 2, 3...)

≥ 1nullable
previousAssignmentIduuidoptional

Link to previous cycle training_assignment for audit trail

nullable
notesstringoptional
max 5000 Zeichennullable
submittedByUserIduuidoptional

User who self-submitted this external training

nullable
reviewedByUserIduuidoptional

Admin/HR user who approved or rejected the submission

nullable
reviewedAtdatetimeoptional

When the submission was reviewed

nullable
rejectionReasonstringoptional

Reason for rejection (if status is REJECTED)

max 2000 Zeichennullable
rejectionCountnumberoptional

Number of times this assignment submission has been rejected

≥ 0nullable

Standard-Endpoints

Diese Resource folgt dem generischen CRUD-Vertrag der Plattform. Lesen Sie die Konventionen für Pagination, Idempotenz, Optimistic Locking und Audit. Die wichtigsten Endpoints:

  • GET /api/v1/training_assignments — Liste, paginiert + filterbar
  • GET /api/v1/training_assignments/<id> — Einzelne Entity
  • POST /api/v1/training_assignments — Anlegen
  • PATCH /api/v1/training_assignments/<id> — Teil-Update
  • DELETE /api/v1/training_assignments/<id> — Soft-Delete
  • GET /api/v1/training_assignments/<id>/timeline — Audit + Aktivitäten

Suche