Como construir um pacote de lançamento no Jitterbit App Builder

Introdução

Esta página mostra como construir um pacote de lançamento, que é uma coleção selecionada de aplicativos, fontes de dados e outros componentes, agrupados para implantação. Este processo é utilizado ao mover um aplicativo de um ambiente para outro, por exemplo, ao mover um aplicativo dos ambientes de desenvolvimento para QA, e a partir daí, para os ambientes de produção.

O diagrama a seguir mostra o que um lançamento contém.

Construir um lançamento

Construir um lançamento em um pacote e, em seguida, instalar um pacote em um novo ambiente ocorre na área Implantar, acessada a partir do IDE do App Builder. Durante este processo, você se moverá do lado esquerdo da tela Construtor de Modelos de Lançamento para o lado direito, enquanto avança por todas as etapas descritas aqui:

1. Selecione Gaveta de Ação > IDE.

2. Selecione Implantar > Criar Lançamento.

3. Para iniciar uma construção, você pode selecionar um modelo existente (se estiver atualizando uma atualização de aplicativo existente) ou clicar em + Lançamento para criar um novo modelo.

4. Se estiver usando um modelo existente, clique no botão Template para o registro do modelo existente.

5. Atualize os campos Name, Version e Developer na tela Release Details para refletir a versão que você está criando:

   

6. Clique no botão Next.

7. Na tela Solution Objects, você escolhe o que vai no pacote de lançamento. As opções são as seguintes:

   • Application
   • Assembly
   • Bundle
   • Collection
   • Data Source
   • Function
   • Logical Data Type
   • Page
   • Role
   • Rule
   • SQL Object
   • Widget

   Para adicionar qualquer um desses, clique no botão + Object, selecione o tipo no menu e, em seguida, clique no botão Save:

   

   Notas

   Os seguintes pontos se aplicam aos pacotes de lançamento:

   • Quando você adiciona um objeto de aplicativo, o pacote e a fonte de dados do aplicativo são adicionados automaticamente ao pacote de lançamento.

   • O pacote de lançamento não inclui grupos de instância, provedores de segurança de instância ou credenciais de servidor.

   • Objetos recém-suportados (como funções e tipos de dados lógicos) não são adicionados automaticamente a modelos pré-existentes. Você deve adicioná-los manualmente.

8. Clique no botão Next.

9. A tela Configure Data Sources lista todas as fontes de dados relevantes para a versão de lançamento. (Se não houver fontes de dados, esta etapa é pulada.) Para cada fonte de dados listada, verifique a coluna Include e certifique-se de que está configurada como você deseja para a versão. Dependendo do tipo de fonte de dados, qualquer uma das seguintes opções está disponível:

   • Logical Model Only: Use quando você deseja empacotar apenas os dados que foram criados e existem no App Builder. Exemplos: dados e objetos de negócios, subconsultas, CRUDs, fluxo de trabalho, pontes. Esta opção é geralmente usada para fontes de dados que você não possui e/ou não são mantidas via App Builder (fontes de dados externas, fontes de dados de API, etc.).

10. Modelo Físico Apenas: Use quando você deseja empacotar apenas as estruturas de tabelas e colunas da fonte de dados, sem os dados.

11. Modelo Lógico e Tabelas Físicas: Use quando você deseja trazer todas as informações existentes no App Builder, bem como as estruturas de tabelas e colunas da fonte de dados subjacente. Aqui, físico refere-se ao App Builder mantendo ou fazendo atualizações na camada real do banco de dados. Se você mover um modelo Físico, isso significa que quaisquer alterações feitas no desenvolvimento no banco de dados também serão feitas no banco de dados QA/Prod ao mover o LP. Esta opção é geralmente usada para fontes de dados que você gerencia.

12. Não Incluir: Use se você não deseja incluir esta fonte de dados nesta versão.

    Importante

    Se você tiver alterações no banco de dados que precisam ser comprometidas, deve mover Lógico e Físico para esse banco de dados. O processo de Gerenciamento de Lançamentos suporta a importação de Tabelas. Se você importar Tabelas em uma fonte de dados, essas Tabelas importadas serão criadas no sistema de destino se fizerem parte do primeiro conjunto de alterações Físicas.

