Convalida di documenti e schemi (DataStage)
XML Output fornisce un'opzione per eseguire due controlli di convalida XML in fase di runtime:
- Verifica la presenza di XML con formato corretto.
- Verifica che gli elementi e gli attributi siano conformi a qualsiasi schema XML a cui si fa riferimento nel documento.
Se si decide di utilizzare l'opzione, vengono eseguite entrambe le convalide. In caso contrario, non si verifica alcuna convalida.
Per fare riferimento ad uno schema nel documento XML, utilizzare l'attributo schemaLocation all'interno della tag dell'elemento root.
Per informazioni sull'attivazione della convalida rispetto a uno schema, vedi Proprietà dello stage.
Impostazione delle opzioni dello schema XML
Per abilitare la convalida, utilizzare l'opzione Strict. Per disabilitare la convalida, utilizzare l'opzione Default.
Il parser XML compila lo schema di validazione per creare una grammatica dello schema. Durante la validazione della grammatica, il parser può applicare delle fasi aggiuntive, chiamate controllo dei vincoli dello schema completo, che possono aumentare il tempo di elaborazione e richiedere molta memoria.
Se il lavoro produce due o più documenti XML che utilizzano lo stesso schema, si può evitare di ricompilare lo schema mettendo in cache la grammatica.
Per informazioni sull'attivazione della convalida dello schema, vedere Proprietà dello stadio.
Impostazioni di convalida per gli schemi XML in DataStage
In Proprietà, impostare le proprietà per la convalida dei dati XML, la registrazione degli errori e la cache della grammatica. La fase XML verifica la presenza di XML ben formato e, facoltativamente, controlla che i dati siano conformi a uno schema XML di riferimento. Per utilizzare i valori predefiniti per gli elementi e gli attributi nei dati di output, è necessario specificare uno schema nei dati di input XML tramite l'attributo schemaLocation all'interno del tag dell'elemento principale.
Il parser XML compila lo schema di validazione per creare una grammatica dello schema. Durante la validazione della grammatica, il parser può applicare delle fasi aggiuntive, chiamate controllo dei vincoli dello schema completo, che possono aumentare il tempo di elaborazione e richiedere molta memoria. Per attivare questo controllo, selezionare l'opzione Strict in Livello di validazione XML. Per disattivare questo tipo di convalida, utilizzare l'opzione Predefinito.
Se il lavoro elabora due o più documenti XML che utilizzano lo stesso schema, si può evitare di ricompilare lo schema mettendo in cache la grammatica. Selezionare Abilita la cache della grammatica per memorizzare la grammatica.
Definire le mappature tra il processore Xalan XSLT e DataStage per determinare come vengono elaborati i messaggi di analisi e i documenti XML difettosi. Assegnare gli errori fatali, gli errori non fatali e le avvertenze a uno dei livelli di errore della seguente tabella.
| DataStage livello di errore | Risultato: |
|---|---|
| Rifiuta | Le righe e i messaggi del documento difettoso possono essere scritti in un collegamento Rifiuta, se esiste. È anche possibile inviare i messaggi al job log. |
| Irreversibile | Il lavoro termina e i messaggi vengono scritti nel registro del lavoro. |
| Avvertenza: | Un messaggio di avviso viene scritto nel log del lavoro. |
| Informazioni | Un messaggio informativo viene scritto nel job log. |
| Traccia | Le informazioni di debug e di monitoraggio vengono scritte nel log del lavoro. |
Mappatura degli errori di convalida in DataStage
Il parser XML segnala tre tipi di condizioni: fatale, errore e avviso.
- Gli errori fatali vengono lanciati quando l'XML non è ben formato.
- Gli errori non fatali vengono lanciati quando l'XML viola un vincolo di validità. Ad esempio, l'elemento radice del documento non è presente nello schema XML di convalida.
- Possono essere lanciati degli avvisi quando lo schema ha definizioni duplicate.
Per ulteriori informazioni su queste condizioni, consultare le specifiche XML e XML Schema sul sito Web del Worldwide Web Consortium.
Mappando i messaggi di parsing ai livelli di errore DataStage®, si decide come elaborare i messaggi di parsing e i documenti XML difettosi.
La tabella seguente descrive come viene elaborato ciascun livello di errore DataStage.
| DataStage livello di errore | Risultato: |
|---|---|
| Rifiuta | Le righe e i messaggi del documento difettoso possono essere scritti in un collegamento Rifiuta, se esiste. È anche possibile inviare i messaggi al job log. Per ulteriori informazioni sull'elaborazione di messaggi e documenti, vedere Utilizzo dei collegamenti di rifiuto. |
| Irreversibile | Il lavoro del server termina e i messaggi vengono scritti nel registro dei lavori. |
| Avvertenza: | Un messaggio di avviso viene scritto nel log del lavoro. |
| Informazioni | Un messaggio informativo viene scritto nel job log. |
| Traccia | Se il lavoro viene eseguito con il tracing attivato, le informazioni di debug e di monitoraggio vengono scritte nel registro del lavoro. |
Per ulteriori informazioni sugli errori di mappatura e sulla loro registrazione, vedere Proprietà dello stadio.
Utilizzo dei link di rifiuto
L'output XML supporta un collegamento Reject, che può memorizzare i messaggi di rifiuto e le righe rifiutate.
Scrittura di messaggi di rifiuto al link
Per scrivere i messaggi di rifiuto su un collegamento Reject:
- Aggiungere una colonna al link Rifiuta.
- Utilizzando la pagina Generale delle proprietà del Collegamento di uscita, identificate la colonna come destinazione dei messaggi di rifiuto.
Scrittura delle righe rifiutate al collegamento
Per scrivere le righe rifiutate in un collegamento Rifiuta:
Aggiungere una colonna sul collegamento Reject con lo stesso nome della colonna della colonna di destinazione sul collegamento di uscita.
I nomi delle colonne per questa operazione sono sensibili alle maiuscole e alle minuscole.
Per informazioni sull'impostazione di un collegamento Reject, vedere Proprietà dei collegamenti in uscita.
Scrivere i messaggi di rifiuto nel registro dei lavori
Per scrivere i messaggi di rifiuto nel registro lavori:
Nella pagina Impostazioni di validazione delle proprietà dello stage, selezionare la casella Registra errori di rifiuto.
Per ulteriori informazioni sulla pagina Generale, vedere Proprietà dello stadio.