S-Works 2.9

Novidades e Configurações

Sumário

Segurança ___________________________________________________________________________ 3

Tradução _____________________________________________________________________________ 3

Arquitetura ___________________________________________________________________________ 4

Funcionalidades ______________________________________________________________________ 6

1. Protocolo de segurança na rota de processamento Highcharts. ______________________ 6

2.    Atenção! Alerta na Funcionalidade "Aplicar Todas as Prioridades"    . __________8

3. Melhoria na Visualização das Políticas de Regras do Sentinela no Sistema Sworks. ___ 11

4. Medir Volume de Inserções via Lote. ______________________________________________ 12

5. Método para Reinício de Tarefas na API REST ______________________________________ 14

6. Relacionamento x Relacionamento _______________________________________________ 19

7. Novo Parâmetro para impedir a exclusão de documentos via API de integração. ______ 22

8. Melhoria na funcionalidade Motor de Regras _______________________________________ 26

9. Melhoria nas métricas de tentativas e falhas. ______________________________________ 30

10. Criar parâmetro para Inativar detalhe no log referente ao Json do WebHook. _________ 30

11. Status Forçado | Retorno no Webhook. ____________________________________________ 30

12. Melhoria DocuSig: Posicionamento da assinatura na API ___________________________ 31

Segurança

Para aprimorar ainda mais nossos protocolos de segurança contínua, estamos integrando todas as etapas do ciclo de vida da aplicação e da infraestrutura. Realizamos ajustes no código com base nos insights fornecidos pelas ferramentas FortyFi e Sync, visando fortalecer nossa postura de segurança.

Além de abordar as questões de segurança identificadas, aproveitamos essa oportunidade para implementar as melhores práticas recomendadas pelas ferramentas utilizadas.

Tradução

Traduções Disponíveis em espanhol e inglês!

Estamos ampliando o suporte de idiomas da nossa aplicação! Agora, as principais áreas e funcionalidades estão disponíveis em espanhol e inglês, para melhorar a acessibilidade e inclusão global dos nossos usuários.

As áreas que receberam suporte de tradução incluem:

• Menu - Validação Manual > Validar Tarefa

• Menu - Administração > Workflow

• Tela Desenho > Workflow

• Menu - Processo > Monitorar Processo

• Tela - Detalhes do Processo

• Menu - Dashboards > Dashboards

• Caixa de Entrada > Detalhes do Processo

Para alterar o idioma, basta acessar as configurações no menu principal e selecionar a sua preferência.

Arquitetura

Atualização do .NET Framework para a Versão 8.0!

Estamos sempre buscando otimizar o desempenho e a estabilidade da nossa aplicação. Nesta atualização, realizamos a migração do .NET Framework para a versão 8.0, trazendo uma série de melhorias importantes, como:

• Melhor Performance: O tempo de resposta da aplicação foi aprimorado, oferecendo uma experiência mais ágil para os usuários.

• Maior Segurança: A nova versão inclui as atualizações mais recentes de segurança, protegendo ainda mais o ambiente contra vulnerabilidades.

• Novos Recursos: A versão 8.0 do .NET oferece suporte a novas funcionalidades e melhorias na integração com outros serviços, aumentando a flexibilidade do desenvolvimento.

Estamos comprometidos em oferecer a melhor experiência possível, garantindo que a aplicação esteja preparada para o futuro.

Otimização da Query Monitorar Tarefas

Realizamos melhorias significativas na tela de monitoramento de tarefas! As otimizações foram feitas na refatoração do código do método "RecuperarListaTarefas", visando aumentar a eficiência e o desempenho do sistema.

As principais alterações incluem:

• Transferência de Filtros para Subquery: Agora, os filtros utilizados na consulta foram movidos para uma subquery. Essa mudança limitou o número de registros processados, resultando em uma performance aprimorada.

• Remoção de Chamadas Desnecessárias: Eliminamos chamadas redundantes à função ToList() e loops foreach, que não eram essenciais, simplificando assim o fluxo de dados.

Como resultado, o sistema apresenta uma redução significativa no consumo de recursos do Banco de Dados. Isso significa que, em operações que lidam com grande volume de dados, como na tela de monitoramento de tarefas, a eficiência e o desempenho foram consideravelmente aumentados.

