# 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!**


---

# 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.hablla.com/hablla-docs-es/flujos-de-automatizaciones/todos-los-componentes/hablla/diccionario.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.