Skip to content

Field Dictionaries

Overview

Field Dictionaries translate data codes into human-readable values for use in Feature Information tooltips, Labels, and Free Text Search Results. From this page, you can create, import, and manage field dictionaries for use across your datasets.

📄 Note

Field Dictionaries support both strings and numbers, although strictly both are treated as strings.

Field Dictionaries page

To access field dictionaries:

  1. In Mapworks UI, click Mgt Console in the bottom left

Mgt Console button in Mapworks UI

  1. In the sidebar, click Field Dictionaries

Field Dictionaries tab in the side navigation

Creating Field Dictionaries

Field Dictionaries can be manually created or imported from a CSV file.

To create a field dictionary:

  1. Click the Create Field Dictionaries icon on the right

Create Field Dictionaries button

  1. Enter the dictionary values following the pattern (Code, Dictionary value)

Create Field Dictionary dialog

Alternatively, click Import Field Dictionaries to import the dictionary as a CSV file.

Import Field Dictionaries button

When importing field dictionaries by CSV, multiple dictionaries can be imported as a single file using the format pictured below:

Example CSV format for importing field dictionaries

Import Field Dictionaries dialog

Conditional Field Dictionaries

Multiple dictionaries can be assigned to a field, with the value of another field determining which dictionary is used in each case.

Conditional Field Dictionaries list

To create conditional field dictionaries:

  1. Create a basic field dictionary for each condition
  2. Select the dictionaries and click the Create Conditional Field Dictionaries button on the right to convert them to be used conditionally

Create Conditional Field Dictionaries button

  1. Enter a condition for each dictionary
  2. Click the Add button

Conditional field dictionary conversion dialog with condition inputs

  1. Check one of the boxes to decide what happens to the Basic Dictionaries after the conversion

    • Reference Basic Dictionaries — Creates duplicates of the original dictionaries
    • Delete Basic Dictionaries — Basic Dictionaries are not retained
  2. Assign all relevant conditional dictionaries to the dataset field

Dataset field showing assigned conditional dictionaries

Assigning Field Dictionaries

After creating a Field Dictionary, it must be assigned to the fields for which it is intended. This allows a single Field Dictionary to be reused across multiple fields or datasets.

To assign field dictionaries:

  1. Select the dataset in Mapworks UI
  2. Click Assign Dictionaries

Dataset field mapping button in Dataset Settings

  1. Click the magnifying glass next to a field

Assign Field dictionary dialog

  1. Search for and select a dictionary from the drop-down list

📄 Note

Conditional Dictionaries are located further down the list, after the Basic Dictionaries.

Inspect Field Dictionary dialog for a dataset field

  1. Click the Add button
  2. Click OK