12: Key-Value List Editor

Overview

The process of creating a Key/Value List is very similar to setting up a Dynamic Image Object or a Dynamic Animation Object.

1. Navigate to Settings > Key-Value List Settings > Key-Value Lists.
2. Click NEW.
3. The Key-Value List Editor displays.
4. Fill out the name of the Key/Value List. Select a name that is easily identifiable, and perhaps descriptive (e.g. “Team Name List”, “Team Logo List”, “Player Animation List”).

Assign values to keys

Based on the type of graphics object to which the Key/Value List is assigned, you will either define text values for keys (for a text/data field) or file paths for keys (for an image or an animation). 

First, you can define how the incoming source value is parsed prior to determining the key’s value:

Lookup:

• Trim Key: Removes any leading or trailing white spaces from the incoming value.
• Ignore Case: Performs a case insensitive lookup.

Default value

• Use Key: Uses the incoming value if the list does not contain a match.
• If you have not selected Use Key, then you can define the default value:
  • If defining the default value for a text field, then type in the default text value.
  • If defining the default value for an image/animation, then use the Select dropdown to browse for a default image/animation file.

Add list entries

To add a key/value pair to the list, you can either enter the information manually by clicking the Add button, or you can Batch import a list if you are adding file paths.

After clicking the Add button you will be presented with a screen that allows you to enter the key and the value. If you are adding a file path, the value section allows you to browse to a file path. 

Batch add list entries

Clicking the Batch dropdown allows you to import a Key-Value List from a Directory or from a File. When batch importing from a directory, the system automatically uses the filenames in a given directory that match the pattern of filenames ending in ‘_[value].[extension]’.

• The file path m:\AndruwJones_25.mov results in the following key/value association:
• Key: 25
• Value: m:\AndruwJones_25.mov

When batch importing from a file, you can supply the system with a prebuilt key/value pair file in XML or CSV. The system automatically parses this list and adds key/value entries based on the information found in the selected file.

Assign a Key/Value List to a Canvas object

To assign a Key/Value List to a canvas object:

1. Open the Graphics Editor, and then right-click the object of choice. Make sure this object is either a Text/Data field, an Image, or an Animation.
2. From the right-click menu, select Key/Value List Options, and then select Browse to select a Key/Value List.
3. From this right-click menu, you can optionally create a new Key/Value List, edit the assigned Key/Value List, or delete the assignment of the Key/Value List.