Histórico da Página

Abaixo segue a relação de tabelas em que o serviço fará o expurgo de dados obsoletos:

• PCINTEGRACAOCORE; 
  • Tabela responsável por armazenar as integrações realizadas. A referência para realizar o expurgo será a coluna DATASINCRONISMO. Serão removidos apenas os registros que possuem status = 2 (sucesso);
• PCINTEGRACAODADOSRECEBIDOS;
  • Tabela responsável por armazenar os dados recebidos da integração;
• PCINTEGRACAOVARIAVEISTEMP;
  • Tabela responsável por armazenar as variáveis temporárias que a integração necessita criar (por exemplo números de lotes, entre outros). 

• PCINTEGRACAOLOGEXCLUSAODADOS;
  • Tabela responsável por armazenar o horário e os logs de execução do serviço de expurgo;

• PCINTEGRACAOEVENTORECEBIDO;
  • Tabela responsável por armazenar os eventos integrados via API de eventos. Apenas os registros marcados como processados entram na regra de exclusão;

A execução do serviço ocorrerá no horário definido no parâmetro app.integracao-core.excluir.agendador do arquivo app.properties (mais detalhes no próximo passo), no entanto caso a última execução tenha ocorrido a mais de 24 horas (caso em que a aplicação esteve parada no período definido para a execução), o serviço de expurgo irá executar automaticamente ao iniciar a aplicação;

É necessário editar o arquivo "app.properties" localizado no diretório "C:\pcsist\produtos\winthor-integracao-core" para adicionar as seguintes opções:

Image Added

Exemplo dos dados que devem conter no arquivo app.properties;

spring.datasource.initialize=false
spring.datasource.url= jdbc\:oracle\:thin\:@127.0.0.1:1521\:ORCL
spring.datasource.username=local
spring.datasource.password=54B4C4075463B2E02CD69F5CD139B5B2
spring.datasource.driver-class-name=oracle.jdbc.OracleDriver
path.winthor.ini=C:/winthor/Prod/Winthor.ini
url.ssh.wta=localhost
port.ssh.wta=8101
path.folder.temporary=C:/pcsist/produtos/winthor-integracao-core/temp
app.task.habilitadas=ALL
app.task.recursos.execucao.ativar-log-tempo=true
app.migration.ambiente.teste=false
app.migration.habilitar=false
#app.task.status-pos-integracao.intervalo-milissegundos=1000
#app.task.status-pos-integracao.tempo-maximo-minutos=1
#app.task.recursos.schedule.fixedRate=6000
app.task.paginacao-winthor.page-size=100
app.task.envio-integracao.threads=1
app.task.buscar-integracao.threads=1
app.task.buscar-integracao.tamanho=25
app.integracao-core.excluir=true
app.integracao-core.excluir.minimo-dias=120
app.integracao-core.excluir.tipo-dado=3
app.integracao-core.excluir.agendador: 0 0 2 * * *

• app.integracao-core.excluir=true
  • Este campo é responsável por definir se o serviço de expurgo estará ativo ou não. O valor default é true (habilitado).

• app.integracao-core.excluir.minimo-dias= 120

  • Este campo é responsável por definir a quantidade de dias em que os registros serão armazenados no banco. No exemplo acima, se o valor definido é 120, serão armazenados os registros até 120 dias desde a sua criação, portanto todos os registros com data inferior aos 120 dias serão deletados. O valor default é 120 dias.

• app.integracao-core.excluir.tipo-dado= 3

  • Este campo é responsável por definir o tipo de registro que será deletado. 1 para registros ENVIADOS (do WinThor para uma integração externa), 2 para registros RECEBIDOS (de uma integração externa para o WinThor) e 3 para AMBOS. O valor default é 3 - AMBOS.

• app.integracao-core.excluir.agendador=0 0 2 * * *

  • Este campo é responsável por definir o horário no qual o serviço será agendado para executar. O modelo segue o formato de string unix-cron, sendo que cada informação possui a seguinte representação: Segundos, Minutos, Horas, Dia, Mes, Dia da Semana, respectivamente. O * indica recorrência. O horário default é 0 0 2 * * * (todos os dias às 02:00 am).

Acesse os serviços do Windows ('services.msc' via 'Executar') e execute o serviço  'WSH - Winthor Smart Hub'.

Image Added

Image Added

No arquivo de logs do WSH (C:\pcsist\produtos\winthor-integracao-core\logs\winthor-integracao-core.out.log) caso o serviço não esteja desabilitado, deverá constar a seguinte informação:

Image Added

Já no caso de a última execução ter ocorrido a mais de 24 horas, o serviço irá executar o expurgo junto com a inicialização da aplicação:

Image Added

Acesse o WinThor Anywhere, localize/pesquise a rotina 2650 - Winthor Smart Hub

Image Added

Selecione a opção Integrações no Menu;

Image Added

Clique no botão Novo, (será apresentado os dados para Cadastro de Integração);

Image Added

 Cadastro de Integração nova

Image Added 

