Image Removed

1. Introdução (Sumário)

Requisitos de Software para o Portal de Mobilidade
Requisitos de Hardware para o Portal de Mobilidade
Observação
Informações Importantes
Instalação
Atualização
Informações adicionais SUMÁRIO
Introdução
Acesso ao Portal
Funcionalidades

LISTA DE FIGURAS
Figura 1 – Tela de Login - Menu Parâmetros Iniciais
Figura 2 – - Menu tela do Administrador Instalação
Figura 3 - Importação automática dos cadastros de menu e regras de acesso Menu Banco de Dados
Figura 4 - Lista de perfis para configuração de permissões de acesso Menu Acesso
Figura 5 - Permissões pré-definidas Resultado dos testes
Figura 6 - Alterando permissões de acesso Informações da Licença
Figura 7 – Tela adicionar Usuário - Dados usuário admin
Figura 8 – Lista de usuários registrados - Botão Setup Concluído
Figura 9 – Alterando permissão e deixando usuário como "Ativo" - Menu Parâmetros Iniciais
Figura 10 – Nova aba - Menu Instalação
Figura 11 – Adicionando um item - Resultado dos testes
Figura 12 – Gerar Cadastros - Editar Permissões do site no IIS
Figura 13 – Importar Apontamento - Aba segurança
Figura 14 – Gauge - Alterando permissões de usuário
Figura 15 – Barra - Removendo "Somente Leitura"
Figura 16 – Torta - Executando scripts de atualização do banco de dados
Figura 17 – Linha - Menu administrador
Figura 18 – Online - Menu Importar Licença
Figura 19 – Configuração acesso ao Banco de Dados - Importar chave de licença
Figura 20 – Dispositivos Cacadastrados - Importar Serviços
Figura 21 – Limpar Histórico - Importação de Serviços

Introdução 

Âncora

...

teste teste

Image Added

O Portal de Mobilidade tem como objetivo integrar os aplicativos moveis referente aos apontamentos de campo para os sistemas PIMS Cana e/ou PIMS Multicultivos, permitindo um melhor controle dos dispositivos utilizados e prover controles/funcionalidades que possibilitem um processo de gestão a vista. Visando a utilização desta ferramenta, foi desenvolvido um Manual para auxiliar o processo de sua instalação através de um Wizard (Instalador).

Âncora
RequisitosSoftware RequisitosSoftware

Requisitos de software para o Portal de Mobilidade 

• Ambiente computacional deve ser estável.
• Windows Server 2012.
• Instalação do IIS 7.5 ou superior:
  • Para a hospedagem e configuração do Portal no Servidor, tecnologia .NET.
• Incluir no IIS a extensão .apk e o tipo application/vnd.android.package-archive para serem servidos como conteúdo estático pelo servidor (tipos de MIME).
• Instalação .Net Framework 4:
  • Tecnologia envolvida no desenvolvimento do Portal
• SQLServer Express 2008 R2
  • Usado para armazenar os dados que são configurados dinamicamente no Portal, como, serviços e visões dos relatórios e indicadores do Portal.
  • O usuário utilizado para acessar a base do Portal deve possuir privilégios "root"
• Oracle Client ou Oracle Server (Integrado com a Produção)
  • Utilizado para acessar a base de dados do PIMS
  • O formato do horário no registro do Windows deve seguir o padrão Americano

Âncora
RequisitosHardware RequisitosHardware

Requisitos de hardware para o Portal de Mobilidade 

Plataforma: Necessário um servidor para a instalação do Portal, não necessariamente dedicado, que possua uma arquitetura de 64 bits. É recomendado utilizar uma arquitetura de 64 bits, já que esta arquitetura suporta a utilização de mais de 4GB de RAM, tendo-se assim um melhor desempenho do servidor.

