Convalida di documenti e schemi ( DataStage )
L'output XML offre un'opzione per eseguire due controlli di convalida XML durante l'esecuzione:
- Controlli per XML ben formato.
- Verifica che gli elementi e gli attributi siano conformi a qualsiasi schema XML a cui fa riferimento il documento.
Se si decide di utilizzare questa opzione, vengono eseguite entrambe le convalide. Altrimenti, non viene eseguita alcuna convalida.
Per fare riferimento a uno schema nel documento XML, utilizzare l'attributo schemaLocation all'interno del tag dell'elemento radice.
Per informazioni sull'attivazione della convalida rispetto a uno schema, vedere Proprietà dello stage.
Impostazione delle opzioni dello schema XML
Per abilitare la convalida, utilizzare Strict l'opzione. Per disabilitare la convalida, utilizzare Default l'opzione.
Il parser XML compila lo schema di convalida per creare una grammatica dello schema. Durante la convalida della grammatica, il parser può applicare ulteriori passaggi denominati "controllo completo dei vincoli dello schema", che possono aumentare il tempo di elaborazione e richiedere un uso intensivo della memoria.
Se il tuo lavoro produce due o più documenti XML che utilizzano lo stesso schema, puoi evitare di ricompilare lo schema memorizzando la grammatica nella cache.
Per informazioni sull'attivazione della convalida dello schema, vedere Proprietà dello stage.
Impostazioni di convalida per schemi XML in DataStage
In Proprietà, impostare le proprietà per la convalida dei dati XML, la registrazione degli errori e la memorizzazione nella cache della grammatica. La fase XML verifica che il codice XML sia ben formato e, facoltativamente, 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 schemaLocation l'attributo all'interno del tag dell'elemento radice.
Il parser XML compila lo schema di convalida per creare una grammatica dello schema. Durante la convalida della grammatica, il parser può applicare ulteriori passaggi denominati "controllo completo dei vincoli dello schema", che possono aumentare il tempo di elaborazione e richiedere un uso intensivo della memoria. Per abilitare questo controllo, seleziona l'opzione Rigoroso sotto Livello di convalida XML. Per disabilitare questo tipo di convalida, utilizzare l'opzione Predefinito.
Se il tuo lavoro elabora due o più documenti XML che utilizzano lo stesso schema, puoi evitare di ricompilare lo schema memorizzando la grammatica nella cache. Selezionare Abilita cache grammaticale per memorizzare la grammatica nella cache.
Definire le mappature tra il processore XSLT Xalan e DataStage per determinare come vengono elaborati i messaggi di analisi e i documenti XML difettosi. Assegnare errori fatali, errori non fatali e avvisi a uno dei livelli di errore riportati nella tabella seguente.
| DataStage livello di errore | Risultato |
|---|---|
| Rifiuta | Le righe di documenti e i messaggi errati possono essere scritti in un collegamento Rifiuta, se presente. È anche possibile inviare i messaggi al registro delle attività. |
| Irreversibile | Il processo termina e i messaggi vengono scritti nel registro dei processi. |
| Avvertenza | Viene scritto un messaggio di avviso nel registro dei lavori. |
| Informazione | Un messaggio informativo viene scritto nel registro dei lavori. |
| Traccia | Le informazioni relative al debug e al monitoraggio vengono scritte nel registro delle attività. |
Mappatura degli errori di convalida agli DataStage errori
Il parser XML segnala tre tipi di condizioni: fatale, errore e avviso.
- Se il formato XML non è corretto, vengono generati errori irreversibili.
- Gli errori non fatali vengono generati quando l'XML viola un vincolo di validità. Ad esempio, l'elemento radice nel documento non è presente nello schema XML di convalida.
- È possibile che vengano generati avvisi quando lo schema presenta 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 analisi ai livelli DataStage® di errore, si decide come vengono elaborati i messaggi di analisi e i documenti XML difettosi.
La tabella seguente descrive come viene elaborato ciascun livello DataStage di errore.
| DataStage livello di errore | Risultato |
|---|---|
| Rifiuta | Le righe di documenti e i messaggi errati possono essere scritti in un collegamento Rifiuta, se presente. È anche possibile inviare i messaggi al registro delle attività. Per ulteriori informazioni sull'elaborazione dei messaggi e dei documenti, vedere Utilizzo dei collegamenti Rifiuta. |
| Irreversibile | Il processo server termina e i messaggi vengono scritti nel registro dei processi. |
| Avvertenza | Viene scritto un messaggio di avviso nel registro dei lavori. |
| Informazione | Un messaggio informativo viene scritto nel registro dei lavori. |
| Traccia | Se il processo viene eseguito con la tracciatura attivata, le informazioni di debug e monitoraggio vengono scritte nel log del processo. |
Per ulteriori informazioni sugli errori di mappatura e sulla loro registrazione, vedere Proprietà dello stage.
Utilizzo dei link di rifiuto
L'output XML supporta un collegamento Reject, che può memorizzare i messaggi di rifiuto e le righe rifiutate.
Scrivere messaggi di rifiuto al link
Per scrivere messaggi di rifiuto su un link di rifiuto:
- Aggiungi una colonna sul link Rifiuta.
- Utilizzando la pagina Generale delle proprietà del collegamento di output, identificare la colonna come destinazione dei messaggi di rifiuto.
Scrittura delle righe rifiutate nel collegamento
Per scrivere le righe rifiutate in un collegamento Reject:
Aggiungi una colonna sul collegamento Rifiuta che abbia lo stesso nome della colonna sulla colonna di destinazione sul collegamento di output.
I nomi delle colonne per questa operazione distinguono tra maiuscole e minuscole.
Per informazioni sulla configurazione di un collegamento di rifiuto, vedere Proprietà del collegamento di output.
Scrivere messaggi di rifiuto nel registro delle attività
Per scrivere messaggi di rifiuto nel registro dei lavori:
Nella pagina Impostazioni di convalida delle proprietà dello Stage, selezionare la casella Registra errori di rifiuto.
Per ulteriori informazioni sulla pagina Generale, vedere Proprietà dello stage.