The DAM API consists of Frinje events, such as requests for data or responses to data requests. To use DAM, your Flex classes must dispatch the request events and listen for the associated responses. You indicate which events your classes can receive by using Frinje metadata annotations.

To use the Data Access Manager library, you must build your extension Flex classes as follows.

1

Create an annotated data model class in your plug-in module. The data model class must extend the DataObject base class.

The data model class describes the information that the mediator class of the extension must retrieve by using the DAM. The mediator references the data model class when dispatching data request events or receiving data response events.

To query for a single property of a given vSphere object, you do not need to create a data model class and can start from Step Step 2.

2

In the mediator class of your extension, create and dispatch one or more data request events.

Data request events include both a reference to the target vSphere object and a data model class as described in Step Step 1. Optionally, the data request can also include a data update specification that will cause the DAM to send notifications whenever the values of the requested properties change.

For data request events that retrieve a single property, you specify the property name by using a string value and do not need to include a data model class.

3

The DAM sends a data response event, which contains a DataObject with the values of the requested properties, as specified in the data model class in Step Step 1 . You must annotate a method in the mediator class of your extension to receive the data response event.

4

In your data response event handler method, update your extension's user interface elements using the data in the data response event.