DOM Parse XML source

Version 2004 (Geändert)

DOM Parse XML source (Dokument{; Gültigkeitsprüfung{; dtd}}) String

Die Funktion DOM Parse XML source analysiert ein Dokument mit einer XML Struktur und gibt eine Referenz auf dieses Dokument zurück. Die Funktion kann je nach Ergebnis das Dokument bestätigen bzw. nicht bestätigen.

Das Dokument kann auf der Festplatte oder im Internet/Intranet liegen.

Im Parameter Dokument übergeben Sie:

• entweder den vollständigen Standard-Zugriffspfad (unter Windows C:\Ordner\Datei\... auf MacOS:Ordner:Datei)

• oder einen Unix-Pfad unter Mac OS (der mit "/" beginnen muss).

• oder einen Netzwerkpfad vomTyp http://www.site.com/Datei bzw. ftp://public.ftp.com...

Der Boolean Parameter Gültigkeitsprüfung gibt an, ob die Struktur mit DTD bestätigbar ist oder nicht.

• Hat Gültigkeitsprüfung den Wert Wahr, wird die Struktur bestätigt. In diesem Fall versucht der Parser, die XML Struktur des Dokuments zu bestätigen, auf Basis der definierten DTD, der Referenz im Dokument oder des Parameters dtd.

• Hat Gültigkeitsprüfung den Wert Falsch, wird die Struktur nicht bestätigt.

Der Parameter dtd gibt die spezifische DTD zum Parsen des Dokuments an. Verwenden Sie diesen Parameter, berücksichtigt die Funktion nicht die DTD, die im XML Dokument angegeben wird.

Sie können die DTD definieren:

• Als eine Referenz. Dazu übergeben Sie im Parameter dtd den vollständigen Zugriffspfad der neuen DTD. Enthält das angegebene Dokument keine gültige DTD, wird dtd ignoriert und ein Fehler angezeigt.

• In einem BLOB oder Text. Beginnt der Inhalt des Parameters mit "<xml !", betrachtet 4D das als DTD; sonst als Zugriffspfad.

Erfolgt keine Gültigkeitsprüfung (kein DTD, inkorrekte URL auf DTD, etc.), wird ein Fehler generiert. Die Systemvariable Error gibt die Fehlernummer an. Sie können diesen Fehler mit einer Methode auffinden, die der Befehl ON ERR CALL aufruft.

Die Funktion gibt einen String mit 16 Zeichen zurück (ElementRef), der die Referenz im Speicher der virtuellen Struktur des Dokuments enthält. Diese Referenz müssen Sie zusammen mit anderen XML Befehlen zum Parsen verwenden.

Wichtig: Benötigen Sie die Funktion nicht länger, denken Sie daran, den Befehl DOM CLOSE XML mit dieser Referenz aufzurufen, um den Speicher wieder freizumachen.

(1) XML Dokument auf Festplatte ohne Gültigkeitsprüfung öffnen:

   $xml_Struct_Ref:=DOM Parse XML source("C:\\import.xml")

(2) XML Dokument neben der Strukturdatei der Datenbank ohne Gültigkeitsprüfung öffnen:

   $xml_Struct_Ref:=DOM Parse XML source("import.xml")

(3) XML Dokument auf Festplatte und mit Gültigkeitsprüfung über eine DTD auf der Festplatte öffnen:

   $xml_Struct_Ref:=DOM Parse XML source("C:\\import.xml";True;"C:\\import_dtd.xml")

(4) XML Dokument in einer spezifischen URL ohne Gültigkeitsprüfung öffnen:

   $xml_Struct_Ref:=DOM Parse XML source("http://www.4D.com/xml/import.xml")

DOM CLOSE XML, DOM Parse XML variable.

Wurde die Funktion korrekt ausgeführt, wird die Systemvariable OK auf 1 gesetzt, sonst auf 0 (Null).

Anwendung des Befehls

XML hierarchische Listen

---