Cross Segmentos - TOTVS CRM Automação e Força de Vendas (SFA) - WEB - Integração - Integração de dados GPS via Google Maps API

Tempo aproximado para leitura: 00:04:00 min 
 

Dúvida

Como configurar integração do SFA com API do Google Maps para dados de localização?
 

Ambiente

Cross Segmentos - TOTVS CRM Automação e Força de Vendas (SFA) - WEB - Integração - Todas as versões
 

Solução

A integração com a API do Google Maps permite que consultemos os dados de localização de um cadastro diretamente com a base de dados do Google, bem como melhorar a análise de rotas e caminhos a serem percorridos entre um cliente e outro. 

Devemos realizar os seguintes passos para configurá-la:
 

Seguir a seguinte documentação para adquirir um token da API: https://tdn.totvs.com/pages/viewpage.action?pageId=829313784

1. Com a chave em mãos, podemos seguir com a configuração.

Abaixo, temos o link para baixar os arquivos a serem utilizados na configuração:

webtmp.wssim.com.br/ws_setup/last_version/integration_sfa_commons.zip
 

Após extraí-los, se parecem com os a seguir:

2. Renomear a pasta com nome "google" e salvamos esses arquivos dentro do servidor.
 

No diretório ws> integracao-spoon, insira a pasta extraída, renomeada para “google”. Dessa forma, o diretório será ws> integracao-spoon> google.
 

Ainda, uma pasta chamado logging deve ser criada junto aos arquivos da pasta Google:

3. Em google> config> .kettle, temos o arquivo kettle.properties (observe que a pasta ".kettle" é oculta).
 

Ao editá-lo, inserimos a nossa chave de integração do passo 0:
 

4. Retornando à pasta google, vamos configurar o importation_google.sh (ou importation_google.bat quando servidor Windows). Edite-o:

Observe:

A primeira parte grifada se refere ao caminho do java dentro do servidor (JAVA_HOME). Por padrão, devemos manter o mesmo que temos nos arquivos sh de importação e exportação utilizados pelo SFA.
 

Exemplo abaixo de como está configurado para o SFA:

Agora, na segunda parte grifada, será onde configuraremos se as importações realizadas pelo arquivo sh (ou bat no caso de Windows) serão DELTA (atualizando a cada novo registro ou mudança no existente) ou FULL (busca todos os registros em cada execução, independentemente se houveram ou não atualizações).

Observe que a carga FULL consome mais requisições via API (consequentemente, possui um custo maior que a DELTA), recomenda-se utilizá-la apenas na carga inicial dos pontos de GPS ou quando quiser realizar uma atualização em massa.

5. Com isso, configuremos o caminho do banco de dados. Em google> config, editamos o arquivo jdbc.properties:

Aqui, colocamos o caminho do banco de dados do SFA. Por padrão, utilizamos ws para ambiente produtivo e ws_homologa para ambiente de desenvolvimento.

6. Finalmente, devemos apenas inserir uma tarefa que executa de forma periódica o arquivo importation_google.sh (ou importation_google.bat) - via Agendador de Tarefas no Windows ou Crontab no Linux.

Observe que a primeira integração deve ser realizada em formato FULL (o que chamamos de carga inicial no tópico 4). Feita a carga inicial, ou seja, executada em formato FULL pela primeira vez, no importation_google devemos alterar para EXECUCAO=DELTA.
 

Com isso, os dados de geolocalização dos pontos de clientes serão, a partir de agora consultados diretamente pela base de dados do Google Maps.

Importante!

Como boa prática, recomendamos que antes de cadastrar o endereço do cliente, consulte-o no Google Maps, para verificar se está retornando exatamente como esperado.

Casos em que não é encontrado endereço para o cliente costumam ser resolvidos apenas corrigindo o endereço cadastrado.