0 / 0
Torna alla versione inglese della documentazione

Passo di XML Composer (DataStage)

Ultimo aggiornamento: 12 mar 2025
Passo Composer XML (stage Hierarchical Data)

Utilizzare una struttura specificata per comporre il contenuto XML.

Destinazione XML

Scrivi su file
Immettere la directory di output e il prefisso del nome file per i file che verranno composti oppure fare clic su Inserisci parametro e selezionare il nome del parametro per la directory di output e il prefisso del nome file. I parametri disponibili sono i parametri precedentemente definiti nel job e le macro integrate presenti in IBM® InfoSphere® DataStage®.
Passa come stringa
Passare la stringa XML composta ad un passo o ad uno stage downstream per un'ulteriore elaborazione.
Passa come oggetto di grandi dimensioni
Passare la stringa XML composta come un oggetto di grandi dimensioni. Lo stage di destinazione finale - che è l'ultimo stage nel job - deve essere uno stage che riconosce LOB, come il connettore Db2 , il connettore Oracle , il connettore ODBC , il connettore Teradata , o WebSphere MQ . Questi stage utilizzano la stringa dell'indicatore di posizione LOB per ottenere i dati XML e quindi scriverli nel database di destinazione o nella coda messaggi. Il job può contenere stage che non conoscono LOB, ma questi stage non devono modificare la stringa del localizzatore LOB. Se l'ultimo stage nel job non è sensibile al LOB, il localizzatore LOB viene scritto come dati, piuttosto che essere interpretato come un localizzatore.

Root documento

Selezionare l'elemento di primo livello che descrive i documenti che si stanno componendo. I tipi che vengono visualizzati nello spazio dei nomi della libreria sono definizioni di elementi di livello superiore. Seguendo lo standard dello schema XML, solo gli elementi di livello superiore possono descrivere i documenti. Il nome dell'elemento selezionato deve corrispondere al nome dell'elemento di livello superiore nei documenti dell'istanza. Ad esempio, se si stanno componendo documenti Ordine, si seleziona l'elemento Ordine. Quando si seleziona l'elemento, è possibile visualizzarne la struttura e verificare che la struttura sia corretta per i documenti che si desidera comporre.
Nota: gli elementi da cui si seleziona la root del documento provengono dalle risorse precedentemente importate nelle librerie di schema. Se è necessario importare la risorsa che contiene la root del documento per il passo Composer XML, fare clic sulla scheda Apri librerie e importare la risorsa desiderata. Quindi, tornare all'editor Assembly e configurare la radice del documento.

Convalida

Per impostazione predefinita, XML Composer utilizza la convalida Minima e il lavoro non riesce se si verifica una violazione. Per personalizzare la convalida, specificare l'azione da eseguire quando si verifica una violazione.

Per ulteriori informazioni sulle regole di convalida, vedere Regole di convalida di XML Composer (DataStage).

Associazioni

Creare una corrispondenza all'elemento document_collection. Il modo in cui viene associato questo elemento determina la creazione di un documento o di più documenti. Per produrre un solo documento, associare la root dell'input (superiore) a document_collection. Per produrre più documenti, associare un elemento di elenco all'elemento document_collection. Quindi, viene creato un file per ogni elemento nell'elenco. Per ulteriori informazioni sulla mappatura, vedere Lavoro con la tabella di mappatura (DataStage).

Intestazione

Specificare ulteriori informazioni facoltative da includere all'inizio dell'output XML.

Genera frammento XML
Non includere dichiarazioni XML, commenti e istruzioni di elaborazione.
Includi dichiarazione XML
Includere la dichiarazione XML, ad esempio <?xml version="1.0" encoding="UTF-8">.
Includi commenti
Includere i commenti immessi nel campo Commenti .
Includi istruzioni di elaborazione
Includere le istruzioni di elaborazione immesse nel campo Istruzioni di elaborazione . Racchiudere ogni istruzione di elaborazione in <? e?>.
Includi schemaLocation
Includere l'attributo schemaLocation in un file xml con il valore immesso nel campo Ubicazione schema .
Includi noNamespaceSchemaLocation
Includere l'attributo noNamespaceSchemaLocation nel file XML con il valore immesso nel campo Nessuna posizione schema spazio dei nomi .

Formato

Tipo di codifica
Selezionare la codifica da utilizzare per il documento. La codifica predefinita è UTF-8.
Stile formato
Selezionare la casella per applicare le seguenti opzioni di formato all'output XML:
  • Spazi per livello di rientro - Selezionare il numero di caratteri da utilizzare per ciascun livello di rientro nell'output XML.
  • Nuovo stile linea - Selezionare il tipo di nuova linea. Le scelte sono UNIX (LF), DOS (CRLF) o MAC (CR).
  • Fuso orario - Specificare il valore del fuso orario da + 14:00 a -14:00. Se i dati di output del compositore hanno elementi di tipo data (time, dateTime, o gMonth), il passo del compositore converte il tipo di dati data secondo il fuso orario specificato e aggiunge i dati convertiti ai dati di output del compositore. Se i dati di output del composer non contengono alcuna informazione sul fuso orario, il fuso orario specificato nel campo di testo viene accodato ai dati di output del composer.

    È possibile selezionare l'opzione Inserisci parametro per inserire parametri contenenti il fuso orario in fase di runtime invece di specificarli in fase di progettazione.

  • Ometti attributi con valore predefinito - Per gli attributi che hanno valori predefiniti e che si trovano nei dati o per gli attributi che hanno valori fissi, omettere i valori dall'output XML.
  • Ometti elementi null - Per gli elementi nullable che non sono nei dati, omettere gli elementi dall'output XML.
  • Ometti elementi vuoti facoltativi - Se un nodo XML ha un valore vuoto, omettere gli elementi dall'output XML.