Histórico da Página

Sumário
Novo Gestor de Stored Procedures – CFGX051M
Migração para o novo modelo
Nova interface
Relação de empresas
Relação de processos
Guia Empresa vs Processos
Guia Processo vs Empresas
Visualizando detalhes
Entendendo os status dos processos e ações que podem ser tomadas
Instalando/Atualizando pacotes de procedures
Desinstalando pacotes de procedures
Consultando o histórico de operações
Relatório de Log
Resolução de problemas pontuais sem necessidade de contato com suporte TOTVS
Configurações adicionais da rotina

...

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;
• 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).

Âncora
entendendo_os_status entendendo_os_status _heading h.f41wful3yjzh

Entendendo os status dos processos e ações que podem ser realizadas

A nova interface exibe uma série de ícones para representar os status possíveis para os processos. Aqui estão relacionados os possíveis status e as ações que podem ser tomadas para cada situação.

Image Added ATUALIZADO: O processo instalado no ambiente está atualizado com a última versão disponível em comparação ao pacote que está no RPO (modo offline) ou em relação ao pacote disponível na Central de Atualizações (modo online).

Solução:

Nenhuma ação é necessária neste caso.

Image Added DESATUALIZADO: O processo instalado no ambiente não está na sua versão mais recente disponibilizada pela TOTVS. Isso significa apenas que o IDSPS do pacote instalado é inferior ao IDSPS do último pacote homologado. Um pacote que está desatualizado não representa um erro e sua atualização não é obrigatória ou urgente. Um pacote de procedures com este status pode perfeitamente ser executado por sua rotina AdvPL.

Ao encontrarmos processos com este status, devemos considerar:

Em ambientes online: A comparação é realizada com os pacotes disponíveis na Central de Atualizações. Vamos pegar como exemplo um processo desatualizado onde o IDSPS instalado é inferior ao IDSPS disponível na Central de Atualizações:

Exemplo de processo desatualizado:

Image Added

Visualizando os detalhes do processo:

Image Added

Note que o IDSPS do processo instalado (7) é inferior ao IDSPS do processo mais recente disponível na Central de Atualizações (691). Por este motivo o status do processo fica Desatualizado. Isto ocorre pois o processo recém homologado fica disponível para uso imediatamente à sua publicação e a ferramenta faz a leitura em tempo real, sem que nenhum patch seja aplicado no ambiente.

Em ambientes offline: A comparação é realizada com os pacotes embarcados no RPO. Vamos pegar como exemplo um processo desatualizado onde o IDSPS instalado é inferior ao IDSPS disponível no RPO:

Image Added

Visualizando os detalhes do processo:

Image Added

Isso pode ocorrer após a aplicação de algum patch (.PTM) contendo o pacote ZSPS mais atual. Nesta situação, como o IDSPS do processo instalado (13) é inferior ao IDSPS do processo disponível no RPO (647), o status do processo é Desatualizado.

Solução: ATUALIZAR O PROCESSO

Para atualizar o processo basta realizar o procedimento descrito no tópico a seguir Instalando/Atualizando pacotes de procedures.

Não será necessário obter nenhum arquivo adicional, nem realizar a aplicação de patchs de atualizações (.PTM). A própria rotina de Gestão de Procedures se encarregará de obter o pacote mais recente disponível (da Central de Atualizações para ambientes online ou do próprio RPO para ambientes offline) e realizará a instalação no ambiente. O status do processo após a instalação será alterado para Atualizado. 

Caso o processo esteja funcionando corretamente em seu ambiente, não há motivos para atualizá-lo com urgência. Avalie também a atualização da rotina AdvPL associada ao processo. Programe o melhor momento para realizar esta atualização já que, caso seja necessária, a atualização da rotina deve ser efetuada primeiro por meio do patch indicado e somente então o processo poderá ser atualizado.

Image Added NÃO AVALIADO: Neste caso o processo instalado no ambiente não pôde ser comparado com o que está embarcado no RPO (modo offline) nem com o que está disponível na Central de Atualizações (modo online). Este status é muito peculiar e não ocorrerá com frequência, exceto nas seguintes situações:

• Caso a conectividade entre a aplicação e a Central de Atualizações seja interrompida ou inexistente no ambiente durante a análise realizada pela ferramenta e
• Quando não existe nenhum arquivo de pacote de procedures embarcado no RPO (arquivos .ZSPS)

Peguemos como exemplo um processo nesta situação:

Image Added

Ao analisarmos os detalhes do processo, veremos:

Image Added

No exemplo acima, constatamos que não há informações sobre o pacote no RPO. Isso significa que não existe o arquivo ZSPS do processo em questão de forma embarcada. Isso pode acontecer, por exemplo, se:

• • Não foi aplicado nenhum patch (.PTM) contendo os pacotes de procedures (recomendamos a leitura do tópico Migração para o novo modelo);
  • O arquivo ZSPS foi deletado do RPO;

Também constatamos que não há informações sobre o pacote na Central de Atualizações. O campo TPH (referente à Central de Atualizações) nem ao menos foi exibido na janela de detalhes. Isso significa que no momento em que a rotina foi executada a conectividade entre a aplicação e a Central de Atualizações foi interrompida ou é inexistente no ambiente em questão. Por estes motivos o status do processo será Não avaliado. 

Solução:

A solução neste caso envolve:

