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 próximo passo da tela de Cadastro de integração.

Image Added

Nesta tela, será possível consultar todos os parâmetros e serviços já cadastrados anteriormente;

Filtros:

Sucesso: Parâmetros e serviços cuja validação ocorreu com sucesso;

Pendente: O registro ainda não passou pela validação;

Falha: A validação retornou erro devido a alguma inconformidade, que será descrita na coluna "Observação" da tabela;

Image Added

Exemplo de validação preenchida:

Image Added

Para adicionar uma nova validação, basta rolar a tela até o final e preencher as informações desejadas:

Image Added

Tipo: Tipo da validação (serviço ou parâmetro);

Em caso de Serviço:

• Preencher o nome do serviço (Ex.: winthor-produto);
• Preencher a versão mínima esperada. Caso o requisito seja apenas que o serviço esteja instalado. pode deixar o campo em branco;
• Os campos Filial e Permite nulo não precisaram ser usados nesse cenário;

Em caso de Parâmetro:

• Preencher o nome do parâmetro (Ex.: CON_UTILIZAVENDAPOREMBALAGEM)
• Preencher o valor esperado:
  • OBS1: tratar valores booleanos como S (verdadeiro) e N (falso);
  • OBS2: caso o requisito seja apenas que o parâmetro esteja preenchido com algum valor, deixar o campo vazio e desmarcar a opção "Permite nulo?" ao lado;
• Preencher a filial do parâmetro. Caso seja um parâmetro geral, deixar o campo vazio ou preencher com filial 99;
• Caso o parâmetro deva necessariamente estar preenchido com alguma informação, desmarcar a opção "Permite nulo?";

Adicionar: O botão "Adicionar" levará o registro para a tabela de cima, com a situação igual a "Pendente", ou seja, aguardando validação;

Para realizar a validação, basta clicar no botão "Validar":

Image Added 

Exemplo:

Caso a barra fique verde, todos os itens foram validados com sucesso, caso fique vermelha, um ou mais itens não puderam ser validados.

Image Added

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

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
}