Melhoria na query Recuperar ItemTarefaDefCapacityDaView

A visão Gerencial de Operações passou por uma atualização significativa. Com a nova versão do dashboard, o carregamento de dados está substancialmente mais rápido, permitindo análises mais ágeis e decisões estratégicas com maior eficiência. Essa melhoria representa um avanço importante na performance e na experiência do usuário.

Antes, ao clicar em 'Executar' no Dashboard/Visão Gerencial de Operações, todos os dados eram carregados de uma vez, deixando o sistema mais lento. Agora, para agilizar seu trabalho, apenas os dados da aba 'Tarefas' serão carregados inicialmente. Essa atualização proporciona ao usuário maior controle sobre as informações mais relevantes para o momento. Caso deseje uma análise mais detalhada, é possível personalizar a visualização conforme a necessidade.

Atualização de dados otimizado

Reduzimos a carga de trabalho do Banco de Dados e aumentamos a velocidade dos processos! Com a nova estrutura de armazenamento, eliminam-se consultas desnecessárias ao reter apenas os resultados de cada ciclo de processamento. Essa melhoria foi implementada com base em uma análise criteriosa dos fluxos operacionais, que identificou uma oportunidade de otimização no armazenamento de dados, especialmente em processos caracterizados por um grande volume de tarefas executadas em poucos ciclos.

Funcionalidades

1. Protocolo de segurança na rota de processamento Highcharts.

Código:120291

Valor para o Produto:

Nesta nova versão, trouxemos uma atualização importante para o Highcharts, com a adição do Módulo de Exportação Offline. Agora, você poderá baixar gráficos diretamente da tela de dashboard de maneira muito mais prática e rápida.

Ao fazer o download dos gráficos, o arquivo é salvo automaticamente no seu computador. A exportação é instantânea, facilitando o acesso rápido aos gráficos, sem burocracias ou aprovações adicionais. Essas melhorias oferecem um fluxo de trabalho mais ágil e prático para os usuários, além de uma experiência mais integrada com a plataforma.

Configuração:

Ao selecionar uma empresa e um Workflow específico no dashboard, clique na aba 'Automação'. Isso exibirá dados semelhantes aos da imagem abaixo, fornecendo uma visão geral do processo automatizado.

Para baixar o gráfico exibido, procure o ícone de download localizado abaixo do botão '’Atualizar'’.

• possível baixar arquivos nos formatos PNG, JPEG, PDF e SVG. Ao clicar no formato desejado, será aberta uma janela para você escolher onde salvar o arquivo no seu computador. Um nome de arquivo sugerido, com a extensão escolhida, será apresentado.
  

Ao abrir o arquivo baixado, você verá que o nome, a extensão e as informações são exatamente as mesmas que aparecem no gráfico do S-Works.

• possível baixar gráficos nas seguintes telas do sistema:

• Dashboard / Automação

• Dashboard / Resultados

• Dashboard / Performance

• Dashboard / Diagnóstico/ Sistema

• Dashboard / Diagnóstico/ Fila de processamento

• Dashboard / Diagnóstico/ Atividades Manuais

2. ⚠  Atenção! Alerta na Funcionalidade "Aplicar Todas as Prioridades" ⚠ .

Código: 119764

Esta é uma atualização importante! Ao clicar no botão "Aplicar todas as prioridades", o sistema agora exibirá um alerta. Isso acontece porque a ação pode causar impactos significativos no desempenho do Banco de Dados e nos processos em andamento.

Valor para o Produto:

O modal vai mostrar o risco real que essa ação pode gerar, incluindo o número exato de processos afetados, e permitirá que você defina uma chave de configuração chamada: LIMITE_PROCESSOS_PRIORIZADOS. Com ela, você pode controlar o número mínimo de processos a serem priorizados, evitando que a execução indiscriminada cause um colapso no sistema e trave o Banco de Dados.

No modal, podemos ver uma chave de configuração que permite determinar a quantidade mínima de processos a serem executados. O valor dessa limitação pode ser ajustado por meio da chave de configuração LIMITE_PROCESSOS_PRIORIZADOS, que define a quantidade máxima de processos a serem priorizados (o valor padrão é 5000).

