Sumário
Novo Gestor de Stored Procedures – CFGX051
Migração para o novo modelo
Nova interface
Relação de empresas
Relação de processos
Guia Empresa vs Processos
Guia Processo vs Empresas
Visualizando detalhes
Instalando pacotes de procedures
Desinstalando pacotes de procedures
Consultando o histórico de operações

Importante: Esta funcionalidade esta sendo distribuída de forma controlada em baixa escala, não estando disponível neste momento a todos os clientes, a previsão de liberação total será em Maio/2022

Novo Gestor de Stored Procedures – CFGX051

O programa gerenciador de procedures (CFGX051) do módulo Configurador (SIGACFG) passou por uma mudança significativa.
Uma das principais mudanças, além da interface totalmente remodelada, será o fato de não mais existirem os arquivos de pacotes com extensão SPS. Estes arquivos foram substituídos por arquivos de extensão ZSPS, que estarão embarcados dentro do RPO. A atualização destes arquivos ocorrerá de maneira semelhante à atualização de qualquer artefato dentro do RPO, ou seja, através de patchs de atualizações expedidos pela TOTVS.
Outra grande mudança é a integração com a Central de Atualizações para obtenção dos pacotes de procedures mais recentes homologados. Esta integração ocorrerá de maneira transparente visando facilitar o processo de atualização das procedures no ambiente. Para saber mais clique aqui.

IMPORTANTE:
Esta alteração não afeta:

Como as procedures são executadas;
Como são instaladas no banco;
Conteúdo das procedures e dos pontos de entradas;
Esta alteração apenas muda a interface e a forma como as procedures são distribuídas.

Migração para o novo modelo

Ao acessar o programa gerenciador de procedures (CFGX051), através do menu Base de Dados | Dicionário | Stored Procedure, será apresentada a seguinte interface:
Linha Microsiga Protheus > Stored Procedures - Novo gerenciador de pacotes > worddavc93595b23c3aa2e2ab88c0fd823d291b.png
As opções disponíveis são:
Documentação: ao clicar neste botão o usuário será levado para esta documentação.
Manter: ao clicar neste botão a rotina atual, sem as novas funcionalidades, será exibida. É importante lembrar que o modelo antigo não sofrerá nenhuma atualização, não serão expedidas atualizações em arquivos SPS, somente no novo formato ZSPS.
Atualizar: ao clicar neste botão o processo de migração ocorrerá. Serão realizados procedimentos que não poderão ser desfeitos, ou seja, após migrado não será possível voltar ao modelo antigo de gestão de procedures. Após realizada a migração para o novo modelo essa interface de migração não será exibida novamente.
Fechar: a rotina não será acionada, retornando ao menu da janela principal do Protheus.

Nova interface

A principal mudança na interface será a apresentação das empresas disponíveis no ambiente e todos os processos existentes para gerenciamento ao mesmo tempo, em uma mesma janela. Não haverá necessidade de mudança de empresa para se visualizar os processos dela.

A interface possui novos botões laterais que permitirão gerenciar os processos de maneira prática e rápida realizando a instalação e remoção de processos com poucos cliques. Consulta e relatório de log de processamento estarão disponíveis também. Novas abas permitem uma navegação mais simples e eficiente para visualizar os processos e empresas. E os totalizadores darão um resumo de forma rápida sobre os status dos processos.
Linha Microsiga Protheus > Stored Procedures - Novo gerenciador de pacotes > worddavd351edb9bcb0c088c694c22d418faa96.png

Relação de empresas

Aqui serão listadas todas as empresas disponíveis no ambiente. Não há necessidade se entrar no ambiente utilizando a empresa para a qual se deseja instalar/desinstalar um processo.
Será possível marcar mais de uma empresa e realizar a ação desejada de uma só vez.
Linha Microsiga Protheus > Stored Procedures - Novo gerenciador de pacotes > worddav49ed50aa0d1089e7881d797bbafd4bcc.png
As ações disponíveis nos botões da barra lateral são:
Instalar os pacotes selecionados nas empresas selecionadas.
Remover os pacotes selecionados das empresas selecionadas.
Linha Microsiga Protheus > Stored Procedures - Novo gerenciador de pacotes > worddav056163d3493ae5dca8df7c3ca126a5e6.png Marcar todas as empresas disponíveis no grid.
Desmarcar todas as empresas do grid.
Consultar o histórico de operações.