Tela destinada ao cadastro de uma nova integração:

• •  Código - Campo que apresentará o ID único do cadastro, este campo é gerado automaticamente.
  • Nome - Deverá ser informado o nome da integração para identificação da mesma.
  • URL Sistema Externo - Deverá ser informada a URL da API que será usada na integração externa.
  • Utiliza WTA - Deverá ser informado se será utilizado como processo WTA (Sim ou Não ).
  • Filial - Deverá ser selecionado o nome da filial.
  • Tempo de expiração - Deve ser informado o tempo (em segundos) para expiração do token. 
  • Token - Este campo será gerado automaticamente após a criação da Integração
  • Botão Salvar - Salva os dados adicionados.

No WSH, acessar o item 3 da rotina 2650, que é a configuração de parâmetros;

Image Added

Clique no botão Novo, (será apresentado os dados para Cadastro de parâmetro);

Image Added

Cadastro de Parâmetro

Image Added

Tela destinada ao cadastro de um novo parâmetro;

• • Código - Campo que apresentará o ID único do cadastro, este campo é gerado automaticamente.
  • ID Rota Serviço- Deverá ser informado o ID da rota para qual o parâmetro será vinculado.
  • Global- Ao selecionar o checkbox Global, será utilizado a rota global ao invés de alguma outra selecionada (Ao selecionar a Global, a seleção de ID Rota Serviço fica desabilitada).
  • Tipo Chave - Deverá selecionar o tipo da chave que será utilizada, se vai ser um parâmetro de BODY, PARAMS ou HEADER.
  • Chave - Será o nome do parâmetro.
  • Tipo Valor -  Informação que identifica de qual natureza é o valor, pode ser uma STRING pura, um SELECT no banco ou um ENCRYPTED, um valor que armazena codificado.
    
  • Valor - Deverá informar o valor referente ao campo.
  • Botão Salvar - Salva os dados adicionados.

Abaixo um exemplo de cadastro:

Image Added

No WSH, acessar o item 3 da rotina 2650, que é a configuração de parâmetros;

Image Added

Clique nos 3 pontos na frente do parâmetro que deseja editar e clique em Editar.

Image Added

Após alterar o campo valor, clique em Replicar para.

Image Added

Selecione os parâmetros que deseja replicar o valor e clique em Confirmar.

Image Added

Clique em Salvar para concluir a replicação.

Image Added

Já no WSH, acessar o item 4 da rotina 2650, que é a configuração de fluxos;

Image Added

Clique no botão Novo, (será apresentado os dados para Cadastro de fluxos);

Image Added

Cadastro de fluxos

Image Added

Nesta tela deverá ser informado o nome(descrição) do fluxo a ser criado e selecionar uma integração;

Cadastro de fluxos

Image Added

Nesta dela, podemos montar os fluxos de acordo com o necessário simplesmente selecionando no lado esquerdo o fluxo necessário e arrastando para a tela em branco da direita.

Caso tenham vários fluxos já adicionados, e a ordem não esteja de acordo com o esperado, podemos mover os fluxos já adicionados entre eles, também arrastando os mesmos com o mouse.

Temos uma lista com vários recursos que podem ser utilizados:

AutenticadorRefreshTokenApi =

BuscaRotaServicoNaoPaginada =

BuscaRotaServicoPaginada =

CriaVariavelTemporaria =

FinalizaVariavelTemporaria =

PersisteIntegracao =

EnvioIntegracaoStatusRecebido =

EnvioIntegracaoStatusEmProcessamento =

ConsultarStatusPosIntegracao =

EnvioIntegracaoStatusRecebidoLote =

Após adicionar os itens que forem necessários, podemos ir para a Seleção de rotas clicando em próximo passo;

Image Added

Neste passo, devemos vincular as rotas em cada fluxo que foi adicionar, clicando na lupa para realizar a busca da rota;

Image Added

Após clicar na lupa, devemos procurar a rota necessária de acordo com o fluxo, como no exemplo abaixo, buscamos a rota de autenticação para o fluxo de AutenticadorRefreshTokenApi;

1º Buscando a rota digitando pelo nome, ou listando as mesmas sem a necessidade de digitar;

2º Clicar sobre a rota para selecionar a mesma;

3º Confirmar a rota selecionada.

Image Added

Após selecionar as rotas para cada fluxo podemos ir para a revisão dos dados ou em caso de necessidade, podemos voltar um passo para selecionar ou remover outro item no fluxo voltando a página anterior;

Image Added

Ao chegar no último passo, o passo de revisão, podemos ficará ativo ou não, também definir IDs independentes e também podemos alterar novamente a ordem de cada item arrastando os mesmos para cima e para baixo.

Obs: No caso de alterar a ordem, podemos verificar que o primeiro item da tabela, "Ordem de execução" também irá alterar, respeitando a ordem de cima para baixo.

Image Added

Ativar ou desativar o fluxo, irá definir se o fluxo vai ficar operante ou não;

A informação do ID independente serve para informar se uma rota depende da execução de outra para funcionar.

