Program variables.


Program variables are specific functions that return system- or resource-related information. You can use Program variables with all fields that have button on the right. To insert such variable into the field just press button and select the variable you want to use from the pop-up menu appeared. You can use multiple program variables within the same field.

Here's the complete list of available Program variables:

System variables:

Common variables:

Special variables:

  1. HTTP (text/html/xml documents only)
    • %CHANGEDFRAGMENTS% - returns all the fragments1 of the given resource which have been changed since the last check2.
    • %FRAGMENTX% (where X is ordinal number of the selected fragment 1,2,3 etc.) - returns specified fragment1,2.
    • %SELECTEDFRAGMENTS% - returns the selected fragments1 of the resource2.
    • %VISIBLETEXT% - returns all visible text of the given resource.
    • %PREVPAGE% - returns URL of the previuos step when using Multiple Request Scripts. Usable for referrer field.
    • %WHOLEPAGE% - returns HTML source of the given resource.
    • %HIGHLIGHTEDCHANGES% - returns highlighted changes during last change detection ("Hightlight changes" option must be enabled in order to get it to work).
    • %CACHEFILENAME% returns the name of the last cached local copy of the resource (Can be used only with HTTP\HTTPS resources when Exact Content Analysis \ Smart Content Analysis is enabled). Useful when using with "Run program" notification.
       
  2. FTP
    • %DIRLIST% - returns directory listing of the given resource. Such variable is useful only when the given resource is FTP folder.
    • Pro: %CHLIST% - returns text representation of the changes list in format <FileName FileSize FileDate FileState(new, changed, deleted)>
       
  3. POP3
    • %HDRLIST% - returns the list of the headers of the letters that are currently stored in the mailbox.
    • %MESSAGECOUNT% - returns the number of the letters that are currently stored in the mailbox.
       

1 - This means fragments which are defined with Smart Content Analysis conditions ("Link Properties > Analysis > Smart Content Analysis options").
2
- Can be used only with Smart Content Analysis checking method selected.

 

The range of these variables is not fixed, so you can suggest a new variable value for more convenient viewing.