Siebel CRM Siebel Mobile Guide: Disconnected Siebel Innovation Pack 2014 Rev. A E52427-01 |
|
![]() Previous |
![]() Next |
View PDF |
You use the bug icon, shown in Figure 8-4, on the application banner to review the log event messages and debug information for Siebel Mobile applications, provided that logging has been enabled for the application.
The bug icon is visible on the application banner only after logging has been enabled for the application. If you cannot see the bug icon on the application banner, then logging has not been enabled for the application yet.
Information about the following is included in this topic:
You enable logging in Siebel CRM for each Siebel Mobile application user role and assign users to that role. You configure Log Events for logging in the Siebel Mobile application. You must set Log Events for logging in the Siebel Mobile application when in online mode - that is, when you are connected to the Siebel Server.
To enable logging for Siebel Mobile application users
Log in to Siebel Tools and add the following application user property and value for the Siebel Mobile application:
Application User Property | Value |
---|---|
Client Business Service | Web Engine UI Preferences |
Note : The Client Business Service user property is added by default for the Siebel Mobile application for Siebel pharma so it is not necessary to add it again. For all other Siebel Mobile applications, this step is required. |
Enable logging in Siebel CRM for Siebel Mobile application users:
Log in to the Siebel business application with administrative responsibility.
Navigate to the Administration - Application screen, then the Responsibilities view.
Query for and select the appropriate Siebel Mobile application user role.
For example, query for the following: PH Pharma Sales Rep - US Sales.
In the Views applet, add the User Profile Logs View to the selected application user role.
In the Users applet, add users to the selected application user role.
Doing this enables the User Profile Logs View for each user that you add.
Select Clear Cache in the Responsibilities view.
Configure Log Events for logging in the Siebel Mobile application:
Log in to the Siebel Mobile application with the User Profile Logs View responsibility.
If you have not been assigned the User Profile Logs View responsibility (as shown in Step 2), then you will not be able to view log information.
Tap Settings (the photo icon) on the application banner, and then select the Settings option.
Tap Behavior, and then set Log Events to one of the values described in the following table.
Value | Description |
---|---|
Metadata Extraction | This log event option logs the following:
|
Data Extraction - Basic | This log event option logs the following:
|
Data Extraction - Detailed | This log event option logs the following during full and incremental synchronization downloads:
|
UpSync | This log event option logs the details of records to be uploaded and all records that are uploaded. |
Client System | This log event option logs the following:
|
All | Logs event and debug information for all of the following log event options combined: Metadata Extraction, Data Extraction - Basic, Data Extraction - Detailed, UpSync, and Client System. |
Log out of the application and then log back in again for the changes to take effect.
Notice that after you log back in to the application, Log (the bug icon) appears on the application banner.
Log information is stored locally in the browser cache. When local storage is full, the following message appears in the log console: Local storage is full. It is recommended that you clear log information on a regular basis to prevent the unnecessary usage of browser storage space. You must have a minimum of 50 megabytes (MB) of available storage on your mobile device at all times.
Before clearing the log information for Siebel Mobile applications, review the existing log information just in case you might want to save any of it. The following procedure assumes that logging has been enabled for the Siebel Mobile users as shown in "Enabling Logging for Siebel Mobile Application Users".
To clear the log information for Siebel Mobile applications
Tap the bug icon on the application banner.
The log console opens showing all recent log event messages and debug information.
Tap clear to clear the log information.
All log information is deleted from the browser local storage.
The following procedure shows you how to upload Siebel Mobile log information to Siebel Server. This procedure assumes that logging has been enabled for Siebel Mobile users as shown in "Enabling Logging for Siebel Mobile Application Users".
To upload Siebel Mobile log information to Siebel Server
Tap the bug icon on the application banner.
The log console opens showing all recent log event messages and debug information.
Tap Upload Logs to upload all log information to Siebel Server.
Siebel Server saves all log information that it receives in the <server location>/log
folder:
<server location
>/log/<user_id
>/DMLog_<nodeid
>_<timestamp
>.log
where:
<user_id> indicates the ID of the logged in user.
<nodeid> indicates the client device. The node ID is generated when the user switches to offline mode. If the user does not switch to offline mode, then the log information is saved as follows: DMLog_No-Node-ID_<timestamp>.log
.
<timestamp> indicates the date and time that the log was saved.
The following procedure shows you how to save Siebel Mobile log information. This procedure assumes that logging has been enabled for Siebel Mobile users as shown in "Enabling Logging for Siebel Mobile Application Users".
To save Siebel Mobile log information
Tap the bug icon on the application banner.
The log console opens showing all recent log event messages and debug information.
Tap anywhere in the log console, tap Select All, and then tap Copy.
Save the log information, for example, as follows:
Open the Notes feature on your mobile device.
Tap New to create a new note.
Tap anywhere in the new note that opens, then tap Paste to paste the contents of the clipboard (that is, the log information that you copied in Step 2) into the note.
The Siebel Mobile log function stores data locally in the browser cache. When the local browser storage is full, the log event messages and debug information for Siebel Mobile applications are no longer logged and the following error message appears in the console log:
Local storage is full.
Table 8-2 describes the Siebel Mobile log function in more detail. For information about troubleshooting Siebel Mobile disconnected application logging, see "Troubleshooting Your Siebel Mobile Disconnected Application".
Table 8-2 Siebel Mobile Log Function
Item | Description |
---|---|
Function Name |
SiebelApp.S_App.LogOfflineEvent() |
In Parameters |
The Siebel Mobile log function takes the following in-parameters: message: string, params: string |
Out Parameter |
The Siebel Mobile log function takes the following out parameter: Type: void |
Description |
This function takes two values (message and params) which are formatted and stored in the local browser storage. An error message appears (Local storage is full) in the console log when the local browser storage is full. Siebel stops logging error messages after this error message appears. |
Example |
SiebelApp.S_App.LogOfflineEvent('%1 - %2:= %3', 'class1', 'method1', 'data'); //This will be logged as: class1 - method1:= data |