0 / 0
Retourner à la version anglaise de la documentation

XML Composer step (DataStage)

Dernière mise à jour : 12 mars 2025
Etape XML Composer (étape Données hiérarchiques)

Utilisez une structure spécifiée pour composer un contenu XML.

Cible XML

Ecrire dans le fichier
Entrez le répertoire de sortie et le préfixe du nom de fichier pour les fichiers qui seront composés, ou cliquez sur Insérer un paramètre, puis sélectionnez le nom du paramètre pour le répertoire de sortie et le préfixe du nom de fichier. Les paramètres disponibles sont les paramètres que vous avez précédemment définis dans le travail et les macros intégrées qui se trouvent dans IBM® InfoSphere® DataStage®.
Transmettre sous forme de chaîne
Transmettez la chaîne XML composée à une étape ou à une étape en aval pour traitement ultérieur.
Transmettre sous forme d'objet LOB
Transmettez la chaîne XML composée sous forme d'objet LOB. L'étape cible finale, c'est-à-dire la dernière étape du travail, doit être une étape compatible LOB, telle que le connecteur Db2, Oracle, ODBC, Teradata ou WebSphere MQ. Ces étapes utilisent la chaîne de releveur de coordonnées LOB pour obtenir les données XML, puis les écrivent dans la base de données cible ou la file d'attente de messages. Le travail peut contenir des étapes non compatibles LOB, mais ces étapes ne doivent pas modifier la chaîne de releveur de coordonnées LOB. Si la dernière étape du travail n'est pas compatible LOB, le releveur de coordonnées LOB est écrit sous forme de données, au lieu d'être interprété comme un releveur de coordonnées.

Document racine

Sélectionnez l'élément de niveau supérieur qui décrit les documents que vous composez. Les types qui s'affichent sous l'espace de nom de la bibliothèque sont des définitions d'élément de niveau supérieur. À la suite de la norme de schéma XML, seuls les éléments de niveau supérieur peuvent décrire des documents. Le nom de l'élément que vous sélectionnez doit correspondre au nom de l'élément de niveau supérieur dans les documents d'instance. Par exemple, si vous composez des documents de commande, vous sélectionnez l'élément Commande. Lorsque vous sélectionnez l'élément, vous pouvez afficher sa structure et vérifier que la structure est correcte pour les documents que vous souhaitez composer.
Remarque: Les éléments à partir desquels vous sélectionnez la racine de document proviennent des ressources précédemment importées dans les bibliothèques de schémas. Si vous devez importer la ressource qui contient la racine de document pour l'étape XML Composer, cliquez sur Bibliothèques ouvertes et importez la ressource dont vous avez besoin. Ensuite, retournez à l'éditeur d'assemblage et configurez la racine du document.

Validation

Par défaut, XML Composer utilise une validation minimale et le travail échoue en cas de violation. Pour personnaliser la validation, indiquez l'action à effectuer lorsqu'une violation se produit.

Pour plus d'informations sur les règles de validation, voir Règles de validation de XML Composer (DataStage).

Mappages

Créez un mappage vers l'élément document_collection. La façon dont cet élément est mappé détermine si un ou plusieurs documents sont créés. Pour ne produire qu'un seul document, mappez la racine de l'entrée (en haut) sur document_collection. Pour générer plusieurs documents, mappez un élément de liste à l'élément document_collection. Un fichier est alors créé pour chaque élément de la liste. Pour plus d'informations sur le mappage, voir Travail avec la table de mappage (DataStage).

En-tête

Indiquez d'autres informations facultatives à inclure au début de la sortie XML.

Générer un fragment XML
N'incluez pas la déclaration XML, les commentaires et les instructions de traitement.
Inclure une déclaration XML
Incluez la déclaration XML, par exemple, <?xml version="1.0" encoding="UTF-8">.
Inclure des commentaires
Incluez les commentaires que vous entrez dans la zone Commentaires.
Inclure des instructions de traitement
Incluez les instructions de traitement que vous entrez dans la zone Instructions de traitement. Placez chaque instruction de traitement entre les balises <? et ?>.
Inclure schemaLocation
Incluez l'attribut schemaLocation dans le fichier xml avec la valeur que vous entrez dans la zone Emplacement du schéma.
Inclure noNamespaceSchemaLocation
Incluez l'attribut noNamespaceSchemaLocation dans le fichier xml avec la valeur que vous entrez dans la zone Aucun emplacement de schéma d'espace de noms.

Format

Type de codage
Sélectionnez le codage à utiliser pour le document. Le codage par défaut est UTF-8.
Style de format
Cochez la case pour appliquer les options de format suivantes à la sortie XML :
  • Espace par niveau de retrait – Sélectionnez le nombre de caractères à utiliser pour chaque niveau de retrait dans la sortie XML.
  • Style de nouvelle ligne – Sélectionnez le type de nouvelle ligne. Les options sont UNIX (LF), DOS (CRLF) ou MAC (CR).
  • Fuseau horaire – Indiquez la valeur de fuseau horaire de +14:00 à -14:00. Si les données de sortie du composeur comportent des éléments de type de données de date (heure, dateTime ou gMonth), l'étape du composeur convertit le type de données de date en fonction du fuseau horaire spécifié et ajoute les données converties aux données de sortie du composeur. Si les données de sortie du composeur ne contiennent pas d'informations de fuseau horaire, le fuseau horaire spécifié dans la zone de texte est ajouté aux données de sortie du composeur.

    Vous pouvez sélectionner l'option Insérer un paramètre pour insérer des paramètres contenant le fuseau horaire au moment de l'exécution au lieu de les spécifier au moment de la conception.

  • Omettre les attributs avec une valeur par défaut – Pour les attributs qui ont des valeurs par défaut et qui se trouvent dans les données ou pour les attributs qui ont des valeurs fixes, omettez les valeurs de la sortie XML.
  • Omettre les éléments NULL – Pour les éléments NULL admis qui ne sont pas dans les données, omettez les éléments de la sortie XML.
  • Omettre les éléments vides optionnels – Si un noeud XML a une valeur vide, omettez les éléments de la sortie XML.