Histórico da Página

...

1. FAT (Faturamento) - https://suporte.totvs.com/portal/p/10098/download?e=1080341
2. COM (Compras) - https://suporte.totvs.com/portal/p/10098/download?e=1080335
3. FIS (Fiscal) - https://suporte.totvs.com/portal/p/10098/download?e=1080345
4. FIN (Financeiro) - https://suporte.totvs.com/portal/p/10098/download?e=1080343
5. EST (Estoque) - https://suporte.totvs.com/portal/p/10098/download?e=1080339
6. CTB (Controladoria) - https://suporte.totvs.com/portal/p/10098/download?e=1080337

Passo 3: Acesse o programa Gerenciador de procedures, através do menu Base de Dados | Dicionário | Stored Procedure. Será apresentada a seguinte interface:
Image Removed

As opções disponíveis são:

• Documentação: ao clicar neste botão o usuário será levado para esta documentação.
• Manter: ao clicar neste botão a rotina atual, sem as novas funcionalidades, será exibida. É importante lembrar que o modelo antigo não sofrerá nenhuma atualização, isto é, não serão expedidas atualizações em arquivos SPS, somente no novo formato ZSPS.
• Atualizar: ao clicar neste botão, ocorrerá o processo de migração. Serão realizados procedimentos que não poderão ser desfeitos, ou seja, após migrado não será possível voltar ao modelo antigo de gestão de procedures. Após realizada a migração para o novo modelo essa interface de migração não será exibida novamente.
• Fechar: a rotina não será acionada, retornando ao menu da janela principal do Protheus.

Passo 4: Clique no botão Atualizar. O processo de migração se inicia e ao ser concluído a nova interface será apresentada.

...

A interface possui novos botões laterais que permitem o gerenciamento dos processos de maneira prática e rápida, realizando a instalação e remoção com poucos cliques. Consulta e relatório de log de processamento e configurações adicionais também estão disponíveis. Novas abas permitem uma navegação mais simples e eficiente para visualizar os processos e empresas. Os totalizadores fornecem, de forma rápida, um resumo dos status dos processos.

...

Entendendo as informações exibidas no título da interface:

Image Removed

Image Removed - Título da interface. A rotina Gestão de Procedures (programa CFGX051M.PRW) também é chamada de instalador de pacotes de procedures.

Image Removed - É a data e hora do programa CFGX051M.PRW compilado no RPO em uso. Este valor será atualizado sempre que uma nova versão do programa for aplicada no RPO através de patchs de atualização.

Image Removed - É a assinatura da rotina de Gestão de Procedures. Esta assinatura é utilizada para garantir que a versão do instalador seja compatível com os pacotes ZSPS utilizados para instalação de processos. Esta assinatura será atualizada (incrementada) conforme a evolução da rotina de instalação. Se o instalador não possuir a assinatura mínima exigida pelo pacote ZSPS, durante a instalação será armazenado no log de operações uma mensagem informando a existência de um problema de incompatibilidade entre o pacote ZSPS e o instalador. Nestes casos será necessário atualizar o instalador seguindo as orientações contidas no próprio log. Para mais detalhes sobre o log de operações, veja os itens Instalando/Atualizando pacotes de procedures e Consultando o histórico de operações.

Image Removed - É a release da Central de Atualizações atualmente encontrada no ambiente em uso. Essa informação não determina que a Central de Atualizações está configurada no ambiente, ela apenas mostra a versão dos programas de Gestão de Procedures que por sua vez estão diretamente ligados à Central de Atualizações. Para mais informações sobre a Central de Atualizações clique aqui.

Image Removed - A sigla TPH refere-se à Central de Atualizações. Pode apresentar dois valores: TPH: ON quando há conectividade, ou TPH: OFF quando não há conectividade com a Central de Atualizações. Neste caso a ausência pode ser temporária, ou seja, algum problema ocorreu durante a inicialização da interface, ou definitiva quando não há realmente nenhuma configuração no ambiente que possibilite o uso da Central de Atualizações.

