Présentation des commandes XML SAX

4D v16.3

Ce thème regroupe les commandes XML SAX de 4D.

Pour des informations générales sur le XML (présentation, jeux de caractères, glossaire) ainsi que sur les différences entre les modes DOM et SAX, veuillez vous reporter à la section Présentation des commandes XML DOM.

Note à propos du mode préemptif : Les références XML créées par un process préemptif peuvent être utilisées dans ce process uniquement. A l'inverse, les références XML créées par des process coopératifs peuvent être utilisées par tout autre process coopératif, mais ne peuvent pas être utilisées par un process préemptif.

Création, ouverture et fermeture des documents XML via SAX

Les commandes SAX travaillent avec des références de documents standard de 4D (RefDoc, référence de type Heure). Il est donc possible d’utiliser ces commandes conjointement avec les commandes 4D permettant de gérer les documents, par exemple ENVOYER PAQUET ou Ajouter a document.
La création et l’ouverture par programmation de documents XML est effectuée via les commandes Creer document et Ouvrir document. Par la suite, l’utilisation d’une commande XML avec ces documents provoquera la mise en oeuvre automatique des mécanismes XML tels que l’encodage. Par exemple, l’en-tête <?xml version="1.0" encoding="… encodage …" standalone = "no "?> sera automatiquement écrit dans le document.

Note : Les documents destinés à la lecture SAX doivent impérativement être ouverts en mode “lecture seule” par la commande Ouvrir document. Ce principe est destiné à prévenir les conflits pouvant survenir entre 4D et la librairie Xerces lors de l’ouverture simultanée de documents “standard” et de documents XML. Si vous exécutez une commande d’analyse SAX avec un document ouvert en lecture-écriture, un message d’alerte est affiché et l’analyse est impossible.

La fermeture d’un document XML SAX doit être effectuée à l’aide de la commande FERMER DOCUMENT. Si des éléments XML étaient ouverts, ils sont automatiquement refermés.