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

Âncora
novo_gestor_stored_procedures novo_gestor_stored_procedures _heading h.gjdgxs

Novo Gestor de Stored Procedures – CFGX051

A partir de 26/01/2022 o programa gerenciador de procedures (CFGX051) do módulo Configurador (SIGACFG) passará 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.

Âncora
migracao_novo_modelo migracao_novo_modelo _heading h.30j0zll

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:

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. Bem como a partir de 26/01/2022 não serão expedidas atualizações em arquivos SPS, somente o novo 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.

Âncora
nova_interface nova_interface _heading h.1fob9te

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.

Âncora
relacao_empresas relacao_empresas _heading h.3znysh7

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.

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.

Âncora
relacao_processos relacao_processos _heading h.2et92p0

Relação de processos

Serão listados todos os processos disponíveis para instalação.

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.

Âncora
guia_empresa_processos guia_empresa_processos _heading h.tyjcwt

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.

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
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.
Indica que o processo não pode ser avaliado na empresa posicionada.

Âncora
guia_processo_empresas guia_processo_empresas _heading h.3dy6vkm

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.

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
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.
Indica que não foi possível avaliar a empresa para o processo posicionado.

Âncora
visualizando_detalhes visualizando_detalhes _heading h.23k0u7fdxslw

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.

...

• 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);

Âncora
instalando_pacotes instalando_pacotes _heading h.f41wful3yjzh

Instalando pacotes de procedures

Não será necessário obter nenhum arquivo SPS para realizar a instalação dos processos. Como dito anteriormente, a partir de 26/01/2022, os arquivos necessários para a instalação estã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:
  
  
  

  Âncora
  desinstalando_pacotes desinstalando_pacotes _heading h.4d34og8

  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:
  
  

  Âncora
  consultando_historico consultando_historico _heading h.2s8eyo1

  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.