Skip to main content

Data Dictionary File Sources in Eggplant Performance

A data dictionary consists of a list of one or more pairs of key=value entries as shown in the following example:

host=systest.sut.env
port=8080
proxyServer=192.168.45.34
proxyPort=80
verboseLogging=true

When multiple virtual users request the same key they all receive the same value. This can be useful for setting common data values for whole groups of virtual users. For example, a true/false flag for turning on/off a certain level of logging, or setting a common host value for URLs accessed by web virtual users.

Adding a Data Dictionary File Source to a Project​

There are several options for adding a data dictionary to a project:

Create a New Dictionary​

  1. Right-click the Data Sources folder in the Project tree and select New data source.

  2. Select Create new dictionary to create a new but empty data dictionary file source and click Next.

  3. Enter a Name for the new data dictionary and click OK. The new data dictionary file source is added to the Project tree under the Data sources folder.

Create a Dictionary from a Recording​

  1. Open the Recordings folder in the Project tree.

  2. Select a recording, then right-click the recording and select Create data source. You also can select a recording, then go to Recordings > Create data source.

  3. Select Create a new dictionary in the Create data source from recording window.

  4. Name the dictionary.

  5. Select the Keys to add to the dictionary from the key/value list, then click OK. The new data dictionary file source is added to the Project tree in the Data sources folder.

Import a Dictionary​

  1. Select Import dictionary and click Next to add an existing file to the Project.

  2. Navigate to the file you wish to import using the Import Dictionary dialog and click Open. The new data dictionary file source will be added to the Project tree under the Data folder.

Editing a Data Dictionary File Source​

To edit an existing data dictionary file source, right-click the Data Dictionary in the Project tree and select Edit. The data dictionary file opens in the configured external text editor. The data dictionary file source information is also displayed in the Data Source view, which shows a preview of the data. You can open the data dictionary file source with the external editor from this view. The data preview pane displayed in the Data Source view lets you edit without the need to invoke an external editor.

Deleting a Data Dictionary File Source​

To delete an existing Data Dictionary File Source, right-click the Data Dictionary in the Project tree and select Delete. Eggplant Performance asks you if you want to remove the corresponding data bindings from the tests. If you click Yes, the data bindings are removed from the test, the Data Dictionary is removed from the Project tree, and the underlying file is deleted from the disk.

Removing a Data Dictionary File Source from a Project​

To remove an existing Data Dictionary File Source from a project, right-click the Data Dictionary in the Project tree and select Remove from project. Eggplant Performance asks you if you want to remove the corresponding data bindings from the tests. If you click Yes, the data bindings are removed from the test, the Data Dictionary is removed from the Project tree, but the underlying file remains on the disk.

Last updated on