<< Fare clic per visualizzazione il sommario >> Percorso: API di piattaforma > Altri servizi > Rest > XmlToDictionary |
Service
Method
XmlToDictionary
Description
Converts an Xml string in a Dataset.
Input |
|||
Name |
Description |
Type |
Optional |
xml |
A string containing data in Xml format. |
String |
|
fields |
A list containing the names of the first-level fields to return in dataset; a null or empty list implies that all fields are returned. |
List of string |
|
xmlFieldNames |
A list containing the names of fields (regardless of the level) that have to be mapped to the corresponding fields specified in the dictionaryFieldNames list; a null or empty list implies that the field names in the Xml structure will be used as keys in the returned dataset. |
List of string |
|
dictionaryFieldNames |
A list containing the names of fields (regardless of the level) that have to be mapped to the corresponding fields specified in the dictionaryFieldNames list; a null or empty list implies that the field names in the Xml structure will be used as keys in the returned dataset. |
List of string |
|
valuesIfNull |
A Key/Value pair collection containing values to assign to the specified fields if their returned value is null. Example: if valuesIfNull contains “first_name”, “” “trim_user”, false the returned Dataset will have any field named “first_name” (at any level) valued with “” instead of null and any field named “trim_user” (at any level) valued with false instead of null. |
Dataset |
|
Output |
|||
Name |
Description |
Type |
Optional |
returnValue |
A dataset. |
Dataset |
|
Remarks
The xmlFieldNames and dictionaryFieldNames lists must have the same number of elements.
As an example, if xmlFieldNames[0] = “?xml” and dictionaryFieldNames[0] = “xmlInfo” and xmlFieldNames[1] = “@pageid” and dictionaryFieldNames[1] = “pageid”, then the “?xml” field in the Xml structure will be returned as the “xmlInfo” field in the dataset and the “@pageid” field as the “pageid” field; fields not present in the xmlFieldNames list will retain their names in the returned dataset.