Expandir |
---|
title | Configuração de Parâmetros |
---|
| Expandir |
---|
title | Cadastro 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 |
---|
title | Cadastro de parâmetros |
---|
|
Totvs custom tabs box |
---|
tabs | Passo 1, Passo 2, Passo 3 |
---|
ids | item-param1,item-param2,item-param3 |
---|
|
Totvs custom tabs box items |
---|
default | yes |
---|
referencia | item-param1 |
---|
|
No WSH, acessar o item 5 da rotina 2650, que é a configuração de parâmetros;
Image Removed
Totvs custom tabs box items |
---|
default | no |
---|
referencia | item-param2 |
---|
|
Clique no botão Novo, (será apresentado os dados para Cadastro de parâmetro);
Image Removed
Totvs custom tabs box items |
---|
default | no |
---|
referencia | item-param3 |
---|
|
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.
Expandir |
---|
title | Configuração de fluxos |
---|
|
Expandir |
---|
|
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 |
---|
tabs | Passo 1, Passo 2, Passo 3, Passo 4, Passo 5 |
---|
ids | item-fluxo1,item-fluxo2,item-fluxo3,item-fluxo4,item-fluxo5 |
---|
|
Totvs custom tabs box items |
---|
default | yes |
---|
referencia | item-fluxo1 |
---|
|
Já no WSH, acessar o item 4 da rotina 2650, que é a configuração de fluxos;
Image Removed
Totvs custom tabs box items |
---|
default | no |
---|
referencia | item-fluxo2 |
---|
|
Clique no botão Novo, (será apresentado os dados para Cadastro de fluxos);
Image Removed
Totvs custom tabs box items |
---|
default | no |
---|
referencia | item-fluxo3 |
---|
|
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
Totvs custom tabs box items |
---|
default | no |
---|
referencia | item-fluxo4 |
---|
|
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;
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 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 |
---|
default | no |
---|
referencia | item-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 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 |
---|
title | Configuração de detalhes técnicos |
---|
|
Expandir |
---|
|
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 |
---|
tabs | Passo 1, Passo 2 |
---|
ids | item-detalhes1,item-detalhes2,item-detalhes3 |
---|
|
Totvs custom tabs box items |
---|
default | yes |
---|
referencia | item-detalhes1 |
---|
|
Já no WSH, acessar o item 5 da rotina 2650, que é a configuração de detalhes técnicos;
Image Removed
Totvs custom tabs box items |
---|
default | no |
---|
referencia | item-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 Removed
Também é possível visualizar a legenda dos status que são apresentados em cada um dos itens disponíveis.
Image Removed
Expandir |
---|
title | Cadastro e consulta de DE/PARA |
---|
|
Expandir |
---|
|
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 |
---|
tabs | Passo 1, Passo 2, Passo 3, Passo 4, ´Passo 5 |
---|
ids | item-depara1,item-depara2,item-depara3,item-depara4,item-depara5 |
---|
|
Totvs custom tabs box items |
---|
default | yes |
---|
referencia | item-depara1 |
---|
|
Já no WSH, acessar o item 5 da rotina 2650, que é a configuração de DE/PARA;
Image Removed
Totvs custom tabs box items |
---|
default | no |
---|
referencia | item-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 Removed
Totvs custom tabs box items |
---|
default | no |
---|
referencia | item-depara3 |
---|
|
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
Totvs custom tabs box items |
---|
default | no |
---|
referencia | item-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 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 |
---|
default | no |
---|
referencia | item-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 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
Expandir |
---|
title | Assistente de configuração |
---|
|
Expandir |
---|
title | Assistente de configuração |
---|
|
***SERÁ DISPONIBILIZADO EM VERSÃO FUTURA DO WINTHOR***
O objetivo é possibilitar o acesso ao Assistente de configuração do Winthor Smart Hub.
Para alterar 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 |
---|
tabs | Passo 1, Passo 2, Passo 3, Passo 4, ´Passo 5 |
---|
ids | assisconfig1,assisconfig2,assisconfig3,assisconfig4,assisconfig5 |
---|
|
Totvs custom tabs box items |
---|
default | yes |
---|
referencia | assisconfig1 |
---|
|
Já no WSH, acessar o item 2 da rotina 2650, que é a configuração de Assistente de configuração;
Image Removed
Totvs custom tabs box items |
---|
default | no |
---|
referencia | assisconfig2 |
---|
|
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, devemos selecionar o ambiente em que será utilizado, Homologação ou Produção:
Image Removed
Após selecionar a versão, podemos clicar em atualizar:
Image Removed
Totvs custom tabs box items |
---|
default | no |
---|
referencia | assisconfig3 |
---|
|
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 |
---|
title | Monitor de Serviço WSH |
---|
|
Expandir |
---|
title | Monitor de Serviço WSH |
---|
|
***SERÁ DISPONIBILIZADO EM VERSÃO FUTURA DO WINTHOR***
O objetivo é possibilitar o acesso ao Monitor de Serviço do Winthor Smart Hub.
Para poder acompanhar via tela, e quando necessário, habilitar ou desabilitar o mesmo. Devemos acessar a rotina 2650 do WSH.
Totvs custom tabs box |
---|
tabs | Passo 1, Passo 2, Passo 3 |
---|
ids | monitorsv1,monitorsv2,monitorsv3 |
---|
|
Totvs custom tabs box items |
---|
default | yes |
---|
referencia | monitorsv1 |
---|
|
Já no WSH, acessar o item 9 da rotina 2650, que é a configuração de Monitor Serviço WSH;
Image Removed
Totvs custom tabs box items |
---|
default | no |
---|
referencia | monitorsv2 |
---|
|
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 Removed
Para iniciar a Monitoria, basta clicar em "Iniciar Monitoria":
Image Removed
Para parar, basta clicar em "Parar Monitoria"
Image Removed
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 Removed
Parar o serviço (será necessário iniciar o serviço manualmente depois dessa ação):
Image Removed
Totvs custom tabs box items |
---|
default | no |
---|
referencia | monitorsv3 |
---|
|
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 Removed
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 Removed
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 Removed
Exibe todas as informações das Threads, id, Nome, Estado em que se encontram, prioridade quando existe, etc.
Logs:
Image Removed
Expandir |
---|
title | Arquivo de configurações WSH |
---|
|
Expandir |
---|
|
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 Removed
- 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.task.paginacao-winthor.page-size= Limita o tamanho da páginação do envio de dados.
- 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);