• • Checagem da conectividade entre a aplicação e a Central de Atualizações;
  • Aplicação de patch (.PTM) contendo o pacote ZSPS do processo em questão;

Após certificar de que o ambiente está normalizado, a reabertura da interface se faz necessária para que o status do processo seja novamente analisado. Não é necessário realizar a instalação/atualização do processo. 

Image Added NÃO INSTALADO: Um processo não instalado não representa uma anormalidade ou um erro. A instalação ou não do processo deve seguir as necessidades de cada ambiente onde a responsabilidade é dividida entre o administrador do sistema e as equipes que farão uso daquele processo. As rotinas Protheus associadas aos processos (ver o tópico Visualizando detalhes) funcionam normalmente sem que os processos estejam instalados no ambiente, porém o desempenho delas não é o mesmo se comparado ao desempenho das stored procedures.

Solução:

Caso seja necessário instalar um processo, basta seguir o procedimento descrito no tópico a seguir Instalando/Atualizando pacotes de procedures.

Image Added 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:

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

Image Added

Constatamos então que as assinaturas são diferentes.

Solução: COMPATIBILIZAR AS ASSINATURAS

A solução nestes casos envolve uma das seguintes opções:

• • Se a assinatura do processo for inferior à assinatura da rotina AdvPL, então o processo deve ser atualizado. Para isso, opte pela solução adequada ao seu cenário:
    • Em ambientes online: Executar a instalação/atualização do processo em questão.
    • Em ambientes offline: Obter um patch (.PTM) que contenha a versão mais recente do processo em questão e realizar a instalação.
  • Se a assinatura da rotina AdvPL for inferior à assinatura do processo: deve-se aplicar o patch (.PTM) contendo a versão mais atualizada da rotina em questão (consulte tópico Visualizando detalhes, subitem Seção Rotina);

Se mesmo após a aplicação do patch (.PTM) mais atual da rotina e/ou instalação do processo mais atual disponibilizado pela TOTVS as assinaturas continuarem incompatíveis, o suporte deverá ser acionado para entender o ocorrido. Existe ainda a alternativa para solucionar o problema de incompatibilidade de assinaturas por meio da opção Forçar utilização de pacotes .ZSPS contidos no RPO. Entretanto deve-se analisar os detalhes do processo (consulte tópico Visualizando detalhes, subitem Processo) e identificar se as assinaturas da rotina e do processo embarcado no RPO são compatíveis. Veja os detalhes do funcionamento desta opção em Configurações adicionais da rotina.

Image Added EMERGENCIAL: Processos com este status referem-se à situações onde foi aplicado um patch de correção (.PTM) contendo um pacote ZSPS Emergencial para correção de problemas pontuais em stored procedures. Clientes que utilizam o serviço PRIME recebem estes patchs (.PTM) com urgência. Pacotes ZSPS podem ser gerados com essa característica (Emergencial) e só são enviados aos clientes em situações específicas. Estes pacotes não são homologados pelo procedimento padrão TOTVS e sua função é a de sanar problemas pontuais ocorridos no ambiente de clientes PRIME.

A ferramenta quando encontra pacotes ZSPS do tipo Emergencial embarcados no RPO passa a se comportar de maneira distinta. No momento da instalação/atualização de processos, ao encontrar no RPO um pacote ZSPS Emergencial, a rotina fará uso dele em detrimento de pacotes encontrados na Central de Atualizações (desde que sejam mais recentes que os homologados e disponíveis na Central de Atualizações).

A interface passa a realizar uma série de controles específicos para garantir, por exemplo, que um pacote Emergencial não seja substituído por um outro pacote cujo conteúdo ainda não tenha sofrido as mesmas correções efetuadas no pacote recebido em caráter emergencial. Dessa forma garantimos que o ambiente não perca as correções contidas no pacote Emergencial, fundamentais para o correto funcionamento das rotinas.

Solução: AGUARDAR EXPEDIÇÃO OFICIAL CONTENDO CORREÇÕES EMERGENCIAIS

Quando a TOTVS concluir as correções em carater oficial e realizar a expedição de um novo pacote ZSPS do processo envolvido, este ficará disponível na Central de Atualizações e também no patch de correção (.PTM) gerado pela expedição realizada. A partir deste momento o processo poderá ser atualizado pela ferramenta, seja de maneira online ou offline.

Ao homologar um novo pacote ZSPS contendo todas as correções feitas no pacote ZSPS Emergencial, garantimos que as correções emergenciais estão presentes de forma oficial nos processos disponibilizados. Assim ao efetuar a atualização do processo Emergencial, a ferramenta identifica que o pacote mais recente homologado pode ser usado para substituir o pacote Emergencial do ambiente. Quando isso ocorre, o status do processo passa a ser Atualizado.

Image Added PILOTO: Processos com este status referem-se à processos que estão em testes por clientes Piloto. Somente com o consentimento e acordo entre Cliente e TOTVS é que um patch de atualização (.PTM) contendo um arquivo ZSPS Piloto é enviado ao cliente. Clientes considerados Pilotos estão em acordo com a TOTVS para realizarem testes de novos processos de procedures e/ou novas funcionalidades em processsos já existentes. Estes pacotes não são homologados pelo procedimento padrão TOTVS e sua função é a de proporcionar ao cliente um ambiente de testes, no qual as rotinas e stored procedures envolvidas ainda estão sendo testadas.

