Widget de programación personalizado

Objetivo

El widget personalizado de programación constituye una solución innovadora para la gestión de tareas. Este widget de programación está diseñado para utilizarse dentro de las aplicaciones de Tulip con el fin de recuperar tareas o trabajos de una base de datos, cada uno con su propia duración específica.

Las tareas, que se muestran en la parte izquierda del widget, aparecen en una lista dispuesta verticalmente. Al arrastrar y soltar tareas sobre uno de los recursos situados en la parte derecha del widget de programación, las tareas o trabajos se pueden programar en una línea de tiempo. Esta asignación vincula la tarea o el trabajo a un recurso específico, indicando cuándo se ocupará de ella dicho recurso.

En esencia, este widget personalizado agiliza el proceso de asignación de tareas al facilitar una asociación visual entre tareas y recursos mediante una función intuitiva de arrastrar y soltar, lo que garantiza una gestión y una programación eficaces dentro de la interfaz de Tulip.

Configuración

Al configurar el widget, algunos parámetros son obligatorios, mientras que otros son opcionales y cuentan con valores por defecto.

Para establecer la conexión con el sistema del cliente, el widget requiere lo siguiente:

• La URL de la instancia del cliente
• Token de autenticación para el acceso, en lugar de credenciales de inicio de sesión
• Si el cliente no utiliza el espacio de trabajo DEFAULT, también debe proporcionarse el ID del espacio de trabajo.

Tras una autenticación correcta, el widget de programación necesita acceder a los recursos, que se obtienen de una lista. Los recursos pueden proceder de variables o de una consulta a una tabla.

Las tareas para el widget de programación se obtienen de la tabla «Tulip» en función del ID de la tabla y sus campos. Dado que estos son personalizables, el widget de programación ofrece mayor flexibilidad si se utiliza una tabla diferente.

El widget de programación tiene los siguientes parámetros que se deben configurar:

Parámetros obligatorios

Recursos: es una lista de texto; puede proceder de una tabla, pero en este caso se gestiona como variable de la aplicación.Nombres de columna: los ID de los campos se pueden encontrar en la tabla «Task»; añádelos uno por uno.

La tabla «Task» se puede encontrar de la siguiente manera:

El ID del campo se puede encontrar de la siguiente manera:

• ID de la tarea
• Nombre de la tarea
• Nombre de la columna «Estado»
• Nombre de la columna «Inicio»
• Nombre de la columna «Fin»
• Nombre de la columna «Duración»
• Nombre de la columna «Recurso»

Token de autenticación básica: haz clic en tu perfil en la esquina superior derecha, selecciona «Configuración de la cuenta», haz clic en «API de Tulip» en el panel de la izquierda y sigue las instrucciones para crear una cuenta de servicio.URL de la cuenta: p. ej.: tu-cuenta.tulip.co. ID de la tabla de tareas: el ID de la tabla se encuentra en el nivel de la tabla

Fecha de programación: ¿Para qué día te gustaría programarlo? Se trata de un campo de fecha y hora.

Parámetros opcionales

Inicio del día: inicio de la línea de tiempo. El valor por defecto es 06:00. Fin del día: fin de la línea de tiempo. El valor por defecto eslas 21:00. Unidad de tiempo dentro de la hora: el valor por defecto es 10 (en minutos), lo que significa que, al mover una tarea en la línea de tiempo, puedes seleccionar, por ejemplo, las 07:10 o las 07:20..., cada paso es de 10 minutos. Si lo cambias a 30, podrás seleccionar 07:00, 07:30..., y cada paso será de 30minutos. Ancho de la unidad: ancho de un paso en píxeles; con este parámetro puedes configurar el ancho del widget. El valor por defecto es 13. Ancho del nombre del recurso: ancho de la columna del recurso en píxeles. El valor por defecto es220. Superposición: el widget admite la superposición de tareas. El valor por defecto es «false».Cuadro de información: se trata de una ventana emergente que muestra el nombre de la tarea si esta queda recortada. El valor por defecto es**«false». Estados (esta opción está disponible si el cuadro de información está activado):** El widget de programación funciona con dos estados fijos: «Programado» y «No programado». Además, ofrece la posibilidad de definir estados adicionales, como «Completado» o «Cancelado». Para los estados personalizados se puede especificar un color y también se puede configurar un comportamiento por defecto (ShowByDefault). En función del parámetro ShowByDefault, el widget oculta automáticamente las tareas si el valor de ShowByDefault es «no» o las muestra si es «sí».

Los estados personalizados se pueden encontrar en el cuadro de información.

Resaltar el intervalo de tiempo actual: muestra una línea vertical que indica el progreso en tiempo real, mostrando nuestra posición actual en la línea de tiempo. El valor por defecto es «false».

Desencadenantes

Los siguientes eventos están disponibles en el widget de programación:

Tarea programada: una tarea añadida a lalínea de tiempo. Tarea desprogramada: una tarea eliminada de la línea de tiempo . Tarea movida: una tarea que acaba deser reprogramada. Actualización del estado de la tarea: en caso de utilizarestados personalizados.Tarea seleccionada: se ha hecho clic en una tarea programada.

Todos los desencadenantes tienen los siguientes resultados, excepto «Tarea seleccionada» y «Actualización del estado de la tarea»:

El resultado de «Tarea seleccionada» es el ID de la tarea. Se puede utilizar, por ejemplo, para cargar un registro.

Cómo funciona

Recupera las tareas mediante una llamada a la API desde la tabla de tareas de una base de datos, mientras que los recursos se obtienen a partir de los parámetros del widget. Las tareas se muestran en el lado izquierdo, mientras que los recursos aparecen en una lista vertical en el lado derecho del widget de programación. Cada recurso tiene una línea de tiempo diaria en la que se pueden colocar las tareas. Las tareas asignadas anteriormente vuelven a aparecer automáticamente en la línea de tiempo al recargar el widget. Cuando una tarea se vincula a un recurso, recibe horas de inicio y fin para el día planificado y solo será visible en la línea de tiempo del widget de programación en ese día concreto.El widget de Programación interactúa con la tabla «CDM Task» de la base de datos para registrar nuevas programaciones, movimientos de tareas en el tiempo o entre recursos, y la eliminación de tareas de la línea de tiempo de un recurso mediante un doble clic (lo que las coloca en un estado sin programar). Estos procesos en segundo plano funcionan utilizando la función integrada «fireEvent». Puede encontrar más información sobre la función fireEvent AQUÍ{target=_blank}. Características adicionales:

• Compatibilidad con solapamientos de tareas al establecer el parámetro «Overlap» en «true», útil para gestionar tareas simultáneas en un mismo recurso.
• Activación de un cuadro de información al establecer el parámetro «Infobox» en «true», lo que muestra una pequeña ventana con el nombre completo de la tarea al hacer clic, ya que en ocasiones el nombre puede no caber en la línea de tiempo.

Cómo crear una cuenta de servicio

Aquí{target=_blank} puedes encontrar información detallada sobre la creación de cuentas de servicio.

Más información

Si deseas obtener más información sobre custom widgets, visita el siguiente sitio web:Descripción general deCustom Widgets {target=_blank}