From 03d05d5c85c281316b8768abb0ab441adc1c903b Mon Sep 17 00:00:00 2001 From: Jordan Date: Fri, 27 Mar 2026 12:30:58 +0000 Subject: [PATCH] Update builder-fields.md --- docs/builder-fields.md | 31 +++++++++++++++++++++++++++++++ 1 file changed, 31 insertions(+) diff --git a/docs/builder-fields.md b/docs/builder-fields.md index bd65ed8..7c24ecf 100644 --- a/docs/builder-fields.md +++ b/docs/builder-fields.md @@ -424,3 +424,34 @@ Manejo automático de validación, almacenamiento en BD y envío de emails. 5. **c-for tabla:** El nombre de tabla va sin prefijo `cms_` 6. **Enlace:** Ya incluye barras, no añadir extras 7. **Checkbox:** Valores `1` o `0`, no `true`/`false` + +--- + +## MCP Tools: Config Vars e Imágenes de Módulos + +### Leer variables de un módulo +Antes de modificar cualquier módulo, usar `get_module_config_vars` para conocer el estado actual: +- **tableName**: tabla del registro padre (ej: `apartados`), SIN prefijo `cms_` +- **recordNum**: campo `num` del registro padre (ej: `2`) +- **sectionId**: el `section_id` de la instancia del módulo (ej: `6c6d8`) + +### Escribir variables de un módulo +Usar `set_module_config_vars` con los mismos tableName, recordNum y sectionId. La respuesta incluye `configVars` con el `recordNum` del registro `builder_custom` creado/actualizado. + +### Subir imágenes a un módulo +El nombre del campo de imagen viene de `builder.json` → `vars.NOMBRE.relations.builder_custom` (ej: `"image1"`). NO es el nombre de la variable (ej: NO `"imagenes"`). + +**Flujo correcto:** +1. `get_module_config_vars` → obtener el `recordNum` en builder_custom de la variable de imagen +2. `upload_record_image` con: + - `tableName`: `"builder_custom"` (siempre, sin prefijo cms_) + - `recordId`: el `recordNum` del paso 1 (ej: `"778"`) + - `fieldName`: el campo de relations del builder.json (ej: `"image1"`) + - `imageUrl`: URL completa accesible desde Docker +3. `reorder_record_uploads` si es necesario — pasar array de upload IDs en el orden deseado +4. `list_record_uploads` para verificar + +**Errores comunes a evitar:** +- NO usar el sectionId como recordId — usar el `num` de builder_custom +- NO usar el nombre de la variable como fieldName — usar el campo de relations del builder.json (ej: `image1`, no `imagenes`) +- NO poner prefijo `cms_` en tableName