A ferramenta quando encontra pacotes ZSPS do tipo Piloto embarcados no RPO passa a se comportar de maneira distinta. No momento da instalação/atualização de processos, ao encontrar no RPO um pacote ZSPS Piloto, a rotina fará uso dele em detrimento de pacotes encontrados na Central de Atualizações (desde que sejam mais recentes que os homologados e disponíveis na Central de Atualizações).

A interface passa a realizar uma série de controles específicos para garantir, por exemplo, que um pacote Piloto não seja substituído por um outro pacote cujo conteúdo não contenha as mesmas inovações efetuadas no pacote recebido em caráter de inovação. Dessa forma garantimos que o ambiente não perca as atualizações contidas no pacote Piloto, fundamentais para a realização dos testes das rotinas e stored procedures envolvidas.

Solução: AGUARDAR EXPEDIÇÃO OFICIAL CONTENDO AS INOVAÇÕES

Quando a TOTVS concluir, em conjunto com os Clientes Piloto, os testes das inovações em carater oficial e realizar a expedição de um novo pacote ZSPS do processo envolvido, este ficará disponível na Central de Atualizações e também no patch de atualização (.PTM) gerado pela expedição realizada. A partir deste momento o processo poderá ser atualizado pela ferramenta, seja de maneira online ou offline.

Ao homologar um novo pacote ZSPS contendo todas as inovações feitas no pacote ZSPS Piloto, garantimos que as inovações criadas estão presentes de forma oficial nos processos disponibilizados. Assim ao efetuar a atualização do processo Piloto, a ferramenta identifica que o pacote mais recente homologado pode ser usado para substituir o pacote Piloto do ambiente. Quando isso ocorre, o status do processo passa a ser Atualizado.

Âncora
instalando_pacotes instalando_pacotes _heading h.f41wful3yjzh

Instalando/Atualizando pacotes de procedures

Em ambientes offline: Os arquivos necessários para a instalação estarão presentes de forma embarcada no RPO. Estes arquivos possuem a extensão .ZSPS e contém todas as informações necessárias para que o procedimento seja realizado de maneira offline (sem integração com a Central de Atualizações). Caso o processo a ser instalado não possua o referido arquivo .ZSPS embarcado no RPO (para constatar isso, consulte o tópico Visualizando detalhes), será necessário aplicar um patch (.PTM) que contenha o arquivo.

Em ambientes online: Durante o procedimento de instalação em ambientes integrados com a Central de Atualizações, os processos mais recentes homologados e disponibilizados pela TOTVS serão obtidos de maneira online e serão utilizados na instalação (desde que sejam mais recentes que os disponíveis no RPO).

Dessa forma garantimos que o ambiente esteja sempre atualizado com os processos de procedures mais recentemente homologados e disponibilizados pela TOTVS e/ou presentes no ambiente (de forma embarcada no RPO).

Para realizar a instalação/atualização:

• Selecionar em quais empresas os processos serão instalados/atualizados:
  Image Added

• Selecionar quais processos serão instalados/atualizados:
  Image Added

Após selecionar as empresas e processos, basta clicar no botão Image Added (instalar processos).

Será exibida uma janela com alguns avisos solicitando a confirmação:
Image Added

O procedimento de instalação somente poderá ocorrer se os processos selecionados não estiverem em uso por outra rotina neste momento.
Ao confirmar, surgirá uma outra janela exibindo o andamento da instalação:
Image Added

Ao final do procedimento surgirá uma janela contendo o Resumo das operações realizadas durante a instalação:

Image Added

Nesta interface constam as seguintes informações:

• • Total de operações: Quantidade total de ações a serem realizadas, baseadas nas Empresas/Grupo de Empresas e processos selecionados para instalação;
  • Sucessos: Quantidade de ações realizadas com sucesso;
  • Ignoradas: Quantidade de ações não realizadas/ignoradas;
  • Falhas: Quantidade de ações com falhas/problemas durante sua execução;

Ainda na janela de Resumo, ao clicar no botão Ver detalhes o detalhamento das ações será exibido:

Image Added

No botão Outras Ações é possível gerar o relatório deste log.

Ao fechar a janela de Resumo (ou de log), a interface principal será atualizada para refletir o status atual:
Image Added

Âncora
desinstalando_pacotes desinstalando_pacotes _heading h.4d34og8

Desinstalando pacotes de procedures

O procedimento para desinstalação de pacotes é semelhante ao de instalação. É necessário apenas que os processos envolvidos não estejam em uso. Este procedimento necessita de acesso exclusivo em algumas tabelas do banco de dados e por isso não pode haver concorrência.

Para realizar a desinstalação:

• Selecionar em quais empresas os processos serão desinstalados:
  Image Added

• Selecionar quais processos serão desinstalados

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

...

A nova interface exibe uma série de ícones para representar os status possíveis para os processos. Aqui estão relacionados os possíveis status e as ações que podem ser tomadas para cada situação.

Image Removed ATUALIZADO: O processo instalado no ambiente está atualizado com a última versão disponível em comparação ao pacote que está no RPO (modo offline) ou em relação ao pacote disponível na Central de Atualizações (modo online).

Solução:

Nenhuma ação é necessária neste caso.

