Exportar e importar um projeto no Jitterbit Integration Studio

Introdução

Esta página descreve como exportar e importar um projeto, bem como importar componentes individuais de um arquivo JSON de projeto para um projeto.

Juntas, as funcionalidades de exportação e importação permitem que você migre projetos e seus componentes para outras organizações, conforme necessário.

As exportações de projetos do Integration Studio estão no formato de um arquivo JSON. Após a exportação do projeto JSON, ele pode ser importado para qualquer organização.

Exportar um projeto

As opções Exportar ou Exportar Projeto podem ser acessadas nestes locais:

• A página Projetos (consulte Visualização em mosaico ou Visualização de lista em Projetos).
• A barra de ferramentas do projeto (veja menu de ações do projeto na Barra de ferramentas do projeto).

Além disso, a tela de exportação do projeto pode ser acessada através do link Exportar na parte inferior da tela Configurações do Projeto (consulte Editar configurações do projeto em Criação e configuração do projeto).

Ao selecionar Exportar ou Exportar Projeto, a tela de exportação do projeto será aberta, onde você poderá escolher as opções de exportação e gerar o projeto como um arquivo JSON:

• Incluir Credenciais: Inclui no projeto exportado os valores especificados nos campos de credenciais das telas de configuração dos componentes do projeto.

  Nota

  Esta opção pode estar desabilitada dependendo da política da organização Permitir a exportação de credenciais.

  Os campos de configuração específicos que são tratados como campos de credenciais variam de acordo com o componente do projeto. Eles geralmente incluem campos como senhas ou tokens de segurança. Desenvolvedores de conectores personalizados que usam o Connector SDK pode designar tais campos com qualquer um destes atributos:

  • "secret": "true": Designa apenas que o campo seja tratado como um campo de credenciais. O valor do campo é criptografado na exportação do projeto.

  • "widgetHint": "password": Designa que o campo é tratado como um campo de credenciais e também mascara o valor na interface do usuário do Integration Studio, substituindo cada caractere por um marcador preto. O valor do campo é criptografado na exportação do projeto.

  Os valores das variáveis do projeto em si não são tratados como credenciais, mesmo que a opção Ocultar valor esteja selecionada na interface do usuário (consulte Variáveis do projeto). Em vez disso, a inclusão de valores de variáveis do projeto é controlada pela seleção Incluir Valores de Variáveis do Projeto.

  Se uma variável de projeto for usada em um campo de credenciais (independentemente de Incluir Valores de Variáveis do Projeto estar selecionado), o campo de credenciais "value" é o valor criptografado da representação sintática dos colchetes do nome da variável do projeto e de qualquer outra entrada, se presente.

  Quando Incluir Credenciais não estiver selecionado, o campo de credenciais "value" não está incluído na exportação do projeto, exceto se uma variável de projeto for usada em um campo de credenciais. Nesse caso, a entrada de texto não criptografado do campo de credenciais é incluída. Isso pode ser preocupante se o campo de credenciais usar qualquer outra entrada junto com a variável de projeto, embora esse caso de uso seja incomum. Por exemplo, uma entrada de campo de [pv_password]1234suffix seria incluído na exportação do projeto como [pv_password]1234suffix.

• Incluir notificações por e-Email: Inclui notificações por e-email no projeto exportado. Esta opção se aplica a todas as notificações por e-email em um projeto, independentemente de estarem configuradas com ações de operação para executar em caso de sucesso, falha ou falha de SOAP ou se forem referenciados em um script.

• Incluir Valores de Variáveis do Projeto: Inclui variável do projeto valores padrão no projeto exportado.

  Os valores das variáveis do projeto configuradas com a opção Ocultar Valor (consulte Variáveis do projeto) são criptografados na exportação do projeto.

• Incluir Cronogramas: Inclui cronogramas de operação no projeto exportado.

• Exportar: Gera e baixa o projeto como um arquivo JSON. Por padrão, o nome do arquivo JSON usa o nome do projeto.

  Nota

  Um projeto exportado não retém o histórico do projeto.

Import

Depois que um projeto for exportado, você pode importar o arquivo JSON do projeto usando qualquer uma destas duas opções de importação:

