Você pode mapear:
- elementos de origem simples para elementos de destino simples
- estruturas de origem para estruturas de destino (em que a origem e o destino são do mesmo tipo)
estruturas de origem para estruturas de destino (em que a origem e o destino são de tipos diferentes)
- vários elementos de origem simples para um elemento de destino simples
As
seções a seguir descrevem como executar o mapeamento desses cenários
específicos utilizando o
Editor de Mapeamento de Mensagens.
Mapeando elementos de
origem simples para elementos de destino simples
No exemplo a
seguir, o elemento de origem chamado Name não contém o mesmo filho do
elemento de destino chamado Name:
Origem |
Destino |
Name
Title
First_name
Middle_name
Last_name
|
Name
Title
First_names
Last_name
|
Para mapear um dos
elementos filhos, arraste o elemento da área de janela de Origem para o
elemento correspondente na área de Destino; por exemplo,
arraste o elemento de origem Last_name no elemento de destino Last_name.
O mapeamento é representado por uma linha entre o elemento de origem e o
elemento de destino e uma entrada para o mapeamento no formato
Xpath aparece na área de janela da Planilha.
Um ícone triangular indica quais elementos das áreas de janela Origem e Destino foram mapeados.
Mapeando Estruturas de Origem para Estruturas de Destino (em que a Origem e o Destino São do Mesmo Tipo)
No
exemplo a seguir, o elemento de origem chamado
Name possui a mesma estrutura do elemento de destino chamado Name:
Origem |
Destino |
Name
Title
First_name
Middle_name
Last_name
|
Name
Title
First_name
Middle_name
Last_name
|
Para mapear a
estrutura de origem inteira para a estrutura de destino, arraste o elemento pai
(Nome) da área de janela de Origem no elemento correspondente (Name) na área de
janela de Destino. Todos os elementos filhos são mapeados.
Mapeando Estruturas de Origem para Estruturas de Destino (em que a Origem e o Destino São de Tipos Diferentes)

No exemplo a seguir, o elemento de origem chamado Name tem uma estrutura diferente do elemento de destino chamado
DifferentName:
Origem |
Destino |
Name
Title
First_name
Middle_name
Last_name
|
DifferentName
Title
FirstName
LastName
|
Para mapear toda a estrutura de origem para a estrutura de destino, arraste o elemento pai (Name) da área de janela Origem para o elemento correspondente
(DifferentName) na área de janela Destino. O assistente
Mapear por Nome é aberto.
Selecione
Mapear Folhas e
Mapear Itens com Nomes Iguais ou Semelhantes para mapear todos os elementos filhos do destino.
O elemento de origem Middle_name não será mapeado, já que não há nenhum elemento de destino com o mesmo nome ou um semelhante.

Mapeando
vários elementos de origem para um elemento de destino simples
No
exemplo a seguir, você deseja concatenar os elementos de origem
First_name e Middle_name para formar um único elemento de destino chamado
First_names:
Origem |
Destino |
Name
Title
First_name
Middle_name
Last_name
|
Name
Title
First_names
Last_name
|
Para mapear os
elementos de origem para um elemento de destino simples, Ctrl+clique nos elementos
de origem apropriados (First_name e Middle_name) e no elemento de destino
(First_names) e, em seguida, clique em
. Uma
função concatenada aparece na área de janela da Planilha; você pode
editar essa função para definir a aparência
do elemento de destino concatenado, por exemplo, incluindo um espaço em branco
entre os dois elementos de origem.
Para customizar o elemento de destino (por exemplo, para tornar o valor de destino igual ao valor de origem mais um), consulte Configurando o Valor de um Elemento de Destino Utilizando uma Expressão ou Função.
Você não pode mapear um elemento simples se um de seus ascendentes também tiver um mapeamento.
Por exemplo, você não pode mapear Propriedades da origem para o destino, em seguida, mapear Properties/MessageFormat.