CatalogItemVariableSetM2M - com escopo

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 4 min. de leitura
  • A API CatalogItemVariableSetM2M permite criar e modificar o conjunto de variáveis de item do catálogo de serviços muitos para muitos (M2Ms) usando scripts.

    Esta API é executada no namespace sn_sc.

    CatalogItemVariableSetM2M - create(Boolean standardUpdate)

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

    Tabela 1. Parâmetros
    Nome Tipo Descrição
    padrãoAtualizar Booliano Sinalizador que indica se a execução de mecanismos e fluxo de trabalho deve ser habilitada.
    Valores válidos:
    • verdadeiro: habilitar mecanismos e fluxo de trabalho.
    • falso: não habilite mecanismos e fluxo de trabalho.
    Tabela 2. Retorna
    Tipo Descrição
    Cadeia de caracteres Sys_id do registro de variável inserido.

    Este exemplo adiciona o conjunto de variáveis Dúvidas padrão do funcionário ao item do catálogo do iPhone 6s e cria um registro que os vincula 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(Boolean standardUpdate)

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

    Tabela 3. Parâmetros
    Nome Tipo Descrição
    padrãoAtualizar Booliano Sinalizador que indica se a execução de mecanismos e fluxo de trabalho deve ser habilitada.
    Valores válidos:
    • verdadeiro: habilitar mecanismos e fluxo de trabalho.
    • falso: não habilite mecanismos e fluxo de trabalho.
    Tabela 4. Retorna
    Tipo Descrição
    vazio

    Este exemplo remove o conjunto de variáveis Dúvidas padrão do funcionário do item do catálogo do iPhone 6s e exclui o registro que os 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, booliano standardUpdate)

    Retorna um mapeamento dos valores do 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 os quais você deseja os valores.
    padrãoAtualizar Booliano Sinalizador que indica se a execução de mecanismos e fluxo de trabalho deve ser habilitada.
    Valores válidos:
    • verdadeiro: habilitar mecanismos e fluxo de trabalho.
    • falso: não habilite mecanismos e fluxo de trabalho.
    Tabela 6. Retorna
    Tipo Descrição
    Objeto Um objeto que mapeia nomes de coluna 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 do 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 Um objeto que mapeia nomes de coluna para valores.
    Tabela 8. Retorna
    Tipo Descrição
    vazio

    Este exemplo adiciona o conjunto de variáveis Dúvidas 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(objeto columnValues, booliano standardUpdate)

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

    Tabela 9. Parâmetros
    Nome Tipo Descrição
    columnValues Objeto Um objeto que mapeia nomes de coluna para valores.
    padrãoAtualizar Booliano Sinalizador que indica se a execução de mecanismos e fluxo de trabalho deve ser habilitada.
    Valores válidos:
    • verdadeiro: habilitar mecanismos e fluxo de trabalho.
    • falso: não habilite mecanismos e fluxo de trabalho.
    Tabela 10. Retorna
    Tipo Descrição
    vazio

    Este exemplo atualiza a ordem do conjunto de variáveis Dúvidas 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"}