Meta-strings is the general term we use to refer to combinations of characters that are replaced by other combinations of characters when the time comes to use them. Temprecord uses meta-strings to add considerable power and flexibility to the tasks you can perform. Meta-strings can be used to generate file and folder names, email subject lines and message text, user data programmed into the logger, and printed report headers and footers.
|
Not all meta-string identifiers are recognized in all situations. Where a meta-string makes no sense, it isn't expanded and will be shown in the "reverted" state (i.e. bracketed with the percent (%) signs). |
An example will make it clearer.
A meta-string that is recognized in all situations is %User%. When the item containing the meta-string (being one of user data, print header/footer, email item, or file/ folder name) is used, the %User% is replaced by the name of the logged-in Windows user.
So, a print footer specified as Printed by user %User% would appear in the printed footer as Printed by user JoeSmith or whoever the logged-in user might have been at the time.
The meta-strings shown in the table below are available everywhere it is possible to use them, i.e. in file and folder specifications, in the subject and body fields of an email message, in printed report headers and footers, and in the user data fields of the parameters dialog and the default options:
Meta-string |
Use |
Example |
Output |
%Version% |
TRW software version |
"Printed with v%Version%" |
Printed with v6.2.tr |
%Build% |
TRW software build |
"Saved with build %Build%" |
Printed with build 2533.tr |
%User% |
logged in Windows user |
"Printed by user %User%" |
Printed by user Fred.tr |
%Computer% |
computer name |
"Printed from PC %Computer%" |
Printed from PC Fred's Workstation.tr |
%Workgroup% |
computer workgroup |
"This file is from the %Workgroup% group" |
This file is from the Administration group.tr |
%Company% |
organization name |
%Company% |
My Company Ltd. |
%Date% |
Inserts the date in the users short date format |
"Reception %Date%" |
Reception 23-8-2012 |
%Time% |
Inserts the current time in the user's long time format |
"Saved at %time%" |
Saved at 15_09_26.tr |
%DateTime% |
Inserts the date and time in the users short date and long time format |
"Saved %DateTime%" |
Saved 23-8-2012 15_09_26.tr |
%Units% |
Inserts a single character indicating the temperature display units |
"Upper temperature limit= %TUpper% %Units%" |
"Upper temperature limit= 12.50 C" |
%%<env var>%% |
environment variable |
"%%TEMP%%" |
C:\DOCUME~1\jrm\LOCALS~1\Temp\ |
The following meta-strings are expanded into various parameters and statistics from the logger data set:
Meta-string |
Use |
Example |
Output |
%Samples% |
number of samples in logger |
Logger %SN% (%Samples% samples) |
Logger S1234567 (1778 samples) |
%Markers% |
number of markers in logger |
Logger %SN% (%Markers% markers) |
Logger S1234567 (17 markers) |
%AllSamples% |
number of samples taken this trip (includes those lost to overwriting) |
%AllSamples% taken this trip |
9199 taken this trip |
%TotalSamples% |
total samples the logger has taken in its lifetime |
%SN% Total Samples=%TotalSamples% |
S1234567 Total Samples=100145 |
%Full% |
indicates if the logger is full |
%SN% Full=%Full% |
S1234567 Full=Y |
%Overwriting% |
indicates if the logger has overwritten samples |
%SN% OVR=%Overwriting% |
S1234567 OVR=N |
%SamplePeriod% |
sample period |
Samples were %SamplePeriod% apart |
Samples were 0:02:30 apart |
%StartDelay% |
start delay |
Logger start delay was %StartDelay% |
Logger start delay was 0:01:00 |
%StartSample% |
start sample (F7 key) |
Statistics are for samples %StartSample% to %EndSample% |
Statistics are for samples 100 to 199 |
%EndSample% |
end sample (F8 key) |
Statistics are for samples %StartSample% to %EndSample% |
Statistics are for samples 100 to 199 |
%StartDate% |
date of start sample |
Statistics are for samples between %StartDate% and %EndDate% |
Statistics are for samples between 12-11-2013 10:00:14 and 13-11-2013 02:10:44 |
%EndDate% |
date of end sample |
Statistics are for samples between %StartDate% and %EndDate% |
Statistics are for samples between 12-11-2013 10:00:14 and 13-11-2013 02:10:44 |
%FirstDate% |
date of first sample |
Logger first sample taken was at %FirstDate% |
Logger first sample taken was at 12-11-2013 08:00:14 |
%LastDate% |
date of last sample |
Logger last sample taken was at %LastDate% |
Logger last sample taken was at 13-11-2013 02:10:44 |
%User1%.. |
Lines 1..5 of user data. |
%User1%, %User2% |
Contents: Frozen Lamb, Origin: Auckland Coolstore |
%UserData% |
All lines of user data (only valid inside the body of an email - %UserData% is not recognized inside the subject line of an email) |
User Data: %UserData% |
User Data: Contents: Frozen Lamb Origin: Auckland Coolstore Destination: Christchurch Container: SKK2311 |
%NPS% |
name of any programmed Named Parameter Set |
Parameters: %NPS% |
Parameters: Conditioned blood products |
%Filepath% |
The path portion of the data file associated with the dataset |
Path: %Filepath% |
Path: C:\My Datafiles\ |
%Filename% |
The filename portion (i.e. with no path and no extension) of the data file associated with the dataset |
Name: %Filename% |
Name: Freezer No 7 |
%FileID% |
The file ID portion (i.e. with no path but including the extension) of the data file associated with the dataset |
Name: %FileID% |
Name: Freezer No 7.trx |
%SN% |
logger serial number |
Logger %SN% |
Logger s1234567 |
%Owner% |
programmed owner name |
Return logger to %Owner% |
Return logger to Waikato |
%Firmware% |
version number of logger firmware. |
%Firmware% |
4.1.6.12 |
%TMean% |
mean value of temperature samples between start and end samples |
Mean temperature between %StartDate% and %EndDate% was %TMean% |
Mean temperature between 12-11-2013 10:00:14 and 13-11-2013 02:10:44 was -18.311 |
%TMax% |
maximum temperature between start and end |
Maximum temperature between %StartDate% and %EndDate% was %TMax% |
Maximum temperature between 12-11-2013 10:00:14 and 13-11-2013 02:10:44 was -17.580 |
%TMin% |
minimum temperature between start and end |
Minimum temperature between %StartDate% and %EndDate% was %TMin% |
Minimum temperature between 12-11-2013 10:00:14 and 13-11-2013 02:10:44 was -18.950 |
%TMaxSample% |
sample number of maximum temperature |
Maximum temperature (%TMax%) occurred sample %TMaxSample% at %TMaxDate% |
Maximum temperature (-17.580) occurred sample 3312 at 12-11-2013 23:38:14 |
%TMinSample% |
sample number of minimum temperature |
Minimum temperature (%TMin%) occurred sample %TMinSample% at %TMinDate% |
Minimum temperature (-18.950) occurred sample 3465 at 13-11-2013 02:57 |
%TMaxDate% |
date-time of maximum temperature |
Maximum temperature (%TMax%) occurred sample %TMaxSample% at %TMaxDate% |
Maximum temperature (-17.580) occurred sample 3312 at 12-11-2013 23:38:14 |
%TMinDate% |
date-time of minimum temperature |
Minimum temperature (%TMin%) occurred sample %TMinSample% at %TMinDate% |
Minimum temperature (-18.950) occurred sample 3465 at 13-11-2013 02:57 |
%TUpper% |
temperature upper limit |
%SN% Upper temperature limit is %TUpper% |
S1234567 Upper temperature limit is 35.00 |
%TLower% |
temperature lower limit |
%SN% Lower temperature limit is %TLower% |
S1234567 Lower temperature limit is 10.00 |
%TAbove% |
indicates if upper limit has been exceeded |
%SN% Temperature Above=%TAbove% |
S1234567 Temperature Above=Y |
%TBelow% |
indicates if lower limit has been exceeded |
%SN% Temperature Below=%TBelow% |
S1234567 Temperature Below=Y |
%MKT% |
mean kinetic temperature between start and end samples |
Mean kinetic temperature between samples %StartSample%-%EndSample% was %MKT% |
Mean kinetic temperature between samples 100-199 was -18.905 |
%HMean% |
mean value of humidity samples between start and end samples |
Mean humidity between %StartDate% and %EndDate% was %TMean% %RH |
Mean humidity between 12-11-2013 10:00:14 and 13-11-2013 02:10:44 was 64.2 %RH |
%HMax% |
maximum humidity between start and end |
Maximum humidity between %StartDate% and %EndDate% was %HMax% %RH |
Maximum humidity between 12-11-2013 10:00:14 and 13-11-2013 02:10:44 was 70.0 %RH |
%HMin% |
minimum humidity between start and end |
Minimum humidity between %StartDate% and %EndDate% was %HMin% %RH |
Minimum humidity between 12-11-2013 10:00:14 and 13-11-2013 02:10:44 was 58.5 %RH |
%HMaxSample% |
sample number of maximum humidity |
Maximum humidity (%HMax% %RH) occurred sample %HMaxSample% at %HMaxDate% |
Maximum humidity (70.0 %RH) occurred sample 3312 at 12-11-2013 23:38:14 |
%HMinSample% |
sample number of minimum humidity |
Minimum humidity (%HMin% %RH) occurred sample %HMinSample% at %HMinDate% |
Minimum humidity (58.5 %RH) occurred sample 3465 at 13-11-2013 02:57 |
%HMaxDate% |
date-time of maximum humidity |
Maximum humidity (%HMax% %RH) occurred sample %HMaxSample% at %HMaxDate% |
Maximum humidity (70.0 %RH) occurred sample 3312 at 12-11-2013 23:38:14 |
%HMinDate% |
date-time of minimum humidity |
Minimum humidity (%HMin% %RH) occurred sample %HMinSample% at %TMinDate% |
Minimum humidity (58.5 %RH) occurred sample 3465 at 13-11-2013 02:57 |
%HUpper% |
humidity upper limit |
%SN% Upper humidity limit is %HUpper% |
S1234567 Upper humidity limit is 35.00 |
%HLower% |
humidity lower limit |
%SN% Lower humidity limit is %HLower% |
S1234567 Lower humidity limit is 10.00 |
%HAbove% |
indicates if humidity upper limit has been exceeded |
%SN% Humidity above=%HAbove% |
S1234567 Humidity above=Y |
%HBelow% |
indicates if humidity lower limit has been exceeded |
%SN% Humidity below=%HBelow% |
S1234567 Humidity below=Y |
|
When a temperature metastring parameter is expanded, the resulting numerical value is always expressed in the current display units. If you want to encode the display units as well you can append the %Units% metastring, which expands to either C or F. |
See also:
Meta-strings in file and folder names
Meta-strings in email messages
Meta-strings in printed reports headers and footers
Meta-strings in parameter sets
(C) 1992-2019 Temprecord International Ltd