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.