Schema · Standard Kompass
Schema Kompass struttura dati dello standard
La struttura dati formale dietro lo standard Kompass — schema JSON, nomi dei campi, intervalli di valori, regole di validazione. Per IT HR, integrazioni e partner che costruiscono sui dati Kompass.
- Schema JSON
- Leggibile da macchina e validabile
- Versionato (v1.0)
PDF · Specifica tecnica
Schema Kompass — specifica completa
La struttura dati completa in PDF: tutti i campi, tutti gli intervalli di valori, tutte le regole di validazione. Include JSON di esempio, note di versionamento e percorsi di migrazione. Gratuito, senza registrazione.
Perché i dati strutturati contano accanto al testo discorsivo.
01 — Perché uno schema formale?
- Leggibilità da macchina — i sistemi di terze parti analizzano direttamente i certificati Kompass
- Confrontabilità — stessi campi per ogni certificato, scale confrontabili tra aziende e settori
- Validazione — verifica automatica di completezza e coerenza prima dell'emissione
- Protezione dalla manipolazione — schema + impronta SHA-256 permettono ricostruzione non alterata
Campi di livello superiore di un certificato Kompass.
02 — Oggetto radice
- schemaVersion (string) — p. es. «kompass/1.0»
- issuedAt (date) — data di emissione, ISO 8601
- subject (object) — dati personali della persona valutata
- company (object) — dati anagrafici dell'azienda emittente
- assessment (object) — i cinque ambiti di prestazione, testi narrativi, conclusione
Chi viene valutato, chi emette il certificato.
03 — subject e company
- subject.firstName, lastName (string, obbligatorio)
- subject.birthDate (date, opzionale)
- subject.position (string) — funzione o titolo
- subject.employmentStart, employmentEnd (date) — periodo di impiego
- company.name, address, uid, city (string)
I cinque ambiti di prestazione, ciascuno con stato e frase di prova.
04 — Blocco assessment
- fields (array) — cinque voci: 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 caratteri) — frase di prova osservabile
- narrative (object) — compiti, contributi, prove di competenza, stile di lavoro come testo discorsivo
- schluss (object) — motivo di uscita, ringraziamento, augurio per il futuro
Cosa controlla il motore dello schema prima dell'emissione.
05 — Regole di validazione
- Campi obbligatori presenti (subject.firstName/lastName/position, company.name, assessment.fields)
- Esattamente cinque voci fields con le chiavi definite
- Stato dall'enum fisso, nessun valore in testo libero
- Campi data nel formato ISO 8601, employmentEnd ≥ employmentStart
Come si introducono nuove versioni dello schema.
06 — Versionamento e compatibilità
- Versionamento semantico (Major.Minor) — schemaVersion sempre nell'oggetto radice
- Aggiornamenti Minor sono retrocompatibili (campi opzionali aggiuntivi)
- Aggiornamenti Major prevedono percorso di migrazione e periodo di transizione di 12 mesi
- I validatori rilevano la versione e applicano l'insieme di regole corrispondente
Continua a leggere
Pagine di approfondimento
FAQ
Domande frequenti
Lo schema è aperto?
Sì. Lo schema è documentato in modo aperto e può essere utilizzato da qualsiasi fornitore, sistema HR o integratore. La specifica PDF qui sopra contiene tutti i campi, intervalli di valori e regole di validazione. Un file JSON Schema leggibile da macchina è disponibile su richiesta.
Che relazione c'è tra lo schema e l'output PDF?
Lo schema è la fonte dati, il PDF la rappresentazione. Da un JSON conforme allo schema, ZeugnisPilot (o un sistema di terze parti) può rendere il PDF pronto per la stampa in modo deterministico. L'impronta del contenuto (SHA-256) è calcolata sul JSON normalizzato — così la manipolazione resta rilevabile anche dopo la stampa del PDF.
Posso usare lo schema nel mio sistema HR?
Sì. Se il vostro sistema deve creare o importare certificati Kompass, basta che rispetti lo schema. Validatori e JSON di esempio agevolano l'avvio. Consigliamo di iniziare con la versione 1.0 e usare il periodo di transizione per gli aggiornamenti Major.
Cosa succede in caso di errore di validazione?
Il validatore restituisce un elenco strutturato di errori (percorso del campo, regola, valore trovato, valori attesi). Il certificato non può essere emesso finché tutti gli errori non sono risolti — protegge da dati incompleti o incoerenti.
Dove trovo lo schema completo in PDF?
Direttamente qui: la specifica dello schema è disponibile in cima a questa pagina come download PDF (gratuito, senza registrazione). Contiene oggetto radice, tutti i sotto-oggetti, intervalli di valori, JSON di esempio e regole di validazione.
Applicare Kompass direttamente nel generatore
Il generatore scrive i certificati Kompass conformi allo schema per impostazione predefinita — potete concentrarvi sui contenuti invece che sui campi JSON.