View and edit database topics

You create a database topic on your map by running a query, and then choosing data to add to the map from the records listed as Results in the Databases task pane .

A database topic displays some topic text and beneath it, the data in the record as a list of topic properties.

If you have configured the connection to specify which fields to include in the topic text, and which fields to show as properties, these settings are used to display the topic data. Otherwise, the topics show the fields you have chosen to show in the Database task pane.

You can edit the topic text without affecting the data, but your changes will be lost if you refresh the topic.

The topic contains all the data in the record as its properties. By default only the properties you choose to display are shown, but you can choose to show all the properties.

Default topic text and visible properties

You can change which data fields in this table are displayed as topic text and basic properties: for the current topic only, for the entire map, or for every map created using this connection.

  1. Right click the topic's database topic icon .

  2. Click Configure Visible Fields.

  3. Specify the visible fields:

  1. Then:

  1. Click OK.

To show all the data fields for the current topic:

  1. Right click the topic's database topic icon .

  2. Click Show All Properties.

You may need to re-size the data area to see all the data.

Show, hide, and refresh data

Add related data

Relations between fields in tables are created in configuration view. If a topic has related data it will display a relation icon at bottom-right.

To add the related data to the map:

  1. Click the icon and then choose the table you want to use.

  2. The related data displays as a subtopic of the current topic. The first topic represents the Relation Query, and its subtopics represent the query results.

  3. To modify the number of results shown in the relation, right-click the Relation Query topic's database topic icon and click Edit Relation Query. You can specify the start record and the number of results to return. (The default number of results is set in the Databases Options.)

Edit data

Each database topic has a dynamic two-way link to the database. If you edit the topic data, changes are sent back to the database.

In order to edit the data, you must have permission to write to the database.

If you change data that is used as the default topic text, you need to refresh the topic.

Disconnect a topic from the database

If you have a database topic whose data you want to retain, you can disconnect it from the database to prevent the data from being updated on refresh, and display it as a static data topic. Or, you can convert it to a normal topic, with the data displayed as subtopics. In either case, the topic is no longer connected to the database.

To create a static data topic:

  1. Right click the topic's database topic icon .

  2. Click Disconnect from Data Source.

  3. The data is retained, and the topic becomes a static topic.

If you prefer, you can display the topic's data as subtopics:

  1. Right click the topic's database topic icon .

  2. Click Convert to Normal Topic.

  3. Each data field becomes a subtopic of the current topic.