Text Formatting Variables

Some settings in Express Dictate are documented as accepting text formatting variables. For example, when sending dictations by email, you may want to automatically insert into the email subject the name of the dictation being sent.

Variables are specified by wrapping a variable name in percent (%) signs. e.g., The variable "%username%" is substituted with the name of the registered user.

Settings that accept text formatting variables can use any combination of text and / or variables. Any text not contained within percent signs is used as-is.

Dictator's details:

%userid% - Registered user ID. (e.g., "123456")
%username% - Registered user name. (e.g., "John Smith")
%usercompany% - Company, as set in Options -> User. (e.g., "Smith and Sons")

Dictation file details:

%filenumber% - Unique number that identifies each dictation for a given user. (e.g., "123")
%filename% - Display name. (e.g., "Dictation 123")
%filepriority% - Priority, as text. (e.g., "High")
%fileprioritypercent% - Priority, as a number, where higher is more important. (e.g., "50" for normal)

Date & time that a dictation was created:

%YYYY% - Year, as a four digit number. (e.g., "2010")
%MM% - Month, as a two digit number. (e.g., "03" for March)
%DD% - Day of the month, as a two digit number. (e.g., "27")
%HH% - Hour, as a two digit number in 24 hour time. (e.g., "16" for 4 PM)
%MIN% - Minutes, as a two digit number. (e.g., "09")
%SS% - Seconds, as a two digit number. (e.g., "48")

XML data (See Prompt for Data in Options -> Creation for information about adding XML elements to dictations):

e.g., %client% - Value of the XML element <client>. (e.g., "Jane Doe")

Percent signs other than those in variable names must be doubled - the second percent will be removed when the text is formatted (e.g., "100%%" would be substituted with "100%").
Multiple dictators can create dictations with the same "%filenumber%". For a dictation ID that is unique when working with multiple dictators, use "%userid%-%filenumber%".
If a specified XML tag is not found, it will be substituted with "[unknown]".

Format string: "%filepriority% priority dictation for %client%"
Result: "Medium priority dictation for Jane Doe"

Format string: "%YYYY%%MM%%DD%-%HH%%MIN% %userid%-%filenumber% %username%"
Result: "20100327-0948 123456-123 John Smith"