Contents 

About
What's New
Purchase
Comparison
Getting Started
Introduction
User Interface
Creating Profile
Log Files
General Information
Log Formats
Filters
Creating Filters
Frequently Used Filters
Reports
Report Format
Report Contents
Click Overlay Report
Custom Tables & Charts
Standard Tables & Charts
General Statistics
Activity Statistics
Access Statistics
Visitors
Referrers
Browsers
Errors
Goals
Tracked Files
Profile Properties
General
Log Files
Time Range
Tracking
Filters
Report
Program Options
Analysis
General
Files
Date & Time
Geolocation
Ignore Lists
Log Cache
Report
Format
Items
Tables
Contents
Web Server
Browser
Network
DNS
Proxy
E-mail
Automation
Schedule
Schedule Task
Command Line
Date Macros
Web Server
Web Server
FAQ
Installation and Backup
Log Files
Analysis
Reports
Scheduler
Glossary

WebLog Expert Help

Prev Page Next Page

Command Line

[Requires Professional or Enterprise 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<IndexPage> -l<LogFile> -r<OutputPath> -e<EmailAddress> -t<TimeRange> -c<AnalysisCache> -s -FromScheduler

<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<IndexPage>

Index page name.

-l<LogFile>

Path to a local log file to analyze. You can also use wildcards and date 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 date 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.

-FromScheduler

This switch is usually used when the program runs from a scheduler, and it is used automatically when the program runs from the built-in scheduler. When this switch is specified, the program doesn't show message boxes if errors occur (like the -s parameter), while information on activity including errors is written to the schedule log. You can view the log by clicking the View Log button in the Schedule dialog. The program also starts minimized to tray, and only the Progress window is shown if the program is restored from tray.

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 -FromScheduler

<ListFile>

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:

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

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 works the same way in the batch mode as in the standard mode.

-FromScheduler

This switch also works the same way in the batch mode as in the standard mode. It is used automatically if the program runs from the built-in scheduler.

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"