Esse manual tem como objetivo detalhar a instalação do Portal Agrícola. Antes de seguir o passo a passa da instalação, ler e realizar o procedimento de Requisitos para Instalação do Portal Agrícola.
1. Inicio da Instalação:
Após download do instalador da JDK 8 processada com a instalação. Na próxima etapa configurar o diretório onde será instalado. Após confirmar e prosseguir, será iniciado o processo de instalação:
Na sequência será solicitado o local de instalação do JRE (Java Runtime Environment). A instalação deste Runtime não é necessário para o funcionamento do Portal Agrícola, mas recomenda-se sua instalação (caso o sistema já não tenha uma versão instalada) pois os consoles de administração do servidor de aplicações se baseiam em Applets, que exigem um JRE.
Como caminho para o JRE informe C:/totvs/jre
Ao clicar em Finish encerramos a instalação. Não é necessário registrar o produto (opcional).
2. Variáveis de Ambiente:
Definir as seguintes variáveis de ambiente abaixo como sendo do sistema:
JAVA_HOME=C:\totvs\jdk CLASSPATH=.; PATH=%JAVA_HOME%\bin;(restante do path)
3. Várias instalações do JDK
Caso a máquina já contenha uma versão do JDK instalada e outros softwares usem essa JDK é recomendado realizar a instalação da JDK homologada do Portal Agrícola e indicar para o JBoss qual JDK será usada.
Para indicar ao JBoss qual a versão JDK que será usada é necessário editar o arquivo run.conf.bat (lembrando que este nome é o padrão, se houver mais de uma instância instalada, é necessário editar o arquivo da instância que deseja alterar, exemplo “runportalagricola.conf.bat” ou “run-manfro.conf.bat”), estes arquivos ficam na pasta JBOSS_HOME\bin .
Na linha 30 onde atribuímos valor a variável JAVA_HOME podemos ver o seguinte texto set "JAVA_HOME=C:\Program Files\Java\jdk1.8.0_92", ela deverá conter o correto da JDK 8. Exemplo:
4. Teste da Instalação
Ao acessar o terminal o comando abaixo pode ser executado para verificar se a instalação e configuração foram realizadas com sucesso. Após a execução do comando deve ser possível visualizar as informações da versão instalada.
C:\> java –version
5. Servidor de Aplicações JBoss 6.1
a. Versões do JBoss suportadas pelo Portal Agrícola
Para a implantação do Portal Agrícola, a instalação de um Servidor de Aplicações é exigida. O único servidor de aplicações homologado para a execução do Portal Agrícola, atualmente é o JBoss Application Server, em sua versão 6.1.0.
b. Obtenção do Software
O software JBoss AS é open-source e multiplataforma, o que significa que seu instalador pode ser utilizado para diversos sistemas operacionais e plataformas (32 bits e 64 bits) que suportem a plataforma Java. Apesar de estar gratuitamente disponível para download no site do fornecedor, obtenção do instalador do JBoss para o Portal Agrícola deve ser feita através do FTP disponibilizado pela TOTVS, pois o mesmo já estará pré-configurado com as bibliotecas necessárias para o funcionamento do Portal Agrícola. Portanto, para a obtenção do instalador, é necessário entrar em contato com o suporte da TOTVS para obter os dados de acesso ao FTP.
c. Requisitos de espaço em disco
Para a instalação do JBoss AS 6.1.0, no mínimo 15GB devem estar disponíveis no disco de instalação.
d. Concorrência de outros serviços Java
Há casos em que o servidor destinado à instalação do aplicativo já possui outras aplicações Java instaladas, como aplicações desktop (standalone) ou servidoras. Quando este for o caso, a equipe técnica da TOTVS deverá ser notificada com a descrição de tais aplicativos/serviços, afim de que se possam prever possíveis conflitos na instalação.
e. Inicio da Instalação
Uma vez obtido o pacote, a instalação consiste basicamente em descompactar o mesmo. Portanto descompacte-o no diretório de instalação. A recomendação é o diretório C:/totvs:
A instalação está concluída! Nas seções seguintes serão apresentadas algumas configurações e uma breve apresentação dos principais recursos do servidor.
f. Ajustando Parâmetros de Memória
O Portal Agrícola necessita de 4GB para que a aplicação funcione corretamente abaixo é possível observar como é configurado o ajuste de de memória utilizada pela JVM (Java Virtual Machine ) utilizada pelo Jboss, essa configuração é realizada no arquivo run.conf.bat que está dentro do diretório bin, da instalação do Jboss.
Os parâmetros -Xms e -Xmx determinam, respectivamente, a quantidade inicial e a quantidade máxima de memória que pode ser utilizada pelo servidor, e devem ser configuradas para o mesmo valor, por questões de desempenho. Neste caso (do exemplo) a configuração determina 4096MB = 4GB de memória, que pode ser aumentado de acordo com a necessidade e disponibilidade de recursos do servidor.
O parâmetro -XX:MaxPermSize é importante aumentar o seu valor porque quando trabalha com JSP ou JSF que é o caso do Portal Agrícola é necessário manter classes adicionais em memória então quando aumenta o valor desse parâmetro o Garbage Collector ( Coletor de lixo de memória) mantem mais classes na memória e só remove após utilização.
O parâmetro -Djava.io.tmpdir é utilizado para definir o diretório temporário da aplicação que no exemplo acima aponta para o próprio temp do servidor.
Para maiores informações sobre os possíveis parâmetros e seus significados, acessar a documentação http://www.oracle.com/technetwork/java/javase/gc-tuning-6-140523.html
g. Testar se o servidor está ok
Para testar a instalação execute o arquivo run.bat. Isso irá inicializar o servidor em modo stand-alone. Observe os logs no prompt de comando:
Ao final do log é possível constatar o tempo de inicialização do servidor.
Para comprovar que o servidor está realmente sendo executado, acesso através de um navegador o seguinte endereço: http://localhost:8080/
Para encerrar o modo stand-alone basta clicar CTRL + C ou fechar a janela do prompt de comando.
h. Configurar como serviço no Windows
Dentro do diretório bin da instalação do JBoss é possível encontrar os arquivos jbosssvc.exe e service.bat. Estes dois arquivos são utilizados para a execução e configuração do serviço, respectivamente.
O arquivo service.bat contém as configurações para a execução do serviço. Dentre as configurações encontradas neste arquivo existe uma que define o nome pelo qual o serviço do JBoss será identificado. Esta configuração pode ser vista no trecho abaixo:
set SVCDISP=1.Portal Agricola set SVCDESC=JBoss Application Server 6.1.0 Final/Platform: Windows %PROCESSOR_ARCHITECTURE% set NOPAUSE=Y
Se for necessário, as descrições (em vermelho) podem ser modificadas para outro nome.
O arquivo service.bat utiliza os arquivos de inicialização e finalização do JBoss (run.bat e shutdown.bat). Se for necessário informar parâmetros de inicialização ou finalização ao JBoss (como quando há a necessidade de inicializar uma instância com uma configuração em específico) isto pode ser feito nas seções apresentadas abaixo..
Para passar parâmetros adicionais na inicialização:
jbosssvc.exe -p 1 "Starting %SVCDISP%" > run.log call run.bat -b 192.168.0.1 < .r.lock >> run.log 2>&1 jbosssvc.exe -p 1 "Shutdown %SVCDISP% service" >> run.log
Para passar parâmetros adicionais na finalização:
jbosssvc.exe -p 1 "Shutting down %SVCDISP%" > shutdown.log call shutdown -S --server=192.168.0.1:1099 < .s.lock >> shutdown.log 2>&1 jbosssvc.exe -p 1 "Shutdown %SVCDISP% service" >> shutdown.log
Abaixo é mostrado um exemplo se fosse necessário criar mais de uma instância no mesmo servidor do Portal Agrícola e como alterar a porta padrão da aplicação.
call run-homologacao.bat -c homologacao -b 192.168.0.1 -Djboss.service.binding.set=ports-01 < .rhomologacao.lock >> run-homologacao.log 2>&1
call shutdown -S --server=192.168.0.1:1099 < .s-homologacao.lock >> shutdown-homologacao.log 2>&1
Para realizar a instalação do serviço, basta executar no prompt de comando (como administrador), e a partir do diretório JBOSS_HOME/bin, o seguinte comando:
JBOSS_HOME/bin> service.bat install
Este comando precisa ser realizado apenas uma vez. Para realizar a desinstalação o procedimento é parecido:
JBOSS_HOME/bin> service.bat uninstall
ATENÇÃO: caso a instalação do serviço falhe, tenha certeza de ter aberto o prompt de comando com permissão de Administrador, para a execução dos comandos:
Após a configuração é possível ver o serviço disponível como qualquer outro serviço do Windows. Configure-o para inicialização automática e reinicie o servidor, para que o serviço possa ser iniciado (isto pode ser necessário caso o usuário em execução não tenha permissão para inicialização de serviços).
i. Limpeza dos diretórios temporários
Os diretórios temporários que podem ser excluídos são apenas os eviênciados.
j. Problemas na instalação
Caso ocorra algum problema na instalação, consultar o manual Online citado nas referências para resolução, e em segundo nível o suporte da TOTVS.
6. Servidor/Serviço de SMTP
a. Conta de E-Mail
Para a utilização correta do Portal Agrícola, deve-se possuir um servidor ou serviço de SMTP que seja capaz de enviar e-mails. Tal necessidade é justificada pelo fato de que os fornecedores (ou usuários do Portal Agrícola) solicitarão acesso à ferramenta e todas as notificações como, por exemplo, (i) recebimento de solicitação de acesso, (ii) envio de resultado de aprovação (aprovado ou rejeitado), (iii) mensagem com dados de acesso e quaisquer outras notificações são encaminhadas por mensagens eletrônicas. Para isso, no momento da instalação do Servidor de Aplicações JBoss e do Portal Agrícola, as seguintes informações devem ser conhecidas: Usuário: usuário (sem e-mail) de autenticação no servidor/serviço de SMTP. o Exemplo: <attribute name="User">XXX</attribute> Senha: senha de autenticação no servidor/serviço de SMTP. o Exemplo: <attribute name="Password">XXX</attribute> Protocolo SMPT: protocolo a ser utilizado para armazenamento de mensagens. Por padrão, o valor “pop3” deve ser informado. o Exemplo: <property name="mail.store.protocol" value="pop3"/> Protocolo de Transporte: protocolo a ser utilizado para transporte de mensagens. Por padrão, o valor “smtp” deve ser informado. o Exemplo: <property name="mail.transport.protocol" value="smtp"/> E-Mail do Usuário: usuário (com e-mail) de autenticação no servidor/serviço de SMTP. o Exemplo: <property name="mail.user" value="XXX@exemplo.com.br"/> Host do Usuário (POP3): host (domínio) de autenticação no servidor/serviço de SMTP. o Exemplo: <property name="mail.pop3.host" value="mail.exemplo.com.br"/> Host SMTP: host (domínio) de autenticação no servidor/serviço de SMTP. o Exemplo: <property name="mail.smtp.host" value="mail.totvs.com.br"/> Porta SMTP: porta do host (domínio) de autenticação no servidor/serviço de SMTP. o Exemplo: <property name="mail.smtp.port" value="XXX"/> E-Mail do Usuário Remetente: usuário (com e-mail) que será o remetente das mensagens de notificação encaminhadas pelo serviço de Mail do Servidor de Aplicações. o Exemplo: <property name="mail.from" value="XXX@exemplo.com.br"/> Utiliza autenticação: Verdadeiro (true) ou Falso (false) sobre a utilização de autenticação SMTP. Por padrão, o valor “true” deve ser informado. Entretanto, tal configuração depende da necessidade do cliente e/ou do servidor/serviço de SMTP disponibilizado para o Portal Agrícola. o Exemplo: <property name="mail.smtp.auth" value="true"/> Habilita TTLS: Verdadeiro (true) ou Falso (false) sobre a habilitação de autenticação por TTLS. Por padrão, o valor “true” deve ser informado. Entretanto, tal configuração depende da necessidade do cliente e/ou do servidor/serviço de SMTP disponibilizado para o Portal Agrícola. o Exemplo: <property name="mail.smtp.starttls.enable" value="true"/>
As informações listadas abaixo serão configuradas no arquivo “mail-service.xml”, localizado na pasta “deploy” do diretório do Servidor de Aplicações JBoss.
b. Configurando o arquivo mail-service.xml
Para localizar o arquivo mail-service.xml siga os passos abaixo:
A imagem abaixo representa o arquivo que precisa ser alterado, cada atributo do arquivo foi explicado na seção a – Conta de EMail
7. Instalação da Aplicação do Portal Agrícola
A aplicação Portal Agrícola é desenvolvida em Java, como um componente que deve ser implantado no servidor de aplicações JBoss 6.1.0. O arquivo da aplicação, disponibilizado para implantação, chama-se PIMSServer.ear.
Esse arquivo encontra-se disponível na central de download, caso não esteja disponível, por gentileza, envie um email solicitando o arquivo para [email protected].
Durante a implantação, ou então quando for necessário realizar uma atualização da aplicação, este arquivo deverá ser copiado para o diretório deploy, cujo caminho está descrito a seguir:
C:\totvs\jboss-pimsserver-oracle11\server\default\deploy
NOTA: lembre-se que este caminho pode mudar de acordo com o local escolhido para a instalação do servidor de aplicações JBoss.
NOTA: quando for realizar a atualização da aplicação, tenha certeza de ter realizado uma cópia de segurança da versão que está sendo substituída, com uma cópia do arquivo em local adequado antes de sua remoção para a substituição pelo novo arquivo.
a. Datasources para conexão com o banco de dados
Para que a aplicação funcione adequadamente, é necessário configurar o acesso ao banco de dados em um arquivo de configuração de datasource. O arquivo em questão é o PIMSPAGRIDS-oracle-ds.xml, e está localizado no diretório deploy, citado acima.
Neste arquivo devem ser informados o IP (ou nome de rede) do servidor onde está configurado o banco de dados, a porta de conexão, o nome da instância, usuário e senha de acesso. O exemplo abaixo, (específico para o Oracle) apresenta estas informações em destaque:
Quando o servidor de banco de dados estiver configurado em RAC, é necessário que o client do Oracle esteja instalado na máquina, e que seu diretório de instalação esteja referenciado nas variáveis de ambiente, como PATH, por exemplo.
Além disso, existem mudanças na maneira de se configurar o datasource. Tomemos como exemplo a seguinte entrada no tsnames.ora:
Exemplo de configuração resultante no datasource:
b. Criptografia de senha no Datasource
É possível criptografar a senha exposta no Datasource para uma maior segurança, principalmente em ambientes de produção. Para isso é necessário, inicialmente, criar um módulo de segurança no arquivo JBOSS_HOME/server/default/conf/ loginconfig.xml. A criação do módulo de segurança consiste na inclusão de um trecho de XML, como o que está exemplificado abaixo, no arquivo login-config.xml:
Na configuração acima destacam-se os seguintes itens:
PIMSCSDSRealm: este é o nome do módulo de segurança que está sendo criado. Este nome é importante pois será referenciado no datasource, posteriormente.
TESTE: este é o nome do usuário de banco de dados a ser utilizado para a conexão.
6ee9d08cc488f63: esta é a senha já criptografada do usuário utilizado para acessar o banco de dados. Para realizar a criptografia da senha acesse o diretório de instalação do JBoss pelo prompt de comando e execute o comando abaixo, substituindo “SENHA” pela senha do usuário. O comando deve ser digitado todo em uma única linha:
java -cp client/jboss-logging.jar;lib/jbosssx.jar org.jboss.resource.security.SecureIdentityLoginModule SENHA
Exemplo de execução do comando:
PIMSCSDS: Este deve ser o nome JNDI do datasource configurado para o banco de dados que utilizará o módulo de segurança.
Abaixo está um exemplo do módulo acima configurado dentro do arquivo login-config.xml:
Abaixo estão exemplos das configurações do datasource (conexão direta e RAC) utilizando o módulo de segurança:
8. Instalação de 2 Serviços Jboss no Windows
O processo de instalação de dois serviços é parecido com o processo de instalar um único serviço, apenas algumas configurações a mais são necessárias.
É preciso estar atento apenas a alguns detalhes:
- É preciso ter dois endereços IP disponíveis. Muitas vezes será necessário criar um IP virtual, pois a máquina pode não ter duas placas de rede ativas.
Para a configuração de dois ou mais serviços do JBoss no Windows não é necessário que mais de uma instalação do JBoss seja utilizada. Para isso será utilizada uma única instalação com configurações (contextos de execução) diferentes. Para a finalidade deste exemplo, vamos supor duas configurações (contextos de execução) que precisam ser iniciadas como serviço: produção e homologação. Estas configurações são representadas por dois diretórios físicos:
É importante planejar a instalação de mais de duas instâncias definindo, por exemplo, qual IP será utilizado para cada uma.
Abaixo um plano de instalação para este exemplo
- Configuração: Homologação
Diretório de configuração: C:\proxima\jboss\server\homologacao
IP: 10.0.0.79 - Configuração: Produção
Diretório de configuração: C:\proxima\jboss\server\producao
IP: 10.0.0.54
Para criar os diretórios homologacao e producao faça uma cópia do diretório default que se encontra dentro do diretório server e mude o nome das cópias para os nomes indicados (homologacao e producao). Vamos partir para as configurações necessárias. Primeiramente é necessário criar duas cópias do arquivo run.bat, uma para cada configuração a ser criada:
Para cada um destes arquivos, o seguinte ponto deverá ser modificados (aqui mostrados em apenas no arquivo runhomologacao.bat, por brevidade):
A referência ao arquivo .bat executável deve ser atualizada para refletir o mesmo nome do arquivo corrente, neste caso como estamos editando o arquivo run-homologacao.bat este deve ser o nome.
Agora é necessário criar duas cópias do arquivo service.bat, uma para cada configuração:
Para cada um destes arquivos, os seguintes pontos deverão ser modificados (aqui mostrados apenas no arquivo servicehomologacao.bat, por brevidade):
[ 1 ] e [ 2 ] Os nomes dos serviços deverão refletir a identidade da configuração, para facilitar sua identificação no painel de serviços do Windows.
[ 3 ] O nome do arquivo de serviço para a configuração deve ser modificado.
[ 4 ] As referências ao nome do arquivo de lock de execução (.r.lock) deverão ser modificadas para refletir a configuração.
[ 5 ] As referências ao nome do arquivo executável (.bat) para a configuração deverão ser atualizados.
[ 6 ] Deverão ser indicados o nome da configuração a ser executada (parâmetro –c) e o endereço IP no qual a configuração será executada (parâmetro –b).
[ 7 ] As referências ao arquivo de log de execução (run.log) deverão ser modificadas para refletir a configuração.
[ 8 ] As referências ao arquivo de lock de shutdown (.s.lock) deverão ser modificadas para refletir a configuração.
[ 9 ] As referências ao arquivo de log de shutdown deverão ser modificadas para refletir a configuração.
[ 10 ] O endereço IP da configuração deverá ser atualizado para as rotinas de shutdown. As mesmas modificações deverão ser feitas em outros pontos do arquivo, conforme demonstrado.
Depois de feitas as modificações, basta acessar o prompt de comando como administrador e instalar os serviços:
Depois disso os serviços serão instalados, podendo serem configurados para a inicialização automática, e podem ser inicializados:
Ao acessar o console de administração web do JBoss podemos verificar a execução dos diferentes contextos:
10.0.0.54
Contexto de Produção
10.0.0.79
Contexto de homologação
Se for necessário realizar modificações nas configurações de memória, ou até mesmo dos endereços IP dos serviços, não é necessário reinstalar os serviços. Nestes casos basta parar a execução dos serviços, realizar as alterações necessárias e iniciálos novamente.
9. Pacote Microsoft Office e Aplicação Leitora de PDF
a. Aplicações Microsoft Office
O Portal Agrícola faz uso de recursos do pacote Microsoft Office para exportar e gerar dados nos formato XLS/XLSX e DOC/DOCX. Para isso, o pacote Office deve estar instalado no Servidor de Aplicações (para a geração e manipulação dos documentos nos formatos citados), bem como na máquina do usuário (caso ele necessite visualizar os conteúdos dos arquivos). As versões homologadas do pacote Microsoft Office são:
- MS Office 2013
- MS Office 2010
- MS Office 2007
b. Aplicação leitora de PDF
O Portal Agrícola também faz uso de recursos no formato PDF. Para isso, uma ferramenta leitora de PDF deve estar instalada no Servidor de Aplicações (para a geração e manipulação dos documentos no formato PDF), bem como na máquina do usuário (caso ele necessite visualizar os conteúdos dos arquivos).
10. Navegadores de Internet
a. Configuração homologada
O Portal Agrícola é mais bem visualizado na resolução 1024 por 768 pixels ou maiores e, para seu correto funcionamento, utilize os navegadores Internet Explorer (10 ou superior) ou Chrome (40 ou superior).
11. Liberações necessárias para o funcionamento correto do Portal Agricola.
a. Portas ou itens que precisam ser liberados no servidor onde ficará o Portal Agricola.
Para atualização do portal agrícola, por gentileza, leia o material Manual de Atualização - Portal Agrícola.
12. Principais funcionalidades e Recursos
12.1 Solicitação de Acesso
Objetivo: Possibilita usuários, de modo especial, fornecedores, solicitar acesso ao portal agrícola como usuário visualizador de informações. O usuário solicitante terá acesso ao portal agrícola somente depois de ler e aceitar as condições do termo de responsabilidade apresentadas, preencher o formulário com os seus dados, confirmar o pedido de acesso e passar pela aprovação do administrador responsável do portal agrícola. Após a confirmação da solicitação de acesso, emails são enviados tanto ao usuário administrador do portal quanto ao usuário solicitante, informando-os sobre a situação do processo (incialmente, aguardando aprovação). O termo de responsabilidade é cadastrado e formatado no cadastro de termos de responsabilidade pelo administrador. No formulário de dados do usuário solicitante devem ser informados os campos nome (permite no máximo 100 caracteres), usuário (permite no máximo 50 caracteres e não permite seu cadastro caso o usuário já existe), CPF (caso o campo CPF seja informado o campo CNPJ deixa de ser obrigatório), CNPJ (caso o campo CNPJ seja informado o campo CPF deixa de ser obrigatório), e-mail, CEP, endereço, número, unidade federativa e município. Os formatos (templates) dos emails são configurados no cadastro de template apenas pelo administrador do portal. Os templates disponíveis para alteração/modificação são: aguardando aprovação (para administrador), aguardando aprovação (para usuário solicitante), aprovação/reprovação (para administrador) e aprovação/reprovação (para solicitante – com envio de senha gerada pelo portal agrícola apenas para a situação de aprovação).
Menu: Não se aplica
Termo de Responsabilidade:
O usuário solicitante de acesso do portal agrícola deve ler e aceitar as condições do termo de responsabilidade apresentado. O termo de responsabilidade é cadastrado apenas pelo usuário administrador do portal agrícola por meio do cadastro de termo de responsabilidade e não pode ser alterado a partir do momento em que um ou mais usuários estejam relacionados com o mesmo. O termo de responsabilidade vigente é o que possui a data mais atual.
Dados do usuário solicitante:
Campos Obrigatórios:
Nome: Permite o usuário solicitante de acesso do portal agrícola informar o seu nome. O campo nome permite no máximo 100 caracteres.
Usuário: Permite o usuário solicitante de acesso do portal agrícola informar o usuário para realização do login no portal agrícola. O campo usuário permite no máximo 50 caracteres alfanuméricos. Uma prévalidação é realizada para verificar se o usuário informado já consta no portal agrícola. Caso esteja em duplicidade, o campo é limpado para que um novo usuário seja informado.
Sexo: Permite o usuário solicitante de acesso do portal agrícola informar o sexo, masculino ou feminino. Por padrão o campo sexo é Masculino.
E-mail: Permite o usuário solicitante de acesso do portal agrícola informar o e-mail. O e-mail informado deve ser válido. O status (aguardando aprovação, aprovado e reprovado) da solicitação de acesso, bem como os dados de acesso (usuário e senha – no caso da solicitação de acesso seja aprovada pelo administrador do portal) será enviado para o e-mail informado.
CEP: Permite o usuário solicitante de acesso do portal agrícola informar o CEP referente ao endereço.
Endereço: Permite o usuário solicitante de acesso do portal agrícola informar o endereço.
Número: Permite o usuário solicitante de acesso do portal agrícola informar o número referente ao endereço.
Unidade Federativa: Permite o usuário solicitante de acesso do portal agrícola selecionar a unidade federativa referente ao endereço.
Município: Permite o usuário solicitante de acesso do portal agrícola informar o município referente ao endereço.
Demais Campos:
E-mail alternativo: Permite o usuário solicitante de acesso do portal agrícola informar um e-mail alternativo. O e-mail alternativo informado deve ser válido. O status (aguardando aprovação, aprovado e reprovado) da solicitação de acesso, bem como os dados de acesso (usuário e senha – no caso da solicitação de acesso seja aprovada pelo administrador do portal) serão enviados tanto para o e-mail informado no campo e-mail quanto para o e-mail alternativo.
Complemento: Permite o usuário solicitante de acesso do portal agrícola informar o complemento referente ao endereço.
Bairro: Permite o usuário solicitante de acesso do portal agrícola informar o bairro referente ao endereço.
Telefone Residencial: Permite o usuário solicitante de acesso do portal agrícola informar um telefone residencial.
Telefone Comercial: Permite o usuário solicitante de acesso do portal agrícola informar um telefone comercial.
Telefone Celular: Permite o usuário solicitante de acesso do portal agrícola informar um telefone celular.
Observação: Permite o usuário solicitante de acesso do portal agrícola descrever alguma observação que julgue necessária.
Campos Condicionais:
CPF: Permite o usuário solicitante de acesso do portal agrícola informar o CPF. O campo CPF é obrigatório caso não seja informado o CNPJ no campo CNPJ.
CNPJ: Permite o usuário solicitante de acesso do portal agrícola informar o CNPJ. O campo CNPJ é obrigatório caso não seja informado o CPF no campo CPF.
Conclusão:
Para concluir o processo de solicitação de acesso, é necessário clicar no botão confirmar. Neste momento é enviado dois emails:
Um para o usuário solicitante do portal agrícola, informando-o que o usuário solicitou acesso ao portal agrícola e aguarda a avaliação de um administrador e que um novo e-mail será enviado em breve, informando-o a respeito da solicitação de acesso.
E um e-mail para o administrador do portal agrícola, informando-o que o usuário solicitou acesso ao portal agrícola e aguarda a avaliação de um administrador.
Para que o administrador do portal agrícola realize a avaliação de solicitação de acesso pelo portal agrícola é necessário que acesse o cadastro de usuário por meio do menu Básico > Usuário, em seguida selecione o item “Aguardando avaliação” da coluna status da tabela/grid de usuários, depois selecione o usuário a ser avaliado e em ações relacionadas escolha a opção “Alterar status”.
Neste momento o usuário administrador do portal agrícola pode aprovar, reprovar ou desabilitar o status do usuário selecionado.
Após o administrador do portal agrícola avaliar a solicitação de acesso (status de avaliação igual aprovado), dois e-mails são enviados um para administrador informando que o ele avaliou a solicitação de acesso do usuário e o pedido foi aprovado ou reprovado.
Uma vez aprovado, o administrador deve efetuar o relacionamento do usuário solicitante com uma ou mais fornecedores listado na tabela de fornecedores. O usuário terá permissão de acesso apenas às informações referentes aos fornecedores a ele relacionado.
E outro email é enviado para o usuário solicitante informando que a sua solicitação de acesso foi avaliada por um administrador do portal agrícola, que o pedido foi aprovado e que para acessar o portal deve fazer uso dos dados de acesso (usuário e senha informado no email).
Caso a solicitação de acesso foi avaliada por um administrador do portal agrícola e o pedido foi reprovado o email enviado para o usuário solicitante informa-o que a sua solicitação de acesso foi avaliada por um administrador do portal agrícola e que seu pedido foi reprovado.
12.2 Recuperar usuário ou senha
Objetivo: Possibilita o usuário do portal agrícola, quando necessário, recuperar os dados de acesso (usuário e senha). Para recuperar os dados de acesso o usuário deve informar um dos dois e-mails (email ou email alternativo) utilizados no momento do cadastro do usuário, para que os novos dados de acesso sejam enviados.
Menu: Não se aplica
12.3 Autenticação
Objetivo: Possibilita a autenticação do usuário no portal agrícola por meio dos dados de acesso (usuário e senha) enviado por email pelo administrador do portal. Para se autenticar no portal agrícola o usuário deve informar o usuário no campo usuário, a senha no campo senha e clicar no botão entrar, localizados na parte superior da página inicial do portal agrícola.
Menu: Não se aplica
Campos Obrigatórios:
Usuário: Usuário utilizado para autenticação no portal agrícola.
Senha: Senha utilizada para autenticação no portal agrícola. A senha é gerada automáticamente e enviada por email pelo administrador do portal.
Demais funcionalidades:
Solicitar acesso: Permite usuário em geral solicitar acesso ao portal agrícola.
Recuperar usuário e senha: Permite o usuário, já cadastrado no portal agrícola, que recupere seus dados de acesso.
Lembrar: Quando marcado lembra o usuário de acesso ao portal.
Entrar: Permite que o usuário acesse o portal agrícola depois de informado os dados de acesso (usuário e senha) válidos.
12.4 Autenticação por usuário administrador
Objetivo: A autenticação por usuário administrador permite o acesso ao cadastros de usuários, notícias, FAQs, links e termos de responsabilidade, as configurações de templates, layout, parâmetros e documentos e as visualizações de consultas, notícias, FAQs, links, widgets, auditoria e contato
12.5 Autenticação por usuário comum
Objetivo: A autenticação por usuário comum permite a visualização de consultas, notícias, FAQ, link, contato, widgets de climatologia e cotações.
12.6 Cadastro de Termo de Responsabilidade
Objetivo: Permitir que o usuário administrador do portal agrícola cadastre o termo de responsabilidade.
Menu: Básico > Termo de Responsabilidade
Campo Obrigatório:
Código: Código do termo de responsabilidade. O campo código, do cadastro de termo de responsabilidade, é único e permite no máximo 30 caracteres alfanuméricos.
Data de Publicação: Data de publicação do termo de responsabilidade. O termo de responsabilidade vigente é o que possui a data de publicação mais atual.
Usuário Criador: Usuário responsável pela criação do termo de responsabilidade. O campo usuário criador é preenchido automaticamente com o usuário administrador logado e não permite edição.
Conteúdo: Conteúdo do termo de responsabilidade. O campo conteúdo permite que o usuário administrador do portal agrícola descreva e formate o conteúdo do termo de responsabilidade.
Demais Campos:
Anexo de Termo de Responsabilidade: Anexo do termo de responsabilidade na extensão .PDF. O campo anexo de termo de responsabilidade permite que o usuário administrador do portal agrícola selecione, anexe e visualize o arquivo referente ao termo de responsabilidade na extensão .PDF.
Anexo de Contrato de Termo de Responsabilidade: Anexo do contrato do termo de responsabilidade na extensão .DOCX. O campo anexo de contrato de termo de responsabilidade permite que o usuário administrador do portal agrícola selecione, anexe e visualize o arquivo referente ao contrato de termo de responsabilidade na extensão .DOCX. O portal agrícola possibilita que os dados referentes ao usuário sejam preenchidos de forma automática no arquivo .DOCX, para isto, pode-se fazer uso de campos chave que serão substituídos por valores. Os campos chave disponíveis são:
Exemplo:
Anexo do contrato do termo de responsabilidade com os campos chaves
Contrato do termo de responsabilidade do usuário logado com os campos chaves substituídos de forma automática
Demais Funcionalidades:
Visualizar Contrato: Permite ao usuário do portal agrícola a visualização do contrato do termo de responsabilidade. Está funcionalidade esta disponível para o usuário por meio do botão Visualizar contrato do Visualizar perfil.
Validações:
O termo de responsabilidade não pode ser alterado e/ou removido depois de relacionado a um ou mais usuário.
12.7 Cadastro de Notícia
Objetivo: Pemitir que o usuário administrador do portal agrícola cadastre as notícias desejadas. As notícias cadatradas são visualizdas na página inicial do portal agrícola.
Menu: Básico > Notícia
Campos Obrigatórios:
Código: Código da notícia. O campo código, do cadastro de notícia, é único e permite no máximo 30 caracteres alfanuméricos.
Título: Título da notícia. O campo título da notícia permite no máximo 200 caracteres alfanuméricos.
Resumo: Resumo da notícia. O campo resumo, do cadastro de notícia, permite que o usuário administrador do portal agrícola descreva, de forma resumida, a notícia e a formate. O resumo da notícia pode ser visualizado na página inicial do portal agrícola por todos que o acessa.
Conteúdo: Conteúdo da notícia. O campo conteúdo, do cadastro de notícia, permite que o usuário administrador do portal agrícola descreva e formate o conteúdo completo da notícia. O conteúdo completo da notícia pode ser visualizado por meio do botão Saiba mais localizado na página inicial do portal agrícola por todos que o acessa.
Usuário Criador: Usuário responsável pela inserção/criação da notícia. O campo usuário criador, do cadastro de notícia, é preenchido automaticamente com o usuário administrador logado e não permite edição.
Fonte: Fonte da notícia.
Data de Publicação: Data de publicação da notícia. Ao inserir uma nova notícia, o campo data de publicação é preenchido inicialmente com a data atual e permite sua edição.
Demais Campos:
Imagem: Imagem da notícia. O campo imagem, do cadastro de notícia, permite que o usuário administrador do portal agrícola defina uma imagem para a notícia. Recomenda-se que a imagem possua as dimensões de 266 pixels de altura por 200 pixels de comprimento. Caso a imagem não possua as dimensões recomendada, o sistema dimensionará automaticamente a imagem. Será definida uma imagem padrão para a notícia caso o administrador do portal agrícola não a informe.
Categoria: Categoria da notícia.
RSS: Feed RSS (Rich Site Summary) de notícia. Campo meramente informativo.
12.8 Cadastro de Link
Objetivo: Pemitir que o usuário administrador do portal agrícola cadastre os links desejados.
Menu: Básico > Link
Campos Obrigatórios:
Título: Título para o link. O campo título, do cadastro de link, permite que o usuário administrador do portal agrícola informe um título para o link com no máximo 100 caracteres alfanuméricos.
URL: Endereço (URL) do link.
Sequência: Sequência para o link. A sequência indica a posição em que o link será posicionado em relação a todos os links cadastrado.
Demais Campos:
Descrição: Descrição para link. O campo descrição, do cadastro de link, permite que o usuário administrador do portal agrícola, descreva e formate a descrição referente ao link.
Favorito: Link favorito. Campo meramente informativo.
Público: Link público. Campo meramente informativo.
12.9 Cadastro de FAQ
Objetivo: Permite que o usuário administrador do portal agrícola cadastre as categorias e os tópicos de FAQ, onde os tópicos são perguntas e respostas e as categorias são grupos. O cadastro de FAQ serve de suporte ao usuário e esclarecimento de dúvidas frenquentes sobre o portal agrícola.
Menu: Básico > FAQ
Campos Obrigatórios:
Código: Código da categoria de FAQ. O campo código, do cadastro de categoria de FAQ, é único e permite que usuário administrador do portal agrícola informe no máximo 30 caracteres alfanuméricos.
Descrição: Descrição da categoria de FAQ. O campo descrição, do cadastro de categoria de FAQ, permite que o usuário administrador do portal agrícola, descreva a categoria da FAQ com no máximo 100 carateres alfanuméricos.
Sequência: Sequência da categoria de FAQ. A sequência indica a posição em que a categoria será posicionado em relação a todas as categorias cadastradas.
Campos Obrigatórios:
Código: Código do tópico de FAQ. O campo código, do cadastro de tópico de FAQ, é único por categoria e permite que usuário administrador do portal agrícola informe no máximo 30 caracteres alfanuméricos.
Pergunta: Pergunta do tópico de FAQ. O campo pergunta, do cadastro de tópico de FAQ, permite que o usuário administrador do portal agrícola informe e formate a pergunta.
Resposta: Resposta do tópico de FAQ. O campo resposta, do cadastro de tópico de FAQ, permite que o usuário administrador do portal agrícola informe e forme a resposta referente a pergunta.
Sequência: Sequência do tópico de FAQ. A sequência indica a posição em que o tópico será posicionado em relação a todos os tópicos cadastrados para a categoria de FAQ.
12.10 Configuração de Templates
Objetivo: Permite que o usuário administrador do portal agrícola configure os templates de envio de e-mail referente a solicitação de acesso e contato.
Menu: Configuração > Template
Campos Obrigatórios:
Código: Código do template. O campo código, do cadastro de template, é único e permite que o usuário administrador do portal agrícola informe no máximo 30 caracteres alfanuméricos. Não altere os códigos dos templates padrões.
Descrição: Descrição do template. O campo descrição, do cadastro de template, é único e permite que o usuário administrador do portal agrícola informe no máximo 100 caracteres alfanuméricos.
Conteúdo: Conteúdo do template. O campo conteúdo, do cadastro de template, permite que o usuário administrador do portal agrícola informe o conteúdo do template e o formate.
Usuário Criador: Usuário responsável pela criação do template. O campo usuário criador é preenchido automaticamente com o usuário administrador logado e não permite edição.
Data de Criação: Data de criação do template. O campo data de criação, do cadastro de template, é preenchido automaticamente com a data atual e não permite edição.
Padrão: Template padrão.
Templates padrões pré cadastrados
Atentar-se para que seja realizado alterações apenas no conteúdo dos templates padrões pré cadastrados, ou seja, não alterar o códigos e a descrição dos templates apenas o conteúdo.
· Mensagem de notificação de solicitação de acesso (MSG_NOT_SA_01): Após o usuário solicitante de acesso do portal agrícola ler e aceitar as condições do termode responsabilidade e prreencher o cadastro com seus dados, um e-mail é enviado para o solicitante informado-lhe que sua solicitação de acesso foi concluida e será avaliada pelo administrador do portal.
· E-Mail de solicitação de acesso - Aguardando aprovação – Solicitante (MAIL_SA_01): Um e-mail é enviado ao usuário solicitante de acesso do portal agrícola, informando-o que sua socilitação aguarda a avaliação de um administrador do portal.
Palavra Chave:
^{nome}: A palavra chave ^{nome}, configurada no conteúdo do template, é substituída automáticamente, com o valor informado no campo nome do formulário de dados do usuário solicitante no momento em que o e-mail é enviado.
· E-Mail de solicitação de acesso - Aguardando aprovação – Administrador (MAIL_SA_02): Um e-mail é enviado para o administrador do portal agrícola para aprovar ou reprovar a solicitação de acesso do usuário.
Palavra Chave:
^{nome}: A palavra chave ^{nome}, configurada no conteúdo do template, é substituída automáticamente, com o valor informado no campo nome do formulário de dados do usuário solicitante no momento em que o e-mail é enviado.
· E-Mail de aprovação de solicitação de acesso – Solicitante (MAIL_SA_03): Um e-mail é enviado para o usuário solicitante de acesso do portal agrícola, com os dados de acesso (usuário e senha), no momento em que o administrador aprova o pedido de acesso.
Palavra Chave:
^{nome}: A palavra chave ^{nome}, configurada no conteúdo do template, é substituída automaticamente, com o valor informado no campo nome do formulário de dados do usuário solicitante no momento em que o e-mail é enviado.
^{usuario}: A palavra chave ^{usuario}, configurada no conteúdo do template, é substituída automaticamente, com o valor informado no campo usuário do formulário de dados do usuário solicitante no momento em que o e-mail é enviado.
^{senha}: A palavra chave ^{senha}, configurada no conteúdo do template, é substituída automaticamente, por uma senha gerada pelo portal agrícola, no momento em que o e-mail é enviado.
· E-Mail de reprovação de solicitação de acesso – Solicitante (MAIL_SA_04): Um e-mail, é enviado, para o usuário solicitante de acesso do portal agrícola, no momento em que um administrador reprova o pedido de acesso.
Palavra Chave:
^{nome}: A palavra chave ^{nome}, configurada no conteúdo do template, é substituída automaticamente, com o valor informado no campo nome do formulário de dados do usuário solicitante no momento em que o e-mail é enviado.
· E-Mail de avaliação de solicitação de acesso – Administrador (MAIL_SA_05): Um e-mail é enviado ao administrador do portal agrícola, informando-lhe o resultado/status (aprovado e reprovado) da avaliação de acesso ao portal para o usuário solicitante.
Palavra Chave:
^{nome}: A palavra chave ^{nome}, configurada no conteúdo do template, é substituída automaticamente, com o valor informado no campo nome do formulário de dados do usuário administrador no momento em que o e-mail é enviado ao administrador do portal agrícola.
^{nome_solicitante}: A palavra chave ^{nome_solicitante}, configurada no conteúdo do template, é substituída automaticamente, com o valor informado no campo nome do formulário de dados do usuário solicitante no momento em que o e-mail é enviado para o administrador do portal agrícola.
^{status}: A palavra chave ^{status}, configurada no conteúdo do template, é substituída automaticamente, com o resultado da avaliação de solicitação de acesso ao portal agrícola para o usuário solcitante, no momento em que o e-mail é enviado para o administrador do portal agrícola.
· E-Mail de lembrete de dados de acesso (MAIL_SA_05): Um e-mail é enviado ao usuário do portal agrícola caso ele deseje recuperar seus dados de acesso (usuário e senha). Neste momento uma nova senha é gerada para o usuário.
Palavra Chave:
^{nome}: A palavra chave ^{nome}, configurada no conteúdo do template, é substituída automaticamente, com o valor informado no campo nome do formulário de dados do usuário solicitante no momento em que o e-mail é enviado.
^{usuario}: A palavra chave ^{ usuario }, configurada no conteúdo do template, é substituída automaticamente, com o valor informado no campo usuário do formulário de dados do usuário solicitante no momento em que o e-mail é enviado.
^{senha}: A palavra chave ^{ senha }, configurada no conteúdo do template, é substituída automaticamente, com a nova senha gerada para o usuário solicitante no momento em que o e-mail é enviado.
· Mensagem com informações de contato (MSG_INFO_CONTATO_01): Este template permite que o administrador do portal agrícola, descreva e formate o conteúdo referente às informações de contato. Essas informações podem ser visualizadas por meio do link Contatos localizado no rodapé de todas as páginas do portal agrícola.
12.11 Configuração de Layout
Objetivo: Permite que o usuário administrador configure o layout do portal agrícola, como o logo, o banner,
Menu: Configuração > Layout
Campos Obrigatórios:
Logo Menor: O campo logo menor permite que, o usuário administrador do portal agrícola, defina o logo com as dimensões de 180 pixels de comprimento por 55 pixels de altura.
Logo Maior: O campo logo maior permite que, o usuário administrador do portal agrícola, defina o logo com as dimensões de 310 pixels de comprimento por 90 pixels de altura.
Banner: O campo banner permite que, o usuário administrador do portal agrícola, defina o banner com as dimensões de 2500 pixels de comprimento por 175 pixels de altura.
Usuário Criador: Usuário responsável pela configuração do layout. O campo usuário criador é preenchido automáticamente pelo usuário administrador logado e não permite edição.
Data de Criação: Data e hora da última configuração do layout. O campo data de criação é prrenchido automáticamente coma a data e hora atual e não permite edição.
Demais Campos:
Menu: O campo menu permite que, o usuário administrador do portal agrícola, defina a cor para o menu padrão onde é possível selecionar o Tipo: Linear ou Radial, se o usuário selecionar o tipo Linear, então é necessário definir as cores: Superior e Inferior, caso o usuário defina o tipo como Radial então é necessário definir as cores: Cor Camada 1, Cor Camada 2 e Cor Camada 3.
Sub Menu: O campo sub menu permite que, o usuário administrador do portal agrícola, defina a cor para o sub menu onde é possível selecionar o Tipo: Linear ou Radial, se o usuário selecionar o tipo Linear, então é necessário definir as cores: Superior e Inferior, caso o usuário defina o tipo como Radial então é necessário definir as cores: Cor Camada 1, Cor Camada 2 e Cor Camada 3.
Item de Menu Selecionado: O campo item de menu selecionado permite que, o usuário administrador do portal agrícola, defina a cor para o item de menu selecionado onde é possível selecionar o Tipo: Linear ou Radial, se o usuário selecionar o tipo Linear, então é necessário definir as cores: Superior e Inferior, caso o usuário defina o tipo como Radial então é necessário definir as cores: Cor Camada 1, Cor Camada 2 e Cor Camada 3.
Fonte: O campo fonte permite que, o usuário administrador do portal agrícola, defina a cor para a fonte de menu onde são definidas as cores: Cor de Fonte Padrão e Cor de Fonte Selecionada.
Cabeçalho Relatório I: O campo cabeçalho relatório I permite que, o usuário administrador do portal agrícola, defina o texto para o primeiro cabeçalho do relatório com no máximo 100 caracteres alfanuméricos.
Cabeçalho Relatório II: O campo cabeçalho relatório II permite que, o usuário administrador do portal agrícola, defina o texto para o segundo cabeçalho do relatório com no máximo 100 caracteres alfanuméricos.
Cabeçalho Relatório III: O campo cabeçalho relatório III permite que, o usuário administrador do portal agrícola, defina o texto para o terceiro cabeçalho do relatório com no máximo 100 caracteres alfanuméricos.
Rodapé Relatório I: O campo rodapé relatório I permite que, o usuário administrador do portal agrícola, defina o texto para o primeiro rodapé do relatório com no máximo 100 caracteres alfanuméricos.
Rodapé Relatório II: O campo rodapé relatório II permite que, o usuário administrador do portal agrícola, defina o texto para o segundo rodapé do relatório com no máximo 100 caracteres alfanuméricos.
12.12 Cadastro de Parâmetro
Objetivo: Permite que o usuário administrador do portal agrícola configure os parâmetros pré cadastrados referente à climatologia, envio de email e cotações.
Menu: Configuração > Parâmetro
Climatologia:
· Códigos das cidades para consulta de previsão de climatologia nos serviços da CPTEC/INPE: Permite que, o usuário administrador do portal agrícola, configure os códigos das cidades para consulta de previsão climatológica fazendo uso dos serviços da CPTEC/INPE. Para obter o código da cidade utilize o serviço do CPTEC/INPE http://servicos.cptec.inpe.br/XML/listaCidades?city=[nome da cidade]*. Os códigos das cidades são cadastrados no campo valor, do cadastro de parâmetros (detalhe), separados por “;” (ponto e virgula).
*[nome da cidade]: Substitua pelo nome da cidade desejada. Não utilize acento no nome da cidade.
Exemplo:
Para obter o código da cidade de São Paulo:
1. Acesse o serviço do CPTEC/INPE por meio de um navegador de internet (internet explore, chrome, mozila...)
http://servicos.cptec.inpe.br/XML/listaCidades?city=Sao Paulo
2. O serviço do CPTEC/INPE retorna um XML com todas as cidades que possui o nome da cidade informada. Localize o id referente à cidade de São Paulo. Neste caso o id, ou seja, o código da cidade de São Paulo é 244.
3. Localizado o código da cidade (244), por meio do serviço do CPTEC/INPE, é necessário informá-lo no campo valor do cadastro de parâmetros
Configurações de Email:
· Habilita as configurações de envio de Email (FG_CONFIG_MAIL): Permite que, o usuário administrador do portal agrícola habilite as configurações de envio de email por meio de configurações de parâmetros e desconsidere a configuração do mail-service.xml do servidor de aplicação JBoss. Os valores permitidos são “N” para não habilitar as configurações de envio de Email por meio do portal agrícola e “S” para permitir habilitar as configurações de envio de email por meio do portal agrícola. Por padrão o valor “N.
· Usuário (com e-mail) que será o remetente das mensagens de notificação encaminhadas pelo serviço de Mail do Servidor de Aplicações (MAIL_FROM): Permite que o usuário administrador do portal agrícola informe o email do usuário remetente das mensagens de notificação.
· Senha de autenticação no servidor/serviço de SMTP (MAIL_PASSWORD): Permite que o usuário administrador do portal agrícola informe a senha de autenticação do email.
· Uso de autenticação SMTP. Por padrão, o valor “S” deve ser informado. Entretanto, tal configuração depende da necessidade do cliente e/ou do servidor/serviço de SMTP disponibilizado para o Portal Agrícola (MAIL_SMTP_AUTH): Permite que o usuário administrador do portal agrícola faça uso de autentificação SMTP. Por padrão o valor é “S”.
· Host (domínio) de autenticação no servidor/serviço de SMTP (MAIL_SMTP_HOST): Permite que o usuário administrador do portal agrícola configure o domínio de autenticação do serviço SMTP.
· Porta do host (domínio) de autenticação no servidor/serviço de SMTP (MAIL_SMTP_PORT): Permite que o usuário administrador do porta agrícola configure a porta do host de autenticação do serviço SMTP.
· Uso de autenticação por TLS. Por padrão, o valor “S” deve ser informado. Entretanto, tal configuração depende da necessidade do cliente e/ou do servidor/serviço de SMTP disponibilizado para o Portal Agrícola (MAIL_SMTP_STARTTLS_ENABLE): Permite que o usuário administrador do portal agrícola faça uso de autenticação TLS. Por padrão o valor é “S”
· Protocolo a ser utilizado para armazenamento de mensagens. Por padrão, o valor “pop3” deve ser informado (MAIL_STORE_PROTOCOL): Permite que o usuário administrador do portal agrícola configure o protocolo a ser utilizado para armazenamento de mensagens. Por padrão o valor é “pop3”.
· Protocolo a ser utilizado para transporte de mensagens. Por padrão, o valor “smtp” deve ser informado (MAIL_TRANSPORT_PROTOCOL): Permite que o usuário administrador do portal agrícola configure o protocolo a ser utilizado para transporte de mensagem. Por padrão o valor é “smtp”.
· Usuário (com e-mail) de autenticação no servidor/serviço de SMTP (MAIL_USER): Permite que o usuário administrador do portal agrícola configure o usuário de autenticação no serviço de SMTP.
· Usuário (sem e-mail) de autenticação no servidor/serviço de SMTP (MAIL_USER_SIMPLE): Permite que o usuário administrador do portal agrícola configure o usuário de autenticação no serviço de SMTP.
Cotações:
· Parâmetros relacionados a cotação das culturas do Portal Agrícola (CULTURAS_OCUPACOES): Permite que o usuário administrador do portal agrícola configure os códigos de cotações para as culturas de arroz, açúcar, café, algodão, citrus, soja, bezerro, gado e milho. A fonte utilizada para as cotação é do CEPEA.
· Token para exibição das culturas no widget de cotações (TOKEN_CULTURAS): Permite que o usuário administrador do portal agrícola configure o token para exibição das culturas. Para obter um novo token acesse https://www.quandl.com/ ou utilize este token “jd_rT448qAELnJuJvrN3”.
12.13 Cadastro de Documentos
Objetivo: Permite que o usuário administrador do portal agrícola cadastre arquivos de várias extensões.
Menu: Configuração > Documento
Campos Obrigatórios
Código: Código do documento. O campo código do cadastro de documento permite que o usuário administrador do portal agrícola informe um código para o documento. O código deve ser único e possuir no máximo 30 caracteres alfanuméricos.
Descrição: Descrição do documento. O campo descrição do cadastro de documento permite que o usuário administrador do portal agrícola informe uma breve descrição para identificar o documento. A descrição deve possuir no máximo 200 caracteres alfanuméricos.
Documento: Arquivo a ser cadastrado. O campo documento permite que o usuário administrador do portal agrícola anexe documentos de várias extensões, como arquivos de texto, imagens, entre outros.
Ações Relacionadas:
Gerar link: Gera um link o qual permite a visualização do documento, ou efetua o download do documento conforme o tipo de link informado. O link gerado pode ser utilizado, por exemplo, nos templates de email para anexar o logo da empresa.
12.14 Visualização de Notícia
Objetivo: Permite a visualização das notícias cadastradas pelo usuário administrador do portal agrícola por meio cadastro de notícias.
Menu: Visualização > Notícia
Demais Funcionalidades:
Consultar: Filtra as notícias cadastradas no portal agrícola as quais possuem a palavra ou a frase informada pelo usuário.
Saiba mais: Permite que o usuário leia a notícia completa, bem como a data de publicação, a categoria e a fonte referente a noticia.
12.15 Visualização de FAQ
Objetivo: Permite a visualização das perguntas e respostas cadastradas pelo usuário administrador do portal agrícola por meio do cadastro de FAQ. As perguntas freqüentes são organizadas por categorias, perguntas e respostas.
Menu: Visualização > FAQ
Demais Funcionalidades:
Consultar: Filtra as FAQs cadastradas pelo administrador do portal agrícola conforme a palavra ou a frase informada pelo usuário.
12.16 Visualização de Links
Objetivo: Permite a visualização dos links cadastrados pelo usuário administrador do portal agrícola por meio do cadastro de Link.
Menu: Visualização > Links
Demais Funcionalidades:
Acessar link: Acessa a página referente ao link.
12.17 Visualização de Widget
Objetivo: Permite a visualização dos widgets de climatologia e cotação conforme configurados no cadastro de parâmetro.
Menu: Visualização > Widget
12.18 Visualização de Auditoria
Objetivo: Permite o usuário administrador do portal agrícola visualizar as ações realizadas pelos usuários no portal.
Menu: Visualização > Auditoria
Filtros:
Usuário: Permite o usuário administrador do portal agrícola informar os nomes dos usuários que deseja filtrar as ações realizadas no portal.
Período: Permite o usuário administrador do portal agrícola informar o período (data inicial e data final) que deseja filtrar as ações realizadas no portal.
Interface: Permite o usuário administrador do portal agrícola indicar as interfaces que deseja filtrar as ações realizadas no portal.
Limte: Permite o usuário administrador do portal agrícola informe a quantidade de ações realizadas no portal que deseja filtrar.
Demais Funcionalidades:
Consultar: Permite o usuário administrador do portal agrícola filtrar os dados referente as ações dos usuários.
Dados:
Usuário: Usuário responsável pela ação realizada no portal agrícola.
Data: Data e hora da ação realizada no portal agrícola pelo usuário.
Descrição: Descrição da ação realizada pelo usuário.
Parâmetro (Sim/Não): Informa se ação realizada pelo usuário fez uso de parâmetro.
Demais Funcionalidades:
Atualizar: Atualiza os registros da tabela de dados referente as ações realizadas pelo usuário.
Visualizar parâmetros: Visualiza os parâmetros referente a ação selecionada.
12.19 Visualização de Contato
Objetivo: Permite o usuário visualizar as informações de contato. Essas informações são cadastradas e formatadas pelo administrador do porta agrícola por meio do cadastro de template (MSG_INFO_CONTATO_01 - Mensagem com informações de contato).
Menu: Visualização > Contato
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas