• Introduction
  • What's new in this version
  • Examples
  • Information
  • Usage
  • Interface
  • Options
  • Monitoring Item Properties
  • RightSoft on the web
  •  
    Right Web Monitor Online Downloads Order Contact Us

    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:

    • %CURRENTYEAR% - returns current year.
    • %CURRENTMONTHNO% - returns current month number (without leading zero).
    • %CURRENTDAY% - returns current day.
    • %CURRENTHOUR% - returns current hour.
    • %CURRENTMINUTE% - returns current minute.
    • %CURRENTSECOND% - returns current second.
    • %CURRENTDATE% - returns current date in system format.
    • %CURRENTTIME% - returns current time in system format.

    Common variables:

    • %FILESIZEBYTES% - returns the resource size in bytes.
    • %FILESIZESHORT% - returns the resource size using the nearest applicable measurement unit (for example 1678200 will be equal to 1,6 Mb).
    • %FILESIZEK% - returns the resource size in kilobytes.
    • %LASTMODIFIED% - returns the resource last modification date/time.
    • %LASTPOLLDATETIME% - returns the timestamp of the last poll of this link.
    • %POLLRESULT% - string representation of the last poll result.
    • %STATE% - returns the extended information about current item state.
    • %SUMMARYSTRING% - returns processed Summary string.
    • %TITLE% - returns resource title.
    • %TITLEURL% - returns <A HREF=[ResourceURL]>[ResourseTitle]</A> string. Useful when using with snapshot string.
    • %URL% - returns item URL.

    Special variables:

    1. HTTP (text/html/xml documents only)
      • %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.
      • %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 (Visible text part).
      • %HTMLFRAGMENTX% (where X is ordinal number of the selected fragment 1,2,3 etc.) - returns specified fragment1,2 (HTML source). Useful when using with snapshot string.
      • %HIGHLIGHTEDCHANGES% - returns highlighted changes during last change detection ("Hightlight changes" option must be enabled in order to get it to work). 
      • %PREVPAGE% - returns URL of the previuos step when using Multiple Request Scripts. Usable for referrer field.
      • %SELECTEDFRAGMENTS% - returns the selected fragments1 of the resource2.
      • %VISIBLETEXT% - returns all visible text of the given resource.
      • %WHOLEPAGE% - returns HTML source of the given resource.
      • %XMLFEED% - returns the feeds summary.
    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.