Page tree

Antes da utilização dos módulos SIGAVDF e SIGAGFP são necessárias algumas configurações para que esses módulos funcionem corretamente.

Guia passo a passo

  1. Faça a instalação padrão do Protheus 

  2. Baixe aqui e copie o repositório  para a pasta Repositório do ambiente e apague a pasta de repositório de formulas rpofrmt1.

  3. Baixe DICIONARIO DE DADOS RELEASE 12.1.17 - DIFERENCIAL descompacte esses arquivos na pasta Systemload.

  4.  Executar do UPDDISTR.

    Importante:

    O procedimento passo-a-passo de migração de Release do Protheus 12 com UPDDISTR encontra-se neste link:
    http://tdn.totvs.com/pages/viewpage.action?pageId=286020348



    Um dicionário de dados diferencial é um dicionário parcial que é utilizado para atualizar o dicionário de dados (metadado) do Protheus em uso.
    O dicionário de dados diferencial pode ser utilizado para diversos fins, a saber:

    • Atualizar o dicionário de dados do Protheus para uma versão atualizada dentro de um mesmo release.
    • Inserir o dicionário de um novo produto, módulo ou funcionalidade.
    • Efetuar atualizações pontuais devido a um novo requisito legal.


    Atenção

    O UPDDISTR não deve ser utilizado para efetuar a migração do Protheus 11 (ou versões anteriores) para o Protheus 12. Nessa situação, deve ser utilizada a ferramenta MP710TO120.


    Preparando o ambiente

    Para aplicar o dicionário de dados diferencial, utilizamos uma ferramenta especial chamada UPDDISTR. O UPDDISTR atualiza o dicionário de dados do Protheus usando as mesmas regras e funcionalidades do atualizador de versão do Protheus.
    De fato, o "core" (núcleo) do UPDDISTR e o do atualizador de versão são exatamente iguais, garantindo que não haja disparidade de regras entre as duas ferramentas. A maior diferença reside no fato do UPDDISTR poder utilizar um dicionário parcial, enquanto o atualizador de versão sempre exigir um dicionário completo.


    Informação:

    Antes de executar o UPDDISTR você deve baixar tanto o arquivo de dicionário completo (SXSBRA.TXT, por exemplo) quanto o dicionário diferencial (SDFBRA.TXT, por exemplo), e descompactá-los na pasta Systemload. Embora a migração de release utilize apenas o arquivo diferencial, o arquivo completo também deve ser baixado para a pasta, pois futuramente, quando for criar uma nova empresa ou filial, por exemplo, o arquivo que será utilizado será o COMPLETO.

    Maiores informações para download dos arquivos no link abaixo:
    Atualizar o Dicionário de Dados do Protheus 12


    Além do dicionário de dados, as alterações na base de dados decorrentes do novo dicionário (como por exemplo tamanho de campos) também são efetuadas, da mesma maneira que no atualizador de versão padrão.


    Observação importante: a ferramenta UPDDISTR apenas atualiza o dicionário de dados (metadado), os helps de campo e a base de dados. As alterações no repositório do sistema (sejam elas substituição do repositório, aplicação de "patchs", "updates" e pacotes) e atualizações de menus devem continuar sendo efetuadas conforme instruído em cada processo específico. 
     
     

    Procedimento para Implementação


     O sistema é atualizado logo após a aplicação do pacote de atualizações (Patch) de Lib, contendo os fontes abaixo cuja data seja igual ou superior às datas informadas.

    • UPDDISTR.PRW – 01/07/2013
    • APUPD030.PRW – 16/10/2013
    • APUPDATE.PRW – 18/09/2013


     

    Procedimentos para Utilização


    Importante:

    O procedimento passo-a-passo de migração de Release do Protheus 12 com UPDDISTR encontra-se neste link:
    http://tdn.totvs.com/pages/viewpage.action?pageId=286020348



    Recomendamos fortemente que:

    • Qualquer processo que envolva atualização do dicionário e base de dados do sistema seja efetuado inicialmente em ambiente de homologação e que os processos mais importantes para a operação da empresa sejam validados.


    • Seja efetuada uma CÓPIA FRIA (todos os serviços parados) e CONSISTENTE (das pastas adequadas e banco de dados) da base de produção antes da aplicação dessa atualização.


    • Seja efetuada uma CÓPIA FRIA (todos os serviços parados) e CONSISTENTE das pastas de dicionário de dados ("startpath" - pasta "system" e similares) antes da aplicação da atualização.


    Estas recomendações tornam-se obrigatórias no caso de sistemas de missão crítica, quando a operação da empresa depende totalmente ou quase que totalmente do sistema Protheus. 
     
      
    Para utilizar este procedimento é preciso dispor de um dicionário diferencial.
    O dicionário diferencial é um arquivo texto que possui o seguinte formato:

    • SDFppp.txt, onde ppp é o código do país (localização).


    Dessa forma, um dicionário diferencial para o Brasil deve possuir o nome SDFBRA.TXT. Um dicionário diferencial para a Argentina deve possuir o nome SDFARG.TXT.
    Cada processo de atualização (atualização do Protheus, novo módulo, nova legislação) vai disponibilizar um arquivo com conteúdo diferente.
    Ao mesmo tempo, poderá ser disponibilizado um arquivo diferencial de helps de campo e alertas, com o seguinte formato:

    • HLPDFiii.TXT, onde iii é o código do idioma.


    Dessa forma, um help de campo para o idioma português deve possuir o nome HLPDFPOR.TXT. Diferentemente do arquivo de dicionário, no Help a diferenciação por país encontra-se no próprio arquivo (interna).
    O(s) arquivo(s) de atualização deve(m) ser posicionado(s) na pasta de carga "\systemload" (pasta criada a partir da pasta "root" (raiz) do Protheus).


    Atualizar Menu:

    Há a possibilidade de atualizar os menus padrões (são os menus que possuem o nome dos módulos do Protheus) através do UPDDISTR.

    Insira o arquivo (Exemplo: sigafin.xnu) do menu que deseja atualizar dentro do diretório systemload/updmenu, caso não exista o diretório deverá ser criado.

    Obs.: Esta funcionalidade está disponível apenas para ambientes com dicionário no banco de dados e versão da Lib maior ou igual 20/08/2018.

    Solicitamos que ao executar uma dada atualização pela primeira vez seja excluído (se existir) o arquivo MPUPDDISTRI.TSK do diretório APPSERVER da instalação do Protheus em uso.


    Este arquivo apenas é necessário caso o processo tenha sido interrompido antes de sua conclusão, e guarda quais tarefas foram concluídas e quais ainda estão pendentes.
    Para atualizar, efetuar a chamada do programa de atualização UPDDISTR, na tela inicial do Protheus, ou seja, digitar UPDDISTR como se fosse o nome de um módulo do Protheus (os demais dados da janela, como conexão e ambiente, são apenas exemplos).


     
     

    A partir do pacote de LIB disponibilizado em 07/04/2016 será possível escolher quais grupos de empresas serão considerados na atualização. Será exibida uma janela onde é possível marcar os grupos de empresas desejados. Por padrão, todos os grupos já vem selecionados. Se desejar utilizar todos os grupos, basta clicar no botão OK.

    Caso uma dada migração seja reiniciada, deve-se escolher exatamente os mesmos grupos de empresas para retomar o processo


     


    Algumas tabelas não possuem grupo de empresas em seu nome, logo essa configuração não terá efeito sobre elas. Os arquivos de help, por exemplo, são compartilhados por todos os grupos de empresas de dado STARTPATH. Dessa forma, o arquivo compartilhado será atualizado.


      
    Após a chamada, será exibido um assistente de atualização. A primeira janela faz uma breve explicação da funcionalidade.
    Deve-se avançar para a segunda janela.
    Na segunda janela deve-se informar:


    • O usuário e senha do administrador do Protheus.

    • Se é uma simulação.
    • Se o dicionário de índices é exclusivo por grupo de empresas (SIX) ou se é utilizado o dicionário SINDEX.





    Deve-se avançar para a terceira janela.
    Na terceira janela deve-se informar:
    O diretório de dados (X2_PATH) para cada grupo de empresas para as novas tabelas a serem inseridas pela atualização. No caso de bases de dados SQL (Top Connect) não é necessário informar o diretório.
    Deve-se avançar para a quarta janela.
    Na quarta janela são definidas informações quanto ao LOG de processamento.

    • Em Configuração de execução do Update, indicamos manter apenas as opções Log de Critical Error e Corrigir erros automaticamente habilitadas, lembrando que a opção de corrigir os erros automaticamente executará as alterações de base pelo próprio sistema
    •  NÃO marque a opção Manter o arquivo de log existente


    Ao confirmar, será exibida uma janela confirmando quais grupos de empresas serão processados e quais operações serão executadas.
    Em seguida será efetuada uma análise da base de dados existente. A análise verificará diversos fatores, como por exemplo a consistência da base de dados em relação ao dicionário existente. Se forem encontrados problemas, os mesmos deverão ser corrigidos antes que a atualização possa prosseguir.
    Deve-se notar que nesta fase é analisado apenas o conteúdo da base de dados e do dicionário já existente. Nesse momento não é efetuada nenhuma consulta ao dicionário de dados diferencial que se pretende aplicar.
    Caso não existam erros ou os mesmos já tenham sido corrigidos a atualização iniciará logo após o processo de verificação.
    Deve-se aguardar o final da atualização e encerrar. 
     
     

    Importante:

    O procedimento passo-a-passo de migração de Release do Protheus 12 com UPDDISTR encontra-se neste link:
    http://tdn.totvs.com/pages/viewpage.action?pageId=286020348

    Informações Técnicas


    Sistemas Operacionais

    Windows/Linux

    Status do documentoConcluído
    Data13/01/2015
    Versão1.0
    Versão anterior1.0
    Autores




     


  5. Baixe os arquivos TTTP120.PTM.e TTTP120_flavour.PTM aplique no ambiente.

    Unable to render {include} The included page could not be found.

  6. Baixe a pasta Dicionários e Helps  do SIGAGFP e copie para a pasta systemload. Após isso execute o UPDISTR.

    Importante:

    O procedimento passo-a-passo de migração de Release do Protheus 12 com UPDDISTR encontra-se neste link:
    http://tdn.totvs.com/pages/viewpage.action?pageId=286020348



    Um dicionário de dados diferencial é um dicionário parcial que é utilizado para atualizar o dicionário de dados (metadado) do Protheus em uso.
    O dicionário de dados diferencial pode ser utilizado para diversos fins, a saber:

    • Atualizar o dicionário de dados do Protheus para uma versão atualizada dentro de um mesmo release.
    • Inserir o dicionário de um novo produto, módulo ou funcionalidade.
    • Efetuar atualizações pontuais devido a um novo requisito legal.


    Atenção

    O UPDDISTR não deve ser utilizado para efetuar a migração do Protheus 11 (ou versões anteriores) para o Protheus 12. Nessa situação, deve ser utilizada a ferramenta MP710TO120.


    Preparando o ambiente

    Para aplicar o dicionário de dados diferencial, utilizamos uma ferramenta especial chamada UPDDISTR. O UPDDISTR atualiza o dicionário de dados do Protheus usando as mesmas regras e funcionalidades do atualizador de versão do Protheus.
    De fato, o "core" (núcleo) do UPDDISTR e o do atualizador de versão são exatamente iguais, garantindo que não haja disparidade de regras entre as duas ferramentas. A maior diferença reside no fato do UPDDISTR poder utilizar um dicionário parcial, enquanto o atualizador de versão sempre exigir um dicionário completo.


    Informação:

    Antes de executar o UPDDISTR você deve baixar tanto o arquivo de dicionário completo (SXSBRA.TXT, por exemplo) quanto o dicionário diferencial (SDFBRA.TXT, por exemplo), e descompactá-los na pasta Systemload. Embora a migração de release utilize apenas o arquivo diferencial, o arquivo completo também deve ser baixado para a pasta, pois futuramente, quando for criar uma nova empresa ou filial, por exemplo, o arquivo que será utilizado será o COMPLETO.

    Maiores informações para download dos arquivos no link abaixo:
    Atualizar o Dicionário de Dados do Protheus 12


    Além do dicionário de dados, as alterações na base de dados decorrentes do novo dicionário (como por exemplo tamanho de campos) também são efetuadas, da mesma maneira que no atualizador de versão padrão.


    Observação importante: a ferramenta UPDDISTR apenas atualiza o dicionário de dados (metadado), os helps de campo e a base de dados. As alterações no repositório do sistema (sejam elas substituição do repositório, aplicação de "patchs", "updates" e pacotes) e atualizações de menus devem continuar sendo efetuadas conforme instruído em cada processo específico. 
     
     

    Procedimento para Implementação


     O sistema é atualizado logo após a aplicação do pacote de atualizações (Patch) de Lib, contendo os fontes abaixo cuja data seja igual ou superior às datas informadas.

    • UPDDISTR.PRW – 01/07/2013
    • APUPD030.PRW – 16/10/2013
    • APUPDATE.PRW – 18/09/2013


     

    Procedimentos para Utilização


    Importante:

    O procedimento passo-a-passo de migração de Release do Protheus 12 com UPDDISTR encontra-se neste link:
    http://tdn.totvs.com/pages/viewpage.action?pageId=286020348



    Recomendamos fortemente que:

    • Qualquer processo que envolva atualização do dicionário e base de dados do sistema seja efetuado inicialmente em ambiente de homologação e que os processos mais importantes para a operação da empresa sejam validados.


    • Seja efetuada uma CÓPIA FRIA (todos os serviços parados) e CONSISTENTE (das pastas adequadas e banco de dados) da base de produção antes da aplicação dessa atualização.


    • Seja efetuada uma CÓPIA FRIA (todos os serviços parados) e CONSISTENTE das pastas de dicionário de dados ("startpath" - pasta "system" e similares) antes da aplicação da atualização.


    Estas recomendações tornam-se obrigatórias no caso de sistemas de missão crítica, quando a operação da empresa depende totalmente ou quase que totalmente do sistema Protheus. 
     
      
    Para utilizar este procedimento é preciso dispor de um dicionário diferencial.
    O dicionário diferencial é um arquivo texto que possui o seguinte formato:

    • SDFppp.txt, onde ppp é o código do país (localização).


    Dessa forma, um dicionário diferencial para o Brasil deve possuir o nome SDFBRA.TXT. Um dicionário diferencial para a Argentina deve possuir o nome SDFARG.TXT.
    Cada processo de atualização (atualização do Protheus, novo módulo, nova legislação) vai disponibilizar um arquivo com conteúdo diferente.
    Ao mesmo tempo, poderá ser disponibilizado um arquivo diferencial de helps de campo e alertas, com o seguinte formato:

    • HLPDFiii.TXT, onde iii é o código do idioma.


    Dessa forma, um help de campo para o idioma português deve possuir o nome HLPDFPOR.TXT. Diferentemente do arquivo de dicionário, no Help a diferenciação por país encontra-se no próprio arquivo (interna).
    O(s) arquivo(s) de atualização deve(m) ser posicionado(s) na pasta de carga "\systemload" (pasta criada a partir da pasta "root" (raiz) do Protheus).


    Atualizar Menu:

    Há a possibilidade de atualizar os menus padrões (são os menus que possuem o nome dos módulos do Protheus) através do UPDDISTR.

    Insira o arquivo (Exemplo: sigafin.xnu) do menu que deseja atualizar dentro do diretório systemload/updmenu, caso não exista o diretório deverá ser criado.

    Obs.: Esta funcionalidade está disponível apenas para ambientes com dicionário no banco de dados e versão da Lib maior ou igual 20/08/2018.

    Solicitamos que ao executar uma dada atualização pela primeira vez seja excluído (se existir) o arquivo MPUPDDISTRI.TSK do diretório APPSERVER da instalação do Protheus em uso.


    Este arquivo apenas é necessário caso o processo tenha sido interrompido antes de sua conclusão, e guarda quais tarefas foram concluídas e quais ainda estão pendentes.
    Para atualizar, efetuar a chamada do programa de atualização UPDDISTR, na tela inicial do Protheus, ou seja, digitar UPDDISTR como se fosse o nome de um módulo do Protheus (os demais dados da janela, como conexão e ambiente, são apenas exemplos).


     
     

    A partir do pacote de LIB disponibilizado em 07/04/2016 será possível escolher quais grupos de empresas serão considerados na atualização. Será exibida uma janela onde é possível marcar os grupos de empresas desejados. Por padrão, todos os grupos já vem selecionados. Se desejar utilizar todos os grupos, basta clicar no botão OK.

    Caso uma dada migração seja reiniciada, deve-se escolher exatamente os mesmos grupos de empresas para retomar o processo


     


    Algumas tabelas não possuem grupo de empresas em seu nome, logo essa configuração não terá efeito sobre elas. Os arquivos de help, por exemplo, são compartilhados por todos os grupos de empresas de dado STARTPATH. Dessa forma, o arquivo compartilhado será atualizado.


      
    Após a chamada, será exibido um assistente de atualização. A primeira janela faz uma breve explicação da funcionalidade.
    Deve-se avançar para a segunda janela.
    Na segunda janela deve-se informar:


    • O usuário e senha do administrador do Protheus.

    • Se é uma simulação.
    • Se o dicionário de índices é exclusivo por grupo de empresas (SIX) ou se é utilizado o dicionário SINDEX.





    Deve-se avançar para a terceira janela.
    Na terceira janela deve-se informar:
    O diretório de dados (X2_PATH) para cada grupo de empresas para as novas tabelas a serem inseridas pela atualização. No caso de bases de dados SQL (Top Connect) não é necessário informar o diretório.
    Deve-se avançar para a quarta janela.
    Na quarta janela são definidas informações quanto ao LOG de processamento.

    • Em Configuração de execução do Update, indicamos manter apenas as opções Log de Critical Error e Corrigir erros automaticamente habilitadas, lembrando que a opção de corrigir os erros automaticamente executará as alterações de base pelo próprio sistema
    •  NÃO marque a opção Manter o arquivo de log existente


    Ao confirmar, será exibida uma janela confirmando quais grupos de empresas serão processados e quais operações serão executadas.
    Em seguida será efetuada uma análise da base de dados existente. A análise verificará diversos fatores, como por exemplo a consistência da base de dados em relação ao dicionário existente. Se forem encontrados problemas, os mesmos deverão ser corrigidos antes que a atualização possa prosseguir.
    Deve-se notar que nesta fase é analisado apenas o conteúdo da base de dados e do dicionário já existente. Nesse momento não é efetuada nenhuma consulta ao dicionário de dados diferencial que se pretende aplicar.
    Caso não existam erros ou os mesmos já tenham sido corrigidos a atualização iniciará logo após o processo de verificação.
    Deve-se aguardar o final da atualização e encerrar. 
     
     

    Importante:

    O procedimento passo-a-passo de migração de Release do Protheus 12 com UPDDISTR encontra-se neste link:
    http://tdn.totvs.com/pages/viewpage.action?pageId=286020348

    Informações Técnicas


    Sistemas Operacionais

    Windows/Linux

    Status do documentoConcluído
    Data13/01/2015
    Versão1.0
    Versão anterior1.0
    Autores




     


  7. .Faça a aplicação do Flavour através do configurador SIGACFG.  

    Produto:

    Microsiga Protheus

    Versões:

    12

    Passo a passo:

    Premissa:
    Possuir o arquivo “.txt” do Flavour (Ex: flvbra.txt, flvrus.txt) na pasta SystemLoad do Ptrotheus.


    Processo:
    - Acessar o modulo SIGACFG no Protheus


    - Menu Ambiente > Flavour > Atualização de Flavour


    - Escolha qual o tipo de operação deseja realizar: 1-Incremental (Inclusão/Alteração), 2-Reset (Reaplicação)


    - Selecione a(s) empresa(s) que deseja aplicar a atualização e confirme.



    Fim do Processo:

    No final do processo de atualização será exibido um relatório das tabelas que foram atualizadas e quais tipos de operações foram realizadas.



    Guia passo a passo

    1. Acesse o módulo configurador SIGACFG.
    2. Acesse a rotina: Usuário > Senhas > Politica


    3. Acesse a pasta Outros e na sessão Flavour, selecione: Flavour Gestão Pública e Confirme.





    Para a atualização do Flavour de Help de Campo (hlpfvbra.txt), deve ser executado o mesmo procedimento.



  8. No Configurador altere o valor do Parâmetro MV_SIGAGFP (Utiliza o modulo SIGAGFP (Gestão de Folha Publica)) para 2 (Sim). Para a Gestão de Folha Mista configurar o parâmetro para 3

    O Parâmetro MV_SIGAGFP é responsável por habilitar a todas as funcionalidades que são especificas de Folha Pública.  

    Guia passo a passo

    1. Acesse o módulo SIGACFG.




    2. No menu acesse a opção: Cadastros > Parâmetros




    3. Clique na Lupa e pesquise por MV_SIGAGFP:





    4. Clique em Editar: 





    5. Altere o valor do campo Cont. Por para 3 (1 = Não / 2 = Folha Pública / 3 = Folha Mista)



    O parâmetro MV_SIGAGFP vem por padrão configurado como 1 = Não. É importante que esse parâmetro seja configurado corretamente para o funcionamento correto das rotinas dos Módulos SIGAGFP e SIGAVDF.



Binários

Os arquivos de binários devem estar atualizados. Link para download dos binarios atualizados: APPSERVER e SMARTCLIENT.