Skip to main content
Documentation & User Guides | FotoWare

Reference to QuickList naming conventions

This article is a complete reference of how FotoStation QuickLists can be named, and how the naming affect the function of the QuickList.

Flat structure QuickLists

Flat structure QuickLists are simple text files that should be named ql_<field number>

A typical flat QuickList for the default Keywords field (#025) should be called ql_025.txt and have content of this format:

Keyword 1
Keyword 2
Keyword 3

Hierarchical structure QuickLists (Thesaurus/Taxonomy)

These QuickLists are text files that should be named according to the field number they should be mapped to, e.g. 025.txt for the Keywords field. It is possible to have both a flat QuickList and a hierarchical one tied to the same field.

The content of a hierarchical list can look like this:

Sports
    Football
    Rugby
    Tennis
Activity
    Hiking
    Swimming
    Running

Each level in the list can have sub levels by adding tab indentations to the file as seen in the example above. By naming this file 025.txt, it will be tied to the Keywords field, and when adding metadata to a file, the user can choose whether just the selected item should be added to the file, or if all parent nodes should also be added.

 

Linked field QuickLists

By employing certain naming conventions for the quick list, it is possible to distribute the different levels of tags in a hierarchical list to several fields.

Let's use this content as an example:

SPO=Sports
    Football
    Rugby
    Tennis
LEI=Leisure Activity
    Hiking
    Swimming
    Running

By naming this file 015_020.txt, we're saying that the first level of tags should be stored in field #015 (Category), while any sub-level marked by a tab indentation in the file should be stored in field #020 (Supplemental Category). The underscore, thus, signifies a tab indentation.

In the above example, we've also added aliases to the SPO and LEI tags. Aliases are the labels that the user will see in the metadata editor, while the preceding tag is what's actually added to the field (#015 - Category in this case).

Lessons learned so far

  • Hierarchical QuickLists can be made using tab indentations
  • The naming of the file dictates how the QuickList content is mapped to metadata fields
  • An underscore in the filename (_) denotes a tab indentation in the tag structure
  • Aliases (tag=<value>) can be used to make otherwise cryptic tags human readable when adding tags in the metadata editor.

 

Sample file with all possible naming conventions explained

To test this file in your configuration, copy and paste the content and store it in a plain text file named 200_201_202_203-204-205-206(207).txt in the QuickLists folder.
To locate the folder, open the FotoStation metadata editor and choose File - Manage QuickLists...


# This is a sample linked list configuration file. It automatically
# fills in 'custom fields' 1 - 8 (fields #200 - #207) Remove the
# 'sample' prefix from the file name to see how it works
#
# The filename defines how the data on each level in the hierarchy is
# mapped to metadata fields.  E.g the text on the first level (aaa) is
# mapped to the first number in the file name (field #200), the text on
# the second level (bbb) is mapped to the second number in the file
# name (field #201), etc...  Note the difference between underscore
# '_', dash '-' and numbers enclosed in parenthesis '( )'
#
# Underscore         -      New level in the hierarchy
# Dash             -    Semi-colon separated text on the same level
# Number in parenthesis    -    Map the alias (after =) to this field
#
# In the example below, 'aaa' has an alias, 'Alias for aaa' which will
# be visible in the list. However, 'aaa' goes into field #200. If
# you rename the file to '200(209)_201.....', 'Alias for aaa' will
# also be copied into field #209.
#
# The expression in the leaf node shows how multiple 'hidden' texts
# are mapped to multiple fields.  'hhh' is the 'alias' that is
# visible in the tree and is also mapped to field #207.  If 'hhh'
# should not be copied to field #207, rename the file to:
# '200_201_202_203-204-205-206.txt'
#
#200    201     202     203 204 205 206(207)
# |      |       |       |   |   |   |   |
# |      |       |       |   |   |   |   |
aaa=Alias for aaa
        bbb
                ccc
                        ddd;eee;fff;ggg=hhh 

Naming quicklists for struct members in a bag of struct

Using the Metadata Configuration tool you can create fields of the type Bag of Struct. These are multi-entry fields that contain several struct members, which you create inside the parent field. One example of such a field is Location Created (#390) which is included in the default FotoStation configuration. As you can see from the screenshot below, there are six struct members in the Location Created field:

To create quicklists for these child fields (which themselves have no field id), the quicklist files should be named ql_<fieldnumber>_<struct member number>.txt

So, to create a quicklist for City, the second struct member of field 390 above, the quicklist file should be named ql_390_2.txt