Histórico da Página

01. DADOS GERAIS

Produto:

Solucoes_totvs

Solucao	TOTVS Saúde Planos

Linha de Produto:

Linhas_totvs

Linha	Linha Protheus

Segmento:

Segmentos_totvs

Segmento	Saúde

Módulo:

Plano de Saúde

Função:

País:

Brasil

Story:

DSAUREV-6566

02. SITUAÇÃO/REQUISITO

Necessidade de realizar melhorias no processo de integração de cadastros PLS com o HAT.

03. SOLUÇÃO

Implementada melhoria com a disponibilização da possibilidade de realizar a comunicação de cadastro do PLS com o HAT através Jobs inicializados pelo appserver.ini.

Este ajuste é uma alternativa a utilização do Schedule de comunicação PLENVHAT, assim o cliente pode decidir por qual processo ele deseja enviar os dados cadastrais do PLS para o HAT. Caso o método adotado seja a utilização de Jobs, recomendamos desabilitar o Schedule PLENVHAT. Card documentosInformacao

O tempo para reconexão das solicitações Post e Get, e a quantidade máxima de tentativas podem ser parametrizados em novos campos na tabela de Operadoras de Saúde (BA0).TituloIMPORTANTE!Funcionamento dos jobs:

Com a utilização de jobs, diferentemente do Schedule que processava os registros por Alias, os jobs sempre vão buscar os registros sem processamento mais antigos independentes da API. Cada thread processa um registro por vez, tentando realizar a comunicação com a API da HAT.

...

O job continua realizando o controle de enviar primeiramente um registro para sua API correspondente com o verbo POST para incluir o mesmo na fila de processamento do HAT, e posteriormente, uma comunicação GET para verificar se o registro já foi processado pelo HAT com sucesso.

Card documentos

Informacao	O tempo para reconexão das solicitações Post e Get, e a quantidade máxima de tentativas podem ser parametrizados em novos campos na tabela de Operadoras de Saúde (BA0).
Titulo	IMPORTANTE!

Totvs custom tabs box

tabs	Passo 01, Passo 02, Passo 03, Passo 04
ids	passo1,passo2

Totvs custom tabs box items

default	yes
referencia	passo1

Para habilitar os jobs automáticos, é necessário adiciona-los ao arquivo appserver.ini:

Crie uma instância PLSHAT:

Bloco de código

title	Bloco PLSHAT
linenumbers	true

[PLSHAT]
ENVIRONMENT=PLS27
INSTANCES=1,1
main=PJobPlsHat

ENVIRONMENT - Indique o ambiente que será processado.
INSTANCES - Quantidade de threads que será alocada/iniciada ao iniciar o server.
main - Nome do programa, manter PJobPlsHat fixo.

Agora precisamos adicionar a instância PLSHAT no ONSTART para a mesma ser iniciada junto com o ambiente:

Bloco de código

title	Bloco ONSTART
linenumbers	true

[OnStart]
jobs=HTTP,HTTPJOB,PLSHAT
RefreshRate=120

Jobs - Nome dos jobs (instâncias) que serão iniciados ao inicializar o serviço.

Refreshrate - Determina um intervalo de tempo, em segundos, para que os jobs especificados, na chave [OnStart], sejam executados novamente e automaticamente, caso os mesmos não estejam em execução.

Esta chave, uma vez especificada, é válida para todos os jobs da seção [OnStart]. Deste modo, todos os jobs especificados serão executados novamente, caso já tenham sido terminados.

Na chave correspondente ao seu ambiente, é necessário adicionar as atributos: EMPROBOXML, FILROBOXML e OPEPLSTOHAT. Perceba que em nossa chave [PLSHAT] criada anteriormente, utilizamos o ambiente PLS27. Segue um exemplo de preenchimento:

Bloco de código

title	Configuração do Ambiente
linenumbers	true

[PLS27]
SourcePath=C:\PLS27\rpo
RootPath=C:\PLS27\ProtheusData                 
StartPath=\System
RpoLanguage=Portuguese
RpoVersion=120
RpoDb=TOP
LocalFiles=CTREE
localdbextension=.DTC
SpecialKey=PLS27
dbDataBase=MSSQL
dbServer=localhost
dbALIAS=P12127MNTDBEXP
dbPort=7890
TOPMemoMega=1
JEMP=T1
JFIL=M SP 01 
EMPROBOXML=T1
FILROBOXML=M SP 01 
OPEPLSTOHAT=0001

EMPROBOXML - Empresa que o Job PJobPlsHat executará.

FILROBOXML - Filial que o Job PJobPlsHat executará.

OPEPLSTOHAT - Código da Operadora (BA0) que o Job PJobPlsHat executará.

Totvs custom tabs box items

default	no
referencia	passo2

Aplique o pacote de dicionário de dados que acompanha este pacote ou crie os campos da tabela BNV e BA0 descritos na sessão 05 deste documento.

No SIGAPLS, acesse Atualizações/Operadora/Operadora de Saúde (PLSA010). Selecione sua Operadora, clique em Alterar. Na nova aba Integração HAT, preencha os novos campos

