---
sourceDocument: Xanadu-API-Referenz
sourceDocumentLink: https://www.servicenow.com/docs/r/de-DE/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - de-DE

ft:publication_title :

    - Xanadu-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# CatalogItemVariableSetM2M: Bereichsbezogen

# CatalogItemVariableSetM2M: Bereichsbezogen {#ariaid-title1}

* Freigeben Version: Xanadu
* 
* Aktualisiert 1. August 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 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) {#ariaid-title2}

Fügt den definierten Katalogelement-Variablensatz M2M ein.
{#r_CatalogItemVariableSetM2M-create_Boolean__table_rrn_wwd_ns__entry__3}

| 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. {#r_CatalogItemVariableSetM2M-create_Boolean__ul_nnx_xwn_kpb} |
[Tabelle : 1. Parameter]

{#r_CatalogItemVariableSetM2M-create_Boolean__table_rrn_wwd_ns} {#r_CatalogItemVariableSetM2M-create_Boolean__table_srn_wwd_ns__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Sys_id des eingefügten Variablendatensatzes. |
[Tabelle : 2. Ergebnisse]

{#r_CatalogItemVariableSetM2M-create_Boolean__table_srn_wwd_ns}  
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) {#ariaid-title3}

Löscht den definierten Katalogelement-Variablensatz M2M.
{#r_CatalogItemVariableSetM2M-deleteRecord_Boolean__table_v2c_1xd_ns__entry__3}

| 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. {#r_CatalogItemVariableSetM2M-deleteRecord_Boolean__ul_nnx_xwn_kpb} |
[Tabelle : 3. Parameter]

{#r_CatalogItemVariableSetM2M-deleteRecord_Boolean__table_v2c_1xd_ns} {#r_CatalogItemVariableSetM2M-deleteRecord_Boolean__table_w2c_1xd_ns__entry__2}

| Typ | Beschreibung |
|-|-|
| void |   |
[Tabelle : 4. Ergebnisse]

{#r_CatalogItemVariableSetM2M-deleteRecord_Boolean__table_w2c_1xd_ns}  
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) {#ariaid-title4}

Gibt eine Zuordnung von M2M-Attributwerten des Katalogelementvariablensatzes zurück.
{#r_CatalogItemVariableSetM2M-read_Object_Boolean__table_uxc_fxd_ns__entry__3}

| 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. {#r_CatalogItemVariableSetM2M-read_Object_Boolean__ul_nnx_xwn_kpb} |
[Tabelle : 5. Parameter]

{#r_CatalogItemVariableSetM2M-read_Object_Boolean__table_uxc_fxd_ns} {#r_CatalogItemVariableSetM2M-read_Object_Boolean__table_vxc_fxd_ns__entry__2}

| Typ | Beschreibung |
|-|-|
| Objekt | Ein Objekt, das Werten Spaltennamen zuordnet. |
[Tabelle : 6. Ergebnisse]

{#r_CatalogItemVariableSetM2M-read_Object_Boolean__table_vxc_fxd_ns}  
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) {#ariaid-title5}

Definiert Attributwerte für diesen Katalogelement-Variablensatz M2M.
{#r_CatalogItemVariableSetM2M-setAttributes_Map__table_tyz_qxd_ns__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| attributes | Objekt | Ein Objekt, das Werten Spaltennamen zuordnet. |
[Tabelle : 7. Parameter]

{#r_CatalogItemVariableSetM2M-setAttributes_Map__table_tyz_qxd_ns} {#r_CatalogItemVariableSetM2M-setAttributes_Map__table_uyz_qxd_ns__entry__2}

| Typ | Beschreibung |
|-|-|
| void |   |
[Tabelle : 8. Ergebnisse]

{#r_CatalogItemVariableSetM2M-setAttributes_Map__table_uyz_qxd_ns}  
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) {#ariaid-title6}

Aktualisiert den aktuellen M2M-Katalogelement-Variablensatz mit festgelegten Werten.
{#r_CatalogItemVariableSetM2M-update_Object_Boolean__table_dj1_cyd_ns__entry__3}

| 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. {#r_CatalogItemVariableSetM2M-update_Object_Boolean__ul_nnx_xwn_kpb} |
[Tabelle : 9. Parameter]

{#r_CatalogItemVariableSetM2M-update_Object_Boolean__table_dj1_cyd_ns} {#r_CatalogItemVariableSetM2M-update_Object_Boolean__table_ej1_cyd_ns__entry__2}

| Typ | Beschreibung |
|-|-|
| void |   |
[Tabelle : 10. Ergebnisse]

{#r_CatalogItemVariableSetM2M-update_Object_Boolean__table_ej1_cyd_ns}  
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"}