Versões comparadas

Chave

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

...

Aviso
titlePré-requisitos

Antes de iniciar a implantação, verifique se todos os pré-requisitos foram atendidos:


  • Requisitos de hardware


    • Equipamento: Servidor dedicado
    • Sistema Operacional: Windows 10 ou Superior 64bits/ Windows Server 2012 ou Superior 64 bits;
    • Processador: De 4+ núcleos e 2ghz+ de processamento;
    • Memória RAM: mínimo de 8GB (recomendado 16GB);
    • Conexão com Internet.
    • Espaço em Disco: Mínimo de 50gb disponíveis;
    • Java 1.8.0
    • Conexão com o banco de dados do WinThor;

      Aviso
      titleATENÇÃO
      • Caso a instalação seja feita em uma estação comum de trabalho ou em servidor compartilhado com outra aplicaçãoa performance pode ser seriamente afetada
      • O compartilhamento de recursos pode não só deixar lento quanto também travar a aplicação. Isso acontece porque quando não há recursos suficientes para o processamento da JVM, a sua instancia é fechada, paralisando todos processos dependentes. Desse modo, não poderemos garantir a perfeita execução da aplicação conforme é planejado para ser.
      • Versões de banco de dados homologadas (para os o PDVs Omni e PDV Supermercados)
        • Oracle 11g, 12c
        • Versões inferiores ou não descritas não são recomendadas para uso, pois não passaram pelo crivo dos testes do WinThor
        • Não usar as versões express do Oracle
    • Serviço WTA Winthor disponível na maquina da aplicação.


    • Para parte de pedidos de vendas deve ter o IP disponível para



Aviso
titleATENÇÃO
  • Caso a instalação seja feita em uma estação comum de trabalho ou em servidor compartilhado com outra aplicaçãoa performance pode ser seriamente afetada
  • O compartilhamento de recursos pode não só deixar lento quanto também travar a aplicação. Isso acontece porque quando não há recursos suficientes para o processamento da JVM, a sua instancia é fechada, paralisando todos processos dependentes. Desse modo, não poderemos garantir a perfeita execução da aplicação conforme é planejado para ser.



  • Requisitos de software



  • Acesse o WinThor Anywhere e no menu principal, preencha no campo de Pesquisar a rotina 801 - Atualização de Serviços Web e tecle Enter (ou clique diretamente sobre a rotina no menu principal do lado esquerdo);

Image Removed

  • Na tela Gerenciador de Rotinas e Serviços, clique o botão Instalações;

Image Removed

  • Instale os serviços winthor-integracao-config e winthor-integracao-2650 na última versão disponível. 

O objetivo é possibilitar o Cadastro de Integrações no Winthor Smart Hub.

Para realizar uma nova integração, devemos acessar as configurações de integrações através da rotina 2650 do WSH.

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

Image Removed

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

Image Removed

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

Image Removed

 Cadastro de Integração nova

Image Removed 

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.
Informações
titleInstalação
Expandir
titleDownloads
Expandir
titleDownload pacote WSH

O download dos arquivos necessário parar realizar a instalação do WSH - Winthor Smart Hub podem ser feitos através do link abaixo:

  • Download WSH (jre.zip, service.zip, winthor-integracao-core.jar)
Expandir
titleInstalação (com instalador)
Expandir
titleDownload do instalador WSH

Efetue o download do instalador do WinThor Smart Hub (WSH):

Expandir
titlePassos

Efetuado o download, clique duas vezes sobre o executável.

Image Added

Será iniciada a tela de boas vindas.

Image Added

Clique em Próximo.

Image Added

Clique em Eu concordo com este contrato de licença e depois, em Próximo.

Image Added

É possível com este instalador:

  • Realizar instalação completa (instalação completa é a opção que irá instalar ou reinstalar o serviço WSH (Realizar instalação nova ou reinstalar)).
  • Alterar arquivo de configuração (a opção de trocar senha de conexão ao banco de dados somente irá parar o serviço WSH e reescrever o arquivo de configuração da aplicação).
    • Será possível alterar os dados de endereço de banco, porta do Oracle, SID ou service name do Oracle, usuário e/ ou senha, além do endereço do WTA.
  • Realizar atualização de versão (aopção de atualização apenas aplica a nova versão do WSH mantendo o arquivo de configuração da aplicação intacto).

Selecionaremos a opção Realizar instalação completa.

Image Added

Não recomendamos mudar o diretório, mas caso queira e, entenda do fluxo do processo, é possível alterar.

  • Caso o diretório já exista, o instalador irá avisar e instalar no mesmo diretório.

Image Added

  • Caso já exista uma instalação anterior,  o instalador irá avisar que se continuar, a instalação será substituída por uma nova.

