--- title: "Widget de planification personnalisé" slug: "job-planningscheduling-board" status: "update" updated: 2026-10-22T17:16:12Z published: 2026-10-22T17:16:12Z canonical: "support.tulip.co/job-planningscheduling-board" --- > ## Documentation Index > Fetch the complete documentation index at: https://support.tulip.co/llms.txt > Use this file to discover all available pages before exploring further. # Widget de planification personnalisé To download the app, visit: [widget](https://library.tulip.co/apps/scheduling-custom-Library ## Objectif Le widget de planification personnalisé constitue une solution innovante pour la gestion des tâches. Ce widget de planification est conçu pour être utilisé au sein des applications Tulip afin de récupérer des tâches ou des missions à partir d’une base de données, chacune ayant une durée qui lui est propre. Affichées sur le côté gauche du widget, les tâches apparaissent sous forme de liste disposée verticalement. En glissant-déposant des tâches sur l’une des ressources situées à droite du widget de planification, il est possible de planifier des tâches ou des missions sur un axe temporel. Cette attribution lie la tâche ou la mission à une ressource spécifique, en indiquant quand celle-ci s’en chargera. En substance, ce widget personnalisé rationalise le processus d’affectation des tâches en facilitant l’association visuelle entre les tâches et les ressources grâce à une fonctionnalité intuitive de glisser-déposer, garantissant ainsi une gestion et une planification efficaces au sein de l’interface Tulip. ![scheduling-printscreen.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/scheduling-printscreen.png) ## Configuration Lors de la configuration du widget, certains paramètres sont obligatoires, tandis que d’autres sont facultatifs et présentent des valeurs par défaut. Pour établir la connexion avec le système du client, le widget nécessite les éléments suivants : - L'URL de l'instance du client - Un jeton d’authentification pour l’accès, à la place des identifiants de connexion - Si le client n'utilise pas l'espace de travail DEFAULT, 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 sur une table. Les tâches destinées au widget de planification sont extraites de la table Tulip en fonction de l’ID de la table et de ses champs. Celles-ci étant personnalisables, le widget de planification offre une flexibilité accrue si une autre table est utilisée. Le widget de planification comporte les paramètres suivants à définir : ### 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 en tant que variable d’application.**Noms de colonnes :** les identifiants des champs se trouvent au niveau de la table « Task » ; veuillez les ajouter un par un. La table « Task » est accessible de la manière suivante :![scheduling-table.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/scheduling-table%281%29.png) L'ID du champ peut être trouvé de la manière suivante :![tablefield-unique-name.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/tablefield-unique-name.png) - *ID de la tâche* - *Nom de la tâche* - *Nom de la colonne « Statut »* - *Nom de la colonne « 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 dans le coin supérieur droit, sélectionnez « Paramètres du compte », cliquez sur « API Tulip » dans le panneau de gauche et suivez les instructions pour créer un compte de service.**URL du compte :** par exemple : votre-compte.tulip.**co ID de la table des tâches :** l'ID de la table se trouve au niveau de la table![tableID.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/tableID.png) **Date de planification :** pour quel jour souhaitez-vous planifier ? Il s'agit d'un champ date-heure. ### Paramètres facultatifs **Début de la journée :** début de la chronologie. La valeur par défaut est 06:**00. Fin de la journée :** fin de la chronologie. La valeur par défaut est 21**h 00. Unité de temps par heure :** la valeur par défaut est 10 (en minutes) ; cela signifie que lorsque vous déplacez une tâche sur la chronologie, vous pouvez sélectionner par exemple 07 h 10 ou 07 h 20… Chaque pas correspond à 10 minutes. Si vous modifiez cette valeur à 30, vous pouvez alors sélectionner 07 h 00, 07 h 30…, chaque pas correspondant à 30**minutes**.**Largeur** d’un**pas :** largeur d’un pas en px ; ce paramètre vous permet de définir la largeur du widget. La valeur par défaut est 13. Largeur du nom de la ressource : largeur de la colonne « Ressource » en px. La valeur par défaut est**220. Chevauchement :** le widget prend en charge le chevauchement des tâches. La valeur par défaut est « false ».**Infobox :** il s’agit d’une fenêtre contextuelle permettant de voir le nom de la tâche si celle-ci est coupée. La valeur par défaut est «**false ». Statuts (cette option est disponible si l’Infobox est activée) :** le widget de planification fonctionne avec deux statuts fixes : « Planifié » et « Non planifié ». De plus, il offre la possibilité de définir des statuts supplémentaires tels que « Terminé » ou « Annulé ». Pour les statuts personnalisés, il est possible de spécifier une couleur et de définir un comportement par défaut (ShowByDefault). En fonction du paramètre ShowByDefault, le widget masque automatiquement les tâches si ShowByDefault est défini sur « non » ou les affiche si ShowByDefault est défini sur « oui ». Les statuts personnalisés sont disponibles dans l’infobox.![image.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/image%28871%29.png) **Mettre en évidence le créneau horaire actuel :** affiche une ligne verticale indiquant la progression en temps réel, montrant notre position actuelle sur la chronologie. La valeur par défaut est « false ». ## Déclencheurs Les événements suivants sont disponibles sur le widget de planification : **Tâche planifiée :** une tâche a été ajoutée à la**chronologie.** **Tâche****non planifiée :** une tâche a été supprimée de la chronologie **. Tâche déplacée :** une tâche vient**d’être replanifiée. Mise à jour du statut de la tâche :** en cas d’utilisation**de statuts** personnalisés.**Tâche sélectionnée :** clic sur une tâche planifiée. ![image.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/image%28870%29.png) Tous les déclencheurs ont les effets suivants, à l'exception de « Tâche sélectionnée » et « Mise à jour du statut de la tâche » : ![scheduling-widget-results.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/scheduling-widget-results.png) Le résultat du déclencheur « Tâche sélectionnée » est l'ID de la tâche. Il peut être utilisé, par exemple, pour charger un enregistrement. ## Fonctionnement Il récupère les tâches via un appel API à partir de la table des tâches d’une base de données, tandis que les ressources sont obtenues à partir des paramètres du widget. Les tâches s’affichent à gauche, tandis que les ressources sont répertoriées verticalement à droite du widget de planification. Chaque ressource dispose d’une chronologie quotidienne sur laquelle les tâches peuvent être placées. Les tâches précédemment attribuées réapparaissent automatiquement sur la chronologie lorsque le widget est rechargé. Lorsqu’une tâche est associée à une ressource, elle se voit attribuer des heures de début et de fin pour la journée prévue et ne sera visible sur la chronologie du widget de planification que ce jour-là.Le widget de planification interagit avec la table « CDM Task » de la base de données pour enregistrer les nouveaux plannings, les déplacements de tâches dans le temps ou entre les ressources, ainsi que la suppression de tâches de la chronologie d’une ressource par double-clic (les plaçant ainsi dans un état non planifié). Ces processus en arrière-plan fonctionnent à l’aide de la fonction intégrée `fireEvent`. Vous trouverez plus d’informations sur la fonction fireEvent [ICI](https://support.tulip.co/docs/custom-widgets-overview#fire-an-event){`target=_blank`}.Fonctionnalités supplémentaires : - Prise en charge des chevauchements de tâches en définissant le paramètre « Overlap » sur true, ce qui est utile pour gérer des tâches simultanées sur une même ressource. - Activation d’une infobox en définissant le paramètre « Infobox » sur « true », ce qui affiche une petite fenêtre contenant le nom complet de la tâche lorsque l’on clique dessus, car il arrive parfois que le nom ne tienne pas sur la chronologie. ## Comment créer un compte de service Feature rename Prior to r383, Service Accounts were called "API Tokens". Vous trouverez[ici](https://support.tulip.co/r230/docs/setting-up-a-tulip-api#adding-an-api){`target=_blank`} des informations détaillées sur la création d’un compte de service. ## Pour en savoir plus Si vous souhaitez en savoir plus sur custom widgets, veuillez consulter le site ci-dessous :[Présentation d'Custom Widgets](https://support.tulip.co/docs/custom-widgets-overview) {`target=_blank`}