Criar variáveis de fluxo de Catálogo de serviços

Crie variáveis de Catálogo de serviços que ficarão disponíveis somente para um fluxo Catálogo de serviços específico. Variáveis específicas de fluxo estão disponíveis para catalogar tarefas e ações no fluxo.

Antes de Iniciar

Função necessária: flow_designer ou administrador

Por Que e Quando Desempenhar Esta Tarefa

As variáveis de fluxo de Catálogo de serviços são exibidas no campo Variáveis do catálogo das ações Criar tarefa do catálogo e Obter variáveis do catálogo. Elas são exibidas no formato Flow:variablename e só estão disponíveis para o fluxo no qual foram definidos.

Para obter mais informações sobre como ações de Catálogo de serviços, consulte Ação Criar tarefa de catálogo e Ação Obter variáveis do catálogo.

Procedimento

1. Abra ou crie um fluxo com um gatilho de Catálogo de serviços.
2. Clique no e selecione Gerenciar variáveis do catálogo de fluxo.
   A tabela Variáveis do catálogo de fluxo será aberta.
3. Clique em Novo para adicionar uma nova variável disponível ao fluxo.
4. Preencha o formulário.

   Tabela 1. Formulário variável

   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.
   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 ServiceNow AI Platform, Portal de serviços e no editor de variáveis em Espaço do agente.
   Desabilitar preenchimento de slot inicial	Caixa de seleção para determinar se o uso de pares de chave-valor fornecidos pelo solicitante deve ser ativado para preencher previamente os formulários de item do catálogo.
   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
   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 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.
   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.
   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 ServiceNow AI 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 ServiceNow AI 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. 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 junto 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. Para obter informações sobre experiência de solicitação delegada, consulte Delegated request experience.
   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. 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 Delegated request experience.
   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. 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.
   Origem da pesquisa	A origem da pesquisa. Selecione Tabela ou Opções . Tabela é selecionada por padrão.
   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 pesquisar variáveis de múltipla escolha e de caixa de seleção de pesquisa e quando um Tabela a origem da pesquisa está selecionada.
   Campo de valor de pesquisa	Campo na tabela de pesquisa que preenche as opções para a variável. Este campo aparece para pesquisar variáveis de múltipla escolha e de caixa de seleção de pesquisa e quando um Tabela a origem da pesquisa está selecionada.
   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 pesquisar variáveis de múltipla escolha e de caixa de seleção de pesquisa e quando um Tabela a origem da pesquisa está selecionada.
   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 pesquisar variáveis de múltipla escolha e de caixa de seleção de pesquisa e quando um Tabela a origem da pesquisa está selecionada.
   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 pesquisar variáveis de múltipla escolha e de caixa de seleção de pesquisa e quando um Tabela a origem da pesquisa está selecionada.
   Tabela de opções	Use este campo para especificar a tabela que contém a lista de seleção desejada. Só está ativo quando Origem da pesquisa está definido como Opções . O sistema consulta a tabela de seleção central (sys_choice) para todas as listas de seleção associadas à tabela selecionada aqui.
   Campo de opção	Use este campo para selecionar o campo específico (ou "Elemento") na tabela de seleção cujas opções você deseja exibir. Por exemplo, se sua tabela de seleção for Incidente [incidente], você poderá selecionar Prioridade , Estado ou Categoria campo para exibir as opções definidas para ele.
   A escolha depende de	Selecione outra variável do mesmo item do catálogo para tornar as escolhas dessa variável dependentes dela. Isso cria um efeito de filtragem dinâmico. As opções mostradas na variável atual serão filtradas em tempo real com base no valor selecionado pelo usuário na variável especificada aqui. Por exemplo, se este campo for para "Cidade", você poderá selecionar uma variável "País" aqui, garantindo que somente as cidades relevantes sejam mostradas com base no país selecionado.
   Macro	Macro de IU 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.
   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. 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 coletor de listas, pesquisa múltipla escolha, caixa de seleção de pesquisa, referência e. Solicitado para variáveis. 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 Define a regular expression for a variable. 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.
   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.
   Bloco de tópicos	Especifique o bloco de tópico semelhante às macros de IU configuradas ou widgets usados nas variáveis personalizadas ou personalizadas com rótulo para replicar o mesmo comportamento em um Virtual Agent conversa. Nota: Este campo está disponível somente para os tipos de variáveis "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 de interfaces conversacionais	Se o item do catálogo tiver uma variável que esteja tornando o item não conversacional, por exemplo, uma variável sobre preço, 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 de várias linhas (MRVS).

5. Clique em Enviar.

Resultado

Acesse a variável no fluxo adicionando uma ação Criar tarefa de catálogo ou Obter variáveis de catálogo.