Extracción de una colección XML desde una cadena XML

Utilice la acción Extraer colección XML para extraer una fila o una colección de filas de una cadena XML o de una sección de una cadena XML. Cada fila en la recolección debe tener el mismo conjunto de propiedades predefinido.

Una recolección extraída de esta manera es equivalente en operación a una resultante de una Acción evento cargar recolección. Esto significa que:

  • Puede estar manipulada por una acción Actualizar recolección subsiguiente.
  • En cualquier acción relevante subsiguiente, se puede volver a convertir en una cadena XML usando la función XML().
  • En cualquier acción relevante subsiguiente, sus filas se pueden repetir usando la función ROWS() y las propiedades de cada fila se pueden referenciar usando las funciones P() o FP().

Esta acción evento proporciona una forma conveniente de trabajar con datos XML sin tener que analizar a través de etiquetas.

Para configurar la acción y sus parámetros:

  1. Crear una acción de evento con el tipo de acción Extraer colección XML.
  2. Cuando haga clic en Editar parámetros, se mostrará el formulario Acción de evento Extraer colección XML.

    Este formulario tiene estos botones, cada uno con un campo que le acompaña:

    Botón/Campo Notas/Comentarios
    Plantilla XML El botón abre el formulario Acción de evento Seleccionar plantilla XML, lo que le permite seleccionar y cargar la plantilla de XML que vaya a usar con los datos XML extraídos. Puede también escribir la plantilla XML en este campo manualmente o pegarla desde otra fuente.

    Una plantilla XML es un fragmento XML que tiene la misma estructura que una fila de datos individual en el XML del que se van a extraer los datos. Este fragmento XML puede, por tanto, servir como plantilla para esa fila de datos.

    El campo muestra la plantilla XML como una cadena única.

    XML El botón abre una instancia del Editor de expresiones acción evento.

    El XML al que se hace referencia aquí es la cadena XML de la que se van a extraer los datos.

    Cuando este tipo de acción evento es parte de un controlador de evento:

    • Con un evento BodOnReceive, una función que se usa habitualmente es BODXML(), que extrae datos del Documento de objeto de negocio (BOD) entrante.
    • También puede:
      • Utilizar la función FILECONTENTS() para leer en los contenidos de un archivo XML fijo.
      • Utilizar la función XML() para construir una cadena XML desde otra recolección.
      • Hacer referencia a una variable o un parámetro.
      • Escribir manualmente una cadena XML fija en un campo.
    Ruta El botón abre una instancia del formulario Acción evento Establecer extraer recolección XML que permite establecer la ruta de extracción del XML.

    Esta ruta es para uno o más nodos en la cadena XML bajo los que residen los datos de las filas que se van a extraer. Esto se expresa en la sintaxis del Lenguaje de rutas XML (XPath).

    Consulte Establecer una ruta de extracción para datos XML.

    Asignación de propiedad El botón abre una instancia del formulario Acción evento Establecer extraer recolección XML que permite crear uno o más conjuntos de pares de valores/nombres de propiedad que asignen los valores que se van a extraer de la cadena XML a propiedades en cada fila de la recolección resultante.

    La asignación de propiedad consta de una lista de pares separados por comas. Cada par, por turnos, consta de un nombre de propiedad y de una ruta separados por un signo de igual (=).

    • El nombre de propiedad dirige cómo se puede hacer referencia al valor extraído más tarde en cada fila de la recolección extraída.
    • La ruta describe la ubicación de los datos que se van a extraer de la propiedad nombrada, relativa a cada ubicación en la cadena XML identificada por el campo Ruta.
      Nota:  Esta ruta se expresa en sintaxis del Lenguaje de rutas XML (XPath).
    Asignación del conjunto de resultados El botón abre el formulario Acción evento Establecer id. de conjunto de resultados, que permite proporcionar un nombre al conjunto de registros que resultan de procesar esta acción evento.
  3. Establezca estos parámetros y haga clic en Aceptar para cerrar el formulario.