• Sistema operacional: exige-se a utilização do Windows Server 2012. O sistema operacional também deve ser compatível com a arquitetura do Servidor 64 bits.
• Memória RAM: 4GB disponíveis por instância;
• Processador: Dual Core 2.0 GHZ ou XEON 2.0 GHZ
• Espaço em Disco: 10GB (o espaço em disco total leva em conta os espaços requeridos pela instalação do .NET, pelo Servidor de aplicações IIS. Entretanto, caso o servidor armazene o banco de dados do PIMS, deve ser considerado à parte o espaço necessário).
• Rede: É necessário que o Servidor esteja em Rede, tanto para acesso interno ou externo. O acesso externo é necessário para que os dispositivos, que estão no campo, tenham acesso aos cadastros.

Âncora
Obs Obs

Observação 

Os Acessos ao Portal e aos serviços usam o Protocolo HTTP.

Âncora
InfoImportantes InfoImportantes

Informações Importantes 

• Antes de iniciar o processo de instalação faça a aquisição das Licenças de Uso junto ao setor comercial da Totvs.

• Certifique-se de que o servidor no qual será instalado o Portal de Mobilidade possua todas as liberações para acessar o IP 138.219.88.222.

• O Instalador deve ser executado com permissões de administrador

• Para uso do banco de dados do Portal de Mobilidade anexado ao SQ Server Management Studio é necessário que o usuário utilizado para se conectar ao banco de dados tenha acesso root ao banco, pois, será necessário realizar a criação de novas tabelas.

• Quando executado o processo de atualização via instalador, o mesmo realiza automaticamente um backup do Portal de Mobilidade atual. O bakcup será salvo um diretório acima do diretório de instalação do Portal. Exemplo:
  • Instalação do Portal em C:\PortalDeMobilidade
  • Diretório de Backup C:\Backup\<nome do site> + data do backup 

• É extremamente importante que seja realizado um backup manual do Portal de Mobilidade, para prevenir algum problema no backup automático realizado pelo instalador, para isso, copie todo o diretório do Portal de Mobilidade atual, geralmente localizado em C:\inetpub\PortalMobile.

Âncora
Instalacao Instalacao

Instalação

Image Added 

Antes de iniciar o processo de instalação do Portal de Mobilidade é necessário que sejam cumpridos todos os pré-requisitos citados nos itens acima.

Menu Parâmetros Iniciais
Image Added

O menu parâmetros iniciais permite escolher o aplicativo PIMS (PIMS Cana ou PIMS Multicultivos), o SGBD (Sistema Gerenciador de Banco de Dados) do Pims, a operação que será realizada Instalação ou Atualização, o tipo da instalação (Teste ou Produção), a configuração do License Server (Ativar - Se irá utilizar o License Server para gerenciar as licenças, IP - Endereço IP do License Server, Porta - Porta do License Server) e o protocolo de instalação (HTTP ou HTTPS). Para instalar o Portal de Mobilidade selecione o Aplicativo PIMS, o SGBD, marque a opção Instalação, selecione o tipo de instalação, escolha o protocolo de instalação e clique no botão avançar. O idioma do instalador segue o idioma do Sistema Operacional.

Menu Instalação
Image Added

No menu instalação é necessário realizar as seguintes configurações:

• ID do cliente (campo obrigatório)
  • Deve conter a ID única do cliente registrada na Totvs para uso do Portal de Mobilidade. Essa ID deve ser fornecida ao cliente junto com o fechamento do contrato.
• Código da Licença (campo obrigatório)
  • Inserir o código enviado pela TOTVS
• Nome do Site (campo obrigatório)
  • O nome informado nesse campo será usado na criação do diretório de instalação (Exemplo: Se optar por instalar em C:\, o Portal será instalado em C:\<Valor colocado no campo Nome do Site>) e também será utilizado como o nome do site no IIS
• Escolha o local para instalar o Portal (campo obrigatório)
  • Indique o diretório onde o Portal de Mobilidade será instalado. O diretório sugerido é C:\inetpub

Como fazer:

