Saltar al contenido

Browsers

Un browser controla la presentación. Configura cómo se muestra un conjunto de datos a las personas y qué pueden hacer con él. La mayoría de los browsers pertenecen a un formulario y muestran sus documentos, pero un browser también puede valerse por sí mismo, respaldado por una vista, de modo que un reporte o tablero se convierte en un lugar de primer nivel en el catálogo, sin un formulario propietario.

Un browser define la lista: qué columnas mostrar, qué buscar, los filtros y las facetas para acotar, y el orden. Define la vista de detalle, de solo lectura o editable, y las acciones disponibles en un registro. Y se ubica a sí mismo en la navegación del catálogo con su propio grupo, ícono y etiqueta — anidado bajo el área de Catálogos por defecto, o elevado a su propio lugar de primer nivel cuando declara una sección (section).

yaml
kind: browser
list:
  search: [nombre, codigo]
  facets:
    - { field: categoria, label: Categoría }
  columns:
    - { field: nombre, label: Nombre }
    - { field: codigo, label: Código }
  actions:
    create: { label: Nuevo, primary: true }
item:
  mode: edit

Los browsers también se adaptan al contexto. Con anulaciones condicionales, un mismo browser puede mostrar columnas, permisos o una vista de detalle de solo lectura o editable distintos según la situación, por ejemplo el rol de quien lo consulta. Alguien con permiso de lectura puede ver una lista de solo lectura, mientras que un editor obtiene crear, editar y eliminar.

Las acciones son donde los browsers se conectan con el resto de la plataforma. Además de las habituales de crear, editar y eliminar, una acción puede iniciar un flujo de trabajo o enviar una señal a uno en marcha. De eso tratan los procesos por mensajes.