ItemVariableSetM2M - Com escopo

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 4 min. de leitura
  • . ItemVariableSetM2M A API fornece métodos que permitem criar e modificar M2Ms (Muitos para Muitos) do conjunto de variáveis do item do catálogo de serviços usando scripts.

    Esta API é executada no sn_sc namespace.

    CatalogItemVariableSetM2M - Criar(boolian standardUpdate)

    Insere o conjunto de variáveis do item do catálogo definido M2M.

    Tabela 1. Parâmetros
    Nome Tipo Descrição
    PadrãoAtualização Booliano Sinalizador que indica se a execução de mecanismos e fluxo de trabalho deve ser habilitada.
    Valores válidos:
    • Verdadeiro: Habilite mecanismos e fluxo de trabalho.
    • Falso: Não habilite mecanismos e fluxo de trabalho.
    Tabela 2. Retornos
    Tipo Descrição
    Cadeia de caracteres Sys_id do registro de variável inserido.

    Este exemplo adiciona o conjunto de variáveis Perguntas padrão do funcionário ao item do catálogo do iPhone 6s e cria um registro vinculando-as na tabela Conjuntos de variáveis do catálogo [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, // 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);

    Saída:

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

    CatalogItemVariableSetM2M - deleteRecord(boolian standardUpdate)

    Exclui o conjunto de variáveis do item do catálogo definido M2M.

    Tabela 3. Parâmetros
    Nome Tipo Descrição
    PadrãoAtualização Booliano Sinalizador que indica se a execução de mecanismos e fluxo de trabalho deve ser habilitada.
    Valores válidos:
    • Verdadeiro: Habilite mecanismos e fluxo de trabalho.
    • Falso: Não habilite mecanismos e fluxo de trabalho.
    Tabela 4. Retornos
    Tipo Descrição
    vazio

    Este exemplo remove o conjunto de variáveis Perguntas padrão do funcionário do item do catálogo do iPhone 6s e exclui o registro que as vincula na tabela Conjuntos de variáveis do catálogo [io_set_item].

    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(colunas de objeto, boolian standardUpdate)

    Retorna um mapeamento de valores de atributo M2M do conjunto de variáveis do item do catálogo.

    Tabela 5. Parâmetros
    Nome Tipo Descrição
    colunas Objeto Conjunto de colunas para as quais você deseja os valores.
    PadrãoAtualização Booliano Sinalizador que indica se a execução de mecanismos e fluxo de trabalho deve ser habilitada.
    Valores válidos:
    • Verdadeiro: Habilite mecanismos e fluxo de trabalho.
    • Falso: Não habilite mecanismos e fluxo de trabalho.
    Tabela 6. Retornos
    Tipo Descrição
    Objeto Uma coluna de mapeamento de objeto nomeia para valores.

    Este exemplo lê todos os conjuntos de variáveis usados pelo item do catálogo do iPhone 6s.

    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));
    }

    Saída:

    {"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(atributos de objeto)

    Define valores de atributo para este conjunto de variáveis de item do catálogo M2M.

    Tabela 7. Parâmetros
    Nome Tipo Descrição
    atributos Objeto Uma coluna de mapeamento de objeto nomeia para valores.
    Tabela 8. Retornos
    Tipo Descrição
    vazio

    Este exemplo adiciona o conjunto de variáveis Perguntas padrão do funcionário ao item do catálogo do iPhone 6s e cria um registro na tabela Conjuntos de variáveis do catálogo [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);

    Saída:

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

    CatalogItemVariableSetM2M - update(Object columnValues, boolian standardUpdate)

    Atualiza M2M do conjunto de variáveis do item do catálogo atual com valores definidos.

    Tabela 9. Parâmetros
    Nome Tipo Descrição
    ColumnValues Objeto Uma coluna de mapeamento de objeto nomeia para valores.
    PadrãoAtualização Booliano Sinalizador que indica se a execução de mecanismos e fluxo de trabalho deve ser habilitada.
    Valores válidos:
    • Verdadeiro: Habilite mecanismos e fluxo de trabalho.
    • Falso: Não habilite mecanismos e fluxo de trabalho.
    Tabela 10. Retornos
    Tipo Descrição
    vazio

    Este exemplo atualiza a ordem do conjunto de variáveis Perguntas padrão do funcionário para o item do catálogo do iPhone 6s.

    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));
    }

    Saída:

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