Skip to main content

 

Documentation & User Guides | FotoWare

Configuring FotoStation to download quicklist content from a web server

When creating quicklists (regular "flat" ones or hierarchical ones) with predefined metadata for FotoStation's editors, it is possible to store these on a central web server and configure "proxy" quicklists files in the FotoStation configuration that tell the metadata editors to fetch new content live from a centrally maintained quicklist repository.

Creating the quicklist content

The Quicklists that contain the actual content that you will use in FotoStation can be created as described in the Creating predefined metadata topic. However, the naming conventions outlined there are not important, as it's the quicklist proxy files (see below) in the FotoStation configuration that need to be named correctly to map the metadata to the correct fields.

Having created quicklists with content, put them on a web share so that FotoStation can reach them. (See below).

How the proxy quicklists files work

The proxy quicklists follow the naming conventions of regular FotoStation quickllists: ql_<fieldnumber>.txt denotes a flat-structure quicklist, while <fieldnumber>.txt is used for thesaurus quicklists, with hierarchically arranged entries.

They are stored in the default location for quicklists; the actual location differs depending on the type of configuration that is used.

It is also possible to create proxy files that link fields together and populate different fields with metadata from different levels in the hierachical structure you've created.  Just make sure to include the connection string as described in the below paragraph to the first line of the file.

Setting the connection string in the proxy file

When creating a proxy quicklist file, it needs only contain a single line of information - the string that tells FotoStation where to fetch the quicklist content. This will be in the form of a web URL, prefixed with http://, or https:// for secure connections.

Example

This is an example of the content in the proxy file that fetches content in a flat structure for the Keywords field.

(Proxy file name: ql_025.txt)

#! HTTP_DOWNLOAD_URL=http://yourserver.com/quicklists/keywords.txt

If the keywords.txt file referenced above is a hierarchical structure of keywords (a thesaurus quicklist) you would simply name the proxy file 025.txt, omitting the ql_ prefix.

Content caching and updating

When a user opens the metadata editor FotoStation downloads the content from the referenced URL. To avoid unnecessary  downloads we recommend setting up caching on the web server.

FotoStation stores the downloaded content in the proxy file and updates it with new content when available. Thus, FotoStation will be able to use the locally cached quicklists even when it does not have a network connection to the server.