🔴 O App de Inscrições e Matrículas, permite que as instituições de ensino
configurem um processo seletivo totalmente personalizável com suas próprias
regras e também permite integração com TOTVS RM e com o Rubeus, além de
muitas outras integrações.
🔗 Para conhecer todos os conteúdos relacionados a esse assunto, clique aqui!
Sumário (para quem não quer perder tempo)
- 🔶 Campos do Sistema
- 🔶 Identidade
- 🔶 Básico
- 🔶 Multivalorado
- 🔶 Validação
- 🔶 Dados
- 🔶 Fonte de Dados TOTVS
- 🔶 Demais fontes de dados
- Vínculo
- Consultas
🔶 Campos do Sistema
Os campos do sistema são recipientes do formulário que servem tanto para receber informações do usuário (visíveis) quanto para armazenar informações relevantes (ocultos) vindas de consultas do TOTVS. No exemplo abaixo, “Nome”, “E-mail” e “Celular” são campos do sistema (visíveis) preparados para receber informações do usuário e entregá-las aos respectivos bancos de dados.
Já no exemplo abaixo podemos ver campos ocultos (dentro do editor de portais), que servem para armazenar informações importantes (obtidas via consulta) que vão nortear a inserção de novos dados, lógicas de exibição ou realização de processos no TOTVS.
O processo de criação de campos é importante para configurar a forma com a qual o campo será utilizado para receber as informações. Este processo possui os seguintes passos, após clicar em “novo campo do sistema”.
🔶 Identidade
O tipo do campo recebe o padrão do campo que, nada mais é, do que tipos para a tag input do HTML. Aqui você decide se o usuário poderá inserir um texto, uma data, ou se o campo será uma caixa de seleção, por exemplo.
Na opção “Tabela do processo seletivo” é selecionado se a informação que o campo receberá será referente à pessoa (informações de contato) ou se fará referência à inscrição desta pessoa (relativo a registro). A diferença, neste caso, é que a pessoa será único por portal, vez que as informações pessoais não diferem entre os processos seletivos; já o da inscrição, ele é registrado com base no Processo Seletivo, podendo a mesma pessoa ter dados diferentes em processos diferentes, desde que ela esteja participando de mais de um.
No campo “Multivalorado” informamos ao sistema se o campo poderá receber mais de um valor. Ele é útil para, por exemplo, caso o campo pretenda receber o upload de mais de um documento.
Ao ativar os campos “Integração Rubeus” e “Integração TOTVS” você associa o campo que está sendo criado a campos nos bancos de dados do Rubeus e ao alias de consultas SQL no TOTVS, a depender de configuração.
Na integração Rubeus, será preciso informar qual tabela será integrada, da mesma forma que ocorreu a escolha da tabela do processo seletivo (procedimento já descrito acima), bem como a coluna da tabela que faz referência ao dado do campo. Já na integração TOTVS, quando o banco de dados é SQL Server, será preciso informar manualmente a tabela e o campo, referenciando ao alias da coluna na consulta SQL, caso seja, Oracle deve informar o nome do campo em Nome alternativo.
🔶 Básico
O Rótulo serve como título do campo e pode ser mostrado acima ou por baixo, a depender da opção posição do rótulo, ou até mesmo ser ocultada através da opção esconder rótulo, o que fará com que o rótulo sirva apenas para identificação do campo dentro do sistema.
O Placeholder é uma demonstração ou descrição que é mostrada dentro do próprio campo enquanto ele não é preenchido. A máscara é mostrada da mesma forma, porém é restrita ao modelo da entrada e não a descrição de qualquer tipo.
A Descrição é uma opção de informar mais detalhes que aparecerá embaixo do campo e será exibido sempre. A dica aparecerá dentro de um botão de interrogação ao lado do rótulo.
A Dica é uma descrição que aparece como um ícone de interrogação, sendo visualizada quando é passado o mouse por cima.
A Máscara ajuda o usuário a digitar em um formato, garantindo um padrão predefinido, sendo o padrão:
9 -> numérico
a -> alfabético
- -> alfanumérico
O sufixo e prefixo são entradas fixas que serão adicionadas ao fim ou ao início da informação dada pelo usuário.
A classe CSS permite a criação de novas classes de estilo que podem ser configuradas no campo Classe CSS(CSS através de código), dando mais poder de personalização ao usuário. Lembrando que a classe criada não serve somente para o escopo do agrupamento, mas sim para todo o projeto, portanto não precisa repetir toda vez que for utilizar a configuração, já que uma classe CSS em qualquer campo pode ser alcançada em todo o projeto.
A opção desabilitar serve para não permitir a edição do campo pelo usuário, apesar dele ser mostrado. Já a opção esconder irá esconder o campo, o que permite que informações sejam armazenadas e acessadas em campos na página sem que tais informações sejam mostradas ao usuário.
A opção esconder rótulo, irá esconder o nome/label do campo. E por fim, a opção de copiar irá habilitar um sufixo com a opção de copiar o valor do input, essa opção é normalmente utilizada para a integração com o PIX da TOTVS.
🔶 Multivalorado
Essa opção é possível configurar a quantidade mínima e máxima de opções que o campo multivalorado pode receber.
🔶 Validação
A validação serve para garantir que os campos sejam preenchidos pelo usuário da maneira esperada, portanto é preciso que se insira a regra de validação e uma mensagem para ser exibida ao usuário caso aquela regra não seja respeitada.
As possibilidades de validação vão desde o meramente campo obrigatório até a formatos específicos de entrada, expressões regulares e validação Javascript, utilizando variáveis pré-definidas para referenciar aos valores aplicados no campo.
🔶 Dados
O valor padrão serve para que a página seja renderizada com o campo já preenchido, trazendo essa informação previamente de outro lugar. Na opção valor padrão simples, o valor padrão será literalmente o que for escolhido na hora da configuração.
A opção de valor padrão dinâmico representa a possibilidade de receber as informações através de métodos de requisição HTTP, permitindo que o usuário que for redirecionado por outra página (landing page, por exemplo) não precise digitar as informações novamente.
As opções pré-definidas servem para povoar o campo com opções, sejam elas provenientes do TOTVS, fonte externa ou inseridas manualmente.
🔶 Fonte de Dados TOTVS
Ao selecionar as opções pré-definidas do TOTVS, o sistema realizará consulta indicada na Fonte de Dados para que as opções sejam buscadas e renderizadas assim que se entra no passo. Portanto, neste ponto apenas é selecionado o TOTVS como fonte, sem maiores especificações, porque tal parametrização é feita dentro da configuração do passo.
Ao inserir no passo um campo cuja fonte de dados selecionada é o TOTVS, precisamos indicar a integração do campo, ou seja, qual é o alias da consulta que o campo deverá receber o resultado. No exemplo abaixo, o campo pretende dar opções de polos para o usuário escolher, conforme aliás “SCAMPUS.CODCAMPUS” da consulta.
Uma vez que selecionamos a fonte de dados como TOTVS e inserimos o campo na tela, é habilitada na configuração do passo os parâmetros da Fonte de Dados, habilitando configuração para que a consulta seja realizada no momento em que o usuário acessa o passo. No exemplo abaixo, a consulta retorna os cursos/ofertas, que serão disponibilizados na tela para escolha do usuário.
Interessante notar que para cada campo na tela será inserida uma fonte, a não ser que os campos inseridos cuja fonte é o TOTVS estejam vinculados. Veja o exemplo abaixo de mais de uma fonte de dados:
Outro exemplo, é a o plano de pagamento, aquela fonte de dados funcionará conforme a consulta abaixo é retornada quando o passo onde ela estiver adicionada é renderizado na tela:
Note que o retorno da consulta terá um “COD”, que seria o value do select e um “DISPLAY”, que seria a label/descrição, que seriam, respectivamente, valor e o que é mostrado na tela. Além disso, para a consulta ser realizada, é preciso que parâmetros sejam passados, conforme abaixo:
Estes parâmetros são configurados também na tela de Fonte de Dados, onde podemos selecionar campos do sistema ou valores fixos:
🔶 Demais fontes de dados
Utilizando a opção fonte externa é possível acessar links externos que vão retornar dados em JSON para serem utilizados como opções e, por fim, a inserção manual permite adicionar rapidamente as opções que serão mostradas ao usuário. Esta opção serve para buscar, por exemplo, em ambientes do cliente que não seja o TOTVS, como uma plataforma de EAD, por exemplo.
A opção somente leitura serve para bloquear escrita no campo.
Vínculo
Este campo é utilizado para criar dependências de filtros entre campos, como por exemplo nos casos em que precisamos, após selecionar uma curso, listar somente os turnos disponíveis para aquele curso. Também serve, como vimos anteriormente, para vincular campos que usam a mesma fonte de dados no TOTVS, conforme visto anteriormente.
Somente campos do tipo “select” e com opções pré-definidas como TOTVS são elegíveis para serem vinculados entre si.
Consultas
- A consulta Buscar processos é a consulta responsável por atualizar dados de um processo seletivo específico.
- A consulta Listar processos é a consulta responsável por exibir os processos seletivos disponíveis para serem configurados.
- A consulta Listar processos disponíveis por candidato Consulta responsável por exibir os processos seletivos disponíveis para inscrição no portal.
- A consulta Login portal do inscrito é a consulta responsável por trazer todas as inscrições do candidato para realizar o login.
- A Dados do portal do inscrito consulta responsável atualizar dados da inscrição toda vez que o candidato acessa o portal.
Comentários
0 comentário
Por favor, entre para comentar.