Default placeholders

You can use default placeholders to customize the systemwide placeholders such as properties, date, and time of any script template.

system placeholder

Usage: Use to customize any script template.

Syntax: %system:argument%

Description: Uses a Java system property as the argument.

Arguments for the system placeholder:

java.version -- Returns the Java Runtime Environment version.
java.vendor -- Returns the Java Runtime Environment vendor.
java.vendor.url -- Returns the Java vendor URL.
java.home -- Returns the Java installation directory.
java.vm.specification.version -- Returns the Java Virtual Machine specification version.
java.vm.specification.vendor -- Returns the Java Virtual Machine specification vendor.
java.vm.specification.name -- Returns the Java Virtual Machine specification name.
java.vm.version -- Returns the Java Virtual Machine implementation version.
java.vm.vendor -- Returns the Java Virtual Machine implementation vendor.
java.vm.name -- Returns the Java Virtual Machine implementation name.
java.specification.version -- Returns the Java Runtime Environment specification version.
java.specification.vendor -- Returns the Java Runtime Environment specification vendor.
java.specification.name -- Returns the Java Runtime Environment specification name.
java.class.version -- Returns the Java class format version number.
java.class.path -- Returns the Java class path.
java.ext.dirs -- Returns the Path of extension directory or directories.
os.name -- Returns the operating system name.
os.arch -- Returns the operating system architecture.
os.version -- Returns the operating system version.
file.separator -- Returns the File separator ("/" on UNIX®), ("\\" on Windows®).
path.separator -- Returns the Path separator (":" on UNIX®), (";" on Windows®).
line.separator -- Returns the Line separator ("\n" on UNIX®), ("\r/n" on Windows®).
user.name -- Returns the User's account name.
user.home -- Returns the User's home directory.
user.dir -- Returns the User's current working directory.

Examples:

%system:java.version% -- Returns the Java Runtime Environment version.
%system:java.vendor% -- Returns the Java Runtime Environment vendor.
%system:java.vendor.url% -- Returns the Java vendor URL.

date placeholder

Description: Returns the current date in the format specified and uses the following arguments with appropriate separators.

Syntax: %date: argument%

Comment: This placeholder follows the java.text.SimpleDateFormat format specification.

Arguments for the date placeholder:

yyyy -- Returns the year (4 digits).
yy -- Returns the year (2 digits).
MMM -- Returns the month (short name).
MM -- Returns the month (2 digits).
M -- Returns the month ( 1 or 2 digits).
EEEE -- Returns the day of week.
EE -- Returns the day of week short form.
dd -- Returns the day of month (2 digits).
d -- Returns the day of month (1 or 2 digits).
hh -- Returns the hour 1-12 (2 digits).
HH -- Returns the hour 0-23 (2 digits).
H -- Returns the hour 0-23 (1 or 2 digits).
KK -- Returns the hour 0-11 (2 digits).
K -- Returns the hour 0-11 (1 or 2 digits).
kk -- Returns the hour 1-24 (2 digits).
k -- Returns the hour 1-24 (1 or 2 digits).
mm -- Returns the minute.
ss -- Returns the second.
SSS -- Returns the millisecond.
a -- Returns the AM or PM.
zzzz -- Returns the time zone.
zz -- Returns the time zone (short form).
F -- Returns the day of week in month (that is, 3rd Thursday).
DDD -- Returns the day in year (3 digits).
D -- Returns the day in year (1, 2, or 3 digits).
ww -- Returns the week in year.
G -- Returns the era (BC or AD).
' -- Allows text within single quotes to appear in a script rather than interpreting the text as a command. (For example: 'dog' prevents dog from being processed).
'' -- Allows a single-quote character to appear in a script rather than interpreting the character as a command.

Examples:

Example of data placeholder Result
%date:yyyy.MM.dd G 'at' hh:mm:ss z% 2005.07.10 AD at 15:08:56 PDT
%date:EEE, MMM d, ' ' yy% Wed, July 10, '05
%date:h:mm a% 12:08 PM
%date:hh 'o"clock' a, zzzz% 12 o'clock PM, Pacific Daylight Time
%date:K:mm a, zz% 3:26 PM, PST
%date:yyyy.MMMMM.dd GGG hh:mm aaa% 2005.July.10 AD 12:08 PM

time placeholder

Description: Returns the current date in the format that you specify and uses the following arguments with appropriate separators. This placeholder extends the date placeholder. You can use the same date placeholder arguments, with the additional argument for milliseconds since 1970/01/01 00:00:00.000 GMT.

Syntax: %time: argument%

Comment: This placeholder follows the java.text.SimpleDateFormat format specification.

Additional argument for the time placeholder:

SSSS -- Returns milliseconds since 1970/01/01 00:00:00.000 GMT.

Example: %time:SSSS% -- Returns milliseconds since 1970/01/01.

env placeholder

Description: Uses an environment variable specified as the argument. Any number of environment variables are available on a system. These values are system dependent.

Syntax: %env: argument%

Arguments for the env placeholder:

PATH -- Returns the executables path.
TMPDIR -- Returns the temporary directory.
HOME -- Returns the users home directory.

Example: %env:PATH%

option placeholder

Description: Returns the value of a specified Rational® Functional Tester customizable option for script execution.

Syntax: %option: argument%

Note: For information about the available option arguments, see Modifying Options for Script Execution topic.

Examples:

%option:rt.project% -- Replaced by the Test Manager project name.

%option:rt.time.delay_before_gui_action% -- Replaced by the time delay before any user interface action is performed.

%option:rt.time.delay_before_mouse_down% -- Replaced by the time delay and inserted before a mouse down event is delivered.

static placeholder

Description: Invokes the specified parameterless static method. The static methods depend on the classes available in the user's Java environment.

Syntax: %static: method% where method is any visible complete Java static method specification.

An argument for the static placeholder includes:

java.lang.System.currentTimeMillis -- Returns the time since 1/1/1970.

Examples:

%static:java.lang.System.currentTimeMillis% -- Returns the time in milliseconds since 1/1/1970.

%static:com.rational.test.ft.script.ScriptUtilities.getOperatingSystemVersion -- Returns host-specific operating system version information.