...

As ações disponíveis nos botões da barra lateral são:

• Image Removed Instalar os pacotes selecionados nas empresas selecionadas.
• Image Removed Remover os pacotes selecionados das empresas selecionadas.
• Image Removed Marcar todas as empresas disponíveis no grid.
• Image Removed Desmarcar todas as empresas do grid.
• Image Removed Consultar o histórico de operações.
• Image Removed Configurações adicionais da rotina.
• Image Removed Link para a documentação oficial da rotina (esta página).

...

As ações disponíveis nos botões da barra lateral são:

...

Image Removed
A parte superior apresentará o nome da empresa posicionada, além dos totalizadores de cada um dos possíveis status.
Na parte inferior estarão relacionados todos os processos disponíveis e seus respectivos status na empresa posicionada.

...

Image Removed
A parte superior apresentará o nome do processo posicionado, além dos totalizadores de cada um dos possíveis status.
Na parte inferior estarão relacionadas todas as empresas disponíveis e seus respectivos status perante o processo posicionado.

LEGENDA

Image Removed Indica que o processo está atualizado.

Image Removed Indica que o processo está desatualizado.

Image Removed Indica que não foi possível avaliar o status do processo.

Image Removed Indica que o processo não está instalado.

Image Removed Indica que o processo e a rotina AdvPL possuem assinaturas incompatíveis.

O detalhamento dos status está no tópico Entendendo os status dos processos e ações que podem ser tomadas.

...

Versão 12.1.2310

1. FAT (Faturamento) - https://suporte.totvs.com/portal/p/10098/download?e=1123877
2. COM (Compras) - https://suporte.totvs.com/portal/p/10098/download?e=1123869
3. FIS (Fiscal) - https://suporte.totvs.com/portal/p/10098/download?e=1123881
4. FIN (Financeiro) - https://suporte.totvs.com/portal/p/10098/download?e=1123879
5. EST (Estoque) - https://suporte.totvs.com/portal/p/10098/download?e=1123875
6. CTB (Controladoria) - https://suporte.totvs.com/portal/p/10098/download?e=1123873
7. ATF (Ativo Fixo) - https://suporte.totvs.com/portal/p/10098/download?e=1123865
8. PCO (Planejamento e Controle Orçamentário) - https://suporte.totvs.com/portal/p/10098/download?e=1123883

Passo 3: Acesse o programa Gerenciador de procedures, através do menu Base de Dados | Dicionário | Stored Procedure. Será apresentada a seguinte interface:
Image Added

As opções disponíveis são:

• Documentação: ao clicar neste botão o usuário será levado para esta documentação.
• Manter: ao clicar neste botão a rotina atual, sem as novas funcionalidades, será exibida. É importante lembrar que o modelo antigo não sofrerá nenhuma atualização, isto é, não serão expedidas atualizações em arquivos SPS, somente no novo formato ZSPS.
• Atualizar: ao clicar neste botão, ocorrerá o processo de migração. Serão realizados procedimentos que não poderão ser desfeitos, ou seja, após migrado não será possível voltar ao modelo antigo de gestão de procedures. Após realizada a migração para o novo modelo essa interface de migração não será exibida novamente.
• Fechar: a rotina não será acionada, retornando ao menu da janela principal do Protheus.

Passo 4: Clique no botão Atualizar. O processo de migração se inicia e ao ser concluído a nova interface será apresentada.

Âncora
nova_interface nova_interface _heading h.1fob9te

Nova interface

A principal mudança na interface será a apresentação das empresas disponíveis no ambiente e todos os processos existentes para gerenciamento ao mesmo tempo, em uma mesma janela. Não haverá necessidade de mudança de empresa para a visualização dos seus processos.

