Transferir (migrar) um projeto para um ambiente no Jitterbit Studio

Introdução

A transferência de projeto move projetos entre ambientes dentro de uma única organização Harmony. Esse recurso ajuda você a promover alterações de design ao longo do seu ciclo de vida de desenvolvimento. Use a transferência de projeto para manter ambientes separados de desenvolvimento, teste e produção. A transferência de projeto garante a implantação controlada de alterações.

A transferência de projeto oferece implantação controlada ao mover projetos ou componentes através de estágios de desenvolvimento de forma planejada. Mantém o isolamento de ambiente ao manter desenvolvimento, teste e produção separados. A transferência de projeto cria uma trilha de auditoria para rastrear o histórico de transferência para conformidade.

Você pode usar a transferência de projeto para realizar o seguinte:

• Mover projetos ou componentes entre ambientes na mesma organização.
• Promover alterações através de estágios de desenvolvimento.
• Manter configurações específicas do ambiente.
• Preservar histórico de transferência e dependências.

Para mover projetos entre organizações, consulte Exportações e importações de projeto.

Você pode transferir projetos usando uma destas duas opções:

1. Transferência de projeto completo: Transferir o projeto inteiro para um ambiente. (Essa opção aparece como Migrar na interface atual.)

2. Transferência seletiva: Transferir apenas componentes especificados para um ambiente.

A tabela a seguir compara os principais recursos de cada opção de transferência:

Você pode transferir projetos ou componentes independentemente de terem sido implantados ou não.

Pré-requisitos

Antes de transferir um projeto ou componente de projeto, conclua estes requisitos:

• Certifique-se de ter o acesso apropriado em ambos os ambientes de origem e destino.

• Verifique se o ambiente de destino possui o tipo de agente necessário (nuvem ou privado) se usar recursos limitados a um determinado tipo de agente.

Cadeias de transferência

Uma cadeia de transferência é uma sequência vinculada de ambientes através da qual um projeto se move durante seu ciclo de vida. Uma vez estabelecidas, essas cadeias criam dependências que você deve gerenciar com cuidado.

Fluxo de transferência típico

Um fluxo de trabalho típico envolve estas etapas:

[Development] → [QA/Testing] → [Production]
     ↓               ↓               ↓
  (Create)      (Test/Fix)      (Go Live)

1. Criar um projeto em um ambiente de desenvolvimento.
2. Transferir para um ambiente de QA (Garantia de Qualidade) para teste.
3. Corrigir problemas no ambiente de desenvolvimento.
4. Transferir para o ambiente de QA novamente para reteste.
5. Transferir de QA para produção quando pronto.
6. Repetir as etapas 3-5 para alterações contínuas.

As transferências de projeto são baseadas em IDs internos, não em nomes, portanto projetos renomeados mantêm seus relacionamentos de transferência.

Dependências em cadeia

A transferência de projeto cria essas dependências permanentes entre projetos:

• Projetos não podem ser excluídos se existirem projetos dependentes a jusante.

• Cadeias não podem ser quebradas sem excluir projetos a jusante.

• Renomear projetos não afeta os relacionamentos em cadeia.

Um projeto transferido tem uma dependência do projeto do qual foi transferido. Não é possível excluir um projeto no início de uma cadeia de transferência até excluir todos os projetos mais adiante na cadeia. Para mais informações, consulte Excluir um projeto em Criação e configuração de projeto.

É possível quebrar uma cadeia de transferência apenas excluindo projetos mais adiante na cadeia ou exportando e importando o projeto. Para mais informações, consulte Exportações e importações de projeto. Renomear um projeto transferido não quebra a cadeia. Apenas exportações e importações de projeto podem criar cópias independentes.

Práticas recomendadas

Recomendamos essas práticas recomendadas ao projetar uma cadeia de transferência:

