FAQs - Suporte técnico

Cross Segmento - Backoffice (Linha Protheus) - SIGAEST - Como instalar as Stored Procedures?


Dúvida

Como instalar as procedures antigas, e novas procedures com a nova gestão de procedures?

 

Ambiente
Cross Segmento - TOTVS Backoffice (Linha Protheus) - Todos os Módulos - Todas as versões

Solução

Neste artigo documentaremos, em passos, como baixar o pacote de Procedures e como instalá-las posteriormente, tanto da versão antiga utilizado SPS como a nova versão utilizando a nova gestão.

Obs: Nova Gestão da release 12.1.27 em diante.

 

 

Novo Gestor de Stored Procedures – CFGX051M

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 no RPO. A atualização destes arquivos ocorrerá de maneira semelhante à atualização de qualquer artefato, 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.

 

Vídeo modelo de configuração e instalação das novas procedures:

 

Migração para o novo modelo

 

Para preparar o ambiente e realizar a migração, tenha certeza de executar os seguintes passos:

 

Passo 1: 

Aplique o patch da Central de Atualizações Release 1.4.1 (ou superior). Para isso acesse a página de Release Notes e baixe o patch mais recente disponibilizado.

IMPORTANTE:

Mesmo que não utilize a Central de Atualizações, o patch da Release 1.4.1 (ou superior) deve ser aplicado. Ele é imprescindível pois atualizará o RPO com a nova interface e suas funcionalidades;

 

Passo 2: 

Aplique os patchs de Expedições Contínuas dos módulos relacionados abaixo para atualizar o RPO com os pacotes ZSPS e também as rotinas vinculadas aos processos de stored procedures:

    1. Versão 12.1.27
      1. FAT (Faturamento) - https://suporte.totvs.com/portal/p/10098/download#detail/954520
      2. COM (Compras) - https://suporte.totvs.com/portal/p/10098/download#detail/957277
      3. FIS (Fiscal) - https://suporte.totvs.com/portal/p/10098/download#detail/956585
      4. FIN (Financeiro) - https://suporte.totvs.com/portal/p/10098/download#detail/954746
      5. EST (Estoque) - https://suporte.totvs.com/portal/p/10098/download#detail/960571
      6. CTB (Controladoria) - https://suporte.totvs.com/portal/p/10098/download#detail/959397
    2. Versão 12.1.33
      1. FAT (Faturamento) - https://suporte.totvs.com/portal/p/10098/download#detail/1039091
      2. COM (Compras) - https://suporte.totvs.com/portal/p/10098/download#detail/1039089
      3. FIS (Fiscal) - https://suporte.totvs.com/portal/p/10098/download#detail/1039088
      4. FIN (Financeiro) - https://suporte.totvs.com/portal/p/10098/download#detail/1039087
      5. EST (Estoque) - https://suporte.totvs.com/portal/p/10098/download#detail/1039086
      6. CTB (Controladoria) - https://suporte.totvs.com/portal/p/10098/download#detail/1039084

 

IMPORTANTE:

Os patchs de Expedição Contínua dos módulos acima são necessários para que o RPO seja atualizado com os pacotes de procedures no novo formato .ZSPS, além das rotinas associadas às stored procedures. A aplicação destes patchs é obrigatória, caso contrário poderão ocorrer erros durante a instalação/desinstalação de processos.

 

Passo 3: 

Acesse o programa Gerenciador de procedures, através do menu Base de Dados | Dicionário | Stored Procedure. Será apresentada a seguinte interface:

IMPORTANTE:

Esta interface contendo as opções será apresentada somente se o patch da Central de Atualizações Release 1.4.1 (ou superior) foi aplicado corretamente no ambiente;

 

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.

 

Passo 4: 

Clique no botão Atualizar. O processo de migração se inicia e ao ser concluído a nova interface será apresentada.

 

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.


 

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  (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:

 

Demais validações como: consulta de logs, relações etc, acesse o link: Clique aqui

 

Processo no antigo gestor de Stored Procedure:

 

1° Passo - Baixá-los do Portal do Cliente:

Abra o seguinte link para acessar o Portal de Cliente: https://suporte.totvs.com/portal/p/10098/download#company/

 

Atente-se aos filtros para localizar o pacote de Procedures. Checar também na coluna Data para buscar o pacote mais atual:

mceclip0.png

 

2° Passo - Reinicie os serviços do Protheus (appserver e dbacess), seja via Serviços do Windows ou via Monitor;

 

3° Passo - Acesse a opção de menu Base de Dados > Dicionario > Stored Procedure > (CFGX051)

mceclip1.png

 

4° Passo - Caso estejam instaladas, devemos desinstalar primeiro, selecionando a opção "Desinstalar" e a Procedure que deseja desinstalar

mceclip2.png

5° Passo - Após desinstalar as Procedures, faça uma cópia de segurança (backup) dos arquivos das Procedures existentes na pasta System (os arquivos vem com nomenclatura p12_01.sps, p12_02.sps, p12_03.sps, até a p12_24.sps).

 

6° Passo - Copie o novo pacote de Stored Procedures baixadas na pasta System;

 

7° Passo - Volte ao Configurador, no menu Base de Dados > Dicionario > Stored Procedure > (CFGX051) da mesma forma que o passo 3;

 

8° Passo - Escolha a opção "Instalação" e dê um Ok

 

mceclip3.png

 

9° Passo - Selecione a(s) Procedure(s) que irá instalar 

 

mceclip4.png

 

10° Passo - Selecione a Empresa ou Grupo e confirme

 

 

11° Passo - As Procedures serão compiladas em seu Banco de Dados

 

 

12° Passo - Por fim, a mensagem de sucesso.

 

Saiba mais:

Clique aqui e veja mais artigos sobre Cadastros e Configurações no Estoque

Esse artigo foi útil?
Usuários que acharam isso útil: 0 de 0

0 Comentários

Por favor, entre para comentar.
X Fechar

Olá ,

Há pendência referente a um de seus produtos contratados para a empresa ().

Entre em contato com o Centro de Serviços TOTVS para tratativa.

Ligue! 4003-0015 opção 4 e 9 ou registre uma solicitação para CST – Cobrança – Verificação de pendências financeiras . clique aqui.

TOTVS

X Fechar

Olá ,

Seu contato não está cadastrado no Portal do Cliente como um perfil autorizado a solicitar consultoria telefônica.

Por gentileza, acione o administrador do Portal de sua empresa para: (1)configurar o seu acesso ou (2)buscar um perfil autorizado para registro desse atendimento.

Em caso de dúvidas sobre a identificação do contato administrador do Portal, ligue (11) 4003-0015, opção 7 e, em seguida, opção 4 para buscar o suporte com o time de Assessoria ao Portal do Cliente. . clique aqui.

TOTVS

X Fechar

Olá ,

Para o atendimento de "Consultoria Telefônica" você deverá estar de acordo com o Faturamento.

TOTVS

X Fechar

Olá,

Algo inesperado ocorreu, e o usuario nao foi reconhecido ou você nao se encontra logado

Por favor realize um novo login

Em caso de dúvidas, entre em contato com o administrador do Portal de Clientes de sua empresa para verificação do seu usuário, ou Centro de Serviços TOTVS.

Ligue! 4003-0015 opção 4 e 9 ou registre uma solicitação para CST – Cadastros . clique aqui.

TOTVS

Chat _

Preencha os campos abaixo para iniciar o atendimento:

Chat _