---
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 variável do Catálogo de serviços

# Criar variável do Catálogo de serviços {#ariaid-title1}

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

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.

## Antes de Iniciar

Função necessária: administrador

## Procedimento

1. Navegar até TudoCatálogo de serviçosDefinições de CatálogoGerenciar Itens.
2. Selecione o item do catálogo para o qual você deseja criar uma variável.
3. Na lista relacionada Variáveis, clique em Novo.
4. Selecione o tipo de variável.  
   Somente os campos aplicáveis para o tipo de variável são exibidos.
5. No formulário, preencha os campos.  
   {#t_CreateAVariableForACatalogItem__table_k3f_2d4_2db__entry__2}

   | Campo | Descrição |
   |-|-|
   | Aplicação | Campo somente de leitura que indica quais aplicações podem usar esta variável. |
   | Mapear para campo | Mapeia a variável para um campo específico na tabela do produtor de registro. Este campo vai aparecer se a variável pertencer a um produtor de registro. |
   | Tipo | O tipo de variável que você deseja criar. Para obter mais informações, consulte [Tipos de variáveis do catálogo de serviços](https://servicenow-prod.fluidtopics.net/7Rv_g0Ih~s9pqSQX1uZMYQ "As variáveis permitem que você especifique perguntas para um item do catálogo. Vários tipos de variáveis do Catálogo de serviços são fornecidos. Alguns tipos de variáveis aceitam atributos de variável."). |
   | Item do catálogo | Item do catálogo usando a variável. |
   | Solicitar | Solicitar que a variável seja colocada na página para o item do catálogo. As variáveis são organizadas de cima para baixo do menor para o maior valor de pedido. Por exemplo, uma variável com um valor de pedido de 1 é colocada acima de outras variáveis com valores de pedido superiores. |
   | Ativo | Caixa de seleção para tornar a variável disponível para uso |
   | Obrigatório | Caixa de seleção para tornar a variável obrigatória como parte do processo de pedido. Nota: Este comportamento é aplicável somente no carregamento da página e pode ser alterado por meio de APIs do cliente. |
   | Somente leitura | Opção para tornar a variável somente de leitura ou editável. |
   | Oculto | Opção para ocultar a variável. |
   | Exclusivo | Opção para proibir valores duplicados para esta variável em um conjunto de variáveis com várias linhas. Nota: * Este campo aparece somente para uma variável criada em um conjunto de variáveis com várias linhas. * Este comportamento é aplicável somente em Now Platform, Portal de serviços e no editor de variáveis em Espaço do agente. {#t_CreateAVariableForACatalogItem__ul_inh_lny_g4b} |
   | Seleção Necessária | Caixa de seleção para exigir que os usuários marquem a variável da caixa de seleção. Por exemplo, use esta opção para exigir que os usuários marquem a caixa de seleção Concordo em um formulário de acordo. Se os usuários tentarem enviar o formulário de acordo sem marcar a caixa de seleção, uma mensagem de alerta vai ser exibida para informar que eles precisam marcar a caixa de seleção. |
   | Global | Se selecionada, a variável estará disponível para todas as tarefas do catálogo nos fluxos de trabalho do catálogo de serviços ou planos de execução por padrão. Se desmarcada, a variável deve ser associada a tarefas do catálogo individuais. |
   | Campo | Campo para o qual a variável mapeia. Este campo vai aparecer se a variável pertencer a um produtor de registro. |
   | Tabela do produtor de registro | Tabela na qual o produtor de registro cria um registro Este campo vai aparecer se a variável pertencer a um produtor de registro. |
   | Pergunta ||
   | Pergunta | Pergunta para aos usuários que estão solicitando o item do catálogo. |
   | Nome | Nome para identificar a pergunta. Nota: Se esse campo estiver vazio, seu valor vai ser preenchido automaticamente com base no campo Pergunta para todos os tipos de variáveis, exceto pausa, divisão do contêiner e término do contêiner. |
   | Dica da ferramenta | Texto de dica de ferramenta a ser exibido quando os usuários apontarem para a variável. Insira uma breve observação para descrever a finalidade da "Pergunta". |
   | Texto de exemplo | Dica exibida no campo da pergunta antes de o usuário inserir um valor. Aplicável às seguintes variáveis: * Endereço IP * E-mail * URL * Texto de linha única * Texto de linha única larga * Texto de várias linhas * Data * Data/Hora {#t_CreateAVariableForACatalogItem__ul_qx2_cj2_cz} |
   | Rich Text | Rótulo formatado a ser exibido em um formulário de item do catálogo. Aplicável para a variável do Rótulo de Rich Text. |
   | Anotação ||
   | Mostrar ajuda | Se selecionado, exibe o [texto de ajuda](https://servicenow-prod.fluidtopics.net/Dmn_pxx6JVypGd8Ew~lpBA "Insira informações de ajuda para uma variável a fim de ajudar os usuários a determinar quais informações eles devem fornecer para uma variável do Catálogo de serviços.") e as instruções para a variável. Nota: * Não está disponível para variáveis de quebra e caixa de seleção. * O texto da ajuda e as instruções não estão disponíveis para um conjunto de variáveis. {#t_CreateAVariableForACatalogItem__ul_hpc_3kc_3gb} |
   | Sempre Expandido | Se selecionado, o Texto de ajuda e o valor do campo Instruções vão ser expandidos por padrão quando a página do item do catálogo for carregada. Essa caixa de seleção aparece apenas quando a caixa de seleção Exibir ajuda for marcada. Nota: * Este campo também é aplicável no Portal de serviços. * Este campo não é aplicável no editor de variáveis no Espaço e no componente UIB do Item do catálogo. * Se a caixa de seleção Expandir ajuda para todas as perguntas estiver marcada no nível do item do catálogo, a configuração do campo Sempre expandido no nível da variável vai ser substituída. * Se a caixa de seleção Expandir ajuda para todas as perguntas estiver desmarcada no nível do item do catálogo, a configuração do campo Sempre expandido no nível da variável vai ser aplicável. {#t_CreateAVariableForACatalogItem__ul_eyb_qlt_xfb} |
   | Marcador de ajuda | Se a caixa de seleção Sempre Expandido estiver desmarcada, clique no valor especificado neste campo para exibir o texto da Ajuda e os valores do campo Instruções. Este campo não é aplicável no editor de variáveis no Espaço e no componente UIB do Item do catálogo. |
   | Texto de ajuda | Informações de ajuda para uma variável do Catálogo de serviços. Este campo é aplicável em Now Platform, Portal de serviços, e editor de variáveis no Espaço e no componente UIB do Item do catálogo. No entanto, em Espaço e no componente UIB do item do catálogo, é possível exibir o texto de ajuda ou as instruções. Se as instruções e o texto de ajuda estiverem disponíveis, vai ser possível exibir somente as instruções. Este campo não é aplicável para variáveis Break, CheckBox, Container End, Container Split, Macro, and UI Page. Em Espaço e no componente UIB do Item do catálogo, este campo também não é aplicável para uma variável Mascarada. |
   | Instruções | Informações que exigem formatação de rich text ou adição de imagens para oferecer suporte a informações de ajuda. Este campo é aplicável em Now Platform, Portal de serviços, e editor de variáveis no Espaço e no componente UIB do Item do catálogo. No entanto, em Espaço e no componente UIB do item do catálogo, é possível exibir o texto de ajuda ou as instruções. Se as instruções e o texto de ajuda estiverem disponíveis, vai ser possível exibir somente as instruções. Em Espaço e no componente UIB do Item do catálogo, este campo também não é aplicável para uma variável Mascarada. Nota: Para tabelas HTML, use tamanhos que estejam dentro da largura da variável. |
   | Especificações de tipo (os campos nesta seção variam para cada tipo de variável) ||
   | Largura da variável | Largura para a variável em uma página de item do catálogo, para especificar a porcentagem do tamanho da tela que ela pode abranger. Para obter detalhes, consulte [Configuração de uma largura padrão para variáveis do catálogo de serviços](https://servicenow-prod.fluidtopics.net/saG3EiBMkqA9omx9lez4YQ "Configure a largura padrão das variáveis em uma página de item do catálogo para especificar a porcentagem do tamanho da tela que ela pode abranger."). Este campo aparece para todos os tipos de variáveis, exceto para variáveis de quebra, término de contêiner, início de contêiner, divisão de contêiner, layout de contêiner e rótulo. |
   | Habilitar também solicitação para | Opção para permitir que uma solicitação de item do catálogo seja enviada para vários usuários. Depois de selecionar esta opção, o campo Solicitação também para é exibido com a variável Solicitado para em um item do catálogo. * Esta funcionalidade é aplicável somente no Portal de serviços. * Este campo é aplicável somente para a variável Solicitado para. {#t_CreateAVariableForACatalogItem__ul_i24_jt1_hmb}Para obter informações sobre experiência de solicitação delegada, consulte [Experiência de solicitação delegada](https://servicenow-prod.fluidtopics.net/pIvFwxCizpaumxFjVlk4WQ "Você pode solicitar um item do catálogo em nome de outro usuário ou de vários usuários usando a variável Solicitado para."). |
   | Funções para usar também solicitação para | Opção para especificar as funções que podem enviar uma solicitação de item do catálogo para vários usuários. * Esta funcionalidade é aplicável somente no Portal de serviços. * Este campo é aplicável somente para a variável Solicitado para. * Este campo aparece apenas se a caixa de seleção Habilitar solicitação também para estiver marcada. {#t_CreateAVariableForACatalogItem__ul_e3t_lt1_hmb} Nota: Se nenhuma função for especificada, qualquer pessoa que tenha acesso ao item do catálogo vai poder enviar a solicitação. Para obter informações sobre experiência de solicitação delegada, consulte [Experiência de solicitação delegada](https://servicenow-prod.fluidtopics.net/pIvFwxCizpaumxFjVlk4WQ "Você pode solicitar um item do catálogo em nome de outro usuário ou de vários usuários usando a variável Solicitado para."). |
   | Direção de escolha | A direção na qual a lista de seleção é organizada. * Nahorizontal: organiza as opções horizontalmente. * Para baixo: organiza as opções verticalmente. {#t_CreateAVariableForACatalogItem__ul_lpl_1bg_xdb} Este campo aparece para variáveis de múltipla escolha de pesquisa. Nota: A direção selecionada também é aplicável no Portal de serviços. |
   | Campo de opção | Campo de tabela para preencher opções para a variável. Se nenhuma opção for definida para um campo, a variável vai carregar valores distintos relacionados ao campo da tabela. Este campo aparece para variáveis de caixa de seleção. |
   | Tabela de opções | Tabela com valores a serem preenchidos no campo Opção. Este campo aparece para variáveis de caixa de seleção. |
   | Não selecione a primeira escolha | Caixa de seleção para deixar todas as opções da variável desmarcadas na página do item do catálogo. Se esta caixa de seleção estiver marcada, a primeira opção para a variável vai ser selecionada por padrão. Este campo aparece para variáveis de escala numérica e de múltipla escolha. |
   | Qualificador de referência dinâmico | Qualificador dinâmico. Selecione um filtro dinâmico para executar uma consulta no campo de referência. Este campo vai aparecer para variáveis de referência quando Usar qualificador de referência estiver definido como Dinâmico. |
   | Incluir nenhum | Caixa de seleção para incluir a opção Nenhum em uma lista de opções. Este campo aparece para variáveis de pesquisa de múltipla escolha, pesquisa de caixa de seleção, múltipla escolha e caixa de seleção. |
   | Layout | Layout para um contêiner, seja de uma ou duas colunas. Este campo aparece para variáveis de início de contêiner. |
   | Tabela de lista | Tabela com os valores do coletor de lista. A tabela deve ter uma coluna de exibição especificada. Este campo aparece para variáveis de coletor de lista. |
   | Pesquisa a partir de tabela | Tabela da qual os valores são obtidos para os usuários selecionarem. Os valores desta tabela são preenchidos no campo Valor de pesquisa. Este campo aparece para variáveis de pesquisa de múltipla escolha e pesquisa de caixa de seleção. |
   | Campo de valor de pesquisa | Campo na tabela de pesquisa que preenche as opções para a variável. Este campo aparece para variáveis de pesquisa de múltipla escolha e pesquisa de caixa de seleção. |
   | Campo(s) do rótulo de pesquisa | Lista separada por vírgulas de campos na tabela de pesquisa cujos valores são usados para exibir opções. Este campo aparece para variáveis de pesquisa de múltipla escolha e pesquisa de caixa de seleção. |
   | Campo de pesquisa de preço | Campo na tabela de pesquisa cujo valor é usado para modificar o preço do item que está sendo solicitado. Este campo aparece para variáveis de pesquisa de múltipla escolha e pesquisa de caixa de seleção. |
   | Campo de pesquisa de preço recorrente | Campo na tabela de pesquisa cujo valor é usado para modificar o preço recorrente do item que está sendo solicitado. Este campo aparece para variáveis de pesquisa de múltipla escolha e pesquisa de caixa de seleção. |
   | Macro | [Macro de IU](https://www.servicenow.com/docs/access?context=c_UIMacros&version=yokohama&pubname=yokohama-application-development&ft:locale=en-US) a ser inserida no item do catálogo. Este campo aparece para variáveis de macro, macro com rótulo e página de IU. |
   | Macro de resumo | Aplicável somente para variáveis do tipo Macro e Macro com rótulo. |
   | Widget | Aplicável somente para variáveis do tipo Macro e Macro com rótulo. |
   | Preço se verificado | Preço do item. Este campo aparece para variáveis de caixa de seleção. |
   | Preço recorrente se marcado | Preço que aumenta para o item, quando o usuário solicita mais de um pedido do item. Este campo aparece para variáveis de caixa de seleção. Para obter mais informações sobre preços e preços recorrentes, consulte [Como usar variáveis para configuração de preço](https://servicenow-prod.fluidtopics.net/DbS1qgdlFfEYLDMu6ZLbEQ#c_ServiceCatalogVariablePricing "Você pode definir um preço para cada item do Catálogo de serviços. O preço ou preço recorrente de um item do catálogo pode ser modificado com variáveis, aumentando o preço base desse item."). |
   | Referência | Tabela de referência para a variável. A tabela deve ter uma coluna de exibição especificada. Este campo aparece para variáveis de referência. |
   | Qual de referência | Qualificadores para restringir os dados disponíveis no campo. Compatível com qualificadores de referência e avançados. Para obter mais informações, consulte [Qualificadores de referência](https://www.servicenow.com/docs/access?context=c_ReferenceQualifiers&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US). Retorna todos os resultados correspondentes (sem máximo). Nota: Por motivos de segurança, o uso de scripts no campo Qual de referência é restrito aos administradores do sistema por meio da regra de negócios Permitir javascript no Valor padrão. Este campo aparece para variáveis de coletor de listas, pesquisa de múltipla escolha, referência e Solicitado para. Este campo vai aparecer para variáveis de referência quando Usar qualificador de referência estiver definido como Dinâmico. |
   | Condição de qualificador de referência | Opções para criar condições. Este campo vai aparecer para variáveis de referência quando Usar qualificador de referência estiver definido como Simples. |
   | Máximo de escala | Maior valor na escala de opções disponíveis para a variável. Este campo aparece para variáveis de escala numérica. |
   | Mínimo de escala | Menor valor na escala de opções disponíveis para a variável. Este campo aparece para variáveis de escala numérica. |
   | Somente valores exclusivos | Caixa de seleção para exigir um valor exclusivo para o campo. Quando esta caixa de seleção está marcada, dois registros não podem ter o mesmo valor para esse campo. Este campo aparece para variáveis de pesquisa de múltipla escolha, pesquisa de caixa de seleção e caixa de seleção. |
   | Confirmação de uso | Caixa de seleção para solicitar que os usuários insiram novamente os dados para verificar suas entradas. Este campo aparece para variáveis mascaradas. |
   | Usar criptografia | Caixa de seleção para armazenar a resposta em formato criptografado no banco de dados. Se não estiver criptografada, a resposta vai ser armazenada em formato de texto sem formatação. A criptografia usa DES triplo com criptografia do sistema. Este campo aparece para variáveis mascaradas. |
   | Use qualificador de referência | Tipo de qualificador a ser usado. Este campo aparece para variáveis de referência. |
   | Regex de Validação | Expressão regular que valida o valor da variável. Este campo é exibido somente para os tipos de variáveis Texto de linha única e Texto de linha única larga. Para definir expressões regulares, consulte [Definir uma expressão regular para uma variável](https://servicenow-prod.fluidtopics.net/ArFVLPfojaVxH3OYKub1GA "Defina uma expressão regular (regex) para validar um valor de variável."). Nota: * Este campo também é aplicável no Portal de serviços. * O valor do atributo max_length é válido mesmo quando o regex de validação está definido. * Não é possível adicionar um item do catálogo com erros de validação de regex à lista de desejos. {#t_CreateAVariableForACatalogItem__ul_f4q_lyg_xfb} |
   | Atributos variáveis | Atributos que definem o comportamento e as restrições de uma variável. Para obter informações sobre atributos de variável, consulte [Atributo de variável do catálogo de serviços](https://servicenow-prod.fluidtopics.net/q62KK~cQxXAQkCmq7u8X4g "Existem algumas variáveis do Catálogo de serviços que oferecem suporte a atributos específicos para definir o comportamento e as restrições das variáveis."). |
   | Bloco de tópicos | Especifique o bloco de tópico semelhante às macros de IU configuradas ou widgets usados nas variáveis personalizadas com ou sem rótulo para replicar o mesmo comportamento em uma conversa do Virtual Agent. Nota: Este campo está disponível somente para os tipos de variável "Personalizado" e "Personalizado com rótulo". |
   | Valor Padrão ||
   | Valor padrão | Valor padrão para a variável. |
   | Permissão Se nenhuma função for especificada nesta guia para as ações de leitura, gravação ou criação, todos os usuários que podem acessar o item do catálogo vão poder executar essas ações, independente de sua função. Por exemplo, se nenhuma função for especificada para o campo Funções de gravação, todos os usuários que podem acessar o item do catálogo vão poder editar o valor da variável no editor de variáveis. Um usuário com uma função que não corresponde a nenhuma das funções a seguir não pode definir valores de variáveis, mesmo por meio de scripts. Essas funções não estão disponíveis para variáveis de Rótulo, Quebra, Divisão de contêiner, Fim de contêiner, Macro, Macro com Rótulo e Página de IU. ||
   | Funções de leitura | Funções que podem visualizar a variável antes ou depois de solicitar o item do catálogo ou o produtor de registro. Somente um usuário com as funções especificadas neste campo pode exibir a variável. |
   | Funções de gravação | Funções que podem editar a variável no editor de variáveis depois de solicitar o item do catálogo ou o produtor de registro. Se um usuário não tiver as funções especificadas neste campo, a variável vai ser somente de leitura no editor de variáveis. |
   | Criar funções | Funções que podem criar valores para a variável antes ou depois de solicitar o item do catálogo ou o produtor de registro. Se um usuário não tiver a função especificada, a variável vai ser somente de leitura antes de solicitar o item do catálogo ou o produtor de registro. |
   | Disponibilidade ||
   | Visível em outro lugar | Se selecionada, a variável fica visível no formulário do item antes de solicitar o item, no VEditor após a solicitação do item e na exibição do carrinho do item. |
   | Visível em pacotes | Se selecionada, a variável fica visível quando o item é adicionado a um pacote. |
   | Visível em guias | Se selecionada, a variável fica visível quando adicionada a um guia de pedido ou quando adicionada a um item do catálogo que esteja incluído no guia de pedido. Nota: Se um guia de pedido tiver muitos itens e variáveis, considere desmarcar esta caixa de seleção no maior número possível de itens, para melhorar o desempenho de carregamento nos guias de pedido. |
   | Visível em sumários | Se selecionada, a variável fica visível em qualquer resumidor de variável do item do catálogo. No Portal de serviços, a variável está visível na página do tíquete de RITM e na página de Aprovação. Em Now Mobile, a variável está visível nos registros de RITM e de aprovação. |
   | Remover das interfaces conversacionais | Se o item do catálogo tiver uma variável que torna o item não conversacional, por exemplo, uma variável sobre preços, marque a caixa de seleção para que o item do catálogo se torne conversacional. Nota: Esta opção não se aplica a um conjunto de variáveis com várias linhas (MRVS). |
   [Tabela 1. Formulário variável]

   {#t_CreateAVariableForACatalogItem__table_k3f_2d4_2db}
6. Clique em Enviar.
* **[Definir informações de ajuda para uma variável do Catálogo de serviços](https://servicenow-prod.fluidtopics.net/Dmn_pxx6JVypGd8Ew~lpBA)**   
  Insira informações de ajuda para uma variável a fim de ajudar os usuários a determinar quais informações eles devem fornecer para uma variável do Catálogo de serviços.
* **[atributos de variável do Catálogo de serviços](https://servicenow-prod.fluidtopics.net/q62KK~cQxXAQkCmq7u8X4g)**   
  Existem algumas variáveis do Catálogo de serviços que oferecem suporte a atributos específicos para definir o comportamento e as restrições das variáveis.
* **[Defina uma opção de pergunta para uma variável](https://servicenow-prod.fluidtopics.net/clV3uHriHTzdQBuk1clO1w)**   
  Defina uma opção de pergunta para uma variável com Catálogo de serviços.