AYUDA EN LÍNEA
 WINDEVWEBDEV Y WINDEV MOBILE

Este contenido se ha traducido automáticamente.  Haga clic aquí  para ver la versión en inglés.
Ayuda / WLanguage / Funciones WLanguage / Funciones estándar / Funciones de archivos XML
  • Declarando un xmlDocument Variable
  • Propiedades específicas de las variables xmlDocument
  • Usando la indirección en los caminos en un Document XML
  • Funciones que utilizan variables xmlDocument
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReportes y ConsultasCódigo de Usuario (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Código Navegador
WINDEV Mobile
AndroidWidget Android iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Otros
Procedimientos almacenados
El tipo xmlDocument se utiliza para manipular un archivo XML. Las características del archivo se pueden definir y cambiar mediante diferentes propiedades WLanguage.
Observación: Para obtener más información sobre la declaración de este tipo de variable y el uso de propiedades WLanguage, consulte Declarar una variable.
Ejemplo
// Example that uses the following XML file: play.xml
// <?xml version="1.0"?>
// <PLAY>
// <TITLE>Title of the play</TITLE>
//
// <PERSONAE>
// <PERSONA>A character</PERSONA>
// </PERSONAE>
//
// <ACT>
// <SCENE>
// <SPEAKER></SPEAKER>
// <LINE></LINE>
// </SCENE>
// </ACT>
// </PLAY>
 
// Declare an xmlDocument variable that is using a document template
RomeoAndJuliet is xmlDocument, description = "play.xml"
 
// Load an XML document from a file
RomeoAndJuliet = XMLOpen("romeo_and_juliet.xml", fromFile)
 
// Display the version number of the XML
Trace(RomeoAndJuliet..Version)
 
// Display the title of the play by accessing the nodes directly
Trace(RomeoAndJuliet.PLAY.TITLE)
Observaciones

Declarando un xmlDocument Variable

Las variables de tipo xmlDocument se pueden declarar indicando un documento de ejemplo (archivo XML) o un documento modelo (archivo XSD). La estructura del documento será leída por WINDEV, WEBDEV y WINDEV Mobile. Así, el autocompletado estará disponible para los nombres de los nodos en el editor de código.
Declarar un xmlDocument Variable con una muestra de Document:
  1. Añade el XML Document al proyecto a través de uno de los siguientes métodos:
    • en la pestaña "Proyecto", en el grupo "Proyecto", despliegue " Lista de elementos" y haga clic en "Lista de elementos del proyecto". La lista de elementos del proyecto aparece en pantalla. Pulse el botón "Añadir" y seleccione el XML Document.
    • arrastre y suelte el archivo en la carpeta "Descripciones externas" del panel "Explorador de proyectos".
    • En el panel "Explorador de proyectos", seleccione la carpeta "Descripciones externas" y, a continuación:
      • "Importar un XML o JSON en este proyecto" en el menú contextual.
      • "Importar un XSD a este proyecto" en el menú contextual.
  2. El XML Document aparece en la carpeta "Descripciones externas" del explorador del proyecto. Se puede ver su estructura.
  3. Declare la variable de la siguiente manera:
    <Variable name> is xmlDocument, description =  <Document name>

    <Nombre del documento> puede corresponder al nombre del documento muestra (con o sin extension) o al nombre del documento modelo (con o sin extension).
    Observaciones:
    • Esta declaración puede obtenerse automáticamente "soltando" el nombre del XML Document directamente desde el panel "Project Explorer".
    • Cuando se utiliza una muestra de Document, también se puede utilizar la siguiente sintaxis:
      <Variable name> is xmlDocument
      <Variable name> = XMLOpen(<Document name>)
  4. Ahora puede acceder directamente a los nodos de la variable por sus nombres. El mecanismo de autocompletado del editor de código propone estos nombres automáticamente.
Observación: XMLSave se utiliza para guardar el XML Document. Si se ha utilizado un archivo XSD, se tendrá en cuenta automáticamente.

Propiedades específicas de las variables xmlDocument

Las siguientes propiedades pueden ser usadas para manipular un xmlDocument Variable LE:
denominarTipo utilizadoEfecto
CodificaciónCadena de caracteresLa codificación utilizada para las cadenas de caracteres del XML Document. La codificación UTF-8 se utiliza si no se especifica este Property o si es set a "" (cadena vacía). Este es el caso, por ejemplo, durante una conversión en cadena con XMLBuildString.
RootNodeArray de xmlNodeArray de los nodos raíz del XML Document.
Un Document XML válido debe tener un único nodo raíz. Sin embargo, se pueden encontrar varios nodos en la raíz cuando se construye la Document.
varianteCadena de caracteresVersión del formato XML. En la mayoría de los casos, este Property es set a "1.0".

Usando la indirección en los caminos en un Document XML

Los operadores indirectos pueden ser utilizados para construir el ruta de un elemento en un Document XML.
Ejemplo:
sXMLDoc is string = [
<?xml version="1.0" encoding="UTF-8"?>
<Document>
<VersionInfo>
<Version>21</Version>
<Year>2016</Year>
</VersionInfo>
</Document>
]

xmlExample is xmlDocument = XMLOpen(sXMLDoc, fromString)

sParam is string = "WINDEV_Param"

// Direct reading of information ...
Trace(xmlExample.Document.VersionInfo.Version)

// Reading with part of XML path found in a variable
// (idem if file item, window parameter, method, ...)
sParameter is string = "VersionInfo"
Trace ({"xmlExample.Document." + sParameter + ".Version"})

Funciones que utilizan variables xmlDocument

XMLBuildStringRecupera y da formato al contenido de un documento XML (creado por xmlDocument y modificado por las funciones XML).
XMLOpenCarga un documento XML desde un archivo, una URL o una cadena en una xmlDocument Variable.
XMLSaveGuarda un XML Document en un archivo.
XMLValidDocumentValida una Document XML de un esquema XSD.
Nota: Una variable XMLDocument debe recorrerse utilizando la sintaxis FOR EACH. No se debe utilizar XMLRead.
Versión mínima requerida
  • Versión 15
Esta página también está disponible para…
Comentarios
Haga clic en [Agregar] para publicar un comentario

Última modificación: 27/01/2023

Señalar un error o enviar una sugerencia | Ayuda local