---
sourceDocument: Referência de API do Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Referência de API do Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# CatItem - com escopo

# CatItem - com escopo {#ariaid-title1}

* Versão de lançamento: Xanadu
* 
* Atualizado 1 de ago. de 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 12 min. de leitura

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

Esta API é executada no namespace `sn_sc`.

## CatItem - availableForUserCriteria(ação de cadeia de caracteres, critérios de matrizIDs) {#ariaid-title2}

Adiciona os critérios do usuário Available For ao item do catálogo atual.
{#r_CIS-availableForUserCriteria_S_A__table_mbk_f5f_vz__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| ação | Cadeia de caracteres | Ação a ser executada. * <kbd class="ph userinput">add</kbd>: adiciona os critérios do usuário à lista Disponível para. * <kbd class="ph userinput">delete</kbd>: exclui os critérios do usuário da lista Disponível para. {#r_CIS-availableForUserCriteria_S_A__ul_gc4_bs4_kpb} |
| critériosIDs | Matriz | Matriz dos critérios do usuário sys_ids. |
[Tabela 1. Parâmetros]

{#r_CIS-availableForUserCriteria_S_A__table_mbk_f5f_vz} {#r_CIS-availableForUserCriteria_S_A__table_nbk_f5f_vz__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 2. Retorna]

{#r_CIS-availableForUserCriteria_S_A__table_nbk_f5f_vz}  
Este exemplo mostra como adicionar os Available For critérios do usuário especificados.

    var item = new sn_sc.CatItem("31bea3d53790200044e0bfc8bcbe5dec");
    item.availableForUserCriteria("add", ["0c441abbc6112275000025157c651c89"]);

## CatItem -- canViewInDomain() {#ariaid-title3}

Verifica se o item do catálogo atual pode ser exibido no domínio selecionado (domínio selecionado no seletor de domínio).
Os itens do catálogo no domínio global estão disponíveis em todos os domínios.
{#CI-canViewInDomain__table_gww_bbd_thb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 3. Parâmetros]

{#CI-canViewInDomain__table_gww_bbd_thb} {#CI-canViewInDomain__table_hww_bbd_thb__entry__2}

| Tipo | Descrição |
|-|-|
| Booliano | Sinalizador que valida se o item do catálogo atual está visível no domínio selecionado. Valores válidos: * verdadeiro: o item do catálogo pode ser visualizado no domínio * falso: o item do catálogo não está visível no domínio {#CI-canViewInDomain__ul_sfm_gdy_shb} |
[Tabela 4. Retorna]

{#CI-canViewInDomain__table_hww_bbd_thb}  
Este exemplo mostra como verificar se um item do catálogo está visível no domínio selecionado no momento.

    var catItem = new sn_sc.CatItem("060f3afa3731300054b6a3549dbe5d3e");
    gs.info(catItem.canViewInDomain());

## CatItem - canViewOnSearch(booliano isMobile) {#ariaid-title4}

Determina se o usuário tem acesso para exibir o item do catálogo na pesquisa global.
{#CI-canViewOnSearch_B__table_pqy_zl2_sbb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| isMobile | Booliano | Sinalizador que indica se a pesquisa deve ser executada na exibição móvel ou na área de trabalho. Valores válidos: * verdadeiro: executa a pesquisa da exibição móvel. * falso: executa a pesquisa da exibição da área de trabalho. |
[Tabela 5. Parâmetros]

{#CI-canViewOnSearch_B__table_pqy_zl2_sbb} {#CI-canViewOnSearch_B__table_qqy_zl2_sbb__entry__2}

| Tipo | Descrição |
|-|-|
| Booliano | Sinalizador que indica se o usuário tem acesso para exibir o item do catálogo na pesquisa global. Valores válidos: * verdadeiro: o usuário tem acesso para exibir o item do catálogo na pesquisa global. * falso: o usuário não tem acesso para exibir o item do catálogo na pesquisa global. |
[Tabela 6. Retorna]

{#CI-canViewOnSearch_B__table_qqy_zl2_sbb}  
Este exemplo de código mostra como verificar se o usuário tem acesso para exibir o item do catálogo na pesquisa global na exibição da área de trabalho.

    var catItem = new sn_sc.CatItem("04b7e94b4f7b4200086eeed18110c7fd");
    var canView = catItem.canViewOnSearch('false');
    gs.info("Can view on global search: " + canView);

Saída:

    Can view on global search: true

## CatItem - create(Booliano StandardUpdate) {#ariaid-title5}

Insere o item do catálogo definido.
{#r_CatItem-create_Boolean__table_uh4_31n_ms__entry__3}

| 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: habilita a execução de mecanismos e fluxos de trabalho. * falso: não habilita a execução de mecanismos e fluxos de trabalho. Observe que as colunas de data do sistema criadas e atualizadas na tabela não são atualizadas. {#r_CatItem-create_Boolean__ul_olr_kf4_pnb} |
[Tabela 7. Parâmetros]

{#r_CatItem-create_Boolean__table_uh4_31n_ms} {#r_CatItem-create_Boolean__table_vh4_31n_ms__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | Sys_id do item do catálogo recém-criado. |
[Tabela 8. Retorna]

{#r_CatItem-create_Boolean__table_vh4_31n_ms}  
Este exemplo cria um novo item do catálogo e adiciona uma variável e um conjunto de variáveis.

    createCatalogItem('Catalog Item Name', 'Short Description', 'e0d08b13c3330100c8b837659bba8fb4', '109f0438c6112276003ae8ac13e7009d'); 

    function createCatalogItem(name, short_desc, catalogId, categoryId) {
        var catalogItem = new sn_sc.CatItem();
        catalogItem.setAttributes({
            "name": name,
            "short_description": short_desc
        });
        catalogItem.setCatalogs(catalogId); // set catalog
        catalogItem.setCategories(categoryId); // set category

        var catItemSysId = catalogItem.create(); // create new catalog item
        gs.info('Catalog item created in table sc_cat_item with sys_id ' + catItemSysId);

        // add variables and variable set
        addDefaultVariables(catItemSysId);
        addDefaultVariableSet(catItemSysId);
    }

    // creates a new variable and adds it to the catalog item
    function addDefaultVariables(catItemSysId) {
        var myVarAttrs = {
            "type": "6", // type 6 is single line text
            "cat_item": catItemSysId,
            "question_text": "First Name",
            "name": "first_name",
            'order': 50
        };
        var myVar = new sn_sc.CatalogItemVariable();
        myVar.setAttributes(myVarAttrs);
        var varRec = myVar.create(true);
        gs.info('Variable added to catalog item and record created in table item_option_new with sys_id ' + varRec);
    }

    // adds an existing variable set to the catalog item
    function addDefaultVariableSet(catItemSysId) {
        var varset = new sn_sc.CatalogItemVariableSetM2M();
        // fields used in object are from table io_set_item 
        var attr = {
            'variable_set': 'e01cab1a4f334200086eeed18110c71f', // required
            'sc_cat_item': catItemSysId, // required
            'order': 100 // 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:

    Catalog item created in table sc_cat_item with sys_id be5c771e876370103a730f2d0ebb3556
    Variable added to catalog item and record created in table item_option_new with sys_id b65cb71e876370103a730f2d0ebb3535
    Variable set added to catalog item and M2M record created in table io_set_item with sys_id 8b5cb71e876370103a730f2d0ebb354b

## CatItem - deleteRecord(Booliano StandardUpdate) {#ariaid-title6}

Exclui um item do catálogo.
{#r_CatItem-delete_Boolean__table_g1q_mfn_ms__entry__3}

| 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: habilita a execução de mecanismos e fluxos de trabalho. * falso: não habilita a execução de mecanismos e fluxos de trabalho. |
[Tabela 9. Parâmetros]

{#r_CatItem-delete_Boolean__table_g1q_mfn_ms} {#r_CatItem-delete_Boolean__table_h1q_mfn_ms__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 10. Retorna]

{#r_CatItem-delete_Boolean__table_h1q_mfn_ms}  
Este exemplo exclui todos os itens do catálogo inativos.

    var catalogItem = new GlideRecord('sc_cat_item');
    catalogItem.addQuery('active', 'false'); // get all inactive catalog items
    catalogItem.query();
    while (catalogItem.next()) {

        // before deleting a catalog item, delete its associated variable set M2M records
        var variableSetM2M = new GlideRecord('io_set_item'); // M2M table linking variable set and catalog item
        variableSetM2M.addQuery('sc_cat_item', catalogItem.getUniqueValue()); // get M2M records for the catalog item
        variableSetM2M.query();
        while (variableSetM2M.next()) {
            var varset = new sn_sc.CatalogItemVariableSetM2M(variableSetM2M.getUniqueValue()); // M2M record sys_id
            varset.deleteRecord(true); // delete M2M record
        }

        // then delete the catalog item
        var item = new sn_sc.CatItem(catalogItem.getUniqueValue()); 
        item.deleteRecord(true);
    }

## CatItem - getFirstAccessibleCategoryForSearch(cadeia de caracteres catalogId) {#ariaid-title7}

Retorna a primeira categoria que o usuário pode exibir em um catálogo.
{#CI-getFirstAccessibleCategoryForSearch_S__table_x4w_2g5_qbb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| catalogId | Cadeia de caracteres | Sys_id do catálogo. |
[Tabela 11. Parâmetros]

{#CI-getFirstAccessibleCategoryForSearch_S__table_x4w_2g5_qbb} {#CI-getFirstAccessibleCategoryForSearch_S__table_y4w_2g5_qbb__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | Sys_id da primeira categoria que o usuário pode exibir em um catálogo. |
[Tabela 12. Retorna]

{#CI-getFirstAccessibleCategoryForSearch_S__table_y4w_2g5_qbb}  
Exemplo:

    var CatItem=new sn_sc.CatItem("04b7e94b4f7b4200086eeed18110c7fd");	
    	console.log(CatItem.getFirstAccessibleCategoryForSearch("e0d08b13c3330100c8b837659bba8fb4"));

Saída:

    d258b953c611227a0146101fb1be7c31

## CatItem - getInvalidDelegatedUsers(Matriz requestForUsers) {#ariaid-title8}

Retorna uma matriz de usuários para os quais o item associado não pode ser delegado (solicitado em nome de).
O método verifica cada um dos usuários aprovados na matriz.
{#CI-getInvalidDelegatedUsers_A__table_avj_5n3_nlb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| requestForUsers | Objeto | Matriz de sys_ids do usuário para verificar se o usuário associado pode adquirir o item atual e se o item pode ser solicitado em nome dele. Os sys_ids do usuário estão localizados na tabela Usuários \[sys_user\]. |
[Tabela 13. Parâmetros]

{#CI-getInvalidDelegatedUsers_A__table_avj_5n3_nlb} {#CI-getInvalidDelegatedUsers_A__table_bvj_5n3_nlb__entry__2}

| Tipo | Descrição |
|-|-|
| Matriz | Lista de nomes de usuário (coluna Nome da tabela Usuários \[sys_user\]) para os quais o item não pode ser solicitado por um delegado. |
[Tabela 14. Retorna]

{#CI-getInvalidDelegatedUsers_A__table_bvj_5n3_nlb}  
Este exemplo mostra como obter uma lista de nomes de usuários para os quais o item não pode ser solicitado por um delegado.

    function getInvalidDelegatedUsers(itemId, userIds) {
    var catItem = new sn_sc.CatItem(itemId);
    var invalidUsers = catItem.getInvalidDelegatedUsers(userIds);
    return invalidUsers;
    }

Saída:

    [
      "Joe Smith",
      "Jenny Brown",
      "Fred Bennet",
      "Alice Jones"
    ]

## CatItem -- getRecordClass() {#ariaid-title9}

Retorna o nome da classe do registro de item do catálogo atual.
{#CI-getRecordClass__table_jld_nl2_sbb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 15. Parâmetros]

{#CI-getRecordClass__table_jld_nl2_sbb} {#CI-getRecordClass__table_kld_nl2_sbb__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | Nome da classe para o registro de item do catálogo atual. |
[Tabela 16. Retorna]

{#CI-getRecordClass__table_kld_nl2_sbb}  
Exemplo:

    var CatItem=new sn_sc.CatItem("04b7e94b4f7b4200086eeed18110c7fd");	
    	console.log(CatItem.getRecordClass());

Saída:

    sc_cat_item

## CatItem - isDelegationAllowed(cadeia de caracteres delegadoUser) {#ariaid-title10}

Verifica se o usuário delegado especificado tem direitos de aquisição para o item do catálogo de serviços atual.
{#CI-isDelegationAllowed_S__table_spd_p3q_nlb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| delegadoUsuário | Cadeia de caracteres | Opcional. Sys_id do usuário para o qual solicitar o item do catálogo de serviços (delegado). O método verifica se o usuário tem direitos de aquisição para o item. Padrão: verifica se o usuário de chamada tem direitos de aquisição para o item. |
[Tabela 17. Parâmetros]

{#CI-isDelegationAllowed_S__table_spd_p3q_nlb} {#CI-isDelegationAllowed_S__table_tpd_p3q_nlb__entry__2}

| Tipo | Descrição |
|-|-|
| Booliano | Sinalizador que indica se o usuário tem direitos de aquisição para o item do catálogo de serviços atual. Valores válidos: * verdadeiro: o usuário tem direitos de aquisição para o item. * falso: o usuário não tem direitos de aquisição para o item. {#CI-isDelegationAllowed_S__ul_sxh_kqq_nlb} |
[Tabela 18. Retorna]

{#CI-isDelegationAllowed_S__table_tpd_p3q_nlb}  
Este exemplo de código mostra como determinar se a delegação é permitida para o item do catálogo.

    function canRequestFor(itemId, user) {
      var catItem = new sn_sc.CatItem(itemId);
      var result = catItem.isDelegationAllowed(user);
      return result;
    }

Saída: verdadeiro

## CatItem - isVisibleServicePortal() {#ariaid-title11}

Determina se o item do catálogo atual está disponível no portal de serviços.
{#CI-isVisibleServicePortal__table_rdm_bn2_sbb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 19. Parâmetros]

{#CI-isVisibleServicePortal__table_rdm_bn2_sbb} {#CI-isVisibleServicePortal__table_sdm_bn2_sbb__entry__2}

| Tipo | Descrição |
|-|-|
| Booliano | Sinalizador que indica se o item do catálogo está disponível no Portal de serviços. Valores válidos: * verdadeiro: disponível no Portal de serviços. * falso: não disponível no Portal de serviços. |
[Tabela 20. Retorna]

{#CI-isVisibleServicePortal__table_sdm_bn2_sbb}  
Exemplo:

    var catItem = new sn_sc.CatItem("04b7e94b4f7b4200086eeed18110c7fd");
    var catItemAvail = catItem.isVisibleServicePortal();
    gs.info("Is item available on Service Portal: " + catItemAvail);

Saída:

    Is item available on Service Portal: true

## CatItem - notAvailableForUserCriteria(ação de cadeia de caracteres, critérios de matrizIDs) {#ariaid-title12}

Adiciona os Not Available For critérios do usuário a um item do catálogo.
{#r_CIS-notAvailableForUserCriteria_S_A__table_wdk_tkn_vz__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| ação | Cadeia de caracteres | Ação a ser executada. * <kbd class="ph userinput">add</kbd>: adiciona os critérios do usuário à lista Não disponível para. * <kbd class="ph userinput">delete</kbd>: exclui os critérios do usuário da lista Não disponível para. {#r_CIS-notAvailableForUserCriteria_S_A__ul_gc4_bs4_kpb} |
[Tabela 21. Parâmetros]

{#r_CIS-notAvailableForUserCriteria_S_A__table_wdk_tkn_vz} {#r_CIS-notAvailableForUserCriteria_S_A__table_xdk_tkn_vz__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 22. Retorna]

{#r_CIS-notAvailableForUserCriteria_S_A__table_xdk_tkn_vz}  
Este exemplo mostra como adicionar os Not Available For critérios do usuário especificados.

    var item = new sn_sc.CatItem("31bea3d53790200044e0bfc8bcbe5dec");
    item. notAvailableForUserCriteria("add", ["0c441abbc6112275000025157c651c89"]);

## CatItem - read (colunas de objeto, Booliano StandardUpdate) {#ariaid-title13}

Retorna um mapeamento de valores de atributo de item do catálogo.
{#r_CatItem-read_Object_Boolean__table_hsf_kgn_ms__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| colunas | Objeto | Pares de nome-valor de colunas para os quais os valores serão retornados. |
| padrãoAtualizar | Booliano | Sinalizador que indica se a execução de mecanismos e fluxos de trabalho deve ser habilitada. Valores válidos: * verdadeiro: habilita a execução de mecanismos e fluxos de trabalho. * falso: não habilita a execução de mecanismos e fluxos de trabalho. {#r_CatItem-read_Object_Boolean__ul_alx_f3p_kpb} |
[Tabela 23. Parâmetros]

{#r_CatItem-read_Object_Boolean__table_hsf_kgn_ms} {#r_CatItem-read_Object_Boolean__table_isf_kgn_ms__entry__2}

| Tipo | Descrição |
|-|-|
| Objeto | Mapeamento de nomes de coluna para valores. |
[Tabela 24. Retorna]

{#r_CatItem-read_Object_Boolean__table_isf_kgn_ms}  
Este exemplo lê os campos de nome e preço de um item do catálogo.

    var catItem = new sn_sc.CatItem("a96277509f300200b407b89a442e704e");
    var values = catItem.read({"name" : "", "price" : ""}, true);
    gs.info("Catalog item name: " + values.name);
    gs.info("Catalog item price: " + values.price);

Saída:

    Catalog item name: Standard Laptop
    Catalog item price: 1100

## CatItem - setAttributes(Atributos de objeto) {#ariaid-title14}

Define atributos para um item do catálogo.
{#r_CatItem-setAttributes_Object__table_lgj_33n_ms__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| atributos | Objeto | Pares de nome-valor das colunas para as quais definir. |
[Tabela 25. Parâmetros]

{#r_CatItem-setAttributes_Object__table_lgj_33n_ms} {#r_CatItem-setAttributes_Object__table_mgj_33n_ms__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 26. Retorna]

{#r_CatItem-setAttributes_Object__table_mgj_33n_ms}  
Este exemplo define atributos para um novo item do catálogo.

    createCatalogItem('Name of your Catalog Item', 'Short Description of your Catalog Item', 'e0d08b13c3330100c8b837659bba8fb4', '109f0438c6112276003ae8ac13e7009d'); 

    function createCatalogItem(name, short_desc, catalogId, categoryId) {
        var catalogItem = new sn_sc.CatItem();
        // catalog item column values
        var attributes ={
            "name": name,
            "short_description": short_desc,
    	 "description": "<p>This is a test catalog item.</p>",
    	 "workflow":"0287f2c64a36232700820846b1f8bdce" // sys_id of workflow
        };
        catalogItem.setAttributes(attributes); // set catalog item attributes
        catalogItem.setCatalogs(catalogId); // set catalog
        catalogItem.setCategories(categoryId); // set category

        var catItemSysId = catalogItem.create(); // create new catalog item
        gs.info('Catalog item created in table sc_cat_item with sys_id ' + catItemSysId);
    }

Saída:

    Catalog item created in table sc_cat_item with sys_id 706948a287e370103a730f2d0ebb351e

## CatItem - setCatalogs(Catálogos de cadeias de caracteres) {#ariaid-title15}

Define os catálogos aos quais este item do catálogo está associado.
{#r_CatItem-setCatalogs_String__table_enx_v3n_ms__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| catálogos | Cadeia de caracteres | Lista separada por vírgulas de sys_ids dos catálogos para associar ao item o item. |
[Tabela 27. Parâmetros]

{#r_CatItem-setCatalogs_String__table_enx_v3n_ms} {#r_CatItem-setCatalogs_String__table_fnx_v3n_ms__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 28. Retorna]

{#r_CatItem-setCatalogs_String__table_fnx_v3n_ms}  
Este exemplo associa um item do catálogo a dois catálogos.

    var short_desc = 'This is a short description of my catalog item.';
    var catalogItem = new sn_sc.CatItem();
    catalogItem.setAttributes({
        "name": 'My Catalog Item',
        "short_description": short_desc
    });
    catalogItem.setCatalogs('e0d08b13c3330100c8b837659bba8fb4,742ce428d7211100f2d224837e61036d'); // set Service Catalog and Technical Catalog

    var catItemSysId = catalogItem.create(); // create new catalog item
    gs.info('Catalog item created in table sc_cat_item with sys_id ' + catItemSysId);

Saída:

    Catalog item created in table sc_cat_item with sys_id d0c5dcaa872770103a730f2d0ebb35cb

## CatItem - setCategories(cadeias de cadeias de caracteres) {#ariaid-title16}

Define as categorias às quais este item do catálogo está associado.
{#r_CatItem-setCategories_String__table_c3s_djn_ms__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| categorias | Cadeia de caracteres | Lista separada por vírgulas de sys_ids das categorias a serem associadas ao item. |
[Tabela 29. Parâmetros]

{#r_CatItem-setCategories_String__table_c3s_djn_ms} {#r_CatItem-setCategories_String__table_d3s_djn_ms__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 30. Retorna]

{#r_CatItem-setCategories_String__table_d3s_djn_ms}  
Este exemplo mostra como associar duas categorias a um item.

    var catItem = new sn_sc.CatItem("060f3afa3731300054b6a3549dbe5d3e");
    catItem.setCatagories("af443cfa5f130100a9ad2572f2b47747", "d467125fd7500200d74460affd6103a1");

## CatItem - setImage(cadeia de caracteres dbImageSysId, tipo de cadeia de caracteres) {#ariaid-title17}

Adiciona uma imagem a um item do catálogo.
{#r_CatItem-setImage_String_String__table_nwf_kjn_ms__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| dbImageSysId | Cadeia de caracteres | Sys_id da imagem da tabela Imagens \[db_image\]. |
| tipo | Cadeia de caracteres | Tipo de imagem. Valores válidos: * imagem * ícone {#r_CatItem-setImage_String_String__ul_p4n_ksp_kpb} |
[Tabela 31. Parâmetros]

{#r_CatItem-setImage_String_String__table_nwf_kjn_ms} {#r_CatItem-setImage_String_String__table_owf_kjn_ms__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 32. Retorna]

{#r_CatItem-setImage_String_String__table_owf_kjn_ms}  
Este exemplo adiciona uma imagem a um item do catálogo.

    var catItem = new sn_sc.CatItem("1fc0bd968777301093d5ec6d0ebb3548"); // sys_id of catalog item to update
    // update fields if needed
    var attr = {
        'name': 'New Name of Catalog Item - 123',
        'description': '<p>This is an updated description.</p><p> My description new line 1</p><p>My description new line 2</p>',
        'short_description': 'New Short Description of Catalog Item' 
    };
    catItem.update(attr, true);
    catItem.setImage('1b443cfa5f130100a9ad2572f2b47746', 'picture'); // sys_id of image from table db_image

## CatItem -- setTableName(cadeia de caracteres "tableName") {#ariaid-title18}

Define o nome da tabela para este item do catálogo.
{#r_CatItem-setTableName_String__table_yzb_bpd_ns__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| tableName | Cadeia de caracteres | Nome da tabela que estende o Item do catálogo \[sc_cat_item\]. |
[Tabela 33. Parâmetros]

{#r_CatItem-setTableName_String__table_yzb_bpd_ns} {#r_CatItem-setTableName_String__table_zzb_bpd_ns__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 34. Retorna]

{#r_CatItem-setTableName_String__table_zzb_bpd_ns}  
Este exemplo mostra como definir o nome de uma tabela estendida.

    var catItem = new sn_sc.CatItem();
    catItem.setTableName("New_catalog_table");

## CatItem - submitProducer (valores de objeto) {#ariaid-title19}

Cria um registro usando um produtor de registro Catálogo de serviços especificado.
{#CI-submitProducer_O__table_gdj_y4n_crb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| valores | Objeto | Contém os valores de campo e o produtor de registro a serem usados ao criar o registro. { "variables": {Object}, "sysparm_id": "String" } |
| valores.variáveis | Objeto | Os valores de campo a serem definidos para o novo registro. { "field": "String", "field": "String" } |
| valores.sysparm_id | Cadeia de caracteres | Sys_id do produtor de registro a ser usado na tabela Produtor de registro \[sc_cat_item_producer\]. |
[Tabela 35. Parâmetros]

{#CI-submitProducer_O__table_gdj_y4n_crb} {#CI-submitProducer_O__table_hdj_y4n_crb__entry__2}

| Tipo | Descrição |
|-|-|
| Objeto | Contém informações sobre o registro que foi criado. { "number": "String", "parent_id": "String", "parent_table": "String", "record": "String", "redirect_portal_url": "String", "redirect_to": "String", "redirect_url": "String", "sys_id": "String", "table": "String" } |
| \<Object\>.número | Valor do campo Número do registro criado. Tipo de dados: cadeia de caracteres |
| \<Object\>.parent_id | Sys_id do registro primário. Tipo de dados: cadeia de caracteres |
| \<Object\>.parent_table | A tabela primária da tabela em que o registro foi criado. Tipo de dados: cadeia de caracteres |
| \<Object\>.registro | XML do registro criado. Tipo de dados: cadeia de caracteres |
| \<Object\>.redirect_portal_url | URL para o qual o Portal de serviçosserá redirecionado. Tipo de dados: cadeia de caracteres |
| \<Object\>.redirect_to | Redirecionar valor. Tipo de dados: cadeia de caracteres |
| \<Object\>.redirect_url | URL do registro criado. Tipo de dados: cadeia de caracteres |
| \<Object\>.sys_id | Sys_id do registro criado. Tipo de dados: cadeia de caracteres |
| \<Object\>.tabela | A tabela em que o registro foi criado. Tipo de dados: cadeia de caracteres |
[Tabela 36. Retorna]

{#CI-submitProducer_O__table_hdj_y4n_crb}  
Este exemplo cria um incidente usando o produtor de registro Criar incidente.

    var catalogItem = new sn_sc.CatItem('3f1dd0320a0a0b99000a53f7604a2ef9');  //sys_id of the Create Incident record producer 
    var values = {
       "variables": {"urgency" : "2", "comments" : "Laptop is in a brick state"},
       "sysparm_id": "3f1dd0320a0a0b99000a53f7604a2ef9"
    }
    var targetRecordDetails = catalogItem.submitProducer(values);
    gs.info(JSON.stringify(targetRecordDetails, null, 3));

Saída:

    {
       "sys_id": "133b2ee1875f30103a730f2d0ebb35f9",
       "number": "INC0010002",
       "parent_id": null,
       "record": "api/now/table/incident/133b2ee1875f30103a730f2d0ebb35f9",
       "redirect_portal_url": "",
       "parent_table": "task",
       "redirect_url": "incident.do?sys_id=133b2ee1875f30103a730f2d0ebb35f9&sysparm_view=ess",
       "table": "incident",
       "redirect_to": "generated_record"
    }

## CatItem - atualizar (objeto columnValues, booliano padrãoAtualizar) {#ariaid-title20}

Atualiza os valores dos campos especificados de um item do catálogo.
{#r_CatItem-update_Object_Boolean__table_uv3_npd_ns__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| columnValues | Objeto | Pares de nome-valor dos campos a serem atualizados e seus valores associados. |
| padrãoAtualizar | Booliano | Sinalizador que indica se a execução de mecanismos e fluxos de trabalho deve ser habilitada. Valores válidos: * verdadeiro: habilita a execução de mecanismos e fluxos de trabalho. * falso: não habilita a execução de mecanismos e fluxos de trabalho. {#r_CatItem-update_Object_Boolean__ul_rpk_xsp_kpb} |
[Tabela 37. Parâmetros]

{#r_CatItem-update_Object_Boolean__table_uv3_npd_ns} {#r_CatItem-update_Object_Boolean__table_vv3_npd_ns__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 38. Retorna]

{#r_CatItem-update_Object_Boolean__table_vv3_npd_ns}  
Este exemplo atualiza o nome, a descrição resumida e o preço de um item do catálogo existente.

    var catItem = new sn_sc.CatItem("1fc0bd968777301093d5ec6d0ebb3548"); // sys_id of catalog item to update
    printCatalogItem(); // print current catalog item values
    // object containing fields to update
    var attr = {
        "name": "New Name of Catalog Item",
        "short_description": "New Short Description of Catalog Item", 
        "price": "450"
    };
    catItem.update(attr, true);
    printCatalogItem(); // print new catalog item values

    // prints the name, short description, and price of the catalog item
    function printCatalogItem(){
        // object containing fields to read
        var readValues = {
            "name" : "", 
            "short_description" : "", 
            "price" : ""
        };
        var values = catItem.read(readValues, true); // read the field values
        gs.info("Catalog item name: " + values.name);
        gs.info("Catalog item short description: " + values.short_description);
        gs.info("Catalog item price: " + values.price);
    }

Saída:

    Catalog item name: Example Catalog Item
    Catalog item short description: Example Short Description
    Catalog item price: 300
    Catalog item name: New Name of Catalog Item
    Catalog item short description: New Short Description of Catalog Item
    Catalog item price: 450