Variables de catalogue de services pouvant contenir des scripts

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 4 minutes de lecture

    • Vous pouvez utiliser des scripts pour référencer n’importe quelle variable d’élément de demande à partir d’une table dans un environnement inclus et non inclus dans le champ d’application.

    Voici un exemple de référence de variable.
    current.variables.<variable_name>
    Où actuel fait référence à l’enregistrement actuel et <variable_name> est le nom de votre variable.
    Remarque :
    Pour référencer une variable à partir de JavaScript, elle doit avoir un nom.

    Lorsqu’une variable fait partie d’un jeu de variables, vous pouvez le référencer en tant que current.variables.<variable_name> ou current.variables.<variable_set_name>.<variable_name>.

    Le jeu de variables est également un citoyen de première classe dans Service Catalog. Comme les variables, un jeu de variables a des rôles de lecture, d’écriture et de création. Si des rôles sont fournis pour un jeu de variables, les rôles sont applicables pour les variables du jeu. Les rôles d’une variable individuelle sont remplacés par les rôles du jeu de variables.

    Imprimer une variable

    var original = current.variables.original_number;
gs.print(original);

    Définir une variable

    current.variables.name = "Auto-Generated:" + current.variables.asset_tag;

    Créer un élément d’inventaire avec des champs définis à partir de variables

    doCreation(); 

function doCreation ( ) { 
var create = current.variables.create_item; 
if (create == 'true') { // we want to create an asset 
  var computer = new GlideRecord('cmdb_ci_computer');
  computer.initialize();
  computer.asset_tag = current.variables.asset_tag;
  computer.serial_number = current.variables.serial_number;
  computer.name = current.variables.name;
  computer.manufacturer = current.variables.company;
  computer.insert(); } }

    Obtenir GlideElementVariable des variables et des jeux de variables associés à un GlideRecord

    now_GR.variables

    Obtenir la paire nom-valeur des variables associées à un GlideRecord

    now_GR.variables.getVariableValue();

    Obtenir une liste de GlideElementVariable pour les variables dans un enregistrement de tâche

    now_GR.variables.getElements();

    Obtenir une liste de GlideElementVariable pour les variables (y compris le jeu de variables à plusieurs lignes) dans un enregistrement de tâche

    now_GR.variables.getElements(true);
    Remarque :
    La méthode getElements() renvoie toutes les variables présentes sur l’enregistrement de tâche donné, à l’exception des variables du formateur telles que l’étiquette, la rupture, la fin du conteneur, la division du conteneur, etc.

    API pour GlideElementVariable

    • now_GR.variables.<var_name>.isMultiRow() : indique si GlideElementVariable est un jeu de variables de plusieurs lignes ou une variable.
    • now_GR.variables.<var_name>.getQuestion() : obtenir l’objet Question pour une variable. Applicable uniquement pour une variable (isMultiRow() est faux) et non pour un jeu de variables à plusieurs lignes.
    • now_GR.variables.<var_name>.getLabel() : obtenir l’étiquette de GlideElementVariable. Pour une variable, l’étiquette de la variable est renvoyée. Pour les jeux de variables à plusieurs lignes, le titre du jeu de variables est renvoyé.
    • now_GR.variables.<var_name>.canRead() : indique si l’utilisateur peut afficher une variable ou un jeu de variables à plusieurs lignes.
    • now_GR.variables.<var_name>.canWrite() : indique si l’utilisateur peut modifier une variable ou un jeu de variables à plusieurs lignes.
    • now_GR.variables.<var_name>.getDecryptedValue() : obtenir la valeur déchiffrée d’une variable masquée. Applicable uniquement à une variable masquée.
    • now_GR.variables.<var_name>.getRows() : obtenir la liste des objets de ligne pour un jeu de variables de plusieurs lignes. Applicable uniquement pour un jeu de variables à plusieurs lignes (isMultiRow() est vrai).
    • now_GR.variables.<var_name>.getRowCount() : obtenir le nombre de lignes pour le jeu de variables de plusieurs lignes. Applicable uniquement pour un jeu de variables à plusieurs lignes (isMultiRow() est vrai).

    Exemple d’accès aux variables de GlideRecord pour la table de tâches

    var now_GR = new GlideRecord('sc_req_item'); 
