Uso de esquema no Jitterbit Integration Studio

Introdução

Os esquemas são usados para representar as estruturas de solicitação e resposta em uma transformação. Esses esquemas podem ser herdados de atividades que são inicialmente adjacentes à transformação ou podem ser definidos diretamente em uma transformação. Esta página descreve quando os esquemas são usados e como os esquemas são definidos.

Quando um esquema é usado

O uso de um esquema depende da atividade e se ele está sendo usado como origem ou destino de uma transformação.

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

Como os esquemas são definidos

Os esquemas são definidos em uma atividade ou em uma transformação. Em uma operação, um esquema fornecido em uma atividade adjacente (ou uma atividade inicialmente adjacente que foi removida) tem precedência sobre um esquema definido em uma transformação.

Os esquemas definidos em uma atividade podem ser gerados pelo conector ou definidos pelo usuário:

• Gerado pelo conector: Os esquemas gerados pelo conector são fixos no conector ou são gerados diretamente do endpoint. Dependendo da atividade específica, um esquema de solicitação ou resposta, ou ambos, um esquema de solicitação e resposta, podem ser fornecidos. Os esquemas gerados pelo conector têm um nome gerado automaticamente que depende se o esquema é uma solicitação ou resposta:

  User-defined Endpoint Name→User-defined Activity Name→Request
  

  User-defined Endpoint Name→User-defined Activity Name→Response
  

  Esta transformação mostra os nomes dos esquemas gerados pelo conector sendo herdados de atividades em seus lados de origem e destino:

  

  Dependendo do conector, a estrutura de alguns esquemas gerados pelo conector pode ser editada pelo usuário, ou a estrutura pode mudar dinamicamente com base na entrada do usuário fornecida durante a configuração da atividade ou com base em alterações no próprio endpoint.

  Os nomes dos esquemas gerados pelo conector não podem ser editados por um usuário.

• Definido pelo usuário: Esquemas definidos pelo usuário são fornecidos pelo usuário, seja criando um esquema personalizado, carregando um arquivo ou URL ou inserindo manualmente o esquema. Dependendo da atividade específica, um esquema de solicitação ou resposta, um esquema de solicitação e resposta ou nenhum esquema pode ser definido.

  Os nomes dos esquemas definidos pelo usuário são baseados no nome do arquivo fornecido ou são definidos pelo usuário.

Quando usadas em uma operação, atividades que têm um esquema de solicitação não precisam necessariamente ser precedidas por uma transformação. Da mesma forma, atividades que têm um esquema de resposta não precisam necessariamente ser seguidas por uma transformação. Em alguns casos, como uma operação projetada para arquivar arquivos de uma fonte de dados para um destino sem uma transformação, nenhum esquema é necessário; se forem especificados, eles são simplesmente ignorados.

Em uma operação, se uma transformação requer um esquema de origem, ela deve ser precedida por uma atividade que fornece um esquema de resposta. Outras regras e padrões para construir uma operação válida são abordados em Validade da operação.

Os esquemas de resposta e solicitação fornecidos pela atividade sempre substituem os esquemas de origem e destino fornecidos pela transformação, se presentes:

• esquema de resposta fornecido pela atividade: Quando uma atividade do conector com um esquema de resposta é colocada antes de uma transformação, o esquema de resposta da atividade é herdado pela transformação como o esquema de origem e substitui qualquer esquema fornecido pela transformação.
• esquema de solicitação fornecido pela atividade: Quando uma atividade do conector com um esquema de solicitação é colocada após uma transformação, o esquema de solicitação da atividade é herdado pela transformação anterior como o esquema de destino e substitui qualquer esquema fornecido pela transformação.

Todas as transformações são reutilizáveis, independentemente de onde seus esquemas vêm. No entanto, há considerações especiais ao referenciar em outra operação uma transformação que tem um esquema fornecido por uma atividade, conforme descrito em Reutilização de Transformação.

Se um esquema fornecido pela transformação estava presente antes da configuração de uma atividade adjacente, esse esquema não pode ser limpo diretamente. Embora um esquema fornecido pela transformação permaneça referenciado pela transformação, ele não é usado no processamento. Para limpar um esquema fornecido pela transformação nessas circunstâncias, você pode remover temporariamente a atividade adjacente primeiro. Depois que a atividade adjacente for removida, um esquema fornecido pela transformação pode ser limpo usando o menu de ações do esquema para selecionar Limpar esquema. Depois de limpar o esquema fornecido pela transformação, você pode substituir a atividade na operação.