Key-Value List Editor
The process of creating a Key/Value List is very similar to setting up a Dynamic Image Object or a Dynamic Animation Object.
- Navigate to Settings Menu -> Key-Value List Settings -> Key-Value Lists.
- Click NEW.
- The Key-Value List Editor displays.
- Fill out the name of the Key/Value List. Make sure to select a name that is easily identifiable, and perhaps descriptive (e.g. βTeam Name Listβ, βTeam Logo Listβ, βPlayer Animation Listβ).
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.
- 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.
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.Β
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.
To assign a Key/Value List to a canvas object:
- 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.
- From the right-click menu, select Key/Value List Options, and then select Browse to select a Key/Value List.
- 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.
NOTE
Deleting the Key/Value List assignment does not delete the Key/Value List from the system.