Manuteno de stored procedures

Produto
Data da criao

Microsiga Protheus Configurador

Verso 10

Chamado

15/07/10

Data da reviso

Pas(es)

: Todos

FNC

: 00000016463/2010

: SCSMCM
08/10/10

Banco(s) de Dados : Todos relacionais (TOP)

Foi desenvolvido um novo mecanismo para manuteno das stored procedures dos mdulos de materiais e
controladoria.

Atualmente o processo de instalao das stored procedures feito atravs da utilizao de um nico arquivo
(SIGAP10.SPS) em que possvel apenas instalar ou remover todas as procedures de uma nica vez.
No novo mtodo 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 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

P10_01.SPS

CTBA190

CTB020

01

Reprocessamento contbil

P10_02.SPS

CTBA190

CTB001

02

Reprocessamento contbil de
oramentos

P10_03.SPS

CTBA220

CTB020

03

Consolidao geral de empresas

P10_04.SPS

CTBXFUN

CTB150

04

Atualizao de saldos on-line

P11_06.SPS

CTBXATU

CTB185

06

Atualizao de saldos on-line por

lote (funo disponvel apenas na
verso Protheus 11)

P10_07.SPS

JOB192

CTB165

07

Reprocessamento por contas

Descrio

SIGACFG Manuteno de Stored Procedures 1

P10_08.SPS

MATXFUNB

FIN001

08

Somatria dos abatimentos

P10_09.SPS

FINA410

FIN003

09

Refaz Clientes/Fornecedores

P10_10.SPS

FINXFUN

FIN002

10

Saldo do ttulo

P10_11.SPS

ATFA050

ATF001

11

Clculo de depreciao de ativos

P10_12.SPS

PCOXSLD

PCO001

12

Atualiza os saldos dos cubos nas

datas posteriores ao movimento

P10_13.SPS

PCOXSLD

PCO003

13

Atualiza os saldos dos cubos por

chave

P10_14.SPS

MATXFUNB

MAT006

14

Clculo de estoque (funo

CALCEST)

P10_15.SPS

MATA216

MAT041

15

Refaz poder de terceiros

P10_16.SPS

MATA225

MAT043

16

Saldos em estoque

P10_17.SPS

MATA280

MAT038

17

Virada de saldos

P10_18.SPS

MATA300

MAT040

18

Saldo atual

P10_19.SPS

MATA330

MAT004

19

Reclculo do custo mdio

P10_20.SPS

MATA320

MAT005

20

Clculo do custo de reposio

P10_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
O processo 06 Atualizao de saldos on-line por lote estar disponvel apenas na verso Protheus 11.

2 SIGACFG Manuteno de Stored Procedures

Nomenclatura do novo pacote de stored procedures

A nomenclatura dos arquivos SPS est definida da seguinte forma:

Exemplo 1: arquivo P10_01. SPS

Onde:

P10 Verso Protheus 10

01 Cdigo do processo (01 Reprocessamento contbil)

Exemplo 2: arquivo P11_01.SPS

Onde:

P11 Verso Protheus 11

01 Cdigo do processo (01 Reprocessamento contbil)

Cada pacote poder ser utilizado somente na sua 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

SIGACFG Manuteno de Stored Procedures 3

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.

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

MSCALCPERIODO

13

MSCALCPER

MSCHARINDEX

11

MSCHARIND

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.

4 SIGACFG Manuteno de Stored Procedures

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. Veja abaixo:
Modelo antigo

Modelo novo

Procedure

Chamada

Procedure

Chamada

MA330CP

xFilial_##

MA330CP

xFilial_19_##

M330INB2CP

xFilial_##

M330INB2CP

xFilial_19_##

M330INC2CP

xFilial_##

M330INC2CP

xFilial_19_##

M280INB9CP

xFilial_##

M280INB9CP

xFilial_17_##

MA280INC2CP

xFilial_##

MA280INC2CP

xFilial_17_##

Onde:
xFilial_19
_19 cdigo do processo referente rotina de recalculo do custo mdio (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.

SIGACFG Manuteno de Stored Procedures 5

Procedimentos para implementao

O sistema ser atualizado logo aps a aplicao do pacote de atualizaes (Patch) desta FNC. Aps o usurio
aplicar o patch ele dever entrar no mdulo configurador e criar manualmente o parmetro MV_PROCSP no
dicionrio de dados SX6. Para que o novo mtodo seja utilizado ser necessrio ativar este parmetro
manualmente.

Este parmetro deve seguir a seguinte configurao:

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 (como descrito acima) o mdulo configurador passar
a funcionar no 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,
.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

P10_01.SPS

CTBA190 Reprocessamento
contbil

01

00000016463/2010

P10_02.SPS

CTBA190 Reprocessamento
contbil de oramentos

02

00000016461/2010

P10_03.SPS

CTBA220 Consolidao geral de

empresas

03

00000016465/2010

6 SIGACFG Manuteno de Stored Procedures

FNC

P10_04.SPS

CTBXFUN Atualizao de saldos

on-line

04

00000016466/2010

P10_07.SPS

JOB192 Reprocessamento por

contas

07

00000016467/2010

P10_08.SPS

MATXFUNB Somatria dos

abatimentos

08

00000016469/2010

P10_09.SPS

FINA410 Refaz
Clientes/Fornecedores

09

00000016472/2010

P10_10.SPS

FINXFUN Saldo do ttulo

10

00000016474/2010

P10_11.SPS

ATFA050 Clculo de depreciao

de ativos

11

00000016476/2010

P10_12.SPS

PCOXSLD Atualiza os saldos dos

cubos nas datas posteriores ao
movimento

12

00000016477/2010

P10_13.SPS

PCOXSLD Atualiza os saldos dos

cubos por chave

13

00000016537/2010

P10_14.SPS

MATXFUNB - Clculo de estoque

(funo CALCEST)

14

00000015518/2010

P10_15.SPS

MATA216 Refaz poder de

terceiros

15

00000015520/2010

P10_16.SPS

MATA225 Saldos em estoque

16

00000015521/2010

P10_17.SPS

MATA280 Virada de saldos

17

00000015525/2010

P10_18.SPS

MATA300 Saldo atual

18

00000015757/2010

P10_19.SPS

MATA330 Reclculo do custo

mdio

19

00000015758/2010

P10_20.SPS

MATA320 Clculo do custo de

reposio

20

00000015763/2010

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

SIGACFG Manuteno de Stored Procedures 7

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.
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 como mencionado anteriormente.
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.

8 SIGACFG Manuteno de Stored Procedures

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 (conforme mencionado
anteriormente).

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.

Procedimentos para utilizao

1. No mdulo Configurador acesse Base de dados / Dicionrio / Stored Procedure.
O sistema apresentar as opes disponveis: Instalao, Desinstalao ou Consulta.
2. Selecione a opo Instalao.
3. Selecione os processos que deseja instalar/atualizar e clique em OK.
4. Selecione as empresas para as quais os processos sero instalados/atualizados.
5. Aguarde o trmino do processo.
6. Repita o passo 1 e selecione agora a opo Consulta.
7. Ser exibida a janela de consulta contendo todos os processos disponveis para a empresa atual.
SIGACFG Manuteno de Stored Procedures 9

8. Verifique se os processos selecionados anteriormente no passo 3 foram instalados corretamente.

9. Repita o passo 1 e selecione a opo Desinstalao.
10. Selecione os processos que deseja desinstalar e confirme clicando em OK.
11. Aguarde o trmino do processo.
12. 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

00000016409/2010

10 SIGACFG Manuteno de Stored Procedures