# Diccionario

Permite la manipulación de datos estructurados, ofreciendo mayor flexibilidad para almacenar y recuperar información con filtros y parámetros específicos.

Con él, es posible agregar nuevos registros al diccionario, modificar datos existentes, eliminar registros, buscar información por ID y realizar consultas avanzadas filtrando múltiples criterios.

### 📂 **Operaciones Disponibles**

Aquí están las operaciones que se pueden realizar con este componente:

| **Operación**                           | **Descripción**                                         |
| --------------------------------------- | ------------------------------------------------------- |
| **Crear (create)**                      | Agrega un nuevo registro al diccionario.                |
| **Actualizar (update)**                 | Modifica los datos de un registro existente.            |
| **Eliminar (delete)**                   | Elimina un registro del diccionario.                    |
| **Buscar por ID (get\_by\_id)**         | Obtiene los detalles de un registro específico.         |
| **Buscar por filtro (get\_by\_filter)** | Obtiene una lista de registros filtrados por criterios. |

### 📑 **Variables Utilizadas en el Componente**

A continuación están las variables utilizadas en el componente **Diccionario**, incluyendo sus tipos de datos y obligatoriedad.

| **Campo**                   | **Tipo de Dato** | **¿Obligatorio?** | **Descripción**                                                                                                      |
| --------------------------- | ---------------- | ----------------- | -------------------------------------------------------------------------------------------------------------------- |
| **Workspace ID**            | `string`         | ✅ Sí              | ID del workspace donde se encuentra ubicada la tabla del diccionario.                                                |
| **Nombre de la Tabla**      | `string`         | ✅ Sí              | Identificador de la tabla en el diccionario donde se almacenan los datos.                                            |
| **ID del Registro**         | `string`         | ❌ No              | Identificador único del registro en el diccionario. Necesario para operaciones que manipulan un elemento específico. |
| **Campos (JSON)**           | `objeto`         | ✅ Sí              | Estructura que contiene los datos del registro que se va a crear o actualizar.                                       |
| **Método de Filtro**        | `string`         | ❌ No              | Define si la búsqueda por filtro se realizará utilizando los campos del diccionario o mediante query directa.        |
| **Parámetros de Filtro**    | `objeto`         | ❌ No              | Estructura que contiene los filtros aplicados para la consulta al diccionario.                                       |
| **Ordenación**              | `string`         | ❌ No              | Define el criterio de ordenación de los registros devueltos.                                                         |
| **Dirección de Ordenación** | `string`         | ❌ No              | Indica si la ordenación será ascendente (`asc`) o descendente (`desc`).                                              |
| **Paginación (Página)**     | `número`         | ❌ No              | Número de la página que se va a recuperar en la búsqueda por filtro.                                                 |
| **Paginación (Límite)**     | `número`         | ❌ No              | Número máximo de registros a devolver por página.                                                                    |

### 🎯 **Cómo Configurar una Operación**

#### 1️⃣ **Accede al Componente**

1. En **Hablla Studio**, abra el flujo de automatización donde desea incluir la acción.
2. Agregue el bloque **"Diccionario"**.
3. En **panel lateral derecho**, seleccione la operación deseada.

#### 2️⃣ **Completa los campos obligatorios**

Dependiendo de la operación elegida, algunos campos son obligatorios. Consulte la tabla de variables arriba para entender qué datos deben completarse para cada operación.

#### 3️⃣ **Guardar la configuración**

Después de completar los campos, haz clic en el botón **"Guardar"** ✅.

Ahora, siempre que se active esta automatización, los registros del diccionario serán gestionados según la configuración definida.

### 📝 **Detalle de las Operaciones**

Cada operación posee campos obligatorios y opcionales que deben completarse según el caso. A continuación, detallaremos cada una de ellas:

1️⃣ **Crear Registro en el Diccionario**\
2️⃣ **Actualizar Registro en el Diccionario**\
3️⃣ **Eliminar Registro del Diccionario**\
4️⃣ **Buscar Registro por ID**\
5️⃣ **Buscar Registros por Filtro**

🚀 **¡Continúe con los próximos temas para configurar cada operación correctamente!**