# Patrón PRG y redirección En modo HTML, CRUD-L hace las altas y los cambios con el patrón **PRG** ([Post-Redirect-Get](https://es.wikipedia.org/wiki/Post/Redirect/Get)): después de guardar responde una redirección, y el navegador pide la página de destino con GET. Así, recargar la página no vuelve a enviar el formulario. ## El ciclo 1. **GET** a `.../{tipo}/_new` o `.../{tipo}/{id}` con `Accept: text/html` devuelve el formulario (vacío o con la entidad). 2. **POST** al mismo punto final envía los datos; el controlador da de alta o modifica. 3. Si sale bien, responde una **redirección** (encabezado `Location`, estado 302). 4. El navegador hace **GET** a esa URL, normalmente la lista. Los navegadores envían `Accept: text/html` en una navegación normal. Si envía el formulario con JavaScript (`fetch`), agregue ese encabezado o recibirá la entidad en JSON en lugar de la redirección. ## Alta y edición con el mismo formulario - `GET .../_new` pide el formulario vacío (el valor se configura con `@entity_id_blank`). - `POST .../_new` da de alta. - `POST .../{id}` modifica: el controlador lo trata como PATCH. La misma vista y el mismo punto final atienden los dos casos, y el formulario siempre se envía a la URL actual (`action=""`). ## Destino de la redirección Se usa el primer criterio que aplique: 1. Si la respuesta ya tiene encabezado `Location`, no se cambia. 2. Si `@url_redir` tiene valor, se evalúa como plantilla y se usa el resultado. 3. Si llegó el parámetro de retorno (`---from_url`, `---from_url_e` o `_from_url_e`), se usa. 4. Si no, se arma la URL predeterminada. Resultados reales con 2.0: | Envío | `Location` | |---|---| | `POST /tienda/cliente/_new` sin más | `/tienda/cliente/?_select=4&_key=sys_pk` | | con `---from_url=/tienda/cliente/?texto=` | `/tienda/cliente/?texto=` | | con `---from_url_e=L3RpZW5kYS9jbGllbnRlLz9lc3RhZG89YWN0aXZv` | `/tienda/cliente/?estado=activo` | | con `?_from_url_e=L3RpZW5kYS9jbGllbnRlLz9lc3RhZG89YWN0aXZv` en la URL | `/tienda/cliente/?estado=activo` | | con `@url_redir` (abajo) | `/tienda/cliente/10?guardado=1` | ### URL predeterminada Se toma la URI sin la cadena de consulta, se quita el segmento del identificador y se agregan `_select` (identificador del registro guardado) y `_key` (campo clave): ```text .../{tipo}/?_select={identificador}&_key={campo_clave} ``` La vista de lista puede usar `_select` para resaltar o seleccionar la fila guardada: ```dkl seleccionado = @@(@crud_context,"$parameters/_select") ``` ### Parámetro de retorno Para volver al lugar de origen (por ejemplo, la lista con sus filtros), mande la URL en el formulario en el campo `---from_url`. El prefijo `---` lo convierte en un [campo de control](#campos-de-control): no llega al modelo. ```html ``` Si la URL debe viajar codificada, use `---from_url_e` (en el formulario) o `_from_url_e` (en la URL del `action`) con el valor codificado por `url_encode` de `functions.dkh` (Base64 con `|`, `_` y `-` en lugar de `=`, `/` y `+`; **no** es la codificación de porcentajes de las URL): ```dkl retorno_e = url_encode("/tienda/cliente/?estado=activo") // L3RpZW5kYS9jbGllbnRlLz9lc3RhZG89YWN0aXZv ``` Desde una vista de lista, la URL actual está en los encabezados de la petición: ```dkl retorno = @@(@crud_context,"$http/request/headers/REQUEST_URI") ``` ### Plantilla de redirección: @url_redir `@url_redir` arma el destino con los datos de la operación. Se evalúa como texto con formato en un contexto con los mismos miembros que una vista (`.`, `output`, `input`, `parameters`, `error`, `database`, `http`), que se leen con `@('ruta')`. Establézcala en el `controller.dk` de la entidad cuando el destino dependa del resultado: ```dkl @url_redir = "/tienda/cliente/#<@('$output/sys_pk')>?guardado=1" ``` Tras un alta, `Location: /tienda/cliente/10?guardado=1`. **En 2.0 use `@('...')`**, no `@@(@crud_context,'...')`: durante la redirección `@crud_context` no existe (solo existe dentro de las vistas), y con esa forma el destino sale **vacío** (`Location:` sin valor, comprobado). El ejemplo de la documentación 1.0 usaba `@@(@crud_context,...)`. ## Campos de control Todo campo de la carga útil cuyo nombre empiece con `---` se mueve a los parámetros antes de que el modelo reciba los datos. El marco lo usa para `---from_url`, pero puede usarlo para lo que necesite: estará en `parameters` y no en `input`. ```html ``` ```dkl origen = @@(@crud_context,"$parameters/---sucursal_origen") ``` En un modelo, los mismos campos se leen de `params` (por ejemplo, el identificador de un bloqueo pesimista, en [El modelo](/es/devkron/2.0/marcos/crudl/modelo.md#bloqueo-pesimista-sys_lock)). ## Suprimir la redirección Con el parámetro `_redirect=disabled` en la URL, alta, cambio y baja muestran la vista de formulario en lugar de redirigir: ```html