WebStats dotNet Scheduler Documentation
Settings File
The settings file is the only data input for Scheduler. All of its settings are contained in this single XML file. Scheduler both reads and writes to this file during operation; However, Scheduler will only save settings from memory to the settings.xml file when it is paused. Therefore, you should always set the Paused setting to true and save the file. Then wait until Scheduler writes the settings from memory to the file. Then, you can go ahead and make your changes.

Example Settings.xml


<?xml version="1.0" encoding="utf-8"?>
<Settings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <LogLevel>Normal</LogLevel>
  <LogFilepath>F:\Program Files\Nodine Legal Technologies\WebStats Scheduler\log.txt</LogFilepath>
  <Pause>false</Pause>
  <RecurringEvents>
    <Event>
      <SettingsDirectory>F:\Program Files\Nodine Legal Technologies\WebStats Scheduler\Settings</SettingsDirectory>
      <ProfilePath>F:\Program Files\Nodine Legal Technologies\WebStats Scheduler\Profiles\Profile1.xml</ProfilePath>
      <LogsToProcess>
        <LogToProcess>
          <Directory>F:\Work\New Biz\Projects\WebStats\Scheduler\bin\Debug\Data</Directory>
          <SearchString>ex07053.\.log</SearchString>
        </LogToProcess>
      </LogsToProcess>
      <Start>2007-06-09T20:03:42.984375-05:00</Start>
      <Stop>2008-06-09T20:03:42.984375-05:00</Stop>
      <NextRun>2007-06-09T20:03:42.984375-05:00</NextRun>
      <RepeatUnit>Minutes</RepeatUnit>
      <RepeatValue>1</RepeatValue>
      <SaveDirectory>F:\Program Files\Nodine Legal Technologies\WebStats Scheduler\Reports</SaveDirectory>
      <Reprocessing>false</Reprocessing>
    </Event>
  </RecurringEvents>
  <OneTimeEvents>
    <Event>
      <SettingsDirectory>F:\Program Files\Nodine Legal Technologies\WebStats Scheduler\Settings</SettingsDirectory>
      <ProfilePath>F:\Program Files\Nodine Legal Technologies\WebStats Scheduler\Profiles\Profile1.xml</ProfilePath>
      <LogsToProcess>
        <LogToProcess>
          <Directory>F:\Work\New Biz\Projects\WebStats\Scheduler\bin\Debug\Data</Directory>
          <SearchString>ex07053.\.log</SearchString>
        </LogToProcess>
      </LogsToProcess>
      <Start>2007-06-09T20:03:42.984375-05:00</Start>
      <SaveDirectory>F:\Program Files\Nodine Legal Technologies\WebStats Scheduler\Reports</SaveDirectory>
    </Event>
  </OneTimeEvents>
</Settings>
Settings


LogLevel - this tells Scheduler how much logging should be done. Acceptable values are: Debug, Normal or None. These are the ONLY acceptable values.

LogFilepath - this is the full filepath to the file that Scheduler will use to log its status information.

Pause - this allows Scheduler to pause processing. Acceptable values are only: true or false. When it is set to true, Scheduler will finish any events that it is currently processing, then it will not process any events until pause is set to false. When set to false, Scheduler will process events normally.

RecurringEvents - this is a list of all the recurring events (specifics below).

OneTimeEvents - this is a list of all the one time events (specifics below).


RecurringEvents


SettingsDirectory - the full directory path (not relative) where the WebStats settings files exist (browsers.xml, robots.xml, etc.).

ProfilePath - the full filepath (not relative) where the WebStats profile file exists.

LogsToProcess - this is a list of all the logs which should be processed when this event is run (specifics below).

Start - the earliest possible time that this event can be fired.

Stop - the latest possible time that this event can be fired.

NextRun - the earliest possible time for the next iteration of this event.

RepeatUnit - a unit of time to be paired with RepeatValue to determine how far NextRun should be advanced after the event is fired. Acceptable values are only: Minutes, Hours, Days, Months.

RepeatValue - an integer value that is paired with RepeatUnit to determine how far NextRun should be advanced after the event is fired.

SaveDirectory - the full directory path (not relative) where the output reports from WebStats should be saved.

Reprocessing - whether or not reprocessing of logs should occur. If true, Scheduler will allow WebStats to process logs over and over again which could lead to undesired results. It is recommended that this be set to false unless you are an advanced user. Acceptable values are only: true or false.


OneTimeEvents


SettingsDirectory - the full directory path (not relative) where the WebStats settings files exist (browsers.xml, robots.xml, etc.).

ProfilePath - the full filepath (not relative) where the WebStats profile file exists.

LogsToProcess - this is a list of all the logs which should be processed when this event is run (specifics below).

Start - the earliest possible time that this event can be fired.

SaveFilepath - the full filepath (not relative) where the output report from WebStats should be saved.


LogsToProcess


LogToProcess - an instance of a log to be processed (specifics below).


LogToProcess


Directory - the full directory path (not relative) of where the logs are located.

SearchString - a RegEx string which will be compared against every file found in the Directory. WebStats will attempt to process ALL matches.