---
sourceDocument: Référence de l’API Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - fr-FR

ft:publication_title :

    - Référence de l’API Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# GlideTimelineItem : global

# GlideTimelineItem : global {#ariaid-title1}

* Rversion finale: Xanadu
* 
* Mis à jour 1 août 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 7 minutes de lecture

L'API GlideTimelineItem étend la classe abstraite ScheduleItem pour définir des propriétés supplémentaires spécifiques à la chronologie.

Un élément de ligne de temps est essentiellement un élément qui s'affiche sur une ligne unique sur la chronologie. Un GlideTimelineItem a zéro ou plusieurs parcours associés (objets TimelineSpan).

## GlideTimelineItem : GlideTimelineItem(String tableName) {#ariaid-title2}

Créer un objet GlideTimelineItem \<\< factice \>\>.
Ceci est utile pour créer des lignes qui n'autorisent aucun YMoving dans ; toutefois, contiennent des enfants imbriqués (par exemple, la ligne \<\< Utilisateurs \>\> de niveau supérieur dans la chronologie des ressources de groupe). Il sys_id doit être unique pour que les fonctions au niveau DOM s'analysent correctement. Par défaut, cet objet ne sera pas \<\< droppable \>\> car aucun nom de table n'a été spécifié.
{#r_TLI-TimelineItem_S__table_dpl_1jm_zt__entry__3}

| Nom | Type | Description |
|-|-|-|
| tableName | Chaîne | Nom de la table associée à l'objet actuel. |
[Tableau 1. Paramètres]

{#r_TLI-TimelineItem_S__table_dpl_1jm_zt} {#r_TLI-TimelineItem_S__table_epl_1jm_zt__entry__2}

| Type | Description |
|-|-|
| nul |   |
[Tableau 2. Renvoie]

{#r_TLI-TimelineItem_S__table_epl_1jm_zt}

## GlideTimelineItem : GlideTimelineItem(String, tableName, chaîne, sys_id) {#ariaid-title3}

Constructeur qui définit la table et sys_id les propriétés requises.
Le reste des propriétés de cet objet doit être défini par l'appelant. Par défaut, cette instance d'objet est \<\< droppable \>\> puisqu'un nom de table est spécifié.
{#r_TLI-TimelineItem_S_S__table_fpl_1jm_zt__entry__3}

| Nom | Type | Description |
|-|-|-|
| tableName | Chaîne | Nom de la table associée à l'objet actuel. |
| sys_id | Chaîne | ID système de l'objet. |
[Tableau 3. Paramètres]

{#r_TLI-TimelineItem_S_S__table_fpl_1jm_zt} {#r_TLI-TimelineItem_S_S__table_gpl_1jm_zt__entry__2}

| Type | Description |
|-|-|
| nul |   |
[Tableau 4. Renvoie]

{#r_TLI-TimelineItem_S_S__table_gpl_1jm_zt}

## GlideTimelineItem : createTimelineSpan (String tableName) {#ariaid-title4}

Crée un nouvel objet TimelineSpan associé à l'objet d'instance actuel.
S'il n'existe aucun autre objet TimelineSpan , l'objet nouvellement créé partagera le même sys_id objet que l'objet d'instance actuel. Sinon, un GUID généré aléatoirement sera utilisé.
{#r_TLI-createTimelineSpan_S__table_hpl_1jm_zt__entry__3}

| Nom | Type | Description |
|-|-|-|
| tableName | Chaîne | Nom de la table associée à l'objet actuel. |
[Tableau 5. Paramètres]

{#r_TLI-createTimelineSpan_S__table_hpl_1jm_zt} {#r_TLI-createTimelineSpan_S__table_ipl_1jm_zt__entry__2}

| Type | Description |
|-|-|
| Objet | L'instance d'objet span nouvellement créée. |
[Tableau 6. Renvoie]

{#r_TLI-createTimelineSpan_S__table_ipl_1jm_zt}

## GlideTimelineItem : createTimelineSpan (chaîne, tableName, chaîne sys_id) {#ariaid-title5}

Crée un nouvel objet TimelineSpan associé à l'objet d'instance actuel à l'aide de la table et du sys_id spécifiés.
{#r_TLI-createTimelineSpan_S_S__table_jpl_1jm_zt__entry__3}

| Nom | Type | Description |
|-|-|-|
| tableName | Chaîne | Nom de la table associée à l'objet actuel |
| sys_id | Chaîne | Sys_id pour l'objet. |
[Tableau 7. Paramètres]

{#r_TLI-createTimelineSpan_S_S__table_jpl_1jm_zt} {#r_TLI-createTimelineSpan_S_S__table_kpl_1jm_zt__entry__2}

| Type | Description |
|-|-|
| Objet | Instance d'objet de parcours nouvellement créée. |
[Tableau 8. Renvoie]

{#r_TLI-createTimelineSpan_S_S__table_kpl_1jm_zt}  
L'exemple suivant montre comment utiliser createTimelineSpan() pour créer un nouvel objet TimelineSpan.

    var project_id="741cc7491b6f1c5043de32231b4bcbc5"; // Project ID 
    var grUser = new GlideRecord('user_resource');
    grUser.addQuery('planned_task', project_id);
    grUser.setQueryReferences(true);
    grUser.orderBy('user.name', 'DESC');
    grUser.query();
    while (grUser.next()) {
      var item = new GlideTimelineItem(grUser.getTableName(), grUser.user);
      /* Specify the text to display in the left pane for this item. */
      item.setLeftLabelText(grUser.user.name); 
      /* Set the name of the image file (including it's path) */
      item.setImage('../images/icons/user.gifx'); 
      /* Specify whether or not to bold the text style of the item in the left pane. */
      item.setTextBold(true); 
      /* Set whether or not the current instance object can be clicked and dragged into another GlideTimelineItem */
      item.setIsDraggable(true);
      /* Create a new TimelineSpan object associated with the current instance object using the specified table and sys_id. */ 
      item.createTimelineSpan(grUser.getTableName(), grUser.getUniqueValue());
    }

## GlideTimelineItem : getImage( ) {#ariaid-title6}

Renvoie une chaîne spécifiant le nom du fichier image associé au GlideTimelineItem actuel.
{#r_TLI-getImage__table_lpl_1jm_zt__entry__3}

| Nom | Type | Description |
|-|-|-|
| aucun |   |   |
[Tableau 9. Paramètres]

{#r_TLI-getImage__table_lpl_1jm_zt} {#r_TLI-getImage__table_mpl_1jm_zt__entry__2}

| Type | Description |
|-|-|
| Chaîne | Nom du fichier image associé au GlideTimelineItem actuel. Si aucune image n'est associée à l'élément actuel, une chaîne vide (\<\< \>\>) est renvoyée. |
[Tableau 10. Renvoie]

{#r_TLI-getImage__table_mpl_1jm_zt}

## GlideTimelineItem : getIsDroppable( ) {#ariaid-title7}

Indique si l'objet d'instance actuel doit être autorisé ou non en tant que \<\< zone de dépôt \>\> lors du déplacement vertical d'éléments de chronologie.
{#r_TLI-getIsDroppable__table_npl_1jm_zt__entry__3}

| Nom | Type | Description |
|-|-|-|
| aucun |   |   |
[Tableau 11. Paramètres]

{#r_TLI-getIsDroppable__table_npl_1jm_zt} {#r_TLI-getIsDroppable__table_opl_1jm_zt__entry__2}

| Type | Description |
|-|-|
| Booléen | Vrai si droppable ; false dans le cas contraire. |
[Tableau 12. Renvoie]

{#r_TLI-getIsDroppable__table_opl_1jm_zt}

## GlideTimelineItem : getLeftLabelText( ) {#ariaid-title8}

Renvoie le texte à afficher dans le volet gauche (si activé).
{#r_TLI-getLeftLabelText__table_fmb_2tm_zt__entry__3}

| Nom | Type | Description |
|-|-|-|
| aucun |   |   |
[Tableau 13. Paramètres]

{#r_TLI-getLeftLabelText__table_fmb_2tm_zt} {#r_TLI-getLeftLabelText__table_gmb_2tm_zt__entry__2}

| Type | Description |
|-|-|
| Chaîne | Valeur du texte à afficher dans le panneau de gauche. |
[Tableau 14. Renvoie]

{#r_TLI-getLeftLabelText__table_gmb_2tm_zt}

## GlideTimelineItem : getParent( ) {#ariaid-title9}

Renvoie l'unique sysId de l'objet parent de GlideTimelineItem actuel.
{#r_TLI-getParent__table_hmb_2tm_zt__entry__3}

| Nom | Type | Description |
|-|-|-|
| aucun |   |   |
[Tableau 15. Paramètres]

{#r_TLI-getParent__table_hmb_2tm_zt} {#r_TLI-getParent__table_imb_2tm_zt__entry__2}

| Type | Description |
|-|-|
| Chaîne | SysId unique de l'objet parent de GlideTimelineItem actuel. Si le parent n'existe pas, cela renvoie une chaîne vide (\<\< \>\>). |
[Tableau 16. Renvoie]

{#r_TLI-getParent__table_imb_2tm_zt}

## GlideTimelineItem : getTimelineSpans( ) {#ariaid-title10}

Renvoie tous les objets TimelineSpan associés à l'instance actuelle dans une ArrayList.
{#r_TLI-getTimelineSpans__table_jmb_2tm_zt__entry__3}

| Nom | Type | Description |
|-|-|-|
| aucun |   |   |
[Tableau 17. Paramètres]

{#r_TLI-getTimelineSpans__table_jmb_2tm_zt} {#r_TLI-getTimelineSpans__table_kmb_2tm_zt__entry__2}

| Type | Description |
|-|-|
| Tableau d'objets | Liste des objets TimelineSpan associés à l'instance actuelle. |
[Tableau 18. Renvoie]

{#r_TLI-getTimelineSpans__table_kmb_2tm_zt}

## GlideTimelineItem : isTextBold( ) {#ariaid-title11}

Indique si le texte du panneau gauche est défini pour s'afficher à l'aide d'un style gras.
{#r_TLI-isTextBold__table_lmb_2tm_zt__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 19. Paramètres]

{#r_TLI-isTextBold__table_lmb_2tm_zt} {#r_TLI-isTextBold__table_mmb_2tm_zt__entry__2}

| Type | Description |
|-|-|
| Booléen | Marqueur indiquant si le texte doit être en gras. Valeurs possibles : * true : le texte doit être en gras. * false : le texte ne doit pas être en gras. {#r_TLI-isTextBold__ul_nrf_mzd_2sb} |
[Tableau 20. Renvoie]

{#r_TLI-isTextBold__table_mmb_2tm_zt}  
L'exemple suivant vérifie si l'état d'un incident est \<\< Nouveau \>\> et définit le texte de l'élément en gras.

    var NewIncidentTimelineScriptInclude = Class.create();
    NewIncidentTimelineScriptInclude.prototype = Object.extendsObject(AbstractTimelineSchedulePage, {

      getItems: function() {
        // Specify the page title 
        this.setPageTitle('New Incident Timeline');

        var groupNew = new GlideTimelineItem('new');
        groupNew.setLeftLabelText('New Incidents');

        groupNew.setImage('../images/icons/all.gifx');
        this.add(groupNew);

        // Get all the new incidents and add them to a new label 
        var grIncident = new GlideRecord('incident');
        grIncident.query();
        while (grIncident.next()) {
          // Loop through all and capture new incidents 
          if (grIncident.incident_state != '1') continue;

          // Create the item and the span item. 
          var item = new GlideTimelineItem(grIncident.getTableName(), grIncident.sys_id);
          var span = item.createTimelineSpan(grIncident.getTableName(), grIncident.sys_id);

          if (grIncident.incident_state == '1') { // New
            item.setParent(groupNew.getSysId());
            // Check and set bold text
              item.setTextBold(item.isTextBold() ? false : true);
            } 
          item.setImage('../images/icons/open.gifx');
          span.setTimeSpan(grIncident.getElement('opened_at').getGlideObject().getNumericValue(),
          grIncident.getElement('opened_at').getGlideObject().getNumericValue());

          // Show different colors based upon the priorities only for new incidents 
          switch (grIncident.getElement('priority').toString()) {
            case '1':
              span.setPointIconClass('red_circle');
              break;
            case '2':
              span.setPointIconClass('red_square');
              break;
            case '3':
              span.setPointIconClass('blue_circle');
              break;
            case '4':
              span.setPointIconClass('blue_square');
              break;
            case '5':
              span.setPointIconClass('sepia_circle');
              break;

              default: // Otherwise, the default point icon class will be used (Milestone)
          }

          // Common item properties 
          item.setLeftLabelText(grIncident.short_description);

          // Common span properties
          span.setSpanText(grIncident.short_description);
          span.setSpanColor('blue');
          span.setTooltip('<strong>' + GlideStringUtil.escapeHTML(grIncident.short_description) +
            '</strong><br>' + grIncident.number);
          this.add(item);
        }
      }

    });

## GlideTimelineItem : setImage(String strImageName) {#ariaid-title12}

Définit le nom du fichier image (y compris son chemin d'accès) à utiliser comme icône de l'élément dans le volet gauche.
{#r_TLI-setImage_S__table_nmb_2tm_zt__entry__3}

| Nom | Type | Description |
|-|-|-|
| strImageName | Chaîne | Nom de l'image, y compris son chemin. |
[Tableau 21. Paramètres]

{#r_TLI-setImage_S__table_nmb_2tm_zt} {#r_TLI-setImage_S__table_omb_2tm_zt__entry__2}

| Type | Description |
|-|-|
| nul |   |
[Tableau 22. Renvoie]

{#r_TLI-setImage_S__table_omb_2tm_zt}  
L'exemple suivant montre comment utiliser setImage() pour définir l'image qui doit apparaître pour l'icône dans le volet gauche.

    var project_id="741cc7491b6f1c5043de32231b4bcbc5"; // Project ID 
    var grUser = new GlideRecord('user_resource');
    grUser.addQuery('planned_task', project_id);
    grUser.setQueryReferences(true);
    grUser.orderBy('user.name', 'DESC');
    grUser.query();
    while (grUser.next()) {
      var item = new GlideTimelineItem(grUser.getTableName(), grUser.user);
      /* Specify the text to display in the left pane for this item. */
      item.setLeftLabelText(grUser.user.name); 
      /* Set the name of the image file (including it's path) */
      item.setImage('../images/icons/user.gifx'); 
      /* Specify whether or not to bold the text style of the item in the left pane. */
      item.setTextBold(true); 
      /* Set whether or not the current instance object can be clicked and dragged into another GlideTimelineItem */
      item.setIsDraggable(true); 
    }

## GlideTimelineItem : setIsDraggable(Boolean b) {#ariaid-title13}

Définit si l'objet d'instance actuel peut être cliqué et déplacé dans un autre GlideTimelineItem.
{#r_TLI-setIsDraggable_B__table_pmb_2tm_zt__entry__3}

| Nom | Type | Description |
|-|-|-|
| b | Booléen | Marqueur indiquant si l'élément peut être déplacé par cliquer-glisser. Valeurs valides : * vrai : l'élément peut être déplacé par cliquer-glisser. * faux : l'élément ne peut pas être déplacé par cliquer-glisser. {#r_TLI-setIsDraggable_B__ul_h4z_jt1_fsb} |
[Tableau 23. Paramètres]

{#r_TLI-setIsDraggable_B__table_pmb_2tm_zt} {#r_TLI-setIsDraggable_B__table_qmb_2tm_zt__entry__2}

| Type | Description |
|-|-|
| nul |   |
[Tableau 24. Renvoie]

{#r_TLI-setIsDraggable_B__table_qmb_2tm_zt}  
L'exemple suivant montre comment utiliser setIsDraggable() pour permettre de glisser l'objet actuel dans un autre GlideTimelineItem.

    var project_id="741cc7491b6f1c5043de32231b4bcbc5"; // Project ID 
    var grUser = new GlideRecord('user_resource');
    grUser.addQuery('planned_task', project_id);
    grUser.setQueryReferences(true);
    grUser.orderBy('user.name', 'DESC');
    grUser.query();
    while (grUser.next()) {
      var item = new GlideTimelineItem(grUser.getTableName(), grUser.user);
      /* Specify the text to display in the left pane for this item. */
      item.setLeftLabelText(grUser.user.name); 
      /* Set the name of the image file (including it's path) */
      item.setImage('../images/icons/user.gifx'); 
      /* Specify whether or not to bold the text style of the item in the left pane. */
      item.setTextBold(true); 
      /* Set whether or not the current instance object can be clicked and dragged into another GlideTimelineItem */
      item.setIsDraggable(true); 
    }

## GlideTimelineItem : setLeftLabelText(String strText) {#ariaid-title14}

Spécifie le texte à afficher dans le volet gauche pour cet élément.
{#r_TLI-setLeftLabelText_S__table_ibb_lvm_zt__entry__3}

| Nom | Type | Description |
|-|-|-|
| strText | Chaîne | Texte à afficher dans le volet gauche de cet élément. |
[Tableau 25. Paramètres]

{#r_TLI-setLeftLabelText_S__table_ibb_lvm_zt} {#r_TLI-setLeftLabelText_S__table_jbb_lvm_zt__entry__2}

| Type | Description |
|-|-|
| nul |   |
[Tableau 26. Renvoie]

{#r_TLI-setLeftLabelText_S__table_jbb_lvm_zt}  
L'exemple suivant montre comment utiliser setLeftLabelText() pour définir le texte dans le volet gauche.

    var project_id="741cc7491b6f1c5043de32231b4bcbc5"; // Project ID 
    var grUser = new GlideRecord('user_resource');
    grUser.addQuery('planned_task', project_id);
    grUser.setQueryReferences(true);
    grUser.orderBy('user.name', 'DESC');
    grUser.query();
    while (grUser.next()) {
      var item = new GlideTimelineItem(grUser.getTableName(), grUser.user);
      /* Specify the text to display in the left pane for this item. */
      item.setLeftLabelText(grUser.user.name); 
      /* Set the name of the image file (including it's path) */
      item.setImage('../images/icons/user.gifx'); 
      /* Specify whether or not to bold the text style of the item in the left pane. */
      item.setTextBold(true); 
      /* Set whether or not the current instance object can be clicked and dragged into another GlideTimelineItem */
      item.setIsDraggable(true); 
    }

## GlideTimelineItem : setParent(String sysId) {#ariaid-title15}

Définit le parent du GlideTimelineItem actuel.
{#r_TLI-setParent_S__table_kbb_lvm_zt__entry__3}

| Nom | Type | Description |
|-|-|-|
| sysId | Chaîne | SysID du GlideTimelineItem qui doit devenir le parent du GlideTimelineItem actuel. |
[Tableau 27. Paramètres]

{#r_TLI-setParent_S__table_kbb_lvm_zt} {#r_TLI-setParent_S__table_lbb_lvm_zt__entry__2}

| Type | Description |
|-|-|
| nul |   |
[Tableau 28. Renvoie]

{#r_TLI-setParent_S__table_lbb_lvm_zt}

## GlideTimelineItem : setTextBold(Boolean b) {#ariaid-title16}

Indique s'il faut ou non mettre en gras le style de texte de l'élément dans le panneau de gauche.
{#r_TLI-setTextBold_B__table_obb_lvm_zt__entry__3}

| Nom | Type | Description |
|-|-|-|
| b | Booléen | Marqueur indiquant si le texte du panneau de gauche doit être en gras. Valeurs valides : * true : le texte doit être en gras. * false : le texte ne doit pas être en gras. {#r_TLI-setTextBold_B__ul_kn4_1zz_2sb} |
[Tableau 29. Paramètres]

{#r_TLI-setTextBold_B__table_obb_lvm_zt} {#r_TLI-setTextBold_B__table_pbb_lvm_zt__entry__2}

| Type | Description |
|-|-|
| nul |   |
[Tableau 30. Renvoie]

{#r_TLI-setTextBold_B__table_pbb_lvm_zt}  
L'exemple suivant montre comment mettre en gras le texte du panneau de gauche.

    var project_id="741cc7491b6f1c5043de32231b4bcbc5"; // Project ID 
    var grUser = new GlideRecord('user_resource');
    grUser.addQuery('planned_task', project_id);
    grUser.setQueryReferences(true);
    grUser.orderBy('user.name', 'DESC');
    grUser.query();
    while (grUser.next()) {
      var item = new GlideTimelineItem(grUser.getTableName(), grUser.user);
      /* Specify the text to display in the left pane for this item. */
      item.setLeftLabelText(grUser.user.name); 
      /* Set the name of the image file (including it's path) */
      item.setImage('../images/icons/user.gifx'); 
      /* Specify whether or not to bold the text style of the item in the left pane. */
      item.setTextBold(true); 
      /* Set whether or not the current instance object can be clicked and dragged into another GlideTimelineItem */
      item.setIsDraggable(true); 
    }