xmlDocument (Variable type)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

Help / WLanguage / WLanguage functions / Standard functions / XML file functions

Declaring an xmlDocument variable
Properties specific to the xmlDocument variables
Using the indirection on the paths in an XML document
Functions that use xmlDocument variables

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

xmlDocument (Variable type)

In french: xmlDocument (Type de variable)

The xmlDocument type is used to handle an XML file. You can define and change the characteristics of this file using different WLanguage properties.

Note: For more details on the declaration of this type of variable and the use of WLanguage properties, see Declaring a variable.

Example

// Exemple utilisant le fichier XML suivant : piece_theatre.xml
// <?xml version="1.0"?>
// <PLAY>
// 	<TITLE>Titre de la piece</TITLE>
// 
// 	<PERSONAE>
// 		<PERSONA>Un personnage</PERSONA>
// 	</PERSONAE>
// 
// 	<ACT>
// 		<SCENE>
// 			<SPEAKER></SPEAKER>
// 			<LINE></LINE>
// 		</SCENE>
// 	</ACT>
// </PLAY>

// Déclaration d'une variable xmlDocument utilisant un modèle de document
RomeoEtJuliette is xmlDocument, description = "piece_theatre.xml"

// Chargement d'un document XML depuis un fichier
RomeoEtJuliette = XMLOpen("romeo_et_juliette.xml", fromFile)

// Affichage du numéro de version du XML
Trace(RomeoEtJuliette..Version)

// Affichage du titre de la pièce en accédant directement aux noeuds
Trace(RomeoEtJuliette.PLAY.TITLE)

Remarks

Declaring an xmlDocument variable

The xmlDocument variables can be declared by indicating a sample document (XML file) or a template document (XSD file). The structure of this document will be read by WINDEV, WEBDEV and WINDEV Mobile. Therefore, the automatic completion will be available for the names of nodes in the code editor.

To declare an xmlDocument variable with a sample document:

Add the XML document into the project via one of the following methods:
- on the "Project" tab, in the "Project" group, expand " List of elements" and click "List of project elements". The list of project elements is displayed. Click the "Add" button and select the XML document.
- drag the file and drop it in the "External descriptions" folder of the "Project explorer" pane.
- in the "Project explorer" pane, select the "External descriptions" folder, then:
  - "Import an XML or JSON into this project" in the context menu.
  - "Import an XSD into this project" in the context menu.
The XML document appears in the "External descriptions" folder of the project explorer. You have the ability to see its structure.
Declare the variable as follows:
<Variable name> is xmlDocument, description = <Document name>

<Document name> can correspond to the name of sample document (with or without extension) or to the name of template document (with or without extension).
Remarks:
- This declaration can be obtained automatically by "dropping" the name of the XML document directly from the "Project Explorer" pane.
- When using a sample document, you also have the ability to use the following syntax:
  <Variable name> is xmlDocument
  <Variable name> = XMLOpen(<Document name>)
You can directly access the variable nodes by their names. These names are automatically proposed by the automatic completion mechanism of the code editor.

Note: The XMLSave function is used to save the XML document. If an XSD file was used, it will be automatically taken into account.

Properties specific to the xmlDocument variables

The following properties can be used to define the characteristics of xmlDocument variables:

Name	Type used	Effect

Encoding	Character string	Encoding used for the character strings of the XML document. The UTF-8 encoding is used if this property is not specified or if it is set to "" (empty string). This is the case for example during a conversion into string with XMLBuildString.
RootNode	Array of xmlNode	Array of root nodes of the XML document. A valid XML document must have a single root node. However, several nodes can be found at the root when building the document.
Version	Character string	Version of the XML format. In most cases, this property is set to "1.0".

Using the indirection on the paths in an XML document

The indirection operators can be used to build the path of an element in an XML document.

Example:

sDocXML is string = [
	<?xml version="1.0" encoding="UTF-8"?>
	<Document>
	<InfoVersion>
	<Version>21</Version>
	<Millesime>2016</Millesime>
	</InfoVersion>
	</Document>
]

xmlExemple is xmlDocument = XMLOpen(sDocXML, fromString)

sParam is string = "WinDev_Param"

// Lecture directe d'une information ...
Trace(xmlExemple.Document.InfoVersion.Version) 

// Lecture avec une partie du chemin XML contenu dans une variable
// (idem si rubrique d'un fichier, paramètre d'une fenêtre, méthode, ...)
sParamètre is string = "InfoVersion"
Trace ({"xmlExemple.Document." + sParamètre + ".Version"})

Functions that use xmlDocument variables


XMLBuildString	Retrieves and formats the content of an XML document (created by XMLDocument and modified by the XML functions).
XMLOpen	Loads an XML document from a file, a URL or a string into an xmlDocument variable.
XMLSave	Saves an XML document in a file.
XMLValidDocument	Validates an XML document from an XSD schema.

Note: Browsing an XMLDocument variable variable must be performed using the FOR ALL syntax. XMLRead must not be used.