Exportar e importar mapeamentos de transformação no Jitterbit Integration Studio

Introdução

Um mapeamento consiste em todos os campos ou nós de destino e seus scripts correspondentes. Esses scripts podem conter referências a campos ou nós de origem ou a componentes do projeto, usar funções ou conter outra lógica de script válida. Um mapeamento não inclui campos de destino que não estão mapeados.

Depois de concluir um mapeamento de transformação, você pode exportar o mapeamento para referência, para compartilhar fora do projeto ou para reutilizar em outro lugar. Mapeamentos que foram exportados podem ser importados em uma transformação, com a capacidade de selecionar se os mapeamentos existentes serão substituídos.

Limitações

Dependendo da estrutura do esquema, certas exportações e importações de mapeamentos de transformação não são suportadas, conforme descrito abaixo.

Esquemas com valores e atributos

A exportação e importação de um mapeamento de transformação não é suportada com esquemas que contêm valores que têm pelo menos um atributo, conforme indicado visualmente com os símbolos # e @, respectivamente. Por exemplo:

Esquemas com caracteres especiais

Ao importar um mapeamento exportado que inclui campos ou nós de destino cujos nomes contêm caracteres especiais, os mapeamentos para esses campos e nós de destino são ignorados. Mapeamentos para campos e nós de destino que não contêm caracteres especiais são importados com sucesso.

Campos e nós de destino cujos nomes contêm qualquer um desses caracteres especiais são ignorados:

- . $ & #

Exportar um mapeamento de transformação

Para iniciar o processo de download, em qualquer modo, clique em Exportar no canto superior direito da estrutura de destino:

O arquivo exportado está no formato JSON e contém cada nó de destino e o conteúdo de quaisquer scripts, se incluídos. Observe que novas linhas são indicadas por \n. Um exemplo de exportação está incluído abaixo:

{
  "mappings": [
    {
      "targetNode": "json$",
      "script": ""
    },
    {
      "targetNode": "json$item.",
      "script": ""
    },
    {
      "targetNode": "json$item.userId$",
      "script": "<trans>\njson$item.userId$\n</trans>"
    },
    {
      "targetNode": "json$item.id$",
      "script": ""
    },
    {
      "targetNode": "json$item.title$",
      "script": ""
    },
    {
      "targetNode": "json$item.body$",
      "script": "<trans>\njson$item.title$\n</trans>"
    }
  ]
}

Importar um mapeamento de transformação

Para iniciar o processo de importação, clique em Importar no canto superior direito da estrutura de destino:

Isso abre uma caixa de diálogo onde você pode fornecer o mapeamento a ser importado:

• Arquivo: Clique no botão Procurar à direita para selecionar um arquivo que contenha o mapeamento. O arquivo deve estar no formato JSON.
• Carregar: Após selecionar um arquivo, clique para carregar o mapeamento e prosseguir para a próxima tela.
• Cancelar: Clique para fechar a caixa de diálogo de importação sem carregar um mapeamento.

Após carregar um arquivo, a próxima tela fornece uma lista de conflitos de mapeamento, se houver, e apresenta uma interface para selecionar quais mapeamentos usar:

• Campo de Destino Tem Mapeamento Existente: Campos de destino que já possuem um mapeamento existente que conflita com o que está sendo importado são listados à esquerda. Selecione as caixas de seleção de quaisquer campos de destino cujos mapeamentos você deseja substituir pelos do arquivo sendo importado. Você também pode clicar em Selecionar Todos para selecionar todos os campos ou Selecionar Nenhum para desmarcar todos os campos.
• Campo de Destino Não Existe: Campos de destino que não existem no mapeamento atual, mas estão incluídos no arquivo sendo importado, não podem ser mapeados. Esses campos estão listados à direita.
• Continuar: Clique para prosseguir e usar as seleções nesta tela para mesclar o mapeamento importado com o mapeamento existente e retornar à tela de mapeamento de transformação.
• Cancelar: Clique para fechar a tela de conflitos de mapeamento sem salvar. O mapeamento existente permanece inalterado.