Clique em Sim.

Image Added

Clique em OK.

Image Added

Clique em Próximo.

Image Added

Informe os dados:

Caso não tenha os dados em mãos, é possível obter os dados de endereço, porta e SID via arquivo tnsnames.ora.

Image Added

  • Endereço do banco: IP ou HOSTNAME de onde o Oracle está instalado.
  • Porta: porta do banco Oracle (geralmente, 1521).
  • SID/ Nome do serviço: SID ou SERVICE_NAME do Oracle.
  • Usuário: usuário do banco de dados.
  • Senha: senha do usuário.
  • Endereço WTA: endereço de acesso do WTA.

Clique em Próximo.

Image Added

Clique em Próximo.

Image Added

A instalação será iniciada com a criação de diretórios, descompactação de arquivos, criação de serviços, etc.

Aguarde.

Image Added

Ao finalizar, o instalador irá exibir a tela acima.

Clique em Próximo.

Image Added

É possível gerar um script de reinstalação automática, se desejar.
Para isto, clique em Gerar um script para reinstalação automática.

Defina o local.

Image Added

Recomendamos salvar em outro diretório que não seja o da instalação atual.

Será gerado o arquivo auto-install.xml.

Bloco de código
languagexml
themeDJango
titleAuto-Install
linenumberstrue
collapsetrue
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<AutomatedInstallation langpack="bra">
    <com.izforge.izpack.panels.htmlinfo.HTMLInfoPanel id="preinstall"/>
    <com.izforge.izpack.panels.licence.LicencePanel id="LicencePanel_1"/>
    <com.izforge.izpack.panels.installationgroup.InstallationGroupPanel id="installSelector">
        <group name="2parcial_trocasenha">
            <pack>Configuração do APP</pack>
        </group>
    </com.izforge.izpack.panels.installationgroup.InstallationGroupPanel>
    <com.izforge.izpack.panels.target.TargetPanel id="targetpanel.1">
        <installpath>C:\pcsist\produtos\winthor-integracao-core</installpath>
    </com.izforge.izpack.panels.target.TargetPanel>
    <com.izforge.izpack.panels.packs.PacksPanel id="treepackspanel.1">
        <pack index="0" name="Configuração do APP" selected="true"/>
    </com.izforge.izpack.panels.packs.PacksPanel>
    <com.izforge.izpack.panels.userinput.UserInputPanel id="panelConfigDataBase">
        <entry key="hostname" value="GON170102466"/>
        <entry key="port" value="1521"/>
        <entry key="dbpassword" value=""/>
        <entry key="dbusername" value="local"/>
        <entry key="wtaurl" value="localhost"/>
        <entry key="sid" value="orcl"/>
    </com.izforge.izpack.panels.userinput.UserInputPanel>
    <com.izforge.izpack.panels.install.InstallPanel id="installPanel.1"/>
    <com.izforge.izpack.panels.htmlinfo.HTMLInfoPanel id="changepass"/>
    <com.izforge.izpack.panels.finish.FinishPanel id="FinishPanel_10"/>
</AutomatedInstallation>

OBS: a senha do usuário não será salva, sendo necessário informá-la novamente, por segurança.

Clique em Pronto.

Agora, a estrutura de pastas do WSH após a instalação.

Image Added


Expandir
titleInstalação manual (sem instalador)

Antes de executar o arquivo de configuração do WSH, devemos parar o serviço do WTA que fica nos serviços do Windows:

Acesse os serviços do Windows ('services.msc' via 'Executar') .

Image Removed 

Na tela de serviços procurar pelo serviço do Winthor Anywhere:

Image Removed

Clicar com o botão direito sobre o serviço e clicar em "Parar"

Image Removed

Totvs custom tabs box
tabsDescompactando os arquivos, Editando arquivo de propriedades "app.properties", Parando o servido WTA, Executando jar para finalizar as configurações iniciais
idspasso1,passo2,passo3,passo4
Totvs custom tabs box items
defaultyes
referenciapasso1


Crie o diretório

Totvs custom tabs box
tabsDescompactando os arquivos, Editando arquivo de propriedades "app.properties", Parando o servido WTA, Executando jar para finalizar as configurações iniciais
idspasso1,passo2,passo3,passo4

Crie o diretório "C:\pcsist\produtos\winthor-integracao-core";

Realizar o download dos arquivos informados no passo anterior e descompactá-los no diretório acima criado "C:\pcsist\produtos\winthor-integracao-core".

Após ser descompactado, a estrutura deve ser a seguinte, conforme imagem abaixo:

Exibindo image.pngImage Removed
apps-fileview.texmex_20231019.01_p2

image.png

Exibindo image.png…

