DocumentaciónAjuda

Desenhar o formulário de um item

Monte as perguntas que o solicitante responde ao pedir um item, faça algumas aparecerem só quando se aplicam e teste-o antes de publicá-lo.

Nesta página

O formulário de um item são as perguntas de que a mesa precisa para atender o pedido de primeira: qual equipamento, para quem, a partir de quando. Você o monta campo a campo e o testa na Pré-visualização exatamente como o solicitante o verá.

Antes de começar

  • Você precisa do nível Administrar em Catálogo de serviços para alterar e salvar o formulário. Com o nível Ver, você pode abri-lo e testá-lo, mas não salvá-lo.

  • O item pode ser novo ou já existente. Veja Criar um item do catálogo.

Adicionar um campo

  1. Entre em Catálogo, aba Itens, e abra o item (ou pressione Novo item).

  2. Na parte Formulário, escolha o tipo na lista ao lado do botão Campo.

  3. Pressione Campo. O campo é adicionado no final, já aberto, com o nome do tipo como rótulo.

  4. Preencha a configuração (veja a tabela abaixo).

  5. Repita para cada pergunta. Um formulário aceita até 50 campos.

  6. Pressione Salvar no canto superior direito.

Cada campo aparece como uma linha com o rótulo, o tipo e, se for o caso, obrigatório. Pressione o rótulo para abrir ou fechar a configuração. Com ↑ e ↓, você muda a ordem em que as perguntas são feitas e, com o ícone da lixeira, remove o campo.

Tipos de campo

Tipo

O que pede ao solicitante

Configuração própria

Texto curto

Uma linha de texto, como um número de série ou o nome de uma pasta

Ajuda, Comprimento máximo

Texto longo

Um texto de várias linhas, como uma justificativa

Ajuda, Comprimento máximo

Número

Uma quantidade, como o número de licenças

Ajuda, Valor máximo

Data

Um dia do calendário, como a data de admissão

Ajuda

E-mail

Um endereço de e-mail válido

Ajuda

Lista suspensa

Escolher uma opção de uma lista

Opções

Opção única

Escolher uma opção, mostrando todas à vista

Opções

Seleção múltipla

Marcar uma ou várias opções

Opções

Caixa de seleção

Marcar sim ou não, como «Aceito as condições de uso»

—

Pessoa

Indicar alguém da empresa, como quem vai receber o equipamento

Pessoas

Anexos

Enviar arquivos, como um orçamento ou um formulário assinado

Máximo de arquivos

Configuração de cada campo

Todos os campos têm:

  • Rótulo: a pergunta que o solicitante lê, até 120 caracteres. Obrigatório.

  • Id: o nome interno do campo. É usado em Mostrar se e nos fluxos para ler a resposta. Ao adicionar o campo, ele é criado a partir do nome do tipo (por exemplo, texto_corto) e não muda quando você edita o rótulo: troque-o por um que se entenda, como tipo, se você for usá-lo em condições. Use minúsculas, comece com uma letra e use só letras, números e _ (até 40 caracteres), sem repetir o de outro campo.

  • Tipo: você pode mudá-lo depois. O rótulo, o id e se é obrigatório são mantidos; entre Lista suspensa, Opção única e Seleção múltipla, as opções também são mantidas.

  • Obrigatório: o solicitante não pode enviar o pedido sem respondê-lo. No portal, ele é marcado com um asterisco (*). Em uma Caixa de seleção obrigatória, o solicitante deve marcá-la.

  • Mostrar se (opcional): uma condição para que o campo apareça só em alguns casos. Veja Mostrar um campo só quando se aplica.

E, conforme o tipo:

  • Ajuda: um texto breve abaixo do campo, até 200 caracteres. Disponível em Texto curto, Texto longo, Número, Data e E-mail.

  • Comprimento máximo: quantos caracteres ele aceita. Se ficar vazio, o limite é 500 em Texto curto e 5.000 em Texto longo.

  • Valor máximo: o número mais alto que um Número aceita.

  • Opções (uma por linha: valor | texto): cada linha é uma opção. À esquerda da barra fica o valor (o que o Elion ITSM guarda e o que você usa nas condições) e, à direita, o texto que o solicitante vê. Se você escrever só o texto, o valor é criado sozinho. Até 100 opções.

  • Pessoas: Toda a empresa permite escolher qualquer pessoa ativa; O departamento da pessoa, só alguém do mesmo departamento de quem pede.

  • Máximo de arquivos: de 1 a 10 por campo. Vem em 3.

Um exemplo de Opções para um campo «Tipo de equipamento»:

notebook | Notebook
pc | Computador de mesa
monitor | Monitor adicional

Escolha valores curtos e estáveis (notebook, pc) e mude o texto à vontade. Se você mudar um valor, as condições e os fluxos que o usam deixam de corresponder.

Mostrar um campo só quando se aplica

Mostrar se (opcional) faz um campo aparecer só se uma condição sobre as outras respostas for atendida. Por exemplo, perguntar «Você precisa de docking?» só quando o tipo de equipamento for notebook.