13. Clique no botão Próximo.

14. Se você tiver traduções em seu aplicativo, a tela Pacotes de Solução aparecerá. Caso contrário, a tela Notas de Lançamento aparecerá com informações gerais sobre o pacote de lançamento:

    

    • Nome: O nome do seu aplicativo.

    • Versão: O número da versão do pacote que está sendo criado.

    • Data de Lançamento: A data que você deseja que o lançamento apareça (esta é uma data provisória e pode ser diferente da data real de lançamento).

    • Data de Construção: A data em que você comprometeu o pacote.

    • Data de Publicação: A data em que você lançou o pacote.

    • Descrição do Modelo: Uma descrição em texto do que seu aplicativo ou suíte faz.

15. Clique no botão Próximo.

16. Revise as informações na tela Publicar, em seguida, clique no botão Concluir.

    Você deve agora estar de volta à tela Construtor de Modelos de Lançamento com a coluna Pronto contendo uma marca de verificação verde.

17. Clique no botão Database Changes e você saberá que tem alterações não confirmadas para revisar e aprovar se vir um ícone de verificação vermelho aparecer na coluna DB na tela do Release Template Builder. A tela de Change Management Requests lista todas as alterações relacionadas à fonte de dados que farão parte do pacote. Se você vir alguma alteração listada com um ícone de verificação vermelho na coluna Status, isso requer que você clique manualmente para revisar e aprovar.

    Clicar para revisar leva você à tela de Change Management Request. Aqui, o campo Patch Number é preenchido automaticamente com um valor e indica qual iteração esta atualização de pacote reflete. Certifique-se de revisar todas as entradas listadas no painel Changes para garantir que essas informações são o que você espera que seja movido com o pacote. Nesta tela, você precisa inserir:

    • Reference Number: Isso pode espelhar o valor do Patch Number, ser uma referência de ticket JIRA ou AHA, ou usar um valor de numeração do cliente.

    • Short Description: Forneça uma descrição em texto sobre o pacote. Se desejar, insira informações adicionais no campo Comments.

18. Clique no botão Save e, se estiver pronto para prosseguir, clique no botão Close this Request.

19. Feche as telas restantes para que você esteja visualizando a tela do Release Template Builder. Agora você verá um ícone de verificação verde aparecer na coluna DB.

20. A Data Config é opcional e só é usada se você estiver movendo Logical e Physical Data com o pacote. Na tela de Data Configuration, você verá itens de todas as fontes de dados, tabelas para a fonte de dados, juntamente com o tipo de Owner Type que foi atribuído, junto com a ação correspondente que acontece quando a tabela é movida para esse ambiente. Os diferentes Owner Types são os seguintes:

    • User Data: Não transferirá nenhum dos dados. Os usuários em cada ambiente são responsáveis por preencher essa tabela. Por exemplo: Customers ou Orders, que são tabelas transacionais.

    • Share Data: Insere os novos registros apenas no próximo ambiente. Por exemplo: Email Templates, que é uma tabela que você deseja que o usuário personalize as alterações.

21. Dados do Desenvolvedor: Trunca a tabela em QA e insere todos os registros do pacote. Isso é tipicamente usado sempre que você tem tabelas de consulta ou tabelas que fazem parte de uma configuração. Por exemplo: Tipo de Cliente, Tipo de Funcionário.

22. As informações podem ser substituídas manualmente para Tipos de Proprietário e definidas para o pacote específico, ou você pode simplesmente clicar em Confirmar Configuração. Isso marca esse processo como completo e retorna à tela do Construtor de Modelos de Lançamento. Observe que a melhor prática da metodologia Jitterbit é sempre definir o valor da Opção de Instalação no nível da Tabela, que mapeia para Tipo de Proprietário na tela do Construtor de Modelos de Lançamento. Opções de Instalação são Dados do Usuário, Compartilhar Dados e Dados do Desenvolvedor. Se os valores forem definidos no nível da tabela, essas configurações serão transferidas para o pacote de lançamento. Definir essas informações no nível da tabela é útil para projetos com vários membros da equipe.