Agora, é necessário criar, manualmente, p arquivo "app.properties" e configurar o mesmo de acordo com os dados da instalação conforme indicado na imagem abaixo, no diretório "C:\pcsist\produtos\winthor-integracao-core":

Image Removed

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

Totvs custom tabs box items
defaultyes
referenciapasso1
Totvs custom tabs box items
defaultno
referenciapasso2
Bloco de código
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.migration.ambiente.pdvomnishop=true
#app.task.paginacao-winthor.page-size=10
app.migration.ambiente.teste=true
app.migration.habilitar=true
#app.task.status-pos-integracao.intervalo-milissegundos=1000
#app.task.status-pos-integracao.tempo-maximo-minutos=1
#app.task.recursos.schedule.fixedRate=60000

Os seguintes campos devem ser informados de acordo com as configurações do ambiente onde o mesmo está sendo configurado:

  • spring.datasource.url= jdbc\:oracle\:thin\:@127.0.0.1:1521\:ORCL

    • Este campo é responsável pela informação do banco de dados do winthor.
  • spring.datasource.username= nome_usuário_banco

    • Este campo é responsável pela informação.
  • spring.datasource.password= DED9EFD3B48EBDBB5E69A00393B57EC9

    • Este campo é responsável pela informação da senha do banco de dados que deve ser em formato MD5 sempre em caixa alta.
  • spring.datasource.driver-class-name=oracle.jdbc.OracleDriver

    • Este campo é responsável pela informação do driver do banco de dados.
  • path.winthor.ini= C:/winthor/Prod/Winthor.ini

    • Este campo é responsável pela informação do local do arquivo de winthor.ini que deve estar dentro do diretório do winthor.
  • url.ssh.wta=localhost

    • Este campo é responsável pela informação da url do WTA.
  • port.ssh.wta:8101

    • Este campo é responsável pela informação da porta de acesso do WTA.
Totvs custom tabs box items
defaultno
referenciapasso3
Totvs custom tabs box items
defaultno
referenciapasso4

Após parar o serviço, podemos executar os arquivos de configurações do WSH.

Para configurar os dados mencionados, deve se executar o arquivo "winthor-integracao-core.jar" via prompt de comando para que todas as configurações sejam realizadas para iniciar o WSH:

Para isto, basta executar no prompt no local onde o arquivo se encontra "C:\pcsist\produtos\winthor-integracao-core" o comando ";

Realizar o download dos arquivos informados no passo anterior e descompactá-los no diretório acima criado "C:\pcsist\produtos\java -jar winthor-integracao-core.jar".

Image Removed

Se se todas as configurações do arquivo "app.properties" estiverem certas, as migrations serão executadas e assim que começarem a ser executados os fluxos, para a aplicação podemos conferir as migrations no log.

Image Removed

Após finalizar o processo, podemos verificar no banco de dados, realizando uma consulta simples para verificar os migrations.

