Escolar Documentos
Profissional Documentos
Cultura Documentos
CFG - Manutenção de Stored Procedures
CFG - Manutenção de Stored Procedures
Foi desenvolvido um novo mecanismo para manutenção das stored procedures dos módulos de materiais e
controladoria.
Atualmente o processo de instalação das stored procedures é feito através da utilização de um único arquivo
(“SIGAP10.SPS”) em que é possível apenas instalar ou remover todas as procedures de uma única vez.
No novo método o pacote “SIGAP10.SPS” foi separado por processos, possibilitando um melhor controle das
rotinas que utilizam stored procedures.
Cada processo possui um conjunto de stored procedures que podem ser instaladas/atualizadas ou removidas
separadamente do banco de dados utilizado, permitindo ao usuário instalar somente os processos que deseja
utilizar.
Nome do
Rotina Procedure Processo Descrição
pacote
P10_01.SPS CTBA190 CTB020 01 Reprocessamento contábil
Reprocessamento contábil de
P10_02.SPS CTBA190 CTB001 02
orçamentos
P10_03.SPS CTBA220 CTB020 03 Consolidação geral de empresas
P10_04.SPS CTBXFUN CTB150 04 Atualização de saldos on-line
Atualização de saldos on-line por
P11_06.SPS CTBXATU CTB185 06 lote (função disponível apenas na
versão Protheus 11)
P10_07.SPS JOB192 CTB165 07 Reprocessamento por contas
Cada processo possui seu próprio arquivo de pacote (SPS) com uma nomenclatura que define qual
rotina/processo o arquivo se refere. Os pacotes de stored procedures são obtidos juntamente com o pacote de
fontes AdvPL de cada um dos processos descritos na tabela acima.
Observações:
Os nomes dos arquivos de pacote são pré-definidos e não podem ser modificados. Cada processo necessita
que seu respectivo arquivo esteja com a nomenclatura conforme definida na tabela acima, respeitando a versão
do sistema.
Importante
O processo “06 – Atualização de saldos on-line por lote” estará disponível apenas na versão Protheus 11.
As stored procedures receberão uma nova nomenclatura no novo método de manutenção. O código do
processo será adicionado ao nome da procedure seguido do código da empresa.
Algumas procedures são executadas por mais de um processo. Para cada processo instalado no banco, um
conjunto novo de procedures também será instalado. Desse modo pode-se identificar facilmente à qual
processo a procedure pertence.
Deste modo, ao remover um processo, somente as procedures pertencentes ao processo serão removidas do
banco de dados e os demais processos continuarão funcionando normalmente.
Houve uma mudança no tamanho do nome de algumas destas procedures, conforme demonstrado abaixo:
Modelo antigo Modelo novo
Nome Tamanho Nome Tamanho
MSCALCPERIODO 13 MSCALCPER 9
MSCHARINDEX 11 MSCHARIND 9
Observação:
Estas procedures/functions seguem a mesma regra de nomenclatura das demais procedures, ou seja,
receberão o código do processo e da empresa na qual foram instaladas.
As procedures de pontos de entrada são as únicas que não serão modificadas em sua nomenclatura.
Por serem específicas de cada processo, ou seja, somente um processo faz uso de uma procedure de ponto de
entrada, não há necessidade de alteração do nome. Não existe duplicidade deste tipo de procedure no banco
de dados.
Com isso será preservada toda programação realizada pelo usuário em cada uma destas procedures, já que
elas também não são removidas do banco ou substituídas no caso de uma atualização de pacote.
Importante: Clientes que utilizam as stored procedures referentes ao processo de Custo Em Partes,
deverão acertar a chamada da stored procedure xFilial contida na programação das stored procedures
MA330CP, M330INB2CP, M330INC2CP, M280INB9CP e MA280INC2CP. Veja abaixo:
Onde:
xFilial_19 “_19” código do processo referente à rotina de recalculo do custo médio (MATA330)
xFilial_17 “_17” código do processo referente à rotina de virada de saldos (MATA280)
Observação:
A remoção de procedures de ponto de entrada do banco está condicionada ao parâmetro MV_DROPPE. Para
correta utilização deste parâmetro verifique a documentação no help on-line ou no portal TDN.
O sistema será atualizado logo após a aplicação do pacote de atualizações (Patch) desta FNC. Após o usuário
aplicar o patch ele deverá entrar no módulo configurador e criar manualmente o parâmetro MV_PROCSP no
dicionário de dados SX6. Para que o novo método seja utilizado será necessário ativar este parâmetro
manualmente.
Após aplicar o patch e ativar o parâmetro MV_PROCSP (como descrito acima) o módulo configurador passará
a funcionar no novo método de manutenção, ou seja, a instalação/atualização ou remoção de procedures
ocorrerá somente por processo. Não mais será possível utilizar o modelo antigo de configuração através de um
único arquivo SPS.
Se o parâmetro estiver ativado (conteúdo verdadeiro, .T.) o módulo configurador realizará a manutenção das
stored procedures no método novo, ou seja, por processos. Se o parâmetro estiver desativado (conteúdo falso,
.F.) ou não existir no dicionário SX6, o modelo antigo de manutenção continuará a ser utilizado e o
comportamento do sistema não será alterado.
Uma vez que o parâmetro MV_PROCSP estiver ativado será impossível realizar atualizações nas stored
procedures através de um único arquivo SPS. Assim que o novo método for ativado, o usuário deverá obter e
instalar todos os pacotes para os processos que deseja utilizar.
A listagem abaixo apresenta as FNC’s onde os pacotes dos processos podem ser obtidos:
Observação:
Conforme novas atualizações/correções forem executadas, novas FNC’s serão geradas e disponibilizadas no
portal do cliente contendo os respectivos pacotes atualizados.
No método novo de manutenção, o módulo configurador não fará mais a instalação/atualização ou remoção
das procedures antigas. Por esse motivo deve-se analisar a possibilidade de remoção destas procedures antes
de iniciar a utilização do novo método. Para isso deve-se utilizar o módulo configurador sem a aplicação do
patch desta FNC ou com o parâmetro MV_PROCSP desativado (conteúdo falso, .F.) ou inexistente no
dicionário de dados SX6.
Observações:
É recomendável a remoção de todas as stored procedures antigas da base de dados antes de iniciar a
utilização do novo método. Após a ativação do parâmetro MV_PROCSP as procedures antigas não serão mais
utilizadas pelo sistema, que passará a executar apenas as procedures novas instaladas para cada processo.
Por exemplo, caso o processo “19 – Recálculo do custo” seja instalado sem que as procedures antigas sejam
removidas, a procedure “MAT004” entrará em desuso, pois a rotina de recálculo do custo utilizará a procedure
“MAT004_19”. Por esse motivo a desinstalação das procedures antigas é altamente recomendada.
1. Analise se as procedures antigas da base de dados devem/podem ou não ser removidas para a empresa
que será atualizada conforme mencionado anteriormente neste boletim.
2. Obtenha os patchs mais atuais de cada uma das rotinas para as quais deseja instalar o processo.
4. Verifique se os pacotes (arquivos SPS) estão no diretório definido na chave “STARTPATH” do arquivo INI
do Protheus Server.
7. Selecione quais processos deseja instalar/atualizar na janela de configuração. Vários processos podem ser
instalados ao mesmo tempo.
Na janela de seleção o usuário visualizará todos os processos disponíveis bem como o nome do arquivo SPS
necessário para sua instalação/atualização.
Foi incluída à consulta uma nova coluna denominada “Código do processo”, indicando qual é o código do
processo para a respectiva rotina. Esta coluna apresentará os códigos de cada um dos processos disponíveis
para instalação/atualização ou remoção da base de dados. As demais informações continuam as mesmas, ou
seja, será apresentado o nome da rotina, as assinaturas tanto da rotina quanto do processo e seu status, que
pode apresentar os seguintes valores:
Para alterar o status dos processos ou das rotinas o usuário deve proceder conforme mencionado no item
“Instalando/atualizando novos processos”.
Observação:
Foi adicionado à barra de botões da janela de consulta um novo botão que apresenta a legenda para os status
das rotinas/processos.
Informações Técnicas
Rotinas Envolvidas SIGACFG – Módulo Configurador
Sistemas Operacionais Todos
Número do Plano 00000016409/2010