Ir para o conteúdo

Notação de Caminho de Entidade Hierárquica

Ao visualizar ou editar uma transformação, você pode ver o código de instância para cada nó ou campo conforme definido na origem ou na estrutura de destino para ajudá-lo a fazer um mapeamento preciso dos campos. Dependendo da estrutura de dados de origem e/ou destino, os códigos de instância que consistem em elementos, valores e atributos, juntamente com quaisquer modificadores, são exibidos ao lado de cada nó ou nome de campo.

Elementos, Valores e Atributos

Os vários [E] os nós são todos representados por pastas nas estruturas de mapeamento de origem ou destino. O usuário mapeia de ou para o [V], [A], ou [EV] Campos.

XML, JSON, NetSuite, Salesforce Significado
[E] Elemento. No Jitterbit, os elementos são representados por nós. Os elementos podem ter um ou mais outros elementos, atributos, valores, uma combinação destes ou nenhum, dependendo dos modificadores.
[V] Valor. No Jitterbit, os valores são representados por campos. Se um nó tiver um valor, ele também terá pelo menos um atributo. Se não tiver um atributo, será representado como [EV].
[A] Atributo. No Jitterbit, os atributos são representados por campos. Se um nó tiver um atributo, ele pode ou não ter um campo de valor. Pode haver mais de um atributo por nó.
[EV] Valor do elemento. No Jitterbit, esses são elementos que possuem um valor, mas não possuem nenhum atributo e, portanto, são representados por campos em vez de nós.

Nota

Os códigos de letras na tabela acima não são usados em estruturas de texto ou banco de dados.

Modificadores

Os modificadores notam o relacionamento para nós e, às vezes, campos, conforme detalhado na tabela abaixo.

XML, JSON, NetSuite, Salesforce Texto complexo ou banco de dados Significado
(sem modificador) Once Only Um e apenas um elemento [1] é válido. Somente nós podem ter esse modificador.
+ One or More Um ou mais elementos [1+] são válidos. Somente nós podem ter esse modificador.
? Zero or One Zero ou um elemento, valor, atributo ou valor de elemento [0,1] é válido. Tanto os nós quanto os campos podem ter esse modificador, o que significa efetivamente que o nó ou campo é opcional.
* Zero or More Zero ou mais elementos [0+] são válidos. Somente nós podem ter esse modificador.

Exemplos

Quando modificadores são usados com elementos, valores e atributos, considere os seguintes exemplos:

Exemplo 1

Suponha que haja um elemento opcional chamado "Tempo". Em seguida, suponha que esse elemento tenha um valor do tipo string e não tenha nenhum atributo. Em seguida, aparecerá como um campo da seguinte forma:

[EV?] Time (String)

O usuário pode então mapear diretamente do [EV?] campo.

Exemplo 2

Se o elemento "Time" também tiver um atributo chamado "Timezone", então o elemento seria representado por um nó, com campos de valor e atributo exibidos dentro do nó:

[E?] Time

[V] (String)

[A] Timezone (String)

Neste caso o [E?] o nó apareceria como uma pasta na árvore e o usuário mapearia de ou para o [V] e [A] campos.

Referência em um Script

Ao fazer referência aos elementos, valores e/ou atributos em um script, são usados caminhos qualificados. O caminho qualificado é o que aparece dentro do <trans> </trans>tags em um script Jitterbit ao referenciar o nó ou campo específico. Os seguintes símbolos são usados dentro da notação para significar o seguinte:

Símbolo Significado
[ ] Os Square são usados para delimitar os nós. No entanto, observe que os caminhos do nó não podem ser mapeados diretamente; somente campos podem ser mapeados.
. Um ponto após um nome de nó indica um nó de loop.
$ Um cifrão após um nome de nó é usado para indicar um Once Only ou [E] elemento. Este nó não pode ser um nó de loop.
# Um sinal de hash após um nome de nó indica que uma matriz para os campos de valor de registro será retornada. Essa notação pode ser usada apenas após um nó de loop antes do ponto.
_ Um sublinhado precedendo Root é usado para referenciar a raiz em um CSV complexo. Isso não está presente para outras estruturas de dados. Um sublinhado também pode ser simplesmente um sublinhado já presente em um nó ou nome de campo.

Os caminhos de amostra a seguir são para uma estrutura de dados CSV complexa. Os caminhos qualificados para outras estruturas seguem o mesmo formato, exceto que _Root não está presente para outras estruturas de dados.

Nota

Nem todas as combinações possíveis são mostradas, mas podem ser construídas com base na tabela acima.

Estrutura de Dados Caminho Qualificado Significado
_Root (Apenas uma vez) [_Root$] O _Root em uma estrutura de dados CSV é sempre um nó e, portanto, aparece entre colchetes [ ]. O cifrão final indica um Once Only elemento. Os caminhos do nó não podem ser mapeados.
Header (Apenas uma vez) [_Root$Header$] Os subnós usam a referência de quaisquer nós anteriores, seguidos pelo nome do nó. O cifrão final indica um Once Only ou [E] elemento. Os caminhos do nó não podem ser mapeados.
Value [V] _Root$Header$Value Um campo de valor não é colocado entre colchetes, mas ainda usa a referência de qualquer nó anterior, seguido pelo nome do valor. Este caminho de campo pode ser usado para mapeamento.
Detail (Um ou Mais) [_Root$Header$Detail.] Os subnós usam a referência de quaisquer nós anteriores, seguidos pelo nome do nó. O ponto final indica um nó de loop. Os caminhos do nó não podem ser mapeados.
Attribute [A] _Root$Header$Detail.Attribute Um campo de atributo não é colocado entre colchetes, mas ainda usa a referência de qualquer nó anterior, seguido pelo nome do atributo. Este caminho de campo pode ser usado para mapeamento.
Value [V] _Root$Header$Detail#.Value Um campo de valor não é colocado entre colchetes, mas ainda usa a referência de qualquer nó anterior, seguido pelo nome do valor. Este exemplo específico mostra um sinal de hash precedendo o período do nó de loop, indicando que uma matriz dos valores de registro "Detalhe" será retornada. Este caminho de campo pode ser usado para mapeamento.