Tipos de variáveis do Catálogo de serviços

Consulte as seções a seguir para obter mais detalhes sobre cada tipo de variável. Para obter detalhes sobre como criar uma variável, consulte Criar variável do Catálogo de serviços. Você também pode fornecer texto de ajuda para qualquer variável do Catálogo de serviços. Para obter informações sobre como definir informações de ajuda, consulte Definir informações de ajuda para uma variável do Catálogo de serviços.

Suporte em vários canais

As variáveis do Catálogo de serviços são compatíveis com vários canais. Para obter informações sobre a disponibilidade, consulte Suporte de variável em vários canais.

Anexo

Ao enviar uma solicitação de item do catálogo, esta variável permite carregar um anexo para uma pergunta do item. Depois de carregar o anexo, você também poderá baixar, atualizar e excluí-lo. Mesmo ao atender à solicitação, você pode baixar, atualizar e excluir o anexo em um item solicitado ou tarefa de catálogo. Você pode especificar restrições de tamanho e extensões de arquivo usando os atributos de variável max_file_size e allowed_extensions. Para obter informações sobre esses atributos de variável, consulte atributos de variável do Catálogo de serviços.

Importante:

Você deve especificar somente um valor inteiro para o seguinte:
- O atributo de variável max_file_size
- A propriedade do sistema glide.sc.variable.attachment.default_max_size (nível de catálogo). O valor padrão é 20.
Se o atributo de variável max_file_size não for especificado, o valor da propriedade do sistema glide.sc.variable.attachment.default_max_size será considerado como o limite máximo para o tamanho do arquivo de anexo.
Independentemente do tamanho do arquivo permitido na variável, o tamanho do arquivo de anexo não pode exceder o tamanho especificado na propriedade do sistema com.glide.attachment.max_size, que é aplicável para anexos em Now Platform.
A API g_form.setValue () é compatível com os scripts de cliente do catálogo.

Nota:

Quando você edita um anexo, o anexo existente é removido, e um novo anexo é carregado.

Quando você carrega um anexo para essa variável, uma entrada é criada na tabela Anexo [sys_attachment]. A variável não é atualizada até que você envie a solicitação do item, adicione-a ao carrinho ou salve o registro ao editá-lo (em fluxos de executante). Se você excluir ou atualizar o anexo antes de enviar o item do catálogo correspondente, a entrada na tabela Anexo [sys_attachment] será apagada.

O anexo carregado para essa variável é copiado nos seguintes cenários:

Em um guia de pedido, quando a variável é colocada em cascata para um item do catálogo na base de regra
Importante:
Os atributos de variáveis individuais não são aceitos para os itens do catálogo na base de regra. Por exemplo, vamos considerar que uma variável na seção Descrever necessidades permita um anexo .pdf e a variável de um item do catálogo na base de regra permita um anexo .txt. Quando você carrega um anexo do tipo .pdf para uma variável na seção Descrever necessidades, ele é inicialmente colocado em cascata para a variável no item do catálogo, e os atributos de variável especificados no item do catálogo não são respeitados. No entanto, se você excluir este anexo inicialmente em cascata de um item individual e tentar carregar um novo anexo, os atributos de variáveis individuais do item do catálogo serão respeitados.
Em um produtor de registro, quando a variável é mapeada para um campo da tabela de tarefas. Essa variável pode ser mapeada somente para o tipo de campo Anexo de arquivo de uma tabela de tarefas.

Importante:

Depois que um anexo é copiado, as mudanças nos anexos individuais são independentes. Por exemplo, qualquer mudança em um anexo no guia de pedido não afeta o mesmo anexo em cascata para o item do catálogo na base de regra.

Aviso:

Como os anexos são copiados, um tamanho maior pode levar a problemas de desempenho.

Se a verificação antivírus em todo o sistema estiver habilitada, ela será realizada no anexo quando você:

Enviar uma solicitação para o item do catálogo correspondente
Adicionar o item do catálogo ao carrinho ou à lista de desejos

Nota:

Esta variável não é compatível com um conjunto de variáveis com várias linhas.
Esta variável é compatível com fluxos e fluxos de trabalho.
Esta variável está disponível no construtor de condições
Para essa variável, a atribuição de variável de item não é compatível com o guia de pedido.

A variável de anexo — Figura 1. Variável de anexo

Interrupção

A variável de interrupção exibe uma linha horizontal no formulário. Essa linha é um elemento de formatação que não coleta dados.

Caixa de seleção

A variável da caixa de seleção permite habilitar e desabilitar opções marcando e desmarcando-as.

