Skriptfähige Servicekatalogvariablen

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 3 Minuten Lesedauer
  • Sie können Skripts verwenden, um auf eine beliebige Anforderungselementvariable aus einer Tabelle im Gültigkeitsbereich und in der non-scoped-Umgebung zu verweisen.

    Nachfolgend sehen Sie ein Beispiel für eine Variablenreferenz.
    current.variables.<variable_name>
    Hierin verweist „current“ auf den aktuellen Datensatz, und <variable_name> ist der Name Ihrer Variablen.
    Hinweis:
    Um aus JavaScript auf eine Variable zu verweisen, muss sie einen Namen haben.

    Wenn eine Variable Teil eines Variablensatzes ist, können Sie sie als current.variables referenzieren.<variable_name> oder current.variables.<variable_set_name> . .

    Variablensatz ist auch ein First Class Citizen im Servicekatalog. Wie Variablen verfügt ein Variablensatz über Lese-, Schreib- und Erstellungsrollen. Wenn Rollen für einen Variablensatz bereitgestellt werden, gelten die Rollen für die Variablen innerhalb des Satzes. Rollen einer einzelnen Variablen werden von den Rollen des Variablensatzes überschrieben.

    Eine Variable drucken

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

    Eine Variable festlegen

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

    Ein Inventarelement mit aus Variablen festgelegten Feldern erstellen

    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(); } }

    GlideElementVariable von Variablen und Variablensätzen abrufen, die einem GlideRecord zugeordnet sind

    now_GR.variables

    Das Name-Wert-Paar von Variablen abrufen, die einem GlideRecord zugeordnet sind

    now_GR.variables.getVariableValue();

    Ruft eine Liste von GlideElementVariablen für Variablen in einem Aufgabendatensatz ab

    now_GR.variables.getElements();

    Ruft eine Liste von GlideElementVariable für Variablen (einschließlich mehrzeiligem Variablensatz) in einem Aufgabendatensatz ab

    now_GR.variables.getElements(true);
    Hinweis:
    Die Methode getElements() gibt alle Variablen zurück, die im angegebenen Aufgabendatensatz vorhanden sind, mit Ausnahme der Formatierervariablen wie Bezeichnung, Bruch, Containerende, Containeraufteilung usw.

    APIs für GlideElementVariable

    • now_GR.Variablen<var_name> .isMultiRow() : Ermittelt, ob die GlideElementVariable ein mehrzeiliger Variablensatz oder eine Variable ist.
    • now_GR.Variablen<var_name> .getQuestion() : Ruft das Frageobjekt für eine Variable ab. Gilt nur für eine Variable (isMultiRow() ist falsch) und nicht für einen mehrzeiligen Variablensatz.
    • now_GR.Variablen<var_name> .getLabel() : Ruft die Bezeichnung der GlideElementVariable ab. Für eine Variable wird die Bezeichnung der Variablen zurückgegeben. Für einen mehrzeiligen Variablensatz wird der Titel des Variablensatzes zurückgegeben.
    • now_GR.Variablen<var_name> .canRead() : Ruft ab, ob der Benutzer eine Variable oder einen mehrzeiligen Variablensatz anzeigen kann.
    • now_GR.Variablen<var_name> .canWrite() : Ruft ab, ob der Benutzer eine Variable oder einen mehrzeiligen Variablensatz bearbeiten kann.
    • now_GR.Variablen<var_name> .getDecryptedValue() : Ruft den entschlüsselten Wert für eine maskierte Variable ab. Gilt nur für eine maskierte Variable.
    • now_GR.Variablen<var_name> .getRows() : Ruft die Liste der Zeilenobjekte für einen mehrzeiligen Variablensatz ab. Gilt nur für einen mehrzeiligen Variablensatz (isMultiRow() ist true).
    • now_GR.Variablen<var_name> .getRowCount() : Ruft die Anzahl der Zeilen für den mehrzeiligen Variablensatz ab. Gilt nur für einen mehrzeiligen Variablensatz (isMultiRow() ist true).

    Beispiel für den Zugriff auf GlideRecord-Variablen für die Aufgabentabelle

    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()) 
        } 
    }

    Beispiel für den Zugriff auf einen mehrzeiligen Variablensatz von GlideRecord für die Aufgabentabelle

    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())
                }
            }
        }
    }

    Mehrzeiliger Variablensatz

    Tabelle : 1. Mehrzeiliger Variablensatz
    Vorgang Verwendung
    Tabellenvorgänge
    JSON-Array-Wert als Zeichenfolge zurückgeben
    now_GR.variables.table_var
    Wert eines mehrzeiligen Variablensatzes festlegen
    now_GR.variables.table_var = <val>
    Hinweis:
    Ein Array von geordneten (Schlüssel-Wert-)Paaren kann ebenfalls als Eingabe verwendet werden.
    Wert der Spalte „var1“ eines mehrzeiligen Variablensatzes abrufen
    now_GR.variables.table_var.var1
    Wert eines Variablensatzes „var1“ festlegen
    now_GR.variables.table_var.var1 = <val>
    Hinweis:
    Ein Array von geordneten (Schlüssel-Wert-)Paaren kann ebenfalls als Eingabe verwendet werden.
    Zeilenvorgänge
    Aktuelle Zeilenanzahl ermitteln
    now_GR.variables.table_var.getRowCount()
    Gibt die durch die Variable „i“ angegebene Zeile zurück – getRow(<int> i)
    var row = now_GR.variables.table_var.getRow(<int> i);
    Zellenwert für eine Fragenspalte abrufen, die <var_name> zugeordnet ist
    row.<var_name>
    Zellenwert für eine Fragenspalte festlegen, die <var_name> zugeordnet ist
    row.setCellValue('<var_name>',value)
    Zellenwert für eine Fragenspalte festlegen, die <var_name> zugeordnet ist
    row.<var_name> = value
    Leere Zeile am Ende der Tabelle hinzufügen und ein skriptfähiges Objekt zurückgeben
    var row = now_GR.variables.table_var.addRow()
    Eine Zeile löschen
    row.deleteRow()

    Hinweise und Einschränkungen

    • //Single column of table_Var
    • now_GR.Variablen.Tabelle_var.var1
    • now_GR.variables.table_var.var1 =<val>
    1. Das Festlegen einer Variablen ist nur in einer Business Rule vom Typ Vor möglich. Variablen, die in einer Regel vom Typ Nach festgelegt werde, werden nicht in die Datenbank geschrieben.
    2. Es gibt keine Möglichkeit, Namespace-Kollisionen mit Variablen zu verhindern. Wenn Sie zwei Variablen namens „computer_speed“ erstellen, wird nur eine davon angezeigt; die zweite Variable überschreibt die erste.
    3. Datums-/Uhrzeitvariablen verwenden dieselben Regeln für Zeitzonenformatierung und -speicherung wie alle anderen Datumsangaben im System. Sie werden intern in GMT gespeichert, jedoch für die Anzeige in die lokale Zeitzone und das Format des Benutzers konvertiert.