Regole di convalida del parser XML ( DataStage® )

Per impostazione predefinita, il parser XML utilizza una convalida minima e ignora le violazioni. Per personalizzare la convalida, specificare l'azione da eseguire quando si verifica una violazione.

Le tabelle seguenti descrivono le regole di convalida e le azioni applicabili.

Tabella 1. Regole di convalida dei valori
Regola	Descrizione	Azioni
Il tipo di dati ha un valore non ammesso	Il valore deve corrispondere alle regole di valore per il tipo di dati dell'elemento corrispondente.	Ignora Il controllo dei tipi e la conversione dei tipi non vengono eseguiti. I tipi degli elementi definiti dallo schema vengono sostituiti dal tipo String. Ad esempio, se lo schema include un elemento denominato startDate di tipo Date, il tipo di tale elemento nell'output del passaggio diventa String, anziché Date. Registra per ogni occorrenza; registra una volta per ogni documento Viene eseguito il controllo del tipo. Se un tipo non supera il controllo, viene segnalato un errore di log una volta per ogni occorrenza o una volta per l'intero documento; tuttavia, l'analisi sintattica continua. La conversione dei tipi non viene eseguita. I tipi reali degli elementi nell'output Step vengono sostituiti da tipi stringa. Rifiuta Vengono eseguiti il controllo dei tipi e la conversione dei tipi. Solo i valori non validi causano l'errore nell'analisi del documento non valido. L'elemento " ParsingStatus " viene aggiunto come nuovo gruppo all'output del passaggio "XML Parser" e viene impostato su "False" e contiene il messaggio di errore corrispondente. Irreversibile Vengono eseguiti il controllo dei tipi e la conversione dei tipi. Un valore non valido causa il fallimento del processo. Converti in predefinito Vengono eseguiti il controllo dei tipi e la conversione dei tipi. Un valore non valido viene sostituito con il suo valore predefinito.
Il valore non rispetta il vincolo facet Nota: Se si abilita questa regola, anche la regola "Il tipo di dati ha un valore non valido" viene impostata con lo stesso valore scelto per la regola " Il valore non soddisfa il vincolo del facet ".	Il valore viene verificato rispetto alle caratteristiche del tipo di elemento corrispondente.	Ignora Il controllo delle sfaccettature non viene eseguito. Registra per ogni occorrenza; registra una volta per ogni documento Viene eseguito il controllo delle sfaccettature. Vengono generati errori di log per le violazioni e l'analisi continua. Rifiuta Viene eseguito il controllo delle sfaccettature. I valori non validi causeranno solo il fallimento dell'analisi del documento non valido e l'elemento ParsingStatus, aggiunto come nuovo gruppo al passaggio Output per il passaggio XML Parser, verrà impostato su False con il messaggio di errore corrispondente. Irreversibile Viene eseguito il controllo delle sfaccettature. Un valore non valido causa il fallimento del processo. Converti in predefinito Viene eseguito il controllo delle sfaccettature. Un valore non valido viene sostituito con il suo valore predefinito.
Un elemento che non può essere null ha un valore null	Gli elementi non nulli vengono controllati per garantire che non contengano valori nulli.	Ignora Il controllo dei valori nulli non viene eseguito. Tutti gli elementi nella fase Output per la fase XML Parser diventano nullable. Tutti gli elementi nell'output del passaggio diventano nullable. Registra per ogni occorrenza; registra una volta per ogni documento Viene eseguito il controllo dei valori nulli e vengono generati errori di log. Sono impostati valori nulli. Di conseguenza, tutti gli elementi nella fase Output per la fase XML Parser diventano nullable. Rifiuta Viene eseguito il controllo dei valori nulli. I valori non validi causeranno solo il fallimento dell'analisi del documento non valido e l'elemento ParsingStatus, aggiunto come nuovo gruppo al passaggio Output per il passaggio XML Parser, viene impostato su False e include il messaggio di errore corrispondente. Irreversibile Viene eseguito il controllo dei valori nulli. Un valore non valido causa il fallimento del processo. Converti in predefinito Viene eseguito il controllo dei valori nulli. Un valore non valido viene sostituito con il suo valore predefinito. Non scrivere dati per questo valore Il controllo dei valori nulli non viene eseguito. La colonna di output non conterrà alcun dato.
Utilizza valori predefiniti globali per i valori mancanti	I valori mancanti vengono sostituiti con i valori predefiniti.	No Se lo schema definisce un valore predefinito per l'elemento, viene utilizzato tale valore predefinito. Altrimenti, il valore viene impostato su nil. Vero Se lo schema definisce un valore predefinito per l'elemento, viene utilizzato tale valore predefinito. Altrimenti, il valore viene impostato sul valore predefinito specificato nel pannello Amministrazione assemblaggio.
Rimuovi spazi dai valori	Riduci lo spazio bianco prima e dopo un valore prima di eseguire il controllo del tipo e la conversione del tipo.	No Il taglio non viene eseguito. Vero Il taglio viene eseguito su entrambi i lati del valore.