A condição não é código: ela usa um conjunto fechado de operadores e o Elion ITSM a verifica enquanto você escreve:

Para

Escreva

Ler uma resposta

form. seguido do Id do campo: form.tipo

Comparar

== (igual), != (diferente), <, <=, >, >=

Ver se está em uma lista

in: form.tipo in ['notebook', 'pc']

Ver se uma seleção múltipla inclui uma opção

contains: form.software contains 'office'

Combinar

&& (e), `

Valores

textos entre aspas simples ('notebook'), números (500000), true, false e null (vazio)

Exemplos:

form.tipo == 'notebook'
form.tipo in ['notebook', 'pc'] && form.reemplazo == true
form.cantidad > 5
form.fecha_ingreso >= '2026-11-01'

Regras para que funcione:

  • Nas listas e opções, a comparação é feita com o valor, não com o texto: form.tipo == 'notebook', não 'Notebook'.

  • Um Número é comparado com números sem aspas (form.cantidad > 5); um texto, com aspas. Um número entre aspas não é igual a um número.

  • Uma Caixa de seleção marcada vale true: form.acepta == true.

  • As datas são comparadas como texto no formato AAAA-MM-DD.

  • Ela só pode usar outros campos deste formulário (não o próprio campo), em até 500 caracteres.

  • Se a condição não for atendida, o campo não aparece e a resposta dele não é pedida, mesmo que seja Obrigatório.

  • Um campo oculto conta como vazio para as condições dos demais. Se «Tipo de equipamento» for ocultado, o que dependia dele também é ocultado.

Se a condição tiver um erro, você o vê em vermelho abaixo do campo, por exemplo Texto não fechado. ou usa form.modelo, que não é um campo deste formulário.

Se você mudar o Id de um campo, as condições de outros campos que o usavam ficam com erro e você não consegue salvar até corrigi-las. Os fluxos que leem essa resposta também deixam de encontrá-la.

Testar o formulário

A parte Pré-visualização mostra o formulário exatamente como o solicitante o verá, com a Descrição curta no alto. Ela se atualiza enquanto você edita e aplica as condições de Mostrar se: responda às perguntas e veja como os campos aparecem e desaparecem.

  1. Responda na Pré-visualização como um solicitante faria.

  2. Pressione Validar. O Elion ITSM verifica suas respostas e marca em vermelho os erros de cada campo, como Obrigatório., E-mail inválido. ou Máximo 5. Se estiver tudo certo, você verá As respostas de teste são válidas.

  3. Se o item já estiver salvo, pressione Testar no servidor. É a mesma verificação feita quando alguém envia o pedido de verdade. Se estiver tudo certo, você verá O servidor aceitou as respostas de teste.

Testar no servidor verifica as respostas em relação ao formulário salvo. Se você mudou campos, pressione Salvar antes de testar. Em um item novo, o botão só aparece depois que você o salva.

Na pré-visualização, Pessoa e Anexos são simulados: você digita um texto em vez de procurar a pessoa ou enviar um arquivo. Por isso, ao testar no servidor, deixe-os vazios (se forem obrigatórios, o servidor os marcará com Obrigatório; é o esperado). Para testá-los de verdade, peça o item pelo portal com um usuário de teste. Veja Pedir algo do catálogo.

Um campo Pessoa com O departamento da pessoa é testado com o seu próprio departamento, como se você fosse quem pede.

O que acontece depois

  • Toda vez que você salva uma alteração no formulário, sobe a Versão do formulário que você vê abaixo do nome do item. As alterações nos outros dados do item não mudam a versão.

  • Os pedidos novos usam a versão vigente. Cada solicitação já criada guarda a versão com que foi respondida: na ficha do ticket, o bloco Pedido do catálogo mostra as perguntas e respostas dessa versão, mesmo que depois você tenha mudado o formulário.

  • No ticket, a descrição traz cada pergunta com sua resposta (as opções com o texto, as caixas de seleção como Sim ou Não).

Se algo não funcionar

Abaixo do formulário aparece um quadro amarelo com o que impede salvar. Enquanto ele estiver lá, ao pressionar Salvar você verá Corrija o formulário antes de salvar. Os avisos mais comuns:

  • falta o rótulo.: escreva o Rótulo do campo.

  • o id deve estar em minúsculas, começar com letra e usar apenas letras, números e _. ou o id “…” está repetido.: corrija o Id.

  • adicione pelo menos uma opção., há opções com o mesmo valor. ou cada opção precisa de valor e texto.: revise as Opções.

  • entre 1 e 10 arquivos. ou o máximo deve ser positivo.: corrija Máximo de arquivos, Comprimento máximo ou Valor máximo.

  • “Mostrar se” de “…”: seguido do problema: corrija a condição desse campo.

Ao testar no servidor, a mensagem Campo desconhecido abaixo de um campo significa que esse campo ainda não foi salvo: pressione Salvar e teste de novo.

Relacionado

Pesquisar em Elion ITSM

Digite pelo menos 2 letras para pesquisar em Elion ITSM.

↑↓ navegar · Enter abrir · Esc fechar