WebLog Expert Help - Command Line

[Requires Professional Edition]

You can run WebLog Expert using the command line mode. In this case the program will analyze the specified profiles and exit.

WebLog Expert supports two command line modes: standard and batch ones.

If a command line parameter contains spaces, use quotes to delimit it. For example:

WLExpert "Main Report" -l"c:\My Logs\*.log"

In most cases you should use full path to the main executable file instead of "WLExpert". E.g. if WebLog Expert is installed to "C:\Program Files\WebLog Expert\" directory the command line will look as follows:

"C:\Program Files\WebLog Expert\WLExpert.exe" Sample

Standard Mode

Command line syntax:

WLExpert <Profile> -n<Name> -d<Domain> -i<IndexFile> -l<LogFile> -r<OutputPath> -e<EmailAddress> -t<TimeRange> -c<AnalysisCache> -s

<Profile>	Name of an existing profile. You can also use wildcards to analyze multiple profiles. E.g. use "WLExpert *" command line (without quotes) to analyze all the existing profiles.
All the switches are optional. -n, -d, -i, -l, -r, -e, -t and -c switches allow you to define custom profile properties that should be used instead of the properties of specified profile(s).
-n<Name>	Name that should be shown in the report instead of the profile name.
-d<Domain>	Domain name.
-i<IndexFile>	Index file name.
-l<LogFile>	Path to a local log file to analyze. You can also use wildcards and macros, and separate multiple file names or masks with semicolons. If you use this switch the program will use "Local file" mode for log location.
-r<OutputPath>	Report output folder (for HTML reports) or output file name (for PDF and CSV reports). You can use macros in the output path. If you use this switch, the program will use "Local drive" mode for report destination.
-e<EmailAddress>	Destination e-mail address. Multiple e-mail addresses can be separated with semicolons. If you use this switch the program will use "E-mail" mode for report destination. Note: -r and -e switches cannot be used at the same time.
-t<TimeRange>	Time range to be analyzed. You can define specific time range or use one of the predefined values. Time ranges must be entered in format "date1:time1 - date2:time2" or "date1 - date2". In the second case whole days will be analyzed. The format of date is mm/dd/yyyy and the format of time is HH:MM:SS. These formats don't depend on date and time format settings of Windows and WebLog Expert. Examples: "05/14/2009 - 06/04/2009", "06/15/2009:07:30:00 - 06/16/2009:12:00:00". You can also use one of the predefined values that are shown on the Time Range page of the Profile Properties dialog: "All activity", "Today", "Yesterday", "Last <n> hours", "Last <n> full days", "This week", "Last week", "Last <n> full weeks", "This month", "Last month", "Last <n> full months", "This quarter", "Last quarter", "Last <n> full quarters", "This year", "Last year" or "Last <n> full years". You need to specify a number instead of <n>. Examples: "Yesterday", "Last 7 full days", "Last 12 full months".
-c<AnalysisCache>	Path to an analysis cache file to be used. If at least one of switches -d, -i, -l and -t is specified, the program cannot use the default analysis cache for the analyzed profile. In such case you need to use the -c switch to save and load analysis results from a file.
-s	Turn on the silent mode. In this mode the program doesn't show message boxes if errors occur.

Examples:
WLExpert Sample
WLExpert Sample -n"Custom Profile" -dwww.domain.com -iindex.htm -t"Last week"
WLExpert Sample -l"c:\Program Files\WebLog Expert\sample.log" -r"c:\Program Files\WebLog Expert\Report"
WLExpert "Main Report" -lc:\Logs\*.log -c"c:\Analysis Cache\Main.db" -s

Batch Mode

Use this mode instead of running WebLog Expert in standard mode several times with different command line parameters.

Command line syntax:

WLExpert @<ListFile> -s

Text file that can be created using any available text editor, which doesn't add special characters (e.g. Notepad). The file must contain lines of the following format:

WebLog Expert processes all lines of <ListFile> sequentially. Each line is processed the same way as program run in the standard mode with the same parameters. All the switches are optional.

-s

This switch in the batch mode command line also works the same way as in the standard mode. The switch is optional too.

Example 1:
WLExpert @c:\Logs\Simple.txt

where Simple.txt file contains the following lines:

Sample
"Profile 1" -n"My Logs"
"Profile 2" -n"Special Logs"

Example 2:
WLExpert @"c:\My Logs\WLEList.txt" -s

where WLEList.txt file contains the following lines:

Main -n"Domain 1" -dwww.domain1.com -l"c:\My Logs\Log1.log" -r"c:\Reports\Report1" -c"c:\Cache\Report1.db"
"Main with Filters" -n"Filtered Domain 1" -dwww.domain1.com -l"c:\My Logs\Log1.log" -r"c:\Reports\FilteredReport1" -c"c:\Cache\FilteredReport1.db"
Main -n"Domain 2" -dwww.domain2.com -l"c:\My Logs\Log2.log" -r"c:\Reports\Report2" -c"c:\Cache\Report2.db"
"Main with Filters" -n"Filtered Domain 2" -dwww.domain2.com -l"c:\My Logs\Log2.log" -r"c:\Reports\FilteredReport2" -c"c:\Cache\FilteredReport2.db"