Manuteno de stored procedures

Produto Data da criao Pas(es) FNC : Microsiga Protheus Configurador Verso 10 15/07/10 : Todos : 000000157752010 Chamado Data da reviso : SCSBBI 15/09/10

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

Desenvolveu-se 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 P10_01.SPS P10_02.SPS P10_03.SPS P10_04.SPS P10_05.SPS P11_06.SPS Rotina CTBA190 CTBA190 CTBA220 CTBXFUN CTBXFUN CTBXATU Procedure CTB020 CTB001 CTB020 CTB150 CTB153 CTB185 Processo 01 02 03 04 05 06 Descrio Reprocessamento contbil Reprocessamento contbil de oramentos Consolidao geral de empresas Atualizao de saldos on-line Descontinuado Atualizao de saldos on-line por lote (funo disponvel apenas na verso Protheus 11)

SIGACFG Manuteno de Stored Procedures 1

P10_07.SPS P10_08.SPS P10_09.SPS P10_10.SPS P10_11.SPS P10_12.SPS P10_13.SPS P10_14.SPS P10_15.SPS P10_16.SPS P10_17.SPS P10_18.SPS P10_19.SPS P10_20.SPS P10_21.SPS

JOB192 MATXFUNB FINA410 FINXFUN ATFA050 PCOXSLD PCOXSLD MATXFUNB MATA216 MATA225 MATA280 MATA300 MATA330 MATA320 MATA350

CTB165 FIN001 FIN003 FIN002 ATF001 PCO001 PCO003 MAT006 MAT041 MAT043 MAT038 MAT040 MAT004 MAT005 MAT026

07 08 09 10 11 12 13 14 15 16 17 18 19 20 21

Reprocessamento por contas Somatria dos abatimentos Refaz Clientes/Fornecedores Saldo do ttulo 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 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 Nome MSCALCPERIODO MSCHARINDEX Tamanho 13 11 Nome MSCALCPER MSCHARIND Modelo novo Tamanho 9 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.

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 Procedure MA330CP M330INB2CP M330INC2CP M280INB9CP MA280INC2CP Chamada xFilial_## xFilial_## xFilial_## xFilial_## xFilial_## Procedure MA330CP M330INB2CP M330INC2CP M280INB9CP MA280INC2CP Modelo novo Chamada xFilial_19_## xFilial_19_## xFilial_19_## xFilial_17_## xFilial_17_##

Onde: xFilial_19 xFilial_17 _## _19 cdigo do processo referente rotina de recalculo do custo mdio (MATA330) _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 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 (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 (Modelo Antigo). 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 P10_01.SPS P10_02.SPS P10_03.SPS Rotina CTBA190 Reprocessamento contbil CTBA190 Reprocessamento contbil de oramentos CTBA220 Consolidao geral de empresas Processo 01 02 03 FNC 00000016463/2010 00000016461/2010 00000016465/2010

6 SIGACFG Manuteno de Stored Procedures

P10_04.SPS P10_07.SPS P10_08.SPS P10_09.SPS P10_10.SPS P10_11.SPS

CTBXFUN Atualizao de saldos on-line 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 MATA300 Saldo atual MATA330 Reclculo do custo mdio MATA320 Clculo do custo de reposio MATA350 Saldo atual para final

04 07 08 09 10 11

00000016466/2010 00000016467/2010 00000016469/2010 00000016472/2010 00000016474/2010 00000016476/2010

P10_12.SPS

12

00000016477/2010

P10_13.SPS P10_14.SPS P10_15.SPS P10_16.SPS P10_17.SPS P10_18.SPS P10_19.SPS P10_20.SPS P10_21.SPS

13 14 15 16 17 18 19 20 21

00000016537/2010 00000015518/2010 00000015520/2010 00000015521/2010 00000015525/2010 00000015757/2010 00000015758/2010 00000015763/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.

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 realizar o processo de desinstalao 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: necessria 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.

Procedimentos para configurao

Instalando/atualizando novos processos Para instalar/atualizar um processo realize os seguintes passos: 1. Desinstalar as procedures antigas da base de dados para a empresa que ser atualizada conforme mencionado anteriormente neste boletim. 2. Obtenha os patchs mais recentes 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.

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

10 SIGACFG Manuteno de Stored Procedures