Histórico da Página
...
Nota | ||
---|---|---|
| ||
O novo modelo não afeta:
|
Âncora | ||||||
---|---|---|---|---|---|---|
|
Para preparar o ambiente e realizar a migração, tenha certeza de executar os seguintes passos:
...
- FAT (Faturamento) - https://suporte.totvs.com/portal/p/10098/download?e=1080341
- COM (Compras) - https://suporte.totvs.com/portal/p/10098/download?e=1080335
- FIS (Fiscal) - https://suporte.totvs.com/portal/p/10098/download?e=1080345
- FIN (Financeiro) - https://suporte.totvs.com/portal/p/10098/download?e=1080343
- EST (Estoque) - https://suporte.totvs.com/portal/p/10098/download?e=1080339
- CTB (Controladoria) - https://suporte.totvs.com/portal/p/10098/download?e=1080337
...
title | IMPORTANTE: |
---|
Versão 12.1.2310
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.
...
- FAT (Faturamento) - https://suporte.totvs.com/portal/p/10098/download?e=1123877
- COM (Compras) -
...
- 1123869
- FIS (Fiscal) - https://suporte.totvs.com/portal/p/10098/download?e=1123881
- FIN (Financeiro) - https://suporte.totvs.com/portal/p/10098/download?e=1123879
- EST (Estoque) - https://suporte.totvs.com/portal/p/10098/download?e=1123875
- CTB (Controladoria) - https://suporte.totvs.com/portal/p/10098/download?e=1123873
- ATF (Ativo Fixo) - https://suporte.totvs.com/portal/p/10098/download?e=1123865
- PCO (Planejamento e Controle Orçamentário) - https://suporte.totvs.com/portal/p/10098/download?e=1123883
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. |
Passo 3: Acesse o programa Gerenciador de procedures,
...
Passo 3: Acesse o programa Gerenciador de procedures, através do menu Base de Dados | Dicionário | Stored Procedure. Será apresentada a seguinte interface:
...
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 | ||||||
---|---|---|---|---|---|---|
|
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.
...
ambiente que possibilite o uso da Central de Atualizaçõesambiente que possibilite o uso da Central de Atualizações.
- 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 noNota | ||
---|---|---|
| ||
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 | ||||||
---|---|---|---|---|---|---|
|
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.
...
- Instalar os pacotes selecionados nas empresas selecionadas.
- Remover os pacotes selecionados das empresas selecionadas.
- Marcar todas as empresas disponíveis no grid.
- Desmarcar todas as empresas do grid.
- Consultar o histórico de operações.
- Configurações adicionais da rotina.
- Link para a documentação oficial da rotina (esta página).
Âncora | ||||||
---|---|---|---|---|---|---|
|
Serão listados todos os processos disponíveis para instalação.
...
- grid. Marcar todos os processos disponíveis no
- Desmarcar todos os processos do grid. Desmarcar todos os processos do grid.
Âncora | ||||||
---|---|---|---|---|---|---|
|
A visão disponibilizada nesta guia baseia-se na navegação realizada entre as empresas disponíveis na relação de empresas.
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 | ||
---|---|---|
|
...
|
...
|
...
|
...
|
...
|
...
Processo vs
...
Empresas
A visão disponibilizada nesta guia baseia-se na navegação realizada entre as empresas os processos disponíveis na relação de processos.
Nota | ||
---|---|---|
| ||
Esta guia somente estará visível caso exista mais de uma empresa/grupo de empresas disponível no ambiente. |
A parte superior apresentará o nome da empresa posicionadado processo posicionado, além dos totalizadores de cada um dos possíveis status.
Na parte inferior estarão relacionados todos os processos relacionadas todas as empresas disponíveis e seus respectivos status na empresa posicionada.
...
Nota | ||
---|---|---|
| ||
Esta guia somente estará visível caso exista mais de uma empresa/grupo de empresas disponível no ambiente. |
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
Indica que o processo está atualizado.
Indica que o processo está desatualizado.
Indica que não foi possível avaliar o status do processo.
Indica que o processo não está instalado.
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.
...
As seções apresentadas são:
Seção Detalhes:
Apresenta informações detalhadas sobre o ambiente:
...
- ON (modo online) quando conectividade está ativa ou
- OFF (modo offline) quando não há conectividade;
perante o processo posicionado.
LEGENDA
Indica que o processo está atualizado.
Indica que o processo está desatualizado.
Indica que não foi possível avaliar o status do processo.
Indica que o processo não está instalado.
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 | ||||||
---|---|---|---|---|---|---|
|
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.
As seções apresentadas são:
Seção Detalhes:
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:
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]
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. |
Seção Rotina:
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)
...
- 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.
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. |
Seção Rotina:
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çõesde 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).
...
- 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:
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
- 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).
Â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.
...
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.
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ópicoSoluçã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:
...
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).
...
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 | ||||||
---|---|---|---|---|---|---|
|
Nota | ||
---|---|---|
| ||
Não é necessário obter nenhum arquivo de extensão .SPS. Eles são obsoletos e não são mais utilizados por esta rotina. |
...
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.
...
Ao fechar a janela de Resumo (ou de log), a interface principal será atualizada para refletir o status atual:
Âncora | ||||||
---|---|---|---|---|---|---|
|
Para visualizar o histórico das operações realizadas, basta clicar no botão
(Histórico de operações) da interface principal:...
Conteúdo da coluna Detalhes:
Âncora | ||||||
---|---|---|---|---|---|---|
|
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.
...
Nota | ||
---|---|---|
| ||
Utilize a opção Planilha para gerar um arquivo em formato Excel. Dessa forma é possível enviar o log para equipes de suporte TOTVS. Estas informações são fundamentais para a equipe iniciar a análise de problemas. |
Âncora | ||||||
---|---|---|---|---|---|---|
|
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.
...
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 | ||||||
---|---|---|---|---|---|---|
|
O botão
(Configurações adicionais da rotina) está disponível na interface principal, na barra lateral:...