GlideTimeline : global

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 12 minutes de lecture
  • La classe GlideTimeline fournit l’implémentation principale pour la configuration et l’affichage d’une chronologie de boîte à outils de fenêtrage Glide.

    Pour des raisons de sécurité, GlideTimeline a déjà été instancié en tant que variable d’instance unique nommé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 parent. Si la valeur est vrai, tous les éléments enfants sont imbriqués dans 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 false.

    Si la valeur est vrai, tous les éléments enfants sont imbriqués dans 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 false.

    Tableau 1. Paramètres
    Nom Type Description
    b Booléen Si cette propriété est définie sur vrai, elle 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, GlideTimeline envoie une demande au serveur et traite l’événement tel qu’il est traité à l’intérieur de 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, GlideTimeline envoie une demande au serveur et traite l’événement tel qu’il est traité à l’intérieur de la classe strScriptIncludeName .

    Tableau 3. Paramètres
    Nom Type Description
    strServeurÉvénement 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 strServerEventfichier . Cette classe doit être définie dans un script include qui étend AbstractTimelineSchedulePage.
    Tableau 4. Renvoie
    Type Description
    nul
    glideTimeline.registerEvent("getItems", "TimelineGanttSchedulePage");

    GlideTimeline : setAutoRefresh(Nombre intSeconds)

    Spécifie le nombre de secondes à attendre avant d’effectuer une actualisation automatique des données sur la chronologie. Si vous réglez le nombre de secondes sur 0, l’actualisation automatique sera désactivée. 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.

    Si vous réglez le nombre de secondes sur 0, l’actualisation automatique sera désactivée. Par défaut, l’actualisation automatique est désactivée. Si intSeconds est supérieur à 0 et inférieur au temps minimum autorisé en secondes (10), il sera défini sur 10 secondes.

    Tableau 5. Paramètres
    Nom Type Description
    intSeconds Numéro Nombre 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(chaîne icon_class)

    Spécifie la classe d’icône par défaut à utiliser pour les parcours de chronologie sans durée 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 :
    • Étape
    • 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 mettre des paramètres supplémentaires dans le script client à disposition des événements Script Include correspondants à l’aide de la méthode getParameter( ). Les paramètres d’URI préfixés par sysparm_timeline_ seront automatiquement inclus dans tous les appels AJAX côté serveur.

    Les paramètres d’URI préfixés par 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 de l’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 à 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 à 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 de vues 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 à 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 à 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 à 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 à 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

    ExampleExplanation

    // 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 à 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 à 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 de vues au format : aaaa-MM-jj HH :mm :ss .
    Tableau 18. Renvoie
    Type Description
    nul

    ExampleExplanation

    // 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 d’é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 false.

    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 false.

    Tableau 19. Paramètres
    Nom Type Description
    b Booléen Si cette propriété est définie sur vrai, elle marque l’intégralité de la chronologie comme étant 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 ce paramètre est défini sur vrai, les lignes de dépendance sont affichées sur la chronologie ; sinon, ne le fait pas.
    Tableau 22. Renvoie
    Type Description
    nul
    glideTimeline.showDependencyLines(true);

    GlideTimeline - showGridLines(Boolean bShowGridlines, Number amount)

    Indique s’il faut ou non afficher des lignes de grille 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 du quadrillage ; sinon, n’affiche pas les lignes de grille.
    calculer le montant de Numéro calculer le montant de
    Tableau 24. Renvoie
    Type Description
    nul Returnvalue
    glideTimeline.showGridLines(false); // Disables grid lines.

    GlideTimeline : showLeftPane(Boolean 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 true.

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

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

    GlideTimeline : showLeftPaneAsTree(booléen b)

    Indique comment afficher les éléments enfants dans le volet gauche de la chronologie. Les éléments enfants s’affichent soit sous forme de nœuds imbriqués et mis en retrait avec une aptitude de développement et de réduction, soit sous forme de mises en retrait uniques. La valeur par défaut de la showLeftPaneAsTree propriété est false.

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

    Tableau 27. Paramètres
    Nom Type Description
    b Booléen Si la valeur est vrai, les nœuds d’éléments enfants sont affichés en retrait avec l’option de développement/réduction ; Sinon, tous les éléments du volet gauche sont affichés à un seul niveau de retrait.
    Tableau 28. Renvoie
    Type Description
    nul
    glideTimeline.showLeftPaneAsTree(true);

    GlideTimeline : showLeftPaneInputBox(Boolean b, String 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 telle que spécifiée par strDefaultValue. Si le volet de 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 false.

    Si le volet de 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 false.

    Tableau 29. Paramètres
    Nom Type Description
    b Booléen Si la valeur est vrai, afficher la zone d’entrée du volet gauche.
    strDefaultValue Chaîne Valeur par défaut à afficher dans la zone d’entrée.
    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 true.

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

    Tableau 31. Paramètres
    Nom Type Description
    b Booléen Si la valeur est vrai, la chronologie inclut le volet de résumé ; Sinon, le volet de résumé ne s’affiche pas.
    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 le 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 l’étendue de la chronologie (s’ils sont enregistrés de manière appropriée pour effectuer cet événement) doit 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, le mouvement vertical des objets de l’étendue de la chronologie est enclenché dans les 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 en fonction du texte de l’étiquette de gauche. La valeur par défaut de la sortByLeftLabelText propriété est false.

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

    Tableau 37. Paramètres
    Nom Type Description
    b Booléen Si vrai, triez les éléments de chronologie par ordre alphabétique en fonction du 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 avant la première date de début 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 false.

    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 false.

    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 : triParTimelineLabelText(Booléen b)

    Indique s’il faut trier ou non 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 de chronologie.

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

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

    Tableau 41. Paramètres
    Nom Type Description
    b Booléen Si cette propriété est définie sur vrai, trie les éléments de chronologie par ordre alphabétique en fonction du texte spécifié dans le texte de la période chronologique de chaque élément.
    Tableau 42. Renvoie
    Type Description
    nul
    glideTimeline.sortByTimelineLabelText(true);