MENU
    Widget chronologique
    • 23 Jan 2025
    • 3 Minutes à lire
    • Contributeurs

    Widget chronologique


    Résumé de l’article

    Objectif

    Le widget Timeline est un widget interactif qui affiche les événements enregistrés dans une table Tulip. Il affiche l'enregistrement le plus récent, ce qui vous permet d'être toujours à jour.

    image

    Configuration

    Champs obligatoires:- ID d'agrégation (agrégation de la table Tulip)- Clé API (texte)- Secret (texte)- URL du compte (texte)

    Champ facultatif:- Texte blanc (oui/non) - Passez à "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 ressemble à your-account.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 les informations directement dans les propriétés du widget. Une fois que vous avez fourni les informations nécessaires, actualisez le widget. À ce stade, si vous avez des événements dans le tableau, ils devraient être affichés dans le widget. Le widget utilise une agrégation. Grâce à l'agrégation, le widget est alimenté par les informations relatives aux événements. Sans cette agrégation, le widget devrait être rafraîchi après chaque insertion dans la table pour rester à jour.

    Comment créer un jeton API

    Pour accéder à la table des événements, vous devez disposer d'un jeton API avec l'autorisation tables : read. Vérifiez que vous en avez un en naviguant vers la section des paramètres de votre instance, puis vers "API tokens". Si un espace de travail est configuré, il peut se trouver dans les paramètres de l'espace de travail. Si vous possédez déjà un jeton, il sera répertorié à cet endroit. Cliquez sur "Modifier" et assurez-vous que l'option tables : read est cochée sous scopes. Si c'est le cas, vous êtes prêt ; si ce n'est pas le cas, ajustez les champs d'application ou créez un nouveau jeton. Si aucun jeton n'est présent, créez-en un en cliquant sur le bouton "Create API token" (Créer un jeton API). Attribuez le nom de votre choix, puis sélectionnez les champs d'application, en veillant à ce que l'option tables : read soit cochée, ainsi que tout autre champ d'application que vous jugerez approprié. De préférence, attribuez le moins de privilèges possible, mais en cas d'incertitude, vous pouvez cocher toutes les options.En cliquant sur "Créer", une fenêtre s'affiche pour vous demander de sauvegarder la clé secrète. Respectez cette consigne, car si vous la perdez et que vous devez régénérer le secret, tous les endroits où l'ancien secret est utilisé devront être mis à jour avec le nouveau secret.

    Fonctionnement

    Le widget se met automatiquement à jour lorsqu'un nouvel enregistrement est ajouté au tableau. Il affiche les derniers événements en haut. Vous pouvez modifier la police de caractères si vous utilisez le widget sur un fond plus sombre.

    Le tableau s'appelle " Événements de la ligne du temps" et comporte les colonnes suivantes:- ID (texte) - identifiant unique pour les événements ; il doit être créé automatiquement et n'est pas destiné à être affiché, mais il est nécessaire- Titre (texte) - titre de l'événement ; il doit être concis car il est affiché en plus grand- Description (texte) - si le titre n'est pas suffisamment descriptif, des détails supplémentaires peuvent être ajoutés et affichés sous le titre- Type (texte) - il peut s'agir de l'un des éléments suivants ou être laissé vide : succès, erreur, avertissement, message, etc : success, error, warning, message, andon, pause, start, stop, msteams - il existe également une icône par défaut si le type n'est pas indiqué ou n'est pas l'un de ceux mentionnés précédemment - ils sont traités sans tenir compte de la casse dans le widget- Date de création (métadonnées, cachées) - chaque enregistrement dans une table Tulip possède des métadonnées (date de création et date de mise à jour) qui ne peuvent pas être modifiées mais qui peuvent être utilisées dans les requêtes.


    Cet article vous a-t-il été utile ?