GlideTimeline : global

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 11 minutes de lecture
  • L’API GlideTimeline fournit l’implémentation de base pour configurer et afficher une chronologie de boîte à outils de fenêtrage Glide.

    Pour des raisons de sécurité, GlideTimeline a déjà été instanciée en tant que variable d’instance unique appelée GlideTimeline. Toutes les configurations doivent être effectuées dans la section de script client de la page de calendrier correspondante qui fait référence à cette variable d’instance.

    GlideTimeline : groupByParent (booléen b)

    Spécifie s’il faut ou non regrouper les éléments de chronologie par leur parent. Si vrai, tous les éléments enfants sont imbriqués à l’intérieur de leur parent. Cela affecte l’ordre d’affichage et les enfants seront toujours répertoriés immédiatement après leur parent. La valeur par défaut de la groupByParent propriété est faux.

    Si vrai, tous les éléments enfants sont imbriqués à l’intérieur de leur parent. Cela affecte l’ordre d’affichage et les enfants seront toujours répertoriés immédiatement après leur parent. La valeur par défaut de la groupByParent propriété est faux.

    Tableau 1. Paramètres
    Nom Type Description
    b Booléen Si la valeur est Vrai, affiche les éléments de chronologie regroupés par parent.
    Tableau 2. Renvoie
    Type Description
    nul
    glideTimeline.groupByParent(true);

    GlideTimeline : registerEvent(String strServerEvent, String strScriptIncludeName)

    Enregistre l’événement de serveur de chronologie spécifié. Le strServerEvent doit être l’un des événements autorisés pour que l’inscription fonctionne correctement. Lorsque l’événement se produit, le GlideTimeline envoie une demande au serveur et traite l’événement comme géré dans la classe strScriptIncludeName .

    Le strServerEvent doit être l’un des événements autorisés pour que l’inscription fonctionne correctement. Lorsque l’événement se produit, le GlideTimeline envoie une demande au serveur et traite l’événement comme géré dans la classe strScriptIncludeName .

    Tableau 3. Paramètres
    Nom Type Description
    strServerEvent Chaîne Spécifie l’un des événements sensibles à la casse suivants :
    • getItems
    • elementMoveX
    • elementMoveY
    • elementMoveXY
    • elementSuccessor
    • elementTimeAdjustStart
    • elementTimeAdjustEnd
    • inputBox
    • itemMove
    strScriptIncludeName Chaîne Spécifie le nom de la classe qui recevra le strServerEvent. Cette classe doit être définie dans un include de script qui étend AbstractTimelineSchedulePage.
    Tableau 4. Renvoie
    Type Description
    nul
    glideTimeline.registerEvent("getItems", "TimelineGanttSchedulePage");

    GlideTimeline : setAutoRefresh(Number intSeconds)

    Spécifie le nombre de secondes à attendre avant d’effectuer une actualisation automatique des données sur la chronologie. Définir le nombre de secondes sur 0 désactive l’actualisation automatique. Par défaut, l’actualisation automatique est désactivée. Si intSeconds la valeur est supérieure à 0 et inférieure à la durée minimale autorisée en secondes (10), elle est définie sur 10 secondes.

    Définir le nombre de secondes sur 0 désactive l’actualisation automatique. Par défaut, l’actualisation automatique est désactivée. Si intSeconds est supérieur à 0 et inférieur à la durée minimale autorisée en secondes (10), il est défini sur 10 secondes.

    Tableau 5. Paramètres
    Nom Type Description
    intSecondes Numéro Un entier spécifiant la durée, en secondes, entre l’actualisation automatique.
    Tableau 6. Renvoie
    Type Description
    nul
    glideTimeline.setAutoRefresh(15); // Sets the interval for auto-refreshing to 15 seconds.

    GlideTimeline : setDefaultPointIconClass(String icon_class)

    Spécifie la classe d’icône par défaut à utiliser pour les parcours de chronologie avec une durée nulle si aucune classe d’icône n’a été explicitement spécifiée dans les propriétés du parcours de chronologie renvoyé par le serveur. La valeur par défaut de la propriété setDefaultPointIconClass est milestone.

    La valeur par défaut de la propriété setDefaultPointIconClass est milestone.

    Tableau 7. Paramètres
    Nom Type Description
    icon_class Chaîne Chaîne qui spécifie l’une des valeurs suivantes :
    • jalon
    • blue_square
    • sepia_square
    • green_square
    • red_square
    • black_square
    • blue_circle
    • sepia_circle
    • green_circle
    • red_circle
    • black_circle
    Tableau 8. Renvoie
    Type Description
    nul
    glideTimeline.setDefaultPointIconClass('blue_circle');

    GlideTimeline : setExtraAjaxParam(String strName, String strValue)

    Permet de définir des paramètres supplémentaires dans le script client à mettre à la disposition des événements d’include de script correspondants à l’aide de la méthode getParameter( ). Les paramètres d’URI précédés d’un préfixe sysparm_timeline_ seront automatiquement inclus dans tous les appels AJAX côté serveur.

    Les paramètres d’URI précédés d’un préfixe sysparm_timeline_ seront automatiquement inclus dans tous les appels AJAX côté serveur.

    Tableau 9. Paramètres
    Nom Type Description
    strName Chaîne Nom du paramètre URI.
    strValue Chaîne La valeur de strName.
    Tableau 10. Renvoie
    Type Description
    nul
    glideTimeline.setExtraAjaxParam("sysparm_timeline_limit", "5");

    GlideTimeline : setInitialViewRange(String objStartDate, String objEndDate)

    Spécifie la plage d’affichage initiale pour la chronologie. Le format des dates de début et de fin doit être au format d’horodatage par défaut : aaaa-MM-jj HH :mm :ss. La plage par défaut est la plage qui spécifie le premier point de parcours de chronologie jusqu’à la fin du dernier parcours de chronologie. Si la initialViewRange propriété est spécifiée, elle remplacera la plage par défaut.

    Le format des dates de début et de fin doit être au format d’horodatage par défaut : aaaa-MM-jj HH :mm :ss. La plage par défaut est la plage qui spécifie le premier point de parcours de chronologie jusqu’à la fin du dernier parcours de chronologie. Si la initialViewRange propriété est spécifiée, elle remplacera la plage par défaut.

    Tableau 11. Paramètres
    Nom Type Description
    objStartDate Chaîne L’heure de début de la plage de vues au format : aaaa-MM-jj HH :mm :ss.
    objEndDate Chaîne L’heure de fin de la plage d’affichage au format : aaaa-MM-jj HH :mm :ss.
    Tableau 12. Renvoie
    Type Description
    nul
    // Sets the initial range to begin on June 20th, 2010 at 8:00 AM and end on June 28th, 2010 at 2:00 PM UTC time.
          glideTimeline.setInitialViewRange("2010-06-20 08:00:00", "2010-06-28 14:00:00");
        

    GlideTimeline : setInitialViewRange(Number objStartDate, Number objEndDate)

    Spécifie la plage d’affichage initiale pour la chronologie. La plage par défaut est la plage qui spécifie le premier point de parcours de chronologie jusqu’à la fin du dernier parcours de chronologie. Si la initialViewRange propriété est spécifiée, elle remplacera la plage par défaut.

    La plage par défaut est la plage qui spécifie le premier point de parcours de chronologie jusqu’à la fin du dernier parcours de chronologie. Si la initialViewRange propriété est spécifiée, elle remplacera la plage par défaut.

    Tableau 13. Paramètres
    Nom Type Description
    objStartDate Numéro L’heure de début de la plage de vues en millisecondes.
    objEndDate Numéro L’heure de fin en millisecondes.
    Tableau 14. Renvoie
    Type Description
    nul
    // Sets the initial range to begin on June 20th, 2010 at 8:00 AM and end on June 28th, 2010 at 2:00 PM UTC time.
          glideTimeline.setInitialViewRange(1277046000000, 1277647200000);

    GlideTimeline : setInitialViewRange(String objStartDate, Number objEndDate)

    Spécifie la plage d’affichage initiale pour la chronologie. La plage par défaut est la plage qui spécifie le premier point de parcours de chronologie jusqu’à la fin du dernier parcours de chronologie. Si la initialViewRange propriété est spécifiée, elle remplacera la plage par défaut.

    La plage par défaut est la plage qui spécifie le premier point de parcours de chronologie jusqu’à la fin du dernier parcours de chronologie. Si la initialViewRange propriété est spécifiée, elle remplacera la plage par défaut.

    Tableau 15. Paramètres
    Nom Type Description
    objStartDate Chaîne L’heure de début de la plage de vues au format : aaaa-MM-jj HH :mm :ss.
    objEndDate Numéro L’heure de fin en millisecondes.
    Tableau 16. Renvoie
    Type Description
    nul

    ExempleExplication

    // Sets the initial range to begin on June 20th, 2010 at 8:00 AM and end on June 28th, 2010 at 2:00 PM UTC time.
          glideTimeline.setInitialViewRange("2010-06-20 08:00:00", 1277647200000);

    GlideTimeline : setInitialViewRange(Number objStartDate, String objEndDate)

    Spécifie la plage d’affichage initiale pour la chronologie. La plage par défaut est la plage qui spécifie le premier point de parcours de chronologie jusqu’à la fin du dernier parcours de chronologie. Si la initialViewRange propriété est spécifiée, elle remplacera la plage par défaut.

    La plage par défaut est la plage qui spécifie le premier point de parcours de chronologie jusqu’à la fin du dernier parcours de chronologie. Si la initialViewRange propriété est spécifiée, elle remplacera la plage par défaut.

    Tableau 17. Paramètres
    Nom Type Description
    objStartDate Numéro L’heure de début de la plage de vues en millisecondes.
    objEndDate Chaîne L’heure de fin de la plage d’affichage au format : aaaa-MM-jj HH :mm :ss.
    Tableau 18. Renvoie
    Type Description
    nul

    ExempleExplication

    // Sets the initial range to begin on June 20th, 2010 at 8:00 AM and end on June 28th, 2010 at 2:00 PM UTC time.
          glideTimeline.setInitialViewRange(1277046000000, "2010-06-28 14:00:00");

    GlideTimeline : setReadOnly(booléen b)

    Active ou désactive toutes les interactions des événements de chronologie. Si cette option est activée, l’interaction de l’événement est déterminée à partir des attributs correspondants spécifiés par chaque élément de chronologie . La valeur par défaut de la readOnly propriété est faux.

    Si cette option est activée, l’interaction de l’événement est déterminée à partir des attributs correspondants spécifiés par chaque élément de chronologie . La valeur par défaut de la readOnly propriété est faux.

    Tableau 19. Paramètres
    Nom Type Description
    b Booléen Si la valeur est Vrai, marque la chronologie entière en lecture seule (non interactive).
    Tableau 20. Renvoie
    Type Description
    nul
    glideTimeline.setReadOnly(true);

    GlideTimeline : showDependencyLines(booléen b)

    Spécifie s’il faut ou non afficher les lignes de dépendance entre les parcours de chronologie. Cette méthode s’applique uniquement si l’ensemble des éléments de chronologie renvoyés par le serveur inclut des relations de dépendance. La valeur par défaut de la propriété showDependencyLines est false.

    Cette méthode s’applique uniquement si l’ensemble des éléments de chronologie renvoyés par le serveur inclut des relations de dépendance. La valeur par défaut de la propriété showDependencyLines est false.

    Tableau 21. Paramètres
    Nom Type Description
    b Booléen Si vrai, affiche les lignes de dépendance sur la chronologie ; sinon, ce n’est pas le cas.
    Tableau 22. Renvoie
    Type Description
    nul
    glideTimeline.showDependencyLines(true);

    GlideTimeline : showGridLines(booléen bShowGridlines, montant du nombre)

    Indique s’il faut ou non afficher le quadrillage pour chaque ligne de données de la chronologie. Par défaut, les lignes de grille sont activées.

    Par défaut, les lignes de grille sont activées.

    Tableau 23. Paramètres
    Nom Type Description
    bShowGridlines Booléen Si vrai, la chronologie affiche les lignes de la grille ; sinon, n’affiche pas le quadrillage.
    calculer le montant de Numéro calculer le montant de
    Tableau 24. Renvoie
    Type Description
    nul Valeur de retour
    glideTimeline.showGridLines(false); // Disables grid lines.

    GlideTimeline : showLeftPane(booléen b)

    Indique s’il faut ou non afficher le volet gauche dans la chronologie. La valeur par défaut de la leftPane propriété est vrai.

    La valeur par défaut de la leftPane propriété est vrai.

    Tableau 25. Paramètres
    Nom Type Description
    b Booléen Si vrai, la chronologie affiche le volet gauche ; Sinon, le volet gauche ne s’affiche pas.
    Tableau 26. Renvoie
    Type Description
    nul
    glideTimeline.showLeftPane(false);

    GlideTimeline : showLeftPaneAsTree(booléen b)

    Spécifie comment afficher les éléments enfants dans le volet gauche de la chronologie. Les éléments enfants sont affichés sous forme de nœuds imbriqués et indentés avec une fonction de développement et de réduction, ou sur un seul niveau de retrait. La valeur par défaut de la showLeftPaneAsTree propriété est faux.

    La valeur par défaut de la showLeftPaneAsTree propriété est faux.

    Tableau 27. Paramètres
    Nom Type Description
    b Booléen Si vrai, les nœuds d’éléments enfants sont affichés en retrait avec la possibilité de développer/réduire ; Dans le cas contraire, tous les éléments du volet gauche s’affichent à un seul niveau de retrait.
    Tableau 28. Renvoie
    Type Description
    nul
    glideTimeline.showLeftPaneAsTree(true);

    GlideTimeline : showLeftPaneInputBox(Booléen b, chaîne strDefaultValue)

    Indique s’il faut ou non afficher la zone de saisie de texte en bas du volet gauche avec une valeur par défaut spécifiée par strDefaultValue. Si le volet gauche est désactivé via showLeftPane(), la zone de saisie ne sera pas visible. La valeur par défaut de la showLeftPaneInputBox propriété est faux.

    Si le volet gauche est désactivé via showLeftPane(), la zone de saisie ne sera pas visible. La valeur par défaut de la showLeftPaneInputBox propriété est faux.

    Tableau 29. Paramètres
    Nom Type Description
    b Booléen Si vrai, affichez la zone d’entrée du volet gauche.
    strDefaultValue Chaîne Valeur par défaut à afficher dans la zone de saisie.
    Tableau 30. Renvoie
    Type Description
    nul
    glideTimeline.showLeftPaneInputBox(true, 'Add a new task ...');
        

    GlideTimeline : showSummaryPane(booléen b)

    Indique s’il faut ou non afficher le volet de résumé en bas de la chronologie. La valeur par défaut de la propriété showSummaryPane est vrai.

    La valeur par défaut de la propriété showSummaryPane est vrai.

    Tableau 31. Paramètres
    Nom Type Description
    b Booléen Si la valeur est Vrai, la chronologie inclut le volet Résumé ; Sinon, le panneau de résumé n’est pas affiché.
    Tableau 32. Renvoie
    Type Description
    nul
    glideTimeline.showSummaryPane(false);

    GlideTimeline : showTimelineText(booléen b)

    Indique s’il faut ou non afficher le texte de la chronologie sous chaque parcours de chronologie dans le volet de chronologie principal. La valeur par défaut de la propriété showTimelineText est false.

    La valeur par défaut de la propriété showTimelineText est false.

    Tableau 33. Paramètres
    Nom Type Description
    b Booléen Si vrai, affiche du texte descriptif sous chaque parcours de chronologie ; sinon, aucun texte n’est affiché sous chaque parcours de chronologie.
    Tableau 34. Renvoie
    Type Description
    nul
    glideTimeline.showTimelineText(true);

    GlideTimeline : snapVertScrollingIntoRows(Booléen b)

    Spécifie si le mouvement vertical des objets de parcours de chronologie (s’ils sont correctement enregistrés pour effectuer cet événement) doit ou non s’ajuster à la ligne la plus proche. Par défaut, cette valeur est activée.

    Par défaut, cette valeur est activée.

    Tableau 35. Paramètres
    Nom Type Description
    b Booléen Si la valeur est vrai, il ancre le mouvement vertical des objets du parcours de chronologie en lignes ; sinon, les éléments se déplacent exactement par rapport à la souris.
    Tableau 36. Renvoie
    Type Description
    nul
    glideTimeline.snapVertScrollingIntoRows(false);

    GlideTimeline : sortByLeftLabelText(Booléen b)

    Spécifie s’il faut ou non regrouper les éléments selon leur texte d’étiquette gauche. La valeur par défaut de la sortByLeftLabelText propriété est faux.

    La valeur par défaut de la sortByLeftLabelText propriété est faux.

    Tableau 37. Paramètres
    Nom Type Description
    b Booléen Si vrai, triez les éléments de chronologie par ordre alphabétique selon le texte spécifié dans l’étiquette de gauche de chaque élément.
    Tableau 38. Renvoie
    Type Description
    nul
    glideTimeline.sortByLeftLabelText(true);

    GlideTimeline : sortByStartDate(booléen b)

    Spécifie s’il faut trier ou non la liste des éléments de chronologie renvoyés en fonction de la date de début la plus proche des objets de parcours de chronologie d’un élément. Si groupByParent() est défini sur vrai, les éléments sont triés après le regroupement. La valeur par défaut de la sortByStartDate propriété est faux.

    Si groupByParent() est défini sur vrai, les éléments sont triés après le regroupement. La valeur par défaut de la sortByStartDate propriété est faux.

    Tableau 39. Paramètres
    Nom Type Description
    b Booléen Si vrai, triez les éléments de chronologie par ordre chronologique en commençant par leur date de début la plus ancienne.
    Tableau 40. Renvoie
    Type Description
    nul
    glideTimeline.sortByStartDate(true);

    GlideTimeline : sortByTimelineLabelText(booléen b)

    Indique s’il faut ou non trier la liste des éléments de chronologie renvoyés par ordre alphabétique en fonction du texte qui a été spécifié pour s’afficher dans le volet Chronologie.

    Remarque :
    Cet ordre de tri s’applique toujours même si le texte de la chronologie a été défini sur false via la méthode showTimelineText( ). De plus, si groupByParent() est défini sur vrai, les éléments sont triés de manière appropriée après le regroupement.

    La valeur par défaut de la sortByTimelineLabelText propriété est faux.

    Tableau 41. Paramètres
    Nom Type Description
    b Booléen Si vrai, trie les éléments de chronologie par ordre alphabétique selon le texte spécifié dans le texte du parcours de chronologie de chaque élément.
    Tableau 42. Renvoie
    Type Description
    nul
    glideTimeline.sortByTimelineLabelText(true);