---
sourceDocument: Yokohama-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# KatalogItemVariableSetM2M -- Umfang

# KatalogItemVariableSetM2M -- Umfang {#ariaid-title1}

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

Fügt den definierten Katalogelementvariablen-Satz M2M ein.
{#r_CatalogItemVariableSetM2M-create_Boolean__table_rrn_wwd_ns__entry__3}

| 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. {#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. Rückgaben]

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

Löscht den definierten Katalogelementvariablen-Satz M2M.
{#r_CatalogItemVariableSetM2M-deleteRecord_Boolean__table_v2c_1xd_ns__entry__3}

| 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. {#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 |
|-|-|
| Ungültig |   |
[Tabelle : 4. Rückgaben]

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

Gibt eine Zuordnung von M2M-Attributwerten des Katalogelementvariablen-Satzes 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 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. {#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 Spaltennamen zu Werten zuordnet. |
[Tabelle : 6. Rückgaben]

{#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 (Objektattribute) {#ariaid-title5}

Definiert Attributwerte für diesen Katalogelementvariablen-Satz M2M.
{#r_CatalogItemVariableSetM2M-setAttributes_Map__table_tyz_qxd_ns__entry__3}

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

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

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 8. Rückgaben]

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

Aktualisiert den aktuellen Variablensatz für Katalogelemente M2M mit festgelegten Werten.
{#r_CatalogItemVariableSetM2M-update_Object_Boolean__table_dj1_cyd_ns__entry__3}

| 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. {#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 |
|-|-|
| Ungültig |   |
[Tabelle : 10. Rückgaben]

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


