Criação e configuração de operação

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 uma ou mais atividades, scripts ou transformações:

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 de operação.

Partes de uma operação

As operações são formadas pela organização de atividades, scripts e transformações 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 consistindo em uma ou mais atividades, scripts ou transformações. As combinações específicas que são permitidas são descritas em Validade da operação.

Atividades

Uma atividade é um componente que é 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 uma origem ou um 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 cada 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 uma meta.

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 é fornecido automaticamente ou pode 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 exigem 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 é fornecido automaticamente ou pode 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 você quiser gravar a resposta em outro destino, o esquema de dados de resposta será fornecido automaticamente ou poderá ser definido ao configurar a atividade ou transformação. Se o tipo de destino fornecer uma resposta, uma operação não será necessária para gravar a resposta em outro destino; ou seja, um esquema de resposta poderá ser fornecido, mas poderá ser ignorado dentro da 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

Scripts

Um script que é criado como um componente de projeto pode ser usado como uma etapa em uma operação para transformar dados, executar cálculos ou executar 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 de Script e criação.

Transformações

Uma transformação é um componente de projeto que é 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. Depois de 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.

Adicionar etapas a uma operação

As operações são compostas de componentes de projeto que consistem em atividades, scripts ou transformações. 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 dentro de uma operação nova ou existente

O método de adicionar 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 sempre que você pode adicionar um componente para criar uma nova operação. Em um workflow que ainda não tem nenhuma operação, a área de inserção é exibida na parte superior da quadro de design por si só. Em um workflow que tem pelo menos uma operação, uma área de inserção é exibida na parte inferior da quadro de design por si só, abaixo da última operação. Para mostrar zonas de lançamento de operação adicionais, passe o mouse sobre uma operação existente.

  

• Operação existente: Operações existentes são exibidas na quadro de design com um fundo cinza claro. Passar o mouse à esquerda ou à direita de um componente em uma operação existente mostra 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 sã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, connectors fornecem a interface inserindo a entrada fornecida pelo usuário, como credenciais para criar uma conexão. Dentro da paleta de componentes, o filtro Connectors mostra os tipos de conectores que podem ser configurados:

Cada conector é representado por um ícone de pasta de conectores rotulado com o nome do conector. Clique em um conector para abrir uma tela de configuração para criar um novo endpoint para acesso a um recurso de dados específico:

Para instruções detalhadas sobre como configurar uma conexão, veja 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 no filtro Conectores.

Após criar uma conexão, ela é mostrada 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-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.

Adicionar e configurar transformações ou scripts

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.

Menu de ações de operação

Após a criação de uma operação, as ações de 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

Quando você cria uma nova operação, seu nome padrão é Nova Operação. Novas operações subsequentes com nomes padrão são anexadas com 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 colapso 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 no expandir tudo ícone 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 na quadro de design (consulte Reordenar operações em Tela de design)