---
sourceDocument: Capacidades da Now Platform da Yokohama
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/yokohama/servicenow-platform

 Release :

    - yokohama

ft:locale :

    - pt-BR

ft:publication_title :

    - Capacidades da Now Platform da Yokohama

ft:clusterId :

    - platcap

bundleId :

    - platcap

workflow :

    - Platform


---

# Criar um conjunto de variáveis e adicioná-lo a um item

# Criar um conjunto de variáveis e adicioná-lo a um item {#ariaid-title1}

* Versão de lançamento: Yokohama
* 
* Atualizado 30 de jan. de 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 4 min. de leitura

Crie um conjunto de variáveis e os adicione a vários itens do catálogo e guias de pedido para reutilização.

## Antes de Iniciar

Função necessária: catalog_admin, admin, catalog_editor ou catalog_manager

## Por Que e Quando Desempenhar Esta Tarefa

* Os conjuntos de variáveis em um item do catálogo não podem ter o mesmo nome interno.
* Em um item do catálogo, o nome de uma variável não pode ser igual ao título ou nome interno de um conjunto de variáveis.
* Qualquer script do cliente de catálogo ou script de política de IU do catálogo deve se referir ao nome interno de um conjunto de variáveis, em vez de seu nome ou título.
{#t_CreateAVariableSet__ul_u5g_kk4_l3b}

## Procedimento

1. Navegar até TudoCatálogo de serviçosVariáveis de CatálogoConjuntos de variáveis.
2. Clique em Nova.  
   A página Criação de conjunto de variáveis é exibida.
3. Selecione uma das opções a seguir.

   | Opção | Descrição |
   | Conjunto de variáveis com linha única | Cria um conjunto de variáveis agrupadas. O campoTipo está definido como <kbd class="ph userinput">Linha única</kbd>. |
   | Conjunto de variáveis com várias linhas | Cria um conjunto de variáveis com várias linhas que captura dados variáveis em um layout de grade. O campoTipo está definido como <kbd class="ph userinput">Várias linhas</kbd>. |
   |-|-|

   {#t_CreateAVariableSet__choicetable_uby_1gq_ddb}
4. Insira os detalhes.  
   {#t_CreateAVariableSet__table_c2q_s1c_xq__entry__2}

   | Campo | Descrição |
   |-|-|
   | Título | Título de um conjunto de variáveis. Aparecerá se a caixa de seleção Exibir título estiver marcada. |
   | Nome interno | Nome do conjunto de variáveis para uso interno. Por exemplo, para acessar o conjunto de variáveis para o front-end (por meio da API g_form) e script do lado do servidor. |
   | Ordem | Número da ordem do conjunto de variáveis. |
   | Tipo | Tipo do conjunto de variáveis. As opções possíveis são: * Linha única * Linha múltipla {#t_CreateAVariableSet__ul_ebn_5kl_gdb} |
   | Aplicação | Aplicações que podem usar esse conjunto de variáveis. |
   | Título de exibição | Se selecionado, adiciona um título e um cabeçalho expansível à direita do conjunto de variáveis. Nota: Quando um usuário solicita o item, todas as variáveis da caixa de seleção são agrupadas em um título padrão de Opções . Para usar um título personalizado, insira uma variável do tipo Rótulo, com um valor de Ordem que o coloque diretamente acima das variáveis da caixa de seleção. |
   | Atributos do conjunto de variáveis | Atributos para configurar um conjunto de variáveis com várias linhas. Use o atributo max_rows a fim de definir um limite para o número de linhas que você pode adicionar a um conjunto de variáveis com várias linhas. Por exemplo, especifique <kbd class="ph userinput">max_rows = 1</kbd> como o valor do campo. |
   | Layout | A exibição do layout. Defina como 1 coluna de largura ou 2 colunas de largura, lados alternados ou 2 colunas de largura, um lado e depois o outro. |
   | Descrição | Descrição do conjunto de variáveis. |
   [ ]

   {#t_CreateAVariableSet__table_c2q_s1c_xq}
5. Clique com o botão direito do mouse e selecione Salvar.
6. Crie as variáveis a serem usadas nesse conjunto.
   1. Na lista relacionada Variáveis, clique em Novo.
   2. Siga as etapas para [criar variáveis](https://servicenow-prod.fluidtopics.net/hldKClzjeWUBrpelDnr7nA "Crie variáveis dos catálogos de serviços para coletar informações de usuários que solicitam um item do catálogo, por exemplo, para perguntar aos usuários quais opções eles desejam para o item.").  
      Nota:  
      Para um conjunto de variáveis com várias linhas:
      * As variáveis incluídas são exibidas como colunas de uma tabela.
      * A ordem das colunas é a ordem das variáveis definidas no conjunto de variáveis.
      {#t_CreateAVariableSet__ul_mx5_2ml_gdb}
   {#t_CreateAVariableSet__substeps_htx_fg4_ybb}
7. Para criar uma regra de pesquisa de dados do catálogo associada, execute as etapas a seguir.
   1. Na lista relacionada Definições de pesquisa de dados do catálogo, clique em Novo.
   2. No formulário Campos de definições de pesquisa de dados de catálogo, preencha os campos.  
      Para obter informações sobre como criar uma regra de pesquisa de dados, consulte [Criar uma definição de pesquisa de catálogo](https://servicenow-prod.fluidtopics.net/A2sNSJkMAFFN5rGd1EG3vg#t_CreatACatDataLookupDefRec "Crie um registro de definição de pesquisa de dados do catálogo.").
   {#t_CreateAVariableSet__substeps_jv1_lqy_g4b}
8. Clique em Enviar.

## Adicionar um conjunto de variáveis a um item do catálogo ou guia de pedido {#ariaid-title2}

Catálogo de serviços permite adicionar um conjunto de variáveis a um ou mais itens do catálogo ou guias de pedido.

### Antes de Iniciar

Função necessária: catalog_admin, admin, catalog_editor ou catalog_manager

### Procedimento

1. Abra um item do catálogo ou um guia de pedido.

   | Opção | Caminho de navegação |
   | Item do catálogo | Catálogo de serviçosDefinição de CatálogoGerenciar Itens |
   | Guia de pedido | Catálogo de serviçosDefinição de CatálogoFormulário de solicitações |
   |-|-|

   {#t_AddAVariableSetToACatalogItem__choicetable_ulz_dzd_ndb}
2. Na lista relacionada Conjuntos de variáveis, clique em Editar.  
   Você pode configurar o formulário para adicionar a lista relacionada Conjuntos de variáveis.
3. Selecione e adicione um conjunto de variáveis.  
   Nota:  
   Se a caixa de seleção Variáveis em cascata estiver marcada para um guia de pedido, os dados do conjunto de variáveis com várias linhas deverão ser enviados em cascata para os itens incluídos.
4. Clique em Salvar.
5. Clique em Testar.  
   Nota:  
   Para um conjunto de variáveis com várias linhas:
   * As variáveis associadas são exibidas como colunas de uma tabela em um item do catálogo ou produtor de registro. Cada linha corresponde a um conjunto de dados para todas as variáveis no conjunto de variáveis.
   * A ordem das colunas é a ordem das variáveis definidas no conjunto de variáveis.
   {#t_AddAVariableSetToACatalogItem__ul_ym2_kml_gdb}
6. **Opcional:** Edite um conjunto de variáveis com várias linhas.
   1. Para adicionar uma linha, clique em Adicionar no conjunto de variáveis, especifique as informações da variável na janela Adicionar linha e clique em Adicionar.  
      Nota:  
      * É possível adicionar, no máximo, 50 linhas.
      * A menos que valores padrão sejam fornecidos para variáveis ou scripts Ao carregar sejam usados para preencher previamente os dados, você deve adicionar dados variáveis para cada linha.
      {#t_AddAVariableSetToACatalogItem__ul_xqq_yqk_ndb}
   2. Para editar uma linha, clique no ícone de edição da linha ![Ícone de edição de uma linha]() na coluna Ações, especifique as informações variáveis na janela Editar Linha e clique em Salvar.  
      Nota:  
      Ao adicionar ou editar uma linha existente, todas as políticas de IU do catálogo e scripts de cliente associados ao conjunto de variáveis de várias linhas devem ser respeitadas.
   3. Para remover uma linha, clique no ícone de remoção da linha ![Ícone de remoção de uma linha]() na coluna Ações e clique em Remover na janela de confirmação.
   4. Para remover todas as linhas da tabela, clique em Remover tudo no conjunto de variáveis e clique em Remover na janela de confirmação.
   {#t_AddAVariableSetToACatalogItem__substeps_usp_swd_ndb}