Support Import

Audit Tab

The highly customizable Softomotive Audit tab, consists of the following features:

Audit_PR_2a1_New.PNG

What you need to understand in order to use the Audit Tab at its full potential, is that the key to unlocking its filtering power is to right-click on the event Columns Bar [4]. For really sophisticated filtering options you should definitely have a look at the Filter Editor which is covered at the end of this article.f

1. Date Range Selection:

The Date Range option allows you to select the dates whose logs interests you, from a number of predefined ranges or a purely Customized range:

Audit_PR_2a2_New.PNG

2. Export option:

The Export option, opens a Window that allows you to save the displayed logs in a *.xls, *.xlsx, *.csv file in a directory that you will choose. Note, that only the currently displayed Logs will be passed on to the file. So in case you have filtered any of them out, make sure that you have everything you need to export.

3. Video Log option:

Please feel free to check the corresponding Topic.

4. The "Search" bar:

You can search for any term that you expect to find in the logs. Please do keep in mind that the Search bar may not be visible by default so you would have to right click on the event Columns Bar to make it visible.

Audit_PR_2a3_New.PNG

5. The event Columns Bar:

Unlike other panes' Head Bars that do not allow interaction, the reader should know that this is a widely interactive element that allows users to implement the filtering of their choice, by either drag and dropping one or multiple Column Headers to target the exact range of results they want to audit, OR by right-clicking on it and working through the resulting menu:

Audit_PR_2a4_New.PNG

In order to return back to the default filtering settings (all) you have not but to right-click on the Drop area and select "Clear Grouping" from the resulting menu:

Audit_PR_2a5_New.PNG

The columns in order of the default appearance are:

Type: Showing if the event is an Error, a Warning or an Info. These three are the event types that are being logged in ProcessRobot. Errors are happening mostly when a Process fails to run successfully and produces an error. Warnings are being displayed after the occurance of expected problems, like trying to run a Process that has known errors. Infos simply let you know when a Process ran and completed or when a Trigger or Schedule was fired.

Date&Time: Date and time that the even happened.

Message: The descriptive message of the event.

Path: The path of the Process that generated the event.

Process Name: Self explanatory.

Robot Name: The Robot on which the process was executed.

User Name: The User Name of the Robot.

Event Id: The Event Id from the list of Event Ids that are declared in ProcessRobot.

Screenshot (without Title): Exception / Error handling (through Process Properties and Global Error Handling) allows you to Add a Screenshot to Logs in case a Process fails. Ticking that check box will produce a Screenshot of your entire screen (even if you use two monitors) at the moment of failure and the image will be available to you in the event Columns pane, next to the Event Id column:Error Handling

Audit_PR_2a6_New.PNG

Clicking that image icon will let you review the Screenshot immediately through a pop-up window (a built-in image viewer) of adjustable size that will also allow you to save the Image on your drive.

Video: Error handling (through Process Properties and Global Error Handling) allows you to open the Video Logs List and inspect the corresponding video:Error Handling

Audit_PR_2a7_New.PNG

6. The event Columns pane:

Here are listed all the events with all the info displayed in the columns.

7. The Additional details of the error

Once you have specified all Types and the Date Range, the Processes that match your filter will be listed.

Selecting a Message will display the Details of that Log event. Most Info or Warning events will only repeat the Message here, as there is no more useful information. In the event of an Error, the Additional Details box will contain all appropriate information to help solve the problem. As this area is highly technical, use this information if you need to contact Technical Support.

The Filter Editor

You can right click on the event Columns Bar in the Audit tab and you will get a number of options like this :

Audit_PR_2a8_New.PNG

If you select the "Filter Editor" option you can create your own Filter with arguments applicable to any of the bar's Columns in a chained-query like fashion.

filt-edit.png

It is worth noting that all conditionals, properties and operators are highly customizable so to meet the needs of the most demanding of business projects.

filt-edit-2.png

Another important thing to note is that your records can be sorted through a unique combo of criteria at any time. If you want to start from a pure database all over again you will have to right-click on the events Columns Bar and choose the "Clear Sorting" or "Clear All Sorting" options (depending on whether you have one or multiple filters binded in a combo) in order to start afresh.

clearing.png

If you are wondering how you can bind multiple filters without using the Filter Editor, simply observe the following example:

Let's say that Lucy wants to sort her records on descending Date&Time order and then sort the resulting table according to ascending Event Id order. To do that, Lucy can do the following:

1) Click once upon the Type Column Header in order for the little arrow to show characteristically that the descending order has been activated.

Audit_PR_2a9_New.PNG

2) Right-click on the Event Id and then click on the Sort Ascending:

Audit_PR_2a10_New.PNG

If Lucy desires to arrange her Logs on other criteria, she should not forgot to click "Clear All Sorting" as we have seen above!