Reutilizar endpoints e scripts no Jitterbit Studio

Introdução

Este guia descreve técnicas para reutilizar trabalho em projetos do Studio: construir um projeto base reutilizável, configurar endpoints dinamicamente com variáveis, reutilizar scripts independentes e importar componentes individuais de um projeto existente. A aplicação dessas técnicas reduz a duplicação e mantém a configuração consistente entre projetos e ambientes.

Projeto base

Um cenário típico para reutilizar um projeto envolve o desenvolvimento de um projeto base com o uso extensivo de variáveis globais e, especialmente, variáveis de projeto.

Itens configuráveis (como credenciais de endpoint, mapeamentos de campos opcionais, consultas parametrizadas, endereços de e-mail e nomes de arquivos) podem ser expostos como variáveis de projeto.

O projeto base também pode conter funções comuns, como tratamento de erros ou o uso de caches em todo o ambiente.

Ao exportar um projeto base, selecione Incluir Valores de Variáveis de Projeto para preservar os valores padrão de todas as variáveis de projeto na exportação. Isso é importante para um projeto base construído em torno de configuração parametrizada. Você também pode escolher se deseja incluir credenciais, notificações por e-mail e cronogramas de operações. Consulte Exportar um projeto para o conjunto completo de opções de exportação.

O arquivo JSON exportado pode ser importado como um novo projeto em qualquer ambiente ou organização. O projeto importado não é implantado automaticamente após a importação; configure os valores de variáveis de projeto específicos do ambiente antes de implantar.

Reutilização de endpoint

Endpoints, criados configurando uma conexão e atividades associadas usando conectores, são frequentemente usados em operações. No entanto, um endpoint único não precisa necessariamente ser construído para cada operação. Como as configurações de atividade aceitam variáveis para caminhos e nomes de arquivos, endpoints genéricos podem ser construídos uma vez e, em seguida, configurados dinamicamente usando variáveis globais e de projeto.

Por exemplo, suponha que uma conexão HTTP v2 e uma atividade associada sejam criadas, e a configuração da atividade especifique um caminho definido por uma variável global, como gv_http_path. Um script controlador pode ser usado para preencher gv_http_path conforme necessário.

Outro exemplo é uma atividade de Consulta de Banco de Dados com uma condição. Sua condição WHERE pode ser atribuída a uma variável global, como gv_database_condition.

A maioria dos endpoints tem a capacidade de ser configurada usando variáveis.

Reutilização de scripts

Scripts autônomos scripts que realizam uma função específica, como retornar uma consulta de banco de dados ou calcular um resultado a partir de uma série de argumentos, podem ser candidatos à reutilização, especialmente se usados em múltiplas operações.

Por exemplo, se um script usa a função DBLookup contra uma tabela de banco de dados, e essa função é usada em todo o projeto, então um script autônomo (separado de uma operação) pode ser construído. Usando a função ArgumentList ou variáveis globais simples, o script pode aceitar argumentos e retornar um resultado. Como cada cadeia de operação é um escopo diferente, o mesmo script pode ser chamado com segurança de múltiplas operações simultâneas.

Para orientações sobre como armazenar credenciais em variáveis de projeto de forma segura, consulte Gerenciar credenciais de endpoint. Para convenções de nomenclatura que mantêm as variáveis de projeto consistentes em um projeto base, consulte Usar uma convenção de nomenclatura para variáveis.

Importação seletiva de componentes

Em vez de importar um projeto base inteiro, você pode importar componentes específicos (como endpoints individuais ou scripts) de um projeto existente ou de um arquivo JSON de projeto para um projeto existente. Isso é útil quando você deseja reutilizar um endpoint bem testado ou um script compartilhado sem importar o restante de um projeto base.

Para importar componentes de forma seletiva, abra o menu de ações do projeto e clique em Importar do Projeto. A importação ocorre em duas etapas:

Opções de importação: Escolha entre fazer o upload de um arquivo JSON de projeto local ou selecionar um projeto existente no mesmo ambiente que o projeto de destino.
Escolher componentes: Navegue pelos componentes por categoria e selecione os que deseja importar. Por padrão, Selecionar dependências automaticamente está habilitado, o que inclui automaticamente todas as dependências necessárias de um componente selecionado.

Se um componente importado compartilhar um nome com um componente existente do mesmo tipo, o conflito deve ser resolvido antes que a importação possa ser concluída. Para endpoints, você pode usar um endpoint existente ou criar um novo. Para outros componentes, você pode substituir o componente existente ou manter ambos (o componente importado é renomeado com um sufixo numérico).

Os componentes importados são agrupados em uma pasta personalizada rotulada como Importado com a data e hora da importação.

Para detalhes completos, consulte Importação seletiva em Exportar e importar um projeto.