Image RemovedImage Added

Qtd Min Post (BA0_HATMIP) - Indica a quantidade de minutos para o job de integração PLS x HAT realizar novamente o envio de registros POST que tiveram falha na comunicação (se o campo estiver vazio, o padrão do sistema é 2).

Qtd Min Get (BA0_HATMIG) - Indica a quantidade de minutos para o job de integração PLS x HAT realizar novamente o envio de registros GET que tiveram falha na comunicação (se o campo estiver vazio, o padrão do sistema é 5).

Qtd Tent Rec (BA0_HATTRY) - Indica a quantidade reenvios que o job de comunicação PLS x HAT pode realizar para um registro que houve falha na comunicação (se o campo estiver vazio, o padrão do sistema é 5).

04. DEMAIS INFORMAÇÕES

MUDANÇA NOS LOGS

Foi implementado também, uma melhoria nos logs do processo. Como o processo pode utilizar várias threads, foi criado uma estrutura de separação dos dados no modelo .CSV com separação das colunas com o caracter ;

O log plshat.log pode ser encontrado em \ProtheusData\logpls\[Data de Processamento].

Exemplo:

Para ler o log com precisão, utilize uma ferramenta de leitura de CSVs. Abaixo, é apresentado o passo-a-passo no Microsoft Excel:

...

Com essa organização, é possível ler o log com facilidade separando cada processamento.

Card documentos

Informacao	A geração dos logs do processo é habilitada através do parâmetro MV_PHATLOG com o conteúdo 1.
Titulo	IMPORTANTE!

05. ASSUNTOS RELACIONADOS

Dicionário de dados atualizado:

Novos campos SX3, tabela Campos SX3:

Tabela BNV:

X3_CAMPO	X3_TIPO	X3_TAMANHO	X3_TITULO	X3_DESCRIC	X3_PICTURE	X3_USADO	X3_VALID	X3_CBOX	X3_BROWSE	X3_VISUAL	X3_CONTEXT	X3_OBRIGAT
BNV_PROCES	Caracter	1	Processado	Processado	@!	Sim	Vazio() .Or. Pertence('01')	0=Não;1=Sim	Não	Visual	Real	Não
BNV_ROBOID	Caracter	15	ID Robo	ID Robo Processamento	@!	Sim			Não	Visual	Real	Não
BNV_ROBOHR	Caracter	17	Hr Inic Proc	Hora inicio proces robo	@!	Sim			Não	Visual	Real	Não
BNV_QTDTRY	Numérico	2	Qtde Tentat	Qtde. Tentativas Rôbo	99	Sim			Não	Visual	Real	Não

Novos campos SX3, tabela Tabela BA0:

X3_CAMPO	X3_TIPO	X3_TAMANHO	X3_TITULO	X3_DESCRIC	X3_PICTURE	X3_USADO	X3_FOLDER	X3_BROWSE	X3_VISUAL	X3_CONTEXT	X3_OBRIGAT
BA0_HATMIP	Numérico	12	Qtd Min Post	Qtde Minutos Post	99	Sim	5	Não	Alterar	Real	Não
BA0_HATMIG	Numérico	152	Qtd Min Get	Quantidade Minutos Get	99	Sim	5	Não	Alterar	Real	Não
BA0_HATTRY	Numérico	172	Qtd Tent Rec	Qtde Tentativas Reconexão	99	Sim	5	Não	Alterar	Real	Não

Novo registro pastas Pastas (folders) SXA:

XA_ALIAS	XA_ORDEM	XA_DESCRI
BA0	5	Integração HAT

Parâmetros SX6:

Parâmetro	MV_PSVCLOG
Descrição	Habilita log para servicos do PLS (0=Desativado / 1=Ativado)
Tipo	Caracter
Conteúdo	1

Observação: esse parâmetro habilita a geração do log plshatservice.log na pasta \ProtheusData\logpls\[Data de Processamento]. Ele é gerado no modelo CSV descrito no na sessão 04 deste documento.

Templatedocumentos

HTML

<style>
div.theme-default .ia-splitter #main {
    margin-left: 0px;
}
.ia-fixed-sidebar, .ia-splitter-left {
    display: none;
}
#main {
    padding-left: 10px;
    padding-right: 10px;
    overflow-x: hidden;
}

.aui-header-primary .aui-nav,  .aui-page-panel {
    margin-left: 0px !important;
}
.aui-header-primary .aui-nav {
    margin-left: 0px !important;
}

.aui-tabs.horizontal-tabs>.tabs-menu>.menu-item.active-tab a::after { 
	background: #FF9900; !important 
}

.menu-item.active-tab { 
	border-bottom: none !important; 
}

</style>

Árvore de páginas

Versões comparadas

Versão antiga 14

Nova versão Atual

Chave

01. DADOS GERAIS

02. SITUAÇÃO/REQUISITO

03. SOLUÇÃO

04. DEMAIS INFORMAÇÕES

05. ASSUNTOS RELACIONADOS