Crie e configure uma operação no Jitterbit Integration Studio

Introdução

Uma operação é a menor unidade dentro de um workflow que é executada independentemente em um agente e registrada pelo Harmony. As operações são usadas para definir o que um processo de integração deve fazer e quando deve ser feito.

As operações são compostas por uma combinação de atividades e ferramentas:

A combinação e a ordem específicas desses componentes devem seguir o conjunto de padrões válidos. Para obter detalhes sobre esses padrões, consulte Validade da operação.

Esta página explica as partes de uma operação e aborda como adicionar etapas às operações, acessar opções de menu, renomear operações, expandir/recolher operações, reordenar operações e reutilizar, remover ou mover etapas da operação.

Partes de uma operação

As operações são formadas pela organização de atividades e ferramentas dentro de uma operação na quadro de design. A operação pode consistir em apenas um único script, ou o arranjo pode formar uma sequência de etapas composta por uma ou mais atividades ou ferramentas. As combinações específicas permitidas são descritas em Validade da operação.

Atividades

Uma atividade é um componente criado a partir de uma conexão e que pode ser configurado para interagir com um endpoint. As atividades podem ser usadas em uma operação como origem ou destino e podem ser configuradas com esquemas de dados que representam os esquemas de solicitação e resposta para a interação com o endpoint. Além de serem usadas como uma etapa de operação, algumas atividades também podem ser referenciadas em scripts (consulte Endpoints em Jitterbit Script).

Para mais informações sobre os princípios básicos de conectores, bem como recursos para configurar conexões e atividades por tipo de conector, consulte as páginas em Conectores.

Fontes

Uma atividade de origem é qualquer atividade que fornece dados dentro de uma operação, que pode então ser transferido para um alvo inalterado ou alterado por uma transformação antes de atingir um alvo.

As atividades de origem exigem um esquema de dados somente se forem usadas como entrada em uma transformação:

• Se a atividade de origem estiver fornecendo dados que serão transformados, ela deverá ter um esquema de dados de resposta, que será fornecido automaticamente ou poderá ser definido durante a configuração da atividade ou transformação.
• Se a atividade de origem estiver fornecendo dados que não serão transformados, um esquema de resposta não precisa ser definido, pois o esquema de resposta não é usado na operação.

Atividades que são normalmente (mas não necessariamente) usadas como fontes incluem aquelas com uma destas palavras no nome da atividade:

• Download
• Pegar
• Ler
• Solicitar
• Consulta

Alvos

Uma atividade alvo é qualquer atividade que recebe dados dentro de uma operação. Esses dados podem vir de uma atividade de origem, de uma transformação, ou de outras entradas, como variáveis ou scripts.

As atividades de destino exigirão um esquema de dados somente se estiverem recebendo dados que foram transformados ou se fornecerem uma resposta que você deseja gravar em outro destino:

• Se a atividade de destino estiver recebendo dados que foram transformados, ela deverá ter um esquema de dados de solicitação, que será fornecido automaticamente ou poderá ser definido durante a configuração da atividade ou transformação.
• Se a atividade de destino estiver recebendo dados que não foram transformados, um esquema de solicitação não precisa ser definido, pois o esquema de solicitação não é usado na operação. Se um tipo específico de atividade de destino fornecer uma resposta, você também poderá ter um esquema de dados de resposta. Se desejar gravar a resposta em outro destino, o esquema de dados de resposta será fornecido automaticamente ou poderá ser definido durante a configuração da atividade ou transformação. Se o tipo de destino fornecer uma resposta, não será necessária uma operação para gravar a resposta em outro destino; ou seja, um esquema de resposta poderá ser fornecido, mas poderá ser ignorado na operação, se não for necessário.

Atividades que são normalmente (mas não necessariamente) usadas como alvos incluem aquelas com uma destas palavras no nome da atividade:

• Adicionar
• Criar
• Excluir
• Inserir
• Publicar
• Colocar
• Resposta
• Carregar
• Atualizar
• Inserir
• Escrever

Ferramentas

Uma ferramenta é um componente de projeto que fornece a interface para aplicar lógica ou condições específicas aos dados dentro de uma operação.

Scripts

Um script criado como um componente de projeto pode ser usado como uma etapa em uma operação para transformar dados, realizar cálculos ou realizar validação lógica. Por exemplo, você pode usar um script antes ou depois de uma atividade para recuperar dados e, em seguida, processar a lógica do script, ou pode executar um script de validação antes de prosseguir para uma transformação. Para obter mais informações, consulte Tipos e criação de Script.

Transformações

Uma transformação é um componente de projeto usado como uma etapa em uma operação para mapear ou transformar entradas em uma saída resultante, movendo dados, limpando dados ou aplicando lógica de negócios. Após criar uma transformação, você deve configurá-la mapeando várias entradas, como objetos de origem, variáveis ou scripts, para a saída de destino resultante, geralmente uma estrutura de dados de destino. Para obter mais informações, consulte Transformações.

Ferramentas adicionais

Ferramentas adicionais estão disponíveis na aba Ferramentas da paleta de componentes de design (consulte Ferramentas na paleta de componentes de design). Esses componentes do projeto implementam uma função específica e têm como objetivo substituir a necessidade de usar scripts para determinados scripts usados como componentes do projeto. Para obter mais informações, consulte Tipos de ferramentas e criação.

