Manual de Configuração do App Minha Colheita / Portal Agrícola

Tempo aproximado para leitura: 40 min

ÍNDICE

1. Visão Geral
2. Exemplo de utilização
   1. Configuração Básica
   2. Configuração da Consulta
   3. Visualização
   4. Ocorrências
   5. Configurações dos Filtros WebServices.
      
3. Tela dos Filtros
   1. Outras Ações / Ações relacionadas
      
4. Tela dos Filtros
   1. Principais Campos e Parâmetros.
5. Tabelas utilizadas

01. VISÃO GERAL

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.

02. EXEMPLO DE UTILIZAÇÃO

     a- Configuração Básica

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.

     c - Visualização

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.

     d - Ocorrências

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.

     e - Configurações dos Filtros Webservices.

• Análises de Maturação

Consulta

• • Nome para App: Análises de Maturação
  • Tipo Consulta: Portal/Mobilidade
  • Classificação Consulta: Produção

Filtros

• • FORNEC: WS_FILTRO_FORNECEDOR
  • CD_UNID_IND: WS_FILTRO_UNIDIND
  • DT_HIST_INI: NULL
  • DT_HIST_FIN: NULL
  • CD_ANL_MAL: WS_FILTRO_TPANALMAT

Campos

• • FAZENDA: Prioridade da Quebra: Nivel 1
  • BLOCO: Prioridade da Quebra: Nivel 2
  • TALHAO: Prioridade da Quebra: Nivel 3
  • Todos outros campos devem estar com Prioridade da Quebra como DETALHE.
  • Marcar Exporta Mobilidade para os campos que deseja exibir no App Minha Colheita.

• Demonstrativo Quinzenal (Quinzena-Safra)

Consulta

• • Nome para App: Demonstrativo Quinzena/Safra
  • Tipo Consulta: Portal/Mobilidade
  • Classificação Consulta: Produção

Filtros

• • FORNEC: WS_FILTRO_FORNECEDOR
  • CD_UNID_IND: WS_FILTRO_UNIDIND
  • DT_REF_INI: NULL
  • DT_REF_FIN: NULL
  • UPNIVEL1: WS_FILTRO_UNIDPROD

Campos

• • FAZENDA: Prioridade da Quebra: Nivel 1
  • QUINZENA: Prioridade da Quebra: Nivel 2
  • ATR_RELATIVO: Prioridade da Quebra: Nivel 3 
  • Todos outros campos devem estar com Prioridade da Quebra como DETALHE.
  • Marcar Exporta Mobilidade para os campos que deseja exibir no App Minha Colheita.

• Listagens de Contratos

Consulta

• • Nome para App: Listagens de Contratos
  • Tipo Consulta: Portal/Mobilidade
  • Classificação Consulta: Financeiro

Filtros

• • SAFRA: WS_FILTRO_SAFRA
  • FORNEC: WS_FILTRO_FORNECEDOR
  • INSTANCIA: WS_FILTRO_INSTANCIA
  • UPNIVEL1: WS_FILTRO_UNIDPROD

Campos

• • FAZENDA1: Prioridade da Quebra: Nivel 1
  • CONTRATO: Prioridade da Quebra: Nivel 2
  • DATA_FINAL: Prioridade da Quebra: Nivel 3 
  • Todos outros campos devem estar com Prioridade da Quebra como DETALHE.
  • Marcar Exporta Mobilidade para os campos que deseja exibir no App Minha Colheita.

• Movimentação de Contratos

Consulta

• • Nome para App: Mov. Contratos Financiamento
  • Tipo Consulta: Portal/Mobilidade
  • Classificação Consulta: Financeiro

Filtros

• • FAVORECIDO: WS_FILTRO_FORNECEDOR
  • INSTANCIA: WS_FILTRO_INSTANCIA
  • DATA_ INICIAL: NULL
  • DATA _ FINAL: NULL
  • EMPRESA: WS_EMPRESAS
  • CONTRATO:

Campos

• • NO_CONTRATO: Prioridade da Quebra: Nivel 1
  • DATA: Prioridade da Quebra: Nivel 2
  • VL_SALDO_ATUAL: Prioridade da Quebra: Nivel 3 
  • Todos outros campos devem estar com Prioridade da Quebra como DETALHE.
  • Marcar Exporta Mobilidade para os campos que deseja exibir no App Minha Colheita.

• NFs - Registro de Entrada de Cana

Consulta

