Exportar e importar um projeto no Jitterbit Integration Studio

Introdução

Esta página descreve como exportar e importar um projeto e 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.

Integration Studio as exportações de projeto estão no formato de um arquivo JSON. Depois que você tiver uma exportação de projeto JSON, ela pode ser importada para qualquer organização.

Exportar um projeto

As opções Exportar ou Exportar Projeto são acessíveis a partir destes locais:

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

Além disso, a tela de exportação do projeto pode ser acessada usando o 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 Export ou Export Project, a tela de exportação do projeto é aberta, onde você escolhe as opções de exportação e gera o projeto como um arquivo JSON:

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

  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 usando o Connector SDK pode designar tais campos com qualquer um destes atributos:

  • "secret": "true": Designa apenas que o campo é 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 no Integration Studio UI 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 se a opção Ocultar valor estiver selecionada na UI (consulte Variáveis do projeto). Em vez disso, se os valores de variáveis do projeto são incluídos é controlado com a seleção Incluir valores de variáveis do projeto.

  Se uma variável do 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 de sintaxe de colchetes do nome da variável do projeto e qualquer outra entrada, se presente.

  Quando Include Credentials não é selecionado, o campo credentials "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 do 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 email no projeto exportado. Esta opção se aplica a todas as notificações de 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.

• Export: 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 foi 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 página) permite que você importe o projeto inteiro para sua organização.

2. Importar componentes de um projeto (beta): 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, você importa o projeto:

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

  Dica

  Se o projeto usar algum conector personalizado, ele deverá existir na organização antes de importar o projeto. Para exportar um conector do Connector Builder e importá-lo em outra organização, consulte Exportações e importações do Connector Builder. Para instalar um conector do Connector SDK 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 é pré-preenchido 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 o qual você deseja importar o projeto.

    Cuidado

    Se o projeto de origem usar conectores que estão disponíveis apenas em agentes privados, você não pode 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 email foram incluídas como parte do projeto quando ele foi exportado, elas são incluídas quando o projeto é importado. Esta opção se aplica a todas as notificações por email em um projeto, independentemente de elas estarem configuradas com ações de operação para executar em caso de sucesso, falha ou falha de SOAP ou se eles forem referenciados em um script. Para excluir notificações de email da importação, desmarque a caixa de seleção.

    Cuidado

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

  • Incluir cronogramas: Por padrão, se cronogramas de operação foram incluídas como parte do projeto quando ele foi exportado, elas são incluídas quando o projeto é importado. Para excluir cronogramas de serem importados, 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 foi importado com sucesso, o projeto importado abre na quadro de design. Além disso, o novo projeto está disponível em Projetos página.

  Após o projeto ser importado, ele ainda não está implantado. Quando estiver pronto para implantar, consulte Implantação do projeto.

Importar componentes de um projeto (beta)

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 (Beta):

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, você seleciona os componentes a serem importados para o projeto que está sendo acessado no momento:

• Importar do projeto: Este painel exibe o nome do projeto do arquivo JSON do projeto e os componentes disponíveis para serem importados 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ível em um projeto é exibido ao lado de um número entre parênteses indicando quantos componentes estão na categoria. Os componentes em uma categoria de componente 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 no momento.

• 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 fica destacada em azul dentro do nome do componente:

  

• Mover para o projeto: Habilitado quando um componente é selecionado no painel Importar do projeto. Uma vez clicado, 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 na mesma categoria de componente, 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 que esteja configurado no projeto que está sendo acessado no momento. 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 no momento. Use o menu para selecionar Global (veja Conexões Globais) ou Nível de projeto.

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

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

    

  • 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 indicados visualmente com um ícone azul Novo:

    

  Essas 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. Depois de clicado, o botão Concluir é habilitado.

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

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

• Concluir: Clique para importar os componentes e retornar ao projeto.

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