> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jelou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Colecciones

> Crea y configura colecciones para organizar tus datos con campos tipados, validaciones e índices

Una **colección** es el equivalente a una tabla en una base de datos tradicional. Cada colección tiene campos (columnas) con tipos de datos específicos y almacena registros (filas) que puedes crear, buscar, editar y eliminar.

## Crear una colección

<Frame caption="Formulario para crear una nueva colección con campos por defecto">
  <img src="https://mintcdn.com/jelouai/daUUvITM1J6ByU2U/assets/images/datum/new-collection.png?fit=max&auto=format&n=daUUvITM1J6ByU2U&q=85&s=3b659bfc208f0567737b375c27a33536" alt="Diálogo de Create Collection con nombre, tipo Base, campos id/created/updated y opción de crear índices" width="3024" height="1730" data-path="assets/images/datum/new-collection.png" />
</Frame>

<Steps>
  <Step title="Haz clic en + New collection">
    En la barra lateral izquierda, haz clic en el botón **+ New collection** ubicado en la parte inferior del panel de colecciones.
  </Step>

  <Step title="Configura los datos básicos">
    Completa los siguientes campos:

    * **Name** — Nombre de la colección (obligatorio, ej. "clientes", "productos")
    * **Type** — Tipo de colección (Base por defecto)
  </Step>

  <Step title="Agrega campos">
    Toda colección nueva incluye tres campos automáticos:

    * **id** — Identificador único del registro (generado automáticamente)
    * **created** — Fecha de creación del registro (Autodate)
    * **updated** — Fecha de última actualización (Autodate)

    Haz clic en **+ New field** para agregar tus propios campos.
  </Step>

  <Step title="Crea la colección">
    Haz clic en **Create** para confirmar.
  </Step>
</Steps>

## Tipos de campo

Cada campo tiene un tipo que determina qué datos puede almacenar y qué validaciones se aplican:

| Tipo         | Descripción                                                                             |
| ------------ | --------------------------------------------------------------------------------------- |
| **Text**     | Cadenas de texto (máximo 5000 caracteres por defecto)                                   |
| **Editor**   | Texto enriquecido con formato (negritas, listas, enlaces, etc.)                         |
| **Number**   | Valores numéricos (enteros o decimales)                                                 |
| **Boolean**  | Valores verdadero/falso                                                                 |
| **Email**    | Direcciones de correo electrónico con validación de formato                             |
| **URL**      | URLs con validación de formato                                                          |
| **Date**     | Fecha y hora que el usuario define manualmente en cada registro                         |
| **Autodate** | Fecha y hora asignada automáticamente por el sistema (ej. campos `created` y `updated`) |
| **Select**   | Selección de una opción de una lista predefinida                                        |
| **Relation** | Referencia a registros de otra colección                                                |
| **File**     | Archivos adjuntos                                                                       |
| **JSON**     | Datos estructurados en formato JSON                                                     |
| **GeoPoint** | Coordenadas geográficas (latitud y longitud)                                            |
| **Password** | Texto enmascarado para almacenar contraseñas o secretos                                 |

## Configurar campos

Haz clic en el ícono de engranaje (⚙) de cualquier campo para ver sus opciones de configuración. Las opciones varían según el tipo de campo.

Para campos de tipo **Text**:

* **Min length / Max length** — Longitud mínima y máxima del texto (máximo 5000 caracteres por defecto)
* **Validation pattern** — Expresión regular para validar el formato (ej. `^[a-z0-9]+$`)
* **Nonempty** — Marca el campo como obligatorio
* **Hidden** — Oculta el campo en la interfaz de usuario
* **Presentable** — Marca el campo como campo representativo del registro

<Warning>
  Puedes cambiar el tipo de un campo existente desde el dropdown del tipo en la configuración de la colección. Ten en cuenta que cambiar el tipo puede afectar datos existentes.
</Warning>

## Reordenar campos

Haz clic en **Reorder fields** dentro de la configuración de la colección para cambiar el orden en que se muestran los campos en la tabla y en los formularios.

## Índices y restricciones únicas

En la parte inferior de la configuración de la colección encontrarás la sección **Unique constraints and indexes**. Los índices mejoran el rendimiento de las consultas en campos que se filtran o buscan frecuentemente.

Haz clic en **Create index** para agregar un nuevo índice a tu colección.

## Configuración de la colección

<Frame caption="Panel de configuración de la colección con lista de campos y tipos">
  <img src="https://mintcdn.com/jelouai/daUUvITM1J6ByU2U/assets/images/datum/collection-settings.png?fit=max&auto=format&n=daUUvITM1J6ByU2U&q=85&s=8f7870dc4ad44e2917691f49e3b625c6" alt="Panel Collection settings mostrando nombre, tipo, lista de campos con sus tipos y opciones de configuración" width="3024" height="1730" data-path="assets/images/datum/collection-settings.png" />
</Frame>

Haz clic en el ícono de engranaje (⚙) junto al nombre de la colección en la parte superior para acceder a la configuración completa. Desde aquí puedes:

* Renombrar la colección
* Agregar, editar o eliminar campos
* Reordenar campos
* Crear índices

El menú **⋯** en la esquina superior derecha de la configuración ofrece opciones adicionales de gestión.

<Warning>
  Desde este menú puedes eliminar la colección permanentemente. Esta acción borra todos los registros y no se puede deshacer.
</Warning>