Image Removed DESATUALIZADO: O processo instalado no ambiente não está na sua versão mais recente disponibilizada pela TOTVS. Isso significa apenas que o IDSPS do pacote instalado é inferior ao IDSPS do último pacote homologado. Um pacote que está desatualizado não representa um erro e sua atualização não é obrigatória ou urgente. Um pacote de procedures com este status pode perfeitamente ser executado por sua rotina AdvPL.

Ao encontrarmos processos com este status, devemos considerar:

Em ambientes online: A comparação é realizada com os pacotes disponíveis na Central de Atualizações. Vamos pegar como exemplo um processo desatualizado onde o IDSPS instalado é inferior ao IDSPS disponível na Central de Atualizações:

Exemplo de processo desatualizado:

Image Removed

Visualizando os detalhes do processo:

Image Removed

Note que o IDSPS do processo instalado (7) é inferior ao IDSPS do processo mais recente disponível na Central de Atualizações (691). Por este motivo o status do processo fica Desatualizado. Isto ocorre pois o processo recém homologado fica disponível para uso imediatamente à sua publicação e a ferramenta faz a leitura em tempo real, sem que nenhum patch seja aplicado no ambiente.

Em ambientes offline: A comparação é realizada com os pacotes embarcados no RPO. Vamos pegar como exemplo um processo desatualizado onde o IDSPS instalado é inferior ao IDSPS disponível no RPO:

Image Removed

Visualizando os detalhes do processo:

Image Removed

Isso pode ocorrer após a aplicação de algum patch (.PTM) contendo o pacote ZSPS mais atual. Nesta situação, como o IDSPS do processo instalado (13) é inferior ao IDSPS do processo disponível no RPO (647), o status do processo é Desatualizado.

Solução: ATUALIZAR O PROCESSO

Para atualizar o processo basta realizar o procedimento descrito no tópico a seguir Instalando/Atualizando pacotes de procedures.

Não será necessário obter nenhum arquivo adicional, nem realizar a aplicação de patchs de atualizações (.PTM). A própria rotina de Gestão de Procedures se encarregará de obter o pacote mais recente disponível (da Central de Atualizações para ambientes online ou do próprio RPO para ambientes offline) e realizará a instalação no ambiente. O status do processo após a instalação será alterado para Atualizado. 

Caso o processo esteja funcionando corretamente em seu ambiente, não há motivos para atualizá-lo com urgência. Avalie também a atualização da rotina AdvPL associada ao processo. Programe o melhor momento para realizar esta atualização já que, caso seja necessária, a atualização da rotina deve ser efetuada primeiro por meio do patch indicado e somente então o processo poderá ser atualizado.

Image Removed NÃO AVALIADO: Neste caso o processo instalado no ambiente não pôde ser comparado com o que está embarcado no RPO (modo offline) nem com o que está disponível na Central de Atualizações (modo online). Este status é muito peculiar e não ocorrerá com frequência, exceto nas seguintes situações:

• Caso a conectividade entre a aplicação e a Central de Atualizações seja interrompida ou inexistente no ambiente durante a análise realizada pela ferramenta e
• Quando não existe nenhum arquivo de pacote de procedures embarcado no RPO (arquivos .ZSPS)

Peguemos como exemplo um processo nesta situação:

Image Removed

Ao analisarmos os detalhes do processo, veremos:

Image Removed

No exemplo acima, constatamos que não há informações sobre o pacote no RPO. Isso significa que não existe o arquivo ZSPS do processo em questão de forma embarcada. Isso pode acontecer, por exemplo, se:

• • Não foi aplicado nenhum patch (.PTM) contendo os pacotes de procedures (recomendamos a leitura do tópico Migração para o novo modelo);
  • O arquivo ZSPS foi deletado do RPO;

Também constatamos que não há informações sobre o pacote na Central de Atualizações. O campo TPH (referente à Central de Atualizações) nem ao menos foi exibido na janela de detalhes. Isso significa que no momento em que a rotina foi executada a conectividade entre a aplicação e a Central de Atualizações foi interrompida ou é inexistente no ambiente em questão. Por estes motivos o status do processo será Não avaliado. 

Solução:

A solução neste caso envolve:

• • Checagem da conectividade entre a aplicação e a Central de Atualizações;
  • Aplicação de patch (.PTM) contendo o pacote ZSPS do processo em questão;

Após certificar de que o ambiente está normalizado, a reabertura da interface se faz necessária para que o status do processo seja novamente analisado. Não é necessário realizar a instalação/atualização do processo. 

Image Removed NÃO INSTALADO: Um processo não instalado não representa uma anormalidade ou um erro. A instalação ou não do processo deve seguir as necessidades de cada ambiente onde a responsabilidade é dividida entre o administrador do sistema e as equipes que farão uso daquele processo. As rotinas Protheus associadas aos processos (ver o tópico Visualizando detalhes) funcionam normalmente sem que os processos estejam instalados no ambiente, porém o desempenho delas não é o mesmo se comparado ao desempenho das stored procedures.

Solução:

Caso seja necessário instalar um processo, basta seguir o procedimento descrito no tópico a seguir Instalando/Atualizando pacotes de procedures.

Image Removed 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

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

Image Removed

Constatamos então que as assinaturas são diferentes.

Solução: COMPATIBILIZAR AS ASSINATURAS

A solução nestes casos envolve uma das seguintes opções:

• • Se a assinatura do processo for inferior à assinatura da rotina AdvPL, então o processo deve ser atualizado. Para isso, opte pela solução adequada ao seu cenário:
    • Em ambientes online: Executar a instalação/atualização do processo em questão.
    • Em ambientes offline: Obter um patch (.PTM) que contenha a versão mais recente do processo em questão e realizar a instalação.
  • Se a assinatura da rotina AdvPL for inferior à assinatura do processo: deve-se aplicar o patch (.PTM) contendo a versão mais atualizada da rotina em questão (consulte tópico Visualizando detalhes, subitem Seção Rotina);

Se mesmo após a aplicação do patch (.PTM) mais atual da rotina e/ou instalação do processo mais atual disponibilizado pela TOTVS as assinaturas continuarem incompatíveis, o suporte deverá ser acionado para entender o ocorrido. Existe ainda a alternativa para solucionar o problema de incompatibilidade de assinaturas por meio da opção Forçar utilização de pacotes .ZSPS contidos no RPO. Entretanto deve-se analisar os detalhes do processo (consulte tópico Visualizando detalhes, subitem Processo) e identificar se as assinaturas da rotina e do processo embarcado no RPO são compatíveis. Veja os detalhes do funcionamento desta opção em Configurações adicionais da rotina.

Image Removed EMERGENCIAL: Processos com este status referem-se à situações onde foi aplicado um patch de correção (.PTM) contendo um pacote ZSPS Emergencial para correção de problemas pontuais em stored procedures. Clientes que utilizam o serviço PRIME recebem estes patchs (.PTM) com urgência. Pacotes ZSPS podem ser gerados com essa característica (Emergencial) e só são enviados aos clientes em situações específicas. Estes pacotes não são homologados pelo procedimento padrão TOTVS e sua função é a de sanar problemas pontuais ocorridos no ambiente de clientes PRIME.

A ferramenta quando encontra pacotes ZSPS do tipo Emergencial embarcados no RPO passa a se comportar de maneira distinta. No momento da instalação/atualização de processos, ao encontrar no RPO um pacote ZSPS Emergencial, a rotina fará uso dele em detrimento de pacotes encontrados na Central de Atualizações (desde que sejam mais recentes que os homologados e disponíveis na Central de Atualizações).

A interface passa a realizar uma série de controles específicos para garantir, por exemplo, que um pacote Emergencial não seja substituído por um outro pacote cujo conteúdo ainda não tenha sofrido as mesmas correções efetuadas no pacote recebido em caráter emergencial. Dessa forma garantimos que o ambiente não perca as correções contidas no pacote Emergencial, fundamentais para o correto funcionamento das rotinas.

Solução: AGUARDAR EXPEDIÇÃO OFICIAL CONTENDO CORREÇÕES EMERGENCIAIS

Quando a TOTVS concluir as correções em carater oficial e realizar a expedição de um novo pacote ZSPS do processo envolvido, este ficará disponível na Central de Atualizações e também no patch de correção (.PTM) gerado pela expedição realizada. A partir deste momento o processo poderá ser atualizado pela ferramenta, seja de maneira online ou offline.

Ao homologar um novo pacote ZSPS contendo todas as correções feitas no pacote ZSPS Emergencial, garantimos que as correções emergenciais estão presentes de forma oficial nos processos disponibilizados. Assim ao efetuar a atualização do processo Emergencial, a ferramenta identifica que o pacote mais recente homologado pode ser usado para substituir o pacote Emergencial do ambiente. Quando isso ocorre, o status do processo passa a ser Atualizado.

Image Removed PILOTO: Processos com este status referem-se à processos que estão em testes por clientes Piloto. Somente com o consentimento e acordo entre Cliente e TOTVS é que um patch de atualização (.PTM) contendo um arquivo ZSPS Piloto é enviado ao cliente. Clientes considerados Pilotos estão em acordo com a TOTVS para realizarem testes de novos processos de procedures e/ou novas funcionalidades em processsos já existentes. Estes pacotes não são homologados pelo procedimento padrão TOTVS e sua função é a de proporcionar ao cliente um ambiente de testes, no qual as rotinas e stored procedures envolvidas ainda estão sendo testadas.

A ferramenta quando encontra pacotes ZSPS do tipo Piloto embarcados no RPO passa a se comportar de maneira distinta. No momento da instalação/atualização de processos, ao encontrar no RPO um pacote ZSPS Piloto, a rotina fará uso dele em detrimento de pacotes encontrados na Central de Atualizações (desde que sejam mais recentes que os homologados e disponíveis na Central de Atualizações).

A interface passa a realizar uma série de controles específicos para garantir, por exemplo, que um pacote Piloto não seja substituído por um outro pacote cujo conteúdo não contenha as mesmas inovações efetuadas no pacote recebido em caráter de inovação. Dessa forma garantimos que o ambiente não perca as atualizações contidas no pacote Piloto, fundamentais para a realização dos testes das rotinas e stored procedures envolvidas.

Solução: AGUARDAR EXPEDIÇÃO OFICIAL CONTENDO AS INOVAÇÕES

Quando a TOTVS concluir, em conjunto com os Clientes Piloto, os testes das inovações em carater oficial e realizar a expedição de um novo pacote ZSPS do processo envolvido, este ficará disponível na Central de Atualizações e também no patch de atualização (.PTM) gerado pela expedição realizada. A partir deste momento o processo poderá ser atualizado pela ferramenta, seja de maneira online ou offline.

