...

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

 A expedição da linha Microsiga Protheus tem, ao longo dos anos, tentado se adaptar melhor às necessidades dos clientes, buscando formas de facilitar a entrega de correções e inovações. A mudança para o release incremental, a criação do UPDDISTR, os pacotes acumulados e outras formas de entrega foram desenvolvidas visando facilitar ao cliente a atualização de seu ambiente com as inovações da TOTVS. O desafio de entregar qualidade aos clientes é o guia das nossas ações e nos levou a desenhar uma nova forma de expedição do Microsiga Protheus, chamada de expedição contínua. 

2. Objetivos da expedição contínua 

Visto a constante evolução da linha Microsiga Protheus, a crescente complexidade dos módulos e as dificuldades atuais 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 semanal e disponibilizará aos clientes o estado mais atual das soluções presentes na solução. 

Para exemplificar este modelo, pode-se utilizar 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 teste automatizado e será disponibilizado aos clientes 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.

3. Módulos participantes

Em um primeiro movimento, foram selecionados dois produtos para a expedição contínua. São eles TAF e RH Protheus. Estes produtos foram escolhidos devido à grande demanda atual relacionada ao tema eSocial. Além disso, os produtos TAF e RH possuem características importantes que facilitam a expedição contínua e automatizada de seus respectivos pacotes. Estes produtos possuem uma maior independência em relação aos outros módulos do Protheus e apresentam uma fronteira bem definida de artefatos que compõe o pacote. 

Gradualmente, o processo de expedição contínua será expandido aos outros módulos e produtos Protheus. Durante este período de transição, as outras formas de expedição serão mantidas. Entretanto, a tendência é que os processos convirjam para a expedição contínua no médio prazo.

4. Composição do pacote

Cada um dos pacotes é composto pela lista completa de códigos-fonte do produto. No processo de criação do pacote, é considerada a última versão de cada um dos códigos-fonte que tenham passado pelo processo completo de teste até a data de corte. A data de corte é semanal e fixa, como apresentado no tópico Processo de Desenvolvimento.

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 produtos devem tomar uma das decisões a seguir:

 1.       Expedir o pacote gerado e testado;

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

Com isso, é possível que um pacote deixe de ser expedido em uma determinada semana 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, você será direcionado para o portal de DOWNLOADS E ATUALIZAÇÕES

Image Added

Para a linha de produtos selecione PROTHEUS, na sequencia

·         Selecione MICROSIGA PROTHEUS VERSÃO 12.1.17

·         Selecione ATUALIZAÇÕES PERIÓDICAS

Image Added

Serão exibidas todas as atualizações disponíveis.  Basta clicar 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.17 para ambiente em Português e Banco de Dados: 

18-07-10_ATUALIZACAO_12.1.17_RH_EXPEDICAO_CONTINUA_TTTP120.ZIP

18-07-10_ATUALIZACAO_12.1.17 _RH_EXPEDICAO_CONTINUA_tttp120.zip

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

...