...

Pontos de atenção

Gerente de Projetos

Analytics

Quando o cliente possuir acesso ao Analytics (APA), será necessário solicitar à Infra para habilitar esse módulo para ter um acesso fluído sem a necessidade de fazer outro login. (PLT-7361)

Infraestrutura

Tempo da primeira inicialização de ambiente

Na primeira inicilização, após a atualizaçao de versão, poderá levar mais tempo que o padrão, pois serão realizadas rotinas de normalização de ambiente e banco de dados. (PLT-5800 e PLT-5944)

Configuração de limite de período de pesquisa

Para clientes migrados, quando o período de pesquisa for superior a 12 meses, isso é, no arquivo de configuracoes.properties no parâmetro de “pesquisa.periodo.meses”, o ambiente não irá iniciar e será apresentado o erro “Parametro 20 esta fora do range permitido, mínimo: 1 maximo: 12”. (PLT-6597 e PLT-6315)

Consultores

Logo e Banner

As configurações de cor, logo, banner etc, foram alteradas para o módulo do Admin – Configurações – Identidade Visual. (PLT-5083)

O tamanho máximo da logo é 1024 Kb e do banner é 5 Mb.

Módulo de Documento (ECM)

• Não haverá a opção de ordenação dos campos metadados, na tela de pesquisa do módulo Documentos (ECM). (PLT-5507)

• A pesquisa com fullText usando várias palavras, irão ser retornados somente os documentos que contenham todas as palavras enviadas para o filtro. Anteriormente ao fazer a pesquisa com fullText usando várias palavras, retornavam todos os documentos que possuíam ao menos uma das palavras enviadas no filtro. (PLT-5791)

• Será permitida uma exportação de documentos por vez, podendo ter uma fila de 10 requisções em espera.

Analytics

Adicionamos novo item “Analytics” no menu que visa abrir o produto Analytics da View B. Esse menu somente será exibido em clientes que tem esse produto contratado.

Já o módulo “Análises”, passa a ser chamado de “Estatísticas”  e não teve nenhuma alteração de funcionalidade no módulo. (PLT-7361)

Performance de pesquisa de processos

• No resultado de pesquisa, retiramos a opção de ordenar e agrupar para campos de formulário antigo. (PLT-5944)

• Limitamos a exportação de campos caixa de texto no formato XLSX para 32.767 caracteres, caso o valor ultrapasse essa quantidade, o mesmo será cortado e adicionado “…”. (PLT-6243)

• Logs

  Criamos o log que fica em [tomcat]/bpm/PESQUISA_EXPORTACAO.log para conter as seguintes informações da pesquisa de processo: filtros utilizados, tempo de processamento, total de resultado, usuário responsável, assim poderá ser identificado quem esta realizando pesquisa de processos e com quais condições. (PLT-6293)

• Banco de dados: SQL Server e Oracle

  Foi removido o comportamento de upper case nas queries para o banco de dados Sql Server e Orale para otimização de performance, portanto a consulta passa a seguir a configuração do banco, ou seja, CASE SENSITIVE ou CASE INSENSITIVE. Recomendamos que esteja configurado como CASE INSENSITIVE. (PLT-5944)

• Normalização usuário gestor

  Na tabela FORMULARIO foi removido o campo cod_usu_gestor, foi criado uma nova tabela para representar esse relacionamento, FORMULARIO_USUARIO_GESTOR, e nela contém os campos de vínculos. (PLT-5517 e PLT-5927)

• Configuração de limite de período de pesquisa

  No módulo Administrativo – Configurações – Gerais, através da opção “Período máximo de pesquisa em meses”, é possível definir o limite de período para pesquisa, em meses, quando utiliza a opção “Todos os processos” no Workspace – Pesquisa avançada.

  Em nova instalação, o período padrão é limitado a 3 meses.

  Já em atualização, o limite continuará o que estava configurado anteriormente no arquivo de configuracoes.properties. (PLT-6597 e PLT-6315)

• Limite de exportação de resultado de pesquisa

  A exportação de resultado de pesquisa de processo foi limitada (PLT-7038):

  • Para arquivos XML e PDF: até 20 mil registros;

  • Para os demais: até 50 mil registros;

• Limite de período para download

  A opção de “Download” do resultado de pesquisa de processo foi limitada para período de até 31 dias. Quando utilizado um período maior, será permitido apenas o envio por e-mail. (PLT-6468)

Autenticador personalizados

A opção “SSO_AUTENTICACAO_ALTERNATIVA”, que ficava no arquivo configuracoes.properties, foi descontinuada durante as versões, agora não sendo mais possível configurar uma autenticação alternativa no ambiente, com uma classe personalizada. Orientamos que esse tipo de customização utilize a camada intermediária de autenticação.