Ao homologar um novo pacote ZSPS contendo todas as inovações feitas no pacote ZSPS Piloto, garantimos que as inovações criadas estão presentes de forma oficial nos processos disponibilizados. Assim ao efetuar a atualização do processo Piloto, a ferramenta identifica que o pacote mais recente homologado pode ser usado para substituir o pacote Piloto do ambiente. Quando isso ocorre, o status do processo passa a ser Atualizado.

...

Em ambientes offline: Os arquivos necessários para a instalação estarão presentes de forma embarcada no RPO. Estes arquivos possuem a extensão .ZSPS e contém todas as informações necessárias para que o procedimento seja realizado de maneira offline (sem integração com a Central de Atualizações). Caso o processo a ser instalado não possua o referido arquivo .ZSPS embarcado no RPO (para constatar isso, consulte o tópico Visualizando detalhes), será necessário aplicar um patch (.PTM) que contenha o arquivo.

Em ambientes online: Durante o procedimento de instalação em ambientes integrados com a Central de Atualizações, os processos mais recentes homologados e disponibilizados pela TOTVS serão obtidos de maneira online e serão utilizados na instalação (desde que sejam mais recentes que os disponíveis no RPO).

...

Para realizar a instalação/atualização:

• Selecionar em quais empresas os processos serão instalados/atualizados:
  Image Removed

• Selecionar quais processos serão instalados/atualizados:
  

Após selecionar as empresas e processos, basta clicar no botão Image Removed Image Added (instalar desinstalar processos).
Será exibida uma janela com alguns avisos solicitando a confirmação da desinstalação:
Image RemovedImage Added

O procedimento de instalação desinstalação somente poderá ocorrer se os processos selecionados não estiverem em uso por outra rotina neste momento.
Ao confirmar, surgirá uma outra janela exibindo o andamento da instalaçãodesinstalação:
Image RemovedImage Added

Ao final do procedimento surgirá uma janela contendo o Resumo das operações realizadas durante a instalaçãodesinstalação:

Image RemovedImage Added

Nesta interface constam as seguintes informações:

• • Total de operações: Quantidade total de ações a serem realizadas, baseadas nas Empresas/Grupo de Empresas e processos selecionados para instalaçãodesinstalação;
  • Sucessos: Quantidade de ações realizadas com sucesso;
  • Ignoradas: Quantidade de ações não realizadas/ignoradas;
  • Falhas: Quantidade de ações com falhas/problemas durante sua execução;

Ainda na janela de Resumo, ao clicar no botão Ver detalhes o detalhamento das ações será exibido:

Image RemovedImage Added

No botão Outras Ações é possível gerar o relatório deste log.

Ao fechar a janela de Resumo (ou de log), a interface principal será atualizada para refletir o status atual:
Image RemovedImage Added

Âncora

...

consultando_

...

historico

...

consultando_

...

historico _heading h.

...

2s8eyo1

Consultando o histórico de operações

Para visualizar o histórico das operações realizadas, basta clicar no botão Image Added (Histórico de operações) da interface principal:

Image Added

As informações na parte superior desta interface se referem às ações de instalação e desinstalação realizadas, contendo entre elas:

• ID da ação (sequencial e de uso interno apenas);
• Data e hora de execução;
• Tipo da ação (instalação ou desinstalação);
• Modo: on-line ou off-line (integração com a Central de Atualizações ativa ou não);
• Código e nome do usuário que executou a ação;
• Dados do ambiente: nome, alias, tipo de banco, IP e porta de comunicação com DBAccess;
• Totalizadores: empresas selecionadas, processos selecionados, execuções a realizar, sucessos, falhas e ignoradas;

Na parte inferior são apresentados os detalhes de cada tarefa:

• ID da tarefa (sequencial e de uso interno apenas);
• Tipo: Pode conter um dos seguintes valores [INFO], [OK], [SKIP], [ERRO];
• Log: descritivo da tarefa realizada;
• Detalhes: armazenará os detalhes dos problemas encontrados durante a execução da tarefa;

A legenda da grid inferior apresentará:

Image Added INFO - Informações genéricas;

Image Added OK - Ação realizada com sucesso;

Image Added SKIP - Ação ignorada;

Image Added ERRO - Ação com falha/problema na execução; 

Ao encontrar uma ação com o tipo Image Added ERRO note que haverá o texto "Duplo clique em Memo para detalhes" na descrição do log. Nesta situação, basta efetuar um duplo clique na coluna Detalhes para visualizar a mensagem completa com a falha/problema ocorrido:

Image Added

Conteúdo da coluna Detalhes:
Image Added

Âncora
relatório_log relatório_log

Para realizar a desinstalação:

• Selecionar em quais empresas os processos serão desinstalados:
  Image Removed

• Selecionar quais processos serão desinstalados:
  Image Removed

Após selecionar as empresas e processos, basta clicar no botão Image Removed (desinstalar processos).
Será exibida uma janela com alguns avisos solicitando a confirmação da desinstalação:
Image Removed

O procedimento de desinstalação somente poderá ocorrer se os processos selecionados não estiverem em uso por outra rotina neste momento.
Ao confirmar, surgirá uma outra janela exibindo o andamento da desinstalação:
Image Removed

Ao final do procedimento surgirá uma janela contendo o Resumo das operações realizadas durante a desinstalação:

Image Removed

Nesta interface constam as seguintes informações:

