Campos adicionais em formulários

01. DADOS GERAIS

02. ESCOPO FUNCIONAL

1. CAMPOS ADICIONAIS PARA CONTEXTO FORMULÁRIO

Para que seja possível incluir outros tipos de campos nos formulários, será necessário implementar campos adicionais para o contexto de Formulários, de forma que seja possível criar facilmente novas possibilidades de campos para os formulários, permitindo ainda a reutilização dos campos customizados em mais de um mesmo formulário.

Estes campos adicionais devem ser cadastrados na tela de cadastro de campos adicionais da ferramenta (Cadastro -> Geral -> Campos Adicionais), onde deve haver um novo tipo de contexto, chamado “FORMULARIO”.

1. CONSULTA SQL EM CAMPOS ADICIONAIS

Nos campos adicionais, será necessário criar uma nova busca para o tipo de campo “Pesquisa em Entidade”, chamado “Entidade Genérica”, o qual permitirá a utilização de Consulta SQL em banco de dados, para que seja possível criar campos customizados, usando as informações do sistema.

Ao utilizar esta nova busca, a aplicação apresentará alguns novos campos na tela de cadastro de campos adicionais, para que seja possível informar a fonte dos dados para a consulta, adicionar as consultas SQL, confirmar a consulta, pré-visualizar os resultados da consulta, validar entrada de dados, permitir utilização de filtro de usuário logado e confirmação do campo adicional.

Segue abaixo o detalhamento dos itens a serem criados:

1. Busca Entidade Genérica

Será necessário implementar um novo tipo de busca para campos adicionais do tipo Pesquisa em Entidade, chamado “Entidade Genérica”, a qual vai ser apresentada inicialmente para campos do contexto de Formulário.

A busca de entidade genérica permitirá ao usuário que selecione a fonte de dados de consulta da entidade, assim como permitirá que o usuário informe uma consulta SQL customizada, para a definição das informações que serão utilizadas neste campo adicional.

Portanto, ao selecionar essa nova opção “Entidade Genérica”, devem ser apresentados os campos “Base de dados” e “Consulta”, conforme descrito a seguir.

1. Base de Dados

Será necessário implementar um novo campo para a busca por Entidade Genérica, onde será possível selecionar a base de dados a ser utilizada na busca das informações do campo adicional.

Este campo terá o seu comportamento similar ao campo de seleção de Base de Dados da tela de cadastro de indicadores do SFA.

1. Consulta

Será necessário implementar um novo campo para as entidades Genéricas, para que seja possível selecionar a Consulta que será utilizada para buscar as informações do campo adicional.

Este campo terá o seu comportamento similar ao campo de seleção de Base de Dados da tela de cadastro de indicadores da ferramenta, onde o usuário poderá selecionar alguma consulta, ou poderá utilizar as configurações avançadas, para informar a sua consulta SQL customizada.

1. Consulta SQL

Será necessário implementar um campo, onde o usuário poderá incluir as consultas SQL, que trarão os dados para o campo adicional.

Este campo será implementado de maneira similar ao existente no cadastro de indicadores de BI, respeitando inclusive as seguintes características:

• Quando este campo estiver visível, ele deve ter o seu preenchimento obrigatório;
• Deve ter uma white-list, para definir comandos/ações SQLs permitidos, evitando assim a inclusão de comandos SQL indesejados;
• Deve ser possível incluir uma variável na consulta, para filtrar pelo usuário logado (WS_USUARIO_LOGADO);
• A consulta precisa ser padronizada, onde o retorno da mesma precisa ser obrigatoriamente duas colunas:

• Chave
• Valor

• Deve haver um botão para confirmar a consulta SQL. Durante a confirmação, a aplicação deve validar se as regras definidas acima estão sendo respeitadas, e caso alguma delas não seja respeitada, deve ser apresentada uma mensagem de erro ao usuário, informando qual regra que não está sendo cumprida;
• Deve haver um botão, que permita a pré-visualização dos resultados retornados com a consulta SQL, conforme descrito a seguir.

1. Pré-Visualização

Será necessário implementar a pré-visualização das consultas SQL, de modo que o usuário possa visualizar os resultados da consulta que está sendo realizada.

A pré-visualização deve apresentar os resultados em formato de tabela, com as colunas Chave e Valor, de acordo com as informações montadas na consulta SQL.

Somente será possível utilizar o botão de pré-visualização dos dados após a confirmação da consulta SQL.

A pré-visualização será utilizada apenas para ter uma prévia dos resultados da consulta, pois não haverá gravação de resultados da consulta durante a gravação do campo. As opções do campo serão geradas em tempo de execução pela aplicação, durante a utilização do campo adicional, ou ainda durante a sincronização do aparelho Android, que gerará as opções para utilização de modo offline.

1. CADASTRO DE FORMULÁRIOS

Será necessário implementar a utilização de “campos adicionais” nas perguntas dos Formulários, de forma que o usuário possa utilizar em seus formulários os campos adicionais previamente criados.

Na tela de edição de formulários, dentro do cadastro de perguntas, será necessário implementar um novo “Tipo da Pergunta”, onde haverá a opção “Campo Adicional”. Essa opção abrirá um novo campo ao usuário, onde ele poderá selecionar um dos campos adicionais cadastrados para o contexto de formulários.

1. Tipo da Pergunta

Será necessário implementar uma nova opção para o Tipo da Pergunta dos formulários chamada “Campo Adicional”, a qual ao ser selecionada, abrirá um novo campo, para a seleção do adicional desejado.