Pontos de impacto

...

Consultores

Permissões ao banco de dados

Para clientes novos, o acesso ao banco de dados será apenas com permissão de leitura, ou seja, não será mais possível alterar os dados de todos os banco de dados da Plataforma, sendo necessário utilizar os serviços disponíveis no Open API.

Infraestrutura

Banco de dados

Para clientes novos, o usuário bpm_prd_custom (para ambiente de produção) ou bpm_act_custom (para ambiente de aceite), deverá ser criado apenas com permissão de leitura. Lembrando que anteriormente era liberado permissões para manipulação de dados e criação de tabelas (insert, delete, update, etc).

Configuração de ambiente seguro: SSL

Desde da versão 5.70, o padrão de comunicação da plataforma deve utilizar SSL e um domínio com TLD válido para geração das chaves OAuth . (AT-3731 e AT-3857)

Novos serviços - SaaS

A partir desta versão, novos serviços em arquitetura SaaS foram criados e, portanto, deverão ser instalados uma única vez, conforme seus respectivos manuais. São eles:

• Implantação Gen-AI 1.0.0.pdf

• Implantação marketplace 1.0.0.pdf

Autenticação entre módulos (OAuth)

Para os serviços SaaS, a partir dessa versão, precisa criar o perfil ACTUATOR-METRICS para cada serviço abaixo, isso será feito uma única vez (PLT-6920):

• sign-service

• gitlab-service

• gen-ai-service

• catalog-service

• file-reader-service

• marketplace-service

• marketplace-integration-service

...

• actuator-metrics, não deve ser exportado como configuração, infra deve armazenar como chave para uso interno;

Monitoramento de ambiente

ParaosServiço (SaaS),ampliamos o recurso de monitoramento dos nossos serviços, conforme abaixo. Os detalhes técnicos estão disponíveis na seção “Monitoramento”, nos respectivos manuais de cada serviço:

...

E para Plataforma Lecom, ampliamos o recurso de monitoramento, conforme descrito na seção “Monitoramento do ambiente“ nomanual de Implantação Plataforma Lecom 6.0_v1.00.pdf.

Núcleo de IA

Será necessário realizar as configurações contidas no manual Implantação de novos ambientes no Gen-AI.pdf.

Flexibilidade de interface

Implementamos o sistema de mensageria no módulo do Admin e um novo microsserviço, o Admin-web. Portanto, será necessário realizar as configurações abaixo, conforme o manual Implantação Plataforma Lecom 6.0_v1.00.pdf (PLT-5083):

• Liberar acesso à porta 3004 para o novo microsserviço;

• Exportar as seguintes variáveis no arquivo setenv.sh do Tomcat

...

## ADMIN-WEB (COM CLUSTER)
 ProxyPass "/admin-web" balancer://admin-web/admin-web
 <Proxy balancer://admin-web>
   BalancerMember https://[IP_NODE_01]:3004 route=node01 loadfactor=1
   BalancerMember https://[IP_NODE_02]:3004 route=node02 loadfactor=1
   BalancerMember https://[IP_NODE_03]:3004 route=node03 loadfactor=1
   ProxySet stickysession=ROUTEID
 </Proxy>

Marketplace

Será necessário realizar as configurações abaixo:

...

<Location /marketplace-service> 
    ProxyPreserveHost Off 
    ProxyPass https://marketplace-service.lecom.com.br/marketplace-service 
    ProxyPassReverse https://marketplace-service.lecom.com.br/marketplace-service 
  </Location>
<Location /marketplace>
    ProxyPreserveHost Off
    ProxyPass https://marketplace.lecom.com.br/marketplace
    ProxyPassReverse https://marketplace.lecom.com.br/marketplace
</Location>

Assinador digital

Reorganizamos a estrutura de um único arquivo compose, para um projeto sign-compose, com múltiplos arquivos e pastas deste serviço SaaS. Com isso os caminhos de arquivos e variáveis foram alterados, exigindo os ajustes abaixo, no processo de configuração, isso será feito uma única vez. (PLT-7588)

• Alterações no services/sign-service.yml

  • Uso do cacerts:
     O arquivo cacerts foi movido para a pasta security do sign-compose. Se não quiser reimportar os certificados, substitua o arquivo cacerts da pasta security pelo atual do Java no ambiente de produção.

  • Configuração do bucket:
     As variáveis de configuração do bucket devem agora estar em /envs/sign dentro do sign-compose. Mova os arquivos de configuração da pasta /opt/lecom/app/microservices/envs/sign para /opt/lecom/app/sign-compose/envs/sign.

  • Revisão dos arquivos .env:
     As variáveis que estavam no arquivo único do Compose devem ser exportadas para os arquivos .env

  • Alteração no mapeamento de logs,

