Notación de Ruta de Entidad Jerárquica

Al ver o editar una transformación, puede ver el código de instancia de cada nodo o campo tal como se define en la estructura de origen o de destino para ayudarlo a realizar una asignación precisa de los campos. Según la estructura de datos de origen o de destino, los códigos de instancia que consisten en elementos, valores y atributos, junto con cualquier modificador, se muestran junto a cada nodo o nombre de campo.

Elementos, Valores y Atributos

Los diversos [E] todos los nodos están representados por carpetas en las estructuras de asignación de origen o de destino. El usuario mapea hacia o desde el [V], [A], o [EV] campos.

XML, JSON, NetSuite, Salesforce	significado
`[E]`	Elemento. En Jitterbit, los elementos están representados por nodos. Los elementos pueden tener uno o más elementos, atributos, valores, una combinación de estos o ninguno, según los modificadores.
`[V]`	Valor. En Jitterbit, los valores están representados por campos. Si un nodo tiene un valor, también tendrá al menos un atributo. Si no tiene un atributo, se representará como `[EV]`.
`[A]`	Atributo. En Jitterbit, los atributos están representados por campos. Si un nodo tiene un atributo, puede tener o no un campo de valor. Puede haber más de un atributo por nodo.
`[EV]`	Valor del elemento. En Jitterbit, estos son elementos que tienen un valor pero no tienen ningún atributo y, por lo tanto, están representados por campos en lugar de nodos.

Nota

Los códigos de letras de la tabla anterior no se utilizan dentro de las estructuras de texto o base de datos.

Modificadores

Los modificadores anotan la relación de los nodos y, a veces, de los campos, como se detalla en la siguiente tabla.

XML, JSON, NetSuite, Salesforce	Texto complejo o base de datos	significado
(sin modificador)	`Once Only`	Uno y solo un elemento [1] es válido. Solo los nodos pueden tener este modificador.
`+`	`One or More`	Uno o más de un elemento [1+] son válidos. Solo los nodos pueden tener este modificador.
`?`	`Zero or One`	Cero o un elemento, valor, atributo o valor de elemento [0,1] es válido. Tanto los nodos como los campos pueden tener este modificador, lo que significa que el nodo o el campo son opcionales.
*``**	`Zero or More`	Cero o más elementos [0+] son válidos. Solo los nodos pueden tener este modificador.

Ejemplos

Cuando se utilizan modificadores con elementos, valores y atributos, considere los siguientes ejemplos:

Ejemplo 1

Suponga que hay un elemento opcional llamado "Tiempo". Luego suponga que este elemento tiene un valor de tipo cadena y no tiene ningún atributo. Luego aparecerá como un campo de la siguiente manera:

[EV?] Time (String)

El usuario puede mapear directamente desde el [EV?] campo.

Ejemplo 2

Si el elemento "Tiempo" también tiene un atributo llamado "Zona horaria", entonces el elemento estaría representado por un nodo, con campos de valor y atributo mostrados dentro del nodo:

[E?] Time

[V] (String)

[A] Timezone (String)

En este caso el [E?] el nodo aparecería como una carpeta en el árbol, y el usuario se asignaría hacia o desde el [V] y [A] campos.

Referencia en un Secuencia de Comandos

Cuando se hace referencia a los elementos, valores y/o atributos dentro de un secuencia de comandos, se utilizan rutas calificadas. La ruta calificada es lo que aparece dentro de la <trans> </trans>etiquetas en un secuencia de comandos de Jitterbit al hacer referencia al nodo o campo específico. Los siguientes símbolos se utilizan dentro de la notación para significar lo siguiente:

Símbolo	Significado
`[ ]`	Los Square se utilizan para encerrar nodos. Sin embargo, tenga en cuenta que las rutas de los nodos no se pueden asignar directamente; solo se pueden mapear campos.
`.`	Un punto que sigue al nombre de un nodo indica un nodo de bucle.
`$`	Se utiliza un signo de dólar después de un nombre de nodo para indicar un `Once Only` o `[E]` elemento. Este nodo no puede ser un nodo de bucle.
`#`	Un signo de almohadilla después de un nombre de nodo indica que se devolverá una matriz para los campos de valor de registro. Esta notación se puede usar solo después de un nodo de bucle antes del período.
`_`	Un guión bajo que precede `Root` se utiliza para hacer referencia a la raíz en un CSV complejo. Esto no está presente para otras estructuras de datos. Un guión bajo también puede ser simplemente un guión bajo ya presente en un nodo o nombre de campo.

Las siguientes rutas de muestra son para una estructura de datos CSV compleja. Las rutas calificadas para otras estructuras siguen el mismo formato excepto que _Root no está presente para otras estructuras de datos.

Nota

No se muestran todas las combinaciones posibles, pero se pueden construir haciendo referencia a la tabla anterior.

Estructura de datos	Camino Calificado	Significado
`_Root` (Solo una vez)	`[_Root$]`	El `_Root` en una estructura de datos CSV siempre es un nodo y, por lo tanto, aparece entre paréntesis `[ ]`. El signo de dólar final indica un `Once Only` elemento. Las rutas de los nodos no se pueden asignar.
`Header` (Solo una vez)	`[_Root$Header$]`	Los subnodos utilizan la referencia de cualquier nodo anterior, seguida del nombre del nodo. El signo de dólar final indica un `Once Only` o `[E]` elemento. Las rutas de los nodos no se pueden asignar.
`Value` [V]	`_Root$Header$Value`	Un campo de valor no está encerrado entre corchetes, pero aún usa la referencia de cualquier nodo anterior, seguido del nombre del valor. Esta ruta de campo se puede utilizar para el mapeo.
`Detail` (Uno o Más)	`[_Root$Header$Detail.]`	Los subnodos utilizan la referencia de cualquier nodo anterior, seguida del nombre del nodo. El período final indica un nodo de bucle. Las rutas de los nodos no se pueden asignar.
`Attribute` [A]	`_Root$Header$Detail.Attribute`	Un campo de atributo no está encerrado entre corchetes, pero aún usa la referencia de cualquier nodo anterior, seguido del nombre del atributo. Esta ruta de campo se puede utilizar para el mapeo.
`Value` [V]	`_Root$Header$Detail#.Value`	Un campo de valor no está encerrado entre corchetes, pero aún usa la referencia de cualquier nodo anterior, seguido del nombre del valor. Este ejemplo específico muestra un signo de hash que precede al período del nodo de bucle, lo que indica que se devolverá una matriz de valores de registro "Detalle". Esta ruta de campo se puede utilizar para el mapeo.