Tempo aproximado para leitura: 40 min
Neste documento tem como objetivo orientar que o utiliza durante a implantação/configuração do App Minha Colheita em clientes. Sendo que todos os passos que serão exemplificados abaixo, somente, são possíveis de realização por um usuário com privilégios Corporativo ou Administrador.
Para início da implantação/configuração foi separado pelos menus do Portal Agrícola e utilizado um usuário Corporativo.
A primeira configuração que iremos realizer é no sub-menu Notícia do menu Básico.
Ao abrir o sub-menu Notícia, pode-se observer a consulta que exibe as notícias, onde o primeiro passo é verificar a existência de notícia(s) observando a tabela abaixo.
Como é possível observar a existência de notícias cadastradas na imagem anterior, iremos realizar a configuração do modo que a(s) notícia(s) irão ser apresentadas no App. Para isso seguiremos alguns passos.
Primeiramente iremos selecionar a notícia desejada e clicar em alterar.
Com a tela de alteração da notícia aberta, vamos procurar os campos conforme apresentados na imagem abaixo.
O campo Categoria Mobilidade define a categoria que a imagem se classifica (Produção, Eventos, Convocações, Financeiro, Tecnologia ou Avisos/Alertas), enquanto o campo Destaque ao ser marcado definirá se a notícia estará em destaque na tela inicial do App.
Após definir esses campos, clique em Salvar para prosseguir para a próxima etapa.
b - Configuração da Consulta
A próxima configuração a ser realizada é no sub-menu Consulta do menu Configuração.
A configuração das consultas é de extrema importância, pois indica como será o funcionamento da realização das consultas dentro do App. Sua configuração é separada em três etapas, sendo elas, a configuração da Consulta (Tabela principal), a configuração dos Filtros (Primeira aba da tabela secundária) e a configuração dos Campos (Segunda aba da tabela secundária).
O primeiro passo é obsevar se existe consultas cadastradas, após isto iremos seguiremos alguns passos.
Ao selecionar a(s) consulta(s) que iremos configurar na tabela principal, pode-se obeservar que na tabela secundária, a aba Filtros e a aba Campos exibirá os campos cadastrados desta consulta.
Com isso iremos primeiramente realizar a alteração dentro da consulta, clicando no botão Alterar abaixo da tabela principal.
Na tela de edição da consulta, existem três pontos que devem ser configurados para definir como o App irá exibir essa consulta. O primeiro é a definição do campo Nome para App, que será o nome que a mesma apresentará no App, já o segundo campo Tipo Consulta define onde a consulta irá aparecer, se é apenas no Portal ou Portal/Mobilidade, enquanto o terceiro campo Classificação Consulta define em qual menu (Produção ou Financeiro) a consulta irá se encontrar no App.
Estes três campos devem ser preenchidos para o funcionamento correto no App, sendo que o campo Nome para App deve receber o nome definido pelo usuário, no combobox Tipo Consulta deve ser obrigatoriamente Portal/Mobilidade para que a consulta apareça no App e o combobox Classificação Consulta deve ser designado para o tipo que se encaixa a consulta. Após definidos os valores deve-se clicar em Salvar as informações para prosseguirmos com a configuração dos Filtros da consulta.
Ao selecionar o filtro que será configurado, clique no botão Alterar para que seja aberta a tela com as informações do mesmo. Nesta tela o campo a ser configurado é o WebService Mobilidade, onde desse-se preencher com o nome do WebService criado para este filtro. O WebService relacionado ao filtro realiza uma consulta onde seu retorno são os dados referentes ao que foi preenchido no filtro.
Caso o usuário realize a criação de um filtro que não possua WebService criado relacionado ainda, deve-se criar também este WebService e voltar na consulta para relacionar o mesmo conforme mostra a imagem abaixo.
Após realizar o vinculo do filtro com um WebService deve-se clicar em Salvar e prosseguir com essa configuração em todos filtros que serão exibidos no App. Ao terminar todos os filtros, vamos passar para a configuração dos Campos da consulta.
Ao escolher o campo a ser configurado, deve-se clicar no botão Alterar para que a tela dos dados a serem ajustados carregue. Nela é necessário configurar dois campos, sendo eles, o combobox Prioridade de Quebra e o checkbox Exporta Mobilidade.
O campo Prioridade de Quebra define em qual nível de detalhamento este campo irá aparecer quando a consulta no App for gerada. Os níveis de 1 até 4 são respectivamente a ordem da quebra que o campo aparecerá, caso for definido como Detalhe o campo somente aparecerá no resultado detalhado(final) que é após todas as quebras. Contudo, para que o campo apareça na consulta realizada pelo App, é obrigatório marcar o checkbox Exporta Mobilidade.
Com a configuração realizada, clique em Salvar e realizar o mesmo procedimento nos demais campos e assim prosseguir para a próxima etapa.
A próxima configuração a ser realizada é no sub-menu Templates do menu Configuração.
Nesta consulta, são configurados os corpos de dois e-mails que são enviados ao usuário do App, sendo eles os templates MAIL_SA_03 e MAIL_SA_06.
No template MAIL_SA_03 é encaminhado para o cliente um e-mail quando ele realiza sua solicitação de acesso. Neste e-mail é informado o usuário/senha que o mesmo deverá utilizar parar acessar o Portal Agrícola e um QrCode para que seja lido para acesso ao App. Enquanto no template MAIL_SA_06 seu corpo é referente quando o cliente solicitou um e-mail de recuperação de senha e neste é informado também o usuário/senha do Portal Agrícola, além do QrCode para o App.
Ao verificar que ambos templates estão configurados, vamos para a próxima etapa.
No próximo passa vamos acessar a opção de sub-menu Parâmetro.
Na primeira tabela Grupo de Parâmetro, deve-se selecionar o parâmetro de código igual à GERAIS.
Logo abaixo será exibidos os parâmetros referentes aquele grupo, onde iremos alterar o parâmetro de código igual à URL_CONEXAO_APP.
Ao clicar em alterar, será aberta a tela para edição do valor do parâmetro.
Vamos alterar a label Valor, mas para isso deve alterar apenas as informações que iremos destacar a seguir.
Olhando o Valor Padrão, vamos copiar a informação armazenada nela e colar no campo Valor, onde está escrito “cliente” deve ser substituído o nome do empresa e onde está escrito “localhost:8080” dee ser substituído pelo endereço público do Portal Agrícola.
PS: apenas substituir os valores informados em negrito acima, apagar ou alterar alguma informação diferente desta pode acarretar em não funcionamento do APP.
Após realizar as alterações, deve-se clicar em salvar e assim podemos seguir para o próximo passo de configuração.
O próximo passo inicialmente não possui uma configuração a ser realizada, serve
A próximo passo inicialmente não possui uma configuração a ser realizada, serve apenas como uma consulta para controlar os usuário que possuem acesso ao App, conforme apresentando na imagem abaixo.
Caso o usuário Corporativo/Administrador do Portal Agrícola deseje liberar/bloquear o acesso de algum usuário ao App, ele deve selecionar o usuário e clicar em Alterar Bloqueio, onde aparecerá uma nova janela para que seja informada a ação que ele quer tomar.
Feito a confirmação do status de bloqueio, já é realizada a alteração do status do usuário conforme nova imagem.
Ao realizar todos esses passos, vamos prosseguir para os próximos.
Neste passo, vamos acessar o sub-menu Avaliação APP localizado no menu Visualização.
Nesta consulta não existe uma configuração a ser realizada, ela tem como funcionalidade para o Administrado do Portal Agrícola acompanhar o feedback dado pelo usuário em relação ao App, conforme imagem abaixo.
Neste passo, vamos acessar o menu Ocorrências.
Nesta consulta, não é necessário realizar nenhuma configuração, ela tem como intuito apresentar em uma tabelas todas as ocorrências abertas até o momento. Sendo que ao clicar sobre uma determinada ocorrência, será aberto o histórico de notificações trocadas entre o Aministrador do Portal e o fornecedor. No caso abaixo, existe apenas uma notificação, que ainda não foi respondida pelo Administrador.
Após realizar as devidas configurações e conhecer todas funcionalidades, o Portal Agrícola pronto para funcionar junto ao App.
Consulta
Filtros
Campos
Consulta
Filtros
Campos
Consulta
Filtros
Campos
Consulta
Filtros
Campos
Consulta
Filtros
Campos
Consulta
Filtros
Campos
Consulta
Filtros
Campos
Consulta
Filtros
Campos
Consulta
Filtros
Campos
Consulta
Filtros
Campos
Consulta
Filtros
Campos
Consulta
Filtros
Campos
Consulta
Filtros
Campos
Outras Ações / Ações relacionadas
| Ação | Descrição |
|---|---|
| INSERIR | Realizar a inserção de um filtro novo sobre a consulta correspondente. |
| ALTERAR | Realizar a alteração de um filtro existente sobre a consulta correspondente. |
| DELETAR | Realizar a deleção de um filtro existente sobre a consulta correspondente. |
Principais Campos e Parâmetros
| Campo | Descrição |
|---|---|
| CD_FILTRO | Código do filtro utilizado na Consulta |
| DE_FILTRO | Descrição do código do filtro utilizado |
| FG_OBRIGATORIO | Flag de obrigatoriedade do filtro |
| FG_HABILITADO | Flag de habilitação do filtro |
| FG_TIPO | Tipo do filtro utilizado(String, Date, Number) |
| DE_ITEM_COMBO | Opções de valores liberados para o tipo do filtro |
| VL_PADRAO | Valor padrão do campo filtro |
| CONDICAO_SQL | Condição SQL que incorporará a instrução. |
| SEQ_FILTRO | Sequência do filtro para exibição em tela |
| LAST_UPDATE | Data da última atualização do filtro |
| CHAGED_BY | Último usuário que alterou o filtro |
| FG_MULT_VALOR | Flag identificar para filtros múltiplos |
| CD_WEBSERVICE | Código em que o sistema recuperará as informações vindas de WebServices |