1. Importar um projeto: Esta opção (acessível em Projetos permite importar o projeto inteiro para sua organização.

2. Importar componentes de um projeto: Esta opção (acessível no menu de ações do projeto em um projeto) permite que você importe apenas componentes especificados do arquivo JSON do projeto para um projeto existente em sua organização.

Importar um projeto

Você pode importar um projeto clicando em Importar em Projetos página:

Na próxima tela, importe o projeto:

• Arquivo de projeto: Use o botão Procurar para navegar até um arquivo JSON de projeto que foi exportado do Integration Studio.

  Dica

  Se o projeto utilizar conectores personalizados, eles deverão existir na organização antes da importação do projeto. Para exportar um conector do Connector Builder e importá-lo para outra organização, consulte Exportações e importações do Connector Builder. Para instalar um conector SDK do Connector em outra organização, consulte Implementando um Harmony Connector.

  Ao selecionar um arquivo, estes campos ficam disponíveis:

  • Nome do projeto: O nome do projeto é preenchido previamente a partir do arquivo JSON. Para usar um nome diferente, você pode editá-lo aqui. O nome do projeto deve atender a estes critérios:

    • Seja único para cada ambiente.

    • Não pode estar em uso como um Design Studio nome do projeto no mesmo ambiente.

    Nota

    Se um projeto com o mesmo nome já existir na nuvem Harmony, vá para o Management Console > Projetos para gerenciar o projeto implantado.

  • Organização: Use o menu suspenso para selecionar a organização para a qual você deseja importar o projeto. Se você tiver apenas uma organização, ela será selecionada por padrão.

  • Ambiente: Use o menu suspenso para selecionar o ambiente para onde você deseja importar o projeto.

    Cuidado

    Se o projeto de origem usar conectores disponíveis apenas em agentes privados, não é possível importá-lo para um ambiente associado a um grupo de agentes de nuvem. Esses ambientes ainda aparecem no menu suspenso Ambiente, mas não podem ser selecionados.

  • Incluir notificações por e-Email: Por padrão, se notificações por e-email foram incluídas como parte do projeto quando ele foi exportado, elas serão incluídas quando o projeto for importado. Esta opção se aplica a todas as notificações por e-email em um projeto, independentemente de estarem configuradas com ações de operação para executar em caso de sucesso, falha ou falha de SOAP ou se forem referenciados em um script. Para excluir notificações por e-email da importação, desmarque a caixa de seleção.

    Cuidado

    As referências a um componente de notificação por e-email em um script não são removidas, mesmo que as notificações por e-email sejam excluídas, portanto, talvez seja necessário corrigir quaisquer referências quebradas após excluir e-emails.

  • Incluir agendamentos: Por padrão, se agendamentos de operação foram incluídos como parte do projeto quando este foi exportado, eles serão incluídos quando o projeto for importado. Para excluir cronogramas da importação, desmarque a caixa de seleção.

  • endpoints globais: Quaisquer endpoints globais usados pelo projeto que está sendo importado são listados e devem ser adicionados ao ambiente selecionado usando uma destas opções:

    

    • Usar endpoint global existente: Visível somente quando o endpoint global já existe na organização. Selecione para adicionar um endpoint de ambiente a um endpoint global existente para o ambiente selecionado. Use o menu para selecionar o endpoint global existente:

      

      Se o endpoint global existente já tiver um endpoint de ambiente para o ambiente selecionado, o endpoint de ambiente existente será usado para o projeto importado. Se o endpoint global existente não tiver um endpoint de ambiente para o ambiente selecionado, as credenciais fornecidas no projeto importado serão usadas (se aplicável). Caso contrário, o endpoint de ambiente precisará ser configurado após a importação.

    • Criar novo endpoint global: Selecione para criar um novo endpoint global para a organização:

      

      Quando o projeto for importado, o endpoint global será adicionado ao ambiente selecionado e precisará ser configurado após a importação.

• Importar: Clique para importar o projeto. Se o projeto for importado com sucesso, ele será aberto na quadro de design. Além disso, o novo projeto está disponível em Projetos página.

  Após a importação do projeto, ele ainda não foi implantado. Quando estiver pronto para implantar, consulte Implantação do projeto.

Importar componentes de um projeto

Para importar apenas componentes especificados de um arquivo JSON de projeto para um projeto, use o menu de ações do projeto em um projeto e clique em Importar:

Uma caixa de diálogo de seleção de arquivo é aberta. Selecione um arquivo JSON do projeto que foi exportado. Na tela de configuração, selecione os componentes a serem importados para o projeto que está sendo acessado:

• Importar do projeto: Este painel exibe o nome do projeto a partir do arquivo JSON do projeto e os componentes disponíveis para importação a partir do arquivo JSON do projeto.

• Importar para o projeto: Este painel exibe o nome do projeto que está sendo acessado e quaisquer componentes no projeto.

• Componentes do projeto: Cada projeto categoria de componente disponíveis em um projeto são exibidos ao lado de um número entre parênteses que indica quantos componentes estão na categoria. Os componentes em uma categoria de componentes são listados em ordem alfabética. No painel Importar do projeto, use as caixas de seleção para selecionar os componentes a serem importados para o projeto que está sendo acessado.

• Expandir/recolher todas as categorias: Expande ou recolhe todas as categorias de componentes do projeto.

• Pesquisar: Use a caixa de pesquisa para inserir uma única palavra-chave ou sequência de palavras-chave. A sequência de palavras-chave é destacada em azul dentro do nome do componente:

  

• Mover para o projeto: Habilitado quando um componente é selecionado no painel Importar do projeto. Após clicar, os componentes selecionados e suas dependências são adicionados ao painel Importar para o projeto. Os componentes adicionados ao projeto são indicados com um ícone azul Novo:

  

• Conflitos: Quando um componente importado compartilha o mesmo nome de um componente da mesma categoria, ocorre um conflito:

  

  Quando presentes, os conflitos devem ser resolvidos para concluir a importação. Use o setas para cima e para baixo para navegar até cada conflito.

  Os Endpoints com conflitos têm estas ações:

  

  • Usar endpoint existente: Selecione para usar um endpoint configurado no projeto que está sendo acessado. Use o menu para selecionar o endpoint existente.

    • Substituir ou copiar componente: Se o endpoint existente do projeto e o endpoint importado tiverem o mesmo tipo de atividade com nomes correspondentes, estas opções ficarão disponíveis:

      • Substituir: Selecione para substituir o tipo de atividade existente pelo tipo de atividade que está sendo importado.

      • Manter ambos: Selecione para manter ambos os tipos de atividade de endpoint como componentes independentes. O nome do componente que está sendo importado é anexado com um número incrementado entre parênteses.

  • Criar novo endpoint: Selecione para criar um novo endpoint no projeto que está sendo acessado. Use o menu para selecionar Global (consulte Endpoints Globais) ou Nível de projeto.

  Todos os componentes com conflitos (exceto endpoints) têm estas ações:

  • Substituir: Substitui o componente existente pelo componente que está sendo importado. Os componentes importados que estão sendo usados como substitutos são indicados com um ícone roxo de Substituir:

    

  • Manter ambos: Mantém ambos os componentes. O nome do componente que está sendo importado é anexado com um número incrementado entre parênteses. Esses componentes são visualmente indicados com um ícone azul Novo:

    

  Estas ações são habilitadas somente quando alterações são feitas em conflitos:

  • Substituir Tudo: Clique para selecionar em massa Substituir (descrito acima) para todos os conflitos de componentes.

  • Manter Tudo: Clique para selecionar em massa Manter Ambos (descrito acima) para todos os conflitos de componentes.

  • Confirmar alterações: Habilitado somente quando uma ação é selecionada para todos os conflitos. Clique para salvar as ações de conflito selecionadas. Após clicar, o botão Concluir é habilitado.

  • Editar alterações: (Visível após clicar em Confirmar alterações.) Clique para editar as resoluções de conflitos.

• Redefinir tudo: Redefine o projeto ao seu estado original, removendo quaisquer componentes novos ou substituídos do painel Importar para o projeto.

• Concluir: Clique para importar os componentes e retornar ao projeto. Os componentes importados são categorizados em um grupo personalizado denominado Importado anexado com a data e hora da importação (em YYYY-MM-DD HH:MM:SS formato):

  

• Cancelar: Clique para cancelar o processo de importação e retornar ao projeto.