Nommage d'une structure mise à plat
Lorsque vous créez une map d'aplatissement, une structure de sortie mise à plat est générée, et ses éléments sont nommés en fonction de la structure d'entrée.
Le nom des éléments de sortie peut être généré de plusieurs manières, si un nom est en doublon au sein de la structure.
Nommage des éléments dupliqués
Lorsque la structure de sortie mise à plat est créée, chaque élément ayant un nom unique au sein de la structure complète conserve son nom dans la sortie. Cependant, lorsqu'il y a des doublons, un préfixe ou un suffixe est ajouté, afin de différencier les éléments :
- Si les noms en doublon sont dans le même élément parent, un suffixe comprenant un nombre est ajouté à tous les noms en doublon. Par exemple, si la structure d'entrée contient un élément order avec deux enfants item, ces enfants seront nommés item_1 et item_2 dans la sortie.
- Si les noms en doublon sont dans des éléments parents différents, le nom de l'élément parent est ajouté en tant que préfixe à tous les noms en doublon. Par exemple, s'il y a un élément address dans shipping et billing, la sortie contiendra ces éléments nommés shipping_address et billing_address.
- Si l'étape ci-dessus ne suffit pas à différencier les éléments, d'autres parents sont ajoutés, jusqu'à ce qu'un nom unique soit défini. Dans l'exemple ci-dessus, si les deux instances de l'élément address contiennent un élément zipcode, ces éléments seront nommés shipping_address_zipcode et billing_address_zipcode dans la sortie.
Troncature des noms d'éléments dépassant la longueur maximale
Par défaut, la longueur maximale d'un nom d'élément dans une map d'aplatissement est de 128 caractères. Ce paramètre peut être personnalisé lors de la création de la map.
Si le nom d'un élément dépasse cette limite, il est tronqué en se basant sur les règles suivantes :
- Le nom est tronqué par segments. Les segments sont le nom de l'élément d'entrée et les parents, s'il y en a, sont ajoutés au nom. Aucun nombre ou segment contenant moins de quatre caractères n'est tronqué.
- La réduction du nom s'effectue un caractère à la fois, de droite à gauche, en commençant par le plus long segment.
Par exemple, avec une longueur maximale de 30, un élément nommé customer_billing_address_zipcode sera tronqué comme suit : custom_billing_address_zipcode.
Si le nom d'un élément ne peut être tronqué pour s'adapter à la longueur maximale, un avertissement s'affiche à la fin du processus de mise à plat.