KatalogItemVariableSetM2M – Umfang

  • Freigeben Version: Australia
  • Aktualisiert 12. März 2026
  • 3 Minuten Lesedauer
  • Die KatalogItemVariableSetM2M Die API bietet Methoden, mit denen Sie Servicekatalog-Variablensatz „viele-zu-viele“ (M2M) mithilfe von Skripts erstellen und ändern können.

    Diese API wird in ausgeführt sn_sc Namespace.

    CatalogItemVariableSetM2M – create(boolescher Standard – Update)

    Fügt den definierten Katalogelementvariablen-Satz M2M ein.

    Tabelle : 1. Parameter
    Name Typ Beschreibung
    Standardaktualisierung Boolean Kennzeichnung, die angibt, ob die Ausführung von Engines und Workflows aktiviert werden soll.
    Gültige Werte:
    • Wahr: Engines und Workflow aktivieren.
    • Falsch: Engines und Workflow nicht aktivieren.
    Tabelle : 2. Rückgaben
    Typ Beschreibung
    Zeichenfolge SYS_ID des eingefügten Variablendatensatzes.

    Dieses Beispiel fügt dem iPhone 6s-Katalogelement den Variablensatz „Standard-Mitarbeiterfragen“ hinzu und erstellt einen Datensatz, 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(boolescher Standard Update)

    Löscht den definierten Katalogelementvariablen-Satz M2M.

    Tabelle : 3. Parameter
    Name Typ Beschreibung
    Standardaktualisierung Boolean Kennzeichnung, die angibt, ob die Ausführung von Engines und Workflows aktiviert werden soll.
    Gültige Werte:
    • Wahr: Engines und Workflow aktivieren.
    • Falsch: Engines und Workflow nicht aktivieren.
    Tabelle : 4. Rückgaben
    Typ Beschreibung
    Ungültig

    In diesem Beispiel wird der Variablensatz „Standard-Mitarbeiterfragen“ 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(Objektspalten, boolescher Standardupdate)

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

    Tabelle : 5. Parameter
    Name Typ Beschreibung
    columns Objekt Satz von Spalten, für die Sie die Werte wünschen.
    Standardaktualisierung Boolean Kennzeichnung, die angibt, ob die Ausführung von Engines und Workflows aktiviert werden soll.
    Gültige Werte:
    • Wahr: Engines und Workflow aktivieren.
    • Falsch: Engines und Workflow nicht aktivieren.
    Tabelle : 6. Rückgaben
    Typ Beschreibung
    Objekt Ein Objekt, das Spaltennamen zu Werten 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 (Objektattribute)

    Definiert Attributwerte für diesen Katalogelementvariablen-Satz M2M.

    Tabelle : 7. Parameter
    Name Typ Beschreibung
    attributes Objekt Ein Objekt, das Spaltennamen zu Werten zuordnet.
    Tabelle : 8. Rückgaben
    Typ Beschreibung
    Ungültig

    Dieses Beispiel fügt dem iPhone 6s-Katalogelement den Variablensatz „Standard-Mitarbeiterfragen“ hinzu und erstellt einen Datensatz in der Tabelle „Katalogvariablensätze“ [io_Set_item].

    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, boolescher Standard Update)

    Aktualisiert den aktuellen Variablensatz für Katalogelemente M2M mit festgelegten Werten.

    Tabelle : 9. Parameter
    Name Typ Beschreibung
    ColumnValues Objekt Ein Objekt, das Spaltennamen zu Werten zuordnet.
    Standardaktualisierung Boolean Kennzeichnung, die angibt, ob die Ausführung von Engines und Workflows aktiviert werden soll.
    Gültige Werte:
    • Wahr: Engines und Workflow aktivieren.
    • Falsch: Engines und Workflow nicht aktivieren.
    Tabelle : 10. Rückgaben
    Typ Beschreibung
    Ungültig

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

    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"}