Skip to main content
Documentation & User Guides | Fotoware

Reading or writing metadata with a database connection (ODBC)

How to configure Color Factory to read from an ODBC connection to update metadata, or read from metadata dn update an ODBC connection.

ODBC setup

In the Color Factory Settings app, expand the relevant channel and select Metadata

Open the ODBC tab.


This functionality makes it possible to extract text from a database and store it in the files processed in the channel or to store metadata from the files in the connected database.

This is done by setting up a data source and mapping database fields to XMP metadata fields:

  1. First, select Activate ODBC connection, then enter a Data Source Name (DSN) or choose one by selecting Browse (...).

Note: A System DSN must be configured on the server for this to function correctly; a User DSN will not work. Optionally enter a username and password required to access the DSN.

  1. Choose how Color Factory should interact with the database. You have three options:


  • Read from database, write to file - searches the database for a matching record, extracts content from it, and stores the information in the file processed in the channel.
  • Read from file, update to database - updates the matching record in the database with the content in the files processed in the channel.
  • Read from file, update and insert to database - updates existing records in the database with metadata from the files, and insert new records in the database if new files are processed that don't have an existing record in the database.
  1. Configure the mapping of column contents to metadata fields. Select Configure and choose a table from the DSN in the Select table drop-down list.


  1. Choose the metadata field to which the content should be mapped and the action that should be performed in this field. You can choose to replace any existing content in the chosen metadata field or to append the new data before or after any already existing text.
  2. Choose which metadata field you want to use as the primary key field. Color Factory will try to match the content of that metadata field to an existing record in the database. When a match has been found, the action specified for each field will be performed (replace or insert before/after).

If you choose File name in the Primary key field you can make Color Factory search for a part of the name, the full name, or the full name with extension. Choose Use part of name to specify the number of characters Color Factory should compare in the file name and the database column content.

  • Was this article helpful?