Ex: Se for necessário enviar uma requisição pro WTA, vai precisar fazer o login antes, então a rota que comunica com o WTA é dependente de uma rota de login que o usuário precisa definir no cadastro do fluxo

Ao clicar em concluir o fluxo é salvo.

Já no WSH, acessar o item 5 da rotina 2650, que é a configuração de detalhes técnicos;

Image Added

Na tela dos detalhes técnicos, podemos realizar as devidas consultas podendo filtrar as mesmas por período de data, por rota, por status sendo esses apenas um ou múltiplos e também controlar a quantidade itens exibidos por página.

Image Added

Já no WSH, acessar o item 6 da rotina 2650, que é a configuração de DE/PARA;

Image Added

Na tela inicial do cadastro de de/para, temos uma visualização geral dos itens já cadastrados, e também podemos utilizar os filtros para uma melhor visualização dos dados de interesse.

Image Added

Cadastro de novo item

Para cadastrar um novo item de de/para, basta clicar em novo e informar os campos solicitados:

Image Added

Neste exemplo usamos a tabela de produtos(PCPRODUT) para cadastrar um código alternativo para um produto:

Image Added

Após preencher todos os dados, basta salvar e depois em confirmar:

Image Added

Então o novo item já deve aparecer salvo na coluna de exibição:

Image Added

Edição de itens

Para editar um item de de/para, basta clicar no botão de contexto (...) e editar o item que desejar:

Image Added

Os dados devem vir carregados com as informações já existentes:

Image Added

Basta editar o item que desejar e salvar.

Neste caso vamos apenas mudar o código externo para exemplificar:

Image Added

Após salvar, o item deve estar atualizado na listagem:

Image Added

Exclusão de itens

Para excluir um item de de/para, basta clicar no botão de contexto (...) e excluir o item que desejar (esta alteração é Irreversível):

Image Added

Após clicar em excluir, é necessário confirmar a exclusão:

Image Added

Após confirmar, um toast de confirmação será exibido informando que o item foi excluído, e o mesmo não irá mais aparecer na listagem:

Image Added

Já no WSH, acessar o item 7 da rotina 2650, que é a configuração de Transformação de Layouts

Image Added

Na tela inicial da seção de Transformação de Layouts temos já os campos destinados a realizar a validação de nossos layouts.

Nesta tela temos 3 campos, sendo eles;

Json de entrada: Neste campo, devemos inserir o json que queremos transformar;

Layout: Neste campo, devemos inserir o Json, que será responsável pela transformação, ou seja, o próprio layout de transformação;

Resultado/erros: Neste campo, será apresentado  o resultado da transformação, no caso de sucesso, será informado um Json com o resultado da transformação, e em caso de erro, será exibido o erro que ocorreu brevemente.

Também é possível clicar nos botões de Validar Json de Entrada e Validar Json Layout, para que seja realizado uma validação do Json antes de transformar.

Image Added

Exemplificando o uso, abaixo, a demonstração de uma transformação de exemplo;

Json de Entrada:

Image Added

Json de entrada:

{
  "rating": {
    "primary": {
      "value": 3
    },
    "quality": {
      "value": 3
    }
  }
}

Json do Layout: 

Image Added

 [
  {
    "operation": "shift",
    "spec": {
      "rating": {
        "primary": {
          "value": "Rating",
          "max": "RatingRange"
        },
        "*": {
          "max":   "SecondaryRatings.&1.Range",
          "value": "SecondaryRatings.&1.Value",
          "$": "SecondaryRatings.&1.Id"
        }
      }
    }
  },
  {
    "operation": "default",
    "spec": {
      "Range": 5,
      "SecondaryRatings": {
        "*": {
          "Range": 5
        }
      }
    }
  }
]

Resultado: 

Neste caso, um exemplo onde ocorreu sucesso na transformação, o resultado é um Json com os dados transformados;

Image Added

{
  "Rating": 3,
  "SecondaryRatings": {
    "quality": {
      "Id": "quality",
      "Value": 3,
      "Range": 5
    }
  },
  "Range": 5
}

{
	"origem": "ORIGEM",
	"codigoOrigem": "CODIGOORIGEM",
	"token": "bf602066-d434-47c6-9930-37fcd6891300",
	"codigoProcesso": 1,
	"descricaoProcesso": "DESCRICAO",
    "observacao":"OBSERVACAO"
}

{
    "origem": "ORIGEM",
    "codigoOrigem": "CODIGOORIGEM",
    "token": "bf602066-d434-47c6-9930-37fcd6891300",
    "descricaoProcesso": "DESCRICAO",
    "observacao": "OBSERVACAO",
    "codigoProcesso": 1,
    "dataCriacao": "2024-04-24T15:31:10.482",
    "dataAlteracao": "2024-04-24T15:31:10.482",
    "processado": false
}

{
    "code": "WT-CONFIG-000032",
    "message": "Erro ao receber evento",
    "detailedMessage": "Campo Obrigatorio não pode ser nulo. Campo: X",
    "details": []
}