XML PARSE |
Analyseur XML |
---|---|
Cobol |
Syntaxe
XML PARSE [[WITH] ENCODING codepage] [RETURNING NATIONAL] VALIDATING [WITH [identifier2|FILE xmlschemaname1]] PROCESSING PROCEDURE [IS] procedurename1 (THROUGH|THRU) procedurename2 [[ON] EXCEPTION imperativestatement1] [NOT [ON] EXCEPTION imperativestatement2] [END-XML] |
Paramètres
Nom | Description |
---|---|
ENCODING codepage | Ce paramètre permet d'indiquer l'encodage utilisé pour analyser le document XML. Par exemple, cela pourrait être UTF-8, ISO-8859-1 ou un autre encodage spécifique pour le fichier XML. |
RETURNING NATIONAL | Ce paramètre permet de retourner les données sous un format national, généralement utilisé pour les caractères non latins ou les caractères spéciaux dans des systèmes multilingues. |
VALIDATING WITH identifier2 | Ce paramètre permet de spécifier qu'une validation doit être effectuée pendant l'analyse du fichier XML. L'identifier2 correspond à une valeur qui pourrait être un fichier, une variable, ou un objet qui contient un schéma XML (comme un fichier XSD) pour valider la structure du document XML. Cette option assure que le fichier XML est conforme aux règles définies dans le schéma avant de le traiter. |
FILE xmlschemaname1 | Ce paramètre définit le nom du fichier de schéma XML (XSD) qui sera utilisé pour valider le document XML pendant le processus de VALIDATING. Le schéma XML définit les structures, types de données et contraintes que le fichier XML doit respecter. |
PROCESSING PROCEDURE [IS] procedurename1 | Ce paramètre permet de spécifier la première procédure qui sera utilisée pour traiter les morceaux du document XML pendant l'analyse. La procédure procedurename1 est appelée pour chaque élément XML que l'analyseur rencontre. Cette procédure est généralement responsable de l'extraction, de la validation ou de la transformation des données extraites du fichier XML. |
(THROUGH|THRU) procedurename2 | Ce paramètre permet d'indiquer un intervalle continue de procédures, de manière à ce que toutes les procédures entre procedurename1 et procedurename2 soient exécutées successivement, chacune traitant les données extraites du fichier XML. Cela permet une grande flexibilité dans le traitement des données XML en plusieurs étapes. |
ON EXCEPTION imperativestatement1 | Ce paramètre définit les instructions à exécuter si une exception se produit pendant l'analyse du document XML. Cela peut inclure des erreurs de syntaxe XML ou des problèmes de données malformées. |
NOT ON EXCEPTION imperativestatement2 | Ce paramètre spécifie les instructions à exécuter lorsque ON EXCEPTION n'est pas déclenché, c'est-à-dire lorsqu'aucune erreur n'est rencontrée pendant l'analyse du XML. |
END-XML | Ce paramètre permet de marquer la fin de la section de traitement XML, fermant le bloc de code qui analyse ou traite le fichier XML. |
Description
Cette instruction permet d'effectuer l'analyse rapide d'un document XML en morceaux individuels et effectue un traitement pour chacun de ceux-ci.
Remarques
- Fonction principale : L'instruction XML PARSE permet de découper un document XML en éléments individuels, les analysant séquentiellement. Chaque élément ou fragment du fichier XML est extrait et traité via des procédures spécifiées, ce qui permet de manipuler efficacement les données XML à l'intérieur du programme COBOL.
- Encodage des caractères : Le paramètre ENCODING codepage permet de spécifier l'encodage utilisé pour le fichier XML. Cela est crucial si le fichier XML contient des caractères non standard ou des symboles spéciaux qui nécessitent un encodage spécifique pour être correctement interprétés. En définissant le codepage, le programme COBOL peut gérer diverses normes de codage, comme UTF-8 ou d'autres formats de texte.
- Retour de données nationales : Le paramètre RETURNING NATIONAL est utilisé pour spécifier que le résultat de l'analyse XML doit être retourné en utilisant des types de données nationaux (national characters), ce qui est souvent nécessaire pour manipuler des caractères non ASCII ou des données multilingues dans le programme COBOL.
- Validation du XML : VALIDATING [WITH identifier2 | FILE xmlschemaname1] permet de valider la structure du document XML par rapport à un schéma XML défini. Cela garantit que le document XML respecte bien la syntaxe et les contraintes définies dans le schéma, ce qui est essentiel pour garantir l'intégrité des données avant de les traiter dans COBOL.
- Procédure de traitement personnalisée : Le paramètre PROCESSING PROCEDURE permet de définir une ou plusieurs procédures personnalisées (comme procedurename1 et procedurename2) pour traiter chaque fragment de XML. Ce traitement personnalisé peut inclure des opérations comme la transformation des données, la validation supplémentaire ou le stockage des éléments extraits dans des variables spécifiques du programme.
- Gestion des exceptions : L'option ON EXCEPTION permet de spécifier une action à effectuer en cas d'erreur lors du processus d'analyse XML. Cela permet de gérer proprement les erreurs (comme un XML mal formé) en exécutant un bloc d'instructions défini par l'utilisateur, ce qui améliore la robustesse du programme. De plus, NOT ON EXCEPTION permet de spécifier une action alternative à prendre si aucune erreur n'est rencontrée.
- Flexibilité de traitement : En utilisant (THROUGH|THRU) procedurename2, il est possible de définir un ensemble de procédures à appeler successivement lors de l'analyse des éléments XML. Cela permet de gérer plusieurs étapes de traitement, et chaque procédure peut être responsable d'une tâche spécifique, comme l'extraction de données, la conversion de formats, ou la mise à jour de structures internes.
- Optimisation du traitement XML : L'instruction XML PARSE est particulièrement efficace pour analyser de grandes quantités de données XML en les découpant en morceaux gérables. Ce mécanisme de "streaming" permet de traiter le fichier XML de manière progressive et d'éviter de charger l'intégralité du document en mémoire, ce qui est important pour les grandes bases de données ou les fichiers XML complexes.
Dernière mise à jour : Jeudi, le 28 juillet 2011