> 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/es/nuestra-pila-tecnologica/inclusive-livelihoods-taxonomy/csv-format.md).

# Formato CSV de la taxonomía

El formato CSV de Tabiya se utiliza para importar y exportar datos de la plataforma de taxonomía abierta de Tabiya.

Cada versión de la taxonomía se compone de nueve archivos CSV. Cada archivo contiene un tipo diferente de datos. Los archivos son:

* [Información del modelo](#model-info)
* [Grupos de habilidades](#skill-groups)
* [Habilidades](#skills)
* [Jerarquía de habilidades](#skill-hierarchy)
* [Relaciones entre habilidades](#skill-to-skill-relations)
* [Grupos ocupacionales](#occupation-groups)
* [Ocupaciones](#occupations)
* [Jerarquía de ocupaciones](#occupation-hierarchy)
* [Relaciones entre ocupaciones y habilidades](#occupation-to-skill-relations)
* [LICENCIA](#LICENSE)

## Notas generales sobre los campos de los archivos CSV

### Historial de UUID

Un `HISTORIAL DE UUID` campo es una [lista](#lists) de todos los UUID que se han asignado a una entidad durante su ciclo de vida, por ejemplo, cuando la entidad se crea, importa, exporta o se copia en nuestra plataforma.

Es un identificador que puede usarse para rastrear objetos no solo a lo largo de su ciclo de vida, sino también entre sistemas.

El historial de UUID está ordenado del más reciente al más antiguo.

La primera entrada de la lista es el UUID actual del objeto.\
La última entrada de la lista es el primero (*inicial*) UUID del objeto.

Las entidades de este conjunto de datos han sido asignadas con un UUID inicial. Cuando una entidad se importe en nuestra plataforma, se emitirá un nuevo UUID y se añadirá al inicio del historial de UUID.

Los UUID utilizados por la plataforma se basan en el [estándar Universally Unique Identifier v4](https://datatracker.ietf.org/doc/html/rfc4122) .

> El número máximo de UUID en el historial de un objeto está limitado a `10000`.

### URI de origen

La `URI DE ORIGEN` campo es una [URI](https://datatracker.ietf.org/doc/html/rfc3986) que apunta a la ubicación donde una entidad se definió originalmente.

> La longitud máxima de la URI de origen es de `4096` caracteres.

### ID

La `ID` campo es un identificador único para cada entidad del conjunto de datos CSV. Se utiliza para la referencia dentro del conjunto de datos CSV, por ejemplo, en las relaciones entre entidades.

Este campo no está pensado para usarse como identificador fuera del ámbito de los archivos CSV; para ese propósito debes usar la primera entrada en el [Historial de UUID](#uuid-history).

### Tipos de objeto

Los tipos de objeto se utilizan para diferenciar entre distintos tipos de entidades del conjunto de datos.

Por ejemplo, en las relaciones entre entidades, los tipos de objeto se utilizan para especificar el tipo de los objetos padre e hijo y determinar en qué archivo se pueden localizar estos objetos.

Los tipos de objeto en los archivos CSV son:

* `habilidad`: Representa una [habilidad](#skills).
* `grupo de habilidades`: Representa una [grupo de habilidades](#skill-groups).
* `ocupación ESCO`: Representa una [ocupación](#occupations) que proviene del marco ESCO.
* `ocupación local`: Representa una [ocupación](#occupations) que no proviene del marco ESCO y está definida solo en esta taxonomía.
* `grupo ocupacional`: Representa una [Grupo ocupacional](#occupation-groups).

### Listas

Las propiedades de lista se almacenan en los archivos CSV como cadenas separadas por un carácter. Actualmente, no admitimos valores que contengan una nueva línea.

### Fechas

Las fechas en los archivos CSV se almacenan en el [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) .

## Descripciones de los archivos

### Información del modelo

Contiene información sobre el modelo. El nombre del archivo de exportación es `model_info.csv`

#### Columnas

* [`HISTORIAL DE UUID`](#uuid-history): Una lista de [UUID](#uuid-history).
* `NOMBRE`: El nombre del modelo.
* `CONFIGURACIÓN REGIONAL`: El código corto de la configuración regional del modelo.
* `DESCRIPCIÓN`: La descripción del modelo.
* `VERSIÓN`: La versión del modelo.
* `PUBLICADO`: Un valor booleano que indica si el modelo está publicado o no.
* `NOTAS DE LA VERSIÓN`: Las notas de la versión del modelo.
* `FECHA DE CREACIÓN`: La [fecha](#dates) en que se creó el modelo.
* `FECHA DE ACTUALIZACIÓN`: La [fecha](#dates) en que el modelo fue actualizado por última vez.\\

### Habilidades

Contiene las habilidades de la taxonomía. El nombre del archivo de exportación es `skills.csv`

#### Columnas

* [`URI DE ORIGEN`](#origin-uri): Un [URI](#origin-uri) que apunta a la ubicación donde la habilidad se definió originalmente.
* [`ID`](#id): Un [identificador único](#id), utilizado para referenciar la habilidad dentro del conjunto de datos CSV.
* [`HISTORIAL DE UUID`](#uuid-history): Una lista de [UUID](#uuid-history).
* `TIPO_DE_HABILIDAD`: El tipo de habilidad.
  * Valores posibles: `habilidad/competencia`,`conocimiento`,`idioma`,`actitud` o vacío ( ).
* `NIVEL_DE_REUTILIZACIÓN`: El nivel de reutilización de la habilidad.
  * Valores posibles: `específico del sector`,`específico de la ocupación`,`intersectorial`,`transversal` o vacío ( ).
* `ETIQUETA_PREFERIDA`: La etiqueta preferida de la habilidad.
* `ETIQUETAS_ALTERNATIVAS`: Un [lista](#lists) de etiquetas alternativas para la habilidad.
  * Longitud máxima por etiqueta: `256` caracteres.
  * Número máximo de etiquetas: `100`.
* `DESCRIPCIÓN`: La descripción de la habilidad.
  * Longitud máxima:`4000` caracteres.
* `DEFINICIÓN`: La definición de la habilidad.
  * Longitud máxima:`4000` caracteres.
* `NOTA_DE_ALCANCE`: La nota de alcance de la habilidad.
  * Longitud máxima:`4000` caracteres.
* `ESTÁ_LOCALIZADA`: Un valor booleano que indica si la habilidad está localizada o no.
  * Valores posibles: `verdadero` o `falso`.
* `FECHA DE CREACIÓN`: La [fecha](#dates) la habilidad fue creada.
* `FECHA DE ACTUALIZACIÓN`: La [fecha](#dates) la habilidad fue actualizada por última vez.\\

### Grupos de habilidades

Contiene los grupos de habilidades de la taxonomía. El nombre del archivo de exportación es `skill_groups.csv`

#### Columnas

* [`URI DE ORIGEN`](#origin-uri): Un [URI](#origin-uri) que apunta a la ubicación donde se definió originalmente el grupo de habilidades.
* [`ID`](#id): Un [identificador único](#id), utilizada para referenciar el grupo de habilidades dentro del conjunto de datos CSV.
* [`HISTORIAL DE UUID`](#uuid-history): Una lista de [UUID](#uuid-history).
* `CÓDIGO`: Código del grupo de habilidades tal como se define en ESCO. Tiene el formato general `SX.X.X`, donde `X` es un número.
* `ETIQUETA_PREFERIDA`: La etiqueta preferida del grupo de habilidades.
* `ETIQUETAS_ALTERNATIVAS`: Un [lista](#lists) de etiquetas alternativas para el grupo de habilidades.
  * Longitud máxima por etiqueta: `256` caracteres.
  * Número máximo de etiquetas: `100`.
* `DESCRIPCIÓN`: La descripción del grupo de habilidades.
  * Longitud máxima:`4000` caracteres.
* `NOTA_DE_ALCANCE`: La nota de alcance del grupo de habilidades.
  * Longitud máxima:`4000` caracteres.
* `FECHA DE CREACIÓN`: La [fecha](#dates) se creó el grupo de habilidades.
* `FECHA DE ACTUALIZACIÓN`: La [fecha](#dates) se actualizó el grupo de habilidades por última vez.

### Ocupaciones

Contiene las ocupaciones de la taxonomía. El nombre del archivo de exportación es `occupations.csv`

#### Columnas

* [`URI DE ORIGEN`](#origin-uri): Un [URI](#origin-uri) que apunta a la ubicación donde se definió originalmente la ocupación.
* [`ID`](#id): Un [identificador único](#id), utilizada para referenciar la ocupación dentro del conjunto de datos CSV.
* [`HISTORIAL DE UUID`](#uuid-history): Una lista de [UUID](#uuid-history).
* `CÓDIGO_DE_GRUPO_DE_OCUPACIÓN`: El grupo ocupacional al que pertenece la ocupación.
* `CÓDIGO`: Un código de ocupación asignado a la ocupación.
  * Para las ocupaciones ESCO, el código será el código padre, seguido de un `.` y cualquier número de dígitos. Ej: `XXXX.1234`
  * Para las ocupaciones locales, el código será el código padre, seguido de un `_` y cualquier número de dígitos. `XXXX_1234`
* `ETIQUETA_PREFERIDA`: La etiqueta preferida de la ocupación.
* `ETIQUETAS_ALTERNATIVAS`: Un [lista](#lists) de etiquetas alternativas para la ocupación.
  * Longitud máxima por etiqueta: `256` caracteres.
  * Número máximo de etiquetas: `100`.
* `DESCRIPCIÓN`: La descripción de la ocupación.
  * Longitud máxima:`4000` caracteres.
* `DEFINICIÓN`: La definición de la ocupación.
  * Longitud máxima:`4000` caracteres.
* `NOTA_DE_ALCANCE`: La nota de alcance de la ocupación.
  * Longitud máxima:`4000` caracteres.
* `NOTA_DE_PROFESIÓN_REGULADA`: La nota de profesión regulada.
  * Longitud máxima:`4000` caracteres.
* `TIPO_DE_OCUPACIÓN`: El tipo de ocupación.
  * Valores posibles: `ocupación ESCO` o `ocupación local`.
* `ESTÁ_LOCALIZADA`: Un valor booleano que indica si la ocupación está localizada o no. Solo las ocupaciones del tipo `ocupación ESCO` pueden localizarse.
  * Valores posibles: `verdadero` o `falso`.
* `FECHA DE CREACIÓN`: La [fecha](#dates) se creó la ocupación.
* `FECHA DE ACTUALIZACIÓN`: La [fecha](#dates) se actualizó la ocupación por última vez.

### Grupos ocupacionales

Contiene los grupos ocupacionales de la taxonomía. El nombre del archivo de exportación es `occupation_groups.csv`

### Columnas

* [`URI DE ORIGEN`](#origin-uri): Un [URI](#origin-uri) que apunta a la ubicación donde se definió originalmente el grupo ocupacional.
* [`ID`](#id): Un [identificador único](#id), utilizada para referenciar el grupo ocupacional dentro del conjunto de datos CSV.
* [`HISTORIAL DE UUID`](#uuid-history): Una lista de [UUID](#uuid-history).
* `CÓDIGO`: Un código de identificación de cuatro dígitos del grupo ocupacional. Cada dígito representa un nivel en la jerarquía.
  * Para los grupos ISCO, el código tiene un máximo de 4 dígitos, y cada grupo hijo debe tener un código que comience con el código del grupo padre. Ej: `1234`
  * Para los grupos locales sin un grupo padre, el código debe comenzar con un carácter alfabético. Ej: `A1234`
  * Para los grupos locales, si el grupo ocupacional padre es un grupo ISCO, el código debe comenzar con el código del grupo padre y luego tener un carácter alfabético. Ej: `1234A`
  * Para los grupos locales, si el grupo ocupacional padre también es un grupo local, el código debe comenzar con el código del grupo padre y luego tener ya sea un carácter alfabético o un número. Ej: `1234AB` o `1234A1`
* `TIPO_DE_GRUPO`: El tipo del grupo ocupacional.
  * Valores posibles: `grupo ISCO` o `grupo local`.
* `ETIQUETA_PREFERIDA`: La etiqueta preferida del grupo ocupacional.
* `ETIQUETAS_ALTERNATIVAS`: Un [lista](#lists) de etiquetas alternativas para el grupo ocupacional.
  * Longitud máxima por etiqueta: `256` caracteres.
  * Número máximo de etiquetas: `100`.
* `DESCRIPCIÓN`: La descripción del grupo ocupacional.
  * Longitud máxima:`4000` caracteres.
* `FECHA DE CREACIÓN`: La [fecha](#dates) se creó el grupo ocupacional.
* `FECHA DE ACTUALIZACIÓN`: La [fecha](#dates) se actualizó el grupo ocupacional por última vez.

### Relaciones entre habilidades

Contiene las relaciones entre habilidades. El nombre del archivo de exportación es `skill_to_skill_relations.csv`

#### Columnas

* `ID_DE_LA_HABILIDAD_REQUERIDA`: La [`ID`](#id) de la habilidad que requiere otra habilidad.
* `TIPO_DE_RELACIÓN`: El tipo de la relación.
  * Valores posibles: `esencial` o `opcional`.
* `ID_DE_LA_HABILIDAD_REQUERIDA`: La [`ID`](#id) de la habilidad que es requerida por otra habilidad.
* `FECHA DE CREACIÓN`: La [fecha](#dates) la relación se creó.
* `FECHA DE ACTUALIZACIÓN`: La [fecha](#dates) la relación se actualizó por última vez.

### Relaciones entre ocupaciones y habilidades

Contiene las relaciones entre ocupaciones y habilidades. El nombre del archivo de exportación es `occupation_to_skill_relations.csv`

#### Columnas

* `TIPO_DE_OCUPACIÓN`: El tipo de ocupación.
  * Valores posibles: `ocupación ESCO` o `ocupación local`.
* `ID_DE_LA_OCUPACIÓN`: La [`ID`](#id) de la ocupación.
* `TIPO_DE_RELACIÓN`: El tipo de la relación.
  * Valores posibles: `esencial`, `opcional`, o puede dejarse vacío.
* `ETIQUETA_DEL_VALOR_DE_SEÑALIZACIÓN`: La etiqueta del valor de señalización de la relación.
  * Valores posibles: `bajo`, `medio`, `alto`, o puede dejarse vacío.
* `VALOR_DE_SEÑALIZACIÓN`: El valor de señalización de la relación.
  * Un número entre `0` y `1`, o puede dejarse vacío. El único delimitador permitido para números decimales es una `.`.
* `ID_DE_LA_HABILIDAD`: La [`ID`](#id) de la habilidad.
* `FECHA DE CREACIÓN`: La [fecha](#dates) la relación se creó.
* `FECHA DE ACTUALIZACIÓN`: La [fecha](#dates) la relación se actualizó por última vez.

> Advertencia: una escooccuption no puede tener un `valor de señalización` o `etiqueta de valor de señalización`. Debe **debe** tener un `tipo de relación`.\
> Para las localoccupations `valor de señalización` y `tipo de relación` son mutuamente excluyentes. Una `ocupación local` puede **ya sea** tener un `valor de señalización` y `etiqueta de valor de señalización` **o** puede tener un `tipo de relación`, pero no ambos.

### Jerarquía de habilidades

Contiene la estructura jerárquica de varias habilidades. El nombre del archivo de exportación es `skill_hierarchy.csv`

#### Columnas

* `TIPO_DE_OBJETO_PADRE`: El tipo del objeto padre.
  * Valores posibles: `habilidad` o `grupo de habilidades`.
* `ID_DEL_PADRE`: La [`ID`](#id) del objeto padre.
* `ID_DEL_HIJO`: La [`ID`](#id) del objeto hijo.
* `TIPO_DE_OBJETO_HIJO`: El tipo del objeto hijo.
  * Valores posibles: `habilidad` o `grupo de habilidades`.
* `FECHA DE CREACIÓN`: La [fecha](#dates) la relación se creó.
* `FECHA DE ACTUALIZACIÓN`: La [fecha](#dates) la relación se actualizó por última vez.

> Advertencia: una habilidad no puede ser el padre de un grupo de habilidades.

### Jerarquía de ocupaciones

Contiene la estructura jerárquica de varias ocupaciones. El nombre del archivo de exportación es `occupation_hierarchy.csv`

#### Columnas

* `TIPO_DE_OBJETO_PADRE`: El tipo del objeto padre.
  * Valores posibles: `grupo ocupacional`, `ocupación ESCO`, `ocupación local`.
* `ID_DEL_PADRE`: La [`ID`](#id) del objeto padre.
* `ID_DEL_HIJO`: La [`ID`](#id) del objeto hijo.
* `TIPO_DE_OBJETO_HIJO`: El tipo del objeto hijo.
  * Valores posibles: `grupo ocupacional`, `ocupación ESCO`, `ocupación local`.
* `FECHA DE CREACIÓN`: La [fecha](#dates) la relación se creó.
* `FECHA DE ACTUALIZACIÓN`: La [fecha](#dates) la relación se actualizó por última vez.

> Advertencia: Un `ocupación ESCO` no puede ser el padre de un 'occupationgroup'.\
> Advertencia: Un `ocupación local` puede ser un hijo de un `ocupación ESCO` o de otro `ocupación local`.

### LICENCIA

Contiene la información de la licencia del modelo. Si se desea añadir una licencia al conjunto de datos, puede añadirse a un archivo llamado `LICENCIA` en la raíz del conjunto de datos.\
El `LICENCIA` archivo admite texto sin formato y formato Markdown. Durante la exportación, la información de la licencia del modelo también se exportará en el `LICENCIA` archivo.


---

# 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/es/nuestra-pila-tecnologica/inclusive-livelihoods-taxonomy/csv-format.md?ask=<question>&goal=<user_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.