A interface possui novos botões laterais que permitem o gerenciamento dos processos de maneira prática e rápida, realizando a instalação e remoção com poucos cliques. Consulta e relatório de log de processamento e configurações adicionais também estão disponíveis. Novas abas permitem uma navegação mais simples e eficiente para visualizar os processos e empresas. Os totalizadores fornecem, de forma rápida, um resumo dos status dos processos.

Image Added

Entendendo as informações exibidas no título da interface:

Image Added

Image Added - Título da interface. A rotina Gestão de Procedures (programa CFGX051M.PRW) também é chamada de instalador de pacotes de procedures.

Image Added - É a data e hora do programa CFGX051M.PRW compilado no RPO em uso. Este valor será atualizado sempre que uma nova versão do programa for aplicada no RPO através de patchs de atualização.

Image Added - É a assinatura da rotina de Gestão de Procedures. Esta assinatura é utilizada para garantir que a versão do instalador seja compatível com os pacotes ZSPS utilizados para instalação de processos. Esta assinatura será atualizada (incrementada) conforme a evolução da rotina de instalação. Se o instalador não possuir a assinatura mínima exigida pelo pacote ZSPS, durante a instalação será armazenado no log de operações uma mensagem informando a existência de um problema de incompatibilidade entre o pacote ZSPS e o instalador. Nestes casos será necessário atualizar o instalador seguindo as orientações contidas no próprio log. Para mais detalhes sobre o log de operações, veja os itens Instalando/Atualizando pacotes de procedures e Consultando o histórico de operações.

Image Added - É a release da Central de Atualizações atualmente encontrada no ambiente em uso. Essa informação não determina que a Central de Atualizações está configurada no ambiente, ela apenas mostra a versão dos programas de Gestão de Procedures que por sua vez estão diretamente ligados à Central de Atualizações. Para mais informações sobre a Central de Atualizações clique aqui.

Image Added - A sigla TPH refere-se à Central de Atualizações. Pode apresentar dois valores: TPH: ON quando há conectividade, ou TPH: OFF quando não há conectividade com a Central de Atualizações. Neste caso a ausência pode ser temporária, ou seja, algum problema ocorreu durante a inicialização da interface, ou definitiva quando não há realmente nenhuma configuração no ambiente que possibilite o uso da Central de Atualizações. 

Âncora
relacao_empresas relacao_empresas _heading h.3znysh7

Relação de empresas

Aqui serão listadas todas as empresas disponíveis no ambiente. Não há necessidade de entrar no ambiente utilizando a empresa para a qual se deseja instalar/desinstalar um processo.
Será possível marcar mais de uma empresa e realizar a ação desejada de uma só vez.

Image Added

As ações disponíveis nos botões da barra lateral são:

• Image Added Instalar os pacotes selecionados nas empresas selecionadas.
• Image Added Remover os pacotes selecionados das empresas selecionadas.
• Image Added Marcar todas as empresas disponíveis no grid.
• Image Added Desmarcar todas as empresas do grid.
• Image Added Consultar o histórico de operações.
• Image Added Configurações adicionais da rotina.
• Image Added Link para a documentação oficial da rotina (esta página).

Âncora
relacao_processos relacao_processos _heading h.2et92p0

Relação de processos

Serão listados todos os processos disponíveis para instalação.
Image Added

As ações disponíveis nos botões da barra lateral são:

• Image Added Marcar todos os processos disponíveis no grid.
• Image Added Desmarcar todos os processos do grid.
  
  

Âncora
guia_empresa_processos guia_empresa_processos _heading h.tyjcwt

Guia Empresa vs Processos

A visão disponibilizada nesta guia baseia-se na navegação realizada entre as empresas disponíveis na relação de empresas.

Image Added
A parte superior apresentará o nome da empresa posicionada, além dos totalizadores de cada um dos possíveis status.
Na parte inferior estarão relacionados todos os processos disponíveis e seus respectivos status na empresa posicionada.

