Altova MapForce 2025 Professional Edition

Navigation: Composants de transformation > Fonctions > Référence des bibliothèques de fonctions > core | node functions

is-xsi-nil

Retourne true si le nœud element a l’attribut xsi:nil défini sur true.

Langages

Built-in, C++, C#, Java, XQuery, XSLT 1.0, XSLT 2.0, XSLT 3.0.

Paramètres

Argument	Description
element	Paramètre obligatoire. Doit être connecté au nœud de source qui doit être vérifié.

Exemple

Le design de mappage illustré ci-dessous copie conditionnellement des données depuis une source vers un fichier XML de cible, et illustre également l’utilisation de plusieurs fonctions, y compris is-xsi-nil. Ce mappage est appelé HandlingXsiNil.mfd et peut être trouvé dans le répertoire <Documents>\Altova\MapForce2025\MapForceExamples\.

Comme illustré ci-dessus, la fonction is-xsi-nil vérifie si l’attribut xsi:nil est "true" pour l’item state dans le fichier de source. Si cet attribut est "false", le filtre copiera l’élément parent Address dans la cible. Le fichier XML de source ressemble à l’exemple suivant (sauf les déclarations XML et d’espace de noms) :

<BranchOffices>
<Name>Nanonull</Name>
<Office>
<Name>Nanonull Research Outpost</Name>
<EMail>sp@nanonull.com</EMail>
<Fax xsi:nil="true"/>
<Phone>+8817 3141 5926</Phone>
<Address>
<city>South Pole</city>
<state xsi:nil="true"/>
<street xsi:nil="true"/>
<zip xsi:nil="true"/>
</Address>
<Contact>
<first>Scott</first>
<last>Amundsen</last>
</Contact>
</Office>
</BranchOffices>

Le résultat du mappage est qu’aucun Address n’est copié dans la cible, parce qu’il n’y a qu’un seul Address dans la source, et l'attribut xsi:nil est défini sur "true" pour l’élément state. Par conséquent, la sortie de mappage est le suivant :

<BranchOffices>
<Name>Nanonull</Name>
<Office>
<Name>Nanonull Research Outpost</Name>
<EMail xsi:nil="true"/>
<Fax>n/a</Fax>
<Phone>+8817 3141 5926</Phone>
<Contact>
<first>Scott</first>
<last>Amundsen</last>
</Contact>
</Office>
</BranchOffices>