Para tornar uma caixa de seleção obrigatória, marque a opção Seleção necessária ao criar a variável. Por exemplo, use essa 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 será exibida para informar aos usuários que eles devem marcar a caixa de seleção.

Um grupo de variáveis de caixa de seleção é criado quando você cria variáveis de caixa de seleção consecutivas. Essas variáveis de caixa de seleção são classificadas por ordem no grupo. Se você quiser definir um rótulo personalizado para o grupo de caixas de seleção, crie uma variável de rótulo no início das variáveis de caixa de seleção consecutivas. O rótulo é considerado uma parte desse grupo e atua como um rótulo do grupo. Se não houver nenhum rótulo personalizado, as caixas de seleção serão agrupadas em um rótulo de Opções pela aplicação.

Em um grupo de variáveis de caixa de seleção:

Se alguma variável da caixa de seleção no grupo for obrigatória, o grupo inteiro se tornará obrigatório, independentemente da visibilidade da variável da caixa de seleção obrigatória. Um asterisco (*) é exibido ao lado do rótulo do grupo e você deve marcar pelo menos uma dessas caixas de seleção.
Ocultar o rótulo oculta o grupo inteiro.
Se todas as outras variáveis de caixa de seleção de um grupo de caixas de seleção obrigatórias estiverem ocultas e não selecionadas, os seguintes cenários serão aplicáveis:
- O grupo permanecerá obrigatório enquanto houver uma caixa de seleção no grupo que esteja visível e não selecionada.
- A última caixa de seleção desse grupo não poderá estar oculta se não estiver marcada.

No Portal de serviços, para tornar um grupo de variáveis de caixa de seleção obrigatório, defina pelo menos uma das variáveis de caixa de seleção como obrigatória. Ao definir o rótulo de um grupo de caixas de seleção, definir um rótulo obrigatório não torna o grupo de variáveis de caixa de seleção obrigatório.

No construtor de catálogo, os seguintes cenários são aplicáveis:

Se houver duas caixas de seleção consecutivas, um contêiner virtual será criado para um grupo de caixas de seleção. Somente tipos de variável da caixa de seleção podem ser adicionados dentro do grupo
Mesmo se uma variável da caixa de seleção for adicionada logo depois de um grupo de caixas de seleção, ela será adicionada automaticamente ao grupo.

Na guia Especificações de tipo, você pode especificar o preço em diferentes tipos de moeda. Além disso, você pode configurar o preço nos seguintes modelos de precificação:

Calculados
Corrigidos
Múltiplos

Para obter informações sobre os modelos de precificação, consulte Campos de preços.

Uma variável de caixa de seleção — Figura 3. Exemplo: variável da caixa de seleção

Para obter mais informações sobre a variável da caixa de seleção, assista ao vídeo a seguir:

Início, divisão e término de contêiner

O início do contêiner, a divisão do contêiner e as variáveis de término do contêiner definem um layout para um contêiner que pode conter mais variáveis. Use as variáveis de início e término do contêiner para definir os pontos de início e término de um layout de contêiner. O término do contêiner deve ser usado junto com o início do contêiner para fechar um contêiner.

Um layout de contêiner pode ser dividido em duas ou três colunas usando a variável de divisão de contêiner. Por padrão, a divisão é calculada na marca de 50%.

Um contêiner é semelhante a um conjunto de variáveis. Ao contrário de um conjunto de variáveis, os contêineres podem ser usados em qualquer lugar, inclusive dentro de um conjunto de variáveis. Os contêineres também podem ser aninhados.

Para obter mais ajuda na seleção do tipo de contêiner apropriado, consulte o artigo Determinar se você está usando a variável de contêiner correta [KB0539982] na Base de conhecimento HI.

Nota:

As variáveis de contêiner ainda não são compatíveis com dispositivos móveis.
O início do contêiner, a divisão do contêiner e as variáveis de término do contêiner são compatíveis com o Portal de serviços. No entanto, se as configurações forem feitas no contêiner de nível superior, um máximo de layouts de duas colunas poderá ser atingido.
Os conjuntos de variáveis também são considerados contêineres. Portanto, uma variável de início de contêiner com um layout de duas colunas em um conjunto de variáveis não é compatível com o Portal de serviços.

Para reproduzir o contêiner mostrado na figura a seguir, insira as seguintes configurações ao criar uma variável de início de contêiner:

Selecione um Layout com 2 colunas de largura, lados alternados.
Marque a caixa de seleção Exibir título para usar uma barra de título recolhível.

Um contêiner de variável — Figura 4. Exemplo: variável de contêiner

Data

A variável de data cria um widget com um campo e calendário para selecionar uma data.

Data e hora

