Histórico da Página

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.

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

Image Added

Selecione a opção Rotas no Menu;

Image Added

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

Image Added

 Cadastro de Rota/Serviço 

Image Added

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 

Image Added

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.

Image Added

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

Image Added

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

Image Added

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

Image Added

• 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;

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

Abaixo um exemplo de cadastro:

Image Added

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"

Image Added

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;

Image Added

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

Image Added

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, hora, por rota, por status sendo esses apenas um ou múltiplos e também controlar a quantidade itens exibidos por página.

Image Added

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

Image Added

Já no WSH, acessar o item 5 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

 Cadastro de Rota/Serviço 

Image Removed

Tela destinada ao cadastro de uma nova rota

• • 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": "ObterNotaPedido",
    "request": {
        "method": "GET",
        "header": [
            {
                "key": "Authorization",
                "value": "Bearer {{TOKEN}}"
            },
             {
                "key": "Content-Type",
                "value": "application/JSON"
            },
            {
                "key": "Accept",
                "value": "*/*"
            }
        ],
        "url": {
            "raw": "{{URL_BASE}}//users/{{USER_ID}}/orders/{{IDEXTERNO}}/",
            "protocol": "https",
            "host": [
                "api",
                "com"
            ],
            "path": [
                "users",
                "00001",
                ""
            ],
            "query": [
                {
                    "key": "sale",
                    "value": "authorized"
                }
            ]
        }
    },
    "response": []
}

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

Image Removed