• • Nome para App: Registro Entrega Cana (NFs)
  • Tipo Consulta: Portal/Mobilidade
  • Classificação Consulta: Financeiro

Filtros

• • FORNEC: WS_FILTRO_FORNECEDOR
  • INSTANCIA: WS_FILTRO_INSTANCIA
  • DT_INICIAL: NULL
  • DT_FINAL: NULL
  • UPNIVEL1: WS_FILTRO_UNIDPROD
  • CD_MUNIC: WS_FILTRO_MUNICIPIO

Campos

• • UPNIVEL1: Prioridade da Quebra: Nivel 1
  • DATA_EMISSAO: Prioridade da Quebra: Nivel 2
  • VALOR_LIQUIDO: Prioridade da Quebra: Nivel 3 
  • Todos outros campos devem estar com Prioridade da Quebra como DETALHE.
  • Marcar Exporta Mobilidade para os campos que deseja exibir no App Minha Colheita.

• Posição Geral de Entrega de Matéria Prima por Equipamento

Consulta

• • Nome para App: Entrega Matéria Prima/Equipto
  • Tipo Consulta: Portal/Mobilidade
  • Classificação Consulta: Produção

Filtros

• • FORNEC: WS_FILTRO_FORNECEDOR
  • CD_UNID_IND: WS_FILTRO_UNIDIND
  • DT_INI_PER: NULL
  • DT_FIM_PER: NULL
  • UPNIVEL1: WS_FILTRO_UNIDPROD
  • CD_FRENTE: WS_FILTRO_FRENTRANSP
  • EQUIPTO: NULL

Campos

• • EQUIPTO: Prioridade da Quebra: Nivel 1
  • TC: Prioridade da Quebra: Nivel 2
  • Todos outros campos devem estar com Prioridade da Quebra como DETALHE.
  • Marcar Exporta Mobilidade para os campos que deseja exibir no App Minha Colheita.

• Posição Geral por Local

Consulta

• • Nome para App: Posição Geral por Local
  • Tipo Consulta: Portal/Mobilidade
  • Classificação Consulta: Produção

Filtros

• • FORNEC: WS_FILTRO_FORNECEDOR
  • CD_UNID_IND: WS_FILTRO_UNIDIND
  • DT_INI_PER: NULL
  • DT_FIM_PER: NULL
  • UPNIVEL1: WS_FILTRO_UNIDPROD

Campos

• • DE_UNID_IND: Prioridade da Quebra: Nivel 1
  • FAZENDA: Prioridade da Quebra: Nivel 2
  • CD_UPNIVEL3: Prioridade da Quebra: Nivel 3
  • Todos outros campos devem estar com Prioridade da Quebra como DETALHE.
  • Marcar Exporta Mobilidade para os campos que deseja exibir no App Minha Colheita.

• Recibos de Pagamento a Fornecedores

Consulta

• • Nome para App: Recibos Pagamento Fornecedores
  • Tipo Consulta: Portal/Mobilidade
  • Classificação Consulta: Financeiro

Filtros

• • FORNEC: WS_FILTRO_FORNECEDOR
  • INSTANCIA: WS_FILTRO_INSTANCIA
  • DT_INICIAL: NULL
  • DT_FINAL: NULL
  • FG_TP_FOLHA: WS_FILTRO_RECIBO
  • UPNIVEL1: WS_FILTRO_UNIDPROD

Campos

• • UPNIVEL1: Prioridade da Quebra: Nivel 1
  • AM_FORNEC: Prioridade da Quebra: Nivel 2
  • VALOR_LIQUIDO: Prioridade da Quebra: Nivel 3 
  • Todos outros campos devem estar com Prioridade da Quebra como DETALHE.
  • Marcar Exporta Mobilidade para os campos que deseja exibir no App Minha Colheita.

• Recibos de Pagamento de Parceria-Arrendamento

Consulta

• • Nome para App: Pagto Parceria/Arrendamento
  • Tipo Consulta: Portal/Mobilidade
  • Classificação Consulta: Financeiro

Filtros

• • FORNEC: WS_FILTRO_FORNECEDOR
  • INSTANCIA: WS_FILTRO_INSTANCIA
  • DT_INICIAL: NULL
  • DT_FINAL: NULL
  • FG_TP_PROC: WS_FILTRO_RECIBO
  • CD_TP_CONTR: WS_FILTRO_TPCONTRATO
  • CD_SAFRA: WS_FILTRO_SAFRA
  • NO_CONTR_CANA:
  • UPNIVEL1: WS_FILTRO_UNIDPROD

