Guia rápido para Jitterbit Studio

Introdução

Este guia é destinado a novos usuários do Studio, a aplicação de design de projetos baseada na web da Jitterbit. Este guia cobre o básico para começar a criar 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 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 Studio e modelos de processo do Studio. Para começar com uma receita ou modelo existente, veja Iniciando um projeto de receita ou modelo.

Acessar o Studio

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

Na página inicial do portal Harmony, clique no bloco da aplicação Studio:

O 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 do Studio acessíveis. Na primeira vez que você acessar o 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 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. 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. Dentro da 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 para criar uma nova conexão para acesso a 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 da pasta do 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 Studio refere-se a um recurso de dados configurado (conector) e suas atividades. (Consulte Uso de Endpoints (Beta) para a definição de um endpoint licenciado.)

Etapas da operação de criação

As 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 exibidas 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 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 ferramentas a uma operação. As 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 drop 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 a configuração, consulte Transformações e Scripts, respectivamente.

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

Depois que mais de uma operação é criada, você pode configurar ações de operação para acionar outras operações a 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, consulte Ações de operação.

Uma vez que essas ações estão 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 em ações de operação é dita estar a jusante de uma operação a montante anterior.

Implantar e executar operações

Após 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 gatilho de API ou gatilho de evento. Para mais informações, consulte 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, consulte Logs de operações.

Recursos adicionais

Enquanto você projeta um projeto, consulte as informações detalhadas organizadas por tópico em 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 configurações de 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 a identificar 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 a partir 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 estar interessados em criar seus próprios conectores para o Studio usando o Construtor de Conectores ou o SDK de Conectores.