Consulta a realizar (utilize o sqlplus ou gerenciador de banco de dados de seu conhecimento:

"SELECT * FROM PCINTEGRACAOCOREMIGRATION;"

Verifique a coluna "SUCESSO" onde todas devem estar com um "S".

Image Removed

Após as migrations executadas pode instalar a aplicação como serviço:

Após ser descompactado, a estrutura deve ser a seguinte, conforme imagem abaixo:

Exibindo image.pngImage Added
apps-fileview.texmex_20231019.01_p2

image.png

Exibindo image.png…

Totvs custom tabs box items
defaultno
referenciapasso2

Agora, é necessário criar, manualmente, p arquivo "app.properties" e configurar o mesmo de acordo com os dados da instalação conforme indicado na imagem abaixo, no diretório "C:\Para isso, no CMD, em modo administrador e, acesse a pasta service "C:\pcsist\produtos\winthor-integracao-core\service" e rode o comando para instalar

Image Removed

Bloco de código
winthor-integracao-core.exe install

Image Removed

OBS: caso precise desinstalar rode o comando com uninstall

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

Image Removed

Image Removed

Expandir
titleConfiguração de rotinas
Expandir
titleConfigurando rotina 2650

":

Image Added


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


Bloco de código
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



Os seguintes campos devem ser informados de acordo com as configurações do ambiente onde o mesmo está sendo configurado:

  • spring.datasource.url= jdbc\:oracle\:thin\:@127.0.0.1:1521\:ORCL

    • Este campo é responsável pela informação do banco de dados do winthor.
  • spring.datasource.username= nome_usuário_banco

    • Este campo é responsável pela informação.
  • spring.datasource.password= DED9EFD3B48EBDBB5E69A00393B57EC9

    • Este campo é responsável pela informação da senha do banco de dados que deve ser em formato MD5 sempre em caixa alta.
  • spring.datasource.driver-class-name=oracle.jdbc.OracleDriver

    • Este campo é responsável pela informação do driver do banco de dados.
  • path.winthor.ini= C:/winthor/Prod/Winthor.ini

    • Este campo é responsável pela informação do local do arquivo de winthor.ini que deve estar dentro do diretório do winthor.
  • url.ssh.wta=localhost

    • Este campo é responsável pela informação da url do WTA.
  • port.ssh.wta:8101

    • Este campo é responsável pela informação da porta de acesso do WTA.


Totvs custom tabs box items
defaultno
referenciapasso3

Antes de executar o WSH, devemos acessar o serviço do WTA e através da rotina 801, instalar o serviço winthor-integracao-config;


Image Added


Clicar na aba de instalação:

Image Added


Procurar pelo servico "winthor-integracao-config";


Image Added


Selecionar o serviço e clicar e instalar;


As dependências do serviço devem ser solicitadas, e para instala a mesmas, basta fazer um aceite;

Image Added

Image Added


Após finalizar será informado que a instalação foi realizada com sucesso:


Image Added

Expandir
titleConfiguração de integrações
Expandir
titleCadastro de integrações
Totvs custom tabs box
tabsPasso 1, Passo 2, Passo 3, Passo 4
idsitem-int1,item-int2,item-int3,item-int4
Totvs custom tabs box items
defaultyes
referenciaitem-int1
Totvs custom tabs box items
defaultyes
referenciaitem-int2
Totvs custom tabs box items
defaultno
referenciaitem-int3
Totvs custom tabs box items
defaultno
referenciaitem-int4
Expandir
titleConfiguração de rotas
  • 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 Removed

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

Image Removed

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

  • 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,
Expandir
titleCadastro de rotas/serviço

O objetivo é possibilitar o Cadastro de Rotas de busca e envio de dados, independente das API’s de emitente e destinatário.

Desta forma o serviço WSH(Winthor Smart Hub)  poderá realizar os processos de integração do produto Winthor, criando uma camada de transformação e intermediação de dados onde será possível realizar integrações com parceiros internos e externos.

Para cadastrar uma nova Rota, realize os procedimentos abaixo:

item-rota1,item-rota2,item-rota3,item-rota4,item-rota5,item-rota6
Totvs custom tabs box
tabsPasso 1, Passo 2, Passo 3, Passo 4, Passo 5, Passo 6
ids


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

Image Removed

Selecione a opção Rotas no Menu;

Image Removed

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

Image Removed

 Cadastro de Rota/Serviço 

Image Removed

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 Removed

    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:
    Totvs custom tabs box items
    default
    yes
    referenciaitem-rota1
    Totvs custom tabs box items
    defaultno
    referenciaitem-rota2
    Totvs custom tabs box items
    defaultno
    referenciaitem-rota3
    Totvs custom tabs box items
    defaultno
    referenciaitem-rota4
    Totvs custom tabs box items
    defaultno
    referenciaitem-rota5
    Bloco de código
    languagejs
    titleExemplo Comunicação
    {
      "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 Removed

    Totvs custom tabs box items
    defaultno
    referenciaitem-rota6
    Bloco de código
    languagejs
    titleExemplo Transformação
    [
      {
        "operation": "shift",
        "spec": {
          "id": "idExterno[0]",
          "shipment": { "logistic_type": "ignorarImportacaoDiferente(regra)" }
        }
      }
    ]
    
    
    • Botão Salvar - Salva os dados adicionados.
    no
    referenciapasso4

    Após instalar o serviço, podemos executar o WSH.

    Para isso deve se executar o arquivo "winthor-integracao-core.jar" via prompt de comando para iniciar o WSH:

    Para isto, basta executar no prompt no local onde o arquivo se encontra "C:\pcsist\produtos\winthor-integracao-core" o comando "java -jar winthor-integracao-core.jar".

    Image Added



    Bloco de código
    winthor-integracao-core.exe install


    Image Added

    OBS: caso precise desinstalar rode o comando com uninstall

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

    Image Added

    Image Added

    Expandir
    titleConfiguração de rotinas
    Expandir
    titleConfigurando rotina 2650
    • Acesse o WinThor Anywhere e no menu principal, preencha no campo de Pesquisar a rotina 801 - Atualização de Serviços Web e tecle Enter (ou clique diretamente sobre a rotina no menu principal do lado esquerdo);

    Image Added


    • Na tela Gerenciador de Rotinas e Serviços, clique o botão Instalações;

    Image Added

    • Instale os serviços winthor-integracao-config e winthor-integracao-2650 na última versão disponível. 


    Expandir
    titleConfiguração de integrações
    Expandir
    titleCadastro de integrações

    O objetivo é possibilitar o Cadastro de Integrações no Winthor Smart Hub.


    Para realizar uma nova integração, devemos acessar as configurações de integrações através da rotina 2650 do WSH.



    Totvs custom tabs box
    tabsPasso 1, Passo 2, Passo 3, Passo 4
    idsitem-int1,item-int2,item-int3,item-int4
    Totvs custom tabs box items
    defaultyes
    referenciaitem-int1

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


    Image Added




    Totvs custom tabs box items
    defaultyes
    referenciaitem-int2

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


    Image Added

    Totvs custom tabs box items
    defaultno
    referenciaitem-int3

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


    Image Added

    Totvs custom tabs box items
    defaultno
    referenciaitem-int4

     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.
    Expandir
    titleConfiguração de rotas
    Expandir
    titleCadastro de rotas/serviço

    O objetivo é possibilitar o Cadastro de Rotas de busca e envio de dados, independente das API’s de emitente e destinatário.


    Desta forma o serviço WSH(Winthor Smart Hub)  poderá realizar os processos de integração do produto Winthor, criando uma camada de transformação e intermediação de dados onde será possível realizar integrações com parceiros internos e externos.


    Para cadastrar uma nova Rota, realize os procedimentos abaixo:


    Totvs custom tabs box
    tabsPasso 1, Passo 2, Passo 3, Passo 4, Passo 5, Passo 6
    idsitem-rota1,item-rota2,item-rota3,item-rota4,item-rota5,item-rota6
    Totvs custom tabs box items
    defaultyes
    referenciaitem-rota1

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


    Image Added

    Totvs custom tabs box items
    defaultno
    referenciaitem-rota2

    Selecione a opção Rotas no Menu;


    Image Added

    Totvs custom tabs box items
    defaultno
    referenciaitem-rota3

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


    Image Added

    Totvs custom tabs box items
    defaultno
    referenciaitem-rota4

     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.


    Totvs custom tabs box items
    defaultno
    referenciaitem-rota5

     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:
    Bloco de código
    languagejs
    titleExemplo Comunicação
    {
      "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



    Totvs custom tabs box items
    defaultno
    referenciaitem-rota6
    • 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,


    Bloco de código
    languagejs
    titleExemplo Transformação
    [
      {
        "operation": "shift",
        "spec": {
          "id": "idExterno[0]",
          "shipment": { "logistic_type": "ignorarImportacaoDiferente(regra)" }
        }
      }
    ]
    
    
    • Botão Salvar - Salva os dados adicionados.


    Expandir
    titleConfiguração de Parâmetros
    Expandir
    titleCadastro de parâmetros

    O objetivo é possibilitar o Cadastro de parâmetros no Winthor Smart Hub.


    Para cadastrar um novo Parâmetro, devemos acessar as configurações de parâmetros através da rotina 2650 do WSH.


    Expandir
    titleCadastro de parâmetros

    Totvs custom tabs box
    tabsPasso 1, Passo 2, Passo 3
    idsitem-param1,item-param2,item-param3
    Totvs custom tabs box items
    defaultyes
    referenciaitem-param1

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


    Image Added

    Totvs custom tabs box items
    defaultno
    referenciaitem-param2

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


    Image Added

    Totvs custom tabs box items
    defaultno
    referenciaitem-param3

    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.


    Expandir
    titleConfiguração de fluxos
    Expandir
    titleCadastro de fluxos

    O objetivo é possibilitar o Cadastro de fluxos no Winthor Smart Hub.

    Os fluxo basicamente são os passos que devem ser feitos para que os dados sejam trafegados da maneira adequada no winthor. É basicamente um conjunto de rotas configuradas para serem executadas em uma ordem específica

    Para cadastrar um novo Fluxo, devemos acessar as configurações de parâmetros através da rotina 2650 do WSH.


    Totvs custom tabs box
    tabsPasso 1, Passo 2, Passo 3, Passo 4, Passo 5
    idsitem-fluxo1,item-fluxo2,item-fluxo3,item-fluxo4,item-fluxo5
    Totvs custom tabs box items
    defaultyes
    referenciaitem-fluxo1

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


    Image Added

    Totvs custom tabs box items
    defaultno
    referenciaitem-fluxo2

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


    Image Added

    Totvs custom tabs box items
    defaultno
    referenciaitem-fluxo3

    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

    Expandir
    titleConfiguração de Parâmetros
    Expandir
    titleCadastro de parâmetros

    O objetivo é possibilitar o Cadastro de parâmetros no Winthor Smart Hub.

    Para cadastrar um novo Parâmetro, devemos acessar as configurações de parâmetros através da rotina 2650 do WSH.

    Expandir
    titleCadastro de parâmetros
    Totvs custom tabs box
    tabsPasso 1, Passo 2, Passo 3
    idsitem-param1,item-param2,item-param3

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

    Image Removed

    Totvs custom tabs box items
    defaultyes
    referenciaitem-param1
    Totvs custom tabs box items
    defaultno
    referenciaitem-param2

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

    Image Removed



    Cadastro de Parâmetro

    Image Removed

    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 Removed

    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 Removed

    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.

    Totvs custom tabs box items
    defaultno
    referenciaitem-param3
    Expandir
    titleConfiguração de fluxos
    item-fluxo4

    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;


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

    Clicar sobre a rota para selecionar a mesma;

    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



    Totvs custom tabs box items
    defaultno
    referenciaitem-fluxo5

    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.

    Expandir
    titleConfiguração de detalhes técnicos
    Expandir
    titleDetalhes técnicos

    O objetivo é possibilitar o acesso aos detalhes técnicos do Winthor Smart Hub.

    Para consultar os detalhes técnicos, devemos acessar a rotina 2650 do WSH.





    Totvs custom tabs box
    tabsPasso 1, Passo 2
    idsitem-detalhes1,item-detalhes2,item-detalhes3
    Expandir
    titleCadastro de fluxos

    O objetivo é possibilitar o Cadastro de fluxos no Winthor Smart Hub.

    Os fluxo basicamente são os passos que devem ser feitos para que os dados sejam trafegados da maneira adequada no winthor. É basicamente um conjunto de rotas configuradas para serem executadas em uma ordem específica

    Para cadastrar um novo Fluxo, devemos acessar as configurações de parâmetros através da rotina 2650 do WSH.

    Totvs custom tabs box
    tabsPasso 1, Passo 2, Passo 3, Passo 4, Passo 5
    idsitem-fluxo1,item-fluxo2,item-fluxo3,item-fluxo4,item-fluxo5

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

    Image Removed

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

    Image Removed

    Cadastro de fluxos

    Image Removed

    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 Removed

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

    Image Removed

    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;

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

    Clicar sobre a rota para selecionar a mesma;

    Confirmar a rota selecionada.

    Image Removed

    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 Removed
    Totvs custom tabs box items
    defaultyes
    referenciaitem-fluxo1
    Totvs custom tabs box items
    defaultno
    referenciaitem-fluxo2
    Totvs custom tabs box items
    defaultno
    referenciaitem-fluxo3
    Totvs custom tabs box items
    defaultno
    referenciaitem-fluxo4
    yes
    referenciaitem-detalhes1

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


    Image Added

    Totvs custom tabs box items
    defaultno
    referenciaitem-detalhes2

    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




    Expandir
    titleCadastro e consulta de DE/PARA
    Expandir
    titleDe/para

    O objetivo é possibilitar o acesso aos dados de DE/PARA do Winthor Smart Hub.

    Para consultar editar ou cadastrar um novo dado, devemos acessar a rotina 2650 do WSH.


    Totvs custom tabs box
    tabsPasso 1, Passo 2, Passo 3, Passo 4, ´Passo 5
    idsitem-depara1,item-depara2,item-depara3,item-depara4,item-depara5
    Totvs custom tabs box items
    defaultnoyes
    referenciaitem-fluxo5depara1

    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 Removed

    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.

    Expandir
    titleConfiguração de detalhes técnicos

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


    Image Added

    Totvs custom tabs box items
    defaultno
    referenciaitem-depara2

    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

    Totvs custom tabs box items
    defaultno
    referenciaitem-depara3

    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


    Totvs custom tabs box items
    defaultno
    referenciaitem-depara4

    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

    Expandir
    titleDetalhes técnicos

    O objetivo é possibilitar o acesso aos detalhes técnicos do Winthor Smart Hub.

    Para consultar os detalhes técnicos, devemos acessar a rotina 2650 do WSH.

    item-detalhes1,item-detalhes2,item-detalhes3
    Totvs custom tabs box
    tabsPasso 1, Passo 2
    ids

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

    Image Removed

    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 Removed

    Totvs custom tabs box items
    defaultyesno
    referenciaitem-detalhes1
    Totvs custom tabs box items
    defaultno
    referenciaitem-detalhes2
    Expandir
    titleCadastro e consulta de DE/PARA
    depara5

    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

    Expandir
    titleAssistente de configuração
    De/para
    Expandir
    titleAssistente de configuração

    ***SERÁ DISPONIBILIZADO EM VERSÃO FUTURA DO WINTHOR***

    Expandir
    title


    O objetivo é possibilitar o acesso aos dados de DE/PARA do Winthor ao Assistente de configuração do Winthor Smart Hub.

    Para consultar editar ou cadastrar um novo dadoalterar via tela, quando necessário, uma nova versão disponível dos layouts de comunicação e transformação das integrações, devemos acessar a rotina 2650 do WSH.


    Totvs custom tabs box
    tabsPasso 1, Passo 2, Passo 3, Passo 4, ´Passo 5
    idsitem-depara1,item-depara2,item-depara3,item-depara4,item-depara5assisconfig1,assisconfig2,assisconfig3,assisconfig4,assisconfig5
    Totvs custom tabs box items
    defaultyes
    referenciaitem-depara1assisconfig1

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


    Image RemovedImage Added

    Totvs custom tabs box items
    defaultno
    referenciaitem-depara2assisconfig2

    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 Removed

    Totvs custom tabs box items
    defaultno
    referenciaitem-depara3

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

    Image Added


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


    Image Added

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


    Image Added


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


    Image Added

    Cadastro de novo item

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

    Image Removed

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

    Image Removed

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

    Image Removed

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

    Image Removed

    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 Removed

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

    Image Removed

    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 Removed

    Totvs custom tabs box items
    defaultno
    referenciaitem-depara4assisconfig3

    Edição Confirmação de itens

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

    Image Removed

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

    Image Removed

    Basta editar o item que desejar e salvar.

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

    Image Removed

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

    Image Removed

    Totvs custom tabs box items
    defaultno
    referenciaitem-depara5
    Expandir
    titleAssistente de configuração

    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:

    Image Added


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


    Image Added


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


    Erro 1:


    Image Added


    Erro 2:


    Image Added


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


    Image Added



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


    Image Added


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


    Image Added


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


    Image Added


    Expandir
    titleMonitor de Serviço WSH
    Expandir
    titleMonitor de Serviço WSH
    Expandir
    titleAssistente de configuração

    ***SERÁ DISPONIBILIZADO EM VERSÃO FUTURA DO WINTHOR***


    O objetivo é possibilitar o acesso ao Assistente Monitor de configuração do Serviço do Winthor Smart Hub.

    Para alterar poder acompanhar via tela, e quando necessário, uma nova versão disponível dos layouts de comunicação e transformação das integrações, devemos acessar a rotina 2650 do WSH.habilitar ou desabilitar o mesmo. Devemos acessar a rotina 2650 do WSH.


    Totvs custom tabs box
    tabsPasso 1, Passo 2, Passo 3
    idsmonitorsv1,monitorsv2,monitorsv3
    Totvs custom tabs box items
    defaultyes
    referenciamonitorsv1

    Já no WSH, acessar o item 9 da rotina 2650, que é a configuração de Monitor Serviço WSH;


    Image Added

    Totvs custom tabs box
    tabsPasso 1, Passo 2, Passo 3, Passo 4, ´Passo 5
    idsassisconfig1,assisconfig2,assisconfig3,assisconfig4,assisconfig5
    -items
    defaultno
    referenciamonitorsv2

    Na tela inicial do Monitor, temos a visualização de todos os dados da máquina disponíveis para monitoria, assim como o log do WSH.

    Image Added


    Para iniciar a Monitoria, basta clicar em "Iniciar Monitoria":


    Image Added


    Para parar, basta clicar em "Parar Monitoria"


    Image Added


    Através do monitor, podemos também Reiniciar e Parar o Serviço do WSH. Lembrando, apenas Parar e Reiniciar, neste primeiro momento, ainda não é possível Iniciar o WSH através do Monitor. 


    Reiniciar:


    Image Added


    Parar o serviço (será necessário iniciar o serviço manualmente depois dessa ação):


    Image Added

    Totvs custom tabs box items
    defaultyes
    referenciaassisconfig1

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

    Image Removed

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

    Image Removed

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

    Image Removed

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

    Image Removed

    Totvs custom tabs box items
    defaultno
    referenciaassisconfig2
    defaultno
    referenciamonitorsv3

    Recursos do monitor: 



    Podemos clicar sobre cada item, para verificar todos os dados referentes a cada componente, CPU, Memória, Threads e Logs.


    CPU:


    Image Added

    Exibe todas as informações disponíveis referentes a CPU da máquina do WSH:

    Tempo de uso JVM(s): Tempo de uso JVM em segundos

    Núcleos disponíveis: Núcleos disponíveis no processador da máquina 

    % de Uso do CPU(JVM): Porcentagem de uso da CPU pela JVM

    % de Uso do CPU(Sistema): Porcentagem de uso da CPU pelo Sistema Operacional.

    Uso do processador pela JVM: Uso do processador pela JVM

    Memória do Sistema

    Memória física total: Memória física instalada na máquina.

    Memória física livre (GB): Memória física livre disponível na máquina. 

    Memória Swap (MB): Memória Swap (memória virtual) disponível. 

    Memória Swap livre (MB): Memória Swap (memória virtual) livre no sistema. 

    Memória comprometida pela JVM (MB): Total de memória comprometida pela JVM. 


    Memória:


    Image Added

    Memória Principal da Aplicação(MB):

    Total: Total de memória utilizada pelo WSH.

    Livre: Total de memória livre reservado ao WSH.

    Utilizada:


    Memória Heap (MB): Reservado para as necessidades de alocação de memória do WSH.


    Memória não Heap (MB):


    Uso de Memória destinada a JVM: Total da memória total disponibilizados para o WSH. 


    Threads:


    Image Added

    Exibe todas as informações das Threads, id, Nome, Estado em que se encontram, prioridade quando existe, etc.


    Logs:


    Image Added

    Totvs custom tabs box items
    defaultno
    referenciaassisconfig3

    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:

    Image Removed

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

    Image Removed

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

    Erro 1:

    Image Removed

    Erro 2:

    Image Removed

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

    Image Removed

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

    Image Removed

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

    Image Removed

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

    Image Removed



    Expandir
    titleArquivo de configurações WSH
    Expandir
    titleapp.properties

    O arquivo app.properties, localizado na pasta de instalação do WSH ( C:\pcsist\produtos\winthor-integracao-core ) é responsável por algumas configurações para o correto funcionamento do WSH.

    Abaixo exemplificaremos o mesmo, com a descrição da funcionalidade de cada linha;


    Image RemovedImage Added



    • spring.datasource.initialize=
    • spring.datasource.url= Dados responsáveis pela conexão com o banco de dados do winthor.
    • spring.datasource.username= Dado responsável pelo usuário do banco de dados para realizar a conxexão.
    • spring.datasource.password= Senha do usuário para conectar no banco de dados (Deve ser no formato MD5 em caixa alta).
    • spring.datasource.driver-class-name= Driver de conexão do banco de dados oracle.
    • path.winthor.ini= Caminho do diretório do winthor.
    • url.ssh.wta= URL para acesso ao WTA.
    • port.ssh.wta= Porta para acesso ao WTA.
    • app.task.habilitadas=app.migration.ambiente.teste= Responsável por criar a integração com o PDV, deve ser retirado o comentário apenas para o seu uso na configuração inicial do WSH.
    • app.task.paginacao-winthor.page-size= Limita o tamanho da páginação do envio de dados.app.migration.habilitar= Habilita a atualização dos layouts no momento da inicialização (caso fique como true)
    • app.task.status-pos-integracao.intervalo-milissegundos=
    • app.task.status-pos-integracao.tempo-maximo-minutos=
    • app.task.recursos.schedule.fixedRate= Determina o tempo em segundos em que o WSH irá executar as ações.
    • app.restart-automatico.habilitar = Responsável por habilitar o reinicio automático do WSH.
    • app.restart-automatico.hora = Responsável por realizar o reinicio do WSH periodicamente (Neste caso, de acordo com a quantidade de HORAS que foi definido, ex: "6", será reiniciado periodicamente a cada 6 horas.)
    • app.restart-automatico.minuto = Responsável por realizar o reinicio do WSH periodicamente  (Neste caso, de acordo com a quantidade de MINUTOS que foi definido, ex: "30", será reiniciado periodicamente a cada 30 minutos.)
    • app.task.envio-integracao.threads = Responsável por definir a quantidade de itens em cada lote
      • Os 4 itens abaixo, são responsáveis por limpar as tabelas de movimentação, para evitar o acumudo de dados desnecessários(Integração core, Variáveis temp, dados recebidos etc.)
    • app.integracao-core.excluir=true Define a opção para realizar a exclusão de arquivos de tempos em tempos de acordo a configuração dos 3 itens abaixo;
    • app.integracao-core.excluir.agendador= Define o tempo para agendar o momento em que a execução das exclusões ocorrerá (0 6 17 * * * (OBS. Segundos, Minutos, Horas, Dia, Mes, Dia da Semana, o * indica recorrência))
    • app.integracao-core.excluir.minimo-dias= Define o período em que selecionará os dados para excluir (Ex: 20 irá excluir os dados de até 20 dias atrás)
    • app.integracao-core.excluir.tipo-dado= Define o tipo de dados que irá excluir (Ex. 1 - excluirá os dados ENVIADOS; 2 - RECEBIDO; 3 - AMBOS)



    OBS: Definir a opção app.task.envio-integracao.threads no arquivo app.proparties = 1; Se esta tag não estiver definida, será assumido o valor default 4. Essa tag influência na geração dos lotes pois é multiplicada a quantidade de theads pelo valor definido na variável limite (Utilizado nas variavéis);



    ...