:::(Info)To download, visit: Library.
:::
Finalidad
El widget «Timeline» es un widget interactivo que muestra los eventos registrados en una tabla de Tulip. Muestra el registro más reciente en la parte superior, lo que te permite estar siempre al día.
Configuración
Campos obligatorios: - ID de agregación (agregación de la tabla de Tulip) - Clave API (texto) - Secreto (texto) - URL de la cuenta (texto)
Campo opcional: - Texto blanco (sí/no) - Activa «sí» para cambiar el color de la fuente a blanco. El valor predeterminado es «no».
Para configurar este widget, debes proporcionar una clave API, un secreto y una URL (que tiene un formato similar a tu-cuenta.tulip.co). Si no sabes qué es una clave API, consulta la siguiente sección.También puedes configurar el widget en el editor de la aplicación (antes de ejecutarla) introduciendo la información directamente en las propiedades del widget.Una vez que hayas proporcionado la información necesaria, actualiza el widget. En este punto, si tienes algún evento en la tabla, debería aparecer en el widget.El widget utiliza una agregación. A través de la agregación, el widget se rellena con la información de los eventos. Sin esta agregación, sería necesario actualizar el widget después de cada inserción en la tabla para mantenerlo al día.
Cómo crear una cuenta de servicio
Prior to r383, Service Accounts were called "API Tokens".
Para acceder a la tabla de eventos, debes disponer de una cuenta de servicio con permiso de lectura de tablas. Comprueba que dispones de una accediendo a la sección de configuración de tu instancia y, a continuación, a «Tulip API». Si tienes un espacio de trabajo configurado, es posible que se encuentre en la configuración del espacio de trabajo.Si ya dispone de una cuenta de servicio, aparecerá en esa ubicación. Haga clic en «Editar» y asegúrese de que la opción «tablas: lectura» esté marcada en «ámbitos». Si está marcada, ya está todo listo; si no es así, ajuste los ámbitos o cree una nueva cuenta de servicio.Si no hay ninguna cuenta de servicio, crea una haciendo clic en el botón «Crear cuenta de servicio». Asigna el nombre que prefieras y, a continuación, selecciona los ámbitos, asegurándote de que la opción «tablas: lectura» esté marcada, así como cualquier otro ámbito que consideres oportuno. Es preferible asignar el mínimo de privilegios necesarios, aunque, en caso de duda, puedes marcar todas las opciones.Al hacer clic en «Crear», aparecerá una ventana en la que se te indicará que guardes la clave secreta. Sigue estas instrucciones, ya que, si la pierdes y necesitas regenerar la clave secreta, tendrás que actualizarla en todos los lugares donde se utilice la clave anterior.
Cómo funciona
El widget se actualiza automáticamente cuando se añade un nuevo registro a la tabla. Muestra los últimos eventos en la parte superior. Puedes cambiar la fuente si utilizas el widget sobre un fondo más oscuro.
La tabla se denomina «Eventos de la línea de tiempo» y tiene las siguientes columnas: - ID (texto) - ID único para los eventos; debe crearse automáticamente; no está pensado para mostrarse, pero es necesario - Título (texto) - título del evento; debe ser conciso, ya que se muestra en letra grande - Descripción (texto) - si el título no es lo suficientemente descriptivo, se pueden añadir más detalles que se muestran debajo del título- Tipo (texto) - puede ser uno de los siguientes o dejarse en blanco: éxito, error, advertencia, mensaje, andon, pausa, inicio, parada, msteams - también hay un icono predeterminado si no se especifica el tipo o si no es ninguno de los mencionados anteriormente - en el widget no se distingue entre mayúsculas y minúsculas - Fecha de creación (metadatos, oculta) - Cada registro de un « Tulip table » tiene metadatos (Fecha de creación y Fecha de actualización) que no se pueden modificar, pero que se pueden utilizar en consultas