CatalogItemVariableSetM2M: Bereichsbezogen

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 2024
  • 3 Minuten Lesedauer
  • Die CatalogItemVariableSetM2M- API stellt Methoden bereit, mit denen Sie m:n-Variablensätze für Servicekatalogelemente mithilfe von Skripts erstellen und ändern können.

    Diese API wird im Namespace sn_sc ausgeführt.

    CatalogItemVariableSetM2M – create(Boolean standardUpdate)

    Fügt den definierten Katalogelement-Variablensatz M2M ein.

    Tabelle : 1. Parameter
    Name Typ Beschreibung
    standardUpdate Boolean Kennzeichnung, die angibt, ob die Ausführung von Engines und Workflows aktiviert werden soll.
    Gültige Werte:
    • „wahr“: Engines und Workflows aktivieren.
    • „falsch“: Engines und Workflow nicht aktiviert.
    Tabelle : 2. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Sys_id des eingefügten Variablendatensatzes.

    In diesem Beispiel wird der Variablensatz „Standardfragen für Mitarbeiter“ zum iPhone 6s-Katalogelement hinzugefügt und ein Datensatz erstellt, der sie in der Tabelle „Katalogvariablensätze“ [io_set_item] verknüpft.

    var cat_item_sys_id = 'bd6fa75a4f334200086eeed18110c79e'; // catalog item - iPhone 6s
    var variable_set_sys_id = 'e01cab1a4f334200086eeed18110c71f'; // variable set - Standard Employee Questions
    var app_scope = 'global'; // sys_id id in case of scoped app
    var varset = new sn_sc.CatalogItemVariableSetM2M();
    var attr = {
        'variable_set': variable_set_sys_id, // required
        'sc_cat_item': cat_item_sys_id, // required
        'sys_scope': app_scope, // optional
        'order': 10 // optional
    };
    varset.setAttributes(attr);
    var m2mRec = varset.create(true);
    gs.info('Variable set added to catalog item and M2M record created in table io_set_item with sys_id ' + m2mRec);

    Ausgabe:

    Variable set added to catalog item and M2M record created in table io_set_item with sys_id c5c87af187eb30103a730f2d0ebb3578

    CatalogItemVariableSetM2M – deleteRecord(Boolean standardUpdate)

    Löscht den definierten Katalogelement-Variablensatz M2M.

    Tabelle : 3. Parameter
    Name Typ Beschreibung
    standardUpdate Boolean Kennzeichnung, die angibt, ob die Ausführung von Engines und Workflows aktiviert werden soll.
    Gültige Werte:
    • „wahr“: Engines und Workflows aktivieren.
    • „falsch“: Engines und Workflow nicht aktiviert.
    Tabelle : 4. Ergebnisse
    Typ Beschreibung
    void

    In diesem Beispiel wird der Variablensatz „Standardfragen für Mitarbeiter“ aus dem iPhone 6s-Katalogelement entfernt und der Datensatz gelöscht, der sie in der Tabelle „Katalogvariablensätze“ [io_set_item] verknüpft.

    var vset = new GlideRecord('io_set_item');
    vset.addQuery('sc_cat_item', 'bd6fa75a4f334200086eeed18110c79e'); // catalog item - iPhone 6s
    vset.addQuery('variable_set', 'e01cab1a4f334200086eeed18110c71f'); // variable set - Standard Employee Questions
    vset.query();
    if (vset.next()) {
        var varset = new sn_sc.CatalogItemVariableSetM2M(vset.getUniqueValue()); // pass sys_id of io_set_item record
        varset.deleteRecord(true);  
    }

    CatalogItemVariableSetM2M – read(Object columns, Boolean standardUpdate)

    Gibt eine Zuordnung von M2M-Attributwerten des Katalogelementvariablensatzes zurück.

    Tabelle : 5. Parameter
    Name Typ Beschreibung
    columns Objekt Satz von Spalten, für die Sie die Werte erhalten möchten.
    standardUpdate Boolean Kennzeichnung, die angibt, ob die Ausführung von Engines und Workflows aktiviert werden soll.
    Gültige Werte:
    • „wahr“: Engines und Workflows aktivieren.
    • „falsch“: Engines und Workflow nicht aktiviert.
    Tabelle : 6. Ergebnisse
    Typ Beschreibung
    Objekt Ein Objekt, das Werten Spaltennamen zuordnet.

    In diesem Beispiel werden alle Variablensätze gelesen, die vom iPhone 6s-Katalogelement verwendet werden.

    var vset = new GlideRecord('io_set_item');
    vset.addQuery('sc_cat_item', 'bd6fa75a4f334200086eeed18110c79e'); // catalog item - iPhone 6s
    vset.query();
    while (vset.next()) {
        var varset = new sn_sc.CatalogItemVariableSetM2M(vset.getUniqueValue()); // pass sys_id of io_set_item record
        //add the fields you want to read from the record
        var attr = {
            'sys_name': '', // optional
            'sys_scope': '', // optional
            'order': '' // optional
        };
        var m2mRec = varset.read(attr, true);
        gs.info(JSON.stringify(m2mRec));
    }

    Ausgabe:

    {"sys_name":"HTML Description.iPhone 6s","sys_scope":"global","order":"10"}
    {"sys_name":"Standard Employee Questions.iPhone 6s","sys_scope":"global","order":"20"}
    

    CatalogItemVariableSetM2M – setAttributes(Object attributes)

    Definiert Attributwerte für diesen Katalogelement-Variablensatz M2M.

    Tabelle : 7. Parameter
    Name Typ Beschreibung
    attributes Objekt Ein Objekt, das Werten Spaltennamen zuordnet.
    Tabelle : 8. Ergebnisse
    Typ Beschreibung
    void

    In diesem Beispiel wird der Variablensatz „Standard-Mitarbeiterfragen“ zum iPhone 6s-Katalogelement hinzugefügt und ein Datensatz in der Tabelle „Katalogvariablensätze“ [io_set_item] erstellt.

    var cat_item_sys_id = 'bd6fa75a4f334200086eeed18110c79e'; // catalog item - iPhone 6s
    var variable_set_sys_id = 'e01cab1a4f334200086eeed18110c71f'; // variable set - Standard Employee Questions
    var app_scope = 'global'; // sys_id id in case of scoped app
    var varset = new sn_sc.CatalogItemVariableSetM2M();
    var attr = {
        'variable_set': variable_set_sys_id,
        'sc_cat_item': cat_item_sys_id,
        'sys_scope': app_scope,
        'order': 10
    };
    varset.setAttributes(attr);
    var m2mRec = varset.create(true);
    gs.info('Variable set added to catalog item and M2M record created in table io_set_item with sys_id ' + m2mRec);

    Ausgabe:

    Variable set added to catalog item and M2M record created in table io_set_item with sys_id c5c87af187eb30103a730f2d0ebb3578

    CatalogItemVariableSetM2M – update(Object columnValues, Boolean standardUpdate)

    Aktualisiert den aktuellen M2M-Katalogelement-Variablensatz mit festgelegten Werten.

    Tabelle : 9. Parameter
    Name Typ Beschreibung
    columnValues Objekt Ein Objekt, das Werten Spaltennamen zuordnet.
    standardUpdate Boolean Kennzeichnung, die angibt, ob die Ausführung von Engines und Workflows aktiviert werden soll.
    Gültige Werte:
    • „wahr“: Engines und Workflows aktivieren.
    • „falsch“: Engines und Workflow nicht aktiviert.
    Tabelle : 10. Ergebnisse
    Typ Beschreibung
    void

    In diesem Beispiel wird die Reihenfolge des Variablensatzes „Standard-Mitarbeiterfragen“ für das iPhone 6s-Katalogelement aktualisiert.

    var vset = new GlideRecord('io_set_item');
    vset.addQuery('sc_cat_item', 'bd6fa75a4f334200086eeed18110c79e'); // catalog item - iPhone 6s
    vset.addQuery('variable_set', 'e01cab1a4f334200086eeed18110c71f'); // variable set - Standard Employee Questions
    vset.query();
    if (vset.next()) {
        var varset = new sn_sc.CatalogItemVariableSetM2M(vset.getUniqueValue()); // pass sys_id of io_set_item record
        var attr = {
            'order': '30' // update order to 30
        };
        varset.update(attr, true);
        var readAttr = {
            'sys_name': '',
            'order': '' 
        };
        var m2mRec = varset.read(readAttr, true); // read the record to confirm the update 
        gs.info(JSON.stringify(m2mRec));
    }

    Ausgabe:

    {"sys_name":"Standard Employee Questions.iPhone 6s","order":"30"}