XMLXQueryExtractor

Catégories

Spécifique à un format

Web

Ce Transformer éclate des portions de texte XML en utilisant des expressions XQuery et les introduit dans des attributs d'entités.

Fonctions XQuery

FME fournit plusieurs fonctions qui peuvent être utilisées dans les scripts XQuery. Ces fonctions permettent aux scripts XQuery d'accéder aux valeurs des attributs des entités et de les manipuler. Actuellement, il n'existe pas de fonctions permettant de manipuler la géométrie des entités.

Voir Les fonctions XQuery.

Exemples

Exemples XQuery

Configuration

Paramètres

XQuery en entrée, Expression XQuery,  Attribut XQuery, Fichier XQuery

Ce paramètre identifie le type de la XQuery à exécuter. Les valeurs possibles correspondent chacune à des façons de spécifier la XQuery. Il peut s'agir

  • Contenue dans la valeur attributaire d'une entité.
  • Il faut alors choisir l'option 'Attribut contenant l'XQuery' et renseigner le paramètre ATTRIBUT XQUERY.
  • Contenu dans un fichier (Option Fichier XQuery et paramètre Fichier XQuery).

XML en entrée, Attribut XML, Fichier XML

Ce paramètre identifie soit un attribut qui contient un document XML (Attribut XML), soit un fichier qui contient un document XML (Fichier XML). Vous pouvez définir ce paramètre sur None (le fichier est spécifié dans la requête) si le paramètre XQuery ci-dessus fait référence à un fichier XML. Si ce paramètre est défini, le document contextuel de la requête sera défini à la valeur du paramètre (sous forme de fichier ou de chaîne, selon le cas).

Supprimer l'attribut XML Source

Si le document XML est chargé depuis un attribut, le paramètre de suppression de l'attribut XML peut être utilisé pour supprimer le document XML après que la requête ait été exécutée.

Écrire l'en tête XML

Le paramètre Ecrire l'en-tête XML indique si l'en-tête XML doit être écrit ou non dans les résultats de la XQuery. Notez que pour les fichiers UNICODE, la marque d'ordre des octets (BOM) n'est pas écrite, et doit être ajoutée par un processus supplémentaire si vous le souhaitez.

Valeur résultante, Attribut résultat, Attribut liste de résultats, Caractère(s) délimiteur(s)

Le paramètre Attribut résultat précise le nom de l'attribut qui va recevoir le résultat de la requête XQuery.

Si la valeur de retour est définie sur Valeurs séparées, les résultats seront écrits sous forme de chaîne de caractères délimitée, le caractère séparateur étant déterminé par la valeur définie pour le(s) caractère(s) séparateur(s). Si la valeur de retour est définie sur Valeur unique, les résultats seront concaténés. Si la valeur de retour est définie sur Attribut de liste, chaque résultat sera écrit dans un élément de la liste spécifiée par le paramètre Attribut liste de résultats.

Attributs à exposer :

Expose les attributs afin qu'ils puissent être utilisés ailleurs dans le traitement.

Les noms des attributs peuvent être saisis directement ou fournis dans la fenêtre Entrer des valeurs pour les attributs à exposer, à laquelle on accède par le bouton "...", où le type de données peut également être spécifié.

Pour plus d'informations sur les attributs exposés et non exposés, voir Comprendre les types d'entités et les attributs.

Éditer les paramètres des Transformers

À l'aide d'un ensemble d'options de menu, les paramètres du Transformer peuvent être attribués en faisant référence à d'autres éléments de traitement. Des fonctions plus avancées, telles qu'un éditeur avancé et un éditeur arithmétique, sont également disponibles dans certains Transformers. Pour accéder à un menu de ces options, cliquez sur à côté du paramètre applicable. Pour plus d'informations, voir Options de menus et paramètres de Transformer.

Définir les valeurs

Il existe plusieurs façons de définir une valeur à utiliser dans un Transformer. La plus simple est de simplement taper une valeur ou une chaîne de caractères, qui peut inclure des fonctions de différents types comme des références d'attributs, des fonctions mathématiques et de chaînes de caractères, et des paramètres de traitement. Il existe un certain nombre d'outils et de raccourcis qui peuvent aider à construire des valeurs, généralement disponibles dans le menu contextuel déroulant adjacent au champ de valeur.