• Faça alterações de design apenas no primeiro ambiente da cadeia. No exemplo de fluxo de transferência típico, este é o ambiente de desenvolvimento. Em ambientes posteriores, recomendamos alterar apenas os valores das variáveis de projeto. Faça essas alterações no aplicativo Studio para que apareçam no histórico do projeto. Alterações de valores de variáveis de projeto feitas no Console de Gerenciamento na página Projetos não aparecem no histórico do projeto. Durante a transferência de projeto, é possível selecionar se deseja transferir todos os valores das variáveis de projeto ou apenas valores selecionados (descrito na próxima seção).

• Torne o primeiro ambiente da cadeia acessível para quem possa precisar fazer alterações no projeto ao longo do tempo. Recomendamos contra um único desenvolvedor projetando o projeto em uma organização pessoal. Se isso acontecer, primeiro exporte o projeto original e depois importe-o para o ambiente que iniciará a cadeia. Faça alterações futuras no projeto no ambiente que inicia a cadeia.

Transferência de projeto

É possível transferir projetos usando uma destas duas opções:

1. Transferência de projeto completo: Transferir o projeto inteiro para um ambiente. (Esta opção aparece como Migrar na interface atual.)
2. Transferência seletiva: Transferir apenas componentes especificados para um ambiente.

Transferir um projeto completo

Ao transferir um projeto completo usando a opção Migrar, todos os componentes do projeto e metadados do projeto são transferidos.

Quando um projeto é transferido para outro ambiente, todas as funções das quais o usuário que faz a transferência é membro e que têm acesso ao ambiente de destino são ativadas na aba User roles do projeto de destino por padrão. Ao transferir para um projeto existente, essas funções são ativadas além de qualquer função já ativada no projeto de destino.

A opção Migrate está acessível nestes locais:

• A barra de ferramentas do projeto. Para mais informações, consulte Project actions menu em Project toolbar.
• A tela de design. Para mais informações, consulte Deploy/migrate actions menu em Design canvas.

Ao selecionar Migrate, uma tela de configuração é aberta. Você pode escolher o ambiente de destino e se deseja transferir os valores de variáveis de projeto individuais:

• Organization e Project: A organização Harmony onde o projeto reside e o nome do projeto a ser transferido, separados por vírgula.

• Current environment e Target environment: O ambiente atual onde o projeto reside e o ambiente de destino para o qual o projeto será transferido são listados junto com seu tipo de grupo de agente associado (cloud agent ou private agent).

  Quando o projeto é transferido, o projeto existente no ambiente atual permanece inalterado. Se o projeto já foi transferido para o ambiente de destino, o projeto do ambiente de destino é sobrescrito usando as seleções para valores de variáveis de projeto abaixo.

  Cuidado

  Se o projeto de origem usa conectores disponíveis apenas em agentes privados, você não pode transferi-lo para um ambiente associado a um grupo de agentes na nuvem. Esses ambientes ainda aparecem no menu suspenso Target Environment, mas não podem ser selecionados.

• Project history tag name: Digite uma tag para rotular o evento de transferência. A tag aparece como um rótulo no evento de transferência e é registrada nos detalhes de implantação acessíveis no histórico do projeto. Recomenda-se inserir uma tag exclusiva, mas não é obrigatório.

• Global Endpoints: Qualquer global endpoint usado pelo projeto sendo transferido que não existe no ambiente de destino é listado. Quando o projeto é transferido, o global endpoint é adicionado a esse ambiente e precisa de configuração após a transferência.

• Migrate all variable values: Selecione esta opção para transferir todos os valores de variáveis de projeto. Se o projeto já existe no ambiente de destino, os valores de todas as variáveis de projeto substituem as variáveis de projeto existentes. Na primeira transferência de um projeto, esta opção é selecionada por padrão. Transferências posteriores usam como padrão Select variable values to migrate.

