Versões comparadas

Chave

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

...

Informações
titleFerramentas
Expandir
titleRotina 2660 - Atualização de Dados

A rotina 2660 permite atualizar datas de registros que estejam nulas (data de atualização, data de cadastro, etc). O intuito é preencher as datas dos registros que estejam nulas com uma data fixa (01/01/1900) ou com uma data especificada, afim de otimizar a carga de dados feita via WSH.

Aviso
titleATENÇÃO
  • Para utilizar a rotina 2660, é necessário instalar o serviço winthor-integracao-2660 na rotina 801 do WTA.
  • Para conseguir acessar a rotina 2660, é necessário habilitar na rotina 530 do WinThor a opção "1 - Permite controlar opção 'Atualização de dados para Integração'";
Totvs custom tabs box
tabs1 - Inicio, 2 - Temas, 3 - Tabelas, 4 - Colunas, 5 - Detalhes, 6 - Revisão
idsitem1-2660,item2-2660,item3-2660,item4-2660,item5-2660,item6-2660
Totvs custom tabs box items
defaultyes
referenciaitem1-2660
  • Nesta etapa será apresentada uma descrição da funcionalidade. É importante ler atentamente e entender o funcionamento da ferramenta.

  • Feita a leitura, basta clicar no botão "Iniciar", e em seguida "Confirmar" conforme imagem abaixo:


Totvs custom tabs box items
defaultno
referenciaitem2-2660
  • Nesta etapa serão apresentados em tela os temas principais presentes nas integrações realizadas pelo WSH. A escolha do tema definirá quais as tabelas que deverão ser listadas no passo seguinte.

Totvs custom tabs box items
defaultno
referenciaitem3-2660
  • Após a escolha do tema, serão listadas as tabelas impactadas pelas integrações referentes ao tema. Escolha as tabelas que deseja para na sequencia definir quais colunas de data serão atualizadas.

Totvs custom tabs box items
defaultno
referenciaitem4-2660
  • Nesta etapa, após a escolha das tabelas, são listadas em tela as colunas de data que a integração utiliza. Selecione quais colunas deseja atualizar os registros nulos.

Totvs custom tabs box items
defaultno
referenciaitem5-2660
  • Após a escolha das colunas de data que deseja alterar, será apresentado um detalhamento da quantidade de registros nulos presentes em cada uma das colunas selecionadas, basta seguir para o próximo passo e definir a data que deseja inserir para esses registros.

  • Caso não existam registros nulos, ao clicar no botão "Próximo passo", a seguinte mensagem será apresentada:

Totvs custom tabs box items
defaultno
referenciaitem6-2660
  • Nesta última etapa, deverá ser definida a data que será inserida nos registros nulos:

  • Opção "Inserir data/hora de forma automática"
    • Define automaticamente a data 01/01/1900 00:00:00 aos registros nulos.
  • Opção "Manual"
    • Permitirá definir uma data específica nos campos de data e hora presentes em tela.
  • Ao clicar em "Finalizar", será apresentada uma tela de confirmação da operação:

  • Após a confirmação, o update será realizado em todos os registros nulos com a data definida. Ao finalizar, será apresentado em tela um resumo da quantidade de registros alterados, e nesse resumo será possível visualizar um log do que foi realizado em cada uma das colunas.

Expandir
titleRotina 2650 - Monitor de Serviços WSH

O Monitor de serviços do WSH presente na rotina 2650 é uma ferramenta que permite acompanhar a utilização de memória, CPU, Threads e os logs da aplicação do WSH.

Aviso
titleATENÇÃO
  • Para utilizar o Monitor de Serviços do WSH, é necessário estar utilizando a versão futura do WSH.
Totvs custom tabs box
tabsAtivar Monitoria, CPU, Memória, Threads, Logs
idsmonitorServicoWSHPasso1,monitorServicoWSHPasso2,monitorServicoWSHPasso3,monitorServicoWSHPasso4,monitorServicoWSHPasso5

Para acessar a ferramenta, basta abrir a rotina 2650 e clicar no menu "Monitor Serviços WSH"

