Descriptor Location
Descriptors may be defined within an OGLML document, stored in an external file, or retrieved directly from a device.
Inline Widget Descriptors
Descriptors are defined within the <meta> block of an OGLML document. Descriptors may not be nested within other widget descriptors. All widget descriptors must be placed within a <widgets> block within the <meta> block.
External Widget Descriptor Files
The widget descriptor may be stored in an external file. External widget descriptor files have the extension .widgetdescriptor.
DashBoard searches for widget descriptors in the following locations:
· Within a widgets subfolder within the folder containing the OGLML document.
· Within the widgets folder inside the DashBoard installation directory.
· A file specified by use of the baseurl attribute of a widgetdescriptor tag.
Device-served Widget Descriptors
A device may specify a URL to retrieve widgets using reserved OID 0xFF14. This mechanism will retrieve a single file from the specified URL. This is the recommended approach for openGear device developers.