• Select variable values to migrate: Selecione esta opção para transferir todos os componentes do projeto e metadados do projeto, exceto pelos valores das variáveis de projeto listadas em Exclude. Se o projeto já existe no ambiente de destino, todos os componentes do projeto, incluindo os valores das variáveis de projeto listadas em Include, são substituídos.

  Quando Select variable values to migrate é selecionado, nenhuma variável de projeto é selecionada para transferência por padrão, a menos que o projeto já exista no ambiente de destino. Quando o projeto já foi transferido, variáveis de projeto recém-adicionadas ou renomeadas são selecionadas para transferência por padrão, mas variáveis cujos valores foram alterados são excluídas.

  • Search: Digite qualquer parte do nome de uma variável de projeto para filtrar a lista de variáveis de projeto no ambiente atual.
  • Current environment: Selecione variáveis de projeto cujos valores você deseja transferir para o ambiente de destino. Conforme você seleciona variáveis de projeto, elas aparecem em Include. Os links Select all e Deselect all adicionam ou limpam todas as seleções de variáveis de projeto de uma vez.
  • Exclude: Variáveis de projeto cujos valores são excluídos da transferência. Se o projeto já existe no ambiente de destino e já contém a variável de projeto, seu valor existente no ambiente de destino é mantido. Se a variável de projeto ainda não existe, o componente da variável de projeto é transferido, mas não recebe nenhum valor.
  • Include: Variáveis de projeto cujos valores são incluídos na transferência. Se o projeto já existe no ambiente de destino e já contém a variável de projeto, seu valor existente no ambiente de destino é sobrescrito.

• Migrar: Clique para transferir o projeto para o ambiente selecionado. Se o projeto já foi transferido para o ambiente de destino, uma mensagem solicita que você confirme se deseja transferir. Esta transferência sobrescreve o projeto existente no ambiente de destino usando as seleções para valores de variáveis de projeto acima.

  Texto do diálogo

  Confirmar Migração
  Um projeto com o mesmo nome no ambiente de destino já existe. Tem certeza de que deseja sobrescrevê-lo?

  Ao clicar em Continuar, se a transferência para o ambiente de destino for bem-sucedida, o projeto transferido abre no designer de projetos.

Transferência seletiva

A transferência seletiva permite transferir apenas componentes especificados de um projeto. Este recurso ajuda a evitar interferências no trabalho que outros colaboradores estão realizando no mesmo projeto e ambiente. Use a transferência seletiva quando deseja promover suas alterações sem sobrescrever o trabalho de outros usuários no ambiente de destino.

Quando um projeto é transferido para outro ambiente, todas as funções das quais o usuário que está transferindo é membro e que têm acesso ao ambiente de destino são habilitadas na guia Funções de usuário do projeto de destino por padrão. Ao transferir para um projeto existente, essas funções são habilitadas além de qualquer função já habilitada no projeto de destino.

Para transferir apenas componentes especificados de um projeto, use o menu de ações do projeto ou menu de ações de operação em um projeto e clique em Transferência Seletiva:

Etapa 1: Selecionar ambiente de destino e tag

Nesta etapa, selecione um ambiente de destino e especifique uma tag.

• Projeto de origem: O nome e o ambiente do seu projeto atual são exibidos.

• Ambiente de destino: Escolha o ambiente para o qual deseja transferir os componentes selecionados.

• Nome da tag do histórico do projeto: Digite um nome de tag para identificar a transferência no histórico do projeto.

• Comentário: Adicione um comentário opcional descrevendo as alterações ou o propósito desta transferência.

• Próximo: Clique para prosseguir para a seleção de componentes.

• Cancelar: Cancele a transferência e retorne ao projeto.

Etapa 2: Selecionar componentes adicionais

Nesta etapa, você pode selecionar componentes individuais conforme suas necessidades.

Os componentes listados no lado de destino da tela exibem a tag da última transferência em que foram incluídos.

Os componentes são agrupados com base em seu status nos ambientes de origem e destino:

• Criar: Componentes que existem no projeto de origem, mas não no projeto de destino. Quando selecionados, esses componentes são criados no projeto de destino.

Uma nova operação é adicionada à tela de design do projeto de destino na mesma posição relativa às suas operações vizinhas como no projeto de origem. Por exemplo, se as operações A, C e B existem nessa ordem no projeto de origem, e o projeto de destino contém A e B, mas não C, transferir C a coloca imediatamente após A e antes de B. Qualquer cadeia de operações conectando a operação transferida a outras operações, como On Success, On Fail, On SOAP Fault ou links da função RunOperation, são preservados no projeto de destino.