Utilisation de l'éditeur de texte

L'éditeur de texte fournit un moyen efficace de construire des chaînes de textes (dont les expressions régulières) à partir de données source diverses, telles que des attributs, des paramètres et des constantes, et le résultat est directement utilisé dans le paramètre.

Editeur de texte

Utilisation de l'éditeur arithmétique

L'éditeur arithmétique fournit un moyen simple de construire des expressions mathématiques à partir de plusieurs données source, telles que des attributs et des fonctions, et le résultat est directement utilisé dans un paramètre.

Éditeur arithmétique

Valeur conditionnelle

Définit des valeurs selon un ou plusieurs tests.

Fenêtre de définition de conditions

Contenu

Les expressions et chaînes de caractères peuvent inclure des fonctions, caractères, paramètres et plus.

Lors du paramétrage des valeurs - qu'elles soient entrées directement dans un paramètre ou construites en utilisant l'un des éditeurs - les chaînes de caractères et les expressions contenant des fonctions Chaîne de caractères, Math, Date et heure ou Entité FME auront ces fonctions évaluées. Par conséquent, les noms de ces fonctions (sous la forme @<nom_de_fonction>) ne doivent pas être utilisés comme valeurs littérales de chaîne de caractères.

Fonctions chaînes de caractères

Ces fonctions manipulent les chaînes de caractères.

Caractères spéciaux

 Un ensemble de caractères de contrôle est disponible dans l'éditeur de texte.

Fonctions mathématiques

Plusieurs fonctions sont disponibles dans les deux éditeurs.
Fonctions Date/heure Les fonctions de dates et heures sont disponibles dans l'Editeur texte.

Opérateurs mathématiques

Ces opérateur sont disponibles dans l'éditeur arithmétique.

Fonctions d'entités

Elles retournent des valeurs spécifiques aux entités.

Paramètres FME

Les paramètres FME et spécifiques au traitement peuvent être utilisés.
Créer et modifier un paramètre publié Créer ses propres paramètres éditables.

Options - Tables

Les Transformers avec des paramètres de style table possèdent des outils additionnels pour remplir et manipuler des valeurs.

Réordonner

Activé une fois que vous avez cliqué sur un élément de ligne. Les choix comprennent :

  • Ajouter une ligne
  • Supprimer une ligne
  • Déplacer la ligne en cours au dessus
  • Déplacer la ligne en cours en dessous
  • Déplacer la ligne en cours en haut de liste
  • Déplacer la ligne en cours en bas de liste

Couper, Copier et Coller

Activé une fois que vous avez cliqué sur un élément de ligne. Les choix comprennent :

  • Couper une ligne - supprime et copie dans le presse-papiers.
  • Copie une ligne dans le presse-papiers.
  • Colle une ligne depuis le presse-papiers.

Copier, copier et coller peuvent être utilisés au sein d'un Transformer ou entre Transfromers.

Filtre

Commencez à taper une chaîne de caractères, et la matrice n'affichera que les lignes correspondant à ces caractères. Recherche dans toutes les colonnes. Cela n'affecte que l'affichage des attributs dans le Transformer - cela ne change pas les attributs qui sont sortis.

Importer

Le bouton d'import remplit la table avec un jeu de nouveaux attributs lus depuis un jeu de données. L'application spécifique varie selon les Transformers.

Réinitialiser/Rafraîchir

Réinitialise la table à son état initial, et peut fournir des options additionnelles pour supprimer des entrées invalides. Le comportement varie d'un Transformer à l'autre.

Note : Tous les outils ne sont pas disponibles dans tous les Transformers.

FME Community

FME Community est l'endroit où trouver des démos, des tutoriaux, des articles, des FAQ et bien plus encore. Obtenez des réponses à vos questions, apprenez des autres utilisateurs et suggérez, votez et commentez de nouvelles entités.

Voir tous les résultats à propos de ce Transformer sur FME Community.