Adicionar etapas a uma operação

As operações são compostas por componentes de projeto que consistem em atividades ou ferramentas. Para criar operações, você coloca esses componentes em um workflow na quadro de design como etapas de uma operação.

Escolha a localização do componente em uma operação nova ou existente

O método de adição de um componente a uma operação depende se a operação está sendo criada recentemente ou se já existe:

• Nova Operação: Uma área de inserção de operações é exibida na quadro de design onde você pode adicionar um componente para criar uma nova operação. Em um workflow que ainda não possui nenhuma operação, a área de inserção é exibida sozinha na parte superior da quadro de design. Em um workflow que possui pelo menos uma operação, uma área de inserção é exibida sozinha na parte inferior da quadro de design, abaixo da última operação. Para mostrar áreas para soltar operação adicionais, passe o mouse sobre uma operação existente.

  

• Operação existente: As operações existentes são exibidas na quadro de design com um fundo cinza claro. Ao passar o mouse à esquerda ou à direita de um componente em uma operação existente, é exibida uma área de inserção de componentes, onde você pode adicionar um componente a uma operação existente.

  

Após decidir o local, as etapas para adicionar o componente serão diferentes, dependendo se o componente é uma atividade ou um script ou transformação, abordado a seguir.

Crie conexões e adicione e configure atividades

A paleta de componentes de design fornece acesso a recursos de conectividade. Aqui, conectores fornecem a interface que permite a inserção de informações fornecidas pelo usuário, como credenciais, para criar uma conexão. Na paleta de componentes, o filtro Conectores mostra os tipos de conectores que podem ser configurados:

Cada conector é representado por um ícone de pasta de conectores com o nome do conector. Clique em um conector para abrir uma tela de configuração e criar um novo endpoint 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 de conectores acessíveis no filtro Conectores.

Após criar uma conexão, ela será exibida no filtro Endpoints. Clique em um endpoint para abrir sua pasta 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.

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

Após criar uma atividade, você pode clicar duas vezes nela para configurá-la conforme descrito para cada atividade específica em Conectores.

Adicionar e configurar ferramentas

Você também pode querer adicionar ferramentas para uma operação. Uma ferramenta pode ser criada a partir destes locais:

• A aba Componentes do painel do projeto usando o menu Criar novo (consulte menu de ações da aba Componentes na aba Componentes do painel Projeto).

• A aba Ferramentas da paleta de componentes de design (consulte Ferramentas na paleta de componentes de design).

Além do acima, ferramentas de script e transformação podem ser criadas a partir da quadro de design usando uma área de inserção (consulte menu de ações da zona de lançamento em Tela de design):

Ao adicionar um script ou transformação, sua tela de configuração é aberta automaticamente. Para obter detalhes sobre a configuração, consulte Transformações e Scripts, respectivamente.

Menu de ações de operação

Após a criação de uma operação, as ações do menu para essa operação podem ser acessadas nestes locais:

• A aba Workflows do painel do projeto (consulte menu de ações do componente na aba Workflows do painel Projeto).

• A aba Componentes do painel do projeto (consulte menu de ações do componente na aba Componentes do painel Projeto).

• A quadro de design (veja menu de ações do componente em Tela de design).

Renomear operações e etapas de operação

Ao criar uma nova operação, seu nome padrão é Nova Operação. As novas operações subsequentes com nomes padrão são acrescidas de um número incrementado entre parênteses. Os nomes das operações devem ser exclusivos e não devem conter barras (/) ou dois pontos (:) para ser válido.

Operações e etapas de operação podem ser renomeadas a partir destes locais:

• A aba Workflows do painel do projeto (consulte menu de ações do componente na aba Workflows do painel Projeto).

• A aba Componentes do painel do projeto (consulte menu de ações do componente na aba Componentes do painel Projeto).

• A quadro de design (consulte Renomeando workflows, operações e etapas de operação em Tela de design).

As etapas da operação também podem ser renomeadas a partir de suas telas de configuração individuais.

Expandir ou recolher operações

Quando uma operação é criada, ela é expandida por padrão. As operações podem ser recolhidas ou expandidas individualmente ou todas de uma vez:

• Recolher uma operação individual: Para recolher uma operação individual, clique no ícone de recolhimento na barra de ação da operação.

  O recolhimento de uma operação exibe apenas o nome da operação e seu status de implantar:

  

• Expandindo uma operação individual: Para expandir uma operação individual quando ela estiver recolhida, clique no expandir ícone na barra de ação da operação.

• Recolher todas as operações: Para recolher todas as operações em um workflow, clique em Recolher todas as operações ou em recolher todos os ícones na parte superior da quadro de design.

• Expandindo todas as operações: Para expandir todas as operações em um workflow quando elas estiverem recolhidas, clique em Expandir todas as operações ou em expandir todos os ícones na parte superior da quadro de design.

Operações de reordenação

As operações podem ser reordenadas dentro ou entre workflows na aba Workflows do painel do projeto (consulte Reordenar operações na aba Workflows do painel Projeto).

As operações podem ser reordenadas dentro do mesmo workflow a partir da quadro de design (consulte Reordenar operações em Tela de design)