Criação de formulário

Para criar um formulário, é necessário inserir no campo "Name" o nome do formulário e no campo "Marker" um identificador único, pelo qual é possível acessar a entidade exclusivo. Após clicar no botão "Add", o formulário aparecerá na tabela de formulários.

Edição de formulário

Para editar um formulário, é necessário clicar no botão "Edit" na última coluna (sem cabeçalho) da tabela de formulários.

Para os formulários, ao editar, estão disponíveis as abas:

• Dados básicos
• Campos do formulário
• Configurações
• Formulários de engajamento — apenas para formulários do tipo Data submission
• Configuração de classificação — apenas para formulários do tipo Rating Form: aqui o formulário de classificação é conectado aos módulos e a escala de avaliação é configurada
• Histórico de versões — histórico de alterações do formulário

1. Dados básicos

A aba "Dados básicos" contém três campos de entrada:

• Título do formulário (para CMS) - nome do formulário que será exibido na interface da Platform OneEntry
• Título do formulário (para aplicação) - nome do formulário para seu site ou aplicativo móvel
• identificador único, pelo qual é possível acessar a entidade
  • identificador único, pelo qual é possível acessar o formulário (apenas letras latinas e os símbolos "_" e "-" são permitidos)

Esses três parâmetros do formulário podem ser alterados na aba "Dados básicos".

2. Campos do formulário

A aba "Campos do formulário" contém três listas suspensas para selecionar o tipo de formulário, Modelo (abre em uma nova aba) e Conjunto de atributos (abre em uma nova aba).

O conjunto de atributos, neste caso, consiste nos campos do próprio formulário.

Na Platform OneEntry, existem cinco tipos de formulários:

• Formulário de pedido - tipo para formulários de pedidos
• Login e Registro - tipo destinado a formulários de autenticação e registro
• Para coleções de integração - tipo para formulários de coleções de integrações
• Data submission - tipo destinado a todos os outros formulários; apenas formulários desse tipo têm a aba "Formulários de engajamento"
• Rating Form - tipo para formulários de avaliação; no conjunto de atributos desse formulário deve haver um atributo com o valor da classificação, e o próprio formulário terá a aba "Configuração de classificação"

3. Configurações

A aba "Configurações" contém as configurações de acesso aos dados do formulário e as mensagens que serão exibidas ao enviar o formulário.

O cartão "Acesso aos dados do formulário" contém a caixa de seleção "Os dados estão disponíveis apenas para administradores (não fornecer por token)". Quando a caixa está marcada, os dados enviados do formulário estão disponíveis apenas para administradores e não são fornecidos por token.

O cartão "Campos a serem enviados para o script" contém dois campos de entrada:

• Mensagem sobre o processamento bem-sucedido dos dados - campo de texto para mensagem em caso de envio bem-sucedido do formulário
• Mensagem sobre o processamento malsucedido dos dados - campo de texto para mensagem em caso de erro ao enviar o formulário

Se os dados do formulário forem enviados para um script, na aba é exibido adicionalmente o campo "URL para onde o formulário será enviado" - o endereço para o qual o formulário será enviado.

4. Formulário de engajamento

A funcionalidade Formulário de engajamento permite integrar formulários de coleta de dados em vários módulos do sistema:

• Administradores (Admin users)
• Páginas (Pages)
• Catálogo (Catalog)
• Usuários (Users)

A cada módulo pode ser anexado um número ilimitado de formulários, garantindo flexibilidade na coleta de informações.

Configurações de formulários

1. Mostrar formulário para todas as entidades do módulo

   • Ao ativar, o formulário se torna disponível para todas as entidades do módulo selecionado
   • Não requer seleção manual de elementos individuais (páginas, usuários, etc.)
   • Exemplo: formulário de comentários para todos os produtos do catálogo
   • A caixa de seleção está disponível apenas enquanto nenhuma entidade individual estiver selecionada. Se as entidades já estiverem marcadas, a caixa de seleção estará desativada e mostrará a dica Para ativá-la, remova todas as seleções — desmarque as entidades para ativá-la

2. Fechar formulário para coleta de dados

   • Ativar esta configuração proíbe a adição de novos registros
   • Os usuários podem apenas visualizar os dados existentes
   • Usado para formulários arquivados ou para fechamento temporário da coleta de informações

3. Visualizar apenas seus dados

   • Limita a exibição de dados apenas aos registros do usuário atual
     • Os dados de outros usuários se tornam invisíveis

4. Comentar apenas seus dados

   • Os usuários podem comentar exclusivamente seus registros

5. Moderar dados

   • Novos registros recebem automaticamente o status "moderate"
   • Visibilidade no sistema apenas após aprovação do moderador

Seleção de entidades no formulário de engajamento

A seleção de entidades para uso no formulário é apresentada em três opções:

• Seleção pontual de entidades Ao clicar no seletor à direita do nome da entidade, o formulário será exibido para essa entidade específica
• Indicação de dados aninhados na entidade selecionada Selecionar o segundo seletor ao escolher entidades permitirá conectar o formulário automaticamente a todas as entidades aninhadas. Útil em casos onde novas entidades serão criadas, o formulário de engajamento já estará conectado a elas.

• Mostrar formulário para todas as entidades do módulo Descrição do item

Abaixo da lista de entidades, são exibidos contadores de dados enviados através do formulário: Total de Dados Enviados — total e Dados Únicos Enviados — únicos.

Uso em módulos

Os dados dos formulários de engajamento podem ser visualizados em duas abas:

• "Formulários de engajamento para todo o módulo" — dados de todo o módulo (aba de nível superior no módulo);
• "Formulários de engajamento" — dados de uma entidade específica (por exemplo, página), aba em seu editor.

No seletor "Formulário", selecione o formulário desejado. Se necessário, você pode especificar dados adicionais: "ID do usuário que enviou os dados" (identificador do usuário que enviou os dados), "Status", intervalo de tempo (datas no formato DD-MM-YYYY) e a caixa de seleção "Enviado por administrador". Na aba "Formulários de engajamento para todo o módulo", há também o campo "ID da entidade para a qual os dados são enviados" (identificador da entidade) — na aba da entidade específica, ele não está presente: a entidade já está selecionada. Após preencher os dados necessários, clique no botão "Select". O botão "Reset" redefine as especificações fornecidas.

Se for necessário exibir atributos específicos, você pode usar o seletor "Selecionar atributos para exibir dados".

Ao encontrar dados, uma tabela com células preenchidas aparecerá.

Cada elemento da tabela contém a coluna obrigatória "Informação", com a indicação:

• Data e hora de recebimento dos dados
• Dados do remetente
• Status do documento
• Identificador da entidade

Para cada elemento da tabela, você pode iniciar uma "conversa", clicando no botão . Na janela modal aberta, os campos do formulário estarão disponíveis para preenchimento. Após preencher e indicar o status, um comentário será criado para o documento indicado. Cada novo comentário será anexado ao elemento pai, permitindo rastrear a hierarquia.