Siebel CRM Siebel Mobile Guide: Disconnected Siebel Innovation Pack 2014 Rev. A E52427-01 |
|
![]() Previous |
![]() Next |
View PDF |
This process is a step in "Roadmap for Setting Up Siebel Mobile Disconnected Applications". To configure Siebel Server for Siebel Mobile disconnected applications, perform the following tasks:
"Enabling the Handheld Component Groups for Siebel Mobile Disconnected Applications"
"Setting Up the Disconnected Mobile Synchronization Component Group"
"Assigning Responsibilities to Siebel Mobile Disconnected Application Users"
"Setting Up Selective Retrieval for Siebel Mobile Disconnected Application Views"
"Configuring Object Definitions for Siebel Mobile Disconnected Applications"
"Configuring Siebel Mobile Disconnected Application Settings"
"Configuring the Mobile Node for Siebel Mobile Disconnected Application Users"
"Running Database Extract for Siebel Mobile Disconnected Application Users"
"Configuring the Web Server for Siebel Mobile Disconnected Applications"
"Guidelines for Developing Data Filters for Siebel Mobile Disconnected Applications"
This task is a step in "Process of Configuring Siebel Server for Siebel Mobile Disconnected Applications" and "Guidelines for Developing Data Filters for Siebel Mobile Disconnected Applications".
The handheld components for Siebel Mobile must be enabled on the supported Siebel Server. You can enable the handheld component groups for the following Siebel Mobile applications on Microsoft Windows or on UNIX:
ePharma Mobile Object Manager (<Lang>)
Service Mobile Object Manager (<Lang>)
To enable the handheld component groups for Siebel Mobile disconnected applications
Log in to the Siebel Web application, and then do the following:
Navigate to the Administration - Server Configuration screen, then the Component Groups view.
Query for the HandheldSync* component group.
The following handheld component groups are returned:
HandheldSync
HandheldSyncSIS
For each of these component groups, do the following:
Select the component group, and then click the Enable button.
In the Component Group Assignments applet, click the Enable button for the required Windows or UNIX Server.
If required, go to the LifeSciences component group, and enable it as described in Step 1 0
NOTE: The LifeSciences component group must only be enabled if using the Siebel Pharma application. |
Stop, and then restart the Siebel Server.
This task is a step in "Process of Configuring Siebel Server for Siebel Mobile Disconnected Applications".
The following procedure shows you how to set up the Disconnected Mobile Synchronization component group (MobileSync) for Siebel Mobile disconnected applications. The purpose of this task is to support synchronization in disconnected mode.
The Disconnected Mobile Synchronization component group (MobileSync), the Data Extraction component (MobileDbXtract), and batch synchronization are all configured for the Siebel Mobile application for Siebel Pharma by default so it is not necessary to configure them again for the application.
You must use MobileDbXtract as a template and configure it accordingly to create the Data Extraction component for other mobile applications (such as, the Siebel Mobile application for Siebel Service), as shown in the following procedure.
To set up the Disconnected Mobile Synchronization component group for Siebel Mobile applications
Connect to the server manager on your server computer and run the following command to see if the MobileSync component group has been enabled or not:
list compgrps
If required, enable the MobileSync component group as follows:
Navigate to the Administration - Server Configuration screen, then the Enterprises view.
Select the Component Groups tab, and then query for MobileSync in the Alias field.
Click the Enable button.
In the Component Groups Assignments applet, click the Enable button for the required Windows or UNIX server.
Create the Data Extraction component for the mobile application as follows:
Log in to the Siebel application as a user with administrator privileges.
Navigate to the Administration - Server Configuration screen, then the Enterprises view.
Click the Component Definitions tab, and then query for MobileDbXtract in the Alias field.
Using MobileDbXtract as a template, create a similar Data Extraction component for the mobile application you want to set up the Disconnected Mobile Synchronization component group (MobileSync) for as follows:
Click Menu, then Copy Record.
In the Component field, type the name of the new Data Extraction component. For example, type in ServicemDbXtract to create a Data Extraction component for the Siebel Mobile application for Siebel Service.
Select MobileSync from the Component Group drop-down list.
In the Description field, type a description of the new component.
In the Component Parameters applet, configure the component parameters for the Data Extraction component (ServicemDbXtract) with the values shown in the following table:
Name | Value |
---|---|
Application Name | Siebel Service for Mobile
Note that the application name must be exactly the same as the mobile application name. You can find the mobile application name using the srvrmgr command line as follows: |
Language Code | ENU |
Application Repository File | siebel_sia.srf |
Click the Activate button to activate the Data Extraction component (created in Step 2 0) for the mobile application.
Click the Synchronize button to synchronize the Data Extraction component (created in Step 2 0) for the mobile application.
Note: This synchronization is a server administration task, which must be done for batch mode server components after certain types of operations, and is not related to the data synchronization that the components perform. For more information, see Siebel System Administration Guide. |
Configure the settings for the mobile application as follows:
Navigate to the Administration - Siebel Mobile screen, then the Application Administration view.
Select the mobile application from the top applet. For example: Siebel Service for Mobile.
Click the Settings tab, and then do the following:
Click New, select Data Extraction Component in the Name field, and then select the actual data extraction component (for example: ServicemDbXtract) in the Value field. The name of the data extraction component must be the same as the name defined in Step 0
Click New, select Enable Batch Extraction in the Name field, and then select True in the Value field. For more information, see "Configuring Batch Synchronization for Siebel Mobile Disconnected Applications".
Set any other mobile application settings. For example, set PurgeInterval, Default Busobj, and ApplicationDirectory. For more information, see Configuring Siebel Mobile Disconnected Application Settings.
Restart the Siebel Server for the changes to take effect.
Check the status of the MobileSync component group by doing one of the following:
From the command line, run the following command:
list comp for compgrp MobileSync
From the UI, navigate to the Administration - Server Management screen, then the Components view.
Create a mobile client (for example: SPORTER) and perform the database extraction by doing one of the following:
From the command line, run the Database Extract component (DbXtract) using the following command:
start task for comp dbxtract with client="SPORTER-MOBILE"
From the UI, navigate to the Administration - Server Management screen, then the Jobs view, and select the Database Extract component (DbXtract). In the Job Parameters applet, add a Client Name parameter and its value, for example, as follows:
ClientName=SPORTER-MOBILE
Start the mobile application (for example, servicem_enu) and log in with the appropriate user credentials.
Test that batch synchronization is working:
Run the following in the server manager:
list task for comp MobileDbXtract
From the UI, you can check the status of MobileDbXtract or the component of the respective application that was created (for example, ServiceDbXtract) by navigating to the Administration - Server Management screen, then the Tasks view.
Verify that the dmData.txt
file is generated in hhsync/<
mobile-application>
directory. For example:
hhsync/phm
is the directory created for the Siebel Mobile application for Siebel Pharma. hhsync/servicem
is the directory created for the Siebel Mobile application for Siebel Service.
The folder structure is determined by the ApplicationDirectory value specified in the Administration - Siebel Mobile screen, Application Administration, Settings view.
This task is a step in "Process of Configuring Siebel Server for Siebel Mobile Disconnected Applications".
A responsibility corresponds to a set of views. Responsibilities control the views to which users have access. The following procedure shows you how to assign views to a responsibility and then users to that responsibility. For more information about setting up view access and users for Siebel Mobile, see "Setting Up Selective Retrieval for Siebel Mobile Disconnected Application Views" and "Setting Up Users for Siebel Mobile Disconnected Applications".
To assign responsibilities to Siebel Mobile disconnected application users
Log in to the Siebel application as a user with administrator privileges.
Navigate to the Administration - Application screen, then the Responsibilities view.
Query for and select the appropriate responsibility or user role.
For example, query for the following: PH Pharma Sales Rep - US Sales.
Select the Responsibilities tab, and then do the following:
In the lower Users applet, add users to the responsibility as required.
In the lower Views applet, add the appropriate views to the responsibility as required.
Table 3-3 lists the Siebel Mobile application views that are added by default as part of the seed data for Siebel Mobile, so it is not necessary to manually add the views again.
Table 3-3 Siebel Mobile Application Views
Application | Default Views |
---|---|
Siebel Mobile application for Siebel Pharma |
LS Home Page Call View - Mobile LS Pharma Call Validation Results View - Mobile LS Pharma Call Signature Capture View - Mobile LS Pharma Signature Audit Administration View_PUI SIS HH Pharma Account Call Attendee View - Mobile SIS HH Pharma Professional Promotional Items View - Mobile SIS HH Pharma Professional Samples Dropped View - Mobile SIS HH Pharma Professional Call Products Detailed View - Mobile eDetailer Message Plan Preview View - Mobile eDetailer Presentation View - Mobile Pharma Call Literature View - Mobile Pharma Account List View - Mobile Pharma Account Contact View - Mobile Pharma Account Calls View - Mobile Pharma Account Addresses View - Mobile Pharma Account Affiliations View - Mobile Pharma Account Relationships View - Mobile Pharma Account Attachments View - Mobile Pharma Contact List View - Mobile Pharma Contact Call View - Mobile Pharma Contact Address View - Mobile Pharma Contact Best Contact Times View - Mobile Pharma Contact State Licenses View - Mobile Pharma Contact Affiliations View - Mobile Pharma Contact Relationships View - Mobile Pharma Contact Attachments View - Mobile |
Siebel Mobile application for Siebel Service |
SHCE Service Account Assets View - Mobile SHCE Service Account Contacts View - Mobile SHCE Service Account Entitlements View - Mobile SHCE Service Account SRs View - Mobile SHCE Service Accounts View - Mobile SHCE Service Activity Assets List View - Mobile SHCE Service Activity Attachment View - Mobile SHCE Service Activity Contact Form View - Mobile SHCE Service Activity FS Expense View - Mobile SHCE Service Activity FS Instructions List view - Mobile SHCE Service Activity FS Steps View - Mobile SHCE Service Activity Home Page View - Mobile SHCE Service Activity Invoice Signature View - Mobile SHCE Service Activity SR List View - Mobile SHCE Service Activity Time View - Mobile SHCE Service Asset Entitlements View - Mobile SHCE Service Asset List View - Mobile SHCE Service Asset Measurement View - Mobile SHCE Service Asset Reading View - Mobile SHCE Service Asset Warranty View - Mobile SHCE Service FS Activity Part Movements View - Mobile SHCE Service FS Activity Recommended Parts Tools - Mobile SHCE Service FS Invoice - Auto Invoice View - Mobile SHCE Service Invoice Line Item Details View - Mobile SHCE Service Invoice List View - Mobile SHCE Service Invoice line Item View - Mobile SHCE Service My Part Browser View - Mobile SHCE Service Order line Item View - Mobile SHCE Service Orders List View - Mobile SHCE Service Part Browser Availability View - Mobile SHCE Service Part Browser Substitute View - Mobile SHCE Service SR Activity View - Mobile SHCE Service SR Invoices View - Mobile SHCE Service SR Orders View - Mobile SHCE Service Service Request Invoice Signature View - Mobile SHCE Service Service Request View - Mobile SHCE Technician Breaks View - Mobile SHCE Technician POU View - Mobile SHCE Technician Shifts View - Mobile |
This task is a step in "Process of Configuring Siebel Server for Siebel Mobile Disconnected Applications".
All Siebel Mobile application views are available to users in offline mode by default. Setting up selective retrieval for Siebel Mobile application views is therefore a mandatory step if you want to restrict the number of views that will be downloaded to client devices and available to users in offline mode. For more information about setting up selective retrieval for Siebel Mobile application views, see the following topics:
It is not necessary to configure object definition data for the following Siebel Mobile applications because the object definitions are configured by default:
Siebel Mobile application for Siebel Pharma
Siebel Mobile application for Siebel Service
However, for information about configuring object mappings for a new or customized business component, see "Configuring the Object Mappings for a New Business Component".
This task is a step in "Process of Configuring Siebel Server for Siebel Mobile Disconnected Applications".
Siebel Mobile application settings are configured in the Settings view. The following application settings must be configured for all Siebel Mobile applications:
Purge Interval, which is set to 30 by default.
This field specifies the duration of the Purge Interval for cleaning up the S_SD_CHG_TXN and S_DM_CHG_TXNPAR tables. These tables carry incremental data, and the volume of data continues to grow in these tables if a user fails to download data for a long time. If a user fails to download data during the Purge Interval, then all incremental data is purged by default.
Note: When the purge interval expires, the transaction router (TxnRouter) will not track the incremental changes for that node any more and a forced full download will be triggered the next time that the user goes offline (switches to disconnected mode). |
Default Busobj, which is used to download the business objects that are not based on any view in the Siebel Mobile application.
ApplicationDirectory, which is used to specify the directory where user metadata is saved. For example: hhsync\phm
(on Windows) or hhsync/phm
(on UNIX). Forward slash must be used for UNIX.
Data Extraction Component, which must be created for Siebel Mobile applications, such as, the Siebel Mobile application for Siebel Service.
Note: The Data Extraction Component (MobileDbXtract) is configured by default for the Siebel Mobile application for Siebel Pharma so it is not necessary to configure it again for the application. |
Enable Batch Extraction, which is used to configure batch synchronization for Siebel Mobile applications.
Use the following procedure to configure Siebel Mobile application settings. This task is a step in "Process of Configuring Siebel Server for Siebel Mobile Disconnected Applications" and "Guidelines for Developing Data Filters for Siebel Mobile Disconnected Applications".
To configure Siebel Mobile disconnected application settings
Navigate to the Administration - Siebel Mobile screen, Application Administration, and then the Settings view.
Verify that Purge Interval is set to 30.
Set ApplicationDirectory, Default Busobj, and other application settings as required.
For information about all the other application settings that can be configured for Siebel Mobile applications, see the following topics:
This task is a step in "Process of Configuring Siebel Server for Siebel Mobile Disconnected Applications".
The following steps must be performed for each Siebel Mobile application user. Setting up the mobile node triggers transaction logging for the corresponding user on the Siebel Server.
To configure the mobile node for a Siebel Mobile disconnected application user
Log in to the Siebel application as a user with administrator privileges.
Navigate to the Administration - Siebel Mobile screen, then the Mobile Clients view.
In the Mobile Clients applet, click new to create a new record with the following values:
User ID. Click the lookup icon, and then select a user ID from the picklist that opens.
Mobile Application. Click the lookup icon, and then select the appropriate mobile application name from the picklist that opens.
Mobile Client. After you complete the Mobile Application field, the Mobile Client field automatically shows the following: <username>-MOBILE
.
Routing Model. Click the lookup icon, and then select Mobile Client - Standard from the picklist that opens.
Connect to the server manager and run Database Extract (dbxtract) for each application user. For more information, see "Running Database Extract for Siebel Mobile Disconnected Application Users".
For more information about setting up users in Siebel Mobile applications, see "Setting Up Users for Siebel Mobile Disconnected Applications".
This task is a step in "Process of Configuring Siebel Server for Siebel Mobile Disconnected Applications".
You must run the Database Extract component (dbxtract) for every Siebel Mobile application user. Running dbxtract for each user takes approximately 3-10 minutes.
Note: If the position changes for a Siebel Mobile application user (for example, the data visibility for the user increases or decreases), then you must run the Database Extract component again for that user. After dbxtract is run again, a full data and metadata download is enforced on the disconnected client by Siebel Mobile when the mobile client next sends a synchronization request to the Siebel Server. |
To run dbxtract for Siebel Mobile disconnected application users from srvrmgr command line
Start a task for the Database Extract component with the following parameters:
client="<client-name>"
For example, for SPORTER-MOBILE, run dbxtract as follows:
start task for comp dbxtract with client="SPORTER-MOBILE"
Run the same command for each configured Siebel Mobile application user.
You can also run dbxtract against a list of users that are specified in a command list or in a file, for example, as follows:
start task for comp dbxtract with client="SPORTER-MOBILE,LHILL-MOBILE,BFRIEDEL-MOBILE"
You can check the dbxtract log file to see the status (completed or failed) for each user specified in the command.
If the transaction processor component is not running, then run the following command:
start task for comp txnproc
To change the interval for the component, run the following command:
change param sleeptime=<value> for comp txnproc
For more information about setting up users for Siebel Mobile applications, see "Setting Up Users for Siebel Mobile Disconnected Applications" and "Roadmap for Configuring Incremental Synchronization for Siebel Mobile".
This task is a step in "Process of Configuring Siebel Server for Siebel Mobile Disconnected Applications".
The following procedures show you how to set MIME Type on different Web servers for Siebel Mobile applications. The procedure is similar across all Web servers. For more information, see the supporting Web server documentation.
To configure MIME Type on Microsoft Windows with IIS, for example, see "Configuring MIME Type on Microsoft Windows". To configure MIME type on operating systems other than Microsoft Windows, see the following:
"Configuring MIME Type for Solaris"
Note: For a complete list of supported Web servers for each operating system, go to the Certifications tab on My Oracle Support and see Siebel Installation Guide for the operating system you are using. |
Use the following procedure to configure MIME Type for Microsoft Windows with Internet Information Services (IIS).
To configure MIME Type on Microsoft Windows
Start IIS.
On Microsoft Windows for example, click Start, Control Panel, Administrative Tools, and then Internet Information Services.
Right click your local computer in the left pane, and then Properties.
Click the MIME Types button, and then New.
Configure MIME Type as follows:
In the Extension field, enter the file name extension, as follows:
.manifest
In the MIME Type field, enter a description that exactly matches the file type defined on the computer, as follows:
text/cache-manifest
Click OK.
Use the following procedure to configure MIME type for Oracle Enterprise Linux (Linux) with Oracle HTTP Server (for example, 11g Web Server).
To configure MIME type for Linux
Login into the Linux computer.
Navigate to Web server installation directory where the mime.types file is located. For example:
cd <WEB_SERVER_INST_DIR>/ config/OHS/ohs1
Run the following command:
echo "text/cache-manifest manifest appcache" >> mime.types
Restart the Web server.
Use the following procedure to configure MIME type for AIX and HPUX with HTTP Server and Apache Web Server. The types of HTTP Servers are as follows:
IBM HTTP Server (on AIX)
Oracle HTTP Server (on Linux)
To configure MIME type for AIX and HPUX
Login into the AIX or HPUX computer.
Navigate to the Web server installation directory where the mime.types file is located. For example:
cd <WEB_SERVER_ROOT>/conf
Run the following command:
echo "text/cache-manifest manifest appcache" >> mime.types
Restart the Web server.
Use the following procedure to configure MIME Type for Solaris with Oracle iPlanet Web Server.
To configure MIME Type for Solaris
Login into the Solaris computer.
Navigate to Web server installation directory where the mime.types file is located.
For example:
cd <WEB_SERVER_ROOT>/https-localhost/config
Run the following command:
echo "type=text/cache-manifest exts=appcache,manifest" >> mime.types
Restart the Web server.
This task is step in "Process of Configuring Siebel Server for Siebel Mobile Disconnected Applications".
For Siebel Innovation Pack 2014 and later, you can set up the MobileSync component group and also Siebel Mobile disconnected applications on Microsoft Windows or any UNIX platform. The MobileSync component group includes the MobileDbXtract component which is a new component, and the following legacy remote components, which were formerly part of the Siebel Remote component group: TxnRoute, TxnProc, and DbXtract.
Use the following procedure to configure a hybrid server setup for Siebel Mobile. Configuring a hybrid server setup is optional.
Note: The complete system requirements and supported platform certifications are available from the Certifications tab on My Oracle Support. For information about Certifications, see article 1492194.1 (Article ID) on My Oracle Support. |
To configure a hybrid server setup for Siebel Mobile
Navigate to the Administration - Server Configuration screen, Enterprises, and then the Component Definition view.
Query for one of the following, as required:
ePharma Mobile Object Manager (<Lang>)
Service Mobile Object Manager (<Lang>)
Click Component Parameters, and then click Advanced.
Search for Siebel File System, and then update the value to the respective windows path.