Esquemas espelhados no Jitterbit Integration Studio

Introdução

Se você estiver usando um esquema no lado de origem ou destino de uma transformação e quiser copiar sua estrutura para usar no outro lado da transformação, você pode espelhar o esquema dentro da transformação. Uma vez que um esquema é espelhado, ele se torna um esquema personalizado que você pode editar no editor de esquema para um esquema plano personalizado ou esquema hierárquico personalizado.

O espelhamento de um esquema só é possível quando a origem ou o destino para o qual o esquema está sendo copiado não é um esquema gerado pelo conector adjacente.

Crie um esquema espelhado

A opção de espelhar um esquema está disponível somente quando certas condições são atendidas. Esta seção descreve primeiro quando o espelhamento está disponível e, em seguida, aborda como espelhar um esquema. O esquema resultante gerado a partir do espelhamento de um esquema está no mesmo formato do esquema que está sendo espelhado. Por exemplo, se você espelhar um esquema JSON, obterá um esquema JSON; se você espelhar um esquema XML, obterá um esquema XML resultante, etc.

Quando o espelhamento está disponível

Para poder espelhar um esquema, primeiro adicione uma transformação para uma operação e definir seu esquema de origem ou de destino de qualquer uma das maneiras descritas em Esquemas definidos em uma atividade ou Esquemas definidos em uma transformação (exceto para a opção de esquema espelhado).

Dependendo se o esquema de origem ou de destino é definido, o esquema do outro lado da transformação não deve ser definido para que a opção de espelhamento esteja disponível. Se a operação tiver uma atividade do outro lado da transformação, durante a configuração da atividade ao fornecer um esquema de solicitação ou resposta, certifique-se de selecionar Nenhum na seleção suspensa do esquema para que o esquema não seja herdado pela transformação.

A origem ou o destino para o qual o esquema está sendo copiado não pode ter um esquema gerado pelo conector adjacente; no entanto, qualquer atividade de origem ou destino com um esquema definido pelo usuário pode ter um esquema copiado para ela, mesmo que a origem da cópia seja de uma atividade gerada pelo conector. Por exemplo, você pode espelhar o esquema gerado de uma Consulta de Banco de Dados usada como a origem de uma transformação se o destino de uma transformação tiver um esquema definido pelo usuário, como o de uma atividade Gravação de FTP. No entanto, você não pode espelhar um esquema fornecido por uma atividade Leitura de FTP para usar como o esquema de destino para uma atividade Inserção de Banco de Dados, pois você deve usar o esquema gerado pelo endpoint do Banco de Dados. Nesses casos, a opção de espelhamento não está presente.

Espelhar um esquema

Desde que as condições acima sejam atendidas, a opção de espelhamento é exibida em modo de mapeamento no lado de origem ou destino da transformação. Dentro da transformação, clique no botão apropriado para Mirror Target Schema ou Mirror Source Schema no respectivo lado da transformação:

• Lado da origem: Para copiar um esquema usado no lado de destino da transformação para o lado da origem, clique em Espelhar esquema de destino no lado da origem:

  

• Lado de destino: Para copiar um esquema usado no lado de origem da transformação para o lado de destino, clique em Espelhar esquema de origem no lado de destino:

  

Isso copia a estrutura de origem ou destino de um lado da transformação para o outro, respectivamente, criando um novo esquema JSON chamado "Esquema Espelhado" por padrão:

Na maioria dos casos, o esquema espelhado resultante é uma cópia exata do esquema que está sendo espelhado, convertido para o formato JSON. Há duas exceções fornecidas como auxílio ao usuário:

• Atividades de banco de dados: Se o esquema que está sendo espelhado for de uma Atividade de banco de dados usando uma única tabela (sem junções), então o esquema espelhado resultante é criado automaticamente com um nó filho adicional chamado row. Quando campos dentro deste nó adicional são mapeados, o nó se torna um nó de loop para permitir que todos os registros sejam percorridos.
• Atividades baseadas no Salesforce: Se o esquema que está sendo espelhado for de um Salesforce não em massa, Salesforce Service Cloud, ou atividade ServiceMax, então o esquema espelhado resultante é criado automaticamente com um nó raiz adicional chamado records com o(s) nó(s) filho(s) espelhando o esquema. Quando campos dentro do(s) nó(s) filho(s) são mapeados, o nó se torna um nó de loop para permitir que todos os registros sejam passados em loop.

Para obter mais informações, consulte Nós de loop em Nós e campos.

Uma vez criado, o esquema espelhado é independente do esquema de origem do qual foi espelhado. Ou seja, você pode renomear ou editar esse esquema da maneira que escolher sem afetar o esquema de origem original. Como o espelhamento de um esquema copia o esquema inteiro, dessa forma você pode primeiro espelhar um esquema e depois editá-lo para remover campos para aparar o esquema (por exemplo, para copiar um esquema de banco de dados para apenas algumas tabelas que estão sendo unidas).

Menu de ações do esquema

Após a criação de um esquema espelhado, você pode acessar opções de menu adicionais disponíveis para todos os esquemas.

Isso inclui excluir, renomear, visualizar dependências de, implantar, implantar configurável e adicionar a um grupo, bem como editar um esquema ou limpar um esquema de uma transformação. Para obter detalhes sobre essas ações, consulte menu de ações do esquema.