• • Total de operações: Quantidade total de ações a serem realizadas, baseadas nas Empresas/Grupo de Empresas e processos selecionados para desinstalação;
  • Sucessos: Quantidade de ações realizadas com sucesso;
  • Ignoradas: Quantidade de ações não realizadas/ignoradas;
  • Falhas: Quantidade de ações com falhas/problemas durante sua execução;

Ainda na janela de Resumo, ao clicar no botão Ver detalhes o detalhamento das ações será exibido:

Image Removed

No botão Outras Ações é possível gerar o relatório deste log.

...

_heading h.2s8eyo1

...

Relatório de

...

Para visualizar o histórico das operações realizadas, basta clicar no botão Image Removed (Histórico de operações) da interface principal:

Image Removed

As informações na parte superior desta interface se referem às ações de instalação e desinstalação realizadas, contendo entre elas:

• ID da ação (sequencial e de uso interno apenas);
• Data e hora de execução;
• Tipo da ação (instalação ou desinstalação);
• Modo: on-line ou off-line (integração com a Central de Atualizações ativa ou não);
• Código e nome do usuário que executou a ação;
• Dados do ambiente: nome, alias, tipo de banco, IP e porta de comunicação com DBAccess;
• Totalizadores: empresas selecionadas, processos selecionados, execuções a realizar, sucessos, falhas e ignoradas;

Na parte inferior são apresentados os detalhes de cada tarefa:

• ID da tarefa (sequencial e de uso interno apenas);
• Tipo: Pode conter um dos seguintes valores [INFO], [OK], [SKIP], [ERRO];
• Log: descritivo da tarefa realizada;
• Detalhes: armazenará os detalhes dos problemas encontrados durante a execução da tarefa;

A legenda da grid inferior apresentará:

Image Removed INFO - Informações genéricas;

Image Removed OK - Ação realizada com sucesso;

Image Removed SKIP - Ação ignorada;

Image Removed ERRO - Ação com falha/problema na execução; 

Ao encontrar uma ação com o tipo Image Removed ERRO note que haverá o texto "Duplo clique em Memo para detalhes" na descrição do log. Nesta situação, basta efetuar um duplo clique na coluna Detalhes para visualizar a mensagem completa com a falha/problema ocorrido:

Image Removed

Conteúdo da coluna Detalhes:
Image Removed

...

Log

No botão Outras Ações da janela de Log é possível gerar um relatório completo de todas as operações contidas no log. Também é possível efetuar filtros e personalizar o relatório.

Image Added

Ao selecionar a opção Relatório, a seguinte interface é exibida. Nesta janela é possível definir, entre outras opções, o tipo de arquivo gerado:

Image Added

No exemplo acima foi selecionada a opção Planilha:

Image Added

Âncora
resolução_problemas resolução_problemas _heading h.2s8eyo1

Resolução de problemas pontuais sem necessidade de contato com suporte TOTVS

Alguns problemas ocorridos durante o procedimento de instalação/desinstalação podem ser resolvidos pelo próprio cliente, sem a necessidade de abertura de chamado e/ou contato com o suporte TOTVS. Para isso, basta visualizar os detalhes do log e seguir as instruções.

Os exemplos abaixo demonstram erros ocorridos durante a instalação de processos. São apresentadas as causas dos problemas e também as soluções propostas para os casos.

Problema reportado: Incompatibilidade de assinaturas entre rotina AdvPL e processo:

Cenário 1: Rotina AdvPL com assinatura inferior

Image Added

Neste exemplo a assinatura da rotina MATA280.PRX (003) é inferior à assinatura do processo (004). Esta situação é descrita no tópico Entendendo os status dos processos e ações que podem ser tomadas.

A solução proposta para o problema é atualizar a rotina MATA280.PRX, compatibilizando as assinaturas. É indicado o link para download do patch (.PTM) mais recente disponível que contém a referida rotina. Espera-se que com a aplicação deste patch, a assinatura da rotina passe a ser idêntica à assinatura do processo (004).

Se mesmo após a aplicação do patch (.PTM) indicado as assinaturas continuarem incompatíveis, o suporte deverá ser acionado para entender o ocorrido. Existe ainda a alternativa para solucionar o problema de incompatibilidade de assinaturas por meio da opção Forçar utilização de pacotes .ZSPS contidos no RPO. Entretanto deve-se analisar os detalhes do processo (consulte tópico Visualizando detalhes, subitem Processo) e identificar se as assinaturas da rotina e do processo embarcado no RPO são compatíveis. Veja os detalhes do funcionamento desta opção em Configurações adicionais da rotina. Se isso acontecer, significa que a rotina em questão não foi devidamente compatibilizada com o processo ao qual ela está associada, e isso deverá ser informado na abertura do chamado. Dessa forma a área responsável poderá identificar o problema e providenciar a compatibilização.

Cenário 2: Processo com assinatura inferior

Image Added

Neste exemplo a assinatura do processo (010) é inferior à da rotina (011). Esta

...

Em alguns casos de erros ocorridos durante o procedimento de instalação/desinstalação é possível resolver o problema sem a necessidade de abertura de chamado e/ou contato com o suporte TOTVS.

O próprio cliente poderá resolver a inconsistência, de acordo com o nível de gravidade, bastando para isso visualizar os detalhes do log e seguir as instruções nele contidas.

