Fechamento do branch e liberação de versões
Descrição dos processos à serem realizados para realizar a liberação e fechamento do Branch da Versão corrente.
- Definição do Processo
- [padronizar] Decisão do fechamento do Branch da Versão e publicação para a equipe
- [padronizar] Atualização dos arquivos "Config.ini"
- [padronizar] Atualização dos arquivos Altver.rtf
- [padronizar] Commit das alterações dos arquivos "Config.ini" e "Altver.rft"
- Solicitando ao desenvolvedor a inclusão do Branch da versão no Trunk
- [padronizar] Geração de executáveis para liberação das versões
- [padronizar] Geração dos instaladores (setups) das versões
- [padronizar] Publicação dos executáveis e instaladores
- [padronizar] Finalização do fechamento do Branch da Versão
- [padronizar] Geração de Customizações (DLLs) para liberação das versões
Definição do Processo
A decisão de quando um Branch da Versão deve ser fechado deve ser tomada em conjunto com as equipes de Desenvolvimento e Qualidade, levando em consideração:
- Quantos casos já estão vinculados ao Branch;
- Quanto tempo faz desde a última liberação de um Branch da Versão;
- Qual a prioridade de entrega dos casos já vinculados ao Branch atual;
A liberação das versões é feita semanalmente (segmento ERP na sexta-feira e segmento FISCO na segunda ou terça feira) e com uma quantidade de casos vinculados ao Branch não muito grande, de preferência com até no máximo 15 casos (deve-se levar em consideração a complexidade dos casos, criação de campos, criação de tabelas, etc.) ou até quinze dias após a liberação do Branch anterior, quando a quantidade de casos finalizados e vinculado ao Branch na primeira semana for pequena ou com casos com prioridade baixa para entrega.
O pré-requisito para início do fechamento do Branch da Versão é alinhar com toda a equipe de Desenvolvimento e Qualidade que o mesmo será fechado e, para iniciar de fato o fechamento, todos os casos vinculados ao Branch já devem estar com a revisão de testes feita e com o status "Aguardando liberação de versão".
Envolvidos no processo
Sempre será uma dupla que ficará responsável pela abertura, manutenção e fechamento do Branch da Versão, sendo um desenvolvedor e um testador.
Etapas do processo
- Decisão do fechamento do Branch da Versão e publicação para a equipe [padronizar o documento da etapa]
- Atualização dos arquivos Config.ini [padronizar como um sub processo do gerenciamento de branch de versões (usado na abertura e fechamento do branch)]
- Atualização dos arquivos Altver.rtf [padronizar como um sub processo do fechamento do branch da versão]
- Commit das alterações dos arquivos Config.ini e Altver.rtf [padronizar como um sub processo do fechamento do branch da versão]
- Geração dos executáveis para liberação de versão [padronizar como um sub processo não relacionado (é utilizado em outros processos)]
- Validação dos executáveis [linkar com o sub processo que será criado]
- Incluir o Branch da Versão no Trunk [padronizar o documento da etapa]
- Compactação dos executáveis [linkar com o sub processo que será criado]
- Assinatura dos executáveis [linkar com o sub processo que será criado]
- Geração dos instaladores/setups [padronizar como um sub processo do fechamento do branch da versão]
- Publicação dos exes e instaladores [padronizar como um sub processo do fechamento do branch da versão]
- Finalização e fechamento do Branch da Versão
Ponto inicial do processo
O início do processo do fechamento do Branch da Versão deverá começar com alguns dias de antecedência em relação à data pretendida para o fechamento do mesmo, a partir dessa decisão, deverá ser comunicado à equipe de Desenvolvimento e Qualidade para que não seja vinculado mais nenhum caso adicional ao Branch. Após todos os casos do Branch terem a revisão de testes realizadas e estarem como "Aguardando liberação de Versão", poderá ser dado início ao fechamento e liberação.
Ponto final do processo
O processo poderá ser considerado como concluído após a publicação dos executáveis e instaladores e a finalização do fechamento do Branch da Versão.
Resultado esperado
Concluir o ciclo de vida útil do Branch da Versão atual, gerando os executáveis e instaladores dos módulos para que possam ser disponibilizados aos clientes.
[padronizar] Decisão do fechamento do Branch da Versão e publicação para a equipe
Avisando a equipe sobre o fechamento do Branch e conferência se o mesmo pode ser fechado
Após ser definido que o Branch da Versão será fechado, deve-se avisar à equipe de Desenvolvimento e Qualidade para que não subam mais nenhum tratamento e/ou façam alterações no Branch. Para isso, no Rocket Chat (ferramenta utilizado internamente para comunicação) no canal "devs-quali-erp" ou "devs-quali-fisco" deve ser enviada uma mensagem padrão, conforme exemplo abaixo:
"Pessoal,
Por favor, não subir mais nenhum tratamento para o Branch XXX.
Irei começar a fazer a liberação dos módulos.
Obrigado!"
Após comunicar a equipe sobre o fechamento da versão, confirmar no Mantis se todos os casos vinculados ao Branch foram realizados os testes e revisão de testes e se estão com o status "Aguardando liberação de versão". Confirmar também se todos os casos do versionamento dos módulos que serão liberados foram vinculados ao caso do Branch, conforme exemplo abaixo:
O quadro em verde está demonstrando todos os casos de versionamento de módulos e que serão liberados no Branch da Versão. Neste exemplo, no Branch 041 serão liberados os módulos Vendas e Compras.
No quadro em vermelho estão todos os casos de erros, solicitações ou melhorias que estão relacionados ao Branch 041 e que serão entregues através dos módulos de Vendas e Compras.
Os casos de versionamento de módulos que serão relacionados ao Branch da Versão dependerão dos casos de erro, solicitação ou melhorias que serão liberados. Se no Branch houver apenas casos do Financeiro, por exemplo, não há necessidade de liberação dos demais módulos, a não ser que para correção de algum destes casos seja necessária alguma correção em uma unit comum, nesta situação precisarão ser liberados todos os módulos que fazem uso da unit em questão.
Casos de versionamento de DLLs também devem ser vinculados ao caso do Branch da Versão.
[padronizar] Atualização dos arquivos "Config.ini"
Os arquivos "Config.ini" são os arquivos onde informamos o número do caso pai (caso de versionamento das versões), número da versão e data de liberação dos módulos, portanto é necessário atualizar estes arquivos à cada liberação de versão.
Antes de começar a atualizar estes arquivos precisaremos realizar o Update, Merge e Commit do Branch da versão, para saber como realizar cada uma destas etapas, clique aqui e em seguida siga os passos abaixo para atualização dos arquivos:
Na pasta do Branch da Versão (Exemplo "C:\Caso-BranchVersão-0044433"), acessar "WorkingCopies > Sistemas", conforme exemplo:
No quadro "Pesquisar Sistemas" digitar "config.ini" para que sejam filtrados apenas os arquivos que contenham esse nome e extensão:
Selecionar os arquivos de todos os módulos que serão liberados, clicar com o botão direito do mouse e em seguida clicar em "Edit with Notepad++":
Neste exemplo faremos a liberação do Branch 041, portanto serão liberados apenas os módulos de Compras, Vendas e NFe.
Os arquivos serão abertos com o aplicativo do Notepad++, conforme demonstrado abaixo. Em todos os arquivos será necessário atualizar os campos "CasoPai", "DataLiberacao", "Versao1" e "Versao2". Após atualizar os campos clicar no botão "Salvar":
Caso Pai
Caso do versionamento do módulo, no Branch 41 o caso pai do módulo de Vendas é o 0044227, por exemplo.
Data Liberação
Data que serão compilados os executáveis para liberação.
Versao1
Preencher com o número da versão anterior ao "ponto". No exemplo do Branch 041 será liberada a versão 6.555 do Vendas, portanto o campo "Versao1" deve ser preenchido com "6".
Versao2
Preencher com os números após o ponto. No exemplo da versão 6.555, preencher o campo "Versao2" com "555".
Atenção: Somente para o arquivo do módulo NE é necessário preencher também os campos "Versao1Principal" e "Versao2Principal".
O módulo NE utiliza as mesmas configurações do projeto do Vendas, portanto o arquivo "Config.ini" do NE deve apontar qual a versão principal do módulo do Vendas que ele estará vinculado.
No exemplo da liberação do Branch 41, que iremos liberar a versão 6.555 do Vendas, os campos deverão ser preenchidos da seguinte forma:
[padronizar] Atualização dos arquivos Altver.rtf
Geração do arquivo "Altver.rtf"
O que são os arquivos "Altver"?
Os arquivos "Altver" contém as informações do que será liberado em cada versão. Existem versões que apenas trataram ajustes/erros no sistema e outras versões que além de correções de erro, liberam também alguma melhoria do sistema, novo recurso, etc, então os mesmos precisarão ser preenchidos de acordo com essas informações.
Geração dos arquivos:
O arquivo deverá ser criado sempre através do WordPad, devendo conter o número da versão que será liberada e quais as implementações da versão, conforme exemplos abaixo:
Exemplo de arquivo Altver onde foram realizados apenas ajustes ou correções de erro no sistema:
Exemplo de arquivo Altver onde houveram melhorias no sistema:
Para o módulo NFE não é necessário criação do arquivo Altver, pois utilizará o mesmo arquivo que o módulo de Vendas.
Atualização dos arquivos "Altver.rft" no SVN e módulos
Após gerar os arquivos Altver de todos os módulos que serão liberados, será necessário atualizá-los no SVN e no projeto de cada módulo.
Atualização dos arquivos Altver no SVN
Para isso, acessar a pasta do Branch da Versão e em seguida "WorkingCopies > Sistemas > Vendas", por exemplo. Deverá eliminar o arquivo "Altver.rtf" já existente e substituir pelo novo arquivo gerado, mantendo a nomenclatura "Altver.rtf":
Esse processo deverá ser repetido para todos os módulos que serão liberados, exceto o módulo NFE, que utilizará o mesmo arquivo que o módulo Vendas.
O arquivo "AltverNE.rtf" não deve ser excluído ou substituído.
Atualização dos arquivos Altver nos módulos (projetos)
Após fazer a substituição do arquivo "Altver.rtf" da pasta de cada um dos módulos que serão liberados, será necessário alterar o projeto de cada um dos módulos para que ele passe a "enxergar" o novo arquivo adicionado. Para isso deveremos acessar a pasta "project" e executar o programa "VD.dproj":
O projeto do módulo que executou, "VD.dproj", "CC.dproj", "FN.dproj" (...) será aberto aberto no Delphi:
Na tela do Delphi, utilizar o comando "CTRL + F12" para abrir a tela de pesquisa de units "Search for units". No campo de pesquisa digite "altver", em seguida selecione a unit "ALTVER1.pas" e clique em "OK". Será aberta a unit "ALTVER1" em uma nova aba:
Clicar na aba "VD", pesquisar novamente por "altver" e agora selecionar a primeira opção, "AltVer.pas". Clicar em "OK" e será aberta uma nova aba com a unit "AltVer":
A ordem de abertura das units sempre devem seguir o padrão "ALTVER1.pas" e depois "AltVer.pas" por motivos relacionados ao código(herança).
Na unit "AltVer" aperte a tecla F12 do teclado e será aberta a tela "Correções e Implementações da Versão Corrente":
Observar que por enquanto o número da versão e as implementações não foram atualizadas.
Clicar com o mouse dentro do quadro "Correções e Implementações da Versão Corrente" para selecioná-lo e em seguida, nas propriedades do canto inferior esquerdo da tela, clicar no DLG da propriedade "LoadRTF". Será aberta uma tela para buscar o arquivo à ser importado:
Na tela "Selecione um RTF", certifique-se de que está dentro da pasta do projeto correto, ou seja, do mesmo projeto que estiver fazendo as alterações no Delphi e então selecione o arquivo "Altver.rtf" e clique em "Abrir".
Após importar o novo arquivo "Altver.rft", verifique que no quadro "Correções e Implementações da Versão Corrente" o número da versão e o conteúdo serão atualizados conforme o arquivo importado. Clique no botão "Salve All (Shift+Ctrl+S)" para salvar o projeto e em seguida pode fechar o Delphi:
O altver do NE é atualizado dentro do projeto do VD pela parte lateral "PagesControl1" onde tem os dois altver "TS_ALTVER" e "TS_ALTVERNE":
É só clicar no "TS_ALTVERNE" e selecionar o arquivo AltverNE.rtf conforme feito nos demais projetos:
[padronizar] Commit das alterações dos arquivos "Config.ini" e "Altver.rft"
Após realizar a atualização dos arquivos "Config.ini" e "Altver.rft" é necessário commitar essas alterações, ou seja, subir as alterações que foram realizadas por enquanto somente em sua máquina para o código fonte do Branch da Versão.
Clique com o botão direito do mouse na pasta do Branch da Versão, exemplo "Caso-BranchVersão-0044433" e em seguida em "SVN Commit":
No quadro das mensagens deverá ser incluída uma mensagem padrão, contendo o Branch da Versão que será liberado, quais casos de versões estão relacionados à ele e quem está realizando o commit (caso esteja utilizando por uma máquina virtual), conforme exemplo abaixo:
No quadro "Changes made" deverão ser selecionados os arquivos que foram modificados e que deverão ser commitados:
Deverão ser selecionados apenas os arquivos com extensões ".dfm", ".Config.ini" e ".rtf".
Dica: Clique no campo "Extension" para que os arquivos sejam ordenados por extensão, assim facilitará selecionar somente os arquivos das extensões ".dfm", ".Config.ini" e ".rtf".
Após selecionar os arquivos que deverão ser commitados, clicar em "OK". Será aberta a tela abaixo para realização do commit, após finalizar clicar em "OK":
Pronto, as alterações foram salvas e enviadas ao código fonte do Branch da Versão.
Solicitando ao desenvolvedor a inclusão do Branch da versão no Trunk
Após concluir a revisão de teste de todos os casos que foram incluídos no branch da versão e a atualização dos arquivos "config.ini" e "altver.rtf", uma anotação solicitando a inclusão do branch da versão no trunk deverá ser enviada para o desenvolvedor responsável no Mantis. Informando os módulos que foram alterados e os casos que foram tratados.
A anotação de solicitação deverá seguir o seguinte padrão:
A anotação não só ajuda na conferência dos arquivos altver e config.ini antes do commit, como facilita muito a busca por casos no SVN quando necessário buscar um tratamento de uma determinada versão.
[padronizar] Geração de executáveis para liberação das versões
Compilando os executáveis
Para gerar os executáveis que faremos a liberação, deveremos acessar a pasta do projeto dentro do Branch da Versão, exemplo (C:\Caso-BranchVersão-0044433\WorkingCopies\Sistemas\SSVendas\project) e em seguida abrir o arquivo ".dproj":
Será aberto o Delphi, digitar "Shift+F9" para abrir a tela "Configurações de Compilação". Selecione qual a Empresa (ambiente) será gerado o executável e confira se os campos "Caso Pai", "Data de liberação" e "Versão" estão corretos. No quadro "Diretório" selecione onde o executável deverá ser salvo e então clique em "OK (F5)":
Será exibida a tela "Information". Clique em "Yes to All" e em seguida em "OK":
Será iniciada a compilação do executável:
Quando a compilação for finalizada, no canto inferior esquerdo será exibida a mensagem "Sucess" e o tempo de compilação:
Verifique que o executável terá sido gerado dentro do diretório indicado anteriormente. Confirmar se o executável foi gerado corretamente de acordo com as opções selecionadas, observando as informações de "Data de modificação", "Marcas Registradas", "Nome do produto" e "Versão do produto":
Até aqui fizemos a compilação do executável do Vendas apenas para o ambiente Nooven, então precisaremos compilá-lo ainda para o ambiente SuperSoft e depois compilar os executáveis das demais versões que serão liberadas. Para não perder os executáveis que já geramos e ir fazendo a separação, é aconselhável criar os diretórios "SS", "NV" e "EC" e ir alocando os executáveis gerados em cada uma dessas pastas, conforme o ambiente do executável:
Recortar o executável e colá-lo dentro da pasta do ambiente correspondente. Neste exemplo, "NV":
Agora compilaremos o executável do Vendas para o ambiente Supersoft. Voltar no Delphi, digitar "Shift+F9", selecionar a empresa "SuperSoft" e clicar em "OK (F5)" e seguir os passos:
Observar que agora terá sido gerado o executável do ambiente "SuperSoft". Recortar e colar o executável dentro da pasta do diretório correspondente:
Os passos acima deverão ser realizados para todos os executáveis que serão liberados.
O módulo NE estará dentro do projeto do Vendas, para compilá-lo deverá executar o arquivo "NE.dproj".
Para os módulos "NE" e "FN" é necessário compilar também os executáveis para o ambiente E-Contab.
Observação: Caso tenha o Delphi instalado em sua máquina e não esteja fazendo a compilação por uma máquina virtual, no quadro "Compactador" pode assinalar a opção "AsPack" (se tiver o programa instalado na máquina) para que os executáveis já sejam compilados compactados.
Validação das informações dos executáveis
Conferência dos executáveis
Após todos os executáveis terem sido compilados, se o processo tiver sido realizado pela máquina virtual será necessário copiar estes executáveis para sua máquina local para que possa compactá-los.
Copie as pastas referentes à cada ambiente que foram criadas na máquina virtual e que estão com os executáveis que foram gerados e cole em sua máquina local.
Máquina virtual:
Máquina local:
Validação das informações na abertura dos executáveis
Copiar os executáveis para o local da instalação dos sistemas SuperSoft e executá-lo para abertura do sistema:
Verifique se a versão que será exibida e se nome, ambiente e versão do sistema estarão corretos:
Após atualizar o sistema, acessar o menu "Ajuda > Sobre" e verificar se o número da versão, data da liberação e número do caso pai estarão corretos (dados do arquivo "Config.ini"):
Em seguida acesse o menu "Ajuda > Correções e Implementações da Versão" e confira se a versão e as implementações/melhorias estão corretas (dados do arquivo "Altver.rtf"):
Validação das informações do executável (propriedades)
Clique com o botão direito do mouse no executável e em seguida clique me "Propriedades". Será aberta a tela com as propriedades do executável:
Clique na aba "Detalhes" e confira se os dados "Descrição do arquivo", "Versão do arquivo", "Nome do produto", "Versão do produto", "Direitos autorais" e "Marcas registradas" estarão corretos:
Exemplo de dados das propriedades do módulo Vendas do ambiente Supersoft.
Exemplo de dados das propriedades do módulo Vendas do ambiente Nooven.
Os passos acima deverão ser realizados para todos os módulos que serão liberados e para todos os ambientes.
Após conferir os executáveis de todos os módulos e se todos estiverem certos, ou seja, se não houver a necessidade de compilar nenhum dos executáveis novamente, deverá ser adicionada uma anotação no Mantis, no caso do Branch da Versão solicitando ao desenvolvimento que subam o Branch da Versão para o Trunk. Na anotação devem ser listados todos os casos relacionados ao Branch, ou seja, todos os "casos pai (casos de versionamento dos módulos)" e todos os casos que serão liberados de correção, melhoria e/ou solicitação:
Seguir a estrutura:
Casos pai (versionamento do módulo)
Casos filho (casos relacionados ao módulo acima e que serão entregues através da liberação do módulo)
Incluindo Branch da versão no Trunk
Desenvolvedor, fazer a Inclusão Branch da versão no Trunk
Compactação dos executáveis
Depois de conferir todos os executáveis gerados, caso tenha feito a compilação por uma máquina virtual será necessário compactá-los.
Para isso deverá abrir o programa "ASPack" e clicar em "Open" para selecionar os executáveis que serão compactados:
Ao clicar em "Open" será aberta a tela "Select file to compress". Se os executáveis estiverem organizados nas pastas de cada ambiente, conforme instruções anteriores, selecione a pasta "SS", por exemplo, e dentro dela selecione todos os módulos e clique em "Abrir":
O programa começará a compactar os arquivos. Aguardar até que a compactação seja finalizada (quando finalizar o programa "ASPack" será encerrado automaticamente):
Quando o aplicativo do "ASPack" for finalizado, verificar que o tamanho dos executáveis terá diminuído significativamente.
Esse processo deverá ser executado para todos os módulos de todos os ambientes que serão liberados.
Assinando os executáveis
Após ter compactado todos os executáveis será necessário assiná-los. Para isso precisará ter em mãos o certificado digital da SuperSoft, portanto, caso não esteja com ele, deverá pegá-lo (normalmente estará com a equipe da qualidade ERP ou Fisco).
Com o certificado já plugado na máquina, execute o programa "Assinador de Arquivos", disponível no caminho (\\ss\qualidade\Compilador\Assinador de exe):
Clique no botão "Add Arquivos" e será aberta a tela "Arquivos Executáveis". Selecione todos os executáveis e clique em "Abrir":
Os executáveis do ambiente E-Contab NÃO devem ser assinados!
Todos os executáveis que foram selecionados serão listados, então clique no botão "Assinar" para iniciar a assinatura:
O sistema irá solicitar a senha do certificado para que os executáveis sejam assinados. Preencher a senha "sS2019"
Após assinar os executáveis, o programa "Assinador de arquivos" adicionará um "OK" na frente de cada um dos executáveis selecionados e que foram assinados:
Para conferir se todos os executáveis foram assinados corretamente, verifique se nas "Propriedades" de cada um dos executáveis foi adicionada a aba "Assinaturas Digitais":
[padronizar] Geração dos instaladores (setups) das versões
Após todos os executáveis terem sido compilados, conferido se as informações estão corretas, compactados e assinados, deverão ser gerados os setups de instalação dos executáveis.
Atenção! Se houver a necessidade de atualização ou criação de algum arquivo padrão para a instalação dos sistemas (setup), é necessário disponibilizar o arquivo no caminho (\\131.72.202.226\centralop\INNO_FIREDAC) antes de iniciar a geração dos instaladores.
Acessar o caminho "\\ss\qualidade\FERRAMENTAS" e abrir o programa "GeradorSetupVersao2":
Clicar no "DLG" para abrir a tela de pesquisa "Abrir Executável". Selecione o primeiro executável para geração do setup de instalação e então clique em "Abrir":
As informações referentes ao módulo que foi selecionado serão preenchidas, confira se tudo está correto e então clique em "Processar":
Será aberta a tela:
Aguardar até que seja exibida a mensagem abaixo. O executável será salvo no caminho indicado no campo "Caminho para geração da instalação":
Os setups de instalação deverão ser gerados para todos os módulos dos ambientes SuperSoft e E-Contab. Para o ambiente Nooven não há necessidade de geração dos setups.
Para os executáveis ERP, durante a liberação do Branch da Versão NUNCA clique na opção "Publicar", pois este comando fará a publicação na Central de Operações.
Assinatura dos instaladores
Após todos os instaladores terem sido gerados, será necessário assiná-los. É o mesmo processo que vimos no tópico "Assinado os executáveis", alterando apenas que agora ao invés de selecionar os executáveis, selecionaremos os instaladores.
O setup do módulo "AP - Preços" não fica como "assinado", então não é necessário assiná-lo.
Para os instaladores do ambiente E-Contab NÃO deve ser feita a assinatura.
[padronizar] Publicação dos executáveis e instaladores
Após todos os executáveis e instaladores dos módulos que serão liberados terem sido gerados e assinados, será necessário publicá-los no Mantis, FTP e no diretório da Qualidade.
Publicação no diretório da Qualidade (\\ss\qualidade\LIBERADO_VERSOES_EXECUTAVEIS):
Primeiramente deverá ser criada uma pasta para cada módulo que será liberado, seguindo o padrão "Número do caso pai_Versão_Número da Versão_liberado_data da liberação", conforme exemplo: "0044227_Versão_6.555_liberado_08-01-2021". Dentro dessa pasta deverão ser criadas uma pasta para cada ambiente que será liberado, no exemplo do módulo de Vendas, uma pasta "SS" e outra pasta "NV":
O arquivo "Altver" referente ao módulo também deverá ser incluído nesta pasta, com o padrão "Altver+módulo (neste exemplo, AltverVD)":
Dentro da pasta de cada ambiente deverá ser salvo o executável correspondente:
Este processo deverá ser realizado para todos os módulos que serão liberados.
Após os passos acima serem realizados, copiar a pasta de cada um dos módulos que foram criadas, acessar o caminho "\\ss\qualidade\LIBERADO_VERSOES_EXECUTAVEIS" e colá-las dentro das pastas dos respectivos módulos:
Publicação no FTP
Renomear as pastas dos módulos para o padrão "Módulo_Versão", conforme exemplo: "VENDAS_6.555":
Em seguida, em todas as pastas delete o arquivo "Altver" de cada uma delas:
Em seguida, na pasta de cada um dos ambientes deverá ser incluído o Setup de instalação (quando houver) e renomear os executáveis:
Os executáveis deverão respeitar o padrão:
Executáveis SS: Manter apenas a abreviatura do módulo, exemplo: VD, CC, FN, etc.
Executáveis NV: Abreviatura do módulo_sigla NV, exemplo: VD_NV, CC_NV, FN_NV, etc.
Executáveis EC: Abreviatura do módulo_sigla EC, exemplo: NE_EC e FN_EC.
Após realizar os passos acima para todos os módulos, copiar as pastas e acessar o caminho "ftp://ftp.supersoft.com.br:2021/pub/SISTEMAS/". Deletar as pastas já existentes dos módulos que serão liberados e substituí-las pelas pastas com as novas versões:
Publicação no Mantis
No Mantis a publicação dos módulos liberados deverá ser apontada em cada um dos casos pai (casos de versionamento dos módulos) que estão vinculados ao Branch que está sendo liberado.
Nos casos do Mantis deverão ser anexados os executáveis de cada um dos ambientes de cada módulo e os instaladores, seguindo o padrão de mensagem:
*Adicionar usuários do Suporte, Projetos, Comercial e Qualidade na anotação
MÓDULO XX.XXX (Número da versão)
Data de liberação: DD/MM/AAAA
Ambientes: SuperSfot / Nooven (Adicionar E-Contab quando for liberação dos módulos NE e FN).
** VERSÃO NÃO LIBERADA NA CENTRAL DE OPERAÇÕES **
Executáveis disponíveis em:
- ftp://ftp.supersoft.com.br:2021/pub/Sistemas/
- Anexo ao caso
Suporte, Projetos e Comercial,
Favor verificar os casos vinculados a versão e atualizar os clientes que necessitam da atualização.
Obrigado.
*Anexar os executáveis e instaladores (detalhar à qual ambiente se referem).
Abaixo segue exemplo de preenchimento no Mantis (caso 44228):
Observação: Quando houver casos onde foram criadas ou alteradas DLLs de algum cliente, é necessário vincular o caso de versionamento da DLL ao caso do Branch e seguir o mesmo procedimento de publicação para o caso de versionamento da DLL. Abaixo exemplo da mensagem de publicação em casos de DLL:
*Adicionar usuários do Suporte, Projetos, Comercial e Qualidade na anotação
CustomXX Nome_do_Cliente (XX = módulo, exemplo CustomVD, CustomFN, CustomCE, etc).
Versão: 5.00 (sempre incremental a partir de 5.00)
Data de liberação: DD/MM/AAAA
Liberar em conjunto com: SSmodulo XX.XXX (Módulo e versão do módulo que deverá ser atualizado em conjunto).
DLL disponível em:
- \\ss\transfer\SISTEMAS\DLLS_NOVO_SKIN (colar a DLL neste caminho, dentro da pasta do respectivo cliente)
- Anexo ao caso.
Qualquer duvida estou a disposição.
Obrigado.
Publicação nos comunicadores (Atualmente é utilizado o Rocket Chat)
No comunicador que estiver sendo utilizado pelos setores (atualmente é o Rocket Chat, no canal "entrega-versoes"), deverá ser enviada uma mensagem avisando os usuários sobre a liberação das versões e relacionando os casos que estão sendo liberados. Abaixo segue exemplo do padrão da mensagem à ser seguido:
Suporte, Projetos e Comercial
Seguem as versões e casos liberados na data de DD/MM/AAAA.
Executáveis disponíveis no FTP e anexo aos casos.
0044227: Versão 6.555 - VENDAS
0044228: Versão 2.655 - NFE
0043362: De Paulo - Sistema apresenta mensagem "Ativado o modo de cálculo manual dos tributos dos itens." indevidamente.
0044128: OASIS (Carina) Ao importar itens de outro documento, sistema está duplicando os itens
0044048: OASIS (Manuela) Ao emitir NFE com CFOP 6.118-000, sistema deve abrir outra NFE 6.923-000 para Remessa por Conta e Ordem
0043550: Expet (Taxa de Conversão do produto no Mobile)
0044115: Expet (Taxa de Conversão do produto no Mobile)
0044220: Versão 4.970 - COMPRAS
0044029: STILETTO - Ao visualizar OC, sistema apresenta data de vencimento errada.
Qualquer dúvida estou a disposição.
Obrigado.
Publicação na Central de Operações
Para o segmento ERP os módulos liberados no Branch NÃO devem ser publicados na Central de Operações. A publicação na Central deverá ser feita mensalmente, em análise com o Gerente/Supervisor do setor de Suporte para verificar qual versão "estável" deverá ser publicada.
Para publicação dos módulos na Central de Operações utilizaremos o programa "GeradorSetupVersao2", que já vimos anteriormente para a geração dos executáveis.
A diferença é que para realizar a publicação na Central de Operações deveremos selecionar o módulo à ser publicado e então clicar no botão "Publicar". O executável deverá ser buscado no caminho "\\ss\qualidade\LIBERADO_VERSOES_EXECUTAVEIS", deverá ser confirmado se os dados do executável estão corretos e em seguida clicar no botão "Publicar", conforme exemplo:
Este processo deverá ser realizado para todos os módulos e para cada um dos ambientes que será realizada a publicação na Central de Operações.
Após realizar a publicação de todos os módulos e ambientes, conferir se em "\\ss\transfer\SISTEMAS\ASSINADOS", dentro da pasta de cada módulo e cada ambiente, se o executável foi atualizado com a data de liberação do mesmo:
Conferir também se em "\\ss\transfer\SISTEMAS\INSTALADORES", dentro da pasta de cada módulo e cada ambiente, se o instalador foi gerado com a data da publicação:
Se tudo estiver correto, copiar o arquivo "Altver" de cada um dos módulos que foram publicados e colá-los no caminho
"\\ss\transfer\SISTEMAS\ASSINADOS":
A conferência da geração dos executáveis, instaladores e cópia dos arquivos Altver deverão ser realizadas para cada um dos ambientes publicados.
Após publicar as versões é necessário acessar o link Comunicados Delphi e cadastrar as novas versões.
Liberando versão para todas as empresas.
Selecione a opção Considerar esta versão para o Dashboard para que a nova versão apareça na central de operações do cliente.
Entregando versão para um cliente específico.
1 - Colocar o modulo que será enviado para o cliente especifico em: H:\centralop\INNO_FIREDAC\SISTEMAS\(EC ou NV ou SS)\EXES_ESPECIFICOS
2 - NÃO selecione a opção Considerar esta versão para o Dashboard.
3 - Selecione a opção Liberar versão para clientes específicos? e digitar o número do CNPJ/CPF e clicar no "+", dessa forma, a versão aparecerá automáticamente na central de operções apenas desses clientes.
[padronizar] Finalização do fechamento do Branch da Versão
Após terem sido realizadas todas as etapas anteriores, agora é necessário apenas fechar todos os casos relacionados ao Branch da Versão (caso de erro/melhoria/customizações e casos de versionamento das versões) para que em seguida possamos fechar o caso do Branch.
Para isso basta acessar cada um dos casos, começando pelos casos que foram tratados dentro do Branch da Versão em questão e seguir os passos abaixo:
Após fechar todos os casos tratados no Branch, o caso do Branch da Versão passará a demonstrar:
Repetir o processo acima para os "casos pai (Versionamento dos módulos)" e depois fechar também o caso do Branch da Versão.
Depois que todos os casos do Mantis e o Branch da Versão for fechado, no Trello mover os casos da coluna "Aguardando Liberação" para a coluna "Entregues":
Sempre após um Branch da Versão ser encerrado é obrigatório realizar o processo da criação de um novo Branch da Versão e criação dos novos "Casos pai (Versionamento dos módulos)".
[padronizar] Geração de Customizações (DLLs) para liberação das versões
Compilando uma Custom
Localizando a pasta das Customizações
Para a compilação de uma Custom será necessário baixar a pasta específica dela que fica em "https://svn.supersoft.com.br/svn/desenvolvimento/outros/DLLs/EmFireDac Skin" com o nome do módulo + o nome do cliente, exemplo "CustomVDOasis":
Para compilar será necessário copiar essa pasta do EmFireDac Skin para o trunk -> CodigoBaseSkin -> WorkingCopies -> Sistemas, e colar:
Após isso abrir a CustomVD.dproj (sempre será o nome do módulo da custom que está sendo compilada) que está dentro da Custom -> Project:
Atualização da versão dentro da Custom
Ao abrir, antes de compilar será necessário ajustar o número da verão em da custom, ir em "Project -> Options -> Version Info" e corrigir para o número da versão que será liberada, e clicar em OK:
Na pagina inicial, abaixar a barra e corrigir o número da versão e conferir o nome da Custom:
Após isso crie uma pasta em: \\ss\qualidade\LIBERADO_DLLs + o nome do cliente + o nome do projeto da custom, exemplo: "\\ss\qualidade\LIBERADO_DLLs\Oasis\CustomVD"
Pasta das Customizações
Crie uma pasta com o número do caso + versão + data de liberação, assim sempre terá as versão antigas salvas
Antes de compilar será necessário ajustar o caminho para salvar a dll em "Project -> Options -> Delphi Compiler -> Output directory" e clicar em OK:
Salve o projeto:
Compilando a Custom
Digitar "Shift+F9" para iniciar o processo de compilação, será exibido no canto inferior esquerdo será exibida a mensagem "Sucess" e o tempo de compilação:
Commit da Custom
Depois acesse novamente a pasta em que foi compilado o projeto e copie os arquivos .dpr e .dproj:
E cole (clique em SIM para substituir) dentro da pasta "EmFireDac Skin" -> nome do projeto -> Project:
Após isso é só clicar com o botão direito na tela TortoiseSVN -> Commit, como padrão sempre usamos o resumo do caso:
Depois ao dar o showlog na pasta será possível ver a alteração na versão da Custom:
Validação das informações das Custom
Após a custom ser compilada será necessário conferir se foi gerada a versão correta, acesse o caminho em que foi compilada:
Selecione ela, clique com o botão direito e vá em "Propriedades" -> "Detalhes" e veja se a versão do arquivo está correta:
Compactação das Customizações
Depois de conferir a Custom gerada será necessário compactá-la. Para isso deverá abrir o programa "ASPack" e clicar em "Open" para selecionar a custom que será compactada e clicar em "Abrir":
O programa começará a compactar os arquivos. Aguardar até que a compactação seja finalizada (quando finalizar o programa "ASPack" pode fecha-lo):
Após isso é só deletar o arquivo .bak que gerou na pasta da dll:
Liberação da Custom no Mantis
Após os procedimentos acima será necessário copiar a pasta da custom gerada para o transfer "\\ss\Trasnfer\SISTEMAS\DLLS_NOVO_SKIN" + Cliente + Projeto:
Por ultimo deverá ser adicionada uma anotação no Mantis referente a publicação das Dlls liberada deverá ser apontada em cada um dos casos pai (casos de versionamento dos módulos) que estão vinculados ao Branch que está sendo liberado + sistema (se houver alterações no módulo que necessitam da Custom)
Nos casos do Mantis mencionar a versão da custom, seguindo o padrão de mensagem:
[b]CustomCP Rodaleve[/b]
Versão: 5.00
Data de liberação: 11/04/2023
*Adicionar usuários do Suporte, Projetos, Comercial e Qualidade na anotação
CustomXX XXXXXX (Projeto e nome do cliente)
Versão: X.XX (Número da versão)
Data de liberação: XX/XX/XXXX
Liberar em conjunto com: Não há necessidade de atualização do executável.
DLL disponível em:
- \\ss\transfer\SISTEMAS\DLLS_NOVO_SKIN
Qualquer duvida estou a disposição.
Obrigada.
Abaixo segue exemplo de preenchimento no Mantis caso 0048457:
Depois disso os casos podem ser fechados.