Relação de processos

Serão listados todos os processos disponíveis para instalação.
Linha Microsiga Protheus > Stored Procedures - Novo gerenciador de pacotes > worddav6b1e5811f6368c1d488766e5a75dc571.png
As ações disponíveis nos botões da barra lateral são:
Marcar todos os processos disponíveis no grid.
Desmarcar todos os processos do grid.

Guia Empresa vs Processos

A visão disponibilizada nesta guia baseia-se na navegação realizada entre as empresas disponíveis na relação de empresas.
Linha Microsiga Protheus > Stored Procedures - Novo gerenciador de pacotes > worddav31e10aa399f2203276ba5a733c0ee4e2.png
A parte superior apresentará o nome da empresa posicionada, além dos totalizadores de cada um dos possíveis status.
Na parte inferior estarão relacionados todos os processos disponíveis e seus respectivos status na empresa posicionada.

LEGENDA
Linha Microsiga Protheus > Stored Procedures - Novo gerenciador de pacotes > worddavef5ec450ef78281bf4d2ee4bb1a091cc.png Indica que o processo não está instalado na empresa posicionada.
Indica que o processo está instalado corretamente na empresa posicionada.
Indica que o processo ou a rotina AdvPL está desatualizada para a empresa selecionada.
Linha Microsiga Protheus > Stored Procedures - Novo gerenciador de pacotes > worddav06c91b5e30da8042075c396d8189f17c.png Indica que o processo não pode ser avaliado na empresa posicionada.

Guia Processo vs Empresas

A visão disponibilizada nesta guia baseia-se na navegação realizada entre os processos disponíveis na relação de processos.
IMPORTANTE: Esta guia somente estará visível caso exista mais de uma empresa disponível no ambiente.
Linha Microsiga Protheus > Stored Procedures - Novo gerenciador de pacotes > worddavaa1a9839151fc1cb66da899a236355d2.png
A parte superior apresentará o nome do processo posicionado, além dos totalizadores de cada um dos possíveis status.
Na parte inferior estarão relacionadas todas as empresas disponíveis e seus respectivos status perante o processo posicionado.

LEGENDA
Linha Microsiga Protheus > Stored Procedures - Novo gerenciador de pacotes > worddavef5ec450ef78281bf4d2ee4bb1a091cc.png Indica que a empresa não possui o processo instalado.
Indica que a empresa possui o processo instalado corretamente.
Indica que a empresa está com o processo ou a rotina AdvPL desatualizada.
Linha Microsiga Protheus > Stored Procedures - Novo gerenciador de pacotes > worddav06c91b5e30da8042075c396d8189f17c.png Indica que não foi possível avaliar a empresa para o processo posicionado.

Visualizando detalhes

Ao efetuar um duplo clique no grid onde estão relacionados os processos e empresas e seus respectivos status, será exibida uma interface contendo detalhes sobre o item selecionado.
Linha Microsiga Protheus > Stored Procedures - Novo gerenciador de pacotes > worddavd1e3ea105c312934df637c520db12472.png

As seções apresentadas são:
Seção Detalhes:
Linha Microsiga Protheus > Stored Procedures - Novo gerenciador de pacotes > worddav6523b4819bd2a51514f6b19ce734c3ae.png
Apresenta informações detalhadas sobre o ambiente:

Status da integração com a Central de Atualizações;
Código da empresa;
Nome da empresa;
Código do processo;
Nome do processo;

Seção Processo:
Linha Microsiga Protheus > Stored Procedures - Novo gerenciador de pacotes > worddavf07d5674c16c325f5a0984d1fccf04db.png
Apresenta informações detalhadas do processo:

