Integration Studio guia de início rápido¶

Introdução¶

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

Para um guia abrangente e passo a passo, faça o Introdução ao Jitterbit Integration Studio curso na Universidade Jitterbit. Como parte deste curso, você também pode consultar o Manual de treinamento de laboratório para módulos práticos suplementar abrangendo uma variedade de casos de uso para ajudar você a começar.

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

Acesso Integration Studio¶

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

Na página de aterrissagem do portal Harmony, clique em Integration Studio ficha de aplicação:

Integration Studio abre na página Projetos, onde você pode criar seu primeiro projeto, em seguida.

Criar um projeto¶

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

Preencha informações básicas do projeto na aba Geral e então clique em Iniciar Design para abrir o designer de projeto.

Desenhar um projeto¶

O designer de projeto é a interface onde você projeta um projeto. O designer de projeto inclui a barra de ferramentas do projeto, o painel do projeto, a quadro de design e uma paleta de componentes, bem como as telas de configuração para cada componente, como aquelas para transformações, scripts, conexões e atividades.

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

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

As próximas seções abordam 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. Implementar e executar operações

Estabelecer conectividade¶

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

Para obter instruções detalhadas sobre como configurar uma conexão, consulte a conexão específica em Conectores. Cada vez que você criar uma nova conexão, você deve fazê-lo a partir dos ícones da pasta do conector acessíveis na categoria Conectores.

Após criar uma conexão, ela é mostrada na categoria Endpoints. Clique em uma conexão para abrir a pasta do conector e revelar os tipos de atividades — interações com um endpoint — que podem ser configuradas para essa conexão.

Um endpoint se refere a uma conexão específica e suas atividades, que são configuradas como origens (para fornecer dados) ou destinos (para consumir dados) em um projeto.

Criar etapas de operação¶

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

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

Para criar uma instância de uma atividade, coloque um tipo de atividade na quadro de design arrastando-o ou copiando-o para uma área de inserção de componentes de operação ou componente:

Depois 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 área de inserção. Drop zones de operação adicionais são mostradas ao passar o mouse sobre uma operação existente. Drop zones de componentes em operações existentes são mostradas ao passar o mouse para a esquerda ou direita das etapas 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 transformações ou scripts a uma operação. Transformações são usadas quando você quer transformar dados antes de atingir seu destino. Scripts podem ser usados dentro de transformações em campos e nós de destino para aplicar lógica ou condições especificadas aos dados. Scripts também podem ser usados como etapas opcionais dentro de uma operação para uma variedade de propósitos, como tratamento de erros ou looping por registros de dados.

Para adicionar uma nova transformação ou script diretamente a uma operação, clique com o botão direito do mouse ou clique no menu de ações em uma área de inserção e selecione Novo Script ou Nova Transformação:

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

Encadeie operações usando ações de operação¶

Depois que mais de uma operação for criada, você pode configurar ações de operação para acionar a execução de outras operações, enviar emails ou gravar 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 de operação e 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 obter detalhes, consulte Ações de operação.

Uma vez que essas ações são configuradas, linhas aparecem na quadro de design para indicar visualmente quaisquer ações que sã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 em ações de operação é dita estar a abaixo de uma operação a acima na cadeia antes dela.

Implantar e executar operações¶

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

Todas as operações que estão a abaixo da operação que está sendo implantada e executada também sã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 gatilho de API ou gatilho de evento. Para obter mais informações, consulte Implementação e execução de operação.

Após as operações serem executadas, você pode validar o comportamento adequado visualizando os logs. Para visualizar os logs de uma operação específica e operações abaixo, clique no ícone do menu de ações no canto superior direito de uma operação e selecione Exibir Logs. Para obter mais informações, consulte Logs de operação.

Recursos adicionais¶

Ao elaborar um projeto, consulte as informações detalhadas organizadas por tópico em Integration Studio:

• Projetos: Aprenda noções básicas sobre permissões de projetos, colaboração e salvamento, e sobre como criar, configurar, implantar, migrar, exportar, importar e excluir projetos.
• Componentes do Projeto: Navegue pelas informações sobre quais componentes do projeto existem e quais ações compartilhadas você pode realizar com cada componente.
• Workflows: Encontre informações sobre como criar, implantar e excluir workflows, dependências e o que torna um workflow válido.
• Operações: Detalhes de referência sobre como criar operações; configurar definições de operação, como ações, opções e agendamentos; visualizar logs de operação; 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 do mapeamento de entradas de dados para a saída de destino desejada.
• Schemas: Conheça os vários tipos de esquemas e aprenda a saber quando usá-los.
• Scripts: Descubra a flexibilidade e o poder dos scripts para transformar dados, realizar cálculos ou executar validação lógica em operações ou transformações.
• Funções: Procure 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 ajudar você a ser mais eficiente na hora de criar um projeto.
• Notificações: Veja como personalizar mensagens de email que podem ser disparadas em caso de sucesso ou falha de uma operação ou chamadas de um script.
• Plugins: Eduque-se sobre como você pode estender os recursos nativos do Harmony usando plugins Jitterbit ou fornecidos pelo usuário.

Usuários avançados também podem estar interessados em criar seus próprios conectores para Integration Studio usando o Connector Builder do Jitterbit ou SDK do conector.