Âncora
guia_processo_empresas guia_processo_empresas _heading h.3dy6vkm

Guia Processo vs Empresas

A visão disponibilizada nesta guia baseia-se na navegação realizada entre os processos disponíveis na relação de processos.

Image Added
A parte superior apresentará o nome do processo posicionado, além dos totalizadores de cada um dos possíveis status.
Na parte inferior estarão relacionadas todas as empresas disponíveis e seus respectivos status perante o processo posicionado.

LEGENDA

Image Added Indica que o processo está atualizado.

Image Added Indica que o processo está desatualizado.

Image Added Indica que não foi possível avaliar o status do processo.

Image Added Indica que o processo não está instalado.

Image Added Indica que o processo e a rotina AdvPL possuem assinaturas incompatíveis.

O detalhamento dos status está no tópico Entendendo os status dos processos e ações que podem ser tomadas.

Âncora
visualizando_detalhes visualizando_detalhes _heading h.23k0u7fdxslw

Visualizando detalhes

Ao efetuar um duplo clique no grid, onde estão relacionados os processos e empresas e seus respectivos status, será exibida uma interface contendo detalhes sobre o item selecionado.
Image Added

As seções apresentadas são:

Seção Detalhes:
Image Added
Apresenta informações detalhadas sobre o ambiente:

• Status da integração com a Central de Atualizações(sigla TPH):
  • ON (modo online) quando conectividade está ativa ou
  • OFF (modo offline) quando não há conectividade;
• Código da empresa;
• Nome da empresa;
• Código do processo;
• Nome do processo;
• Release da Central de Atualizações do ambiente;

Seção Processo:
Image Added
Apresenta informações detalhadas do processo:

• Status do processo: os possíveis status estão detalhados em Entendendo os status dos processos e ações que podem ser tomadas.
• Assinatura do processo instalado (em destaque para facilitar a visualização): exemplo na imagem 003
• No campo Instalado:
  • IDSPS (identificador único do pacote): exemplo na imagem (-17)
  • Data e hora do pacote ZSPS instalado: exemplo na imagem 21/01/2020 14:24:14 
  • Assinatura do pacote ZSPS instalado: exemplo na imagem [003]
• No campo RPO:
  • IDSPS (identificador único do pacote): exemplo na imagem (998)
  • Data e hora do pacote ZSPS contido no RPO : exemplo na imagem: 20/03/2023 08:09:32
  • Assinatura do pacote ZSPS contido no RPO: exemplo na imagem: [003]
• No campo TPH:
  • IDSPS (identificador único do pacote): exemplo na imagem (1171)
  • Data e hora do pacote ZSPS disponível na Central de Atualizações : exemplo na imagem: 03/05/2023 18:20:42
  • Assinatura do pacote ZSPS disponível na Central de Atualizações: exemplo na imagem: [004]

Seção Rotina:
Image Added

Apresenta informações detalhadas do rotina AdvPL associada ao processo:

• Status da rotina compilada no RPO:
  • Atualizado: a rotina está na sua versão mais recente disponibilizada pela TOTVS.
  • Desatualizado: significa que a rotina AdvPL compilada no RPO não é a mais recente disponibilizada pela TOTVS. Existe(m) patch(s) de atualização (.PTM) com uma versão mais recente disponível.

           Obs.: A comparação é realizada com a Central de Atualizações. Em ambientes offline essa comparação não é possível, ou seja, o status da rotina será sempre Não avaliado.

• Assinatura da rotina AdvPL: é utilizada para garantir a compatibilidade entre a rotina AdvPL e o processo (Stored Procedure);
• Nome da rotina/programa fonte;
• Data e hora da rotina contida no RPO;
• Data e hora da rotina disponível na Central de Atualizações (exibido somente se o ambiente estiver online);
• Botão Buscar atualização: direciona para o portal de atualização, para obtenção do patch contendo a rotina em questão. Botão disponível apenas se houver integração com a Central de Atualizações (modo online).