Antigo: /opt/lecom/app/microservices/logs:/opt/lecom/app/microservices/logs

Novo: ../logs/:/opt/lecom/app/microservices/logs/

• Alterações no services/mysql.yml

  • Mapeamento do volume do MySQL:
     O volume agora está mapeado para ../volumes/mysql_data:/var/lib/mysql dentro do sign-compose. A migração dos dados de /opt/lecom/app/docker-compose/volumes/mysql para sign-compose/volumes/mysql_data será necessária.

Analytics

Quando o cliente possuir acesso ao Analytics, será necessário:

• PROXY: aplicar configurações para redirecionar a chamada ao produto da View B, no arquivo .conf , conforme Implantação Plataforma Lecom 6.0_v1.00.pdf. (PLT-7361)

ProxyPass /external/analytics !  
Redirect /external/analytics [endereço da plataforma do cliente]/vb 

<Location /vb> 
    ProxyPreserveHost Off 
    ProxyPass [endereço fornecido pela View B]/vb 
    ProxyPassReverse [endereço fornecido pela View B]/vb 
  </Location> 

<Location /viewb> 
    ProxyPreserveHost Off 
    ProxyPass [endereço fornecido pela View B]/viewb 
    ProxyPassReverse [endereço fornecido pela View B]/viewb 
  </Location> 

<Location /biserver> 
    ProxyPreserveHost Off 
    ProxyPass [endereço fornecido pela View B]/biserver 
    ProxyPassReverse [endereço fornecido pela View B]/biserver 
 </Location>

...

Rota: PATCH /admin/api/v1/environments 
Body: 
{ 
    "properties": { 
        "ANALYTICS_ENABLED": "S" 
    } 
} 

Indexação de conteúdo em site de busca

Para desativar a indexação da plataforma Lecom, pelos motores de busca (Google, Bing etc.), é necessária a aplicação do cabeçalho X-Robots-Tag no proxy reverso que pode ser feito aplicando a tag Header set X-Robots-Tag "noindex, nofollow", conforme exemploabaixo, para cada ambiente de cliente, independente da versão. (AT-3746)

<VirtualHost *:443>
   ServerName pet.lecom.com.br
   ServerAlias pet.lecom.com.br
   ProxyPreserveHost On
   ProxyRequests Off
   SSLProxyEngine on
   Header set X-Robots-Tag “noindex, nofollow”
   # COOKIE NODE ROUTED
   Header add Set-Cookie "ROUTEID=.%{BALANCER WORKER ROUTE}e; path=/; Secure; HttpOnly" env=BALANCER ROUTE CHANGED
   # ADMIN-API
   ProxyPass /admin/api balancer://gateway/admin/api
   # ECM-API
   ProxyPass /ecmcore/api balancer://gateway/ecmcore/api
   # APP-EXT
   ProxyPass /app-ext balancer://app-ext

Envio de e-mail com OAuth 2.0

A tabela utilizada para configurar e-mail mudou da tabela Parametro para Email, por isso é necessário alterar o script de limpeza de base, para retirar as configurações da tabela nova. Conforme script atualizado Script_limpeza_PET_V6.00_2024.sql . (PLT-4819)

Configurações personalizadas das propriedades

As configurações que constavam no arquivo configuracoes.properties, passaram ser armazenadas diretamente na tabela “Environment_properties” no banco de dados BPM. Para realizar atualização, será necessário consumir um serviço (API), via CURL ou POSTMAN, conforme a seção “Apendice B”  do manual Implantação Plataforma Lecom 6.0_v1.00.pdf e não será mais necessário reiniciar o ambiente para que alteração tenha efeito. (PLT-6597)

Por isso o arquivo {Storage}/bpm/configuracoes/configuracoes.properties não será mais criado.

Atenção, a opção “SSO_AUTENTICACAO_ALTERNATIVA” foi descontinuada durante as versões, agora não sendo mais possível configurar uma autenticação alternativa no ambiente, com uma classe personalizada. Orientamos que esse tipo de customização utilize a camada intermediária de autenticação.

Pacotes

Plataforma Lecom

Servicos Saas

IA Generativa

Autenticador entre módulos ( OAuth-service)

Devops (Gitlab-service, Gitlab-service-client)

Assinador digital (Sign-service)

Marketplace