Funciones del sistema de CA Process Automation › convertValueToXml

convertValueToXml

La función convertValueToXml devuelve un fragmento de XML basado en una matriz de tipos simples o un ValueMap de tipos simples.

Cuando se utiliza un ValueMap, los elementos XML se crean mediante usando nombres de campo como etiquetas y valores de campo como contenido. Se puede especificar una cadena o nulo para el parámetro de etiqueta cuando se utiliza ValueMaps. Si se especifica una cadena, ésta se utiliza para crear un elemento raíz con la etiqueta especificada. Los elementos que se han creado a partir del ValueMap están contenidos dentro de ese elemento e raíz. Si se especifica nulo, los elementos se encuentran a nivel de raíz.

Cuando se utiliza una matriz, especifique una cadena para el parámetro de etiqueta. Esta cadena se hace para crear las etiquetas de elemento con los valores de matriz como elementos de contenido.

Sintaxis

sXML = convertValueToXml(arrayOrVmap, tag)

Argumentos

arrayOrVmap (String)

Especifica una matriz o un ValueMap.

tag (String)

Especifica la etiqueta obligatoria que se tiene que utilizar con una matriz o la etiqueta opcional que se tiene que utilizar con un ValueMap.

Valor de retorno

sXML (String)

El tipo de retorno es String.

Ejemplos

1. En este ejemplo, Process.array contiene los valores 1, 2 y 3.

   Process.xml = convertValueToXml(Process.array, "prueba")
   

   Process.xml contiene el siguiente fragmento de XML:

    <test>1<test><test>2<test><test>3<test>
   

2. En este ejemplo, Process.valuemap tiene dos campos con los nombres "field1" y "field2" y los valores "value1" y "value2".

   Process.xml = convertValueToXml(Process.valuemap, nulo)
   

   Process.xml contiene el siguiente fragmento de XML:

    <field1>value1</field1><field2>value2</field2>