Manuteno de stored procedures

Produto Data da criao Pas (es) FNC : Microsiga Protheus Configurador Verso 11 Chamado Data da reviso : SCSQCZ : 23/02/11

: 26/11/10 : Todos : 00000016706/2010

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

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 P11_01.SPS P11_02.SPS P11_03.SPS P11_04.SPS P11_06.SPS P11_07.SPS P11_08.SPS P11_09.SPS P11_10.SPS Rotina CTBA190 CTBA190 CTBA220 CTBXATU CTBXATU JOB192 MATXFUNB FINA410 FINXFUN Procedure CTB020 CTB001 CTB020 CTB150 CTB185 CTB165 FIN001 FIN003 FIN002 Processo 01 02 03 04 06 07 08 09 10 Descrio Reprocessamento contbil Reprocessamento contbil de oramentos Consolidao geral de empresas Atualizao de saldos on-line Atualizao de saldos on-line por lote Reprocessamento por contas Somatria dos abatimentos Refaz Clientes/Fornecedores Saldo do ttulo

SIGACFG Manuteno de Stored Procedures 1

P11_11.SPS P11_12.SPS P11_13.SPS P11_14.SPS P11_15.SPS P11_16.SPS P11_17.SPS P11_18.SPS P11_19.SPS P11_20.SPS P11_21.SPS

ATFA050 PCOXSLD PCOXSLD MATXFUNB MATA216 MATA225 MATA280 MATA300 MATA330 MATA320 MATA350

ATF001 PCO001 PCO003 MAT006 MAT041 MAT043 MAT038 MAT040 MAT004 MAT005 MAT026

11 12 13 14 15 16 17 18 19 20 21

Clculo de depreciao de ativos Atualiza os saldos dos cubos nas datas posteriores ao movimento Atualiza os saldos dos cubos por chave Clculo de estoque (funo CALCEST) Refaz poder de terceiros Saldos em estoque Virada de saldos Saldo atual Reclculo do custo mdio Clculo do custo de reposio 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:

2 SIGACFG Manuteno de Stored Procedures

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.
SIGACFG Manuteno de Stored Procedures 3

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 Nome MSCHARINDEX Tamanho 11 Nome MSCHARIND Modelo novo Tamanho 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 Procedure MA330CP M330INB2CP M330INC2CP M280INB9CP Chamada xFilial_## xFilial_## xFilial_## xFilial_## Procedure MA330CP M330INB2CP M330INC2CP M280INB9CP Modelo novo Chamada xFilial_19_## xFilial_19_## xFilial_19_## xFilial_17_##

4 SIGACFG Manuteno de Stored Procedures

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 Tipo Descrio Valor Padro MV_PROCSP Lgico Indica se a manuteno de stored procedures ser realizada por processo. (.T. = Sim / .F. = No) .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,

SIGACFG Manuteno de Stored Procedures 5

.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
P11_01.SPS P11_02.SPS P11_03.SPS P11_04.SPS P11_06.SPS P11_07.SPS P11_08.SPS P11_09.SPS P11_10.SPS P11_11.SPS

Rotina
CTBA190 Reprocessamento contbil CTBA190 Reprocessamento contbil de oramentos CTBA220 Consolidao geral de empresas CTBXATU Atualizao de saldos on-line CTBXATU Atualizao de saldos on-line por Lote JOB192 Reprocessamento por contas MATXFUNB Somatria dos abatimentos FINA410 Refaz Clientes/Fornecedores FINXFUN Saldo do ttulo ATFA050 Clculo de depreciao de ativos PCOXSLD Atualiza os saldos dos cubos nas datas posteriores ao movimento PCOXSLD Atualiza os saldos dos cubos por chave MATXFUNB - Clculo de estoque (funo CALCEST) MATA216 Refaz poder de terceiros MATA225 Saldos em estoque MATA280 Virada de saldos

Processo
01 02 03 04 06 07 08 09 10 11

FNC
00000016817/2010 00000016579/2010 00000017172/2010 00000017016/2010 00000017016/2010 00000017100/2010 00000017036/2010 00000017020/2010 00000017050/2010 00000017130/2010

P11_12.SPS

12

00000016583/2010

P11_13.SPS P11_14.SPS P11_15.SPS P11_16.SPS P11_17.SPS

13 14 15 16 17

00000016706/2010 00000015971/2010 00000016025/2010 00000016034/2010 00000016039/2010

6 SIGACFG Manuteno de Stored Procedures

P11_18.SPS P11_19.SPS P11_20.SPS P11_21.SPS

MATA300 Saldo atual MATA330 Reclculo do custo mdio MATA320 Clculo do custo de reposio MATA350 Saldo atual para final

18 19 20 21

00000016045/2010 00000016046/2010 00000016053/2010 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.
SIGACFG Manuteno de Stored Procedures 7

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.

8 SIGACFG Manuteno de Stored Procedures

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. 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 Sistemas Operacionais Nmero do Plano SIGACFG Mdulo Configurador Todos 00000016651/2010

SIGACFG Manuteno de Stored Procedures 9