Para criar essa chave de configuração, basta seguir os passos:

1. Acesse Administração/Configurações.

2. Selecione Adicionar configurações.

Exemplo: se definir o valor como 300, o sistema permitirá que até 300 processos sejam afetados ou mais, caso não seja especificado outro valor. Se essa chave não for configurada, o sistema utilizará o valor padrão de 5000 processos.

Risco de Timeout e Congelamento do Sistema:

Sem esse controle, há um risco elevado de timeouts no Banco de Dados, o que pode travar os processos e alterar as prioridades de maneira inesperada, afetando diretamente a eficiência e a operação do sistema.

Proteção Crítica para o Usuário:

Este alerta não é apenas uma notificação, é uma proteção essencial para evitar erros graves que poderiam comprometer todo o fluxo de trabalho e gerar sérios problemas operacionais.

Fique atento, e use essa funcionalidade com cautela.

3. Melhoria na Visualização das Políticas de Regras do Sentinela no Sistema Sworks.

Código: 117443

Valor para o produto:

Essa atualização aprimora a visualização das políticas de regras do Sentinela, proporcionando maior transparência nas operações do sistema e otimizando seu desempenho.

Agora, o log exibe quando uma regra é aplicada e o motivo dessa aplicação, oferecendo mais clareza e eficiência na administração dos processos.

Configuração e Validação:

• Validação de Processos em Execução

Um processo em execução foi alterado manualmente via Banco de Dados, excluindo a entrada e reinserindo com data e hora diferentes. O Sentinela identificou a mudança e dentro de um intervalo de 15 minutos, devolveu o processo à fila de processamento.

Resultado: O Sentinela monitorou e após atingir a reincidência máxima (5 vezes), retornou o processo à fila.

Validação de Tarefas em Execução

Alterações foram realizadas no Banco de Dados na data de último processamento e status da tarefa. O Sentinela identificou a falha e devolveu o processo para a fila de processamento.

Resultado: O Sentinela identificou e corrigiu a tarefa com falha.

Validação do Último Processamento.

(SentinelaOnQueueFlagComUltimoProcessamento).

Um processo teve sua data de último processamento excluída manualmente no banco de dados. O Sentinela identificou essa alteração e removeu o processo da fila de processamento.

Resultado: O processo foi corretamente retirado da fila de processamento.

Validação Sem Último Processamento (SentinelaOnQueueFlagSemUltimoProcessamento).

A regra aplicada removeu a informação do último processo via Banco de Dados, resultando na remoção do processo da fila de processamento. O Sentinela fez a vigília e devolveu o processo à fila após sua correção.

4. Medir Volume de Inserções via Lote.

Código: 107533

Valor para o Produto:

Nesta versão, introduzimos uma nova visão no Grafana chamada

(sworks_acoeslote_processos_inseridos_total), que permite acompanhar as inserções de processos via lote em tempo real. Com essa funcionalidade, agora é possível monitorar detalhadamente a origem de cada chamada, identificando o Workflow, o usuário responsável,  além de registrar data e hora de cada inserção. Esse recurso visa melhorar o controle e a visibilidade sobre as operações realizadas via lote, facilitando a identificação de potenciais problemas e garantindo uma gestão mais eficiente dos processos em massa.

Configuração:

Para que os dados sejam corretamente alimentados no Grafana e no Prometheus, é necessário realizar a inserção de processos via lote. Para isso, acesse a aba de Processo e clique em Nova Solicitação em Lote.

Após concluir essa etapa, é necessário verificar se os processos foram realmente inseridos.

Para isso, acesse a aba de Processos e clique em Monitorar Solicitações em Lote.

Na imagem acima, é possível verificar que 11 processos foram inseridos corretamente.

Agora, vamos abrir a tela do Prometheus para confirmar se esses processos já estão registrados e visíveis na plataforma.

Agora, vamos visualizar os dados na tela do Grafana:

5. Método para Reinício de Tarefas na API REST.

Código: 112368

Valor para o Produto:

Configuração:

Acesse o Swagger do S-Works:

