Convertir du texte en version XML avec un fichier de schéma de texte
Créez un assemblage contenant une étape
textschema
. Obtenez l’exemple de texte qui constituera la base de votre schéma de texte. L’étape
textschema
vous permet de convertir du texte en version XML à l’aide d’un schéma de texte. Pour développer un schéma de texte, vous devez connaître la structure des données que vous souhaitez transformer. Le processus est considérablement simplifié grâce à un petit exemple de document contenant des données représentatives. Cette rubrique suppose que vous avez un tel exemple. Vous pouvez utiliser l’étape
textschema
pour convertir la version XML en texte ou pour transformer des fichiers délimités, mais dans la plupart des cas, il est plus simple d’utiliser l’étape XTT
et l’étape csv-to-xml
, respectivement.- Dans la vuePropertiesde l’étapetextschema, cliquez surCreate Text Schema File.
- Sélectionnez un dossier parent pour le fichier de schéma de texte et entrez un nom de fichier. Si nécessaire, indiquez l’URI de l’espace de noms cible.
- Studio ouvre l’éditeur de schéma de texte et affiche le nouveau schéma de texte dans sonarborescence.
- Coupez et collez votre exemple de texte dans la zone supérieure droite de l’éditeur de schéma de texte, en le remplaçant parinitial-text.Pour retirer le saut de ligne de fin d'emploi des fichiers d'entrée, ajoutez cet attribut à l'élément de schéma racine :ts:eofStrip=" ".
- Commencez à décrire l’exemple de texte. Sélectionnez le premier champ, puis cliquez sur celui-ci avec le bouton droit de la souris et sélectionnezCreate Field.Si vous ne disposez pas d’un échantillon du texte à convertir mais que vous en connaissez la structure, vous pouvez modifier directement la vueSourcedu schéma de texte.
- Dans la pageIdentityduCreate Field Wizard, fournissez une description de base du champ. Pour la tâche, tenez compte des éléments suivants :
Option Description NomUn nom pour le champ.OccurrenceLes options sont les suivantes :- Default: le champ est obligatoire et n’apparaît qu’une seule fois.
- Required: identique à la valeur par défaut.
- Optional: le champ est facultatif et ne peut apparaître qu’une seule fois.
- Multiple Optional: le champ est facultatif et peut apparaître plusieurs fois.
- Multiple Required: le champ est obligatoire et peut apparaître plusieurs fois.
Start TagUne expression rationnelle qui définit le texte à l’origine de la génération d’un élément. Notez que le texte correspondant à cette expression ne fait pas partie de la valeur de sortie. Si vous voulez que le texte mis en correspondance soit affiché dans la valeur de sortie, utilisez la fonctionts:formatoption.Marqueur de finUne expression rationnelle qui définit le texte marquant la fin d’un élément. Notez que le texte correspondant à cette expression ne fait pas partie de la valeur de sortie. Si vous voulez que le texte mis en correspondance soit affiché dans la valeur de sortie, utilisez la fonctionts:formatoption.TronquerIndique s’il faut tronquer les données en dépassement dans un champ de longueur fixe ou lancer une erreur. La valeur par défaut esttrue.SéparateurUne expression rationnelle qui définit le caractère qui sépare les champs répétés. Activée uniquement si vous sélectionnez les options d’occurrenceMultiple OptionalouMultiple Required.OmitIndique s’il faut omettre le champ de la sortie dans une transformationtext-to-XMLouXML-to-text. La valeur par défaut est no omission. - Dans la pageDelimitdeCreate Field Wizard, décrivez le nombre de caractères de l’exemple de texte qui représentent un champ :
Option Description FormatUne expression rationnelle qui désigne des modèles de texte valides pour un champ. Utilisez cette expression comme alternative àStart TagetEnd Tagpour vous assurer que tout le texte correspondant s’affiche dans la sortie. Vous pouvez également l’utiliser lorsque vous traitez des valeurs à occurrences multiples, de manière à ce que la fin de la séquence soit claire.Fixed LengthIndique la longueur des champs de longueur fixe. Inclut les guillemets et les caractères d’échappement.QuotedIndique si les valeurs des chaînes sont traitées comme des chaînes entre guillemets. Les options sont les suivantes :- Default:
- always:
- always-including-empty:
- optional:
- never:
PaddingUne expression rationnelle qui identifie tout texte de remplissage dans les champs de longueur fixe.Preferred PaddingIndique la valeur à utiliser si l’expression dePaddingpeut correspondre à plus d’une (1) chaîne possible.AlignIndique l’alignement des champs de longueur fixe qui nécessitent un remplissage. - Dans la pageInterpretduCreate Field Wizard, décrivez le nombre de caractères de l’exemple de texte qui représentent un champ :
Option Description TypeLe type de données du champ.Valeur par défautUne valeur par défaut pour le champ.Date FormatIndique un modèle pour les dates ou les dates et les heures. Prend en charge tous les modèles autorisés par JavaSimpleDateFormat.Date et langueIndique la langue de la date à utiliser lors de l’interprétation des dates. Assure que le nom est traité dans la langue appropriée lorsque le format de date utilise les noms de mois. La valeur par défaut estEN.Année à deux chiffresIndique une valeur pour interpréter les dates d’une année à deux (2) chiffres. L’analyseur du schéma de texte interprète les dates d’année à 2 chiffres antérieures à cette valeur comme étant dans le siége actuel. Exemple : si vous entrez18, l'analyseur interprète14en tant que2014et96en tant que1996.Format de nombreIndique un modèle pour les nombres. Prend en charge tous les modèles autorisés par JavaDecimalFormat.Signe décimalIndique le séparateur utilisé pour les nombres décimaux.Grouping SeparatorIndique le séparateur des groupes de milliers pour les nombres. - Répétez les étapes 6 à 9 pour chaque champ de l’exemple de texte, en ajoutant de nouveaux éléments dans l’arborescence. Quand vous avez créé toutes les définitions de champs obligatoires, supprimez les définitions restantes.Unparsedélément enfant.
- Pour envelopper tous les éléments que vous avez créés dans un type complexe, sélectionnez-les, cliquez avec le bouton droit de la souris, puis sélectionnezÉléments d’enveloppement. Fournissez ensuite un nom et une valeur d’occurrence pour l’élément de regroupement.
- Dans la vuedes propriétésde l’élément d’enveloppe, sélectionnez/ndans la liste déroulanteMarqueur de fin.
- L'élément racine du schéma par défaut est nomméFile. Dans l’ongletSchémade la vuedes propriétésde l’élément, fournissez un nom plus significatif.
- Dans la vuedes propriétésdu niveau supérieurschemaélément, la propriétéÉlément racinea la valeurtns:File. RemplacerFileavec le nom significatif que vous avez sélectionné pour l'élément racine.
- Pour retirer des espaces supplémentaires de la sortie générée, sélectionnez la vuePropriétésdu niveau supérieur.schemaélément. Sélectionnez+dans la liste déroulanteRemplissage. Enregistrez le schéma.