...

1.

...

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: 

 A evolução da expedição Protheus

Para melhor atender os seus clientes, a TOTVS vem buscando, ao longo dos anos, a melhor forma de realizar a expedição da linha Microsiga Protheus, com o objetivo de facilitar a entrega de correções e inovações do produto.

A mudança para o release incremental, a criação do UPDDISTR, os pacotes acumulados e outras formas de entrega, foram desenvolvidos visando facilitar para o cliente, a atualização de seu ambiente com as inovações da TOTVS.

O desafio de entregar qualidade aos nossos clientes, norteou as nossas ações e nos levou a desenhar uma nova forma de expedição, chamada de Expedição Contínua Protheus. 

2. Objetivos da expedição contínua 

Visto a constante evolução da linha Microsiga Protheus, a crescente complexidade dos módulos e os desafios dos clientes, criou-se um novo processo de expedição, baseado na divisão do Protheus em seus diversos segmentos.

Este novo processo de expedição terá uma frequência quinzenal e disponibilizará aos clientes o estado mais atual das soluções. 

Para exemplificar este modelo, utilizaremos o RH e seus módulos: Gestão de Pessoal, Ponto Eletrônico, Recrutamento e Seleção etc.

Semanalmente, o estado completo e mais atual destes módulos passará por um processo de execução de testes automatizados e, em seguida será disponibilizado para download como um pacote único. Assim, o cliente poderá atualizar apenas os módulos que fazem parte do seu processo de trabalho e a TOTVS garantirá a consistência do pacote disponibilizado.

Com esta nova forma de expedir, buscaremos reduzir a quantidade dos modos atuais de expedição, limitando-os a dois processos: release semestral e Expedição Contínua Protheus.

3. Módulos participantes

O calendário oficial lista os módulos participantes, bem como a sazonalidade prevista de expedição e a documentação especifica de cada pacote. 

A previsão e publicação dos pacotes é de escolha do Responsável pelo Produto e excepcionalmente, uma publicação pode ser adiada para a próxima janela, de acordo com sua avaliação. 

Calendário Oficial - Atualizado em Setembro/2020

4. Composição do pacote

Cada um dos pacotes é composto por um arquivo de atualização (patch) contendo a lista completa de códigos fontes do módulo e, eventualmente, podem conter outros arquivos, caso o módulo necessite, como RDMAKES, arquivos de configuração e/ou arquivos magnéticos e etc. Estes arquivos caso existam, serão encontrados dentro de uma pasta de arquivos compactados dentro do pacote.

No processo de criação do pacote, sempre é considerada a última versão de cada um dos códigos fontes que tenham passado pelo processo completo de teste até a data de corte. A data de corte é fixa e segue um calendário interno separando os módulos conforme sua sazonalidade.

5. Autorização da expedição 

A fase final da expedição é baseada na análise dos resultados da execução dos testes automatizados, a partir da análise dos resultados, os responsáveis por cada um dos módulos devem tomar uma das seguintes decisões.

1. Expedir o pacote gerado e testado;
2. Não expedir o pacote gerado e testado.

Desta forma, é possível que um pacote deixe de ser expedido em uma determinada data, caso os resultados não sejam satisfatórios.

6. Publicação

Os pacotes da expedição contínua serão disponibilizados sempre nos mesmos links do Portal do Cliente e apenas o último pacote publicado estará disponível.

Para download dos pacotes deve-se acessar a Central de Relacionamentos TOTVS e efetuar o login.

https://totvscst.zendesk.com/hc/pt-br/#home

Image Added

Selecione a opção Downloads e você será direcionado para o portal de Downloads e Atualizações.

Image Added

Para a linha de produtos selecione Protheus, na sequência:

• Selecione MICROSIGA PROTHEUS VERSÃO 12.1.23.
• Selecione ATUALIZAÇÕES PERIÓDICAS.

Image Added

Serão exibidas todas as atualizações disponíveis.

Clique em um item para executar o download.

<AA-MM-DD>_ATUALIZACAO_<release>_<identificador>_EXPEDICAO_CONTINUA_<patch>.zip

Onde: 

<AA-MM-DD>: Data da expedição no formato ano-mês-dia

ATUALIZACAO: Fixo para identificar que é uma atualização

<release>: Release a que se refere a expedição

<identificador>: Identificador do pacote, exemplo: RH, TAF, GFE, etc.

EXPEDICAO_CONTINUA: Fixo para identifica o tipo da expedição

<patch>: Tipo de patch do Protheus, variando o ambiente e idioma

Exemplo, para uma expedição do RH da versão 12, release 12.1.23 para ambiente em Português e Banco de Dados: 

19-04-13_ATUALIZACAO_12.1.23 _RH_EXPEDICAO_CONTINUA_tttp120.zip

<style>
div.theme-default .ia-splitter #main {
    margin-left: 0px;
}
.ia-fixed-sidebar, .ia-splitter-left {
    display: none;
}
#main {
    padding-left: 10px;
    padding-right: 10px;
    overflow-x: hidden;
}

.aui-header-primary .aui-nav,  .aui-page-panel {
    margin-left: 0px !important;
}
.aui-header-primary .aui-nav {
    margin-left: 0px !important;
}

.aui-tabs.horizontal-tabs>.tabs-menu>.menu-item.active-tab a::after { 
	background: #FF9900; !important 
}

.menu-item.active-tab { 
	border-bottom: none !important; 
}

</style>

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:

Image Removed

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:

Image Removed

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

Image Removed

A pesquisa pode ser feita pelas palavras QUINZENAL ou ACUMULADO.

Abaixo a tela de exemplo da pesquisa:

Image Removed

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

2º Cenário

3º Cenário

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

...