• Overwrite: Componentes que existem em ambos os projetos, mas têm conteúdo diferente com base na data da última modificação e comparação do usuário. Quando selecionado, esses componentes são substituídos no projeto de destino.

  Um ícone View changes aparece ao lado das linhas de componentes de script, transformação, endpoint do conector e atividade do conector. Clique nele para abrir uma visualização de diff mostrando uma comparação lado a lado do conteúdo do componente antes e depois da alteração. Os seguintes controles estão disponíveis na barra de título da visualização de diff:

  • Pop-out: Abre a visualização de diff em uma nova janela pop-up. Clique novamente para retorná-la à posição inline.
  • Maximize / Restore: Expande a visualização de diff para preencher o espaço de tela disponível ou a retorna ao seu tamanho padrão.
  • Close: Fecha a visualização de diff.

  A visualização de diff usa um dos seguintes formatos, dependendo do tipo de componente:

  • Code diff view: Usada para scripts e transformações. A visualização de diff mostra dois painéis lado a lado:

    

    As linhas removidas são destacadas em vermelho (painel esquerdo) e as linhas adicionadas são destacadas em verde (painel direito). Para transformações, cada regra de mapeamento alterada aparece como uma seção recolhível rotulada com o caminho do campo (por exemplo, "Mapping rule json/isActive"). Clique na seta para expandir ou recolher seções individuais.

  • Field comparison diff view: Usada para endpoints do conector e atividades do conector. A visualização de diff mostra uma tabela com as colunas Name, Before e After listando cada campo alterado:

    

    Os valores de campo alterados são destacados em vermelho (coluna Before) e verde (coluna After), e valores sensíveis como senhas são mascarados. A barra de título da visualização de diff exibe o tipo e o nome do componente (por exemplo, "Endpoint: HTTP v2" ou "Activity: GET").

    Nota

    As linhas mostradas para uma atividade do conector refletem suas propriedades de configuração subjacentes, que nem sempre se alinham um a um com as telas de configuração baseadas em etapas da atividade. Por exemplo, a atividade Query do Salesforce apresenta várias etapas de configuração que atualizam uma única propriedade de consulta subjacente, portanto, editar campos em várias etapas da atividade pode aparecer como uma única linha alterada no diff.

• Delete: Componentes que existem no projeto de destino, mas não no projeto de origem. Quando selecionado, esses componentes são removidos do projeto de destino.

• Unchanged: Componentes que existem em ambos os projetos e têm o mesmo conteúdo com base na data da última modificação e comparação do usuário. Esses componentes não podem ser selecionados.

Você pode selecionar ou desselecionar componentes nas categorias Create, Overwrite e Delete para configurar sua transferência.

• Autoselect dependencies: Alterne essa opção para controlar como as dependências de componentes são tratadas durante a transferência. Quando ativada (padrão), selecionar um componente seleciona automaticamente todas as suas dependências necessárias, que não podem ser desmarcadas individualmente. Quando desativada, você pode selecionar componentes individuais sem incluir automaticamente suas dependências.

• Show: Mostrar dados ocultos de Last Modified. Clique para exibir essas informações.

• Hide: Ocultar dados visíveis de Last Modified. Clique para ocultar essas informações.

• Anterior: Retorna à etapa anterior.

• Próximo: Prossegue para a próxima etapa.

• Transferir: Desabilitado a menos que todas as etapas na configuração de transferência tenham sido concluídas. Quando habilitado, clique para iniciar o processo de transferência com seus componentes e configuração selecionados. Quando a transferência for concluída, uma caixa de diálogo de confirmação aparecerá com uma opção para abrir o projeto no ambiente de destino.

• Cancelar: Cancela a transferência e retorna ao projeto.

Etapa 3: Configurar variáveis

Nesta etapa, você pode gerenciar como as variáveis de projeto são transferidas para o ambiente de destino.

As variáveis de projeto são agrupadas com base em seu status nos ambientes de origem e destino:

• Criar: Variáveis de projeto que existem no projeto de origem, mas não no projeto de destino. Quando selecionadas, essas variáveis de projeto são criadas no projeto de destino.

• Sobrescrever: Variáveis de projeto que existem em ambos os projetos, mas têm conteúdo diferente com base na data da última modificação e comparação de usuário. Quando selecionadas, essas variáveis são substituídas no projeto de destino.

• Excluir: Variáveis de projeto que existem no projeto de destino, mas não no projeto de origem. Quando selecionadas, essas variáveis de projeto são removidas do projeto de destino.

• Inalterado: Variáveis de projeto que existem em ambos os projetos e têm o mesmo conteúdo com base na data da última modificação e comparação de usuário. Essas variáveis de projeto não podem ser selecionadas.

Você pode selecionar ou desselecionar variáveis de projeto nas categorias Criar, Sobrescrever e Excluir para configurar sua transferência.

• Incluir valor padrão: Quando selecionado, essa opção substitui o valor da variável de projeto no projeto de destino pelo valor padrão do projeto de origem. Quando desmarcado, o valor da variável de projeto não é substituído.

  Essa caixa de seleção é selecionada automaticamente quando você seleciona uma variável (individualmente ou através de Selecionar tudo). Quando você desseleciona uma variável, essa caixa de seleção é desmarcada e desabilitada.

• Mostrar: Mostra dados ocultos de Última Modificação. Clique para exibir essas informações.

• Ocultar: Oculta dados visíveis de Última Modificação. Clique para ocultar essas informações.

• Anterior: Retorna à etapa anterior.

• Próximo: Prossegue para a próxima etapa.

• Transferir: Desabilitado a menos que todas as etapas tenham sido configuradas. Quando habilitado, clique para iniciar o processo de transferência com seus componentes e configuração selecionados. Quando a transferência for concluída, uma caixa de diálogo de confirmação aparecerá com uma opção para abrir o projeto no ambiente de destino.

• Cancelar: Cancela a transferência e retorna ao projeto.

Etapa 4: Configurar agendamentos

Nesta etapa, configure como os agendamentos são transferidos para suas operações.

• Transferir configurações de agendamento para operações: Alterne essa opção para ativar ou desativar a transferência de configurações de agendamento. Quando ativado, você pode selecionar agendamentos para transferir para o projeto de destino.

Os agendamentos são organizados em categorias com base em sua ação de transferência. Você pode expandir um agendamento para visualizar quais operações estão atribuídas a ele. As operações marcadas com um rótulo Atribuído estão atualmente atribuídas a esse agendamento no projeto de origem.

• Criar: Agendamentos que existem no projeto de origem, mas não no projeto de destino. Quando selecionados, os agendamentos e suas atribuições são criados no projeto de destino.

• Sobrescrever: Agendamentos que existem em ambos os projetos, mas têm conteúdo diferente com base na data da última modificação e comparação de usuário. Quando selecionados, os agendamentos e suas atribuições são substituídos no projeto de destino.

• Excluir: Agendamentos que existem no projeto de destino, mas não no projeto de origem. Quando selecionados, esses agendamentos são removidos do projeto de destino.

• Desatribuir: Agendamentos que existem em ambos os projetos e foram desatribuídos de operações no projeto de origem. Quando selecionados, esses agendamentos são desatribuídos de operações para o projeto de destino.

• Mostrar: Exibe dados de Última Modificação ocultos. Clique para exibir essas informações.

• Ocultar: Oculta dados de Última Modificação visíveis. Clique para ocultar essas informações.

• Anterior: Retorna à etapa anterior.

• Próxima: Prossegue para a próxima etapa.

• Transferir: Desabilitado até que todas as etapas sejam configuradas. Quando habilitado, clique para iniciar o processo de transferência com seus componentes e configuração selecionados. Quando a transferência for concluída, uma caixa de diálogo de confirmação aparecerá com uma opção para abrir o projeto no ambiente de destino.

• Cancelar: Cancela a transferência e retorna ao projeto.