CatCategory - Com escopo

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 4 min. de leitura

    • . CatCategory A API fornece métodos que permitem criar e modificar categorias do catálogo de serviços usando scripts.

    Esta API é executada no sn_sc namespace.

    Importante:
    Esta API está acessível; no entanto, a implementação recomendada é REST API do Catálogo de serviços .

    CatCategory - availableForUserCriteria(ação de cadeia de caracteres, IDs de critérios de matriz)

    Adiciona o. Available Forcritérios do usuário para a categoria do catálogo atual.

    Tabela 1. Parâmetros
    Nome Tipo Descrição
    ação Cadeia de caracteres Ação a ser executada.
    • adicionar Adiciona os critérios do usuário ao Disponível para lista.
    • excluir Exclui os critérios do usuário do Disponível para lista.
    CritériaIDs Matriz Matriz dos sys_ids de critérios do usuário.
    Tabela 2. Retornos
    Tipo Descrição
    vazio 
    var item = new sn_sc.CatCategory("31bea3d53790200044e0bfc8bcbe5dec");
item.availableForUserCriteria("add", ["0c441abbc6112275000025157c651c89"]);

    CatCategory - canView (isMobile booliano, cadeia de caracteres userSysId)

    Determina se um usuário especificado pode exibir uma categoria especificada em um dispositivo móvel ou desktop.

    Tabela 3. Parâmetros
    Nome Tipo Descrição
    isMobile Booliano Sinalizador que indica se o usuário deve verificar o acesso em um dispositivo móvel ou desktop.
    • Verdadeiro: Validar para celular.
    • Falso: Validar para desktop.
    userSysId Cadeia de caracteres Sys_id do usuário a ser validado.
    Tabela 4. Retornos
    Tipo Descrição
    Booliano Sinalizador que indica se o usuário pode exibir a categoria associada.
    • Verdadeiro: O usuário pode exibir a categoria.
    • Falso: O usuário não pode exibir a categoria.
    		 
    var scopedCategoryObj = new sn_sc.CatCategory('7b1262b9530033007444ddeeff7b12ae');
scopedCategoryObj.canView(false, '62826bf03710200044e0bfc8bcbe5df1');

    CatCategory - Criar (boolian standardUpdate)

    Insira a categoria definida.

    Tabela 5. 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 6. Retornos
    Tipo Descrição
    Cadeia de caracteres Sys_id do registro de variável inserido. 
    var categoryCreate = new sn_sc.CatCategory();
categoryCreate.setAttributes({"title" : "test a scoped category", "sc_catalog" : "e0d08b13c3330100c8b837659bba8fb4"});
var categorySysId = categoryCreate.create();
var isValidSysId = categorySysId.match(/^[0-9a-fA-F]{32}$/) == null ? false : true;
global.Assert.assertEquals(true, isValidSysId,"CategorySysId: ["+ categorySysId +"] is not valid", true, isValidSysId);

    CatCategory - deleteRecord (boolian standardUpdate)

    Exclui o registro de categoria no qual a classe CatCategory foi instanciada inicialmente.

    Tabela 7. 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 8. Retornos
    Tipo Descrição
    vazio 
    var categoryDelete = new sn_sc.CatCategory(categorySysId);
categoryDelete.deleteRecord();
var category = new sn_sc.CatCategory(categorySysId);
values = category.read({"title" : "", "sc_catalog":""}, false);
global.Assert.assertEquals("", values.title,"Category should title");

    CatCategory - getID()

    Retorna o sys_id da categoria atual.

    Tabela 9. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 10. Retorna
    Tipo Descrição
    Cadeia de caracteres Sys_id da categoria atual.

    Exemplo:

    var cart = new sn_sc.CatCategory("2809952237b1300054b6a3549dbe5dd4");
var categoryID = cart.getID();
gs.info(categoryID);

    Saída:

    2809952237b1300054b6a3549dbe5dd4

    CatCategory - notAvailableForUserCriteria(Ação de cadeia de caracteres, Array[] critérios)

    Adiciona o. Not Available Forcritérios do usuário para uma categoria do catálogo.

    Tabela 11. Parâmetros
    Nome Tipo Descrição
    ação Cadeia de caracteres Ação a ser executada.
    • adicionar Adiciona os critérios do usuário ao Não disponível para lista.
    • excluir Exclui os critérios do usuário do Não disponível para lista.
    Tabela 12. Retornos
    Tipo Descrição
    vazio 
    var item = new sn_sc.CatCategory("31bea3d53790200044e0bfc8bcbe5dec");
item. notAvailableForUserCriteria("add", ["0c441abbc6112275000025157c651c89"]);

    CatCategory - read (colunas de objeto, booliano padrão)

    Retorna um mapeamento da categoria.

    Tabela 13. 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 14. Retornos
    Tipo Descrição
    Objeto Mapeamento de nomes de coluna para valores. 
    var category = new sn_sc.CatCategory("a96277509f300200b407b89a442e704e");
var values = category.read({"title" : ""}, true);
gs.log(values.title);

    CatCategory - setAttributes(atributos de objeto)

    Define os valores de atributo para esta categoria.

    Tabela 15. Parâmetros
    Nome Tipo Descrição
    atributos Objeto Atributos para os novos pares de campo e valor.
    Tabela 16. Retornos
    Tipo Descrição
    vazio 
    var categoryCreate = new sn_sc.CatCategory();
categoryCreate.setAttributes({"title" : "test a scoped category", "sc_catalog" : "e0d08b13c3330100c8b837659bba8fb4"});
var categorySysId = categoryCreate.create();
var isValidSysId = categorySysId.match(/^[0-9a-fA-F]{32}$/) == null ? false : true;
global.Assert.assertEquals(true, isValidSysId,"CategorySysId: ["+ categorySysId +"] is not valid", true, isValidSysId);

    CatCategory - setTableName(cadeia de caracteres tablename)

    Define o nome da tabela para esta categoria.

    Tabela 17. Parâmetros
    Nome Tipo Descrição
    tableName Cadeia de caracteres Nome da tabela que estende sc_category.
    Tabela 18. Retornos
    Tipo Descrição
    vazio 
    var categoryRead = new sn_sc.CatCategory(categorySysId);
categoryRead.setTableName("test_category");
var values = categoryRead.read({"title" : "", "sc_catalog":"", "test": ""}, false);
gs.info(categorySysId);
gs.info(values.title);
gs.info(values.test);
global.Assert.assertEquals("testValue", values.test,"Category extends sc_category and stores its extended value");

    CatCategory - update(Object columnValues, boolian standardUpdate)

    Atualiza a categoria atual com os pares nome-valor especificados.

    Tabela 19. Parâmetros
    Nome Tipo Descrição
    ColumnValues Objeto Mapeamento de nomes de coluna 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 20. Retornos
    Tipo Descrição
    vazio 
    var categoryUpdate = new sn_sc.CatCategory(categorySysId);
categoryUpdate.update({"title" : "test changed scoped category"}, true);
values = categoryUpdate.read({"title" : "", "sc_catalog":""}, false);
global.Assert.assertEquals("test changed scoped category", values.title,"Category should title");