23. A área de Configuração SQL permite que você escolha o banco de dados e veja se há algum objeto (visões ou procedimentos armazenados) armazenado no banco de dados no nível SQL nativo. Isso permitirá que você mova visões ou procedimentos armazenados. Essas informações não serão preenchidas automaticamente na tela de Código resultante, e você precisará clicar manualmente no botão Criar e adicioná-los. Essa etapa é tipicamente usada apenas em situações avançadas e não é uma etapa obrigatória.

24. A etapa de Construção mostrará a versão para este lançamento, permitirá que você adicione notas específicas para este lançamento e permitirá que você selecione uma opção para tirar uma captura de tela antes de construir. Ao estruturar suas notas de lançamento, você deve usar um formato como a captura de tela a seguir. Seguir um processo consistente para nomear suas notas de lançamento ao longo do tempo é importante, especialmente se seu projeto for um que tenha várias pessoas trabalhando nele. Isso se torna um registro contínuo das notas de lançamento do aplicativo.

25. Clique no botão Construir Pacote, que inicia um trabalho em segundo plano que constrói o pacote. Não há notificação que aconteça para avisá-lo quando o pacote estiver concluído e/ou falhar. Para verificar o status do processo, você precisa ir ao App Builder IDE, Gerenciar Servidores e Agendas e verificar o painel de Instâncias de Trabalhos em Execução.

26. O botão Reset limpará todas as informações associadas ao modelo de pacote e permitirá que você comece do zero para a construção do seu pacote.

27. Clique no ícone Packages , que o levará à tela de Lançamentos da Solução, onde está o arquivo LP baixável criado para o próximo ambiente. Este é o arquivo que você levará para instalar no próximo ambiente. A partir desta tela, baixe o arquivo do Pacote e armazene-o localmente em seu computador.

28. Com o arquivo LP disponível, vá para o seu próximo ambiente onde você irá instalá-lo (QA ou Prod). A partir daí, vá para Deploy your Application no IDE do App Builder e clique no botão Install Release.

    Dica

    Para ver o conteúdo do pacote antes de instalar, clique no botão Manifest.

29. Clique no botão Create e Browse para localizar o arquivo do Pacote e clique em Save. Ao salvar, você verá o painel da Solução à direita exibindo as informações do pacote sobre Nome, Versão, Desenvolvedor, Data de Lançamento, Descrição e Notas de Lançamento.

30. Clique no botão Install após confirmar que este é o pacote que você deseja instalar. Este processo é executado em primeiro plano. Se for bem-sucedido, você receberá uma mensagem de sucesso. Se falhar, vá para Logs > App Server Fast Logs e você verá informações específicas sobre o erro que causou a falha na instalação.

Schedules and release packages

Os Agendamentos serão incluídos em um Pacote de Lançamento (ou LP) a menos que sejam removidos manualmente ao construir o Pacote. Por design, os Agendamentos que foram implantados em um ambiente de Produção estão "selados" ou impedidos de fazer certas edições nas informações do Agendamento. Isso evita que alguém faça alterações de desenvolvimento acidentalmente em um ambiente posterior, o que poderia levar a vários problemas ao tentar implantar o aplicativo no futuro. Os Agendamentos são parte de um aplicativo, portanto, estão "selados" nesses ambientes posteriores. Você pode ativar ou desativar Agendamentos ou ajustar o horário, mas não pode alterar o tipo de execução de um Agendamento.

Existem alguns cenários em que você pode configurar um Agendamento no Dev, mas uma vez em Produção, o Agendamento do Dev é desativado. Por exemplo, ao interagir com uma API. Você pode querer interagir com uma API apenas a partir do ambiente de Produção, então, uma vez que o Dev esteja completo, você pode desativar o Agendamento no ambiente de Desenvolvimento.

Uma vez que um Agendamento foi adicionado a um LP, observe que nem todas as alterações de Agendamento serão aplicadas em futuras Compilações de um pacote. Se você adicionar ou remover Eventos associados a um Agendamento, essas alterações serão refletidas em uma nova Compilação. Outras alterações na definição de um Agendamento não serão aplicadas a futuras Compilações.

Para fazer alterações em um Agendamento de Produção que está selado, você pode criar um novo Agendamento que será incluído no próximo LP. Esse processo garantirá que o Agendamento seja criado corretamente com quaisquer novas configurações refletidas nos ambientes subsequentes.