# Referencia de CRUD-L Resumen de todos los parámetros, variables, punteros, funciones y códigos del marco. La columna **Estado** indica: - **Disponible**: implementado y utilizable. - **Convención**: el marco no lo usa; es un nombre adoptado por los sistemas construidos sobre CRUD-L. - **Reservado**: nombre previsto sin implementación. No lo use; puede cambiar. ## Parámetros de URL Disponibles en `@http_context/request/get` y en `parameters` de la vista. | Parámetro | Estado | Descripción | |---|---|---| | `_entities_type` | Disponible | Tipo de entidad (carpeta y, salvo `@table_name`, tabla). Requerido | | `_entity_id` | Disponible | Identificador. Su presencia decide la operación | | `_key` | Disponible | Campo identificador; predeterminado `sys_pk`. Gana sobre `@keyfield` | | `_app_group` | Disponible | Aplicación del administrador de conexiones | | `_connection` | Disponible | Conexión dentro de la aplicación | | `ws` | Disponible | Espacio de trabajo; con sesión activa la suplantación | | `_redirect` | Disponible | `disabled` muestra el formulario en lugar de redirigir | | `_select` | Disponible | Lo pone el marco en la URL de redirección: identificador guardado | | `_operation` | Disponible | Lo agrega el marco: operación realizada (visible en la vista) | | `_from_url_e` | Disponible | URL de retorno codificada con `url_encode` | | `_view` | Convención | Seleccionar subrecursos desde `controller.dk` | | `_limit`, `_fields`, `_order`, `_start`, `_method` | Reservado | — | ## Campos de control de la carga útil | Campo | Descripción | |---|---| | `---from_url` | URL de retorno para la redirección PRG | | `---from_url_e` | URL de retorno codificada con `url_encode` | | `---{cualquiera}` | Se mueve a los parámetros; no llega al modelo | ## Variables del punto de entrada | Variable | Valor de la plantilla | Descripción | |---|---|---| | `@path_root` | `""` | Carpeta física del sitio | | `@base_path` | `""` | Carpeta de las entidades, relativa a `@path_root` | | `@dbmvc_path` | `"crudl/"` | Carpeta del marco | | `@db_engine` | `"MY_SQL"` | Motor (informativo; la suplantación usa siempre `mysql.dbr.dkh`) | | `@crudl.qname` | `""` | Nombre cualificado de la conexión | | `@crudl.user`, `@crudl.pwd` | `""` | Credenciales de la conexión constante | | `@crudl.access_privilege` | manifiesto por `workspace` | Privilegios para la suplantación | | `@ws` | de la URL | Espacio de trabajo | | `@list_view`, `@form_view`, `@error_view` | `"list.dk"`, `"form.dk"`, `"error.dk"` | Nombres de las vistas | | `@dkl_view_ext` | `".dk"` | Extensión de vistas DKL | | `@websencia_ext` | `".jsnwm"` | Extensión de archivos de Websencia | | `@entity_id_blank` | `"_new"` | Identificador de "entidad nueva" (obligatoria) | | `@crudl_routes_json` | `"routes.json"` | Archivo de rutas declarativas | | `@url_redir` | `""` | Plantilla de la URL de redirección | | `@path_template_protected` | `{@base_path}/{@path_root}/_protected/default.htt` | Plantilla envolvente de errores | | `@auto_crud` | `@true` | Previsto para exigir `model.dk`; el controlador lo vuelve a poner en `@true`, así que hoy no tiene efecto | | `@crudl.enable_idreplacement` | `@true` | Definida en la plantilla; el marco no la usa | Variables que el controlador deja disponibles: `@expected_html` (modo HTML), `@entity_name`, `@entity_path`, `@crud_path`, `@database` (la conexión). ## Variables del modelo | Variable | Valor predeterminado | Descripción | |---|---|---| | `@table_name` | `""` | Tabla; vacía = `_entities_type` | | `@keyfield` | `"sys_pk"` | Campo clave; `_key` gana | | `@read_query` | ver [modelo](/es/devkron/2.0/marcos/crudl/modelo.md) | Consulta de READ | | `@get_sys_pk` | ver [modelo](/es/devkron/2.0/marcos/crudl/modelo.md) | `sys_pk` a partir de una clave alterna | | `@list_query` | ver [modelo](/es/devkron/2.0/marcos/crudl/modelo.md) | Consulta de LIST | | `@create_fields`, `@update_fields` | `"*"` | Campos que se guardan | | `@create_exclude_fields`, `@update_exclude_fields` | `""` | Campos excluidos | | `@create_alias_fields`, `@update_alias_fields` | `""` | Pares `alias:campo` | | `@use_transaction` | `@true` | Transacción en alta, cambio y baja | | `@childs` | vacío | Tablas dependientes | | `@custom_delete` | nulo | Borrado propio | | `@sys_fields` | lista de campos de sistema | Definida en `entity.dk`; el marco no la usa | ## Punteros del modelo Se cambian con `point ... to función`; se deshabilitan con `ref @puntero = @null` (404 `Operación no admitida`). | Puntero | Firma | Devuelve | |---|---|---| | `@create` | `&db, ¶ms, &data` | Entidad creada | | `@read` | `&db, ¶ms` | Entidad | | `@update` | `&db, ¶ms, &data` | Entidad actualizada | | `@delete` | `&db, ¶ms` | — | | `@list` | `&db, ¶ms` | Lista | | `@blank` | `&db, ¶ms` | Elemento en blanco | | `@custom_delete` | `&db, tabla, sys_pk` | — | ## Punteros de la vista | Puntero | Firma | Descripción | |---|---|---| | `@view_controller` | `operation, ¶ms` | Asigna `@success_view` y `@fail_view` | | `@success_view` | `¶ms, &input_data, &output_data, &error_info` | Vista de éxito | | `@fail_view` | `¶ms, &input_data, &output_data, &error_info` | Vista de error | Funciones de `view.dk` a las que pueden apuntar: `json_view`, `list_view`, `form_view`, `error_view`, `redirect`. ## Miembros de @crud_context | Miembro | Descripción | |---|---| | `output` | Resultado de la operación | | `.` | Como `output`, pero con los datos de entrada cuando hubo error | | `input` | Datos de entrada | | `parameters` | Parámetros, con `_operation` | | `error` | Nulo o `{"message": ...}` | | `database` | Conexión | | `http` | El `@http_context` de la petición | | `script` | Script asociado (hoy llega vacío: defecto conocido) | ## Objeto de error ```json { "message": "Texto del error" } ``` ## Códigos de estado | Código | Situación | |---|---| | 200 | CREATE, READ, UPDATE, LIST | | 204 | DELETE (también en modo HTML) | | 302 | Redirección PRG en modo HTML | | 404 | Elemento no encontrado; operación no admitida; identidad no indicada; `Id no encontrado` | | 500 | Vista no disponible; error de base de datos; cualquier otro | Desde un modelo puede producir cualquier código de 400 en adelante con `rise_error`, por ejemplo 423 para un registro bloqueado. ## Funciones de configuración y enrutamiento (crudl/crudl.dk) | Función | Descripción | |---|---| | `crudl.load_config()` | Carga el archivo `.crudl` en `@crudl_config` | | `crudl.config_file(ruta)` | Devuelve la ruta del `.crudl` que corresponde (o `""`) | | `crudl.loadRoutesJSON()` | Carga `routes.json` | | `crudl.routes.pattern(patrón)` | Declara los parámetros de la ruta lógica | | `crudl.routes.resolve()` | Devuelve la ruta lógica armada con los patrones | | `crudl.routes.entity(ruta, entidad)` | Si la ruta coincide, asigna `_entities_type`; devuelve `1` o `0` | | `crudl.route(ruta)` | Compara sin asignar entidad | | `crudl.database()` | Conexión del proveedor de identidad, o nulo (sirve también en vistas) | ## Funciones del modelo genérico (crudl/entity.dk) | Función | Descripción | |---|---| | `entity.create`, `entity.read`, `entity.update`, `entity.delete`, `entity.list`, `entity.blank` | Implementaciones predeterminadas | | `entity.child(tabla, join, consulta)` | Describe una tabla dependiente | | `entity.safe_id(id)` | Limpia un identificador antes de insertarlo como texto | | `entity.remove_fields(&data, &lista)` | Quita campos de un registro | | `dbr.updateDetails(&db, &info, clave_maestro, &filas)` | Guarda las filas de un hijo (la usa `entity.create`/`update`) | ## Funciones del motor (crudl/mysql.dbr.dkh) | Función | Descripción | |---|---| | `dbr.check_alter_access(&user)` | Verifica `@crudl.access_privilege` | | `dbr.alter_id(qname, uid, uname, ids)` | Conexión con la identidad indicada (crea usuario y sesión locales) |