MERGEPROPERTIES

Essa função combina duas ou mais definições de propriedade XML em uma só e a exibe como uma string.

É possível usar o caractere asterisco (*) no início ou no final de uma string como um curinga. Por exemplo, para retornar determinadas chaves ou propriedades. Os asteriscos de uma string não agem como curingas. A pesquisa de curinga retorna apenas a primeira chave ou propriedade combinadas.

Nota

Nós não podemos garantir a ordem em que as chaves ou propriedades são correspondidas.

Sintaxe

=MERGEPROPERTIES(XMLProperty1,XMLProperty2....,XMLPropertyN)

Exemplos

Nestes exemplos, considere que há definições de propriedade XML nas células B5 e B7 e que há variáveis globais chamadas Var1 e Var2, sendo que cada uma delas contém definições de propriedade XML.

=MERGEPROPERTIES(B5,B7)

=MERGEPROPERTIES(globalvariables.Var1.text,globalvariables,Var2.text)

=MERGEPROPERTIES(globalvariables.Va1.text,B7)

As propriedades são mescladas na definição XML. Se duas ou mais definições contiverem o mesmo nome de propriedade, a definição adicionada mais recentemente substituirá a definição anterior. Por exemplo:

A segunda definição de propriedade:

<Table><Row name="Key1"><Property name="p1" value="v21"/>
<Property name="p22" value="v22" /></Row></Table>

mescla na primeira definição de propriedade:

<Table><Row name="Key1"><Property name="p1" value="v1"/>
<Property name="p2" value="v2" /></Row></Table>

A primeira e a segunda definições de propriedade contêm, cada uma, Property name=p1. A segunda definição de propriedade substitui a primeira, resultando nesta definição mesclada:

<Table><Row name="k1"><Property name="p1" value="v21"/>
<Property name="p2" value="v2" /><Property name="p22" value="v22" /></Row></Table>