> For the complete documentation index, see [llms.txt](https://docs.tabiya.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tabiya.org/tabiya-documentation/deutsch/unser-technologie-stack/inclusive-livelihoods-taxonomy/csv-format.md). # CSV-Format der Taxonomie Das Tabiya-CSV-Format wird verwendet, um Daten von und zur Tabiya Open Taxonomy Platform zu importieren und zu exportieren. Jede Taxonomieversion besteht aus neun CSV-Dateien. Jede Datei enthält einen anderen Datentyp. Die Dateien sind: * [Modellinformationen](#model-info) * [Skill-Gruppen](#skill-groups) * [Fähigkeiten](#skills) * [Skill-Hierarchie](#skill-hierarchy) * [Skill-zu-Skill-Beziehungen](#skill-to-skill-relations) * [Berufsgruppen](#occupation-groups) * [Berufe](#occupations) * [Berufshierarchie](#occupation-hierarchy) * [Berufs-zu-Skill-Beziehungen](#occupation-to-skill-relations) * [LIZENZ](#LICENSE) ## Allgemeine Hinweise zu den Feldern der CSV-Dateien ### UUID-Historie Ein `UUIDHISTORY` ist eine [Liste](#lists) aller UUIDs, die einer Entität während ihres Lebenszyklus zugewiesen wurden, z. B. wenn die Entität erstellt, importiert, exportiert oder in unsere Plattform kopiert wird. Es ist ein Bezeichner, der nicht nur über ihren Lebenszyklus hinweg, sondern auch systemübergreifend zum Verfolgen von Objekten verwendet werden kann. Die UUID-Historie ist von der neuesten zur ältesten UUID geordnet. Der erste Eintrag in der Liste ist die aktuelle UUID des Objekts.\ Der letzte Eintrag in der Liste ist die allererste (*ursprüngliche*) UUID des Objekts. Den Entitäten in diesem Datensatz wurde eine anfängliche UUID zugewiesen. Wenn eine Entität in unsere Plattform importiert wird, wird eine neue UUID vergeben und oben in der UUID-Historie hinzugefügt. Die von der Plattform verwendeten UUIDs basieren auf dem [UUID-v4](https://datatracker.ietf.org/doc/html/rfc4122) Standard. > Die maximale Anzahl von UUIDs in der Historie eines Objekts ist begrenzt auf `10000`. ### Ursprungs-URI Die `ORIGINURI` ist eine [URI](https://datatracker.ietf.org/doc/html/rfc3986) die auf den Ort verweist, an dem eine Entität ursprünglich definiert wurde. > Die maximale Länge der Ursprungs-URI beträgt `4096` Zeichen. ### ID Die `ID` ist ein eindeutiger Bezeichner für jede Entität im CSV-Datensatz. Er wird für Verweise innerhalb des CSV-Datensatzes verwendet, zum Beispiel in den Beziehungen zwischen Entitäten. Dieses Feld ist nicht dazu gedacht, als Bezeichner außerhalb des Geltungsbereichs der CSV-Dateien verwendet zu werden; für diesen Zweck sollten Sie den ersten Eintrag in der [UUID-Historie](#uuid-history). ### Objekttypen Die Objekttypen werden verwendet, um zwischen verschiedenen Entitätstypen im Datensatz zu unterscheiden. Zum Beispiel werden in Beziehungen zwischen Entitäten die Objekttypen verwendet, um den Typ der übergeordneten und untergeordneten Objekte anzugeben und festzulegen, in welcher Datei diese Objekte zu finden sind. Die Objekttypen in den CSV-Dateien sind: * `skill`: Repräsentiert eine [skill](#skills). * `skillgroup`: Repräsentiert eine [Skill-Gruppe](#skill-groups). * `escooccupation`: Repräsentiert einen [occupation](#occupations) die aus dem ESCO-Rahmenwerk stammt. * `localoccupation`: Repräsentiert einen [occupation](#occupations) die nicht aus dem ESCO-Rahmenwerk stammt und nur in dieser Taxonomie definiert ist. * `occupationgroup`: Repräsentiert einen [Berufsgruppe](#occupation-groups). ### Listen Listen-Eigenschaften werden in den CSV-Dateien als durch ein Zeichen getrennte Zeichenfolgen gespeichert. Derzeit unterstützen wir keine Werte, die einen Zeilenumbruch enthalten. ### Datumsangaben Die Datumsangaben in den CSV-Dateien werden im [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) Format gespeichert. ## Dateibeschreibungen ### Modellinformationen Enthält Informationen über das Modell. Der Export-Dateiname ist `model_info.csv` #### Spalten * [`UUIDHISTORY`](#uuid-history): Eine Liste von [UUIDs](#uuid-history). * `NAME`: Der Name des Modells. * `LOCALE`: Der Kurzcode der Gebietssprache des Modells. * `DESCRIPTION`: Die Beschreibung des Modells. * `VERSION`: Die Version des Modells. * `RELEASED`: Ein boolescher Wert, der angibt, ob das Modell veröffentlicht ist oder nicht. * `RELEASENOTES`: Die Veröffentlichungsnotizen des Modells. * `CREATEDAT`: Das [Datum](#dates) an dem das Modell erstellt wurde. * `UPDATEDAT`: Das [Datum](#dates) das Modell zuletzt aktualisiert wurde. ### Fähigkeiten Enthält die Skills der Taxonomie. Der Export-Dateiname ist `skills.csv` #### Spalten * [`ORIGINURI`](#origin-uri): Ein [URI](#origin-uri) die auf den Ort verweist, an dem der Skill ursprünglich definiert wurde. * [`ID`](#id): Ein [eindeutiger Bezeichner](#id), verwendet zur Referenzierung des Skills innerhalb des CSV-Datensatzes. * [`UUIDHISTORY`](#uuid-history): Eine Liste von [UUIDs](#uuid-history). * `SKILLTYPE`: Der Skill-Typ. * Mögliche Werte: `Fähigkeit/Kompetenz`,`Wissen`,`Sprache`,`Einstellung` oder leer ( ). * `REUSELEVEL`: Das Wiederverwendungsniveau des Skills. * Mögliche Werte: `sektorspezifisch`,`berufsspezifisch`,`sektorübergreifend`,`transversal` oder leer ( ). * `PREFERREDLABEL`: Die bevorzugte Bezeichnung des Skills. * `ALTLABELS`: Ein [Liste](#lists) von alternativen Bezeichnungen für den Skill. * Maximale Länge pro Bezeichnung: `256` Zeichen. * Maximale Anzahl von Bezeichnungen: `100`. * `DESCRIPTION`: Die Beschreibung des Skills. * Maximale Länge:`4000` Zeichen. * `DEFINITION`: Die Definition des Skills. * Maximale Länge:`4000` Zeichen. * `SCOPENOTE`: Die Anmerkung zum Anwendungsbereich des Skills. * Maximale Länge:`4000` Zeichen. * `ISLOCALIZED`: Ein boolescher Wert, der angibt, ob der Skill lokalisiert ist oder nicht. * Mögliche Werte: `true` oder `false`. * `CREATEDAT`: Das [Datum](#dates) der Skill erstellt wurde. * `UPDATEDAT`: Das [Datum](#dates) der Skill zuletzt aktualisiert wurde.\\ ### Skill-Gruppen Enthält die Skill-Gruppen der Taxonomie. Der Export-Dateiname ist `skill_groups.csv` #### Spalten * [`ORIGINURI`](#origin-uri): Ein [URI](#origin-uri) die auf den Ort verweist, an dem die Skill-Gruppe ursprünglich definiert wurde. * [`ID`](#id): Ein [eindeutiger Bezeichner](#id), verwendet zur Referenzierung der Skill-Gruppe innerhalb des CSV-Datensatzes. * [`UUIDHISTORY`](#uuid-history): Eine Liste von [UUIDs](#uuid-history). * `CODE`: SkillGroup-Code, wie in ESCO definiert. Er hat das allgemeine Format `SX.X.X`, wobei `X` eine Zahl ist. * `PREFERREDLABEL`: Die bevorzugte Bezeichnung der Skill-Gruppe. * `ALTLABELS`: Ein [Liste](#lists) von alternativen Bezeichnungen für die Skill-Gruppe. * Maximale Länge pro Bezeichnung: `256` Zeichen. * Maximale Anzahl von Bezeichnungen: `100`. * `DESCRIPTION`: Die Beschreibung der Skill-Gruppe. * Maximale Länge:`4000` Zeichen. * `SCOPENOTE`: Die Anmerkung zum Anwendungsbereich der Skill-Gruppe. * Maximale Länge:`4000` Zeichen. * `CREATEDAT`: Das [Datum](#dates) die Skill-Gruppe erstellt wurde. * `UPDATEDAT`: Das [Datum](#dates) die Skill-Gruppe zuletzt aktualisiert wurde. ### Berufe Enthält die Berufe der Taxonomie. Der Export-Dateiname ist `occupations.csv` #### Spalten * [`ORIGINURI`](#origin-uri): Ein [URI](#origin-uri) die auf den Ort verweist, an dem der Beruf ursprünglich definiert wurde. * [`ID`](#id): Ein [eindeutiger Bezeichner](#id), verwendet zur Referenzierung des Berufs innerhalb des CSV-Datensatzes. * [`UUIDHISTORY`](#uuid-history): Eine Liste von [UUIDs](#uuid-history). * `OCCUPATIONGROUPCODE`:Die Berufsgruppe, zu der der Beruf gehört. * `CODE`: Ein dem Beruf zugewiesener Berufscode. * Für ESCO-Berufe besteht der Code aus dem übergeordneten Code, gefolgt von einem `.` und beliebig vielen Ziffern. Z. B.: `XXXX.1234` * Für lokale Berufe besteht der Code aus dem übergeordneten Code, gefolgt von einem `_` und beliebig vielen Ziffern. `XXXX_1234` * `PREFERREDLABEL`: Die bevorzugte Bezeichnung des Berufs. * `ALTLABELS`: Ein [Liste](#lists) von alternativen Bezeichnungen für den Beruf. * Maximale Länge pro Bezeichnung: `256` Zeichen. * Maximale Anzahl von Bezeichnungen: `100`. * `DESCRIPTION`: Die Beschreibung des Berufs. * Maximale Länge:`4000` Zeichen. * `DEFINITION`: Die Definition des Berufs. * Maximale Länge:`4000` Zeichen. * `SCOPENOTE`: Die Anmerkung zum Anwendungsbereich des Berufs. * Maximale Länge:`4000` Zeichen. * `REGULATEDPROFESSIONNOTE`: Die Anmerkung zur reglementierten Berufsausübung. * Maximale Länge:`4000` Zeichen. * `OCCUPATIONTYPE`: Der Typ des Berufs. * Mögliche Werte: `escooccupation` oder `localoccupation`. * `ISLOCALIZED`: Ein boolescher Wert, der angibt, ob der Beruf lokalisiert ist oder nicht. Nur Berufe des Typs `escooccupation` können lokalisiert werden. * Mögliche Werte: `true` oder `false`. * `CREATEDAT`: Das [Datum](#dates) der Beruf erstellt wurde. * `UPDATEDAT`: Das [Datum](#dates) der Beruf zuletzt aktualisiert wurde. ### Berufsgruppen Enthält die Berufsgruppen der Taxonomie. Der Export-Dateiname ist `occupation_groups.csv` ### Spalten * [`ORIGINURI`](#origin-uri): Ein [URI](#origin-uri) die auf den Ort verweist, an dem die Berufsgruppe ursprünglich definiert wurde. * [`ID`](#id): Ein [eindeutiger Bezeichner](#id), verwendet zur Referenzierung der Berufsgruppe innerhalb des CSV-Datensatzes. * [`UUIDHISTORY`](#uuid-history): Eine Liste von [UUIDs](#uuid-history). * `CODE`: Ein vierstelliger Identifikationscode der Berufsgruppe. Jede Ziffer stellt eine Ebene in der Hierarchie dar. * Für ISCO-Gruppen besteht der Code aus maximal 4 Ziffern, und jede Untergruppe sollte einen Code haben, der mit dem Code der übergeordneten Gruppe beginnt. Z. B.: `1234` * Für lokale Gruppen ohne übergeordnete Gruppe sollte der Code mit einem alphabetischen Zeichen beginnen. Z. B.: `A1234` * Für lokale Gruppen, wenn die übergeordnete Berufsgruppe eine ISCO-Gruppe ist, sollte der Code mit dem Code der übergeordneten Gruppe beginnen und dann ein alphabetisches Zeichen enthalten. Z. B.: `1234A` * Für lokale Gruppen, wenn die übergeordnete Berufsgruppe ebenfalls eine lokale Gruppe ist, sollte der Code mit dem Code der übergeordneten Gruppe beginnen und dann entweder ein alphabetisches Zeichen oder eine Zahl enthalten. Z. B.: `1234AB` oder `1234A1` * `GROUPTYPE`: Der Typ der Berufsgruppe. * Mögliche Werte: `iscogroup` oder `localgroup`. * `PREFERREDLABEL`: Die bevorzugte Bezeichnung der Berufsgruppe. * `ALTLABELS`: Ein [Liste](#lists) von alternativen Bezeichnungen für die Berufsgruppe. * Maximale Länge pro Bezeichnung: `256` Zeichen. * Maximale Anzahl von Bezeichnungen: `100`. * `DESCRIPTION`: Die Beschreibung der Berufsgruppe. * Maximale Länge:`4000` Zeichen. * `CREATEDAT`: Das [Datum](#dates) die Berufsgruppe erstellt wurde. * `UPDATEDAT`: Das [Datum](#dates) die Berufsgruppe zuletzt aktualisiert wurde. ### Skill-zu-Skill-Beziehungen Enthält die Beziehungen zwischen Skills. Der Export-Dateiname ist `skill_to_skill_relations.csv` #### Spalten * `REQUIRINGID`: Das [`ID`](#id) des Skills, der einen anderen Skill benötigt. * `RELATIONTYPE`: Der Typ der Beziehung. * Mögliche Werte: `essenziell` oder `optional`. * `REQUIREDID`: Das [`ID`](#id) des Skills, der von einem anderen Skill benötigt wird. * `CREATEDAT`: Das [Datum](#dates) die Beziehung erstellt wurde. * `UPDATEDAT`: Das [Datum](#dates) die Beziehung zuletzt aktualisiert wurde. ### Berufs-zu-Skill-Beziehungen Enthält die Beziehungen zwischen Berufen und Skills. Der Export-Dateiname ist `occupation_to_skill_relations.csv` #### Spalten * `OCCUPATIONTYPE`: Der Typ des Berufs. * Mögliche Werte: `escooccupation` oder `localoccupation`. * `OCCUPATIONID`: Das [`ID`](#id) des Berufs. * `RELATIONTYPE`: Der Typ der Beziehung. * Mögliche Werte: `essenziell`, `optional`, oder es kann leer gelassen werden. * `SIGNALLINGVALUELABEL`: Die Bezeichnung des Signalisierungswerts der Beziehung. * Mögliche Werte: `niedrig`, `mittel`, `hoch`, oder es kann leer gelassen werden. * `SIGNALLINGVALUE`: Der Signalisierungswert der Beziehung. * Eine Zahl zwischen `0` und `1`, oder es kann leer gelassen werden. Das einzige zulässige Trennzeichen für Dezimalzahlen ist ein `.`. * `SKILLID`: Das [`ID`](#id) des Skills. * `CREATEDAT`: Das [Datum](#dates) die Beziehung erstellt wurde. * `UPDATEDAT`: Das [Datum](#dates) die Beziehung zuletzt aktualisiert wurde. > Achtung: Ein escooccuption kann einen `Signalisierungswert` oder `Signalisierungswertbezeichnung`. Es **muss** haben einen `relationType`.\ > Für localoccupations `Signalisierungswert` und `relationType` sind gegenseitig exklusiv. Ein `localoccupation` kann **entweder** haben einen `Signalisierungswert` und `Signalisierungswertbezeichnung` **oder** es kann einen `relationType`, aber nicht beides. ### Skill-Hierarchie Enthält die hierarchische Struktur verschiedener Skills. Der Export-Dateiname ist `skill_hierarchy.csv` #### Spalten * `PARENTOBJECTTYPE`: Der Typ des übergeordneten Objekts. * Mögliche Werte: `skill` oder `skillgroup`. * `PARENTID`: Das [`ID`](#id) des übergeordneten Objekts. * `CHILDID`: Das [`ID`](#id) des untergeordneten Objekts. * `CHILDOBJECTTYPE`: Der Typ des untergeordneten Objekts. * Mögliche Werte: `skill` oder `skillgroup`. * `CREATEDAT`: Das [Datum](#dates) die Beziehung erstellt wurde. * `UPDATEDAT`: Das [Datum](#dates) die Beziehung zuletzt aktualisiert wurde. > Achtung: Ein Skill kann nicht die übergeordnete Instanz einer Skill-Gruppe sein. ### Berufshierarchie Enthält die hierarchische Struktur verschiedener Berufe. Der Export-Dateiname ist `occupation_hierarchy.csv` #### Spalten * `PARENTOBJECTTYPE`: Der Typ des übergeordneten Objekts. * Mögliche Werte: `occupationgroup`, `escooccupation`, `localoccupation`. * `PARENTID`: Das [`ID`](#id) des übergeordneten Objekts. * `CHILDID`: Das [`ID`](#id) des untergeordneten Objekts. * `CHILDOBJECTTYPE`: Der Typ des untergeordneten Objekts. * Mögliche Werte: `occupationgroup`, `escooccupation`, `localoccupation`. * `CREATEDAT`: Das [Datum](#dates) die Beziehung erstellt wurde. * `UPDATEDAT`: Das [Datum](#dates) die Beziehung zuletzt aktualisiert wurde. > Achtung: Ein `escooccupation` kann nicht die übergeordnete Instanz eines 'occupationgroup' sein.\ > Achtung: Ein `localoccupation` kann ein untergeordnetes Element von einem `escooccupation` oder einem anderen `localoccupation`. ### LIZENZ Enthält die Lizenzinformationen für das Modell. Wenn man dem Datensatz eine Lizenz hinzufügen möchte, kann sie zu einer Datei mit dem Namen `LIZENZ` im Stammverzeichnis des Datensatzes hinzugefügt werden.\ Die `LIZENZ` Datei unterstützt Klartext- und Markdown-Format. Beim Export werden die Lizenzinformationen des Modells auch in die `LIZENZ` Datei exportiert. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.tabiya.org/tabiya-documentation/deutsch/unser-technologie-stack/inclusive-livelihoods-taxonomy/csv-format.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.