:::(Info)To download, visit: Library.
:::
Objectif
Le widget « Timeline » est un widget interactif qui affiche les événements enregistrés à partir d’une table Tulip. Il affiche l’enregistrement le plus récent en haut, ce qui vous permet d’être toujours à jour.
Configuration
Champs obligatoires : - ID d’agrégation (agrégation de table Tulip) - Clé API (texte) - Secret (texte) - URL du compte (texte)
Champ facultatif : - Texte blanc (oui/non) - Activez l'option « oui » pour changer la couleur de la police en blanc. La valeur par défaut est « non ».
Pour configurer ce widget, vous devez fournir une clé API, un secret et une URL (qui se présente sous la forme « votre-compte.tulip.co »). Si vous ne savez pas ce qu’est une clé API, reportez-vous à la section suivante.Vous pouvez également configurer le widget dans l’éditeur d’application (avant de lancer l’application) en saisissant directement les informations dans les propriétés du widget.Une fois les informations nécessaires fournies, actualisez le widget. À ce stade, si le tableau contient des événements, ceux-ci devraient s’afficher dans le widget.Le widget utilise une agrégation. Grâce à cette agrégation, le widget est renseigné avec les informations relatives aux événements. Sans cette agrégation, il faudrait actualiser le widget après chaque insertion dans le tableau pour le maintenir à jour.
Comment créer un compte de service
Prior to r383, Service Accounts were called "API Tokens".
Pour accéder à la table des événements, vous devez disposer d’un compte de service doté de l’autorisation « tables : lecture ». Vérifiez que vous en possédez un en accédant à la section des paramètres de votre instance, puis à « Tulip API ». Si un espace de travail est configuré, cette option peut se trouver dans les paramètres de l’espace de travail.Si vous disposez déjà d’un compte de service, il figurera à cet emplacement. Cliquez sur « Modifier » et assurez-vous que l’option « tables : lecture » est cochée dans les champs d’application. Si c’est le cas, tout est prêt ; sinon, modifiez les champs d’application ou créez un nouveau compte de service.S'il n'y a aucun compte de service, créez-en un en cliquant sur le bouton « Créer un compte de service ». Attribuez-lui le nom de votre choix, puis sélectionnez les périmètres d'accès en vous assurant que l'option « tables : lecture » est cochée, ainsi que tout autre périmètre que vous jugez nécessaire. Il est préférable de n'attribuer que le minimum de privilèges nécessaires ; toutefois, en cas de doute, vous pouvez cocher toutes les options.Lorsque vous cliquez sur « Créer », une fenêtre s’affiche vous invitant à enregistrer la clé secrète. Respectez cette consigne, car si vous la perdez et devez régénérer la clé secrète, tous les emplacements où l’ancienne clé est utilisée devront être mis à jour avec la nouvelle clé.
Fonctionnement
Le widget se met automatiquement à jour lorsqu’un nouvel enregistrement est ajouté à la table. Il affiche les événements les plus récents en haut. Vous pouvez modifier la police si vous utilisez le widget sur un fond sombre.
Le tableau s’intitule « Événements de la chronologie » et comporte les colonnes suivantes : - ID (texte) - identifiant unique des événements ; il doit être créé automatiquement ; il n’est pas destiné à être affiché mais est nécessaire - Titre (texte) - titre de l’événement ; il doit être concis car il s’affiche en gros caractères - Description (texte) - si le titre n’est pas suffisamment descriptif, des détails supplémentaires peuvent être ajoutés ; ils s’affichent sous le titre- Type (texte) - il peut s’agir de l’une des valeurs suivantes ou être laissé vide : succès, erreur, avertissement, message, andon, pause, démarrage, arrêt, msteams - une icône par défaut est également associée si le type n’est pas spécifié ou ne correspond à aucune des valeurs mentionnées ci-dessus - dans le widget, ces valeurs sont traitées sans distinction de majuscules/minuscules- Date de création (métadonnées, masquée) - Chaque enregistrement d’une « Tulip table » comporte des métadonnées (date de création et date de mise à jour) qui ne peuvent pas être modifiées mais peuvent être utilisées dans des requêtes