A variável de data e hora cria um widget com um calendário e campos para selecionar uma data e hora. O valor de hora é armazenado no Horário de Greenwich (GMT) e exibido no seu fuso horário.

Duração

Use a variável de duração para especificar a duração pela qual um item do catálogo está disponível.

Para obter os atributos compatíveis com essa variável, consulte atributos de variáveis.

Nota:

Insira a duração no formato DD HH: MM: SS ao definir o valor padrão da variável e especificar nas funções g_form.getValue() e g_form.setValue().

A variável de duração — Figura 7. Exemplo: variável de duração

E-mail

A variável de e-mail cria um widget para inserir e selecionar um endereço de e-mail. A variável aceita somente expressões de e-mail válidas que contenham @ e informações de domínio.

Nota:

A validação de variável não é compatível com o Portal de serviços.

Uma variável de e-mail — Figura 8. Exemplo: variável de e-mail

HTML

A variável HTML permite fornecer conteúdo com formatação avançada, incluindo imagens, para um item do catálogo.

Use a variável para criar campos para entrada do usuário. Você também pode usar a variável para conteúdo reutilizável quando colocada em um conjunto de variáveis, como termos e condições.

A variável está disponível em dois modos: edição e somente leitura. No modo de edição, uma barra de ferramentas está disponível e os links não funcionam. No modo somente leitura, a barra de ferramentas está desabilitada e os links funcionam. Para alternar entre os modos, use os direitos ou crie uma política de IU para definir o campo HTML como modo somente leitura.

Nota:

Variáveis HTML não são compatíveis para exibição no resumo do carrinho de compras ou nas telas de resumo de aprovação.

Uma variável HTML — Figura 9. Exemplo: variável HTML

Endereço IP

Use a variável de endereço IP para especificar os dados IPv4 e IPv6 para um item do catálogo. No submódulo Scripts de validação, um tipo de script de validação associado a essa variável está disponível.

Nota:

A validação de variável não é compatível com o Portal de serviços.
Quando você define o valor padrão para a variável Endereço IP ou especifica seu valor nas funções g_form.getValue () e g_form.setValue (), o delimitador é (.).

Captura de tela da variável de endereço IP — Figura 10. Exemplo: variável de endereço IP

Rótulo

A variável de rótulo exibe um rótulo no formulário. Rótulos são elementos de formatação. Nenhum dado é coletado.

Você pode usar rótulos para organizar as perguntas em seções. Você também pode usar rótulos para perguntas com várias opções. Por exemplo, rotule as caixas de seleção das diferentes opções de uma pergunta.

Você não pode definir uma variável de rótulo como obrigatória. No entanto, você pode tornar obrigatório um grupo de variáveis de caixa de seleção precedidas por uma variável Rótulo.

Coletor de listas

A variável do coletor de listas cria uma interface que permite selecionar e adicionar vários registros de uma tabela. Para obter os atributos compatíveis com essa variável, consulte atributos de variáveis.

Para obter mais informações sobre como usar a variável do coletor de listas, assista a este vídeo:

Nota:

O qualificador de referência e o atributo glide_list se aplicam somente a versões de Helsinki em diante. O atributo não se aplica a Geneva.
Você pode definir um valor para essa variável usando a função g_form.setValue () em um script do cliente do catálogo.
Quando o atributo glide_list não é verdadeiro, você só pode definir o valor que está visível na lista Disponível usando a função g_form.setValue (). Essa funcionalidade não é aplicável quando a função setValue () é chamada onLoad.
Tabela com dados grandes causa problemas de desempenho ao carregar a página. Use qualificadores de referência para reduzir dados ou use o atributo glide_list.
Os valores na tabela referenciada não aparecerão se o usuário não estiver conectado.
O coletor de lista exibe no máximo 100 itens em uma lista. Depois de mover itens para a lista Selecionado, você poderá clicar em Executar filtro para atualizar a lista Disponível. Esta ação adicionará mais itens disponíveis à lista, até um máximo de 100 itens.

Múltipla Escolha de Pesquisa

A variável de múltipla escolha de pesquisa cria botões de opção usando dados de uma tabela. Sua funcionalidade é semelhante à variável da caixa de seleção de pesquisa, que cria uma lista de seleção a partir dos dados consultados. Para obter os atributos compatíveis com essa variável, consulte atributos de variáveis.

Nota:

Tabela com dados grandes causa problemas de desempenho ao carregar a página. Use qualificadores de referência para reduzir dados ou use a variável de tipo de referência.
Você não pode adicionar mais de 10.000 opções.