Campos

• • FAZENDA: Prioridade da Quebra: Nivel 1
  • NO_PARCELA: Prioridade da Quebra: Nivel 2
  • VL_LIQUIDO: Prioridade da Quebra: Nivel 3 
  • Todos outros campos devem estar com Prioridade da Quebra como DETALHE.
  • Marcar Exporta Mobilidade para os campos que deseja exibir no App Minha Colheita.

• Resumo Diário

Consulta

• • Nome para App: Resumo Diário
  • Tipo Consulta: Portal/Mobilidade
  • Classificação Consulta: Produção

Filtros

• • FORNEC: WS_FILTRO_FORNECEDOR
  • CD_UNID_IND: WS_FILTRO_UNIDIND
  • DT_HISTORICO: NULL

Campos

• • DE_UNID_IND: Prioridade da Quebra: Nivel 1
  • FAZENDA: Prioridade da Quebra: Nivel 2
  • Todos outros campos devem estar com Prioridade da Quebra como DETALHE.
  • Marcar Exporta Mobilidade para os campos que deseja exibir no App Minha Colheita.

• Resumo dos Contratos

Consulta

• • Nome para App: Resumo Contratos Financiamento
  • Tipo Consulta: Portal/Mobilidade
  • Classificação Consulta: Financeiro

Filtros

• • FAVORECIDO: WS_FILTRO_FORNECEDOR
  • INSTANCIA: WS_FILTRO_INSTANCIA
  • DATA_ INICIAL: NULL
  • DATA _ FINAL: NULL
  • SAFRA_DESCONTO: WS_FILTRO_SAFRA
  • CD_UPNV1_DESC: WS_FILTRO_UNIDPROD

Campos

• • CONTRATO: Prioridade da Quebra: Nivel 1
  • TIPO_TRANSF: Prioridade da Quebra: Nivel 2
  • SALDO_FINAL: Prioridade da Quebra: Nivel 3 
  • Todos outros campos devem estar com Prioridade da Quebra como DETALHE.
  • Marcar Exporta Mobilidade para os campos que deseja exibir no App Minha Colheita.

• Sumário Geral de Impureza

Consulta

• • Nome para App: Sumário Geral de Impureza
  • Tipo Consulta: Portal/Mobilidade
  • Classificação Consulta: Produção

Filtros

• • FORNEC: WS_FILTRO_FORNECEDOR
  • CD_UNID_IND: WS_FILTRO_UNIDIND
  • DT_INICIAL: NULL
  • DT_FINAL: NULL
  • FAZENDA_INICIAL: WS_FILTRO_UNIDPROD
  • FAZENDA_FINAL: WS_FILTRO_UNIDPROD
  • CD_FRENTE: WS_FILTRO_FRENTRANSP
  • TBL_BCK_SAFRA: WS_FILTRO_SAFRA

Campos

• • DE_UPNIVEL1: Prioridade da Quebra: Nivel 1
  • DE_FUNC: Prioridade da Quebra: Nivel 2
  • Todos outros campos devem estar com Prioridade da Quebra como DETALHE.
  • Marcar Exporta Mobilidade para os campos que deseja exibir no App Minha Colheita.

• Sumário de Produção por Operadores

Consulta

• • Nome para App: Sumário Produção/Operador
  • Tipo Consulta: Portal/Mobilidade
  • Classificação Consulta: Produção

Filtros

• • FORNEC: WS_FILTRO_FORNECEDOR
  • CD_UNID_IND: WS_FILTRO_UNIDIND
  • DT_INICIAL: NULL
  • DT_FINAL: NULL
  • FAZENDA_INICIAL: WS_FILTRO_UNIDPROD
  • FAZENDA_FINAL: WS_FILTRO_UNIDPROD
  • CD_FRENTE: WS_FILTRO_FRENTRANSP

Campos

• • NOME_OPERADOR: Prioridade da Quebra: Nivel 1
  • CARGAS: Prioridade da Quebra: Nivel 2
  • Todos outros campos devem estar com Prioridade da Quebra como DETALHE.
  • Marcar Exporta Mobilidade para os campos que deseja exibir no App Minha Colheita.

03. TELA DOS FILTROS

Outras Ações / Ações relacionadas

04. TELAS DOS FILTROS

Principais Campos e Parâmetros