# Archivo de configuración .crudl El archivo `.crudl` cambia las vistas, los scripts y la plantilla de un sistema CRUD-L **sin modificar sus archivos**, y de forma distinta para cada host que atiende la misma instalación. Es la forma de atender a varios clientes con un mismo código cuando cada uno quiere sus propios formularios o estilos. Es opcional: si no existe, el marco usa la resolución normal de vistas. ## Ubicación `crudl.load_config()`, que se llama desde el punto de entrada, busca el archivo en tres lugares, relativos a la carpeta de trabajo del servidor (la instalación de Devkron), y usa el primero que exista: 1. `_config/{host}/{@base_path}.crudl` 2. `_config/{@base_path}.crudl` 3. `{@base_path}.crudl` `{host}` es el encabezado `Host` de la petición (o el nombre del servidor). Si `@base_path` termina en diagonal, se le quita. **Ejemplo.** Con `@base_path = "tienda/entidades"` y una petición a `clientea.ejemplo.com`: ```text /opt/devkron/_config/clientea.ejemplo.com/tienda/entidades.crudl /opt/devkron/_config/tienda/entidades.crudl /opt/devkron/tienda/entidades.crudl ``` Así hay una configuración común con excepciones por host. Si el archivo existe pero no es JSON válido, se ignora en silencio. ## Estructura ```json { "httm_template": "web/clientea/_protected/plantilla.htt", "entities": { "cliente": { "httm_template": "web/clientea/_protected/plantilla-catalogos.htt", "views": { "form.dk": "web/clientea/vistas/cliente-form.dk", "list.dk": "web/clientea/vistas/cliente-list.dk" }, "scripts": { "form.dk": "web/clientea/scripts/cliente-form.js" } }, "factura": { "views": { "form.dk": "web/clientea/vistas/factura-captura.dk" } } } } ``` | Llave | Ámbito | Significado | |---|---|---| | `httm_template` | raíz | Plantilla envolvente para todas las entidades | | `entities` | raíz | Configuración por tipo de entidad | | `entities.{tipo}.httm_template` | entidad | Plantilla de esa entidad; gana sobre la de la raíz | | `entities.{tipo}.views.{vista}` | entidad | Ruta alterna del archivo de la vista | | `entities.{tipo}.scripts.{vista}` | entidad | Ruta del script asociado a la vista | Los nombres de `views` y `scripts` son los valores de `@form_view`, `@list_view` y `@error_view` (con la configuración de la plantilla, `form.dk`, `list.dk` y `error.dk`). Las rutas son relativas a la carpeta de trabajo del servidor. ## Sustitución de vistas La ruta alterna encabeza la búsqueda de la vista; si el archivo no existe, se sigue con la búsqueda normal (entidad, entidades, marco). Vea [Resolución de la vista](/es/devkron/2.0/marcos/crudl/vistas.md#resolución-de-la-vista). Comprobado con 2.0: con `_config/misitio.localhost/tienda/entidades.crudl` declarando una vista alterna para `cliente/list.dk`, la lista de clientes del host `misitio.localhost` se pintó con la vista alterna (`
Clientes: 3
...`), y los demás hosts siguieron con la vista normal. ## Scripts asociados El texto del archivo de `scripts` debería llegar a la vista en `@crud_context/script`. **En la versión actual de dkl-web llega siempre vacío** (defecto de `view.dk`, ver [Inyección de scripts](/es/devkron/2.0/marcos/crudl/vistas.md#inyección-de-scripts)): por ahora lea el archivo desde la vista con `file.rtext`. ## Plantillas `httm_template` indica la plantilla que envuelve la salida **cuando la operación falló** en modo HTML. La de la entidad gana sobre la de la raíz; sin ninguna, se usa `@path_template_protected`. Vea [Plantilla envolvente](/es/devkron/2.0/marcos/crudl/vistas.md#plantilla-envolvente). ## Relación con routes.json | | `.crudl` | `routes.json` | |---|---|---| | Configura | Vistas, scripts, plantillas | Patrones de ruta y entidades | | Se carga con | `crudl.load_config()` | `crudl.loadRoutesJSON()` | | Se busca en | `_config/{host}/...`, `_config/...`, carpeta de trabajo | `{@path_root}/{@base_path}/` | | Cambia por host | Sí | No | Vea [routes.json](/es/devkron/2.0/marcos/crudl/enrutamiento.md#definición-declarativa-con-routesjson).