# Formato CSV de la taxonomía

Cada versión de la taxonomía está compuesta por nueve archivos CSV. Cada archivo contiene un tipo de datos diferente. Los archivos son:

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

## Notas generales sobre los campos de los archivos CSV

### Historial de UUID

A `UUIDHISTORY` campo es una [lista](#lists) de todos los UUIDs que se han asignado a una entidad durante su ciclo de vida, p. ej., cuando la entidad se crea, importa, exporta o copia en nuestra plataforma.

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

El historial de UUIDs está ordenado de más nuevo a más antiguo.

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

A las entidades de este conjunto de datos se les ha asignado un UUID inicial. Cuando una entidad se importa en nuestra plataforma, se emitirá un nuevo UUID y se añadirá en la parte superior del historial de UUIDs.

Los UUID usados por la plataforma se basan en el [Identificador Único Universal v4](https://datatracker.ietf.org/doc/html/rfc4122) estándar.

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

### Origen Uri

El `ORIGINURI` campo es una [URI](https://datatracker.ietf.org/doc/html/rfc3986) que apunta a la ubicación donde una entidad fue definida originalmente.

> La longitud máxima para el Origin Uri es `4096` caracteres.

### ID

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

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

### Tipos de objetos

Los tipos de objeto se usan para diferenciar entre distintos tipos de entidades en el conjunto de datos.

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

Los tipos de objeto en los archivos CSV son:

* `habilidad`: Representa una [habilidad](#skills).
* `skillgroup`: Representa una [grupo de habilidades](#skill-groups).
* `escooccupation`: Representa una [ocupación](#occupations) que se origina en el marco ESCO.
* `localoccupation`: Representa una [ocupación](#occupations) que no se origina en el marco ESCO y está definida solo en esta taxonomía.
* `occupationgroup`: Representa una [Grupo de ocupaciones](#occupation-groups).

### Listas

Las propiedades de lista se almacenan en los archivos CSV como cadenas separadas por un carácter. Actualmente, no soportamos valores que contengan un salto de 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) formato.

## Descripciones de archivos

### Información del modelo

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

#### Columnas

* [`UUIDHISTORY`](#uuid-history): Una lista de [UUIDs](#uuid-history).
* `NOMBRE`: El nombre del modelo.
* `LOCALIDAD`: El código corto de la localidad 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.
* `NOTASDELANZAMIENTO`: Las notas de la versión del modelo.
* `CREADOEN`: La [fecha](#dates) en que el modelo fue creado.
* `ACTUALIZADOEN`: La [fecha](#dates) en que el modelo fue actualizado por última vez.

### Habilidades

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

#### Columnas

* [`ORIGINURI`](#origin-uri): Un [URI](#origin-uri) que apunta a la ubicación donde la habilidad fue definida originalmente.
* [`ID`](#id): Un [identificador único](#id), usado para referenciar la habilidad dentro del conjunto de datos CSV.
* [`UUIDHISTORY`](#uuid-history): Una lista de [UUIDs](#uuid-history).
* `TIPODEHABILIDAD`: El tipo de habilidad.
  * Valores posibles: `habilidad/competencia`,`conocimiento`,`idioma`,`actitud` o vacío ( ).
* `NIVELDEREUSO`: El nivel de reutilización de la habilidad.
  * Valores posibles: `específico del sector`,`específico de la ocupación`,`transversal al sector`,`transversal` o vacío ( ).
* `ETIQUETAPREFERIDA`: La etiqueta preferida de la habilidad.
* `ETIQUETASALT`: 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.
* `NOTASDEALCANCE`: La nota de alcance de la habilidad.
  * Longitud máxima:`4000` caracteres.
* `ESTALOCALIZADO`: Un valor booleano que indica si la habilidad está localizada o no.
  * Valores posibles: `verdadero` o `falso`.
* `CREADOEN`: La [fecha](#dates) la habilidad fue creada.
* `ACTUALIZADOEN`: La [fecha](#dates) la habilidad fue actualizada por última vez.\\

### Grupos de habilidades

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

#### Columnas

* [`ORIGINURI`](#origin-uri): Un [URI](#origin-uri) que apunta a la ubicación donde el grupo de habilidades fue definido originalmente.
* [`ID`](#id): Un [identificador único](#id), usado para referenciar el grupo de habilidades dentro del conjunto de datos CSV.
* [`UUIDHISTORY`](#uuid-history): Una lista de [UUIDs](#uuid-history).
* `CÓDIGO`: Código de SkillGroup según lo definido en ESCO. Tiene el formato general `SX.X.X`, donde `X` es un número.
* `ETIQUETAPREFERIDA`: La etiqueta preferida del grupo de habilidades.
* `ETIQUETASALT`: 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.
* `NOTASDEALCANCE`: La nota de alcance del grupo de habilidades.
  * Longitud máxima:`4000` caracteres.
* `CREADOEN`: La [fecha](#dates) el grupo de habilidades fue creado.
* `ACTUALIZADOEN`: La [fecha](#dates) el grupo de habilidades fue actualizado por última vez.

### Ocupaciones

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

#### Columnas

* [`ORIGINURI`](#origin-uri): Un [URI](#origin-uri) que apunta a la ubicación donde la ocupación fue definida originalmente.
* [`ID`](#id): Un [identificador único](#id), usado para referenciar la ocupación dentro del conjunto de datos CSV.
* [`UUIDHISTORY`](#uuid-history): Una lista de [UUIDs](#uuid-history).
* `CÓDIGODEGRUPODEOCUPACIÓN`: El grupo de ocupación al que pertenece la ocupación.
* `CÓDIGO`: Un código de ocupación asignado a la ocupación.
  * Para ocupaciones ESCO, el código será el código padre, seguido de un `.` y cualquier número de dígitos. Ej: `XXXX.1234`
  * Para ocupaciones locales, el código será el código padre, seguido de un `_` y cualquier número de dígitos. `XXXX_1234`
* `ETIQUETAPREFERIDA`: La etiqueta preferida de la ocupación.
* `ETIQUETASALT`: 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.
* `NOTASDEALCANCE`: La nota de alcance de la ocupación.
  * Longitud máxima:`4000` caracteres.
* `NOTADERESOLVIRPROFESIÓN`: La nota de profesión regulada.
  * Longitud máxima:`4000` caracteres.
* `TIPODEOCUPACIÓN`: El tipo de la ocupación.
  * Valores posibles: `escooccupation` o `localoccupation`.
* `ESTALOCALIZADO`: Un valor booleano que indica si la ocupación está localizada o no. Solo las ocupaciones del tipo `escooccupation` pueden estar localizadas.
  * Valores posibles: `verdadero` o `falso`.
* `CREADOEN`: La [fecha](#dates) la ocupación fue creada.
* `ACTUALIZADOEN`: La [fecha](#dates) la ocupación fue actualizada por última vez.

### Grupos de ocupaciones

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

### Columnas

* [`ORIGINURI`](#origin-uri): Un [URI](#origin-uri) que apunta a la ubicación donde el grupo de ocupación fue definido originalmente.
* [`ID`](#id): Un [identificador único](#id), usado para referenciar el grupo de ocupación dentro del conjunto de datos CSV.
* [`UUIDHISTORY`](#uuid-history): Una lista de [UUIDs](#uuid-history).
* `CÓDIGO`: Un código de identificación de cuatro dígitos del grupo de ocupación. Cada dígito representa un nivel en la jerarquía.
  * Para los grupos ISCO, el código es de un máximo de 4 dígitos, y cada grupo hijo debería tener un código que comience con el código del grupo padre. Ej: `1234`
  * Para grupos locales sin un grupo padre, el código debe comenzar con un carácter alfabético. Ej: `A1234`
  * Para grupos locales, si el grupo de ocupación 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 grupos locales, si el grupo de ocupación 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`
* `TIPODEGRUPO`: El tipo del grupo de ocupación.
  * Valores posibles: `grupoisco` o `grupolocal`.
* `ETIQUETAPREFERIDA`: La etiqueta preferida del grupo de ocupación.
* `ETIQUETASALT`: Un [lista](#lists) de etiquetas alternativas para el grupo de ocupación.
  * Longitud máxima por etiqueta: `256` caracteres.
  * Número máximo de etiquetas: `100`.
* `DESCRIPCIÓN`: La descripción del grupo de ocupación.
  * Longitud máxima:`4000` caracteres.
* `CREADOEN`: La [fecha](#dates) el grupo de ocupación fue creado.
* `ACTUALIZADOEN`: La [fecha](#dates) el grupo de ocupación fue actualizado por última vez.

### Relaciones habilidad a habilidad

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

#### Columnas

* `REQUERIDOPORID`: La [`ID`](#id) de la habilidad que requiere otra habilidad.
* `TIPODERELACIÓN`: El tipo de la relación.
  * Valores posibles: `esencial` o `opcional`.
* `REQUERIDOID`: La [`ID`](#id) de la habilidad que es requerida por otra habilidad.
* `CREADOEN`: La [fecha](#dates) la relación fue creada.
* `ACTUALIZADOEN`: La [fecha](#dates) la relación fue actualizada por última vez.

### Relaciones ocupación a habilidad

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

#### Columnas

* `TIPODEOCUPACIÓN`: El tipo de la ocupación.
  * Valores posibles: `escooccupation` o `localoccupation`.
* `OCUPACIÓNID`: La [`ID`](#id) de la ocupación.
* `TIPODERELACIÓN`: El tipo de la relación.
  * Valores posibles: `esencial`, `opcional`, o puede dejarse vacío.
* `ETIQUETAVALORDESEÑALIZACIÓN`: La etiqueta del valor de señalización de la relación.
  * Valores posibles: `bajo`, `medio`, `alto`, o puede dejarse vacío.
* `VALORDESEÑ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 `.`.
* `HABILIDADID`: La [`ID`](#id) de la habilidad.
* `CREADOEN`: La [fecha](#dates) la relación fue creada.
* `ACTUALIZADOEN`: La [fecha](#dates) la relación fue actualizada por última vez.

> Salvedad: Una escooccuption no puede tener un `valor de señalización` o `etiqueta de valor de señalización`. Esto **debe** tener un `tipoDeRelación`.\
> Para ocupaciones locales `valor de señalización` y `tipoDeRelación` son mutuamente excluyentes. Un `localoccupation` puede **o** tener un `valor de señalización` y `etiqueta de valor de señalización` **o** puede tener un `tipoDeRelación`, pero no ambos.

### Jerarquía de habilidades

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

#### Columnas

* `TIPODEOBJETOPADRE`: El tipo del objeto padre.
  * Valores posibles: `habilidad` o `skillgroup`.
* `IDPADRE`: La [`ID`](#id) del objeto padre.
* `IDHIJO`: La [`ID`](#id) del objeto hijo.
* `TIPODEOBJETOHIO`: El tipo del objeto hijo.
  * Valores posibles: `habilidad` o `skillgroup`.
* `CREADOEN`: La [fecha](#dates) la relación fue creada.
* `ACTUALIZADOEN`: La [fecha](#dates) la relación fue actualizada por última vez.

> Salvedad: 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 de archivo de la exportación es `occupation_hierarchy.csv`

#### Columnas

* `TIPODEOBJETOPADRE`: El tipo del objeto padre.
  * Valores posibles: `occupationgroup`, `escooccupation`, `localoccupation`.
* `IDPADRE`: La [`ID`](#id) del objeto padre.
* `IDHIJO`: La [`ID`](#id) del objeto hijo.
* `TIPODEOBJETOHIO`: El tipo del objeto hijo.
  * Valores posibles: `occupationgroup`, `escooccupation`, `localoccupation`.
* `CREADOEN`: La [fecha](#dates) la relación fue creada.
* `ACTUALIZADOEN`: La [fecha](#dates) la relación fue actualizada por última vez.

> Salvedad: Un `escooccupation` no puede ser el padre de un 'occupationgroup'.\
> Salvedad: Un `localoccupation` puede ser hijo de un `escooccupation` o de otro `localoccupation`.

### 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 plano 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: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.tabiya.org/tabiya-documentation/es/nuestra-pila-tecnologica/inclusive-livelihoods-taxonomy/csv-format.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
