Exemples de remontée pas à pas
Accéder aux champs d’une table connexe à partir d’un formulaire, d’une liste ou d’un script par remontée pas à pas. Cette rubrique comprend des exemples des différentes façons de remonter pas à pas.
Champs listes
Vous pouvez remonter pas à pas vers les champs connexes d’une liste, tels que la liste des champs dans un filtre. Cet exemple montre comment filtrer la table Incident [incident] en fonction de la société de l’appelant qui a enregistré l’incident.
Lorsque vous sélectionnez Entreprise dans les champs Appelant → Utilisateur, le champ devient Appelant.Entreprise.
L’exemple montre que l’utilisateur se trouve sur Incident.Appelant.Société. Vous pouvez revenir à des 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 renvoie à la liste des champs d’incident.
Générateurs de conditions
Vous pouvez effectuer une requête détaillée sur une table en remontée pas à pas dans le générateur de conditions.
Pour effectuer une remontée pas à pas dans un générateur de conditions, sélectionnez d’abord Afficher les champs connexes dans le menu des champs. Cette action vous permet d’ajouter des champs des tables connexes à votre requête.
Le GIF suivant montre comment vous pouvez remonter pas à pas les champs d’un générateur de conditions pour trouver tous les enregistrements d’incident affectés à un utilisateur spécifique, Beth Anglin. Dans l’exemple, l’utilisateur accède à , puis ouvre le générateur de conditions. 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 les champs Affecté à → Utilisateur. L’utilisateur ouvre à nouveau le menu des champs pour sélectionner Nom de famille. L’utilisateur génère la condition suivante : [Nom de famille] [est] [Anglin]. Une fois que l’utilisateur a sélectionné Exécuter, la liste Incident affiche uniquement les enregistrements affectés à Beth Anglin.
Collecteurs de listes
Scripts
Vous pouvez effectuer une remontée 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.
try{
current.opened_by.manager;
}
catch(err){}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 des modèles, des notifications ou d’autres formulaires où une valeur est appelée à partir du formulaire.
Par exemple, ${assigned_to} est la variable pour le champ Affecté à .
Comme indiqué dans l’exemple, vous pouvez remonter pas à pas vers les 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 effectuez une remontée 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’une arborescence.
Arborescences
- Éléments de configuration (CI) subordonnés à un autre CI de niveau supérieur.
- Membres d’un certain groupe. Par exemple, vous utiliseriez un arborescence pour rechercher un utilisateur dans le groupe Centre de services.
- Éléments de référence pour toute table hiérarchique. Une table hiérarchique est une table dont un champ parent pointe vers lui-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 arborescence pour affecter un enregistrement d’incident à un utilisateur du groupe Base de données.
Vous navigueriez d’abord vers n’importe quel enregistrement d’incident, puis saisiriez Base de données dans le champ Groupe d’affectation .
Dans cet exemple, le groupe Base de données est un groupe parent sous lequel se rapportent plusieurs groupes enfants. Lorsque vous sélectionnez l’icône de recherche ( ) en regard du champ Affecté à , une fenêtre affiche les champs de référence du groupe Base de données.
Les champs de référence ont l’icône de développement (+) en regard de leur nom. Cliquez sur le bouton + pour développer une liste des champs sur ce champ référencé. 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.
Vous pouvez sélectionner l’un des enregistrements d’utilisateur pour l’ajouter en tant que valeur dans le champ Affecté à .