• Inicie o seu navegador e navegue até a interface do Swagger do S-Works.

• Após acessar o Swagger, você poderá visualizar duas novas rotas disponíveis.

• Primeira Rota: Esta rota utiliza o GUID do processo e a ordem da tarefa.

• Segunda Rota: Esta rota utiliza o número do processo e a ordem da tarefa.

Acessamos um processo que possui uma tarefa com um temporizador, no qual já está concluído.

Acessamos o Postman e executamos o Endpoint responsável por reiniciar a tarefa 50 do processo 162762, realizando a busca pelo número do processo.

Acessamos os detalhes do processo e constatamos que a tarefa está com o status 'Aguardando', confirmando que o reinício foi realizado com sucesso.

Acessamos a aba de histórico e notamos o registro deste reinício:

Após 1 minuto, a tarefa foi concluída conforme o esperado.

Realizaremos um teste reiniciando esta tarefa utilizando o GUID do processo. Para isso, acessamos os detalhes do processo e copiamos o GUID (identificador) correspondente.

Acessamos o Postman e executamos o endpoint responsável por reiniciar a tarefa 50 do processo 162762, utilizando o número do GUID para realizar a pesquisa.

Acessamos os detalhes da tarefa e confirmamos que o reinício foi realizado com sucesso.

6. Relacionamento x Relacionamento

Código: 113551

Uma atualização estratégica que transformará a forma como a organização gerencia relacionamentos no Workflow.

• Nova Coluna de Relacionamentos: Agora, na aba de relacionamentos, você pode visualizar de forma clara se um objeto possui relacionamentos e quantos são, garantindo mais transparência e organização.

• Botão de Atalho: Com apenas um clique, seja redirecionado diretamente para o objeto desejado, economizando tempo e otimizando sua navegação.

• Melhoria na Visualização de Relacionamentos: Nos detalhes do processo, ficou ainda mais fácil identificar a hierarquia entre objetos pais e filhos, simplificando o acompanhamento e a gestão.

Valor para o Produto:

Essas melhorias garantem mais visibilidade, agilidade e uma experiência de usuário ainda mais intuitiva, ajudando a gerenciar relacionamentos com eficiência e mais assertividade.

Configuração:

Na aba Relacionamentos, você pode visualizar a quantidade de objetos relacionados à cada item principal na coluna 'Qtd. Relacionamentos'. Ao clicar no botão 'Ver Objeto', o usuário será direcionado diretamente para a tela de cadastro do objeto principal, facilitando a navegação e a gestão dos seus dados.

Ao clicar no botão "Ver Objeto", a tela de gerenciamento do objeto é aberta com sucesso, permitindo editar, excluir ou adicionar novos dados de entrada de forma simples e eficiente.

Ao acessar os detalhes de um processo e clicar em 'Relacionamentos', uma nova aba 'Visualizar Relacionamentos' é aberta, mostrando os detalhes completos de cada relação.

Clicando nesta aba, você terá acesso ao nome do item principal e aos itens relacionados a ele, ou seja, objeto principal nome e os dois objetos filhos.

7. Novo Parâmetro para impedir a exclusão de documentos via API de integração.

Código: 120618

Agora, no formulário do workflow, foi implementado um novo parâmetro chamado "Bloquear a exclusão de documentos via Web API". Com ele, você tem total controle sobre a exclusão de documentos associados à um processo. Dependendo da configuração feita neste formulário, é possível bloquear a exclusão dos documentos pela API de integração, garantindo que arquivos críticos ou importantes sejam preservados e protegidos contra exclusões não autorizadas.

Valor para o Produto:

Esta adição aumenta significativamente a segurança e o controle sobre os documentos no sistema, permitindo que você gerencie com mais eficiência e confiabilidade os dados críticos do processo. Agora, os documentos ficam mais protegidos, evitando ações indesejadas e garantindo a integridade das informações.

Configuração:

Ao editar um formulário de Workflow, você encontrará uma nova opção: "Bloquear a exclusão de documentos via Web API". Ao ativar essa opção, todos os documentos vinculados a esse formulário ficarão protegidos contra exclusões indesejadas, garantindo a segurança e integridade dos seus dados.