Seção Gestão de Procedures:
Image Added
Apresenta informações detalhadas da interface de Gestão de Procedures (CFGX051M):

• Status da rotina compilada no RPO:
  • Atualizado: a rotina está na sua versão mais recente disponibilizada pela TOTVS.
  • Desatualizado: significa que a rotina AdvPL compilada no RPO não é a mais recente disponibilizada pela TOTVS. Existe(m) patch(s) de atualização (.PTM) com uma versão mais recente disponível.

           Obs.: A comparação é realizada com a Central de Atualizações. Em ambientes offline essa comparação não é possível, ou seja, o status da rotina será sempre Não avaliado.

• Assinatura da rotina AdvPL de gestão de procedures: é usada para garantir a compatibilidade entre a rotina de gestão de procedures (instalador) e os pacotes de procedures

As seções apresentadas são:

Seção Detalhes:
Image Removed
Apresenta informações detalhadas sobre o ambiente:

...

• ON (modo online) quando conectividade está ativa ou
• OFF (modo offline) quando não há conectividade;

...

• Status do processo;
• Assinatura do processo instalado (em destaque para facilitar a visualização);
• No campo Instalado: apresentará o IDSPS (identificador único do pacote), Data e hora do pacote ZSPS usado na instalação e sua assinatura;
• No campo RPO: apresentará o IDSPS (identificador único do pacote), data e hora do pacote ZSPS contido no RPO e sua assinatura;
• No campo TPH: apresentará o IDSPS (identificador único do pacote), data e hora do pacote ZSPS disponível na Central de Atualizações e sua assinatura.

Seção Rotina:
Image Removed

Apresenta informações detalhadas do rotina AdvPL associada ao processo:

• Status;
• Assinatura da rotina AdvPL;
• Nome da rotina/programa fonte;
• Data e hora da rotina contida no RPO;
• Data e hora da rotina disponível na Central de Atualizações;
• Botão Buscar atualização: direciona para o portal de atualização, para obtenção do patch contendo a rotina em questão. Botão disponível apenas se houver integração com a Central de Atualizações (modo online).

...

• Status;
• Assinatura da rotina AdvPL de gestão de procedures;
• Nome da rotina/programa fonte;
• Data e hora da rotina contida no RPO;
• Data e hora da rotina disponível na Central de Atualizações;
• Botão Buscar atualização: direciona para o portal de atualização, para obtenção do patch contendo a rotina em questão. Botão disponível apenas se houver integração com a Central de Atualizações (modo online).

...

INCOMPATÍVEL: Nesta situação as assinaturas do processo e da rotina AdvPL (consulte tópico Visualizando detalhes) são incompatíveis. Isso significa que a rotina AdvPL que faz a chamada para as procedures não poderá utilizá-las. Ao tentar executar uma rotina que esteja incompatível com seu processo de stored procedures, o usuário receberá a seguinte mensagem de erro:

Exemplo de mensagem de incompatibilidade entre a rotina AdvPL e o processo:

Image Removed

...

as assinaturas do processo e da rotina AdvPL (consulte tópico Visualizando detalhes) são incompatíveis. Isso significa que a rotina AdvPL que faz a chamada para as procedures não poderá utilizá-las. Ao tentar executar uma rotina que esteja incompatível com seu processo de stored procedures, o usuário receberá a seguinte mensagem:

Exemplo de mensagem de incompatibilidade entre a rotina AdvPL e o processo:

Image Added

No exemplo acima vemos que a rotina FINA410 tentou executar a stored procedure FIN003_09 e recebeu um erro. Isso ocorre porque a assinatura da rotina (013) não é a mesma assinatura da stored procedure (011). A rotina não poderá ser executada utilizando as stored procedures até que as assinaturas sejam compatibilizadas.

Podemos verificar estas informações ao visualizarmos os detalhes do processo (no caso é o processo 09).

...