Uma variável de múltipla escolha de pesquisa — Figura 13. Exemplo: variável de pesquisa de múltipla escolha

Caixa de seleção de pesquisa

A variável da caixa de seleção de pesquisa cria uma lista de seleção usando dados consultados de uma tabela. Sua funcionalidade é semelhante à variável de múltipla escolha de pesquisa, que cria botões de opção a partir dos dados consultados. Para obter os atributos compatíveis com essa variável, consulte atributos de variáveis.

Para criar a caixa de seleção de pesquisa mostrada na figura a seguir, insira os seguintes valores ao criar a variável:

Pesquisa da tabela: Incidente [incidente]
Campo de valor de pesquisa: Sys ID
Campo de rótulo de pesquisa: número, categoria, prioridade
qual de referência: caller_id=javascript:gs.getUserID()^active=true

Nota:

Tabela com dados grandes causa problemas de desempenho ao carregar a página. Use qualificadores de referência para reduzir dados ou use a variável de tipo de referência.
Você não pode adicionar mais de 10.000 opções.

Personalizado

Essa variável insere uma macro de IU no item do catálogo.

As macros de IU no Catálogo de serviços não são compatíveis com as seguintes funções glide_list: clique de referência, edição de slushbucket e campo de e-mail.

Use a fase um do Jelly apenas para macros de IU adicionadas como variáveis. O Jelly fase dois na macro não é processado e aparece na página como conteúdo padrão.
Esta variável ainda não é compatível com dispositivos móveis clássicos.
Esta variável é compatível com o Portal de serviços por meio de widgets. Crie um widget com a mesma funcionalidade de uma macro e vincule o widget à variável.

Uma variável personalizada — Figura 14. Exemplo: variável personalizada

Personalizado com rótulo

Esta variável insere uma macro de IU com um rótulo.

Esta variável ainda não é compatível com dispositivos móveis clássicos.
Esta variável é compatível com o Portal de serviços por meio de widgets. Crie um widget com a mesma funcionalidade de uma macro e o vincule à variável.

Uma variável personalizada com rótulo — Figura 15. Exemplo: variável personalizada com rótulo

Mascarado

A variável mascarada insere um campo que mascara o texto inserido. Cada caractere inserido é exibido como um asterisco (*). Use essa variável para solicitar aos usuários dados confidenciais, como senhas.

Ao marcar a caixa de seleção Usar criptografia, você pode configurar a variável para criptografar seu valor usando vários algoritmos de criptografia antes de armazenar no banco de dados. Esses valores só podem ser descriptografados usando now_GR.variables.var_name.getDecryptedValue() em RITM, tarefa de catálogo ou qualquer registro de extensão da tarefa criado usando um produtor de registro.

Nota:

Por padrão, o campo Usar criptografia é definido como verdadeiro para garantir o armazenamento seguro das informações.

No editor de variáveis, você também pode descriptografar e criptografar os valores de uma variável mascarada usando os botões Mostrar e Ocultar. Esses botões não estão disponíveis para um executante (itil) sem a função catalog_view_masked. Você só pode exibir o valor que especificou ao solicitar.

Tabela 1. Ações em uma variável criptografada
Ação	Funções
Ação	Solicitante	Executante com a função catalog_view_masked	Executante sem a função catalog_view_masked
Exibir ou ocultar o valor criptografado em formulários de catálogo	Sim	Não aplicável	Não aplicável
Editar o valor criptografado em formulários de catálogo	Sim	Não aplicável	Não aplicável
Exibir ou ocultar o valor criptografado no editor de variáveis	Sim	Sim	Não
Editar o valor criptografado no editor de variáveis	Sim Nota: Se a variável mascarada for somente leitura no editor de variáveis, o valor da variável não será editável	Sim Nota: Se a variável mascarada for somente leitura no editor de variáveis, o valor da variável não será editável	Não

Texto de várias linhas

A variável de texto de várias linhas cria um campo que permite inserir várias linhas de texto.

Múltipla escolha

A variável de múltipla escolha cria botões de opção para opções de pergunta.

Escala numérica

A variável de escala numérica cria um conjunto de botões de opção para um intervalo de opções, como uma escala Likert.

Referência

Uma variável de referência faz referência a um registro em outra tabela. Por exemplo, uma variável chamada point_of_contact faz referência à tabela Usuário [sys_user]. Para obter os atributos compatíveis com essa variável, consulte atributos de variáveis.

Lembre-se das seguintes informações ao criar uma variável de referência:

As variáveis de referência usam o recurso de preenchimento automático. Para garantir que os usuários tenham informações suficientes para fazer a seleção, configure a lista de pesquisa de referência.
Variáveis de referência armazenam o sys_id do registro selecionado (como campos de referência). Para usar o valor de exibição em um script, use os mesmos métodos usados para um campo de referência.

