Páginas filhas
  • 1- Instalação do Extrator de Dados e Parametrizações do Banco de Dados do ERP Winthor.

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

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óciosPainel Financeiro.

> INSTALADOR WINTHOR2C

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óciosPainel Financeiro.

Totvs custom tabs box
tabsProcesso de Instalação

...

, Processo de Agendamento
idspasso1,passo2
Totvs custom tabs box items
defaultyes
referenciapasso1
Aviso

Importante!

É de suma importância que para chegar nessa etapa da instalação do Wizard do WINTHOR2C, obrigatoriamente deve-se ter executado todas as etapas do link DT 1.2 - Atualizações na infraestrutura do Banco de Dados para o processo entre TOTVS Mais Negócios x ERP Winthor. Se por alguma eventualidade essa etapa do link anterior não puder ser executada, não prossiga para essa próxima execução.


Para que seja realizado o envio de dados do ERP Winthor para a plataforma TOTVS Mais Negócios, é necessário a instalação do serviço do Winthor2c em uma máquina que tenha acesso a internet e ao banco de dados do cliente. Esta máquina preferencialmente não pode ser a mesma que esteja instalado o WTA - Winthor Anywhere ou o DocFiscal para que não haja concorrência entre os serviços.

  1. Execute o arquivo instalador “winthor2c.exe” como administrador, conforme disponível no Link Winthor2c

    Image Added


  2. No assistente de instalação clique na opção de “Avançar” para prosseguir com a instalação.

    Image Added


  3. Para que o arquivo de configurações seja criado e executado corretamente, é necessário que seja preenchido com os dados abaixo:
    1. Fornecidos pelo TOTVS Mais Negócios:
      1. Client ID
      2. Client Secret
    2. Acesso ao Banco de Dados Winthor
      1. Usuário/senha
      2. IP/Host
      3. Serviço/Porta
  4. Após preencher os dados clique na opção de “Avançar

    Image Added


  5. Aguarde a instalação e a inicialização do serviço.

    Image Added


  6. Ao finalizar a instalação clique na opção “Concluir”.

    Image Added


  7. Ao final da instalação, deve-se iniciar o serviço do Winthor2c no Windows, para que as Views, Functions, Table e Triggers sejam instaladas no banco de dados. Assim sendo, deve-se acessar o banco de dados por algum programa de gerenciamento de banco de dados (SQL Navigator, PL/SQL, SQL Developer e entre outros) e verificar se os objetos abaixo, foram criados:

    1. Views:
      1. VW_CLIENTES_FILIAL
      2. VW_PARCELAS_PREST_ANTECIPA
      3. VW_BANCO_FILIAL
      4. VW_VENC_REAL_ANTECIPA
      5. VW_MOEDA_EMPRESA
      6. VW_BAIXA_SALDO_ANTECIPA
      7. VW_CANC_TIT_ESTR_ANTECIPA
      8. VW_CENTRO_CUSTO_FILIAL
      9. VW_FORNEC_FILIAL
      10. VW_CANC_TIT_ESTR_ANTECIPA
      11. VW_NOTA_DEVOLUCAO_MAISNEGOCIOS
      12. VW_PARCELAS_MAISNEG
      13. VW_POSICAOCLIENTEMAISNEGOCIOS

    2. Functions:
      1. F_DTVENCIMENTOANTECIPA
      2. F_BUSCACOBRANCAMAISNEG
      3. F_BUSCANUMTRANSVENDAMAISNEG

    3. Table:
      1. PCW2C_QUEUE (Gerencia Fila de Envio de dados)

    4. Triggers:
      1. TRG_PCFILIAL_2C
      2. TRG_PCCOB_2C
      3. TRG_PCCLIENT2C
      4. TRG_PCPREST_2C
      5. TRG_PCNFSAID_2C
      6. TRG_PCNFSAID_NOTA_2C
      7. TRG_PCFILAMAISNEGLOG_2C
      8. TRG_PCNFENT_2C

  8. Caso haja a necessidade de verificar os dados de instalação, pode-se acessar o caminho "C:\pcsist\produtos\winthor2c\target\settings.json" e abrir o arquivo para verificar os dados informados na instalação, como senha, nome do banco, client id e etc

Image Added

Totvs custom tabs box items
defaultno
referenciapasso2
  1. 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

...

  1. w2cFiles, é possível conferir as seguintes informações:

    Image Modified


    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.

...

  1. : Caso seja necessário incluir novos agendamentos devem ser realizados via

...

  1. 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:

...

  1. 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.

  2. Para criar novos agendamentos ou executar novas consultas é necessário que tenha o

...

  1. POSTMAN conforme o link

...

  1. https://www.postman.com/downloads/ instalado no computador
    1. Executar uma requisição

...

    1. POST

...

    1. para o Endpoint:
      1. http://localhost:8080/api/v1/schedule/schedules
      2. 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":

...

  1. true,

            "queryFile": "pcprest_diaria.sql",

            "description":"sincronização de 30 em 30 min",       

            "timeExpression":

...

  1. "* 30 * ? * *",

            "dataConnector":"winthor"

        }

    ]

     

    Mais de um Agendamento:

    [

        {

            "entity": "pcprest",

            "active":

...

  1. true,

            "queryFile": "pcprest_diaria.sql",

            "description":"sincronização de 30 em 30 min",       

            "timeExpression":

...

  1. "* 30 * ? * *",

            "dataConnector":"winthor"

        },

        {

            "entity": "pcprest",

            "active":

...

  1. true,

            "queryFile": "pcprest_diaria.sql",

            "description":"sincronização de 15 em 15 min",       

            "timeExpression":

...

  1. "* 0/15 * ? * *",

            "dataConnector":"winthor"

        }

     ]

  2. Para obter os agendamentos já criados, é necessário acessar o seguinte Endpoint:
          I. Executar uma requisição

...

  1. GET

...

  1. para o Endpoint:
                  

...

  1. http://localhost:8080/api/v1/schedule/schedules

    Image Modified


  2. Para validar os agendamentos na fila de execução consultar o Endpoint:
                   http://localhost:8080/api/v1/status/schedules

  3. 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


Aviso

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