1. Seleção do campo

Será necessário implementar um novo campo no cadastro de perguntas do formulário, onde o usuário poderá selecionar qual o campo adicionar que deseja incluir no formulário.

Este campo será apresentado apenas quando o tipo de pergunta selecionada tenha sido “Campo Adicional”.

Quando apresentado em tela, o preenchimento de campo é obrigatório.

1. Pré-visualização do campo adicional no formulário^[a]

Será necessário implementar a pré-visualização do campo adicional na tela de edição de formulários, de modo que seja possível pré-visualizar as opções que serão apresentadas no campo.

A pré-visualização dos campos adicionais será similar à pré-visualização das perguntas do tipo “Campos cadastrados”, onde ao clicar sobre a lupa na lateral direita do campo, será apresentada uma popup com a lista de resultados do campo, permitindo inclusive a filtragem dos resultados pela descrição (Valor) do campo.

Nessa popup, será apresentado o conteúdo definido na coluna “valor” do campo adicional.

1. RESPONDER FORMULÁRIO - WEB

Será necessário implementar o campo adicional do tipo Consulta SQL na tela de “responder formulário” da Web do SFA.

Ao carregar a tela de responder, a aplicação efetuará a consulta SQL no banco de dados para gerar as opções do campo, apresentando em tela o Valor encontrado para cada um dos registros.

Os campos adicionais serão apresentados de maneira similar aos campos do tipo “Campos cadastrados”, onde ao clicar sobre a lupa na lateral direita do campo, será apresentada uma popup com a lista de resultados do campo, permitindo inclusive a filtragem dos resultados pela descrição (Valor) do campo.

Nessa popup, será apresentado o conteúdo definido na coluna “valor” do campo adicional.

Quando a aplicação for registrar em banco as respostas destes campos adicionais, deve ser armazenado em banco tanto a Chave quanto o Valor do registro que foi selecionado no formulário, permitindo assim a posterior visualização das respostas incluídas pelo profissional.

1. VISUALIZAR ENVIADOS - WEB

Será necessário implementar a visualização do campo adicional do tipo Consulta SQL na tela de “Visualizar Formulários Enviados” da Web do SFA.

Ao carregar a tela de visualização das respostas, a aplicação deve resgatar no banco de dados as informações registradas para o campo adicional, apresentando em tela a descrição do registro (Valor) conforme o que está registrado na resposta do banco de dados.

Como a Consulta SQL pode ter sido totalmente customizada, e a Chave também pode ter sido customizada, a aplicação NÃO deve realizar uma nova Consulta SQL para buscar a descrição do registro, devendo simplesmente apresentar a descrição do registro selecionado.

1. SINCRONIZAÇÃO DE CAMPOS CONSULTA SQL

Será necessário implementar a sincronização de campos adicionais do tipo Consulta SQL para o Android, de forma que estes campos possam ser utilizados de forma offline no Android.

Para isso, durante a sincronização, devem ser preparadas as opções selecionáveis do campo através de “views”, onde essas opções serão armazenadas dentro de um novo DATS do aparelho.

Dessa forma, será possível utilizar os formulários com perguntas geradas a partir de consultas SQL, uma vez que a consulta foi realizada no momento da sincronização, e o seu resultado está permitido na memória do aparelho.

A cada nova sincronização, as opções selecionáveis serão atualizadas, de forma que elas sempre estejam atualizadas no aparelho do usuário.

1. RESPONDER FORMULÁRIO - ANDROID

Será necessário implementar o campo adicional do tipo Consulta SQL na tela de “responder formulário” do APP Mobile do SFA.

Ao carregar a tela de responder, a aplicação efetuará a busca a busca das opções do campo de maneira offline, através dos registros presentes na tabela/entidade criada durante a sincronização dos dados.

Como a sincronização atualiza os dados do campo adicional a cada nova sincronização, as informações que estão sendo visualizadas pelo profissional no campo adicional se referem ao momento em que a sincronização foi realizada, assim como ocorre com os demais dados do SFA. Não haverá consulta online para gerar os dados do campo adicional em tempo de execução no APP Mobile.

Os campos adicionais serão apresentados de maneira similar aos campos do tipo “Campos cadastrados”, onde ao clicar sobre o campo, será apresentada uma popup com a lista de resultados do campo, permitindo inclusive a filtragem dos resultados pela descrição (Valor) do campo.

Nessa popup, será apresentado o conteúdo definido na coluna “valor” do campo adicional.

Quando a aplicação for registrar em banco as respostas destes campos adicionais, deve ser armazenado em banco tanto a Chave quanto o Valor do registro que foi selecionado no formulário, permitindo assim a posterior visualização das respostas incluídas pelo profissional.

1. VISUALIZAR ENVIADOS - ANDROID

Será necessário implementar a visualização do campo adicional do tipo Consulta SQL na tela de “Visualizar Formulários Enviados” do APP Mobile do SFA.

Ao carregar a tela de visualização das respostas, a aplicação deve resgatar no banco de dados as informações registradas para o campo adicional, apresentando em tela a descrição do registro (Valor) conforme o que está registrado na resposta do banco de dados/memória do aparelho.

Como a Consulta SQL pode ter sido totalmente customizada, e a Chave também pode ter sido customizada, a aplicação NÃO deve realizar uma nova Consulta SQL para buscar a descrição do registro, devendo simplesmente apresentar a descrição do registro selecionado.

02. ESCOPO TÉCNICO

Banco de dados