...
Passo 2: Aplique os patchs de Expedições Contínuas dos módulos relacionados abaixo para atualizar o RPO com os pacotes ZSPS e também as rotinas vinculadas aos processos de stored procedures:
Versão 12.1.272210
Versão 12.1.332310
Versão 12.1.2210
Versão 12.1.2410
Para os módulos do Backoffice (FAT, COM, FIS, FIN, EST, CTB, ATF, PCO e CRM) deve-se obter o pacote de Expedição Contínua Backoffice a partir do link: https://suporte.totvs.com/portal/p/10098/download?e=
...
| Nota | ||
|---|---|---|
| ||
ROTINAS ATUALIZADAS E | ||
| Nota | ||
| ||
ROTINAS ATUALIZADAS E PACOTES DE PROCEDURES NO FORMATO ZSPS Os patchs de Expedição Contínua dos módulos acima são necessários para que o RPO seja atualizado com os pacotes de procedures no novo formato .ZSPS, além das rotinas associadas às stored procedures. A aplicação destes patchs é obrigatória, caso contrário poderão ocorrer erros durante a instalação/desinstalação de processos. |
...
- 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.
...
| Nota | ||
|---|---|---|
| ||
A Central de Atualizações não é item obrigatório. A ausência (temporária ou definitiva) de conectividade não atrapalha em nada o funcionamento da rotina de Gestão de Procedures. |
| Âncora | |||||||||
|---|---|---|---|---|---|---|---|---|---|
|
...
Seção Processo:
Apresenta informações detalhadas do processo:
| Nota | ||
|---|---|---|
| ||
| Nota | ||
| ||
Um processo com IDSPS negativo no campo Instalado (no exemplo acima -17) significa apenas que ele é legado, ou seja, já estava devidamente instalado no ambiente previamente à migração para o novo modelo de Gestão de Procedures. Isso não caracteriza problema ou erro. Processos legados, em sua maioria, estão Desatualizados perante aos novos pacotes ZSPS contidos no RPO ou na Central de Atualizações. Contudo, estes processos podem ser utilizados normalmente por suas rotinas AdvPL, desde que possuam assinaturas compatíveis. |
...
Apresenta informações detalhadas do rotina AdvPL associada ao processo:
...
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.
...
Seção Gestão de Procedures:
Apresenta informações detalhadas da interface de Gestão de Procedures (CFGX051M):
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.
| Âncora | ||||||
|---|---|---|---|---|---|---|
|
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.
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.
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:
...
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.
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.
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:
Visualizando os detalhes do processo:
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.
| Nota | ||
|---|---|---|
| ||
Os pacotes de procedures ficam disponíveis na Central de Atualizações assim que é feita a homologação dos mesmos. Essa etapa ocorre simultaneamente à expedição dos patchs de atualizações (.PTM) publicados e disponibilizados no Portal de Downloads. Por esse motivo, em um ambiente integrado à Central de Atualizações a interface pode indicar, a qualquer momento, que um determinado processo está Desatualizado. Contudo, isso não indica necessariamente um problema, já que pacotes Desatualizados podem ser utilizados normalmente por suas rotinas AdvPL. |
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:
Visualizando os detalhes do processo:
Note que o 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 (137) é inferior ao IDSPS do processo disponível no RPO (647), mais recente disponível na Central de Atualizações (691). Por este motivo o status do processo é fica 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.
...
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.
| Nota | ||
|---|---|---|
| ||
Os pacotes de procedures ficam disponíveis na Central de Atualizações assim que é feita a homologação dos mesmos. Essa etapa ocorre simultaneamente à expedição dos patchs de atualizações (.PTM) |
...
publicados e disponibilizados no Portal de Downloads. Por esse motivo, em um ambiente integrado à Central de Atualizações a interface pode indicar, a qualquer momento, que um determinado processo está Desatualizado. Contudo, isso não indica necessariamente um problema, já que pacotes Desatualizados podem ser utilizados normalmente por suas rotinas AdvPL. |
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:
Visualizando os detalhes do processo:
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.
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 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.
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:
Peguemos como exemplo um processo nesta situação:
Ao analisarmos os detalhes do processo, veremos:
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:
...
...
...
...
Peguemos como exemplo um processo nesta situação:
Ao analisarmos os detalhes do processo, veremos:
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:
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:
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.
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.
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:
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.
| Nota | ||
|---|---|---|
| ||
Esta interface tem como objetivo proteger o sistema, impedindo que ocorram errorlogs. A checagem de compatibilidade é uma tarefa executada sempre que uma stored procedure é acionada a partir do sistema, ou seja, esse mecanismo sempre será ativado independente de ações do usuário, parametrização do sistema, etc. Não há como evitar que essa mensagem seja exibida quando houver incompatibilidade. A única forma de evitar a exibição desta mensagem é garantir que os processos de stored procedures estejam sempre compatíveis com suas respectivas rotinas AdvPL. Essa checagem não tem relação com o novo modelo de Gestão de Procedures. Ela sempre existiu, desde as primeiras releases Protheus disponibilizadas com a funcionalidade de stored procedures. |
Podemos verificar estas informações ao visualizarmos os detalhes do processo (no caso é o processo 09).
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 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.
EMERGENCIAL: Processos com este status referem-se à
Solução:
A solução neste caso envolve:
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.
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.
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:
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).
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 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.
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.
...
Ainda na janela de Resumo, ao clicar no botão Ver detalhes o detalhamento das ações será exibido:
No botão Outras Ações é possível gerar o relatório deste log.
...
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:
| Âncora | ||||||
|---|---|---|---|---|---|---|
|
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:
Após selecionar as empresas e processos, basta clicar no botão 
(desinstalar processos).
Será exibida uma janela com alguns avisos solicitando a confirmação da desinstalação:
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:
Ao final do procedimento surgirá uma janela contendo o Resumo das operações realizadas durante a desinstalação:
Nesta interface constam as seguintes informações:
Ainda na janela de Resumo, ao clicar no botão Ver detalhes o detalhamento das ações será exibido:
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:
| Nota | ||
|---|---|---|
| ||
O comportamento padrão da rotina de desinstalação de pacotes não remove fisicamente da base de dados as stored procedures do tipo ponto de entrada. Estas procedures merecem um cuidado especial, pois podem conter customizações específicas de cada cliente e, portanto, não devem ser removidas sem consentimento. Porém, caso seja necessário, é possível removê-las configurando-se o parâmetro MV_DROPPE. Caso este parâmetro seja ativado, elas também serão removidas fisicamente da base durante a desinstalação de um pacote. |
Para realizar a desinstalação:
Após selecionar as empresas e processos, basta clicar no botão (desinstalar processos).
Será exibida uma janela com alguns avisos solicitando a confirmação da desinstalação:
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:
Ao final do procedimento surgirá uma janela contendo o Resumo das operações realizadas durante a desinstalação:
Nesta interface constam as seguintes informações:
Ainda na janela de Resumo, ao clicar no botão Ver detalhes o detalhamento das ações será exibido:
No botão Outras Ações é possível gerar o relatório deste log.
...
| Âncora | ||||||
|---|---|---|---|---|---|---|
|
...
A solução 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. Pode-se utilizar, nestes casos, o patch acumulado de procedures, disponível no link: https://suporte.totvs.com/portal/p/10098/download?e=1039992. Este é o conjunto completo de todos os pacotes de procedures no novo formato .ZSPScom 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 mesmo após a aplicação do patch (.PTM) indicado as assinaturas continuarem incompatíveis, o suporte deverá ser acionado para entender o ocorrido. Se isso ocorrer, significa que o processo em questão não foi devidamente compatibilizado 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 compatibilização.
...
| Nota | ||
|---|---|---|
| ||
O link para download dos patchs (.PTM) somente serão exibidos nas mensagens do log em ambientes online, ou seja, com a integração com a Central de Atualizações configurada e ativa no momento da instalação/desinstalação. Se o ambiente não possuir integração com a Central de Atualizações, então o portal de downloads deve ser acionado e os patchs de correções (.PTM) devem ser obtidos individualmente . Os ou por meio dos pacotes de procedures (.ZSPS) podem ser obtidos diretamente no link: https://suporte.totvs.com/portal/p/10098/download?e=1039992. Expedições Contínuas. |
| Âncora | ||||||
|---|---|---|---|---|---|---|
|
...
