Logs

Purpose of Logs

Logs give the Software Administrator an overview of usage, and they allow Forsta to receive transaction data from customers according to contractual commitments. Logs are to be sent to Forsta on a monthly basis, on one of the first days of the new month to report for the preceding month.

Multimode Log

Go to Admin > Activity Logs > Multimode Log to search for information about multimode event activity. Add the appropriate search criteria, then click Search to display the information. Click Reset to remove all search criteria and re-display the full list.

• Newest on Top - orders the list chronologically. Select Yes to always have the newest event at the top of the list; select No to have the oldest event at the top.
• Set Interval to Partial Hour to open two additional fields; Start Minute and End Minute. These allow you to set the search time criteria to the required minute.

Figure 1 - Example of the results of a Multimode search

Note that you can add more than one company ID to the Include and Exclude Company IDs filter fields. Separate the IDs with a space.

Click Export to export the list as an emailed zipped .txt file.

Note that you can page through the resulting list by the selected interval, both forwards and backwards, using the << and >> buttons at either side of the result list header bar.

Ordering a Log

1. Go to the Admin > Activity Logs / Log Reporting menu command.

The Log Reporting overlay opens as shown in the figure below.

2. Type the email address to which the log is to be sent. Default is the logged-in user - you.
3. Choose the Month and Year for the desired log, and set the start time.

Note that you can set up the transmission as a recurring task by selecting Schedule for later execution then setting the parameters (go to Setting Up a Repeated Task for more information).

4. Click OK.

An encrypted XML file is sent to the specified email address.

A log can be ordered to any email address using the same procedure (assuming that e-mail rules in your company allow that). If you wish to include a report in clear text (that is readable), check the Include a readable report box.

Figure 2 - Log reporting

Setting Up a Repeated Task

To set up a repeated task (for example the monthly Usage report to Forsta), or schedule the log to be sent at a later time, proceed as follows:

1. Go to the Admin > Activity Logs > Log Reporting menu command.

The Log Reporting overlay opens as shown in the figure above below.



Figure 3 - The Export of aggregated activities dialog

2. Choose the Month and Year for the log, but for the monthly report leave the Mail to address at the default.
3. Click the down-arrow beside the Start time field to open the drop-down list, then select Schedule for later execution.
4. Click OK.

The Log Reporting overlay changes to display the Recurrence tab.



Figure 4 - Setting Log reporting as recurring task

5. Set Recurring Task to Yes.

A number of additional options become available. Make the required settings. As an example, the following settings will ensure monthly transmission of the required information, starting at 05:00 on 20th April 2010, and repeating thereafter at the same time on the 1st day of each month until October.

• Click the date picker icon beside the date field under New Start Time, and select the date you want to start the task (20.04.2010).
• Set the time (05:00).
• Set Recurring task to Yes.
• Click the date picker icon beside the End By field, and select the date you want the task to stop (01.10.2010).
• Set Recurrence pattern type to Monthly .
• Set Monthly Schedule to Day 1 of every 1 month(s).
6. Click Save to save the settings.

Note: If a user sets up a recurring task and at some point in the future while the task is still running the user’s ID expires, the task will be “Aborted by the system”. The following error message will then be written to the task log - “Your account has expired. Please contact your system administrator.” For assistance, contact Support. The system administrator can also change “ownership” of the task – click here for details.

Content of the Log File

The mail generated by the system on the Software Administrator’s request will include one encrypted XML file and, if the "Include a readable report" option is selected, a readable XML file. This allows you to check the transaction information before sending it to Forsta. Once received, the file will be decrypted by Forsta.

The file contains the following information:

1) addon_<company>_<date>

List of companies having been granted access to Add-ons

addon_idaddon_companyidcompany_name

11Forsta

etc

2) list_<company>_<date>

Number of report-accesses granted pr user company list on the server

ListCompanyNumber of users

Forsta ASP 7

etc

3) users_<company>_<date>

List of the User IDs on the server

CompanyUserCreatedExpires

Forsta ASOveH1998.10.242001.12.31

etc

4) aggregated_<company>_<date>

5) activitytype_<company>_<date>

The encrypted files include the number of Transactions / Hits. Given that no attempt has been made to tamper with the transaction data, the content of the files will match the numbers displayed in the email On-Screen message.

Email Activity Log

Company Administrators and System Administrators have access to the Email Activity Log. This report shows the number of emails sent for the current company per month. The report can be grouped by date, weekday, week, quarter or all.

Figure 5 - Example of the Email Activity Log for February

Error Log

This menu command takes you to the Home > Tasks page Aborted tab, and displays the last 30 day's entries on the error log for batch jobs. The Task ID is a link to the properties and log of a specific task that enables you to investigate the error further.

Figure 6 - Example of the Error log