Schéma · Standard Kompass
Schéma Kompass structure de données du standard
La structure de données formelle derrière le standard Kompass — schéma JSON, noms de champs, plages de valeurs, règles de validation. Pour la DSI RH, les intégrations et les partenaires construisant sur les données Kompass.
- Schéma JSON
- Lisible par machine et validable
- Versionné (v1.0)
PDF · Spécification technique
Schéma Kompass — spécification complète
La structure de données complète au format PDF : tous les champs, toutes les plages de valeurs, toutes les règles de validation. Inclut un JSON d'exemple, des notes de versionnement et des chemins de migration. Gratuit, sans inscription.
Pourquoi les données structurées comptent à côté du texte rédigé.
01 — Pourquoi un schéma formel ?
- Lisibilité par machine — les systèmes tiers parsent les certificats Kompass directement
- Comparabilité — mêmes champs pour chaque certificat, échelles comparables entre entreprises et secteurs
- Validation — vérification automatique de l'exhaustivité et de la cohérence avant émission
- Protection contre la falsification — schéma + empreinte SHA-256 permettent une reconstruction non altérée
Champs de niveau supérieur d'un certificat Kompass.
02 — Objet racine
- schemaVersion (string) — p. ex. « kompass/1.0 »
- issuedAt (date) — date d'émission, ISO 8601
- subject (object) — données personnelles de la personne évaluée
- company (object) — données maîtres de l'entreprise émettrice
- assessment (object) — les cinq domaines de performance, textes narratifs, conclusion
Qui est évalué, qui émet le certificat.
03 — subject et company
- subject.firstName, lastName (string, obligatoire)
- subject.birthDate (date, optionnel)
- subject.position (string) — fonction ou intitulé de poste
- subject.employmentStart, employmentEnd (date) — période d'emploi
- company.name, address, uid, city (string)
Les cinq domaines de performance, chacun avec statut et phrase de preuve.
04 — Bloc assessment
- fields (array) — cinq entrées : aufgabenbewaeltigung, selbststeuerung, zusammenarbeit, entwicklung, wirkung
- fields[i].status (enum) — « anforderungen-erfuellt », « anforderungen-oft-uebertroffen », « anforderungen-deutlich-uebertroffen », « nicht-anwendbar »
- fields[i].evidenz (string, max 240 caractères) — phrase de preuve observable
- narrative (object) — tâches, contributions, preuves de compétences, style de travail rédigés
- schluss (object) — motif de départ, remerciements, vœux pour l'avenir
Ce que le moteur de schéma vérifie avant l'émission.
05 — Règles de validation
- Champs obligatoires présents (subject.firstName/lastName/position, company.name, assessment.fields)
- Exactement cinq entrées fields avec les clés définies
- Statut depuis l'enum fixe, pas de valeurs en texte libre
- Champs date au format ISO 8601, employmentEnd ≥ employmentStart
Comment les nouvelles versions de schéma sont introduites.
06 — Versionnement & compatibilité
- Versionnement sémantique (Major.Minor) — schemaVersion toujours dans l'objet racine
- Les mises à jour Minor sont rétro-compatibles (champs optionnels supplémentaires)
- Les mises à jour Major s'accompagnent d'un chemin de migration et d'une période de transition de 12 mois
- Les validateurs détectent eux-mêmes la version et appliquent l'ensemble de règles correspondant
Pour aller plus loin
Pages d'approfondissement
FAQ
Questions fréquentes
Le schéma est-il ouvert ?
Oui. Le schéma est documenté de manière ouverte et peut être utilisé par tout fournisseur, système RH ou intégrateur. La spécification PDF ci-dessus contient tous les champs, plages de valeurs et règles de validation. Un fichier JSON Schema lisible par machine est disponible sur demande.
Quel est le rapport entre le schéma et la sortie PDF ?
Le schéma est la source de données, le PDF la représentation. À partir d'un JSON conforme au schéma, ZeugnisPilot (ou un système tiers) peut générer le PDF prêt à imprimer de manière déterministe. L'empreinte de contenu (SHA-256) est calculée sur le JSON normalisé — ainsi toute manipulation reste détectable même après impression du PDF.
Puis-je utiliser le schéma dans mon propre système RH ?
Oui. Si votre système doit créer ou importer des certificats Kompass, il lui suffit de respecter le schéma. Des validateurs et des JSON exemples facilitent la prise en main. Nous recommandons de commencer par la version 1.0 et d'utiliser la période de transition pour les mises à jour Major.
Que se passe-t-il en cas d'erreur de validation ?
Le validateur renvoie une liste structurée d'erreurs (chemin du champ, règle, valeur trouvée, valeurs attendues). Le certificat ne peut être émis tant que toutes les erreurs ne sont pas corrigées — cela protège contre les données incomplètes ou incohérentes.
Où trouver le schéma complet en PDF ?
Directement ici : la spécification du schéma est disponible en haut de cette page en téléchargement PDF (gratuit, sans inscription). Elle contient l'objet racine, tous les sous-objets, les plages de valeurs, un JSON exemple et les règles de validation.
Appliquer Kompass directement dans le générateur
Le générateur écrit les certificats Kompass conformes au schéma par défaut — vous pouvez vous concentrer sur le contenu plutôt que sur les champs JSON.