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

Skill Definition Schema

Schema-ID
skill_definition
Collection
skill_definitions
Permissions
  • Lesenskill_definition_view
  • Anlegenskill_definition_create
  • Ändernskill_definition_edit
  • Löschenskill_definition_delete

Felder

Skill Definition Schema

skill_definitions4 Permissions

Schema for validating skill definition entities (Skill-Katalog)

namestringerforderlich

Display name of the skill (e.g. "Windows Server", "Netzwerktechnik")

1–200 Zeichen
slugstringerforderlich

URL-safe slug, also used as tag value for dispatch compatibility

max 200 ZeichenPattern
parentIduuidoptional

Parent skill UUID for tree nesting. Null = root node. Arbitrary depth allowed.

nullable
categorystringoptional

Legacy flat category. Prefer parentId hierarchy. Auto-computed from root ancestor name.

max 200 Zeichennullable
descriptionstringoptional

Detailed description of the skill

max 2000 Zeichennullable
isActivebooleanoptional

Whether this skill is currently active and selectable

Default: true
relatedCourseIdsuuid[]optional

UUIDs of academy courses that teach this skill

Default: []
schedulingCategorystringoptional

Category for scheduling qualification matching

TECHNICALSOFTCERTIFICATIONLANGUAGEOTHERnull
nullable
requiresCertificationbooleanoptional

If true, valid employee_certifications entry required for scheduling

Default: false
requiredForSchedulingbooleanoptional

If true, this skill can be required in shift template position slots

Default: false
minimumLevelForSchedulingstringoptional

Minimum proficiency level required when used in scheduling

BEGINNERINTERMEDIATEADVANCEDEXPERTnull
nullable
isBinarybooleanoptional

If true, skill is presence-only (have it or not) — e.g. formal qualifications like Rettungssanitäter. No XP/level tracked; auto-XP awards skip this skill.

Default: false
impliedSkillIdsuuid[]optional

Skills that are automatically covered when an employee holds this skill. Example: Notfallsanitäter implies Rettungssanitäter. Only meaningful for isBinary=true; targets must also be isBinary. Cycles are rejected. Resolved transitively by the solver and replacement search.

Default: []
aiManagedbooleanoptional

If true, automatic XP awards from ticket/task completion and survey-driven level steps are applied to this skill. If false, the skill level is curated manually only (certifications, manager assignment, self-assessment). Ignored when isBinary is true.

Default: false
assetMatchRulesobject[]optional

Rules that auto-derive this skill as a ticket requirement from a customer's assets (CMDB). When a ticket is dispatched, the customer's assets are matched against these rules; each match adds this skill to the ticket's requiredSkills (source ASSET_DERIVED), so dispatch prefers technicians who hold it. Empty = the skill is never asset-derived. Example: a "WatchGuard" skill with a rule { manufacturers: ["WatchGuard"], assetSchemaPatterns: ["asset.network.firewall"] }.

Default: []
manufacturersstring[]optional

Manufacturer names matched case-insensitively (substring) against the asset manufacturer (or its asset_template manufacturer). Empty = any manufacturer.

Default: []
assetSchemaPatternsstring[]optional

Asset schema prefixes matched via prefix against the asset schema, e.g. "asset.network.firewall" or "asset.network" (all network assets). Empty = any asset type.

Default: []
minimumLevelstringoptional

Minimum proficiency the derived requirement demands when this rule matches. Null = any level.

BEGINNERINTERMEDIATEADVANCEDEXPERTnull
nullable

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

Suche