Totvs custom tabs box items
defaultyes
referenciamonitorServicoWSHPasso1

Ao clicar no botão "Iniciar monitoria" a ferramenta dará inicio ao monitoramento:

Image Added



Totvs custom tabs box items
defaultno
referenciamonitorServicoWSHPasso2

Na aba "CPU" é possível visualizarmos informações referentes ao processador, uso da JVM pela aplicação do WSH e também algumas informações de memoria da máquina física.

Image Added

Totvs custom tabs box items
defaultno
referenciamonitorServicoWSHPasso3

Na aba "Memória" visualizamos informações relacionadas a memória principal da aplicação, memórias heap e não reap, e também o uso da memória total destinada a JVM

Image Added

Totvs custom tabs box items
defaultno
referenciamonitorServicoWSHPasso4

Na aba "Threads" é possível acompanhar a quantidade de threads que a aplicação está utilizando, bem como o status de cada thread.

Image Added

Totvs custom tabs box items
defaultno
referenciamonitorServicoWSHPasso5

Na aba "Logs" podemos acompanhar os logs em tempo real da aplicação. Os logs são os mesmos registrados no arquivo de logs do WSH:

Image Added



Informações
titleAPI's
Expandir
titleIntegração de eventos

O objetivo é disponibilizar uma API de integração de eventos ao WSH;

Aviso
titleATENÇÃO
  • Para utilizar a API, deverá ser instalado o serviço winthor-integracao-config na versão 1.35.1.16 ou superior.
  • Antes de utilizar a API de integração de eventos é necessário realizar o Login no WTA.
Totvs custom tabs box
tabsRequest, Response
idsitem1-apiEvento,item2-apiEvento
Totvs custom tabs box items
defaultyes
referenciaitem1-apiEvento

O envio da requisição de eventos deverá ser realizado no seguinte endpoint:

  • winthor/integracao/fulfillment/v1/evento método POST;

O JSON deverá respeitar a seguinte estrutura:

Bloco de código
languagejs
{
	"origem": "ORIGEM",
	"codigoOrigem": "CODIGOORIGEM",
	"token": "bf602066-d434-47c6-9930-37fcd6891300",
	"codigoProcesso": 1,
	"descricaoProcesso": "DESCRICAO",
    "observacao":"OBSERVACAO"
}
CampoTipoDescriçãoObrigatório
origemString (50)Origem do evento.Sim
codigoOrigemString (100)Código de identificação da origem do eventoSim
tokenStringToken de identificação da requisição;Não
codigoProcessoLong (10)Código do processo referente ao evento.Sim
descricaoProcessoString (200)Descrição do processo referente ao evento.Não
observacaoStringObservação sobre o evento.Não


O objetivo da API é armazenar essa informação enviada no request na tabela PCINTEGRACAOEVENTORECEBIDO.


Totvs custom tabs box items
defaultno
referenciaitem2-apiEvento

Casa respeitados os campos de envio da requisição, o response deverá apresentar a seguinte estrutura:

  • HttpStatusCode 201 CREATED;
  • Um objeto contendo o evento inserido;

Ex:

Bloco de código
languagejs
{
    "origem": "ORIGEM",
    "codigoOrigem": "CODIGOORIGEM",
    "token": "bf602066-d434-47c6-9930-37fcd6891300",
    "descricaoProcesso": "DESCRICAO",
    "observacao": "OBSERVACAO",
    "codigoProcesso": 1,
    "dataCriacao": "2024-04-24T15:31:10.482",
    "dataAlteracao": "2024-04-24T15:31:10.482",
    "processado": false
}


Do contrário, caso algum campo obrigatório não tenha sido informado, o response irá informar HttpStatusCode 400 BAD REQUEST e o seguinte erro:

Bloco de código
languagejs
{
    "code": "WT-CONFIG-000032",
    "message": "Erro ao receber evento",
    "detailedMessage": "Campo Obrigatorio não pode ser nulo. Campo: X",
    "details": []
}

...