Exemples de remontée pas à pas

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 6 minutes de lecture
  • Accédez aux champs d’une table connexe à partir d’un formulaire, d’une liste ou d’un script en effectuant une remontée pas à pas. Cette rubrique comprend des exemples des différentes façons dont vous pouvez effectuer une remontée pas à pas.

    Champs listes

    Vous pouvez remonter pas à pas vers les champs connexes d’une liste, comme la liste de champs d’un filtre. Cet exemple montre comment filtrer la table Incident [incident] selon la société de l’appelant qui a enregistré l’incident.

    Lorsque vous ouvrez la liste des champs que vous souhaitez filtrer, la liste des champs de table Incidents disponibles s’affiche. Les champs de référence sont suivis par les champs connexes. Par exemple, Appelant est suivi de Appelant > Champs d'utilisateurs, ce qui signifie que l’appelant est un champ de référence et que les champs connexes sont des champs d’utilisateur sur l’enregistrement de l’appelant . Si les champs connexes ne sont pas présents dans la liste, vous devez sélectionner Afficher les champs connexes en bas de la liste.
    Afficher les champs connexes

    Lorsque vous sélectionnez Afficher les champs connexes, le menu se recharge pour afficher les champs connexes.Champs connexes

    Lorsque vous sélectionnez un champ associé, le menu se recharge avec les champs de la table associée.
    Champs de tables connexes

    Lorsque vous sélectionnez Société sous les champs Appelant → Utilisateur, le champ devient alors Appelant.Entreprise.

    L’exemple suivant montre où vous vous trouvez dans la remontée pas à pas. Chaque référence sélectionnée est stockée en haut du menu des champs, et le nombre de points précédant l’étiquette du champ indique le nombre de points de l’enregistrement initial atteint par l’utilisateur.
    Champ de remontée pas à pas

    L’exemple montre que l’utilisateur se trouve dans Incident.Caller.Company. Vous pouvez revenir aux niveaux supérieurs de la hiérarchie en sélectionnant les champs situés en haut du menu. Par exemple, la sélection des champs d’incident revient à la liste des champs d’incident.

    Les champs connexes peuvent être supprimés en sélectionnant Supprimer les champs connexes en bas de la liste.
    Supprimer les champs connexes

    Créateurs de condition

    Vous pouvez effectuer une requête détaillée sur une table en effectuant une remontée pas à pas dans le créateur de condition.

    Pour remonter pas à pas dans un créateur de condition, sélectionnez d’abord Afficher les champs connexes dans le menu des champs. Cette action vous permet d’ajouter des champs de tables connexes à votre requête.

    Le GIF suivant montre comment effectuer une remontée pas à pas des champs dans un créateur de condition pour trouver tous les enregistrements d’incidents affectés à un utilisateur spécifique, Beth Anglin. Dans l’exemple, l’utilisateur accède à Incident > Ouvert , puis ouvre le créateur de condition. Dans le menu des champs, l’utilisateur sélectionne d’abord Afficher les champs connexes , puis ouvre à nouveau le menu des champs pour sélectionner Affecté à → champs de l’utilisateur. L’utilisateur ouvre à nouveau le menu des champs pour sélectionner Nom de famille. L’utilisateur crée la condition suivante : [Nom] [est] [Anglin]. Une fois que l’utilisateur a sélectionné Exécuter, la liste Incident affiche uniquement les enregistrements affectés à Beth Anglin.


    Le GIF montre comment effectuer une remontée pas à pas dans un créateur de condition

    Collecteurs de listes

    Remarque :
    L’ajout de nouveaux champs via une remontée pas à pas en remplissant la section Créer un nouveau champ (« A » dans l’exemple) dans le champ Nom (« B » dans l’exemple) n’est pas pris en charge. L’ajout de champs non autorisés et l’ajout de champs par rapport aux recommandations via une remontée pas à pas peut entraîner des comportements inattendus dans la plateforme. Remontée pas à pas non autorisée à partir de Créer une section de champ
    Lorsque vous sélectionnez une liste de champs à partir d’un collecteur de liste (par exemple, lorsque vous configurez un formulaire), vous pouvez remonter pas à pas vers les champs d’autres formulaires.
    Pour savoir quels champs sont des champs de référence et peuvent faire l’objet d’une remontée pas à pas, recherchez les champs verts avec un symbole plus.
    Champs de référence
    Une fois qu’un champ de référence est mis en surbrillance, l’icône de développement ( icône de développement) apparaît au-dessus de l’icône d’ajout.
    Champs de référence avec l’option de développement
    La sélection de l’icône de développement ouvre la liste des champs de la liste connexe dans le volet Disponible . L’exemple suivant montre que les champs Affecté à ont été sélectionnés. Les listes de champs précédentes apparaissent en haut de la liste.
    Listes de champs
    Une fois le champ ajouté au volet Sélectionné , il apparaît avec sa syntaxe complète de remontée pas à pas. L’exemple suivant montre que Affecté à. Actif a été sélectionné.
    Champ de remontée pas à pas

    Scripts

    Vous pouvez remonter pas à pas au sein d’un script en invoquant la syntaxe de remontée pas à pas. Cette fonctionnalité nécessite une connaissance de JavaScript.

    Pour les scripts qui s’exécutent côté serveur, tels que les règles métier, il est nécessaire d’ajouter la valeur actuelle.

    Le script suivant, par exemple, est une règle d’approbation scriptée qui demande une approbation du gestionnaire de l’utilisateur qui a ouvert le ticket.
    try{
      current.opened_by.manager;
    }
    catch(err){}
    Pour les scripts qui s’exécutent côté client, tels que les scripts clients, la valeur actuelle n’est pas nécessaire. Par exemple, le script Highlight VIP Caller suivant s’exécute côté client.
    function onChange(control, oldValue, newValue, isLoading){
      //wait until there is a valid record in the field
      if(newValue){ 
        //get the caller object so we can access fields
        var caller = g_form. getReference('caller_id');
        var callerLabel = document.getElementById('label.incident.caller_id');
        var callerField = document.getElementById('sys_display.incident.caller_id');
     
      //check for VIP status
      if(caller.vip == 'true') { 
        //change the caller label to red background
        //style object is CSSStyleDeclaration, style names are not standard css names
      if(callerLabel) 
        document.getElementById('label.incident.caller_id').style.backgroundColor = 'red';
     
      //change the caller's name field to red text
      if(callerField)
         document.getElementById('sys_display.incident.caller_id').style.color = 'red';
      } 
        else { //not a VIP, remove temporary styles if(callerLabel)
         document.getElementById('label.incident.caller_id').style.backgroundColor = '';
    
        if(callerField)
          document.getElementById('sys_display.incident.caller_id').style.color = '';
        }
      }
    }

    Variables

    Souvent, vous pouvez ajouter des variables dans les modèles, les notifications ou d’autres formulaires où une valeur est appelée à partir du formulaire.

    Par exemple, ${assigned_to} est la variable du champ Affecté à .

    Comme illustré dans l’exemple, vous pouvez remonter pas à pas jusqu’aux champs de l’enregistrement d’origine de n’importe quel champ de référence. Il est possible de remonter pas à pas vers n’importe quel champ de l’enregistrement assigned_to, par exemple, ${assigned_to.manager}.

    Lorsque vous remontez pas à pas, vous pouvez avoir une chaîne plus longue si vous en avez besoin, comme dans cet exemple : ${assigned_to.department.manager.mobile_phone}.

    Parfois, vous pouvez sélectionner cette variable à partir d’un arborescence.

    Cueilleurs d’arbres

    L’interface de l’arborescence dispose d’une vue hiérarchique extensible que vous pouvez utiliser pour rechercher les éléments suivants :
    • Éléments de configuration (CI) qui sont subordonnés à un autre CI de niveau supérieur.
    • Membres d’un certain groupe. Par exemple, vous pouvez utiliser une arborescence pour rechercher un utilisateur dans le groupe Service Desk.
    • Éléments de référence pour n’importe quelle table hiérarchique. Une table hiérarchique est une table qui a un champ parent pointant vers elle-même. La table Groupe [sys_user_group], par exemple, est considérée comme une table hiérarchique, car certains groupes sont des enfants de groupes parents.

    L’exemple suivant montre comment utiliser un sélecteur d’arborescence pour affecter un enregistrement d’incident à un utilisateur du groupe Base de données.

    Vous devez d’abord accéder à n’importe quel enregistrement d’incident, puis entrer Base de données dans le champ Groupe d’affectation .


    Champ Liste

    Dans cet exemple, le groupe Base de données est un groupe parent auquel se trouvent plusieurs groupes enfants. Lorsque vous sélectionnez l’icône de recherche ( icône de recherche. ) en regard du champ Affecté à , une fenêtre affiche les champs de référence dans le groupe Base de données.


    Sélectionner des champs

    L’icône de développement (+) des champs de référence se trouve en regard de leur nom. En cliquant sur le signe + , la liste des champs du champ référencé s’affiche. Dans cet exemple, le développement des champs Base de données Atlanta ou Base de données San Diego ouvre une liste d’enregistrements utilisateur au sein de chaque groupe enfant.


    Sélectionner les champs référencés

    Vous devez sélectionner l’un des enregistrements utilisateur pour l’ajouter en tant que valeur dans le champ Affecté à .


    Variable de remontée pas à pas
    Remarque :
    Vous pouvez configurer l’arborescence de façon à sélectionner jusqu’à 1 000 nœuds lorsque vous configurez la glide.ui.group_heirarchy.max_nodes propriété. Pour définir la propriété, ouvrez les attributs de dictionnaire pour le champ et ajoutez tree_picker=true dans le champ Attributs . S’il existe plusieurs attributs, utilisez une virgule pour les séparer sans aucun espace entre eux.