Specifying Mapped Objects

This section describes the steps for mapping objects.

The objects that you want to map should already be created when you perform the mapping procedure. For example, if you are linking a Data Query object to an image file, both objects should reside on the custom page. If you are linking to a variable, the variable should already be created.

De-select all objects on the custom page. Click the Data Map button on the Properties pane. The Data Map dialog box appears.

Data Mapping Example

Suppose you want to create a mapped data query that displays an employee's dependents when a user of the query selects an employee. You would start by creating two queries, query1 which has the employee data, and query2, which has the dependent data. When the two queries have been created, you can map them.

Click the select button for Data Source. Both query1 and query2 should be available for selecting.

Select query1 as the data source. Any elements from the query (in this case, fields) appear in the left pane ("query1") and are available to be selected. Select the Company field and click the > button to send the element to the custom page data source list. Do the same for the Employee field.

Select query2 as the data source. Select Company and map it with Company in the custom page data source. Do the same for Employee.

Make sure Trigger Refresh is turned on for query2 for the Company and Employee keys.

At runtime, when a user selects an employee record in query1, query2 will refresh with the employee's dependent records.