1. Insira a ID do cliente e clique no botão Image Added . A ID será enviada aos servidores da TOTVS para validação, após alguns segundos o instalador receberá uma resposta, caso a ID seja válida será exibido na frente do campo o ícone Image Added , caso a ID não seja válida será exibido o ícone Image Added , se não foi possível realizar a comunicação com os servidores TOTVS será exibido o ícone Image Added . Somente é permito prosseguir com a instalação caso a ID do cliente seja válida ou se não foi possível realizar a comunicação com os servidores da TOTVS.
2. Caso ainda não possua a chave de licença, preencha o campo E-mail com o e-mail no qual deseja receber a chave e clique no botão Image Added , caso o e-mail tenha sido enviado para a TOTVS o seguinte ícone é exibido Image Added , se não foi possível enviar o e-mail para a TOTVS o ícone Image Added é exibido. Caso não receba uma resposta da TOTVS com a chave favor entrar em contato pelo telefone (18) 3302-1200.
3. Em posse da chave de licença insira no campo Chave e clique no botão Image Added . Caso a chave seja válida o seguinte ícone é exibido Image Added , se se a chave não for válida o ícone Image Added é exibido. Somente é possível prosseguir com a instalação se a chave de licença for válida.
4. Escolha o diretório para a instalação do Portal de Mobilidade. O diretório sugerido é C:\inetpub, caso queira escolher outro diretório, basta digitar o caminho desejado, ou procurar um diretório clicando no ícone Image Added .

Menu Banco de Dados
Image Added

Image Added

• Servidor\Instância (campo obrigatório)
  • Nome ou IP do servidor mais a Instância do SQL Server (se existir) separados por barra ().
• Banco (campo obrigatório)
  • Nome do banco de dados do servidor SQL.
• Usuário (campo obrigatório)
  • Nome do usuário para acesso ao banco de dados
• Senha (campo obrigatório)
  • Senha para acessar o banco de dados

Menu Acesso
Image Added

No menu Acesso devem ser configuradas as informações de Acesso ao Portal de Mobilidade. Ao abrir os campos são preenchidos com valores padrão, esses valores servem como exemplo de preenchimento dos campos.
No menu acesso é necessário realizar as seguintes configurações:

• Porta (campo obrigatório)
  • A porta reservada para o site do Portal de Mobilidade
• Endereço Principal (campo obrigatório)
  • Principal endereço de acesso ao Portal de Mobilidade, geralmente configurado com o endereço IP externo. Não é necessário incluir a porta nesse campo.
• E-mail do administrador (campo obrigatório)
  • E-mail do administrador do Portal de Mobilidade

• Âncora
  OLE_LINK1 OLE_LINK1

  Âncora
  OLE_LINK2 OLE_LINK2

  Lista de IPs de Acesso (campo obrigatório)
  • Lista de IPs que permitiram acessar o Portal, geralmente preenchido com localhost, IP interno do servidor e IP externo do servidor sem necessidade de incluir a porta e separados com ; (ponto e vírgula)
• ID do cliente (campo obrigatório)
  • Esse campo exibe a ID do cliente informada no menu Instalação.
• Criar Virtual Path
  • Marcar essa opção caso o Portal de Mobilidade seja instalado em um virtual path.

Resultado dos testes
Image Added

Após concluir as configurações e clicar no botão "Validar", o instalador do Portal de Mobilidade realiza automaticamente alguns testes para validar as configurações.
Os ícones abaixo indicam o resultado dos testes:
Image Added - Erro
Image Added - Sucesso
Image Added - Aviso

OBS**: Caso ocorra um erro nos itens "StringConnection", "MembershipApi" e "Write", a instalação do Portal de Mobilidade não é concluída, sendo necessário clicar no botão corrigir e rever as configurações realizadas. Caso não haja erro nos itens anteriormente citados o instalador permite concluir a instalação, pois, erros nem itens subsequentes não impedem o funcionamento total do Portal de Mobilidade.

OBS**: No caso de erros de "StringConnection" e "Membership API", e os parâmetros de conexão com o Banco de Dados/Portas estiverem corretos, após clicar no botão "Corrigir" para uma nova análise, é sugerido que o usuário PARE OS SERVIÇOS DO IIS, pois, caso possua alguma outra configuração prévia, poderá ocorrer um conflito entre as portas utilizadas na instalação. Após finalizada a mesma, e as mensagens estiverem OK, basta reiniciar os serviços do IIS.

