Using References

If a field in a data type is of the data reference type, you can choose how to present the referenced data in XML returned by Get<DataType>Xml - inline or nested - by setting this parameter:

• Show reference data inline [ShowReferencesInline] (Boolean)

The use of this parameter is only valid if you select a field of the data reference type in the Selected fields (PropertyNames) parameter.

When inline (true), the referenced field will be presented as an attribute within the data element (see the GalleryId.Name attribute)

<GalleryItem Id="20f59d12-c30a-420a-afec-ec23f107d009" Title="Jellyfish" GalleryId.Name="Images" xmlns=""/>
<GalleryItem Id="906ae622-ec7e-4f62-a77e-717e972acd3c" Title="Koala" GalleryId.Name="Images" xmlns=""/>
<GalleryItem Id="e34fcd17-4a4e-4ad9-bfa5-6234ffc29e58" Title="Penguins" GalleryId.Name="Images" xmlns=""/>

^{Listing 4: Inline referenced fields}

The inline reference is easy to use in XSLT while bloating the XML

When nested, the referenced field will be presented as an individual element (see the GalleryId element):

<GalleryItem Id="20f59d12-c30a-420a-afec-ec23f107d009" Title="Jellyfish" xmlns=""/>
<GalleryItem Id="906ae622-ec7e-4f62-a77e-717e972acd3c" Title="Koala" xmlns=""/>
<GalleryItem Id="e34fcd17-4a4e-4ad9-bfa5-6234ffc29e58" Title="Penguins" xmlns=""/>
<GalleryId Name="Images" xmlns=""/>

^{Listing 5: Nested referenced field}