Widget personnalisé de programmation

Objectif

Le widget personnalisé de planification est une solution innovante pour la gestion des tâches. Ce widget est conçu pour être utilisé dans les applications Tulip afin de récupérer des tâches ou des travaux dans une base de données, chacun ayant sa propre durée.

Affichées sur le côté gauche du widget, les tâches apparaissent dans une liste verticale. En glissant et déposant les tâches sur l'une des ressources situées sur le côté droit du widget de planification, les tâches ou les travaux peuvent être planifiés sur une ligne de temps. Cette affectation lie la tâche ou le travail à une ressource spécifique, en indiquant le moment où la ressource s'en chargera.

En substance, ce widget personnalisé rationalise le processus d'allocation des tâches en facilitant une association visuelle entre les tâches et les ressources grâce à une fonctionnalité intuitive de glisser-déposer, assurant ainsi une gestion et une planification efficaces au sein de l'interface de Tulip.

Configuration

Lors de la configuration du widget, certains paramètres sont obligatoires, tandis que d'autres sont optionnels avec des valeurs par défaut.

Pour établir la connexion avec le système du client, le widget a besoin des éléments suivants :

• l'URL de l'instance du client
• Le jeton d'authentification pour l'accès au lieu des identifiants de connexion.
• Si le client n'utilise pas l'espace de travail par défaut, l'ID de l'espace de travail doit également être fourni.

Une fois l'authentification réussie, le widget de planification doit accéder aux ressources, qui sont extraites d'une liste. Les ressources peuvent provenir de variables ou d'une requête de table.

Les tâches du widget de planification sont obtenues à partir de la table Tulip sur la base de l'identifiant de la table et de ses champs. Ces derniers étant personnalisables, le widget Planification offre une plus grande flexibilité si une table différente est utilisée.

Les paramètres suivants peuvent être définis pour le widget Planification :

Paramètres obligatoires

Ressources : il s'agit d'une liste de texte, elle peut provenir d'une table mais dans ce cas elle est gérée comme une variable d'application**.Nom des colonnes :** les ID des champs peuvent être trouvés au niveau de la table Tâche, veuillez les ajouter un par un.

La table Task peut être trouvée de la manière suivante :

L'ID du champ se trouve de la manière suivante :

• ID de la tâche
• Nom de la tâche
• Nom de la colonne Statut
• Nom de la colonne de début
• Nom de la colonne Fin
• Nom de la colonne Durée
• Nom de la colonne Ressource

Jeton d'authentification de base : cliquez sur votre profil en haut à droite, sélectionnez les paramètres du compte, cliquez sur les jetons API dans le panneau de gauche et suivez les instructions pour obtenir ce jeton**.URL du compte :** ex : votre-compte.tulip.coTaskTable ID : l'ID de la table peut être trouvé au niveau de la table

Date de planification : quel jour souhaitez-vous planifier ? Il s'agit d'un champ de type date.

Paramètres facultatifs

Day start : début de la ligne de temps. Valeur par défaut : 06:00Fin de journée**:** fin de la ligne de temps. La valeur par défaut est 21:00Unité de tempsdans l'heure : la valeur par défaut est 10 (en minutes), ce qui signifie que lorsque vous déplacez une tâche sur la ligne de temps, vous pouvez sélectionner par exemple 07:10 ou 07:20....., chaque étape est de 10 minutes. Si vous le changez par 30, vous pouvez sélectionner 07:00, 07:30..... chaque étape est de 30 minutesUnitwidth : largeur d'une étape en px, ce paramètre vous permet de définir la largeur du widget. La valeur par défaut est 13Largeur du nom de la ressource : Largeur de la colonne des ressources en px. La valeur par défaut est 220Overlap**:** le widget prend en charge le chevauchement des tâches.Infobox : il s'agit d'une fenêtre contextuelle permettant de voir le nom de la tâche si elle est recadrée. La valeur par défaut est falseStatuses**(cette option est disponible si l'infobox est activée) :** Le widget de planification fonctionne avec deux statuts fixes : "Programmée" et "Non programmée". En outre, il permet de définir des statuts supplémentaires tels que "Completed" (terminé) ou "Cancelled" (annulé). En fonction du paramètre ShowByDefault, le widget masque automatiquement les tâches si le paramètre ShowByDefault est "no" ou les affiche si le paramètre est "yes".

Les statuts personnalisés peuvent être trouvés dans l'infobox.

Mise en évidence du créneau horaire actuel : Affichage d'une ligne verticale indiquant la progression en temps réel, montrant notre position actuelle sur la ligne de temps. La valeur par défaut est false.

Déclencheurs

Les événements suivants sont disponibles dans le widget Planification :

Tâche planifiée : une tâche déposée sur la ligne de tempsTâchenon planifiée : une tâche retirée de la ligne de tempsTâche déplacée : une tâche qui vient d'êtrereplanifiéeMise à jour de l'état de la tâche**:** dans le cas de l'utilisation de statuts personnalisésTâchesélectionnée : cliqué sur une tâche planifiée

Tous les déclencheurs ont les résultats suivants, à l'exception de Tâche sélectionnée et Mise à jour de l'état de la tâche :

Le résultat de "Tâche sélectionnée" est l'ID de la tâche. Il peut être utilisé par exemple pour le chargement d'un enregistrement.

Comment cela fonctionne-t-il ?

Les tâches sont affichées sur le côté gauche, tandis que les ressources sont listées verticalement sur le côté droit du widget de planification. Chaque ressource dispose d'un calendrier quotidien dans lequel les tâches peuvent être placées. Lorsqu'une tâche est liée à une ressource, elle reçoit les heures de début et de fin de la journée planifiée et ne sera visible sur la ligne de temps du widget de planification que ce jour-là.Le widget de planification interagit avec la table des tâches CDM dans la base de données pour enregistrer les nouvelles planifications, les mouvements de tâches dans le temps ou entre les ressources, et le retrait des tâches de la ligne de temps d'une ressource par double-clic (en les plaçant dans un état non planifié). Ces processus d'arrière-plan utilisent la fonction intégrée fireEvent. De plus amples informations sur la fonction fireEvent sont disponibles ICI{target=_blank}:

• Prise en charge des chevauchements de tâches en définissant le paramètre "Overlap" sur true, utile pour gérer des tâches concurrentes sur la même ressource.
• Activation d'une infobox en définissant le paramètre "Infobox" sur true, affichant une petite fenêtre avec le nom complet de la tâche lorsque l'on clique, car parfois le nom peut ne pas tenir sur la ligne de temps.

Comment créer un jeton API

Vous trouverez ici{target=_blank} des informations détaillées sur la création d'un jeton API.

Pour en savoir plus

Si vous souhaitez en savoir plus sur les widgets personnalisés, veuillez consulter le site ci-dessous: Aperçudes widgets personnalisés{target=_blank}