Após clicar no botão Concluir o instalador do Portal de Mobilidade tentará se comunicar com os servidores da TOTVS para fazer a liberação dos aplicativos de acordo com a sua Licença, havendo sucesso nessa comunicação, serão exibidas na tela as informações da sua licença, como na imagem abaixo:
Image Added

Juntamente com a configuração da licença o instalador criará um usuário "admin" utilizando como nome de usuário o e-mail informado na Tela Acesso, campo E-mail do administrado (Figura 4) e a senha totvs@123. Essas informações também são exibidas na tela.
Image Added

Clicando no botão "Ok", será exibida a mensagem de que a instalação está concluída, em seguida a mensagem para fechar o instalador, após fechar o instalador, uma janela do navegador padrão será aberta, nessa janela serão executados alguns testes diretamente no Portal de Mobilidade, tendo sucesso nesses testes clique no botão "Sim, setup completo" ao final da página. Será aberta a tela inicial o Portal de Mobilidade.
Image Added

Âncora
Atualizacao Atualizacao

Atualização

Image Added 

Antes de iniciar o processo de atualização do Portal de Mobilidade é necessário parar o Site no IIS (Internet Information Service) e aguardar no mínimo 5 minutos antes de iniciar o processo de atualização.

Menu Parâmetros Iniciais
Image Added

O menu parâmetros iniciais permite escolher o aplicativo PIMS (PIMS Cana ou PIMS Multicultivos), o SGBD (Sistema Gerenciador de Banco de Dados) do Pims, a operação que será realizada Instalação ou Atualização e o tipo da instalação (Trial ou Produção). Para atualizar o Portal de Mobilidade, selecione o Aplicativo PIMS, marque a opção atualização  (ao marcar a opção de atualização a seleção do protocolo ficará desabilitada) e clique no botão Image Added para indicar onde está instalado o Portal de Mobilidade que será atualizado, e selecione o tipo de instalação (Teste ou Produção), após, clique em Avançar. O idioma do instalador segue o idioma do Sistema Operacional.

Menu Instalação
Image Added

No menu instalação é necessário realizar as seguintes configurações:

• ID do cliente (campo obrigatório)
  • Contém a ID única do cliente registrada na Totvs para uso do Portal de Mobilidade. Essa ID é recuperada das configurações atuais do Portal de Mobilidade
• Chave (campo obrigatório)
  • Inserir a chave enviada pela TOTVS
• Nome do Site (campo obrigatório)
  • O nome informado nesse campo será usado na criação do diretório de instalação (Exemplo: Se optar por instalar em C:\, o Portal será instalado em C:\<Valor colocado no campo Nome do Site>) e também será utilizado como o nome do site no IIS
• Escolha o local para instalar o Portal (campo obrigatório)
  • Indica o local da instalação do Portal de Mobilidade que será atualizada.

Como fazer:

1. Caso ainda não possua a chave de licença, preencha o campo E-mail com o e-mail no qual deseja receber a chave e clique no botão Image Added , caso o e-mail tenha sido enviado para a TOTVS o seguinte ícone é exibido Image Added , se não foi possível enviar o e-mail para a TOTVS o ícone Image Added é exibido. Caso não receba uma resposta da TOTVS com a chave favor entrar em contato pelo telefone (18) 3302-1200.
2. Em posse da chave de licença insira no campo Chave e clique no botão Image Added . Caso a chave seja válida o seguinte ícone é exibido Image Added , se se a chave não for válida o ícone Image Added é exibido. Somente é possível prosseguir com a instalação se a chave de licença for válida.

Âncora
InfoAdicional InfoAdicional

Informações adicionais 

Instalação em ambiente de teste

Para realizar a instalação em ambiente de teste é ecessário entrar em contato com a TOTVS para que seja gerada uma ID de cliente com liberação de instalação ou atualização de um ambiente de teste. Após negociado com a TOTVS será liberada uma ID e Chave de licença contendo os aplicativos que forem negociados e o ambiente de teste ficará disponível por 30 dias a partir da data de geração da chave de licença. A instalação do ambiente de teste deve ser realizada em no máximo 24 horas após a liberação da chave de licença, pois, ela é válida apenas por 24 horas após a sua geração. Se não for possível realizar a instalação dentro das 24 horas, será necessário entrar novamente em contato com a TOTVS para geração de uma nova chave de licença.
Liberar permissões de acesso ao diretório de instalação do Portal de Mobilidade através do IIS
Após clicar em "Validar" na tela de Acesso (Figura 4) a tela de resultado dos testes é exibida (Figura 10).
Image Added