if (now_GR.get('635a1f5387320300e0ef0cf888cb0b73')) { 
    var variables = now_GR.variables.getElements(); 
    for (var i=0;i<variables.length;i++) { 
        var question = variables[i].getQuestion(); 
        gs.log(question.getLabel() + ":" + question.getValue()) 
    } 
}

    Exemple d’accès à un jeu de variables de plusieurs lignes de GlideRecord pour la table de tâches

    var now_GR = new GlideRecord('sc_req_item');
now_GR.get('02c38dcd87013300e0ef0cf888cb0bb2');

var vars = now_GR.variables.getElements(true);

for (var i=0; i<vars.length; i++) {
    var now_V = vars[i];
    if (now_V.isMultiRow()) {
        var rows = now_V.getRows();
        for (var j=0; j<now_V.getRowCount(); j++) {
            var row = rows[j];
            var cells = row.getCells();
            for (var k=0; k<cells.length; k++) {
                var cell = cells[k];
                gs.info(cell.getLabel() + ":" + cell.getCellDisplayValue())
            }
        }
    }
}

    Jeu de variables de plusieurs lignes

    Tableau 1. Jeu de variables de plusieurs lignes
    Opération Utilisation
    Opérations de table
    Renvoyer la valeur du tableau JSON en tant que chaîne 
    now_GR.variables.table_var
    Définir la valeur d’un jeu de variables de plusieurs lignes 
    now_GR.variables.table_var = <val>
    Remarque :
    Un tableau de paires ordonnées (clé, valeur) est également applicable comme entrée.
    Obtenir la valeur de la colonne, var1, d’un jeu de variables de plusieurs lignes 
    now_GR.variables.table_var.var1
    Valeur définie d’un jeu de variables, var1 
    now_GR.variables.table_var.var1 = <val>
    Remarque :
    Un tableau de paires ordonnées (clé, valeur) est également applicable comme entrée.
    Opérations de ligne
    Obtenir le nombre de lignes actuel 
    now_GR.variables.table_var.getRowCount()
    Renvoie la ligne spécifiée par la variable « i » : getRow(<int> i) 
    var row = now_GR.variables.table_var.getRow(<int> i);
    Obtenir la valeur de cellule d’une colonne de question mappée à <var_name> 
    row.<var_name>
    Définir la valeur de cellule d’une colonne de question mappée à <var_name> 
    row.setCellValue('<var_name>',value)
    Définir la valeur de cellule d’une colonne de question mappée à <var_name> 
    row.<var_name> = value
    Ajouter une ligne vide à la fin de la table et renvoyer un objet pouvant contenir des scripts 
    var row = now_GR.variables.table_var.addRow()
    Supprimer une ligne 
    row.deleteRow()

    Remarques et limitations

    • Colonne unique de table_Var
    • now_GR.variables.table_var.var1
    • now_GR.variables.table_var.var1 = <val>
    1. Vous pouvez définir une variable uniquement dans une règle métier « before ». Les variables définies dans une règle after ne sont pas écrites dans la base de données.
    2. Rien n’est en place pour empêcher la collision de l’espace de noms avec les variables. La création de deux variables nommées computer_speed entraînerait l’affichage d’une seule d’entre elles ; le second écraserait le premier.
    3. Les variables de date/heure utilisent le même format de fuseau horaire et les mêmes règles de stockage que toutes les autres dates du système. Ils sont stockés en interne dans GMT, mais traduits dans le fuseau horaire local de l’utilisateur et le format d’affichage.