Para que serve

Perguntas condicionais deixam o formulário curto para quem não precisa delas e mais completo para quem precisa. Um exemplo: só perguntar "Há quanto tempo isso acontece?" para quem respondeu Sim no campo Ainda está acontecendo? (no canal, a pessoa lê Isso ainda está acontecendo?). Quem relata vê menos perguntas irrelevantes, e a equipe recebe o detalhe certo quando ele faz sentido.

Os formulários padrão do Canal de Denúncias não usam condições: todas as perguntas aparecem para todos. As condições são um recurso de configuração avançada, que você adiciona quando há um motivo claro.

Como funciona no canal

O canal mostra uma pergunta por vez e recalcula o percurso a cada resposta. O contador no topo (por exemplo, PERGUNTA 6 DE 8) considera só as perguntas visíveis naquele momento. Por isso, o total pode mudar quando a pessoa responde um gatilho.

Tela do canal no celular com a pergunta 6 de 8, Isso ainda está acontecendo?, com as opções Não sei informar, Sim e Não e a opção Sim selecionada.
Uma pergunta de seleção como esta pode servir de gatilho: a resposta Sim pode abrir uma pergunta complementar logo em seguida. Dados fictícios da organização de demonstração. Ampliar imagem

Se a pessoa voltar e mudar a resposta do gatilho, a pergunta complementar deixa de aparecer e a resposta dada a ela não é enviada. O servidor também recusa respostas de perguntas que deveriam estar ocultas, de modo que nada escondido chega à equipe por engano.

Na revisão final, só entram as perguntas visíveis. As opcionais que ficaram sem resposta aparecem em Perguntas sem resposta.

Tela de revisão do canal no celular com o título Está tudo como você quer contar?, os itens Como você se identifica (Sem identificação), Empresa, Assunto e O que aconteceu, cada um com o link Editar, e o botão Enviar meu relato.
A revisão lista apenas as perguntas que estavam visíveis no percurso da pessoa, cada uma com o link Editar. Dados fictícios da organização de demonstração. Ampliar imagem

Antes de começar

As condições são escritas na definição do tipo, em JSON. Na tabela de campos do tipo, cada rótulo mostra embaixo a chave do campo, que é o que a condição usa. O selo Condicional, na coluna Regras, marca os campos com condição de exibição (visible_if). A obrigatoriedade condicional (required_if) não ganha selo.

Tela do tipo Assédio moral com a tabela de campos da Revisão publicada 1, mostrando cada rótulo com a chave abaixo, como ongoing em Ainda está acontecendo? e frequency em Com que frequência acontece?, e o link Ver definição completa.
A tabela mostra a chave de cada campo, que é o que a condição usa. Os valores das opções ficam em Ver definição completa. Dados fictícios da organização de demonstração. Ampliar imagem

Uma condição tem um operador (op) e, conforme o caso, um campo (field) e um valor (value):

  • eq (igual) e neq (diferente): comparam com um valor. Em seleções, o valor é o value da opção, não o rótulo. Exemplo: {"op": "eq", "field": "ongoing", "value": "sim"}.
  • in: verdadeiro quando a resposta está em uma lista. Exemplo: {"op": "in", "field": "frequency", "value": ["algumas", "recorrente"]}.
  • exists: verdadeiro quando a pergunta tem resposta.
  • gt, gte, lt e lte: maior, maior ou igual, menor e menor ou igual. Só valem para campos de número inteiro, valor em dinheiro, data ou mês.
  • all, any e not: combinam outras condições, listadas em conditions (todas, qualquer uma, negação). Exemplo: {"op": "all", "conditions": [{"op": "eq", "field": "ongoing", "value": "sim"}, {"op": "eq", "field": "frequency", "value": "recorrente"}]}. O not recebe exatamente uma condição.

Cada campo pode ter dois tipos de condição: visible_if decide se a pergunta aparece; required_if decide se, aparecendo, ela passa a ser obrigatória.

Passo a passo

1

