Formulários de self-service

Os Formulários de Self Service do RealmJoin recolhem dados estruturados dos utilizadores, como relatórios de incidentes ou pedidos de alteração, depois de ativados pelo Support.

Visão geral

Você pode usar Formulários de Autoatendimento para coletar dados estruturados dos utilizadores. Isso pode ser usado para permitir que os utilizadores relatem incidentes ou indiquem alterações, como a necessidade de uma nova configuração de posto de trabalho em um Office.

"Self Service Forms" é um recurso opcional que pode ser ativado para o seu Tenant pelo suporte do RealmJoin. Se não estiver ativado, você ainda pode inserir/preparar formulários na página de configurações, mas os utilizadores não poderão ver/usar formulários de autoatendimento.

Usaremos um fluxo de trabalho para "indicar um novo animal de estimação" como exemplo.

Exemplo de Formulário

Usando Formulários

Usando o item de navegação, os utilizadores podem selecionar um formulário para preencher e enviar.

Seletor de Formulário

Quando um utilizador preenche e envia um formulário, o seu conteúdo será enviado por e-mail para o destinatário indicado na definição do formulário. O e-mail será enviado pela infraestrutura do RealmJoin e não terá origem nos endereços de e-mail da sua empresa.

E-mail de exemplo de um formulário

Quando os Formulários de Autoatendimento estão ativados para o seu Tenant, todos os utilizadores podem usar / enviar formulários.

Revisar Submissões

Usando o ícone de navegação, você pode revisar submissões anteriores de formulários dos seus utilizadores.

Lista de Submissões

Você pode pesquisar submissões enviando o nome de utilizador e o nome do formulário, mas não pelos campos da submissão do formulário.

Clique em "Ver" para ver os dados do formulário preenchido. A visualização é apenas para leitura.

Página de Configurações

A página de configurações dos Formulários de Autoatendimento permite gerir formulários existentes, adicionar, editar e eliminar formulários.

Lista de Formulários na Página de Configurações

Lista de Formulários

Use "Novo Formulário" ou "Editar" para descrever o formulário usando JSON Schema. Isso define quais campos precisam ser preenchidos e quais valores são válidos. A interface oferece um editor de verificação de sintaxe e uma pré-visualização do formulário resultante.

O esquema será usado para criar dinamicamente um formulário para o utilizador. Basicamente, use o esquema não apenas para descrever os dados desejados, mas também para criar implicitamente a interface do formulário.

Editor de Esquema

Acima do editor há dois campos. Use o campo da esquerda para dar ao seu formulário um nome descritivo. Use o campo da direita para nomear o endereço de e-mail do destinatário dos dados enviados pelo utilizador.

Exemplo do Editor de Esquema

Você pode usar "Atualizar Pré-visualização do Formulário JSON" para criar uma pré-visualização do formulário resultante abaixo do editor.

Pré-visualização do Editor

Após modificar o esquema, pressione "Submeter" para salvar as suas alterações. Será exibido um erro se a verificação de sintaxe falhar.

JSON Schema

O uso de JSON Schema está fora do escopo deste documento. Você pode usar geradores de esquemas online (como este) para simplificar o processo.

Para dar pelo menos um ponto de partida, vamos examinar o esquema do nosso exemplo

{
  "title": "Pessoa",
  "type": "object",
  "required": [
    "name",
    "date",
    "location",
    "pets"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Nome e sobrenome",
      "minLength": 4,
      "default": "- O seu nome aqui -"
    },
    "date": {
      "type": "string",
      "format": "date",
      "options": {
        "flatpickr": {}
      }
    },
    "location": {
      "type": "object",
      "title": "Localização",
      "properties": {
        "city": {
          "type": "string",
          "default": "San Francisco"
        },
        "state": {
          "type": "string",
          "default": "CA"
        },
        "citystate": {
          "type": "string",
          "description": "Isto é gerado automaticamente a partir dos dois campos anteriores",
          "template": "{{city}}, {{state}}",
          "watch": {
            "city": "location.city",
            "state": "location.state"
          }
        }
      }
    },
    "pets": {
      "type": "array",
      "format": "table",
      "title": "Animais de estimação",
      "uniqueItems": true,
      "items": {
        "type": "object",
        "title": "Animal de estimação",
        "properties": {
          "type": {
            "type": "string",
            "enum": [
              "cat",
              "dog",
              "bird",
              "reptile",
              "other"
            ],
            "default": "dog"
          },
          "name": {
            "type": "string"
          }
        }
      },
      "default": [
        {
          "type": "dog",
          "name": "Walter"
        }
      ]
    }
  }
}

Todo esquema JSON consiste em objetos. Todo objeto tem de, no mínimo, ter um tipo e um nome.

Tipos

Objeto

"Objetos" complexos que contêm outros objetos filhos devem usar o object tipo. No nosso exemplo, o nó raiz "Pessoa" do esquema é deste tipo.

Você pode definir campos obrigatórios usando a required palavra-chave. Esses campos também têm de ser definidos no esquema.

Use properties para descrever as características de cada campo necessário; isso inclui atribuir um tipo e um nome.

Array

Arrays permitem adicionar vários itens a uma lista. Use a itens palavra-chave para descrever o tipo dos itens etc.

String

Apenas texto simples. Você pode pré-preenchê-lo usando a padrão palavra-chave.

Para permitir apenas certos valores, você pode usar a enum palavra-chave.