Étape du compositeur JSON (DataStage)

Cible JSON

Ecrire dans fichier

Entrez le répertoire de sortie et le préfixe du nom de fichier pour les fichiers à composer, 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 ceux 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 JSON composée à une étape ou un stade en aval pour un traitement ultérieur.

Transmettre sous forme d'objet LOB

Transmettez la chaîne JSON composée en tant qu'objet LOB. La dernière étape du travail doit être une étape qui tient compte des objets LOB, telle que le connecteur Db2, le connecteur Oracle, le connecteur ODBC, le connecteur Teradata ou le connecteur Websphere MQ. Ces étapes utilisent la chaîne du releveur de coordonnées LOB pour obtenir les données JSON, puis les écrivent dans la base de données cible ou la file d'attente de messages. Le travail peut contenir des étapes qui ne tiennent pas compte des objets LOBs, mais ces étapes ne doivent pas modifier la chaîne du releveur de coordonnées LOB. Si la dernière étape du travail ne tient pas compte des objets LOB, le releveur de coordonnées LOB est écrit en tant que données et n'est pas interprété comme un releveur de coordonnées.

Document racine

Sélectionnez l'élément de niveau supérieur ou une vue d'un schéma JSON qui décrit les données JSON que vous souhaitez composer. Le schéma JSON est un schéma généré lors de l'importation d'une instance de données JSON dans la bibliothèque de schémas.

Validation

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

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) à l'élément document_collection. Si vous souhaitez que chaque élément de la liste soit dans un document distinct, mappez une liste à l'élément document_collection. Si vous produisez plusieurs documents, un fichier est créé pour chaque élément de la liste. Pour plus d'informations sur le mappage, voir Travail avec la table de mappage (DataStage).

Un tableau JSON est modélisé comme plusieurs occurrences de types mixtes. Le choiceDescriminator indique la branche de choix que vous devez sélectionner pour l'élément de tableau particulier. Voici un exemple de tableau JSON.

[
	{"type": "home", "number": "212 555-1234"},
	[116, 943, 234],
	true
]

Dans l'exemple ci-dessus, le choiceDescriminator a la valeur objectValue pour le premier élément de tableau qui est un objet. Le choiceDescriminator a la valeur arrayValue car le second élément de tableau est un tableau imbriqué. Le choiceDescriminator a la valeur booleanValue. La valeur de choiceDescriminator contient stringValue, numberValue, booleanValue, nullValue, objectValue et arrayValue. Lorsque vous composez les données JSON, vous devez choisir la valeur qui doit être utilisée parmi les valeurs disponibles.

Format

Type de codage

Sélectionnez le codage à utiliser pour le document. Le codage par défaut est UTF-8.

Style de format

Appliquez les options de format suivantes à la sortie JSON :

Longueur de renfoncement

Sélectionnez le nombre de caractères à utiliser pour chaque niveau d'indentation dans la sortie JSON.

Style de nouvelle ligne

Sélectionnez le type de nouvelle ligne. Les options sont UNIX (LF), DOS (CRLF) ou MAC (CR).