Tabella 2. Regole di convalida della struttura
Regola	Descrizione	Azioni
Documento in formato non corretto	Il documento è malformato.	Ignora Non viene registrato alcun messaggio di errore. Registro per documento Viene registrato un messaggio di errore. Rifiuta L'elemento " ParsingStatus ", aggiunto come nuovo gruppo al passaggio "Output" del passaggio "XML Parser", è impostato su "False" e include il messaggio di errore corrispondente. Irreversibile Un documento malformato causa il fallimento del processo.
Gli elementi non sono dichiarati nello schema	Gli elementi nel documento di istanza devono essere dichiarati nello schema. Le violazioni possono verificarsi quando un processo utilizza una versione non aggiornata di uno schema.	Ignora Non viene registrato alcun messaggio di errore. Gli elementi vengono analizzati in base alla migliore ipotesi possibile. Registra per ogni occorrenza; registra una volta per ogni documento I messaggi di errore vengono registrati. Gli elementi vengono analizzati in base alla migliore ipotesi possibile. Rifiuta L'elemento " ParsingStatus ", aggiunto come nuovo gruppo al passaggio "Output" del passaggio "XML Parser", è impostato su "False" e include il messaggio di errore corrispondente. Irreversibile Un elemento non dichiarato nello schema causa il fallimento del processo.
L'elemento Nil ha un valore	Gli elementi nullable vengono controllati per garantire che non contengano valori di dati. Questo vale solo per gli elementi per cui nullable è impostato su true nel documento xml.	Ignora Non viene registrato alcun messaggio di errore. Gli elementi vengono analizzati in base alla migliore ipotesi possibile. Registra per ogni occorrenza; registra una volta per ogni documento I messaggi di errore vengono registrati. Gli elementi vengono analizzati in base alla migliore ipotesi possibile. Rifiuta L'elemento " ParsingStatus ", aggiunto come nuovo gruppo al passaggio "Output" del passaggio "XML Parser", è impostato su "False" e include il messaggio di errore corrispondente. Irreversibile Un elemento nullo con un valore causa il fallimento del processo.
Elemento obbligatorio mancante	Gli elementi devono apparire correttamente nel documento dell'istanza. Le violazioni possono verificarsi se manca un attributo richiesto o se un elemento appare fuori ordine in un contenuto sequenziale.	Ignora Non viene effettuato alcun controllo degli elementi obbligatori. Non viene registrato alcun messaggio di errore. Di conseguenza, tutti gli elementi nella fase Output diventano facoltativi. Registra per ogni occorrenza; registra una volta per ogni documento I messaggi di errore vengono registrati. L'analisi sintattica continua, anche se mancano dei dati. Di conseguenza, tutti gli elementi nella fase Output diventano facoltativi. Rifiuta L'elemento " ParsingStatus ", aggiunto come nuovo gruppo al passaggio "Output" del passaggio "XML Parser", è impostato su "False" e include il messaggio di errore corrispondente. Irreversibile La mancanza di un elemento obbligatorio causa il fallimento del processo.
L'elenco contiene un numero di ricorrenze non valido	Il numero di occorrenze deve essere compreso tra il valore dell'attributo MinOccurs e quello dell'attributo MaxOccurs, come definito nello schema.	Ignora Non viene registrato alcun messaggio di errore. Registra per ogni occorrenza; registra una volta per ogni documento I messaggi di errore vengono registrati. Rifiuta L'elemento " ParsingStatus ", aggiunto come nuovo gruppo al passaggio "Output" del passaggio "XML Parser", è impostato su "False" e include il messaggio di errore corrispondente. Irreversibile Se l'elenco contiene un numero non valido di occorrenze, il processo non va a buon fine.
I valori ID non sono univoci	Ogni documento deve avere un ID univoco.	Ignora Non viene registrato alcun messaggio di errore. Registra per ogni occorrenza; registra una volta per ogni documento I messaggi di errore vengono registrati. Rifiuta L'elemento " ParsingStatus ", aggiunto come nuovo gruppo al passaggio "Output" del passaggio "XML Parser", è impostato su "False" e include il messaggio di errore corrispondente. Irreversibile I valori ID duplicati causano il fallimento del processo.