Guia de início rápido para o Jitterbit Integration Studio

Introdução

Este guia é destinado a novos usuários do Integration Studio, o aplicativo de design de projetos baseado na web da Jitterbit. Este guia cobre o básico para começar criando um novo projeto do zero e fornece uma visão geral dos conceitos de design de projetos.

Para um guia abrangente e um passo a passo, faça o curso Introdução ao Jitterbit Integration Studio na Jitterbit University. Como parte deste curso, você também pode consultar os tutoriais suplementares que cobrem uma variedade de casos de uso para ajudar você a começar.

O Jitterbit Marketplace também oferece centenas de projetos pré-construídos, disponibilizando receitas de integração do Integration Studio e modelos de processo do Integration Studio. Para começar com uma receita ou modelo existente, veja Iniciando um projeto de receita ou modelo.

Acessar o Integration Studio

O Integration Studio é acessado diretamente através do portal Harmony.

Na página inicial do portal Harmony, clique no bloco do aplicativo Integration Studio:

O Integration Studio abre na página Projetos, onde você pode criar seu primeiro projeto, a seguir.

Criar um projeto

A página Projetos mostra um repositório de projetos acessíveis do Integration Studio. Na primeira vez que você acessar o Integration Studio, esta tela estará em branco. Clique em Novo Projeto para começar:

Preencha as informações básicas do projeto na aba Geral e, em seguida, clique em Começar a Projetar para abrir o designer de projetos.

Projetar um projeto

O designer de projetos é a interface onde você projeta um projeto. O designer de projetos inclui a barra de ferramentas do projeto, o painel do projeto, a tela de design e uma paleta de componentes, além das telas de configuração para cada componente, como aquelas para transformações, scripts, endpoints e atividades.

Ao abrir um projeto, essas partes do designer de projetos são exibidas, como mostrado no exemplo abaixo para um projeto que já foi projetado:

Geralmente, você projeta fluxos de trabalho — ou coleções de operações agrupadas para a conveniência do usuário — dentro da tela de design usando as ferramentas fornecidas na paleta de componentes, no painel do projeto e na própria tela de design.

As próximas seções descrevem o processo básico de design:

1. Estabelecer conectividade
2. Criar etapas de operação
3. Encadear operações usando ações de operação
4. Implantar e executar operações

Estabelecer conectividade

A paleta de componentes de design fornece acesso a recursos de conectividade. Aqui, conectores fornecem a interface para inserir entradas fornecidas pelo usuário, como credenciais, para criar uma conexão. Na aba Endpoints e conectores do projeto da paleta de componentes, a categoria Conectores mostra os tipos de conectores que podem ser configurados. Cada conector é representado por um ícone de pasta de conector e o nome do conector. Clique em um conector para abrir uma tela de configuração e criar uma nova conexão para acessar um recurso de dados específico:

Para instruções detalhadas sobre como configurar um endpoint, consulte a conexão específica em Conectores. Cada vez que você cria um novo endpoint, deve fazê-lo a partir dos ícones de pasta de conector acessíveis na categoria Conectores.

Uma vez que você tenha criado uma conexão, ela é exibida na categoria Endpoints. Clique em um endpoint para abrir a pasta do conector e revelar os tipos de atividades — interações com um recurso de dados — que podem ser configuradas para esse endpoint.

Um endpoint na interface do usuário do Integration Studio refere-se a um recurso de dados configurado (conector) e suas atividades. (Veja Uso de Endpoints (Beta) para a definição de um endpoint licenciado.)

Criar etapas de operação

Operações que definem o que a integração deve fazer são criadas adicionando e configurando etapas de operação — compostas por atividades, transformações e/ou scripts — na tela de design.

A seção Estabelecer conectividade acima mostrou como criar um endpoint e ver seus tipos de atividade.

Para criar uma instância de uma atividade, coloque um tipo de atividade na tela de design arrastando-o ou copiando-o para uma zona de soltura de operação ou componente:

Uma vez que uma atividade é criada, você pode clicar duas vezes nela para configurá-la conforme descrito para cada atividade específica em Conectores.

Para adicionar atividades adicionais, coloque-as em outra zona de soltura. Zonas de soltura de operação adicionais são mostradas ao passar o mouse sobre uma operação existente. Zonas de soltura de componente em operações existentes são mostradas ao passar o mouse à esquerda ou à direita dos passos de operação existentes. Uma configuração comum é configurar uma atividade como a fonte de dados e uma segunda atividade à sua direita como o destino dos dados.

