Acciones de tarjeta y drill-down

Una tarjeta puede hacer algo al hacer clic en ella: reducir el tablero al dispositivo pulsado, abrir una página de detalle sobre él, abrir otro tablero, ir a una página de la aplicación o ejecutar un comando. Esta página enumera qué se puede pulsar, las acciones y cómo crear un drill-down desde una vista general hasta un único dispositivo.

Dónde se configuran las acciones

Personalice el tablero, abra la configuración de la tarjeta y abra Qué ocurre al hacer clic (acciones). Cada origen tiene una lista de acciones que se ejecutan en orden. Añada todas las que necesite, por ejemplo Establecer parámetros del tablero y después Mostrar una página de este tablero.

Qué se puede pulsar

Origen	Tarjetas
Cuando se hace clic en esta tarjeta, doble clic, clic derecho	Cualquier tarjeta
Botones de cabecera	Cualquier tarjeta: botones en la cabecera de la tarjeta, cada uno con una etiqueta y un icono
Cuando se usa este control, Cuando se pulsa Aplicar	Controles
Cuando se hace clic en una fila, Cuando se hace doble clic en una fila, Cuando se hace clic en una celda, Botones de fila	Tablas, tablas de dispositivos y de alarmas
Cuando se hace clic en un marcador del mapa, Cuando se suelta un marcador	Mapas
Cuando se hace clic en un sector del gráfico circular, Cuando se selecciona un rango en el gráfico	Gráficos circulares y de series
Cuando se hace clic en un enlace del texto	Tarjetas de texto, para enlaces `[palabras](action:id)`
Cuando se hace clic en un símbolo, doble clic, clic derecho	Diagramas de proceso (véase Comandos en símbolos)
Cuando se hace clic en un marcador o en un elemento del modelo, Clic en elemento	Tarjetas 3D

Las acciones

Acción	Hace
Ir a una página	Abre una página de la aplicación, opcionalmente en una pestaña nueva. Ejemplo: `/admin/iot/devices/{{row_id}}`.
Abrir una URL	Abre una dirección externa en una pestaña nueva.
Establecer parámetros del tablero	Cambia los parámetros del tablero en el mismo sitio, por ejemplo el dispositivo que siguen las demás tarjetas.
Mostrar una página de este tablero	Abre una página del mismo tablero como página, panel lateral, diálogo o popover.
Abrir un tablero	Abre otro tablero con sus parámetros preseleccionados (drill-down).
Volver atrás	Retrocede por el recorrido del drill-down, algunos niveles o hasta el primer tablero.
Establecer la ventana de tiempo	Cambia la ventana del tablero: un preajuste, el valor por defecto del tablero o un rango seleccionado en un gráfico.
Actualizar este widget, Actualizar el tablero	Recarga los datos.
Copiar al portapapeles	Copia un valor.
Mostrar un mensaje	Muestra un mensaje breve al usuario.
Ejecutar un comando	Envía un comando al dispositivo, tras su confirmación. Solo desde controles, botones de fila y símbolos. Véase Tarjetas de control.

Un clic en una tarjeta nunca ejecuta un comando; el editor lo rechaza allí.

Valores del clic

El texto de una acción puede contener tokens:

Token	Se sustituye por
`{{param_<key>}}`	El valor de un parámetro del tablero, por ejemplo `{{param_device}}`
`{{row_<column>}}`	Una columna de la fila pulsada (orígenes de fila, celda y marcador), por ejemplo `{{row_id}}`

En Establecer parámetros del tablero y Abrir un tablero, un parámetro puede tomar un valor fijo, otro parámetro, o una columna de la fila pulsada.

Condiciones y confirmación

Cualquier acción, excepto la de un clic en la tarjeta, puede llevar una condición de visualización: se ejecuta (o un botón se muestra) solo mientras un parámetro coincida. En el propio clic de un control, la condición deshabilita el control.
Pedir confirmación antes de ejecutar pregunta «¿Ejecutar ««?» antes de Establecer parámetros del tablero, Mostrar una página de este tablero, Abrir un tablero y Volver atrás. Los comandos piden confirmación por defecto.

Páginas de detalle

Un tablero puede tener hasta 20 páginas después de su página principal. Una página que no está en el menú de páginas es una página de detalle, que solo se abre desde una tarjeta.

Personalice el tablero y abra Gestionar páginas….
Añadir página. Dele un título, por ejemplo Dispositivo {{param_device}}: «Dispositivo {{example}}» se lee «Dispositivo P-201» una vez elegido un dispositivo.
En Parámetros, añada los parámetros con los que trabaja la página. Uno marcado con estrella es necesario: «la página solo se abre desde una acción de tarjeta que proporcione este parámetro.»
Desmarque En menú para convertirla en una página de detalle.
Elija Se muestra como: Página, Panel lateral, Diálogo o Popover, y un tamaño (Pequeño, Mediano, Grande).
Seleccione Guardar páginas. Después mueva las tarjetas a la página mientras está abierta.

Una página abierta por una acción se abre sobre la página en la que está la tarjeta. Pueden apilarse hasta 8; cada una conserva los valores con los que se abrió, y Volver a la página anterior cierra la superior. Un panel lateral o diálogo ofrece Abrir como página completa. Una página abierta sin un valor necesario dice «Elija para ver esta página».

Drill-down a otro tablero

Abrir un tablero abre otro tablero con parámetros establecidos desde el clic. Los tableros por los que ha pasado aparecen como una ruta de navegación en la parte superior, guardada en la dirección (?trail=…), de modo que Volver atrás y el botón atrás del navegador los recorren.

Ejemplo: de todas las instalaciones a una bomba.

Tablero Sites: una Tabla vinculada a Estado bajo un activo para el sitio superior. En Cuando se hace clic en una fila: Abrir un tablero > Detalle de sitio, con site establecido desde la fila pulsada.
Tablero Detalle de sitio: un parámetro de entidad site (La página o un enlace lo establece), y una tabla de los dispositivos que dependen de él. En Cuando se hace clic en una fila: Mostrar una página de este tablero > la página de detalle Dispositivo, con device establecido desde la fila pulsada, mostrada como Panel lateral.
La página Dispositivo: un Indicador, un Gráfico de líneas y un Botón cuyo campo de dispositivo toma El dispositivo que muestra esta página (el parámetro device).

La plantilla de tablero Sites construye la mayor parte de esto por usted. Véase Plantillas de tablero y archivos de tablero.

Resolución de problemas

Problema	Causa
No se puede eliminar una página	«Contiene tarjetas o la abre una acción: mueva primero las tarjetas y cambie las acciones.»
Una acción se rechaza al guardar	Mostrar una página de este tablero dejaría un parámetro necesario sin valor. Asígnele el parámetro.
«No guardado: N acción(es) sin terminar.»	Cada acción sin terminar indica lo que necesita.
La ruta de navegación ha desaparecido	El recorrido forma parte de la dirección; un marcador sin él inicia un recorrido nuevo.