Status;
Código da assinatura;
ID e data do pacote ZSPS instalado;
ID e data do pacote ZSPS contido no RPO;
ID e data do pacote ZSPS disponível na Central de Atualizações;

Seção Rotina:
Linha Microsiga Protheus > Stored Procedures - Novo gerenciador de pacotes > worddav2431cdc3c8bfd924e6698408d5a59744.png
Apresenta informações detalhadas do rotina AdvPL associada ao processo:

Status;
Código da assinatura;
Nome da rotina/programa fonte;
Data da rotina contida no RPO;
Data da rotina disponível na Central de Atualizações;
Botão "Buscar atualização": direciona para o portal de atualização, para obtenção do patch (estará disponível apenas se houver integração com a Central de Atualizações);

Seção Gestão de Procedures:
Linha Microsiga Protheus > Stored Procedures - Novo gerenciador de pacotes > worddav6d68cfbceb5ad7e416473fd23792d030.png
Apresenta informações detalhadas da interface de Gestão de procedures (CFGX051M):

Status;
Código da assinatura;
Nome da rotina/programa fonte;
Data da rotina contida no RPO;
Data da rotina disponível na Central de Atualizações;
Botão "Buscar atualização": direciona para o portal de atualização, para obtenção do patch (estará disponível apenas se houver integração com a Central de Atualizações);

Instalando pacotes de procedures

Não será necessário obter nenhum arquivo SPS para realizar a instalação dos processos. Os arquivos necessários para a instalação estarão presentes de forma embarcada no RPO. Estes arquivos possuem a extensão ZSPS e contém todas as informações necessárias para que o procedimento seja realizado de maneira off-line (sem integração com a Central de Atualizações).
Durante o procedimento de instalação, caso a integração com a Central de Atualizações esteja ativa, os processos mais atuais homologados pela TOTVS serão obtidos de maneira online e serão utilizados na instalação (desde que sejam mais recentes que os disponíveis no RPO).
Dessa forma garantimos que o ambiente esteja sempre atualizado com os processos de procedures mais recentes homologados.
Para realizar a instalação:

Selecionar em quais empresas os processos serão instalados:
Selecionar quais processos serão instalados:

Após selecionar as empresas e processos, basta clicar no botão (instalar processos).

Será exibida uma janela com alguns avisos solicitando a confirmação da instalação:

O procedimento de instalação somente poderá ocorrer se os processos selecionados não estiverem em uso por outra rotina neste momento.
Ao confirmar, surgirá uma outra janela exibindo o andamento da instalação:

Ao final do procedimento surgirá uma janela contendo o log da operação realizada:

No botão Outras Ações é possível gerar o relatório deste log.
Ao fechar a janela de log, a interface principal será atualizada para refletir o status atual:

Desinstalando pacotes de procedures

O procedimento para desinstalação de pacotes é semelhante ao de instalação. É necessário apenas que os processos envolvidos não estejam em uso. Este procedimento necessita de acesso exclusivo em algumas tabelas do banco de dados e por isso não pode haver concorrência.
Para realizar a desinstalação:
Selecionar em quais empresas os processos serão desinstalados:
Selecionar quais processos serão desinstalados:

Após selecionar as empresas e processos, basta clicar no botão (desinstalar processos).
Será exibida uma janela com alguns avisos solicitando a confirmação da desinstalação:

O procedimento de desinstalação somente poderá ocorrer se os processos selecionados não estiverem em uso por outra rotina neste momento.
Ao confirmar, surgirá uma outra janela exibindo o andamento da desinstalação:

Ao final do procedimento surgirá uma janela contendo o log da operação realizada:

No botão Outras Ações é possível gerar o relatório deste log.
Ao fechar a janela de log, a interface principal será atualizada para refletir o status atual:

Consultando o histórico de operações
Para visualizar todas as operações realizadas, basta clicar no botão (Histórico de operações)

No botão Outras Ações é possível gerar o relatório completo de todas as operações contidas no log.