Os exemplos abaixo demonstram erros ocorridos durante a instalação de processos. São apresentadas as causas dos problemas e também as soluções para os casos.

Problema reportado: Incompatibilidade de assinaturas entre rotina AdvPL e processo

Image Removed

Neste exemplo fica claro que o problema de incompatibilidade ocorreu porque as assinaturas são divergentes.

A assinatura da rotina MATA280.PRX (no exemplo 003) é inferior à assinatura do processo (no exemplo 004). Esta situação é descrita no tópico Entendendo os status dos processos e ações que podem ser tomadas.Repare que é proposta uma solução para o problema. Neste exemplo basta aplicar o patch de correção (.PTM) contendo a rotina MATA280.PRX com a assinatura atualizada e compatível com o processoe ações que podem ser tomadas.

A solução ainda oferece um link direcionando o cliente para o portal de downloads, diretamente para o patch (.PTM) mais recente disponível que contém a referida rotina.

Ao acessar este link, o cliente poderá baixar o patch, e seguindo as instruções contidas no log, após a aplicação do mesmo a rotina estará em sua versão mais atual.

Espera-se que com essa aplicação de patch, a assinatura da rotina passe a ser idêntica à assinatura do processo (no caso 004).

proposta para o problema é atualizar o processo, compatibilizando as assinaturas. É importante lembrar que se o ambiente estiver integrado à Central de Atualizações e esta não oferecer um processo com a assinatura compatível, o contato com o suporte se faz necessário. Se o ambiente for offline, então a obtenção do patch (.PTM) conforme as instruções do log deve ser realizada. 

Se Contudo, se mesmo após a aplicação do patch , a rotina ainda permanecer com a assinatura incompatível, então o suporte TOTVS deverá ser acionado e deverá ser relatado exatamente o que foi descrito neste caso.(.PTM) indicado as assinaturas continuarem incompatíveis, o suporte deverá ser acionado para entender o ocorrido. Se isso ocorrer, significa que a rotina o processo em questão não foi devidamente compatibilizada com o processo ao qual ela está associadacompatibilizado com a rotina à qual ele está associado, e isso deverá ser informado na abertura do chamado. Dessa forma a área responsável poderá identificar o problema e providenciar a correção para a incompatibilidadecompatibilização.

Problema reportado: Incompatibilidade de assinaturas entre processo e rotina CFGX051M.PRW (Instalador instalador de procedures):

Neste exemplo o problema de incompatibilidade é entre o processo e a rotina que faz a instalação CFGX051M.PRW (o próprio instalador, CFGX051M.PRW).

Isso pode ocorrer ocorre porque os arquivos ZSPS contém exigem uma informação que é a assinatura mínima exigida para o instalador.do instalador para serem utilizados. Essa assinatura garante que os pacotes ZSPS construídos para serem utilizados por uma determinada versão do instalador não gerem errorlog durante a sua instalação caso o programa que faz a sua instalação não seja compatívelcaso o instalador esteja desatualizado.

Esse mecanismo é necessário pois a construção das procedures segue um padrão pré-estabelecido pela TOTVS. Essa construção leva em consideração uma série de requisitos para sua escrita e que por sua vez fazem parte do mecanismo de instalação. Por estarmos sempre em evolução, o programa instalador sofre alterações de acordo com a necessidade de adequação alterações para se adequar à forma como as procedures são escritas.   Diante disso, precisamos garantir que caso uma procedure tenha sido escrita sob novas regras de construção, o instalador esteja preparado para ler esta procedure e entenda o que foi escrito nela.Por isso devemos sempre manter o programa instalador (CFGX051M.PRW) atualizado.uma procedure possa ser lida e processada corretamente pelo programa instalador. Por este motivo o programa instalador deve estar sempre atualizado (consulte tópico Visualizando detalhes, subitem Seção Gestão de Procedures);

Note que, assim como no exemplo anteriornos exemplos anteriores, existem neste log a causa do problema e uma solução proposta para ele. E da mesma forma, existe um link que, ao ser acionado direcionará nos levará para a página de downloads diretamente para o patch (.PTM) contendo a versão mais recente disponível do instalador. Após aplicado, a assinatura do instalador estará compatível com a assinatura mínima para instalação exigida pelo processoexigida. Caso isso não ocorra, então o suporte deverá ser acionado.

Em ambos todos os casos descritos acima o que é mais importante salientar é ressaltar que, mesmo sem a ajuda do acionar o suporte TOTVS, o próprio cliente poderá solucionar os problemas ocorridos.

Vale lembrar que em ambas as situações, caso não ocorra a compatibilização após a aplicação do patch (.PTM), o suporte deverá ser acionado.

...

alguns problemas podem ser solucionados apenas seguindo as instruções contidas nos detalhes do log. Salientamos com isso a importância de sempre verificar as ocorrências do tipo Image Added ERRO no log de operações.

...

No botão Outras Ações da janela de Log é possível gerar um relatório completo de todas as operações contidas no log. Também é possível efetuar filtros e personalizar o relatório.

Image Removed

Ao selecionar a opção Relatório, a seguinte interface é exibida. Nesta janela é possível definir, entre outras opções, o tipo de arquivo gerado:

Image Removed

No exemplo acima foi selecionada a opção Planilha:

Image Removed

Âncora
configurações_adicionais configurações_adicionais _heading h.2s8eyo1

Configurações adicionais da rotina

...