Ajoute les attributs d'une entité à une autre entité. Les entités entrant dans le Transformer par le port SUPPLIER (fournisseur) sont utilisées pour fournir des attributs aux entités entrant par le port REQUESTOR (demandeur).

Quand un demandeur trouve un fournisseur (même valeur pour les attributs de jointure), les attributs du fournisseur sont ajoutés à ceux du demandeur. Lorsque des attributs du fournisseur existent déjà chez le demandeur, la valeur d'origine est conservée pour ces attributs. Un même fournisseur peut être utilisé par plusieurs demandeurs.

La jointure entre demandeurs et fournisseurs est effectuée à partir des attributs de jointure définis en paramètre.

Port d'entrée

• SUPPLIER (fournisseur) : Source des nouveaux attributs à ajouter entrant par le port REQUESTOR.
• REQUESTOR (demandeur) : Reçoit les nouveaux attributs depuis l'entité connectée au port SUPPLIER.

Ports de sortie

• COMPLETE : Demandeurs qui trouvent un fournisseur.
• INCOMPLETE : Demandeurs qui ne trouvent pas de fournisseur.
• EMPTY : Les demandeurs n'ayant pas de valeur pour l'attribut de jointure ressortent par le port EMPTY (vide).
• REFERENCED : Les fournisseurs utilisés par au moins un demandeur ressortent par le port REFERENCED (utilisé).
• UNREFERENCED : Les fournisseurs qui ne sont utilisés par aucun demandeur ressortent par le port UNREFERENCED (non utilisé).
• DUPLICATE_SUPPLIER : Fournisseur avec la même valeur que l'attribut de référence. Remarquez qu'aucun Duplicate Supplier (fournisseur dupliqué) ne ressort si un Nom de liste est spécifié ou si le paramètre traiter les fournisseurs multpiles vaut Non.

Paramètres

Regrouper par

Le paramètre de regroupement permet de regrouper les entités en entrée.Si vous choisissez de regrouper leurs attributs, les références entre plusieurs attributs ne pourront se faire que si ils partagent une valeur.

Si aucun paramètre de regroupement n'est défini, toutes les entités seront traitées ensemble.

Si vous avez plus d'une données source, il est pratique de les regrouper par id de sorte à s'assurer que les références soit traitées avec les bonnes entités.

Type de regroupement

Vous pouvez utilisez ce Transformer si vous avez un groupe d'entités que vous voulez combiner avec un autre groupe pour obtenir leur géométrie, leurs attributs ou les deux. Le paramètre type de regroupement permet de déterminer ces choix :

• Lorsque le type de regroupement est Attributs seulement, seuls les fournisseurs contenant les attributs seront joints à l'entité demandeur.
• Lorsque le type de regroupement vaut Geometrie, alors les fournisseurs sont les entités qui contiennent la géométrie.Notez que le demandeur perdra sa précédente géométrie.
• Lorsque le type de regroupement vaut Attributs et Géométrie, les fournisseurs contenant géométrie et attributs seront joints aux entités demandeurs.Toutes les géométries du demandeur seront écrasées. Les attributs du requestor (demandeur) peuvent ou ne peuvent pas être écrasés, cela dépend des paramètres NOM DE LISTE et TRAITER LES FOURNISSEURS SIMPLES.

Attributs seulement : Les attributs existants d'une entité demandeur ne seront jamais écrasés par des attributs de même nom des entités fournisseurs. Notez que tous les attributs fme_* de l'entité fournisseur ne seront pas transférés à l'entité demandeur.

Générer des Polygones : Si les fournisseurs sont composés de polygones et polygones troués, alors les segments en commun seront supprimés. Si le fournisseur contient au moins une entité non surfacique ou non trouée, alors le Transformer génèrera des polygones et des polygones troués et joindra les segments de lignes du fournisseur avant de définir la géométrie du demandeur. Dans ce cas, la géométrie peut être un agrégat si plusieurs géométries disjointes sont créées.

Générer des agrégats : Le Transformer crée des agrégats des géométries du fournisseurs. (Si il y a seulement une entité fournisseur, alors la géométrie du demandeur sera un agrégat avec seulement un élément).

Générer des lignes à partir des points : Le Transformer connecte les points du founisseur aux lignes. Remarquez que toutes les entités qui ne sont pas des points seront ignorées lors de la construction des lignes.

Attributs de jointure

Normallement, l'attribut de jointure des fournisseurs est un identifiant unique et les doublons sont ignorés par le Transformer. Cependant, si le paramètre TRAITER LES FOURNISSEURS MULTIPLES vaut "Oui", alors, tous les fournisseurs correspondant à un demandeur seront associés à ce demandeur.

Nom liste

Remarquez que, si un nom de liste est spécifié, les fournisseurs multiples sont automatiquement acceptés quelle que soit la valeur du paramètre.Lorsqu'un nom de liste est défini, tous les fournisseurs associés à un demandeur voient leurs attributs ajoutés à la liste.

Construire les demandeurs incomplets

Quand plusieurs fournisseurs sont associés à un demandeur, le paramètre CONSTRUIRE LES DEMANDEURS INCOMPLETS définit les traitements à appliquer aux demandeurs qui ne peuvent pas localiser tous leur fournisseurs.

Si le paramètres est à "Oui", les fournisseurs trouvés sont combinés avec le demandeur et ressortent par le port INCOMPLETE. Les fournisseurs utilisés ressortent par le port REFERENCED.Si le paramètre est à "Non", les demandeurs ressortent non modifiés par le port INCOMPLETE et les fournisseurs par le port UNREFERENCED.

Traiter les fournisseurs multiples

Si plus d'un fournisseur est trouvé pour un demandeur et que Traiter les fournisseurs multiples vaut non et que le nom de la liste n'est pas spécifiée, alors chaque fournisseur suivant le premier ressort par le port DUPLICATE_SUPPLIER (fournisseur supplémentaire). Seul le premier des fournisseurs sera associé à un demandeur. Si ce paramètre vaut oui alors les fournisseurs dupliqués correspondent tous à un demandeur.

Gestion de la géométrie

Si le paramètre avancé de workbench "Support de la géométrie" vaut "Riche", les géométries fusionnées préservent les arcs, les ellipses et les textes, sinon elles sont converties en point.

Implémentation

Fonction(s) de bas niveau utilisée(s) (Function ou Factory): ReferenceFactory