élément join

Modèle de contenu

join:==EMPTY

Attributs

• @dstFilterExpr (string)
• @xpath-dst (string)
• @xpath-src (string)

Parents

<element>

Enfants

Aucun

Description

Cet élément permet de définir les champs créant une jointure entre des tables SQL.

Usage et contexte d'utilisation

Un élément <join> ne peut être utilisé que si l’élément <element> parent est de type "link". Cela signifie que l’attribut « @type=link » doit être déclaré pour l’élément parent.

Il n’est pas nécessaire de spécifier le nom et l’espace de noms de la table distante dans l’élément <join>. Ils doivent être spécifiés dans le <element> parent.

Par convention, les liens sont définis à la fin du schéma.

Si l’élément <join> n'est pas précisé lors de la définition d'un élément de type "link", alors le lien sera automatiquement posé sur les clefs primaires des deux tables.

Description des attributs

• dstFilterExpr (string) : cet attribut permet de restreindre le nombre de valeurs éligibles dans la table distante.
• xpath-dst (string) : cet attribut reçoit un Xpath (attribut "@name" de la table distante).
• xpath-src (string) : cet attribut reçoit un Xpath (attribut "@name" dans le schéma courant).

Exemples

Lien entre le champ 'email' de la table courante et le champ "@compagny-id" de la table distante:

<join xpath-dst="@compagny-id" xpath-src="@email"/>

Lien 'filtré' vers la table "cus:Country" basé sur le contenu du champ "@country" qui doit contenir la valeur 'FR' :

<element name="StockEN" type="link" label="MyLink" target="cus:Stock">
   <join xpath-dst="@country" xpath-src="@code" dstFilterExpr="@country = 'EN'"/>
 </element>