Você também pode querer adicionar ferramentas a uma operação. Ferramentas fornecem a interface para aplicar lógica ou condições específicas aos dados dentro de uma operação.

Para adicionar ferramentas de transformação ou script diretamente a uma operação, clique com o botão direito ou clique no menu de ações em uma zona de soltura e selecione Novo Script ou Nova Transformação:

Quando você adiciona um script ou transformação, a tela de configuração é aberta automaticamente. Para detalhes sobre configuração, consulte Transformações e Scripts, respectivamente.

Encadear operações usando ações de operação

Após mais de uma operação ser criada, você pode configurar ações de operação para acionar outras operações para serem executadas, enviar emails ou escrever mensagens no log após uma operação ser bem-sucedida ou falhar.

Para configurar essas ações, clique no ícone do menu de ações na barra de ações da operação, em seguida, clique em Configurações.

Na aba Ações das configurações, selecione a condição que deve acionar a ação, qual ação deve ser tomada e quaisquer parâmetros adicionais, como qual outra operação deve ser configurada para ser executada. Para detalhes, veja Ações de operação.

Uma vez que essas ações estejam configuradas, linhas aparecem na tela de design para indicar visualmente quaisquer ações que estão configuradas para serem executadas em caso de sucesso (linhas verdes) ou em caso de falha (linhas vermelhas) da operação. Uma operação sendo iniciada com base nas ações de operação é dita estar a jusante de uma operação a montante anterior.

Implantar e executar operações

Depois de desenvolver uma cadeia de operações, você a implanta em um agente Jitterbit e a executa. Para implantar e executar uma operação, clique no ícone de implantar e executar na barra de ações da operação.

Quaisquer operações que estejam a jusante da operação sendo implantada e executada também estão incluídas.

Em vez de execução manual, você também pode configurar operações para serem executadas em um cronograma, ou em um acionador de API ou acionador de evento. Para mais informações, veja Implantação e execução de operações.

Após a execução das operações, você pode validar o comportamento adequado visualizando os logs. Para visualizar logs de uma operação específica e operações a jusante, clique no ícone do menu de ações no canto superior direito de uma operação e selecione Ver Logs. Para mais informações, veja Logs de operação.

Recursos adicionais

Enquanto você projeta um projeto, consulte as informações detalhadas organizadas por tópico em Integration Studio:

• Projetos: Aprenda o básico sobre permissões de projeto, colaboração e salvamento, e sobre como criar, configurar, implantar, transferir, exportar, importar e excluir projetos.
• Componentes do Projeto: Navegue pelas informações sobre quais componentes de projeto existem e quais ações compartilhadas você pode realizar com cada componente.
• Fluxos de Trabalho: Encontre informações sobre como criar, implantar e excluir fluxos de trabalho, dependências e o que torna um fluxo de trabalho válido.
• Operações: Consulte detalhes sobre como criar operações; configurar as configurações da operação, como ações, opções e cronogramas; visualizar logs de operações; implantar e executar operações; visualizar dependências e excluir operações; e o que torna uma operação válida.
• Conectores: Consulte a documentação específica do endpoint sobre como configurar conexões e atividades para se conectar e interagir com um endpoint específico.
• Transformações: Leia sobre os conceitos básicos e aprenda as complexidades de mapear entradas de dados para a saída de destino desejada.
• Esquemas: Conheça os vários tipos de esquemas e aprenda como saber quando usá-los.
• Scripts: Descubra a flexibilidade e o poder dos scripts para transformar dados, realizar cálculos ou validar lógica dentro de operações ou transformações.
• Funções: Consulte descrições e exemplos de funções que podem ser usadas em scripts para aprimorar e refinar processos de dados.
• Variáveis: Confira os diferentes tipos de variáveis e como elas podem ajudá-lo a ser mais eficiente no design de um projeto.
• Notificações: Veja como personalizar mensagens de email que podem ser acionadas em caso de sucesso ou falha de uma operação ou chamadas de um script.
• Plugins: Informe-se sobre como você pode estender as capacidades nativas do Harmony usando plugins fornecidos pela Jitterbit ou pelo usuário.

Usuários avançados também podem se interessar em criar seus próprios conectores para o Integration Studio usando o Connector Builder ou o Connector SDK.