Havendo erros ou não, antes de corrigir ou concluir a instalação, execute os seguintes procedimentos:

• Abra o IIS (Internet Information Service), clique com o botão direito sobre o nome do Site Portal de Mobilidade e clique em "Editar Permissões"

Image Added

• Clique na aba "Segurança" e clique no botão "Editar" abaixo das informações de "Nomes de grupo e de usuário"

Image Added

• Para cada "Nome de grupo ou de Usuário" marque a opção "Permitir" na permissão "Controle Total" e clique no botão "Aplicar" e depois no botão "OK"

Image Added

• Clique na aba "Geral", desmarque o atributo "Somente Leitura", clique no botão "Aplicar" e depois no botão "OK"

Image Added

• Volte ao instalador, conclua a instalação ou clique em "Corrigir" caso o botão "Concluir" não esteja habilitado e verifique se todas as configurações estão corretas, caso o botão "Concluir" esteja habilitado, conclua a instalação.

Atualizar o banco de dados
Após concluir a instalação abra a url http://localhost/Setup/Base.aspx (onde localhost é o endereço principal de acesso ao Portal de Mobilidade. Feito isso serão executados os scripts de atualização do banco de dados.
Image Added

Image Added

Navegue até o item "Importar Licença" (Figura 17).
Image Added

Na tela seguinte (Figura 18) inclua a sua chave de licença e clique em "Importar Configuração", caso não seja possível importar, solicite junto a Totvs o arquivo da sua licença, para importa-lo clique em "Upload License" e indique o arquivo enviado pela Totvs. Após isso o Portal de Mobilidade terá toda as informações referentes a duração da licença, quantidade de dispositivos e aplicativos liberados.
Image Added

Importação de serviços

Após realizar a instalação é necessário fazer a importação dos serviços que serão utilizados no Portal, para isso vá até o menu "Administrador" (Figura 16). Navegue até o item "Importar Serviços" (Figura 19).
Image Added

Na próxima tela escolha os serviços que deseja importar, atentando-se para sempre manter a origem e os destinos iguais, ou seja, quando a origem for "Manfro", o destino deve ser "Manfro", como na Figura 20.
Image Added

Caso não seja possível realizar a importação dos serviços através da comunicação com os servidores Totvs, solicite junto a Totvs os arquivos para que seja realizada a Importação Manual, para isso, indique a Totvs quais os serviços serão importados. Após recebidos os arquivos, vá até a seção Importação manual, indique qual o serviço a ser importado, clique em Upload Serviços e encontre o arquivo referente ao serviço.

AVISO: Antes de realizar a importação automática dos serviços, verifique a seção "Configurando corretamente o servidor de importação de serviços." ao final deste manual

Alterando formato da data do client Oracle
Deve-se verificar no regedit a seguinte chave: HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\ORACLE\KEY_OraClient10g_home1\NLS_LANG
A chave NLS_LANG deverá ficar com valor igual AMERICAN_AMERICA.XXXXXXXX
Image Added
Deve-se criar neste diretório abaixo a chave NLS_DATE_FORMAT com valor igual DD/MM/YYYY.
HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\ORACLE\KEY_OraClient10g_home1
Image Added
Formato de Data do Windows

Neste passo deve-se verificar o formato de data do Windows. Entrar em Painel de Controle>>>Região e Idioma>>>Configurações Adicionais>>>Data
O formato de data deverá estar como dd/MM/aaaa
Image Added

Configurando a manipulação de arquivos .apk no IIS

A partir da versão 12.1.14 do Portal de Mobilidade o gerenciamento dos aplicativos dos dispositivos móveis passou a ser realizado diretamente pelo Portal.
Para que essa gerencia possa ser realizada corretamente, é necessário configurar o IIS para manipular arquivos com a extensão .apk, para isso, siga os passos a seguir:

