Histórico da Página

spring.datasource.initialize=false
#spring.datasource.url= jdbc:oracle:thin:@(DESCRIPTION =    (ADDRESS = (PROTOCOL = TCP)(HOST = gowend01)(PORT = 1521))    (CONNECT_DATA =      (SERVER = DEDICATED)      (SERVICE_NAME = ORCL)    )  )
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/MOD-000/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.task.paginacao-winthor.page-size=10
#app.task.status-pos-integracao.intervalo-milissegundos=1000
#app.task.status-pos-integracao.tempo-maximo-minutos=1
#app.task.recursos.schedule.fixedRate=60000

winthor-integracao-core.exe install

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

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

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

 Cadastro de Integração nova

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.

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

Selecione a opção Rotas no Menu;

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

 Cadastro de Rota/Serviço 

Tela destinada ao cadastro de uma nova rota

• •  Código - Campo que apresentará o ID único do cadastro, este campo é gerado automaticamente.
  • ID Integração - Deverá ser informado a empresa da rota que executará a ação.
  • Descrição da Integração - Ao selecionar o ID da empresa o nome será apresentado conforme cadastrado no banco de dados.
  • Status -O status ele define se a própria rota que tá sendo criada vai ser executada ou não. Deverá selecionar uma das opções ATIVO(será executada) / INATIVO(não será executada).
  • Autenticador -  Deverá selecionar as opções SIM/NÃO. Caso a Rota precise de autenticação antes da execução, este campo deverá ser informado igual a SIM, caso contrário informar NÃO.
  • Atualizar Token - Deverá selecionar as opções SIM/NÃO. Caso a Rota precise ATUALIZAR o Token, este campo deverá ser informado igual a SIM, caso contrário informar NÃO.
  • Nome do Serviço - É o nome que o usuário pode dar à rota pra identificá-la depois.

 Cadastro de Rota/Serviço 

Tela destinada ao cadastro de uma nova rota

• • Nome do Serviço / Nome Layout - É o nome que o usuário pode dar ao layout pra identificá-la depois.
  • Método HTTP - É o método que será utilizado pelo layout (GET, POST, PUT, DELETE, PATCH).
  • URL - A url a qual o layout irá utilizar.
  • Query -  Query utilizada no layout para realizar as consultas necessárias conforme configurações desejadas.
  • Body - Irá preencher o bodyraw do JSON
  • Parâmetros de Header - Permite adicionar novos parâmetros ao JSON do layut

• • Layout de Comunicação - Campo destinado a inserção do Layout que faça comunicação com o serviço, deve-se indicar o tipo de requisição e parâmetros necessários para que a ação seja executada, conforme o exemplo abaixo:

{
  "name": "",
  "request": {
    "method": "",
    "header": [],
    "url": {
      "raw": "",
      "query": ""
    },
    "bodyraw": ""
  },
  "response": []
}

Ao finalizar o Cadastro de layout de comunicação de Rota/Serviço, será apresentado o botão "Próximo" que levará ao segundo passo de configuração, Layout de Transformação.

• O layout de transformação é dividido em 4 partes que são:
  • JSON de entrada - Campo destinado a adição de como receber a informação.

• JSON de Saída - Campo destinado a informação de como deve ficar o JSON final do processo.

• Mapear JSON - está no centro das informações JSON de entrada e JSON de Saída, este campo é responsável por configurar o que liga os campos de entrada e saída para gerar o JSON de transformação do processo.

• Layout de Transformação - Campo destinado a inserção do Layout que faça transformação dos dados recebidos de forma que o ERP Winthor consiga integrar. Ao clicar no botão "Gerar Layout" será gerado dinamicamente após preenchimento das informações JSON entrada/saída e mapeamento dos campos,

[
  {
    "operation": "shift",
    "spec": {
      "id": "idExterno[0]",
      "shipment": { "logistic_type": "ignorarImportacaoDiferente(regra)" }
    }
  }
]

• Botão Salvar - Salva os dados adicionados.

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

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

Cadastro de Parâmetro

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.
  • WTA - Define se o campo valor será criptografado ou não.
  • Botão Salvar - Salva os dados adicionados.

Abaixo um exemplo de cadastro:

Ao selecionar a opção WTA, no momento de salvar, os dados serão criptografados em MD5:

Ao editar o item, é possível ver que o mesmo foi criptografado:

No campo onde tínhamos a informação "PCINTEGRACAOCORE.DADOSTRANSFORMADOS" ficou "C02E1F7066CDC879B35D0EDAE3570DE8"

Ao editar itens, onde os dados estão criptografados, é exibida a mensagem informativa "Atenção! O parâmetro está em MD5, verifique se a opção 'WTA' está desmarcada antes de concluir a edição."

Pois se a opção for marcada novamente, os dados serão criptografados novamente, e ocorrerá problemas com os dados.

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

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

Cadastro de fluxos

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;

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

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.

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;

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.

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;

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

Também é possível visualizar a legenda dos status que são apresentados em cada um dos itens disponíveis.

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

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.

Cadastro de novo item

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

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

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

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

Edição de itens

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

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

Basta editar o item que desejar e salvar.

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

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

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):

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

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:

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

Na tela inicial do assistente de configurações, temos a visualização de um campo para selecionar a integração que queremos atualizar.

Após selecionar a integração desejada, podemos selecionar a versão para qual queremos atualizar:

Após selecionar a versão, devemos selecionar o ambiente em que será utilizado, Homologação ou Produção:

Após selecionar a versão, podemos clicar em atualizar:

Confirmação de atualização

Para concluir a atualização, temos duas etapas de confirmação, isso por que essa atualização, pode afetar dados sensíveis de configurações de integração, e não deve ser feita sem ter certeza da atualização;

A primeira etapa, confirma a versão escolhida, e solicita a confirmação do usuário:

A segunda etapa pede ao usuário que digite o texto conforme indicado no texto para confirmar a instalação:

Ao tentar confirmar sem digitar o texto, ou digitar errado, um erro é apresentado:

Erro 1:

Erro 2:

Ao digitar o texto corretamente e confirmar, os dados começarão a ser atualizados:

Caso a atualização ocorra corretamente, uma mensagem informativa, irá aparecer no rodapé da página, indicando que a atualização ocorreu com sucesso:

Caso ocorra algum problema, a mensagem informativa também irá indicar que ocorreu a falha na atualização:

Ao ver detalhes, teremos um pouco mais de informações sobre o problema: