> ## 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.

# Registros

> Crea, edita, busca, filtra y exporta registros dentro de tus colecciones

Los **registros** son las filas de datos dentro de una colección. Cada registro contiene valores para los campos definidos en la colección.

## Crear un registro

<Frame caption="Formulario para crear un nuevo registro con campos tipados">
  <img src="https://mintcdn.com/jelouai/daUUvITM1J6ByU2U/assets/images/datum/new-record.png?fit=max&auto=format&n=daUUvITM1J6ByU2U&q=85&s=6b51e6b702e0f45811d2227680ad20b4" alt="Formulario New record con campos brand, model, price y más, mostrando tipos de campo e indicadores de campo obligatorio" width="3024" height="1730" data-path="assets/images/datum/new-record.png" />
</Frame>

<Steps>
  <Step title="Abre la colección">
    Selecciona la colección donde quieres agregar un registro desde la barra lateral izquierda.
  </Step>

  <Step title="Haz clic en + New record">
    El botón se encuentra en la esquina superior derecha de la vista de colección.
  </Step>

  <Step title="Completa los campos">
    El formulario muestra todos los campos de la colección con sus tipos. Los campos marcados con <code>\*</code> son obligatorios. El campo **id** se genera automáticamente al guardar.
  </Step>

  <Step title="Haz clic en Create">
    El registro se crea y aparece en la tabla de la colección.
  </Step>
</Steps>

## Editar un registro

<Frame caption="Panel de edición de un registro con campos y contador de caracteres">
  <img src="https://mintcdn.com/jelouai/daUUvITM1J6ByU2U/assets/images/datum/edit-record.png?fit=max&auto=format&n=daUUvITM1J6ByU2U&q=85&s=790c573ebe0585043e0a070640fc246e" alt="Panel Edit record mostrando campos editables con valores, contadores de caracteres y botón Save changes" width="3024" height="1730" data-path="assets/images/datum/edit-record.png" />
</Frame>

Haz clic en la flecha al final de cualquier fila para abrir el panel de edición. Modifica los valores que necesites y haz clic en **Save changes** para guardar.

Cada campo de texto muestra un contador de caracteres (ej. `5/5000 characters`) para que puedas controlar la longitud del contenido.

## Duplicar y eliminar registros

Dentro del panel de edición de un registro, haz clic en el menú **⋮** (esquina superior derecha) para acceder a:

* **Duplicate** — Crea una copia del registro con un nuevo ID
* **Delete** — Elimina el registro permanentemente

## Buscar registros

Utiliza la barra de búsqueda en la parte superior de la tabla (**Search across visible columns**) para buscar texto en todas las columnas visibles. También puedes usar el atajo **Cmd+K** para enfocar la búsqueda rápidamente.

## Filtros avanzados

Haz clic en el ícono de filtro (embudo) junto a la barra de búsqueda para abrir el panel de **Advanced filters**.

<Steps>
  <Step title="Configura la lógica">
    Elige entre **AND** (todas las condiciones deben cumplirse) u **OR** (al menos una condición debe cumplirse).
  </Step>

  <Step title="Agrega condiciones">
    Haz clic en **+ Add** y configura cada condición con:

    * **Campo** — Selecciona el campo a filtrar
    * **Operador** — Elige el operador de comparación
    * **Valor** — Ingresa el valor a comparar
  </Step>

  <Step title="Aplica los filtros">
    Haz clic en **Apply filters** para ver los resultados filtrados.
  </Step>
</Steps>

Los operadores disponibles dependen del tipo de campo:

| Tipo de campo | Operadores                                 |
| ------------- | ------------------------------------------ |
| **Text**      | Equals, Not equal, Contains, Not contains  |
| **Number**    | Equals, Not equal, Greater than, Less than |

<Tip>
  En la sección **CURRENT QUERY** puedes ver y copiar la expresión de filtro generada. Esto es útil para reutilizar el filtro en llamadas a la API.
</Tip>

Puedes guardar combinaciones de filtros que uses frecuentemente con el botón **Save filters** y limpiar todos los filtros activos con **Clear**.

## Ordenar registros

Haz clic en el encabezado de cualquier columna para alternar el orden de los registros:

* Primera vez: orden **ascendente** (A→Z, 0→9)
* Segunda vez: orden **descendente** (Z→A, 9→0)
* Tercera vez: sin orden específico

## Exportar registros

Haz clic en el botón **Export** en la esquina superior derecha para descargar los registros de la colección actual. La exportación respeta los filtros activos, permitiéndote exportar solo un subconjunto de datos.

## Paginación

La tabla muestra los registros paginados. En la esquina inferior derecha puedes:

* Ver cuántos registros hay en total (ej. "1 - 10 de 10")
* Navegar entre páginas con las flechas de anterior y siguiente
* Cambiar la cantidad de filas por página con el selector de filas

## API Preview

<Frame caption="Vista previa de la API con ejemplos de código para la colección actual">
  <img src="https://mintcdn.com/jelouai/daUUvITM1J6ByU2U/assets/images/datum/api-preview.png?fit=max&auto=format&n=daUUvITM1J6ByU2U&q=85&s=85b261d151723d256bff716c5ebe1437" alt="Panel API Preview mostrando endpoints List/Search, View, Create, Update, Delete y Batch con ejemplos en cURL" width="3024" height="1730" data-path="assets/images/datum/api-preview.png" />
</Frame>

Haz clic en **API Preview** en la esquina superior derecha para ver la documentación interactiva de la API para la colección actual. Incluye:

* **List/Search** — Listar y buscar registros con filtros, orden y paginación
* **View** — Obtener un registro por ID
* **Create** — Crear un nuevo registro
* **Update** — Actualizar un registro existente
* **Delete** — Eliminar un registro
* **Batch** — Operaciones en lote

Cada operación incluye ejemplos de código en **cURL**, **JavaScript**, **Python**, **PHP** y **Laravel** con los endpoints y parámetros específicos de tu colección.
