Histórico da Página
...
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
...
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 29 30 onde atribuímos valor a variável JAVA_HOME podemos ver o seguinte texto rem set "JAVA_HOME=C:\optProgram Files\Java\jdk1.68.0_1392", apague a palavra “rem”, e substitua o caminho da JDK pelo caminho corretoela 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
...
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
...
Para cada um destes arquivos, o seguinte ponto deverá ser modificados (aqui mostrados em apenas no arquivo runhomologacao.bat, por brevidade):
...
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.
...
| Nota | |||||
|---|---|---|---|---|---|
| |||||
Um ponto importante a ser destacado, na configuração das portas de acesso ao TOTVS Agro Portal Agrícola, é que tais portas devem estar totalmente liberadas, sem nenhum tipo de bloqueio ou limitação, aplicado por medidas de segurança dos ambientes onde o produto será configurado.
|
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.10Configuraçã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 é enviadoao 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.11Configuraçã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 automaticamente 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 é preenchido automaticamente coma a data e hora atual e não permiteediçã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. (Campo necessário para a realização das consultas)
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. (Campo necessário para a realização das consultas)
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.12Cadastro 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.13Cadastro 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.14Visualizaçã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.15Visualizaçã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.16Visualizaçã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.17Visualizaçã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.18Visualizaçã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.19Visualizaçã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
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
...
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
...
...
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas