SIGACFG Manuteno de Stored Procedures 1

Manuteno de stored procedures

Produto :
Microsiga Protheus
Configurador Verso 11
Chamado : SCSVR9
Data da criao : 26/11/10 Data da reviso : 24/02/11
Pas (es) : Todos Banco(s) de Dados : Todos relacionais (TOP)
FNC : 00000017036/2010

Implementado novo mecanismo de manuteno de Stored Procedures para os mdulos de Materiais e
Controladoria.
Atualmente o processo de instalao das stored procedures feito atravs da utilizao de um nico arquivo
(SIGAM11.SPS) em que possvel apenas instalar ou remover todas as procedures de uma nica vez.
No novo mtodo, o pacote SIGAM11.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 usurio instalar somente os processos que deseja
utilizar.

A estrutura dos processos de Materiais e Controladoria est organizada da seguinte forma:
Nome do
pacote
Rotina Procedure Processo Descrio
P11_01.SPS CTBA190 CTB020 01 Reprocessamento contbil
P11_02.SPS CTBA190 CTB001 02
Reprocessamento contbil de
oramentos
P11_03.SPS CTBA220 CTB020 03 Consolidao geral de empresas
P11_04.SPS CTBXATU CTB150 04 Atualizao de saldos on-line
P11_06.SPS CTBXATU CTB185 06
Atualizao de saldos on-line por
lote
P11_07.SPS JOB192 CTB165 07 Reprocessamento por contas
P11_08.SPS MATXFUNB FIN001 08 Somatrio dos abatimentos
P11_09.SPS FINA410 FIN003 09 Refaz Clientes/Fornecedores
P11_10.SPS FINXFUN FIN002 10 Saldo do ttulo

2 SIGACFG Manuteno de Stored Procedures
P11_11.SPS ATFA050 ATF001 11 Clculo de depreciao de ativos
P11_12.SPS PCOXSLD PCO001 12
Atualiza os saldos dos cubos nas
datas posteriores ao movimento
P11_13.SPS PCOXSLD PCO003 13
Atualiza os saldos dos cubos por
chave
P11_14.SPS MATXFUNB MAT006 14
Clculo de estoque (funo
CALCEST)
P11_15.SPS MATA216 MAT041 15 Refaz poder de terceiros
P11_16.SPS MATA225 MAT043 16 Saldos em estoque
P11_17.SPS MATA280 MAT038 17 Virada de saldos
P11_18.SPS MATA300 MAT040 18 Saldo atual
P11_19.SPS MATA330 MAT004 19 Reclculo do custo mdio
P11_20.SPS MATA320 MAT005 20 Clculo do custo de reposio
P11_21.SPS MATA350 MAT026 21 Saldo atual para final

Cada processo possui seu prprio arquivo de pacote (SPS) com uma nomenclatura que define qual
rotina/processo o arquivo se refere. Os pacotes de stored procedures so obtidos juntamente com o pacote de
fontes AdvPL de cada um dos processos descritos na tabela acima.

Observaes:
Os nomes dos arquivos de pacote so pr-definidos e no podem ser modificados. Cada processo necessita
que seu respectivo arquivo esteja com a nomenclatura conforme definida na tabela acima, respeitando a
verso do sistema.

Importante
A atualizao de saldos on-line poder ser realizada pelo processo 06 Atualizao de saldos on-line por
lote ou pelo processo 04 Atualizao de saldos on-line linha a linha.
Existe um parmetro que define qual a forma de atualizao de saldos on-line, MV_CTBSALD. Seu
contedo pode ser: 1 (atualizao pelo processo 04) ou 2 (atualizao pelo processo 06 default).
Nomenclatura do novo pacote de stored procedures
A nomenclatura dos arquivos SPS est definida da seguinte forma:

Exemplo: arquivo P11_01.SPS
Onde:
SIGACFG Manuteno de Stored Procedures 3
P11 Verso Protheus 11
01 Cdigo do processo (01 Reprocessamento contbil)

Cada pacote poder ser utilizado somente na verso compatvel.
Nomenclatura das stored procedures
As stored procedures recebero uma nova nomenclatura no novo mtodo de manuteno. O cdigo do
processo ser adicionado ao nome da procedure seguido do cdigo da empresa.

A nomenclatura das procedures est definida da seguinte forma:

Exemplo: procedure MAT006_14_01
Onde:
MAT006 Nome que identifica a procedure
14 Cdigo do processo (14 Clculo do estoque)
01 Cdigo da empresa na qual a procedure foi instalada

Algumas procedures so executadas por mais de um processo. Para cada processo instalado no banco, um
conjunto novo de procedures tambm ser instalado. Desse modo pode-se identificar facilmente qual
processo a procedure pertence.

Exemplo 1: procedure xFILIAL_01_01
Onde:
xFILIAL Nome que identifica a procedure
01 Cdigo do processo (01 Reprocessamento contbil)
01 Cdigo da empresa na qual a procedure foi instalada

Exemplo 2: procedure xFILIAL_19_01
Onde:
xFILIAL Nome que identifica a procedure
19 Cdigo do processo (19 Reclculo do custo mdio)
01 Cdigo da empresa na qual a procedure foi instalada

Deste modo, ao remover um processo, somente as procedures pertencentes ao processo sero removidas do
banco de dados e os demais processos continuaro funcionando normalmente.

4 SIGACFG Manuteno de Stored Procedures
Mudana nas procedures TOOLS
Existem algumas procedures/functions denominadas TOOLS. Estas procedures/functions so instaladas de
acordo com o tipo de banco de dados usado.

Houve uma mudana no tamanho do nome de algumas destas procedures, conforme demonstrado abaixo:
Modelo antigo Modelo novo
Nome Tamanho Nome Tamanho
MSCHARINDEX 11 MSCHARIND 9

As demais procedures/functions no foram alteradas.

Observao:
Estas procedures/functions seguem a mesma regra de nomenclatura das demais procedures, ou seja,
recebero o cdigo do processo e da empresa na qual foram instaladas.
Stored procedures de ponto de entrada
As procedures de pontos de entrada so as nicas que no sero modificadas em sua nomenclatura.
Por serem especficas de cada processo, ou seja, somente um processo faz uso de uma procedure de ponto de
entrada, no h necessidade de alterao do nome. No existe duplicidade deste tipo de procedure no banco
de dados.
Com isso ser preservada toda programao realizada pelo usurio em cada uma destas procedures, j que
elas tambm no so removidas do banco ou substitudas no caso de uma atualizao de pacote.

Importante:
Clientes que utilizam as stored procedures referentes ao processo de Custo Em Partes, devero acertar a
chamada da stored procedure xFilial, contida na programao das stored procedures MA330CP,
M330INB2CP, M330INC2CP, M280INB9CP e MA280INC2CP, conforme quadro abaixo:
Modelo antigo Modelo novo
Procedure Chamada Procedure Chamada
MA330CP xFilial_## MA330CP xFilial_19_##
M330INB2CP xFilial_## M330INB2CP xFilial_19_##
M330INC2CP xFilial_## M330INC2CP xFilial_19_##
SIGACFG Manuteno de Stored Procedures 5
M280INB9CP xFilial_## M280INB9CP xFilial_17_##
MA280INC2CP xFilial_## MA280INC2CP xFilial_17_##

Onde:
xFilial_19 _19 cdigo do processo referente rotina de recalculo do custo (MATA330)
xFilial_17 _17 cdigo do processo referente rotina de virada de saldos (MATA280)

_## Cdigo da Empresa
Exemplo: xFilial_19_##
Considerando que o cliente utiliza a empresa 01, teremos:
xFilial_19_01
Observao:
A remoo de procedures de ponto de entrada do banco est condicionada ao parmetro MV_DROPPE. Para
correta utilizao deste parmetro, verifique a documentao no Help On-line ou no Portal TDN.
Procedimentos para implementao
O sistema ser atualizado logo aps a aplicao do pacote de atualizaes (Patch) desta FNC.
Aps a aplicao do patch, necessrio criar manualmente o parmetro MV_PROCSP no dicionrio de dados
SX6, para que o novo mtodo seja utilizado.

1. No Configurador (SIGACFG) acesse Ambientes/Cadastros/Parmetros (CFGX017). Crie e configure o
parmetro a seguir:
Nome da Varivel MV_PROCSP
Tipo Lgico
Descrio
Indica se a manuteno de stored procedures ser realizada por processo.
(.T. = Sim / .F. = No)
Valor Padro .T.

Aps aplicar o patch e ativar o parmetro MV_PROCSP, o mdulo configurador funcionar com o novo mtodo
de manuteno, ou seja, a instalao/atualizao ou remoo de procedures ocorrer somente por processo.
No mais ser possvel utilizar o modelo antigo de configurao atravs de um nico arquivo SPS.

Se o parmetro estiver ativado (contedo verdadeiro, .T.) o mdulo Configurador realizar a manuteno das
stored procedures no mtodo novo, ou seja, por processos. Se o parmetro estiver desativado (contedo falso,

6 SIGACFG Manuteno de Stored Procedures
.F.) ou no existir no dicionrio SX6, o modelo antigo de manuteno continuar a ser utilizado e o
comportamento do sistema no ser alterado.

Uma vez que o parmetro MV_PROCSP estiver ativado ser impossvel realizar atualizaes nas stored
procedures atravs de um nico arquivo SPS. Assim que o novo mtodo for ativado, o usurio dever obter e
instalar todos os pacotes para os processos que deseja utilizar.

A listagem abaixo apresenta as FNCs onde os pacotes dos processos podem ser obtidos:
Pacote Rotina Processo FNC
P11_01.SPS
CTBA190 Reprocessamento
contbil
01 00000016817/2010
P11_02.SPS
CTBA190 Reprocessamento
contbil de oramentos
02 00000016579/2010
P11_03.SPS
CTBA220 Consolidao geral de
empresas
03 00000017172/2010
P11_04.SPS
CTBXATU Atualizao de saldos
on-line
04 00000017016/2010
P11_06.SPS
CTBXATU Atualizao de saldos
on-line por Lote
06 00000017016/2010
P11_07.SPS
JOB192 Reprocessamento por
contas
07 00000017100/2010
P11_08.SPS
MATXFUNB Somatria dos
abatimentos
08 00000017036/2010
P11_09.SPS
FINA410 Refaz
Clientes/Fornecedores
09 00000017020/2010
P11_10.SPS FINXFUN Saldo do ttulo 10 00000017050/2010
P11_11.SPS
ATFA050 Clculo de depreciao
de ativos
11 00000017130/2010
P11_12.SPS
PCOXSLD Atualiza os saldos dos
cubos nas datas posteriores ao
movimento
12 00000016583/2010
P11_13.SPS
PCOXSLD Atualiza os saldos dos
cubos por chave
13 00000016706/2010
P11_14.SPS
MATXFUNB - Clculo de estoque
(funo CALCEST)
14 00000015971/2010
P11_15.SPS MATA216 Refaz poder de terceiros 15 00000016025/2010
P11_16.SPS MATA225 Saldos em estoque 16 00000016034/2010
P11_17.SPS MATA280 Virada de saldos 17 00000016039/2010
SIGACFG Manuteno de Stored Procedures 7
P11_18.SPS MATA300 Saldo atual 18 00000016045/2010
P11_19.SPS
MATA330 Reclculo do custo
mdio
19 00000016046/2010
P11_20.SPS
MATA320 Clculo do custo de
reposio
20 00000016053/2010
P11_21.SPS MATA350 Saldo atual para final 21 00000015775/2010

Observao:
Conforme novas atualizaes/correes forem executadas, novas FNCs sero geradas e disponibilizadas no
Portal do Cliente contendo os respectivos pacotes atualizados.
Remoo de stored procedures antigas
No mtodo novo de manuteno, o mdulo Configurador no far mais a instalao/atualizao ou remoo
das procedures antigas. Por esse motivo deve-se analisar a possibilidade de remoo destas procedures antes
de iniciar a utilizao do novo mtodo. Para isso deve-se utilizar o mdulo configurador sem a aplicao do
patch desta FNC ou com o parmetro MV_PROCSP desativado (contedo falso,.F.) ou inexistente no dicionrio
de dados SX6.

