Troubleshooting Siebel Mobile Connected Applications

Table 3-4 shows some common errors that users might encounter when trying to access and use Siebel Mobile connected applications on their mobile device.

Table 3-4 Troubleshooting Siebel Mobile Connected Applications: Common Errors

Problem	Cause	Solution
The application user interface is not displaying correctly on the mobile device.	The Siebel Mobile connected application is not rendering correctly.	Check the browser that is being used on your mobile device. For information about browser requirements, see Deploying Siebel Open UI.
The Siebel Mobile environment is not loading and a blank screen appears.	Private browsing is enabled for the browser on your mobile device.	Make sure that private browsing is not enabled for the browser on your mobile device. For more information, see "Disabling Private Browsing".
If you get errors similar to the following: Tag: swe:nav-control is not valid in this context. . . . Error creating Parameter:HighInteractivity for Comp:ePharmaMObjMgr_ENU @ in CompGroup:HandheldSyncSIS Strict Flag set to FALSE, continuing with the next Object... Error creating Parameter:MobileApplication for Comp:ePharmaMObjMgr_ENU @ in CompGroup:HandheldSyncSIS Strict Flag set to FALSE, continuing with the next Object...	The Siebel Mobile connected application is not rendering correctly.	Make sure that the Siebel Application Object Manager parameters are configured correctly for your Siebel Mobile connected application. To set the parameters again, run the srvrmgr command for your Siebel Application Object Manager. For more information, see "Siebel Application Object Manager Parameters for Siebel Mobile Connected Applications".
An error message similar to the following appears after selecting a value from a drop-down list: The applet field with name " . . . " does not exist (SBL-UIF-00289)	The User Agent settings for the web browser are incorrect.	The steps to modify the User Agent settings for the web browser are: Log in to the Siebel Business Application. Navigate to the Administration - Web Browser screen, then the Browsers view. Create a new browser by entering the browser name and version. Add the capabilities for the new browser. For example: User-Agent = Mozilla/4.0 (compatible; <browsername&version> Parent = <browsenamer&version> Accept = image/gif, image/x-xbitmap, image/jpeg, image/pjpeg, application/vnd.ms-powerpoint, application/vnd.ms-excel, application/msword, */* JumpTab = True Note that although the User-Agent value looks incomplete without a closing (right bracket) parenthesis, this is the correct value. After applying these Siebel client parameters, restart the Siebel Mobile connected application. No browser errors will be returned, no matter what parameters are set on the browser side.

.

Enabling JavaScript for Safari

To use Siebel Mobile on Safari, JavaScript must be enabled for Safari.

To enable JavaScript for Safari 

1. Start your Safari browser.

2. Select Preferences from the Safari menu.

3. Click Security.

4. Select the Enable JavaScript option.

5. Close the Preferences window.

6. Close and restart Safari.

Disabling Private Browsing

If after logging into Siebel Mobile, the application environment will not load and a blank screen appears, then make sure that private browsing is not enabled for the browser on your mobile device. Private browsing mode will block any browser cache from registering, and prevent Siebel Mobile, which depends on caching, from running. The following procedure shows you how to disable private browsing in, for example, Safari on iPad.

To disable private browsing (for example, on iPad)  

1. Tap Safari on the home screen of your iPad to start the browser.

2. Do one of the following as required:

   1. If using Apple iOS 7, then disable private browsing as follows:

      • Tap Show Pages (the plus icon) in the lower right hand corner of the screen.

      • Tap Private in the lower left hand corner of the screen

      • If prompted to close or keep all current tabs open, select an option.

      • Tap Done in the lower right hand corner of the screen.

      Private browsing is now disabled for the mobile device, and the background color of the Safari browser changes to white or light gray.

      To enable private browsing for the mobile device, repeat this step again. When private browsing is enabled, the background color of the Safari browser is black or dark gray (and not white or light gray).

   2. If using Apple iOS 7.1 or later, then disable private browsing as follows:

      • Tap the URL field at the top of the screen.

      • When the keyboard opens, tap Private above the keyboard on the left hand side.

      • If prompted to close or keep all current tabs open, select an option.

      Private browsing is now disabled for the mobile device, and the background color of the Safari browser changes to white or light gray. To enable private browsing for the mobile device, repeat this step again. When private browsing is enabled, the background color of the Safari browser is black or dark gray (and not white or light gray).

Clearing the Browser Cache

The process of clearing the browser cache differs from browser to browser, but typically involves selecting an option to delete the cache or temporary files in your browser's administrative settings. After clearing your browser cache, refresh the page that you are viewing so that your browser can obtain the fresh files. The following procedure shows you how to clear the browser cache.

To clear the browser cache 

1. On an iOS device (such as iPad):

   1. Tap Settings, Safari, and then tap Clear Cookies and Data.

   2. Tap Clear when prompted for confirmation to clear all cookies and data.

      This step clears all the cached data that was used to speed up browsing.

   3. Refresh the page that you are viewing to obtain the latest files.

2. On an Android device (such as Samsung Galaxy tablet):

   1. Open the Web browser on your mobile device.

   2. Tap Menu, select Settings, tap Privacy and Security, and then to one or both of the following as required:

      • Tap Clear all cookie data to clear all browser cookies.

      • Tap Clear browser cache to delete locally cached content and databases.

   3. Refresh the page that you are viewing to obtain the latest files.

Checking the Browser Cache Size

To successfully use Siebel Mobile in offline mode, you must have a minimum of 50 megabytes (MB) of available storage on your mobile device. The following procedure shows you how to check the browser cache size in Safari on iPad so that you are within the cache limit and how to delete the Web site data if required. The procedure is similar on Android devices.

To check the browser cache size (for example, on iPad)  

1. Tap Settings, Safari, Advanced, and then tap Website Data.

   Review the amount of data stored for each Web site and the total amount of Web site data stored on your iPad.

2. Remove the data for any Web site whose data has been updated recently or is no longer required as follows:

   • Tap Edit.

   • Select the Web site whose data you want to remove, and then tap Delete.