Funções do sistema do CA Process Automation › convertValueToXml

convertValueToXml

A função convertValueToXml retorna um fragmento XML com base em uma série de tipos simples ou em um mapa de valores de tipos simples.

Quando um mapa de valores é usado, os elementos XML são criados usando os nomes de campo como tags e os valores de campo como o conteúdo. Você pode especificar uma sequência de caracteres ou um valor nulo para o parâmetro de tag ao usar mapas de valores. Se você especificar uma sequência de caracteres, a sequência de caracteres é usada para criar um elemento raiz com o nome especificado. Os elementos criados no mapa de valores estão contidos nesse elemento raiz. Se você especificar o valor nulo, os elementos estarão no nível raiz.

Ao usar uma matriz, especifique uma sequência de caracteres para o parâmetro de tag. Ela é usada para criar as tags de elemento com os valores de matriz como o conteúdo do elemento.

Sintaxe

sXML = convertValueToXml(arrayOrVmap, tag)

Argumentos

arrayOrVmap (Sequência de caracteres)

Especifica uma matriz ou um mapa de valores.

tag (sequência de caracteres)

Especifica a tag obrigatória a ser usada com uma matriz ou a tag opcional a ser usada com um mapa de valores.

Valor de retorno

sXML (sequência de caracteres)

O tipo de retorno é Sequência de caracteres.

Exemplos

1. Nesse exemplo, Process.array contém valores 1, 2 e 3.

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

   Process.xml contém o fragmento XML a seguir:

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

2. Neste exemplo, o Process.valuemap tem dois campos com os nomes "field1" e "field2" e valores ''value1' e 'value2'.

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

   Process.xml contém o fragmento XML a seguir:

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