• Abra o IIS
• Clique no site PortalMobile
• Encontre a opção "Tipo de MIME", como na imagem abaixo:

Image Added

• Clique em adicionar e acrescente o seguinte "Tipo de MIME"
  • Extensão: .apk
  • Tipo: application/vnd.android.package-archive

Image Added

Configurando para uso da Ordem de Serviço Offline (OS Offline)

Caso o cliente deseje utilizar a Ordem de Serviço Offline, é necessário verificar se as configurações necessárias existem dentro do arquivo web.config, que está localizado em C:\inetpub\PortalMobile.
Abra o arquivo web.config e procure pela tag <listeners>, verifique se dentro dessa tag existe a tag abaixo, caso contrário adicione.

<add fileName="App_Data\Manfro\Manfro.log" footer="" formatter="Single Line Formatter" header="" rollFileExistsBehavior="Increment" rollInterval="None" rollSizeKB="1024" timeStampPattern="dd-MM-yyyyy" listenerDataType="Microsoft.Practices.EnterpriseLibrary.Logging.Configuration.RollingFlatFileTraceListenerData, Microsoft.Practices.EnterpriseLibrary.Logging, Version=4.1.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35" traceOutputOptions="None" filter="All" type="Microsoft.Practices.EnterpriseLibrary.Logging.TraceListeners.RollingFlatFileTraceListener, Microsoft.Practices.EnterpriseLibrary.Logging, Version=4.1.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35" name="Manfro" /> 

Ainda com o web.config aberto, procure pela tag <categorySources> e verifique se dentro dela existe a tag abaixo, caso contrário adicione.

<add switchValue="All" name="Manfro">
<listeners>
<add name="Manfro" />
</listeners>
</add>

Configurando corretamente o servidor de importação de serviços.

No momento da instalação ou atualização a tag <ServerTotvsServices> será configurada de acordo com o banco de dados do PIMS (Oracle ou SQLServer). O objetivo desta tag é indicar ao Portal de Mobilidade em qual servidor Totvs ele deve buscar os serviços, sendo para Oracle o servidor http://138.219.88.222/Portal e para SQLServer o servidor http://138.219.88.222/PortalSQL. Antes de realizar a importação dos serviços, verifique se a tag esta configurada corretamente!

...

1. Para acessar o portal é preciso ter um usuário registrado, é necessário informar o e-mail e a senha cadastrada.

...

1. Menu administrador

...

1. Importação de configurações de menu

...

1. Adicionar novo usuário

...

1. Quando é adicionada uma nova "Aba" no Portal, ela é adicionada sem nenhum item atrelado a ela. É possível alterar o título, excluir e alterar colunas da aba

...

1. Itens

...

1. Configurações

Para configurar acesso ao banco de dados no Portal, clique na opção Geral -> Cadastros Gerais que se encontra no menu principal da aplicação.
Image Removed
Figura 19 - Menu Cadastros Gerais
Aparecerá a tela abaixo:
Image Removed
Âncora_Toc464543001_Toc464543001Figura 20 – Configuração acesso ao Banco de Dados
Selecione a Aba "Configuração".
Clique no botão Adicionar que liberará uma linha para inserção de uma nova String de Conexão, selecione uma linha e clique em Deletar para exclui-la.
Para alterar clique duas vezes sobre o item e faça a alteração.
Para visualização dos Dispositivos selecione a aba "Disp. Cadastrados"
Image Removed
Âncora_Toc464543002_Toc464543002Figura 21 – Dispositivos Cacadastrados
Para limpar os dados historiados selecione a aba "Config Historico", após clique na opção Limpar Historico. É possível agendar a limpeza para que ela seja executada automaticamente, para isso, preencha os campos "Tempo para limpeza automatica" e "Tempo para limpeza automatica rastreio" com a frequencia que deseja que a limpeza seja realizada, coloque o valor em horas.
Image Removed
Âncora_Toc464543003_Toc464543003Figura 22 – Limpar Histórico Âncora_GoBack_GoBack