...

1. Introdução

...

A Central de Atualizações Protheus é uma ferramenta com objetivo de facilitar a identificação dos componentes de um ambiente Protheus e seu status de atualização. Através desta solução o cliente do ERP Protheus conseguirá identificar mais facilmente se seu ambiente está atualizado ou não comparando com os últimos artefatos atualizados pela Totvs, podendo assim diminuir acesso ao suporte e se auto atualizando. Podendo usar a ferramenta como um atalho ao TDN

...

2. Arquitetura

A solução é dividida em dois serviços um rodando no ambiente do cliente e outro rodando no ambiente Totvs, conforme diagrama abaixo.

Image Removed

2.1. Protheus Cliente

Diariamente um serviço irá avaliar o ambiente em que está rodando e identificando qualquer atualização no mesmo irá enviar para a central de atualizações as informações das versões de todos os artefatos referente ao ambiente (RPO, Pacotes de Atualização Aplicados, Lib, Binários e Dados do Ambiente) para que possam ser comparados com as versões atualizadas da Totvs.

2.2. Central de Atualizações (Serviços TPH)

Conjunto de Serviços responsável por comparar e exibir as informações dos artefatos atualizados e não atualizados direcionando o caminho para atualização.

2.2.1. API

Serviço responsável pela coleta de dados do ambiente do cliente e dos artefatos Totvs.

2.2.2. Portinari/THF Cliente

Interface disponibilizada ao cliente para visualização de dados de seu ambiente e direcionamento para atualização, bem como para documentação do artefato selecionado.

3. Protheus

3.1. Instalação

A instalação da ferramenta no ambiente Protheus depende da aplicação de um pacote e seguir alguns pré-requisitos abaixo.

...

3.1.1. Release 12.1.27

A release 12.1.27 já tem a solução instalada em sua versão 1.0.4 não sendo necessário aplicação de nenhum pacote para implementação, somente de atualizações de novas versões quando existir.

3.1.2. Releases 12.1.25 e 12.1.23

Aplicar o pacote acima e Atualizar a Lib para o Label xxxxxx (expedida em fevereiro 2020) ou superior

3.1.3. Pré-requisitos

-Chave: MaxStringSize configurado com valor superior a 5 ou sem definição pois o padrão atende (Mais detalhes em https://tdn.totvs.com/x/oQCeCQ)

-Todos os dados são enviados para a URL https://api.tph.engpro.totvs.com.br senda que essa url deve estar liberado no servidor de aplicação, permitindo assim o appserver enviar dados para central de atualizações.

3.1.4. Parametrização

Caso queira mudar algum comportamento desta solução é possível fazer por meio de parâmetros (SX6) que devem se criados quando necessário.

-MV_ENGTPH1 -> Disponibiliza a aplicação apenas para usuários Administradores quando configurado como verdadeiro (.T.);

...

.T. (Habilitado)

.F. (Desabilitado) Valor padrão mesmo quando não configurado o parâmetro.

3.1.5. Limitação

3.2. Rotinas

               Acessando o menu miscelânea Central de Atualizações é possível ter acesso a solução pelas opções de menu abaixo.

3.2.1. Acessar

Opção para acessar a Central de Atualizações, ao clicar o sistema irá negociar um token com a e disponibilizar uma URL de acesso para visualizar no Browser que será aberto automaticamente, entretanto se isso não ocorrer é possível copiar a URL indicada e abrir manualmente.

(Print de tela aqui.)

3.2.2. Manutenção

Esta rotina permite que sejam feitas algumas manutenções:

-Re-envio imediato de todas as informações;

-Re-envio agendado de dados específicos;

(Print de tela aqui.)

3.2.3. Relatório de Log

Relatório de Logs de controle ferramenta. Podendo ser usado em caso de análise de erros.

(Print de tela aqui.)

3.2.4. JOB de Integração

Rotina de integração configurada na LIB, para rodar periodicamente e enviar dados do ambiente para central de atualizações. Os dados somente são enviados quando for identificado uma atualização no ambiente assim evitando processamento desnecessário.

Dados enviados:

-Código dos Patchs (.ptm) aplicados;

...

e

...

-Versões de LIB, AppServer e DbaAccess

-Data de Fontes do POR;

-Código TotvsId (Código da instalação do License Server);

4. Portinari/THF Cliente

...

Central

...

4.1. Acesso

O acesso sempre deve ser feito por dentro do Protheus, pois o token gerado tem validade de 20min e estra atrelado a um ambiente Protheus.

4.2. Geral

Abaixo serão descritos comportamentos e recursos genéricos desta solução.

-Busca Rápida: A opção de Busca rápida localizada no canto superior direito ou no canto superior esquerdo das páginas de detalhes, permite fazer uma pesquisa por parte de palavras ou códigos de acordo com a página. Está opção é mais pratica, entretanto o resultado pode ser um pouco mais lento.

-Busca Avançada : A opção de Busca Avançada no canto superior direito da página permite uma pesquisa exata, devendo ser passado o nome ou código exata do conteúdo procurado. Esta opção é mais restritiva e de retorno rápido.

-Ajuda: Todas as Páginas possuem uma opção de ajuda que detalha o Objetivo da página, os campos, as opções de pesquisa/filtro e quais as opções adicionais.

-Opções adicionais: As páginas podem possuir informações complementares e serão apresentadas sempre na última coluna da grade. Podendo ser “...” três pontos quando forem mais de uma opção ou diretamente o nome da opção adicional

4.3. Páginas

dsadsa

4.3.1. Home

dsadsa

4.3.2. Meu Ambiente

4.3.3. Atualizações Disponíveis

...

...

de

...

-Fonte: Nome do Fonte;

-Data Patch: Data da última versão disponível;

-Hora Patch: Hora da última versão disponível;

-Data RPO: Data do fonte no RPO;

-Hora RPO: Hora do fonte no RPO;

-Status: Avalia se está atualizado ou não, respeitando possíveis diferenças de compilação. Obs: Fontes com 1 hora exata de diferença serão considerados iguais;

...

Por fonte.

...

-Detalhes: Exibi os pacotes que contem o fonte e permite baixa-lo, o pacote da issue com o fonte mais atual e as expedições continuas que tiverem o fonte mais atualizado que no RPO.

4. Versões e Atualizações

...

Downloads

...

...

.

...

4.2. THF Cliente

...