4D v14.3
DOM Analyser source XML
- 4D - Langage
-
- XML DOM
-
- Présentation des commandes XML DOM
- DOM Ajouter element XML
- DOM Ajouter noeud enfant XML
- DOM Analyser source XML
- DOM Analyser variable XML
- DOM Chercher element XML
- DOM Chercher element XML par ID
- DOM Compter attributs XML
- DOM Compter elements XML
- DOM Creer element XML
- DOM Creer element XML tableaux
- DOM Creer ref XML
- DOM ECRIRE ATTRIBUT XML
- DOM ECRIRE NOM ELEMENT XML
- DOM ECRIRE VALEUR ELEMENT XML
- DOM EXPORTER VERS FICHIER
- DOM EXPORTER VERS VARIABLE
- DOM FERMER XML
- DOM FIXER DECLARATION XML
- DOM Inserer element XML
- DOM LIRE ATTRIBUT XML PAR INDEX
- DOM LIRE ATTRIBUT XML PAR NOM
- DOM Lire dernier element XML enfant
- DOM Lire element XML
- DOM Lire element XML frere precedent
- DOM Lire element XML frere suivant
- DOM Lire element XML parent
- DOM Lire element XML racine
- DOM Lire informations XML
- DOM LIRE NOEUDS ENFANTS XML
- DOM LIRE NOM ELEMENT XML
- DOM Lire premier element XML enfant
- DOM Lire ref document XML
- DOM LIRE VALEUR ELEMENT XML
- DOM SUPPRIMER ATTRIBUT XML
- DOM SUPPRIMER ELEMENT XML
DOM Analyser source XML
| DOM Analyser source XML ( nomFichier {; validation {; dtd | schéma}} ) -> Résultat | ||||||||
| Paramètre | Type | Description | ||||||
| nomFichier | Chaîne |
|
Chemin d’accès du document | |||||
| validation | Booléen |
|
Vrai = Validation, Faux = Pas de validation | |||||
| dtd | schéma | Chaîne |
|
Emplacement de la DTD ou du schéma XML | |||||
| Résultat | Chaîne |
|
Référence de l’élément XML (16 caractères) | |||||
La commande DOM Analyser source XML analyse un document contenant une structure XML et retourne une référence pour ce document. La commande peut valider ou non le document via une DTD ou un schéma XML (document XSD, XML Schema Definition).
Le document peut être situé sur disque ou sur Internet/Intranet.
Note : L'exécution de la commande DOM Analyser source XML est synchrone.
Vous pouvez passer dans le paramètre document :
- soit un chemin d’accès complet standard (du type C:\\Dossier\\Fichier\\... sous Windows et MacintoshHD:Dossier:Fichier sous Mac OS),
- soit un chemin Unix sous Mac OS (débutant obligatoirement par /).
- soit un chemin réseau du type http://www.site.com/Fichier ou ftp://public.ftp.com...
Le paramètre booléen validation vous permet d’indiquer si vous souhaitez que la structure soit validée ou non.
- Si validation vaut Vrai, la structure sera validée. Dans ce cas, l’analyseur tentera de valider la structure XML du document sur la base de la référence DTD ou XSD incluse dans le document, ou via la DTD ou le schéma XML désigné(e) par le troisième paramètre s'il est passé.
- Si validation vaut Faux, la structure ne sera pas validée.
Si vous passez Vrai dans validation et omettez le troisième paramètre, la commande tentera de valider la structure XML via une référence DTD ou XSD trouvée dans la structure elle-même. La validation peut être indirecte : si la structure contient une référence vers une fichier DTD qui lui-même contient une référence vers un fichier XSD, la commande tentera d’effectuer les deux validations.
Le troisième paramètre vous permet de désigner une DTD spécifique ou un schéma XML pour l’analyse du document. Si vous utilisez ce paramètre, la commande ne tient pas compte de la DTD référencée dans le document XML.
Validation par DTD
Il existe deux moyens pour désigner une DTD :
- en tant que référence. Il vous suffit pour cela de passer le chemin d’accès complet de la nouvelle DTD (extension “dtd”) dans le paramètre dtd. Si le document désigné ne contient pas de DTD valide, le paramètre dtd est ignoré et une erreur est générée.
- directement dans un texte. Dans ce cas, si le contenu du paramètre débute par “<?xml”, 4D considérera qu’il s’agit de la DTD ; dans le cas contraire, 4D considérera qu’il s’agit d’un chemin d’accès.
Validation par schema
Pour valider le document via un schéma XML, il suffit de passer dans le troisième paramètre un fichier ou un URL d’extension“xsd” au lieu de “dtd”. La validation par schéma XML est considérée comme plus souple et plus puissante que la validation par DTD. Le langage des documents XSD est basé sur le langage XML. Les schémas XML prennent notamment en charge des types de données. Pour plus d’informations sur les schémas XML, reportez-vous à l’adresse http://www.w3.org/XML/Schema.
Si la validation ne peut être effectuée (pas de DTD ou d'XSD, URL incorrect, etc.), une erreur est générée. La variable système Error indique le numéro de l’erreur. Vous pouvez intercepter cette erreur à l’aide d’une méthode installée par la commande APPELER SUR ERREUR.
La commande retourne une chaîne de 16 caractères (RefElément) constituant la référence en mémoire de la structure virtuelle du document. Cette référence devra être utilisée avec les autres commandes d’analyse XML.
Important : Une fois que vous n'en avez plus besoin, n'oubliez pas d'appeler la commande DOM FERMER XML avec cette référence afin de libérer la mémoire.
Ouverture sans validation d’un document XML situé sur disque :
$ref_XML_Struct:=DOM Analyser source XML("C:\\import.xml")Ouverture sans validation d’un document XML situé à côté du fichier de structure de la base :
$ref_XML_Struct:=DOM Analyser source XML("import.xml")Ouverture d’un document XML situé sur disque et validation à l’aide d’une DTD située sur le disque :
$ref_XML_Struct:=DOM Analyser source XML("C:\\import.xml";Vrai;"C:\\import_dtd.xml")Ouverture sans validation d’un document XML situé à un URL spécifique :
$ref_XML_Struct:=DOM Analyser source XML("http://www.4D.fr/xml/import.xml")Si la commande a été correctement exécutée, la variable système OK prend la valeur 1. Sinon, elle prend la valeur 0.
Produit : 4D
Thème : XML DOM
Numéro :
719
Nom intl. : DOM Parse XML source
Modifié : 4D v11 SQL
DOM Analyser variable XML
DOM FERMER XML
4D - Langage ( 4D v11 SQL Release 6)
4D - Langage ( 4D v12.4)
4D - Langage ( 4D v14 R2)
4D - Langage ( 4D v14 R3)
4D - Langage ( 4D v13.5)
4D - Langage ( 4D v14.3)
4D - Langage ( 4D v14 R4)
