Make Parameterized Phrase

This dialog is available for any wording within a report that can be customized, including:

  • The title of the report.
  • The title of any column.
  • The display of time and date information.

Parameter keywords begin with a % and are enclosed in square brackets as shown in the following example. All other text is passed through as written.

Standard parameters available to tag query parameterized phrases

When building a parameterized phrase, leave a space between each element unless you want words to run together. If building your own time format, it is up to you to include colons between hours, minutes, etc.

Tag Query Parameter Variables Include:

ShortName - The name of a tag, excluding all parents.

DataColumn - The function applied to the column.

Field - For any I/O tag (including legacy input / output tags) this is simply "Value".
           Field is most useful when displaying driver statistics or values from custom tags that store data other than value.

Units - Engineering units configured for the tag displayed in any column.

RelativeName - The name of a tag including parents to the selected Context or the top of the tag tree.

Description - The configured description of each tag.

Time Parameter Variables Include:

Time - Displayed as hh:mm tt, where tt represents AM/PM.

Date - Displayed as yyyy-MM-dd.

Hours12 - The current hour using a 12-hour clock.

Hours24 - The current hours using a 24-hour clock.

Minutes - Minutes within an hour.

Seconds - Seconds within a minute.

SubSeconds - Milliseconds within a second.

AMPM - AM or PM.

DayNum - The numeric day within a month.

MonthNum - The numeric month within a year.

Year - The four-digit representation of the year.

DayString - The name of the day of the week.

MonthString - The name of the month of the year.

Report Title Variables Include:

StartDate - Beginning date of the time span formatted as yyyy-MM-dd

StartTime - Beginning time of the time span formatted as hh:mm tt

EndDate - Date ending the included time span.

EndTime - Time ending the included time span.

RunDate - Date when the report was generated.

RunTime - Time when the report was generated.

WorkstationName - The identity of the workstation where the report was generated.

Custom Parameters

As described in Parameterized Reports, parameters that you create for your report can also be used in your parameterized phrases. This is especially useful for report titles and column headers.