XMLSampleGenerator

Ce Transformer génère un document XML basé sur un fichier XML Schema (XSD). Bien que le document d'exemple puisse ne pas passer une validation de schéma, il fournira un aperçu de ce à quoi ressemble un document XML valide. Le XML généré par ce Transformer peut être utilisé comme base pour un modèle XML utilisé dans le Transformer XMLTemplater.

En plus de générer des documents XML entiers, ce Transformer peut également être utilisé pour générer de petites parties d'un document XML. Tout ce qui est nécessaire est le chemin vers l'élément qui doit être généré.

Notez qu'afin d'éviter les récursions infinies, le Transformer ne générera pas de types complexes récursifs ou de groupes de substitution. Les types récursifs et les groupes de substitution seront générés une fois, et les types/groupes imbriqués ne seront pas générés.

Configuration

Ports en entrée

Ports de sortie

Paramètres

Schéma

Emplacement du schéma

Ce paramètre spécifie l'emplacement du fichier XSD à partir duquel le XML sera généré. Il est important que le fichier sélectionné pour ce paramètre contienne la définition de l'élément à générer. Comme il est courant qu'un fichier XSD importe d'autres fichiers XSD, la valeur de ce paramètre peut varier en fonction de la sortie souhaitée du Transformer.

Si un document entier doit être généré, vous devez sélectionner le fichier XSD "de base". Si un élément spécifique doit être généré, vous devrez peut-être sélectionner un autre fichier XSD.

Chemin de l'élément

Ce paramètre a deux utilités :

D'abord, pour les fichiers XSD qui contiennent plus d'un élément racine, vous pouvez utiliser ce paramètre pour spécifier quel élément doit être généré.
Deuxièmement, vous pouvez utiliser ce paramètre pour demander au Transformer de générer un élément qui n'est pas un élément de niveau supérieur. Pour ce faire, entrez le chemin d'accès à l'élément comme valeur du paramètre. Par exemple, le chemin suivant peut être utilisé pour générer un élément d'animation à partir du schéma Collada 1.4 :

/COLLADA/library_animations/animation

Notez que ce chemin doit être conforme aux espaces de nommage. Autrement dit, les éléments du chemin doivent correspondre aux espaces de nommage cibles des schémas XSD utilisés. Par exemple, pour générer un élément Date dans le schéma AIXM, le chemin suivant peut être utilisé.

aixm:HoldingPatternTimeSlice/aixm:timeSliceMetadata/gmd:MD_Metadata/gmd:dateStamp/gco:Date

Eléments à exclure

Ce paramètre peut être utilisé pour exclure des éléments du XML généré. Plusieurs noms d'éléments peuvent être saisis dans une liste séparée par des espaces. Comme dans le paramètre Chemin, les noms d'éléments dans ce paramètre doivent être corrects au niveau de l'espace de noms ; les noms d'éléments doivent utiliser les mêmes préfixes d'espace de noms que les fichiers XSD. Des caractères génériques peuvent être utilisés dans les noms d'éléments. Par exemple, la valeur suivante exclura tous les éléments de l'espace de noms gml, ainsi que l'élément gmd:dateStamp.

gml:* gmd:dateStamp

Si le XML généré comporte des commentaires, un commentaire sera inséré pour chaque élément exclu.

Génération de XML

Générer des attributs optionnels	Un schéma XML peut désigner certains attributs XML comme étant facultatifs. Si ce paramètre a pour valeur Oui, les attributs facultatifs seront inclus dans le document de sortie XML. Si ce paramètre a la valeur Non, seuls les attributs XML marqués comme "obligatoires" seront inclus dans le document de sortie.
Générer les éléments optionnels	Un schéma XML peut désigner le nombre minimum et maximum d'occurrences d'un élément dans un emplacement particulier. Si ce paramètre a pour valeur No, seuls les éléments dont le nombre minimum d'occurrences est supérieur à zéro seront inclus dans le document XML de sortie. Si ce paramètre a la valeur Oui, tous les éléments seront inclus au moins une fois dans le document de sortie.
Groupes de substitution abstraits	Ce paramètre contrôle la sortie quand le schéma XML contient des groupes de substitution abstraits. Premier membre seulement : Il s'agit de la valeur par défaut de ce paramètre. Seul le premier membre du groupe de substitution sera généré. Tous les membres : Tous les membres du groupe de substitution seront générés. En général, un groupe de substitution abstrait doit être substitué par un seul membre. Ce paramètre peut être utilisé pour examiner tous les membres possibles du groupe de substitution. L'utilisation de cette valeur peut conduire à un document de sortie très volumineux. Aucun membre : Aucun membre de groupe de substitution ne sera généré. En revanche, si le paramètre 'Annoter le XML avec des commentaires' est défini sur 'Oui', la sortie contiendra un commentaire indiquant le chemin d'accès aux membres du groupe de substitution. Ces chemins peuvent ensuite être utilisés dans un autre XMLSampleGenerator pour générer les membres individuels du groupe de substitution.
Eléments choix du schéma	Ce paramètre contrôle la sortie lorsque le schéma XML contient un xs:choice. Un xs:choice énumère un certain nombre d'éléments possibles qui peuvent apparaître dans la sortie. Première option seulement : Il s'agit de la valeur par défaut de ce paramètre. Seule la première option du choix sera générée. Toutes les options : Toutes les options de choix seront générées. En général, un document valide du point de vue du schéma ne contient qu'une seule option. La valeur de ce paramètre peut être utilisée pour examiner toutes les options de choix possibles. L'utilisation de cette valeur peut conduire à un document de sortie très volumineux. Aucune option : Aucune option de choix ne sera générée. En revanche, si le paramètre 'Annoter le XML avec des commentaires' est défini sur 'Oui', la sortie contiendra un commentaire indiquant le chemin vers les options de choix. Ces chemins peuvent ensuite être utilisés dans un autre XMLSampleGenerator pour générer les options de choix individuelles. Notez que seuls les chemins vers les éléments seront listés. Les séquences et les choix imbriqués ne produiront aucun chemin.
Générer l'en-tête XML	Si ce paramètre a pour valeur Oui, la sortie sera précédée d'un en-tête XML. Si ce paramètre a la valeur No, la sortie ne contiendra pas d'en-tête XML.
Associer un commentaire	Si ce paramètre est défini à "oui", la sortie contiendra des commentaires XML la décrivant. Ces commentaires décriront ce qui est nécessaire pour convertir l'échantillon XML en un document XML valide selon le schéma donné. Cela inclut des avertissements sur les types complexes récursifs et les groupes de substitution, des détails sur la multiplicité acceptable des éléments et des informations sur les types de données qu'un élément peut contenir.
Exposer les éléments d'annotation	Si oui, la sortie contiendra la documentation d'annotation et les informations d'application du document de schéma XML qui sont pertinentes pour l'échantillon XML. Le contenu des annotations est écrit dans des commentaires XML dans l'échantillon de sortie.

É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.

Définir des valeurs de paramètres

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.

Types de contenu

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.

Outils de tableau

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.