Observaes:
recomendvel a remoo de todas as stored procedures antigas da base de dados antes de iniciar a
utilizao do novo mtodo. Aps a ativao do parmetro MV_PROCSP as procedures antigas no sero mais
utilizadas pelo sistema, que passar a executar apenas as procedures novas instaladas para cada processo.
Por exemplo, caso o processo 19 Reclculo do custo seja instalado sem que as procedures antigas sejam
removidas, a procedure MAT004 entrar em desuso, pois a rotina de reclculo do custo utilizar a procedure
MAT004_19. Por esse motivo a desinstalao das procedures antigas altamente recomendada.
Procedimentos para configurao
Instalando/atualizando novos processos
Para instalar/atualizar um processo realize os seguintes passos:
1. Analise se as procedures antigas da base de dados devem/podem ou no 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.
3. Aplique os patchs para as rotinas desejadas.

8 SIGACFG Manuteno de Stored Procedures
4. Verifique se os pacotes (arquivos SPS) esto no diretrio definido na chave STARTPATH do arquivo INI
do Protheus Server.
5. Execute o mdulo configurador e ative o parmetro MV_PROCSP.
6. Aps ativar o parmetro, selecione a opo de instalao de procedures.
7. Selecione quais processos deseja instalar/atualizar na janela de configurao. Vrios processos podem ser
instalados ao mesmo tempo.
8. Selecione para quais empresas os processos sero instalados/atualizados.

Na janela de seleo o usurio visualizar todos os processos disponveis bem como o nome do arquivo SPS
necessrio para sua instalao/atualizao.

Consultando os processos j instalados na base (por empresa)

A partir da ativao do parmetro MV_PROCSP, a opo de consulta s stored procedures apresentar a
listagem de todos os processos instalados/disponveis no sistema. As procedures antigas no sero mais
analisadas e mesmo que estejam instaladas corretamente no banco, a consulta no exibir nenhuma
informao sobre elas, j que no sero mais utilizadas por nenhuma rotina do sistema.
Foi includa consulta, uma nova coluna denominada Cdigo do processo, indicando qual o cdigo do
processo para a respectiva rotina. Esta coluna apresentar os cdigos de cada um dos processos disponveis
para instalao/atualizao ou remoo da base de dados. As demais informaes 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:

- OK: o processo est instalado corretamente (sinalizado na cor verde).
- Processo no instalado: o processo no est instalado (sinalizado na cor vermelha).
- Rotina desatualizada: a rotina em AdvPL est desatualizada (sinalizado na cor amarela).
- Processo desatualizado: o processo est desatualizado (sinalizado na cor amarela).

Para alterar o status dos processos ou das rotinas, o usurio deve proceder conforme mencionado no item
Instalando/atualizando novos processos.

Observao:
Foi adicionado barra de botes da janela de consulta um novo boto que apresenta a legenda para os status
das rotinas/processos.
SIGACFG Manuteno de Stored Procedures 9
Procedimentos para utilizao
1. No mdulo Configurador acesse Base de dados / Dicionrio / Stored Procedure.
O sistema apresentar as opes disponveis: Instalao, Desinstalao ou Consulta.
1. Selecione a opo Instalao.
2. Selecione os processos que deseja instalar/atualizar e clique em OK.
3. Selecione as empresas para as quais os processos sero instalados/atualizados.
4. Aguarde o trmino do processo.
5. Repita o passo 1 e selecione agora a opo Consulta.
6. Ser exibida a janela de consulta contendo todos os processos disponveis para a empresa atual.
7. Verifique se os processos selecionados anteriormente no passo 3 foram instalados corretamente.
8. Repita o passo 1 e selecione a opo Desinstalao.
9. Selecione os processos que deseja desinstalar e confirme clicando em OK.
10. Aguarde o trmino do processo.
11. Novamente realize a consulta e verifique se todos os processos selecionados no passo 10 foram
desinstalados corretamente.

Informaes Tcnicas
Rotinas Envolvidas SIGACFG Mdulo Configurador
Sistemas Operacionais Todos
Nmero do Plano 00000016981/2010