GlideTimeline - Global

L’API GlideTimeline fournit l’implémentation de base 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é sous la forme d’une 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 en fonction de leur parent. Si vrai, cela imbriquera tous les éléments enfants à 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 false.

Si vrai, cela imbriquera tous les éléments enfants à 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 false.

Tableau 1. Paramètres

Nom	Type	Description
b	Booléen	Si cette propriété est définie sur vrai, les éléments de chronologie regroupés par parent s’affichent.

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
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 pour recevoir le strServerEventfichier . 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(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 est 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 est désactivée. 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
intSeconds	Numéro	Un entier spécifiant le temps, 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 de 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 mettre des paramètres supplémentaires dans le script client à la 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 de la dernière plage 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 de la dernière plage 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 à la fin de la dernière plage 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 de la dernière plage 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 de la dernière plage 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 de la dernière plage 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 de la dernière plage 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 de la dernière plage 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

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 toute interaction d’événement 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 vrai, marque l’ensemble de la chronologie comme étant en lecture seule (non interactif).

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, Nombre amount)

Spécifie 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 quadrillage sont activées.

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

Tableau 23. Paramètres

Nom	Type	Description
bShowGridlines	Booléen	Si vrai, la chronologie affiche le quadrillage ; 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(Boolean b)

Spécifie 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 n’est pas affiché.

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 s’affichent soit sous forme de nœuds imbriqués et indentés avec possibilité de développer et de réduire, soit sous forme de retrait unique. 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 vrai, les nœuds d’éléments enfants sont affichés comme étant en retrait avec l’option développer/réduire ; Dans le cas contraire, tous les éléments du volet de gauche sont affichés à un seul niveau de retrait.

Tableau 28. Renvoie

Type	Description
nul

glideTimeline.showLeftPaneAsTree(true);

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

Spécifie s’il faut ou non afficher la zone de saisie de texte en bas du volet de 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 false.

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

Tableau 29. Paramètres

Nom	Type	Description
b	Booléen	Si vrai, affichez la zone de saisie 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)

Spécifie s’il faut ou non afficher le volet de résumé au 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 vrai, la chronologie inclut le volet de résumé ; Dans le cas contraire, le volet Résumé ne s’affiche pas.

Tableau 32. Renvoie

Type	Description
nul

glideTimeline.showSummaryPane(false);

GlideTimeline : showTimelineText(booléen b)

Spécifie 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 un 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 accrocher l’ajustement à 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 parcours de chronologie est enclenché en lignes ; Dans le cas contraire, les éléments se déplacent exactement par rapport à la souris.

Tableau 36. Renvoie

Type	Description
nul

glideTimeline.snapVertScrollingIntoRows(false);

GlideTimeline : triByLeftLabelText(Booléen b)

Spécifie s’il faut ou non regrouper les éléments par leur texte d’étiquette 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 : triByStartDate(Boolean b)

Spécifie si la liste des éléments de chronologie renvoyée au plus tôt la date de début des objets de parcours de chronologie d’un élément doit être triée ou non. 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 : triByTimelineLabelText(Boolean b)

Spécifie 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é à 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 seront triés correctement 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 parcours de chronologie de chaque élément.

Tableau 42. Renvoie

Type	Description
nul

glideTimeline.sortByTimelineLabelText(true);