Defina a regra em uma frase, por exemplo: "se Ainda está acontecendo? for Sim, perguntar há quanto tempo". Anote a chave do gatilho (como ongoing), que aparece na tabela de campos, e o value da opção (como sim), que aparece em Ver definição completa.

2

Em Organização > Categorias e solicitações, abra o tipo e clique em Editar (abrir rascunho).

3

Clique em Editar JSON. No campo complementar, que deve vir depois do gatilho na lista de campos, acrescente "visible_if": {"op": "eq", "field": "ongoing", "value": "sim"}.

4

Se a complementar precisar de resposta quando aparecer, não use "required": true. Use "required_if" com a mesma condição.

5

Clique em Aplicar ao rascunho, depois em Salvar rascunho e em Validar.

6

Corrija os itens de Problemas encontrados, se houver. Os mais comuns são A condição usa um campo que não existe, A condição usa uma opção que não existe, Operador incompatível com o campo, Valor inválido na condição e Campo obrigatório não pode ficar oculto por condição.

7

Quando aparecer Rascunho válido para publicar., clique em Publicar e confirme em Publicar nova revisão.

8

No canal publicado, faça dois percursos com dados fictícios: um que abre a pergunta e outro que não abre. Depois, volte ao gatilho, mude a resposta e confira que a pergunta some.

Confira o resultado

Na tela do tipo, o campo complementar mostra o selo Condicional na coluna Regras. No canal, o contador de perguntas muda conforme a resposta do gatilho, e a revisão final mostra só o que estava visível.

Boas práticas

  • Condicione sempre a uma pergunta anterior. O canal segue a ordem do formulário: uma condição que depende de uma pergunta posterior deixa a complementar escondida no momento em que ela deveria aparecer.
  • Use como gatilho perguntas de seleção ou de sim ou não. Texto livre é imprevisível para condições.
  • Lembre-se de Não sei informar: decida se essa resposta deve abrir a complementar e teste esse caminho também.
  • Prefira poucas condições simples a uma árvore complexa. Cada condição a mais é um caminho a mais para testar.
  • Nunca esconda atrás de uma condição algo de que a equipe precisa sempre, como a descrição do fato.

Limites e cuidados

  • Uma condição pode ter até três níveis de combinação (Condição com mais de três níveis). O formulário aceita até 50 condições, contando cada parte de uma combinação, e até 100 campos.
  • Uma pergunta com required não pode ter visible_if. Use required_if.
  • Respostas de perguntas ocultas não são enviadas pelo canal nem aceitas pelo servidor.
  • A mudança vale para relatos novos. Relatos já abertos continuam na revisão em que foram registrados.
  • Não existe prévia do formulário fora do canal. O teste real é feito no canal publicado, e cada envio de teste vira um caso de verdade, que chega à equipe como qualquer relato.

Perguntas frequentes

O encaminhamento para a equipe alternativa é uma pergunta condicional?

Não. O campo O relato envolve alguém da equipe que recebe este canal? (no canal, O relato envolve alguém que recebe este canal?) aparece para todos. Quando a resposta é Sim, o caso é encaminhado à equipe alternativa configurada pela organização. Não transforme essa pergunta em condicional e não mude a chave involves_receivers nem o valor yes da opção Sim: o encaminhamento depende deles.

Tela do canal no celular com a pergunta 7 de 8, O relato envolve alguém que recebe este canal?, o aviso Opcional · pode pular se não souber, as opções Não sei informar, Sim e Não, com Não selecionada, e a dica Se sim, o caso vai direto para uma equipe alternativa e independente.
Esta pergunta aparece para todos. A dica abaixo das opções explica o que acontece quando a resposta é Sim. Dados fictícios da organização de demonstração. Ampliar imagem

Posso condicionar uma pergunta à forma de identificação?

Não. As condições só usam campos do próprio formulário. A identificação é tratada pelo canal, separada do formulário.

Precisa de ajuda?

Pesquise nesta central pelo nome da tela ou da tarefa. Se o problema continuar, entre com sua conta do Canal de Denúncias e abra um chamado em Meus chamados, informando a tela, o passo e a mensagem exibida.