CatalogItemVariableSetM2M - com escopo

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 4 min. de leitura
  • A API CatalogItemVariableSetM2M fornece métodos que permitem 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(Booliano 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 fluxos 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 Perguntas 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(Booliano StandardUpdate)

    Exclui o conjunto de variáveis do 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 fluxos 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 Perguntas 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 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 os quais você deseja os valores.
    padrãoAtualizar Booliano Sinalizador que indica se a execução de mecanismos e fluxos 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 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. Retorna
    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 (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 Uma coluna de mapeamento de objeto nomeia para valores.
    padrãoAtualizar Booliano Sinalizador que indica se a execução de mecanismos e fluxos 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 Perguntas padrão de funcionários 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"}