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: A partir de 06/05/2022 as stored procedures serão atualizadas apenas por esta nova funcionalidade. Isso significa que os arquivos de extensão SPS e a rotina CFGX051 não serão mais atualizados. Sendo este o novo e exclusivo processo de atualização de procedures.

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, é 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.

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, isto é, não serão expedidas atualizações em arquivos SPS, somente no novo formato ZSPS.
Atualizar: ao clicar neste botão, ocorrerá o processo de migração. 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 a visualização dos seus processos.

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 de 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.
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.

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 um 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 recentemente 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 Linha Microsiga Protheus > Stored Procedures - Novo gerenciador de pacotes > worddav4fff3b945bb21f990a9906fa19377a01.png (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:
Linha Microsiga Protheus > Stored Procedures - Novo gerenciador de pacotes > worddav178d711de5a613775647d6c2fe253bb3.png

Ao final do procedimento surgirá uma janela contendo o log da operação realizada:
Linha Microsiga Protheus > Stored Procedures - Novo gerenciador de pacotes > worddavea0373c72c852f8ca614d13136e334fc.png

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:
Linha Microsiga Protheus > Stored Procedures - Novo gerenciador de pacotes > worddav44e49501a3f84a3368d84b70723d7403.png

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 Linha Microsiga Protheus > Stored Procedures - Novo gerenciador de pacotes > worddavde157571e60718492642fc5ecfcdb29d.png (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:
Linha Microsiga Protheus > Stored Procedures - Novo gerenciador de pacotes > worddav0379bc81e46f652071c361ea714b8ecb.png

Ao final do procedimento surgirá uma janela contendo o log da operação realizada:
Linha Microsiga Protheus > Stored Procedures - Novo gerenciador de pacotes > worddavc206bae9b66de38e52c9a3198bde5a03.png

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:
Linha Microsiga Protheus > Stored Procedures - Novo gerenciador de pacotes > worddav0f291d73dd336f425223ec8cf67ea6d4.png

Consultando o histórico de operações

Para visualizar todas as operações realizadas, basta clicar no botão Linha Microsiga Protheus > Stored Procedures - Novo gerenciador de pacotes > worddav6d7d2d3a02b95ab972ad82169732d848.png (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.