CatalogItemVariableSetM2M – Scoped

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 3 Minuten Lesedauer
  • Mit der CatalogItemVariableSetM2M- API können Sie Servicekatalogelement-Variablensätze mit Viele-zu-Viele-Werten (M2M) mithilfe von Skripts erstellen und ändern.

    Diese API wird im Namespace sn_sc ausgeführt.

    CatalogItemVariableSetM2M – create(Boolean standardUpdate)

    Fügt das definierte 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:
    • true: Engines und Workflow aktivieren.
    • false: Engines und Workflow nicht aktivieren.
    Tabelle : 2. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Sys_id des eingefügten Variablendatensatzes.

    In diesem Beispiel wird der Variablensatz Standard-Mitarbeiterfragen dem 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 das definierte 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:
    • true: Engines und Workflow aktivieren.
    • false: Engines und Workflow nicht aktivieren.
    Tabelle : 4. Ergebnisse
    Typ Beschreibung
    void

    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(Object columns, Boolean standardUpdate)

    Gibt eine Zuordnung der M2M-Attributwerte des Katalogelementvariablensatzes zurück.

    Tabelle : 5. Parameter
    Name Typ Beschreibung
    columns Objekt Satz von Spalten, für die Sie die Werte wünschen.
    standardUpdate Boolean Kennzeichnung, die angibt, ob die Ausführung von Engines und Workflows aktiviert werden soll.
    Gültige Werte:
    • true: Engines und Workflow aktivieren.
    • false: Engines und Workflow nicht aktivieren.
    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 dieses 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 dem 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 Katalogelement-Variablensatz M2M 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:
    • true: Engines und Workflow aktivieren.
    • false: Engines und Workflow nicht aktivieren.
    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"}