Passo 2.1 - Executar o Wizard de Configuração da Integração - Windows

Visão Geral

O TOTVS Saúde Portal Autorizador ETL foi criado para facilitar o processo de extração de dados da base Protheus e importação desses dados na base do TOTVS Saúde Portal Autorizador.

Requisitos

Sistema operacional Windows

Ter instalado a ultima versão do Java 64 bits (https://www.java.com/pt_BR/download/manual.jsp)

Caso esteja instalando em um ambiente multi-operadora consulte o documento Implantação em ambientes multi-operadora - Home Soluções Saúde - TDN (totvs.com)

O TOTVS Saúde Portal Autorizador ETL não possui suporte oficial a sistemas operacionais Linux, mas é possível realizar a configuração seguindo a documentação disponível em Implantação em ambientes Linux

Executar o Wizard

1 - Executando o arquivo SETUP_HAT

Execute o arquivo SETUP_HAT.jar enviado para você, será apresentada a tela de boas vindas, após ler as informações sobre o instalador clique em Próximo.

2 - Contrato de licença

Leia atentamente o contrato de licença, caso esteja de acordo marque a opção Eu concordo com este contrato de licença e depois clique em Próximo.

3 - Local de instalação

Selecione o local onde serão instalados os arquivos do instalador e clique em Próximo.

4 - Pacotes

Confirme os pacotes que serão instalados e clique em Próximo.

5 - Agendamento

O HAT setup configura um schedule para a extração de algumas cargas de dados incrementais de dados que não são sincronizados via integração por API, você pode selecionar quais serão as tabelas atualizadas por carga incremental no passo 9.

Selecione o melhor horário para que essas atualizações sejam feitas e clique em Próximo.

6 - Dados da operadora

Preencha o campo "Por favor informe o nome do Tenant:" com o nome do tenant, essa informação está disponível no Painel de administração do TOTVS Saúde Portal Autorizador.

Preencha o campo "Por favor informe o registro ANS:" com o registro ANS da operadora.

Os dados para preenchimento desse passo estão disponíveis no Painel de administração do TOTVS Saúde Portal Autorizador.

Finalizado o preenchimento dos campos clique em Próximo.

7 - Tipo do banco de dados

Selecione de qual o tipo de banco de dados que será feita a extração e depois clique em Próximo.

8 - Informações do banco de dados

Preencha os dados referente ao acesso a base de dados, após o preenchimento dos campos, na seção Esta opção habilita a customização e criação automática de views no banco de dados,

selecione se deseja ou não criar as views de integração no banco de dados e clique em Próximo. Caso seja a carga inicial de dados deixe a opção selecionada.

9 - Views que serão extraídas

Selecione quais views serão criadas e extraídos os dados e clique em Próximo. Caso seja a carga inicial de dados deixe todas as views selecionadas.

10 - Instalação dos pacotes

O instalador fará a cópia dos pacotes selecionados no passo 4 para destino selecionado. Finalizado o processo clique em Próximo.

11 - Customização das views

Nesse passo você poderá selecionar se quer customizar as views para alterar o nome das tabelas ou dos campos.

Para saber mais sobre a customização das views acesse Views para ETL no TOTVS Saúde Portal Autorizador

Atenção

Caso tenha informado um alias para as views é necessário editar o nome das views no arquivo install.properties.

Para isso siga as instruções do passo 11.1 antes de continuar.

Finalizadas as alterações necessárias, caso haja alguma, clique em Próximo.

11.1 Editando arquivo install.properties

Caso tenha informado um alias para as views é preciso editar o arquivo install.properties antes de continuar com o processo. Na pasta onde foi instalado o HAT_SETUP abra o arquivo install.properties

e na chave Views que serao extraidas complemente o nome das views com o alias informado no momento da criação das views no Protheus.

O exemplo abaixo temos o alias "DOC" para as views, no arquivo colocamos o _DOC após o nome das views.

install.properties

...
################################################
###        Views que serao extraidas         ###
################################################

data.HAT_LOAD_B06_DOC.sql=select * from HAT_LOAD_B06_DOC
data.HAT_LOAD_B26_DOC.sql=select * from HAT_LOAD_B26_DOC
data.HAT_LOAD_B2J_DOC.sql=select * from HAT_LOAD_B2J_DOC
data.HAT_LOAD_B2K_DOC.sql=select * from HAT_LOAD_B2K_DOC
data.HAT_LOAD_BA0_DOC.sql=select * from HAT_LOAD_BA0_DOC
data.HAT_LOAD_BA1_DOC.sql=select * from HAT_LOAD_BA1_DOC
data.HAT_LOAD_BA3_DOC.sql=select * from HAT_LOAD_BA3_DOC
data.HAT_LOAD_BA6_DOC.sql=select * from HAT_LOAD_BA6_DOC
data.HAT_LOAD_BA9_DOC.sql=select * from HAT_LOAD_BA9_DOC
data.HAT_LOAD_BAN_DOC.sql=select * from HAT_LOAD_BAN_DOC
data.HAT_LOAD_BAQ_DOC.sql=select * from HAT_LOAD_BAQ_DOC
data.HAT_LOAD_BAU_DOC.sql=select * from HAT_LOAD_BAU_DOC
data.HAT_LOAD_BAW_DOC.sql=select * from HAT_LOAD_BAW_DOC
data.HAT_LOAD_BAX_DOC.sql=select * from HAT_LOAD_BAX_DOC
data.HAT_LOAD_BB0_DOC.sql=select * from HAT_LOAD_BB0_DOC
data.HAT_LOAD_BB2_DOC.sql=select * from HAT_LOAD_BB2_DOC
data.HAT_LOAD_BB6_DOC.sql=select * from HAT_LOAD_BB6_DOC
data.HAT_LOAD_BB8_DOC.sql=select * from HAT_LOAD_BB8_DOC
data.HAT_LOAD_BBF_DOC.sql=select * from HAT_LOAD_BBF_DOC
data.HAT_LOAD_BBI_DOC.sql=select * from HAT_LOAD_BBI_DOC
data.HAT_LOAD_BBK_DOC.sql=select * from HAT_LOAD_BBK_DOC
data.HAT_LOAD_BBM_DOC.sql=select * from HAT_LOAD_BBM_DOC
data.HAT_LOAD_BBN_DOC.sql=select * from HAT_LOAD_BBN_DOC
data.HAT_LOAD_BC0_DOC.sql=select * from HAT_LOAD_BC0_DOC
data.HAT_LOAD_BC1_DOC.sql=select * from HAT_LOAD_BC1_DOC
data.HAT_LOAD_BCT_DOC.sql=select * from HAT_LOAD_BCT_DOC
data.HAT_LOAD_BDL_DOC.sql=select * from HAT_LOAD_BDL_DOC
data.HAT_LOAD_BDT_DOC.sql=select * from HAT_LOAD_BDT_DOC
data.HAT_LOAD_BE4_DOC.sql=select * from HAT_LOAD_BE4_DOC
data.HAT_LOAD_BE6_DOC.sql=select * from HAT_LOAD_BE6_DOC
...

12 - Extraindo os dados

Será feito o processo de extração dos dados e envio dos dados extraídos para o local onde eles serão processados e importados para o HAT.

Finalizado o processo clique em Próximo.

13 - Fim da execução do setup

Após isso o processo de extração de dados extração de dados é finalizado. Clique em Sair para encerrar o instalador.

Configurar agendamento no Windows

Preparar o arquivo config.properties

Para configurar o agendamento no Windows o primeiro passo é ajustar o arquivo config.properties. Na pasta onde foi instalado o HAT_SETUP abra o arquivo install.properties e copie da chave Views que serao extraidas os valores que iniciam com HAT_STMP_... e substitua os valores da chave Views que serao extraidas no config.properties.

Caso tenha informado um alias para view não esqueça de incluir o alias no nome da view.

O exemplo abaixo mostra como deve ficar o arquivo config.properties:
Exemplo: config.properties

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107

################################################
###         Propriedades da operadora        ###
################################################
registroAnsOperadora=REGISTRO_ANS_OPERADORA

################################################
###    Configuracao de conexao mssql
################################################
jdbc.driver_path=jdbc/sqljdbc4.jar
jdbc.driver=com.microsoft.sqlserver.jdbc.SQLServerDriver
jdbc.url=jdbc:sqlserver://IPBancoDeDados:1433;DatabaseName=NomeBancoDeDados
jdbc.username=UsuarioBD
jdbc.password=SenhaBD

################################################
###        Views que serao extraidas         ###
################################################

data.HAT_STMP_B06.sql=select * from HAT_STMP_B06
data.HAT_STMP_BA0.sql=select * from HAT_STMP_BA0
data.HAT_STMP_BA1.sql=select * from HAT_STMP_BA1
data.HAT_STMP_BA3.sql=select * from HAT_STMP_BA3
data.HAT_STMP_BA6.sql=select * from HAT_STMP_BA6
data.HAT_STMP_BA9.sql=select * from HAT_STMP_BA9
data.HAT_STMP_BAN.sql=select * from HAT_STMP_BAN
data.HAT_STMP_BAQ.sql=select * from HAT_STMP_BAQ
data.HAT_STMP_BAU.sql=select * from HAT_STMP_BAU
data.HAT_STMP_BAW.sql=select * from HAT_STMP_BAW
data.HAT_STMP_BAX.sql=select * from HAT_STMP_BAX
data.HAT_STMP_BB0.sql=select * from HAT_STMP_BB0
data.HAT_STMP_BB2.sql=select * from HAT_STMP_BB2
data.HAT_STMP_BB6.sql=select * from HAT_STMP_BB6
data.HAT_STMP_BB8.sql=select * from HAT_STMP_BB8
data.HAT_STMP_BBF.sql=select * from HAT_STMP_BBF
data.HAT_STMP_BBI.sql=select * from HAT_STMP_BBI
data.HAT_STMP_BBK.sql=select * from HAT_STMP_BBK
data.HAT_STMP_BBM.sql=select * from HAT_STMP_BBM
data.HAT_STMP_BBN.sql=select * from HAT_STMP_BBN
data.HAT_STMP_BC0.sql=select * from HAT_STMP_BC0
data.HAT_STMP_BC1.sql=select * from HAT_STMP_BC1
data.HAT_STMP_BCT.sql=select * from HAT_STMP_BCT
data.HAT_STMP_BDL.sql=select * from HAT_STMP_BDL
data.HAT_STMP_BE4.sql=select * from HAT_STMP_BE4
data.HAT_STMP_BE6.sql=select * from HAT_STMP_BE6
data.HAT_STMP_BE9.sql=select * from HAT_STMP_BE9
data.HAT_STMP_BEA.sql=select * from HAT_STMP_BEA
data.HAT_STMP_BF1.sql=select * from HAT_STMP_BF1
data.HAT_STMP_BFC.sql=select * from HAT_STMP_BFC
data.HAT_STMP_BFD.sql=select * from HAT_STMP_BFD
data.HAT_STMP_BFE.sql=select * from HAT_STMP_BFE
data.HAT_STMP_BFG.sql=select * from HAT_STMP_BFG
data.HAT_STMP_BFJ.sql=select * from HAT_STMP_BFJ
data.HAT_STMP_BFO.sql=select * from HAT_STMP_BFO
data.HAT_STMP_BFP.sql=select * from HAT_STMP_BFP
data.HAT_STMP_BG7.sql=select * from HAT_STMP_BG7
data.HAT_STMP_BG8.sql=select * from HAT_STMP_BG8
data.HAT_STMP_BG9.sql=select * from HAT_STMP_BG9
data.HAT_STMP_BI3.sql=select * from HAT_STMP_BI3
data.HAT_STMP_BI6.sql=select * from HAT_STMP_BI6
data.HAT_STMP_BIA.sql=select * from HAT_STMP_BIA
data.HAT_STMP_BJ4.sql=select * from HAT_STMP_BJ4
data.HAT_STMP_BJE.sql=select * from HAT_STMP_BJE
data.HAT_STMP_BLD.sql=select * from HAT_STMP_BLD
data.HAT_STMP_BLE.sql=select * from HAT_STMP_BLE
data.HAT_STMP_BQC.sql=select * from HAT_STMP_BQC
data.HAT_STMP_BR4.sql=select * from HAT_STMP_BR4
data.HAT_STMP_BR8.sql=select * from HAT_STMP_BR8
data.HAT_STMP_BRV.sql=select * from HAT_STMP_BRV
data.HAT_STMP_BT4.sql=select * from HAT_STMP_BT4
data.HAT_STMP_BT5.sql=select * from HAT_STMP_BT5
data.HAT_STMP_BT6.sql=select * from HAT_STMP_BT6
data.HAT_STMP_BT7.sql=select * from HAT_STMP_BT7
data.HAT_STMP_BT8.sql=select * from HAT_STMP_BT8
data.HAT_STMP_BTQ.sql=select * from HAT_STMP_BTQ
data.HAT_STMP_BTS.sql=select * from HAT_STMP_BTS
data.HAT_STMP_BTU.sql=select * from HAT_STMP_BTU
data.HAT_STMP_BVI.sql=select * from HAT_STMP_BVI
data.HAT_STMP_BW3.sql=select * from HAT_STMP_BW3
data.HAT_STMP_CidIncompativel_BAA.sql=select * from HAT_STMP_CidIncompativel_BAA
data.HAT_STMP_CRIT_ATEND_BEG.sql=select * from HAT_STMP_CRIT_ATEND_BEG
data.HAT_STMP_CRIT_ATEND_BEL.sql=select * from HAT_STMP_CRIT_ATEND_BEL
data.HAT_STMP_PROC_ATEND_BE2.sql=select * from HAT_STMP_PROC_ATEND_BE2
data.HAT_STMP_PROC_ATEND_BEJ.sql=select * from HAT_STMP_PROC_ATEND_BEJ
data.HAT_STMP_REGRASCOBERTURA.sql=select * from HAT_STMP_REGRASCOBERTURA
data.HAT_STMP_SE1.sql=select * from HAT_STMP_SE1
data.HAT_STMP_VINCULOSODONTO.sql=select * from HAT_STMP_VINCULOSODONTO

################################################
###     Parametros obrigatorios do Agent   ###
################################################
# Credenciais do FTP
gdc.unlock=FALSE
gdc.uploadTrying=1
gdc.uploadSecond=1

gdc.upload_url=https://pagprostorage.blob.core.windows.net/arquivos-integracao
gdc.key=P3N2PTIwMTctMTEtMDkmc3M9YiZzcnQ9c2NvJnNwPXJ3ZGxhJnNlPTIwMzAtMTItMDJUMjM6NDQ6MzFaJnN0PTIwMTgtMDgtMjBUMTY6NDQ6MzFaJnNwcj1odHRwcyZzaWc9YXpLR3JITkdGbDBYNWwzd3BGRE1yNnUxV3JGdE5lOElUYkRmVzd2ZmNobyUzRA==
gdc.blob_type=BlockBlob

gdc.upload_archive=Integracao_HAT-${yyyyMMddHHmmss}.zip
gdc.upload_manifest=manifest-${yyyyMMddHHmmss}.txt

# Parametro responsavel por verificar se sera utilizado criptografia de senhas.
gdc.crypto=FALSE

# Backup
gdc.backup=TRUE

Preparar o arquivo sync_data.bat

O arquivo sync_data.bat será utilizado para executar o comando de extração de dados no tempo programado no Agendador de tarefas do Windows. Abaixo o exemplo de como deve ficar o arquivo sync_data.bat.
Exemplo: sync_data.bat

1
2
3
4
5
6
7
8
9

@echo off
E:
cd E:\ETL\hat\bin\agent

set log_name=E:\ETL\hat\TOTVS_HAT_INTEGRATION_AGENT_a8b0b752.log

echo ------------------------------------------ >> %log_name%

java -jar agent-healthcare.jar >> %log_name% 2>>&1

Para dar continuidade ao processo de implantação acesse o Passo 3 - Configurar o HAT Admin

Atalhos

Árvore de páginas