Histórico da Página
. DADOS GERAIS
Produto: | TOTVS Distribuição e Varejo |
---|---|
Linha de Produto: | Linha Winthor |
Segmento: | Distribuição |
Módulo: | N/A |
País: | Brasil |
Ticket: | N/A |
Requisito/Story/Issue (informe o requisito relacionado) : | N/A |
02. SITUAÇÃO/REQUISITO
Criar um instalador de extração de dados do banco do ERP Winthor para a plataforma do TOTVS Mais Negócios
03. SOLUÇÃO
Para que a integração ocorra com sucesso, foi criado o instalador Winthor2c para extrair esses dados e enviar para a plataforma do TOTVS Mais Negócios
- O serviço será instalado no seguinte caminho: “C:\pcsist\produtos\Winthor2c”, dentro desta pasta, existe uma subpasta que armazena o processamento das consultas realizadas no banco de dados que é a w2cFiles, é possível conferir as seguintes informações:
A pasta “queries” armazena as consultas que serão executadas pelo Winthor2c, durante a instalação já são configuradas 31 consultas padrões de todas as tabelas que devem ser sincronizadas, divididas entre carga inicial e sincronização diária. O padrão de envio dos dados é de 1 em 1 hora. : Caso seja necessário incluir novos agendamentos devem ser realizados via POSTMAN (vide item 2).
Na pasta “sync_queue”, possui as subpastas “inbox” e “relay”. Dentro da pasta “inbox” são armazenados os agendamentos, com os dados da consulta que será executada e seu agendamento. Exemplo: vw_parcelas_prest_antecipa.2021-04-26T10:38:35
Na pasta “relay” serão armazenadas as consultas que por algum problema deram falha na sincronização, para serem executadas novamente. - Para criar novos agendamentos ou executar novas consultas é necessário que tenha o POSTMAN conforme o link https://www.postman.com/downloads/ instalado no computador
- Executar uma requisição POST para o Endpoint:
- http://localhost:8080/api/v1/schedule/schedules
- Enviar no corpo da requisição os seguintes dados:
- entity (Nome da tabela): pcprest
- active (tabela ativa?): true
- queryFile (caminho do arquivo de consulta sql): pcprest.sql (obs.: ao informar somente o nome do arquivo, automaticamente o serviço já olha na pasta: C:\pcsist\produtos\Winthor2c\w2cFiles\queries)
- description (descrição da consulta, se é por hora, minuto, etc): sincronização de 30 em 30 min
- timeExpression (expressão cron que define o tempo que deve ser executado a consulta): * 30 * ? * * (obs.: neste exemplo essa consulta será executada a cada 30 minutos)
- dataConnector (nome do sistema): winhtor
Exemplo do corpo da requisição, onde pode ser enviado um array com uma ou várias consultas:
Uma Agendamento:
[
{
"entity": "pcprest",
"active": true,
"queryFile": "pcprest_diaria.sql",
"description":"sincronização de 30 em 30 min",
"timeExpression": "* 30 * ? * *",
"dataConnector":"winthor"
}
]
Mais de um Agendamento:
[
{
"entity": "pcprest",
"active": true,
"queryFile": "pcprest_diaria.sql",
"description":"sincronização de 30 em 30 min",
"timeExpression": "* 30 * ? * *",
"dataConnector":"winthor"
},
{
"entity": "pcprest",
"active": true,
"queryFile": "pcprest_diaria.sql",
"description":"sincronização de 15 em 15 min",
"timeExpression": "* 0/15 * ? * *",
"dataConnector":"winthor"
}
]
- Executar uma requisição POST para o Endpoint:
- Para obter os agendamentos já criados, é necessário acessar o seguinte Endpoint:
I. Executar uma requisição GET para o Endpoint:
http://localhost:8080/api/v1/schedule/schedules - Para validar os agendamentos na fila de execução consultar o Endpoint:
http://localhost:8080/api/v1/status/schedules - Para remover um agendamento acesse o seguinte Endpoint passando o id (consulte o Id no item 3)
http://localhost:8080/api/v1/schedule/schedules/:id
04. DEMAIS INFORMAÇÕES
Importante!
As versões estarão disponíveis para download no CCW.
https://centraldecontrole.pcinformatica.com.br/
Mantenha suas rotinas sempre atualizadas!
05. ASSUNTOS RELACIONADOS
- Você sabe quais são os requisitos mínimos para o uso do TOTVS Mais Negócios x ERP Winthor?
- Você sabe quais são as atualizações de infraestrutura de banco de dados que devem ser feitos para o processo de TOTVS Mais Negócios x ERP Winthor?
- Você sabe como atualizar as rotinas do WinThor?