current.variables.<variable name>.getDisplayValue()

Uma variável de referência — Figura 20. Exemplo: variável de referência

Solicitado para

Antes de enviar uma solicitação de item do catálogo, esta variável ajuda a especificar para quem essa solicitação pode ser enviada. Você deve especificar essas informações ao responder às perguntas de item do catálogo.

Importante:

Você só pode especificar usuários da tabela Usuário [sys_user].
Se você não especificar o valor padrão para essa variável, o usuário conectado no momento que está solicitando o item será considerado como o valor da variável Solicitado para padrão.
Você pode enviar a solicitação de um usuário com base no acesso a um item do catálogo. O campo Tipo de acesso do item de catálogo pode ser usado para especificar se uma solicitação pode ser enviada para um usuário que não tem acesso ao item do catálogo.
Para essa variável, a atribuição de variável de item não é compatível com a base de regra de um guia de pedido. Se o guia de pedido contiver a variável Solicitado para, o valor será colocado em cascata para a variável equivalente de itens na base de regra como somente leitura.

Usando o campo Habilitar também solicitação para da variável Solicitado para, você pode solicitar um item do catálogo para diferentes usuários em uma solicitação.

Para obter informações sobre experiência de solicitação delegada, consulte Experiência de solicitação delegada.

Importante:

Você pode adicionar essa variável a um item do catálogo ou conjunto de variáveis. No entanto, ao enviar a solicitação, um item do catálogo pode ter apenas uma variável Solicitado para.
Você pode adicionar apenas uma variável Solicitado para a um conjunto de variáveis.
Essa variável não é compatível com um conjunto de variáveis com várias linhas.
Depois que a solicitação é enviada, o valor dessa variável fica visível no editor de variáveis e no consolidador de variáveis.

Captura de tela da variável Solicitado para — Figura 21. Variável Solicitado para

Rótulo de Rich Text

Esta variável exibe um rótulo formatado em um formulário de item do catálogo. No editor de rich text TinyMCE, você pode formatar o rótulo e adicionar imagens ou links. Esta variável oferece suporte aos marcadores HTML.

Nota:

Você pode tornar essa variável visível usando scripts de cliente de catálogo e políticas de IU de catálogo.
Você não pode colocar em cascata essa variável em um guia de pedido.
Você não pode definir essa variável como obrigatória.
No Automated Test Framework, essa variável só tem suporte na etapa de validação do estado de variável para verificar a visibilidade.
Esta variável não é compatível com o seguinte:
- Consolidador de variáveis
- Conjunto de variáveis com várias linhas
- Construtores de condição e relatórios
Você não pode especificar o seguinte para essa variável:
- Texto de ajuda e instruções
- Dica da ferramenta
- Permissões
- Largura da variável
- Texto de exemplo
As APIs g_form.setValue(), g_form.setReadOnly() e g_form.setMandatory() não são compatíveis com os scripts de cliente do catálogo. Somente a API g_form.setVisible() é compatível.

A variável do rótulo de Rich Text — Figura 22. Variável do rótulo de Rich Text

Caixa de seleção

A variável da caixa de seleção cria uma lista de opções de perguntas predefinidas. Para obter os atributos compatíveis com essa variável, consulte atributos de variáveis.

Texto de linha única

A variável de texto de linha única cria um campo para inserir uma única linha de texto. Para obter os atributos compatíveis com essa variável, consulte atributos de variáveis.

Página de IU

A variável de página IU insere uma página de IU no item do catálogo.

Use Jelly fase um somente para macros de IU adicionadas como variáveis. O Jelly fase dois na macro não é processado e aparece na página como conteúdo padrão.
Essa variável ainda não é compatível com dispositivos móveis clássicos e no Portal de serviços.

URL

A variável URL cria um widget para os usuários inserirem URLs. Os URLs são validados para os seguintes protocolos: HTTP, HTTPS, FTP.

Nota:

A validação de variável não é compatível com o Portal de serviços.
Essa variável não é editável no Now Mobile.

Uma variável de URL — Figura 25. Exemplo: variável URL

Texto de linha única larga

A variável de texto de linha única larga cria um campo que abrange o formulário, permitindo que os usuários insiram linhas de texto mais longas. Para obter os atributos compatíveis com essa variável, consulte atributos de variáveis.

Sim/Não

A variável Sim ou Não cria uma lista de seleção com as opções Sim e Não.

Uma variável Sim ou Não — Figura 27. Exemplo: variável Sim ou Não