Neste exemplo, serão testados 10 formulários. Em 5 deles, o parâmetro "Bloquear exclusão de documentos via Web API" estará ativo, enquanto nos outros 5 estará desativado.

Criamos um processo e associamos 10 documentos, com cada um vinculado a um formulário específico por meio da Tipificação.

Executamos o Endpoint para realizar a exclusão dos documentos:

Atualizamos os detalhes do processo e verificamos que os documentos associados aos formulários sem o parâmetro ativo foram excluídos, enquanto aqueles vinculados aos formulários com o parâmetro ativo foram preservados.

8. Melhoria na funcionalidade Motor de Regras.

Código: 116040

Incluímos um novo campo na tela do Motor de Regras, permitindo que o usuário informe o valor da escala para realizar o cálculo do score. A escala definida vai de 0 a 1000, oferecendo maior flexibilidade e precisão no cálculo da pontuação.

Valor para o Produto:

Com essa melhoria, o sistema agora realiza automaticamente o cálculo da pontuação máxima do score, com base na escala definida, eliminando a necessidade de cálculos manuais em outras tarefas. Isso simplifica o processo, aumenta a eficiência e melhora a experiência do usuário.

Configuração:

Ao criar o Motor de Regras, será possível observar um novo campo a ser preenchido. Para acessá-lo, siga o caminho: Administração > Motor de Regras > Adicionar Motor de Regras.

Ao clicar no campo, é possível preenchê-lo utilizando as setas ou, se preferir, digitar o número correspondente diretamente.

Para adicionar a nova escala a um Motor de Regras já existente, será necessário versionar.

Ao clicar no título do motor de regras, será exibida uma janela para edição, onde você poderá definir a escala.

Após executar o processo, o valor da escala informada será exibido na aba 'Dados JSON' da tarefa.

Na aba 'Detalhes do Motor de Regras', você encontrará o valor da escala utilizada e o resultado do score.

OBS: O sistema calcula o valor final utilizando a seguinte fórmula: (Score do Motor / Total de pontos distribuídos) x Pontuação máxima de score.

9. Melhoria nas métricas de tentativas e falhas.

Código: 121749

Valor para o Produto:

Agora, você tem ainda mais visibilidade sobre a saúde das suas integrações. Nossa nova métrica contabiliza os erros mapeados nas APIs, permitindo um acompanhamento detalhado das falhas e suas causas. Com essas informações, é possível tomar decisões mais assertivas e trabalhar de forma mais eficiente com seus fornecedores, garantindo a qualidade e a estabilidade do seu sistema.

10. Criar parâmetro para Inativar detalhe no log referente ao Json do WebHook.

Código: 118560

Valor para o Produto:

Agora você tem ainda mais flexibilidade para personalizar os logs da sua aplicação. Incluímos um novo parâmetro, WEBHOOK_LOGAR_JSON, que permite controlar se o JSON dos webhooks será registrado nos logs. Com essa novidade, você pode otimizar o armazenamento de logs e facilitar a busca por informações relevantes.

11. Status Forçado | Retorno no Webhook.

Código: 113009

Valor para o Produto:

Melhoria na comunicação entre sistemas: notificações de status forçado via webhook!

Para facilitar a integração entre sistemas, implementamos uma nova funcionalidade que permite enviar notificações via webhook, quando um status é alterado manualmente. Essa nova chave de configuração oferece mais flexibilidade e permite que você mantenha os sistemas sempre sincronizados.

12. Melhoria DocuSign: Posicionamento da assinatura na API

Código: 121462

Valor para o Produto:

Posicionamento preciso e personalizável de assinaturas no DocuSign!

Ganhe total controle sobre a localização das assinaturas em seus documentos! Nossa nova funcionalidade permite definir, de forma precisa e individualizada, a posição de cada assinatura em cada página de um documento. Você pode especificar múltiplas posições de assinatura por página e configurar essas informações para cada documento de forma independente.

Configuração:

Na configuração da tarefa, definimos 3 posições de assinatura e suas respectivas coordenadas:

Ao receber o documento para assinatura, é possível verificar 3 áreas de assinatura, conforme especificado no envio: