1. Objetivo

Objetivo desse documento é explicar como funciona o uso e a expedição dos periódicos e acumulados. Será explicado como utilizar esses pacotes para ter um ambiente atualizado.

1.1. Como funciona a geração dos pacotes 

Os pacotes são gerados geralmente a cada 15 dias. Todos os pacotes acumulados e periódicos são gerados nos seguintes ambientes e idiomas: 

        Para releases da 12:

  1. Ambiente TOP CONNECT e idioma Português
  2. Ambiente TOP CONNECT e idioma Espanhol
  3. Ambiente TOP CONNECT e idioma Inglês
  4. Ambiente CTREE e idioma Português
  5. Ambiente CTREE e idioma Espanhol
  6. Ambiente CTREE e idioma Inglês
  7. Ambiente CODEBASE e idioma Português
  8. Ambiente CODEBASE e idioma Espanhol
  9. Ambiente CODEBASE e idioma Inglês 

       Para versão 11.80

  1. Todos os ambientes e idiomas da versão 12 e mais os abaixo:
  2. Ambiente ADS e idioma Português
  3. Ambiente ADS e idioma Espanhol
  4. Ambiente ADS e idioma Inglês


Na conclusão da geração do pacote é criado um arquivo .ZIP com o conteúdo abaixo: 

  1. Um arquivo CHAMADO.TXT com a lista as issues que compõem o pacote e o link da documentação de cada uma.
  2. Um arquivo CONTENTS.TXT com a lista dos fontes das issues que compõem o pacote.
  3. Um arquivo .PTM de um ambiente e idioma, com todos os fontes e outros arquivos necessários conforme a lista CONTENTS.TXT.
  4. Caso exista algum RDMAKEPADRAO que tenha sido utilizado em alguma Issue o(s) fonte(s) irá(ão) anexo(s).


São consideradas somente as patches no período disponibilizadas para Clientes, os patches emergências não são considerados. 

Para geração dos arquivos acima, usamos o calendário da área para saber o período dos pacotes. 

Por exemplo, para gerações quinzenais e acumulados da release 12.X.AB. O calendário começará no dia 01/01/2017.

Logo teremos as gerações abaixo: 


Gerações

Data de Geração

O que foi gerado?

Datas / Períodos

Primeira geração

16/01/2017

Quinzenal

01/01/2017 até 15/01/2017

Primeira geração

16/01/2017

Acumulado

01/01/2017 até 15/01/2017

Segunda geração

01/02/2017

Quinzenal

16/01/2017 até 31/01/2017

Segunda geração

01/02/2017

Acumulado

01/01/2017 até 31/01/2017

Terceira geração

16/02/2017

Quinzenal

01/02/2017 até 15/02/2017

Terceira geração

16/02/2017

Acumulado

01/01/2017 até 15/02/2017

Quarta geração

01/03/2017

Quinzenal

16/02/2017 até 28/02/2017

Quarta geração

01/03/2017

Acumulado

01/01/2017 até 28/02/2017



As gerações são realizadas no primeiro dia depois de cada período.

As expedições são realizadas em até 3 dias úteis depois da geração do pacote. 

Na primeira geração os pacotes acumulados e quinzenais serão iguais. A partir da segunda geração o acumulado possuirá os fontes da primeira geração mais os fontes da segunda geração e assim por diante, o quinzenal terá só os fontes aprovados conforme o período, por exemplo, o período de 15 dias utilizado na tabela acima.

1.2. Publicação dos pacotes gerados 

Os arquivos .ZIP são publicados em suas respectivas versões/releases e ambientes/idiomas. Eles sempre são substituídos pelos novos arquivos publicados. Não deixamos históricos dos pacotes no portal. 

A composição do nome do arquivo é: Data da Publicação + ATUALIZAÇÃO + Versão/Release + Área + Tipo Periodicidade + Período + Ambiente e Idioma.

1.3. Informações dos pacotes publicados 

Neste item vamos explicar quais informações compõem o arquivo publicado no pacote acumulado e o quinzenal (pode ser chamado de periódico também).


PACOTE QUINZENAL OU PERIÓDICO 

A seguir o detalhe de cada informação que compõem o nome do arquivo abaixo:


17-08-11_ATUALIZACAO_12.1.17_GERAL_QUINZENAL_24_07_2017_A_10_08_2017_TTTP120.ZIP


Data de Publicação = Data da realização da publicação.

Texto Padrão = O texto ATUALIZACAO é utilizado em todos os pacotes gerados com periodicidade.

Versão/Release = Os pacotes são separados por versão/releases.

Área = Os pacotes são separados por área, mas quando usamos o termo GERAL é que o pacote possui as correções de todos os módulos do Protheus.

Periodicidade = Os pacotes podem ter períodos distintos como por exemplo, Semanal, Quinzenal, Mensal, Trimestral e etc...

Período da Periodiciodade = Intervalo que foi utilizado para geração do pacote. No quadro abaixo, demosntramos a regra do período quinzenal.

Ambiente e Idioma = Indica qual é o ambiente e o idioma do pacote.


Abaixo a tela de um arquivo publicado no portal:


PACOTE ACUMULADO 

A seguir o detalhe de cada informação que compõem o nome do arquivo abaixo:


17-08-11_ATUALIZACAO_12.1.17_GERAL_ACUMULADO_19_07_2016_A_10_08_2017_TTTP120.ZIP


Data de Publicação = Data da realização da publicação.

Texto Padrão = O texto ATUALIZACAO é utilizado em todos os pacotes gerados com periodicidade.

Versão/Release = Os pacotes são separados por versão/releases.

Área = Os pacotes são separados por área, mas quando usamos o termo GERAL é que o pacote possui as correções de todos os módulos do Protheus.

Periodicidade = Os pacotes podem ter períodos distintos como por exemplo, Semanal, Quinzenal, Mensal, Trimestral e etc...

Período da Periodiciodade = Intervalo que foi utilizado para geração do pacote. No quadro abaixo, demosntramos a regra do período quinzenal.

Ambiente e Idioma = Indica qual é o ambiente e o idioma do pacote.


Abaixo a tela de um arquivo publicado no portal:

1.4. Como encontrar os pacotes no Portal do Cliente 

No site https://suporte.totvs.com/portal/p/10098/home e na sessão DOWNLOADS E ATUALIZAÇÕES os arquivos podem ser  pesquisados pela categoria ou pelo nome do arquivo, isso dentro de cada versão/release. 

A pesquisa pode ser feita pela categoria PATCHES ACUMULADOS.

Para habilitar a opção categoria é necessário selecionar a linha de produto Protheus e depois selecionar uma versão/release. 

Abaixo a tela de exemplo da pesquisa.:

A pesquisa pode ser feita pelas palavras QUINZENAL ou ACUMULADO.

Abaixo a tela de exemplo da pesquisa:

1.5. Atualização dos pacotes 

Para deixar seu ambiente atualizado, recomendamos que use os pacotes acumulados ou quinzenais para realizar as atualizações do repositório (.RPO) periodicamente.

Sempre atualizar o seu ambiente com os pacotes de correção recebido pelo seus Tickets e a cada 15 dias aplicar o pacote acumulado ou quinzenal que contém as outras correções que foram abertas por outros Clientes. 

Se não há o uso regular dos pacotes pacotes quinzenais, sugerimos a utilização do pacote acumulado. 

No momento da aplicação do pacote no ambiente é obrigatório sempre utilizar a opção “aceitar somente os fontes mais atuais”. 

As atualizações podem ser feitas conforme cenários abaixo. Os exemplos estão até a quarta atualização, mas na realizada pode ter mais atualizações.


1º Cenário


Atualizações?

Pacote para Aplicação?

Primeira atualização

Utilizar o pacote periódico (quinzenal por exemplo)

Segunda atualização

Utilizar o pacote periódico (quinzenal por exemplo)

Terceira atualização

Utilizar o pacote periódico (quinzenal por exemplo)

Quarta atualização

Utilizar o pacote periódico (quinzenal por exemplo)



2º Cenário


Atualizações?

Pacote para Aplicação?

Primeira atualização

Utilizar o pacote periódico (quinzenal por exemplo)

Segunda atualização

Utilizar o pacote acumulado

Terceira atualização

Utilizar o pacote acumulado

Quarta atualização

Utilizar o pacote acumulado



3º Cenário


Atualizações?

Pacote para Aplicação?

Primeira atualização

Utilizar o pacote acumulado

Segunda atualização

Utilizar o pacote acumulado

Terceira atualização

Utilizar o pacote acumulado

Quarta atualização

Utilizar o pacote acumulado




4º Cenário


Atualizações?

Pacote para Aplicação?

Primeira atualização

Utilizar o pacote acumulado

Segunda atualização

Utilizar o pacote periódico (quinzenal por exemplo)

Terceira atualização

Utilizar o pacote periódico (quinzenal por exemplo)

Quarta atualização

Utilizar o pacote periódico (quinzenal por exemplo)