Getting Started with the Siebel Mobile Application Container

Getting Started with the Siebel Mobile Application Container (Siebel App)

This chapter describes how to get started with the Siebel Mobile Application Container (Siebel app) and how to integrate Siebel Mobile with native device features. It includes the following topics:

About the Siebel App, Siebel.maa File, and Mobile Application Framework

Before using the Siebel App, Siebel.maa file and MAF, note the following:

Earlier versions of Siebel Server, prior to Siebel Innovation Pack 2015 patchset 15 or Siebel Innovation Pack 2016 patchset 5, will not work with version 2.16.10 or later of the Siebel app and Siebel.maa file.
You cannot use an earlier version of the Siebel.maa file, prior to version 2.16.10, with MAF version 2.3.1 or later.
You must upgrade to MAF version 2.3.1 or later to use the Siebel app and Siebel.maa file version 2.16.10 and later.

Overview of Siebel Mobile Integration with Native Device Features

You can access and use the following native device features from Siebel Mobile, provided that you download and configure the Siebel app first from either the Apple App store if using an iOS device or from Google Play if using an Android device:

File System Access. From Siebel Mobile, you can access the native device local hard disk space to read data from and write data to files stored locally on the device using either relative or absolute paths, or the file URL (file://host/path). Depending on mobile application set up and on whether you are using Siebel Mobile connected or disconnected, Siebel Mobile routes commands to the Siebel Server (if online) or local resources (if offline) as required.
Location Services. From Siebel Mobile, you can use the native device location services to obtain more accurate location data. For more information about using location services on a mobile device, see Displaying Location Details in Siebel Mobile and Configuring the Privacy Settings for Native Device Feature.

Note: This release of Siebel Mobile uses WkWebView for iOS devices (instead of UIWebView), which improves performance and communication between the application and web page.

Note: This release of Siebel Mobile uses SQLite (and not WebSQL):

SQLite implements the SQL database system and its query language is a simplified version of SQL.
SQLite is an embedded SQL database engine and it reads and writes to ordinary disk files.
Whereas WebSQL implementations have a 50 megabyte data download limit, this limitation does not apply to SQLite.

Process of Integrating Siebel Mobile with Native Device Features

To integrate Siebel Mobile with the native features on your mobile device, perform the following tasks:

Downloading and Installing the Siebel App

This topic shows you how to download and install the Siebel app on your mobile device. You need the Siebel app to dynamically link to a Siebel Mobile server so that you will be able to access and use native device features, such as the local file system and location services, from Siebel Mobile.

Downloading and Installing the Siebel App from the Apple App Store

The following procedure shows you how to download and install the Siebel app (Siebel.ipa file) from the Apple App Store for iOS devices such as iPad. If you want to create and deploy your own customized Siebel app, then ignore this procedure and see Downloading and Using the Siebel Mobile Archive File (Administrator Task) for more information.

To download and install the Siebel app from the Apple App Store

Start your iOS mobile device.
Go to the Apple App Store (http://store.apple.com/us) and search for the following app: Siebel.
Tap FREE to download the Siebel app.
Tap INSTALL to install the Siebel app.
Enter your Apple ID password to install the Siebel app on your mobile device.
Configure the Siebel app.
For more information, see Configuring the Siebel App on iOS and Android Devices.

Downloading and Installing the Siebel App From Google Play

The following procedure shows you how to download and install the Siebel app (Siebel.apk file) from Google Play for Android devices such as Samsung Galaxy tablet. If you want to create and deploy your own customized Siebel app, then ignore this procedure and see Downloading and Using the Siebel Mobile Archive File (Administrator Task) for more information.

To download and install the Siebel app from Google Play

Start your Android device.
Go to Google Play (http://play.google.com/store) and search for the following app: Siebel.
Select the Siebel app and then tap INSTALL.
Follow the on screen instructions to install the Siebel app on your mobile device.
Configure the Siebel app.
For more information, see Configuring the Siebel App on iOS and Android Devices.

Downloading and Using the Siebel Mobile Archive File (Administrator Task)

Instead of downloading the Siebel app and installing it on a mobile device as described in Downloading and Installing the Siebel App, administrators can download the Siebel Mobile archive file (Siebel.maa) from Oracle Software Delivery Cloud (https://edelivery.oracle.com) and use the archive file to create and deploy a customized Siebel app for iOS and Android devices.

For more information about how to use Oracle JDeveloper to create a new Mobile Application Framework (MAF) application from an archive (.maa) file, how to deploy the mobile application, and customize the application (for example, replace the application images), see the supporting documentation for Oracle JDeveloper:

http://docs.oracle.com/cd/E53569_01/tutorials/tut_jdev_maf_setup/tut_jdev_maf_setup.html

Setting Up the Host Server for Siebel Mobile

This task applies only if using Siebel Innovation Pack 2017 or later. If using an earlier innovation pack prior to 2017, then see Setting Up the Host Server for Siebel Mobile (Innovation Pack 2016).

The following procedure shows you how to set up the host server where Siebel Mobile applications are located. You use the Siebel Management Console to configure the host server. The host address is configured in the following format:

https://host:port/siebel/v1.0/applicationlist

For example:

https://samplehost.com:636/siebel/v1.0/applicationlist

The host address connects to the Application Interface, which contains the application list information.

To set up the host server for Siebel Mobile (Innovation Pack 2017)

Log in to the Siebel Management Console.
Click Profiles in the navigation menu in the side pane, and then select Application Interface.
Existing Application Interface Profiles are listed, if any.

Select the application interface profile you want and do the following:

Click Applications and then select the application you want to configure for Siebel Mobile (for example: epharma, sales, or service).
When you select an application, the following options appear for the application: Basic Information, Mobile, Enhanced Authentication.
Select the Mobile option and then configure the parameters for the application as shown in the following table.

Repeat these steps for each application you want to configure for Siebel Mobile.

Parameter	Description
Configure Siebel Mobile	Select this check box to configure a Siebel Mobile application (a mobile version of the application).
Application Display Name	Specify the display name of the Siebel Mobile application. For example: epharmam, salesm, or servicem.
Application Display Order	Specify the display order of the Siebel Mobile application. For example: 1, 2, or 3.
Application Icon Name	Specify the icon of the Siebel Mobile application. For example: epharma.png, sales.png, or service.png.

Click Submit to save your changes to the application interface profile.

Setting Up the Host Server for Siebel Mobile (Innovation Pack 2016)

This task applies only if using Siebel Mobile version 2.x in Siebel Innovation Pack 2016 or earlier. If using Siebel Innovation Pack 2017 or later, then see Setting Up the Host Server for Siebel Mobile.

The following procedure shows you how to set up the host server where Siebel Mobile applications are located.

To set up the host server for Siebel Mobile (Innovation Pack 2016)

After installing and configuring Siebel Web Server Extension (SWSE), copy the mobileapplist.lst file from SWSEHome to the host Web server root path.

For example on Microsoft Windows (IIS), navigate to Local Disk (C), inetput, wwwroot and paste a copy of the mobileapplist.lst file in this location. On UNIX, copy the .lst file to the Web server root and make sure it supports the .lst MIME type.

The following table summarizes the Web server paths for different operating systems.

Field	Web Server Path
Windows	C:\inetpub\wwwroot\
Linux	Build_Install_Directory/web/Oracle_WT1/instances/instance1/config/OHS/ohs1/htdocs>
Solaris	Build_Install_Directory/web/https-localhost/docs
HP-UX	Build_Install_Directory/web/htdocs
AIX	Build_Install_Directory/web/htdocs

Open the mobileapplist.lst file in a text editor.

An example of the content in the file is as follows:

{
"1":{"id":"1","name":"Siebel ePharma 
Mobile","lang":"LanguageCode","url":"http(s):// webserver_hostname/epharmam_
LanguageCode/"},
"2":{"id":"2","name":"Siebel Service for 
Mobile","lang":"LanguageCode","url":"http(s):// webserver_hostname/servicem_
LanguageCode/"},
"3":{"id":"3","name":"Siebel Sales 
Mobile","lang":"LanguageCode","url":"http(s):// webserver_hostname/salesm_
LanguageCode/"}
}

Edit the mobileapplist.lst file as follows:
1. Change LanguageCode to the language in which you want to run the application. For example, change LanguageCode to enu to run the application in English.
2. Depending on your deployment, use http or https for the Siebel Web server URL.
3. Change epharmam_LanguageCode and servicem_LanguageCode to (for example) epharmam_enu and servicem_enu respectively.
  When finished, the content in the mobileapplist.lst file appears similar to the following:
```
{
"1":{"id":"1","name":"Siebel ePharma Mobile","lang":"enu","url":"http(s):// 
webserver.com/epharmam_enu/"},
"2":{"id":"2","name":"Siebel Service for 
Mobile","lang":"enu","url":"http(s):// webserver.com/servicem_enu/"},
"3":{"id":"3","name":"Siebel Sales Mobile","lang":"enu","url":"http(s):// 
webserver.com/salesm_enu/"}
}
```
4. Save and close the mobileapplist.lst file.
Change the MIME type for mobileapplist.lst as follows:
1. Open Internet Information Services Manager.
2. Navigate to the Features view and double-click MIME Types.
3. Right-click the .lst MIME type and select Edit.
4. In the MIME Type field, type in text/plain, and then click OK.

Customizing the Siebel App Application Icons (Siebel Innovation Pack 2016)

This task applies only if using Siebel Mobile version 2.x in Siebel Innovation Pack 2016 or earlier. If using Siebel Innovation Pack 2017 or later, then see Setting Up the Host Server for Siebel Mobile.

You can customize the icon associated with each application listed on the Home page (Application List screen) of the Siebel app.

To customize the Siebel App application icons

Open the mobileapplist.lst file in a text editor.

An example of the content in the file is as follows:

{
{"1":{"id":"1","name":"Siebel ePharma 
Mobile","lang":"LanguageCode","url":"http(s):// webserver_hostname/epharmam_
LanguageCode/"},
"2":{"id":"2","name":"Siebel Service for 
Mobile","lang":"LanguageCode","url":"http(s):// webserver_hostname/servicem_
LanguageCode/"},
"3":{"id":"3","name":"Siebel Sales 
Mobile","lang":"LanguageCode","url":"http(s):// webserver_hostname/salesm_
LanguageCode/"}
}

For each application definition in the mobileapplist.lst file, add the following:

"icon":"appname.png"

Where appname is the name of the application. When finished, the content in the mobileapplist.lst file appears similar to the following:

{
"1":{"id":"1","name":"Siebel ePharma 
Mobile","lang":"LanguageCode","icon":"epharma.png", "url":"http(s):// 
webserver.com/epharmam_LanguageCode/"},
"2":{"id":"2","name":"Siebel Service for 
Mobile","lang":"LanguageCode","icon":"service.png", "url":"http(s):// 
webserver.com/servicem_LanguageCode/"},
"3":{"id":"3","name":"Siebel Sales 
Mobile","lang":"LanguageCode","icon":"sales.png", "url":"http(s):// 
webserver.com/salesm_LanguageCode/"}
}

Save and close the mobileapplist.lst file.

Configuring Single Sign-On for Siebel Mobile

Siebel Mobile supports Single Sign-On (SSO) for connected applications.

Note: SSO does not apply for Siebel Mobile disconnected applications since Siebel Mobile is used locally on the mobile device without connectivity. Siebel Mobile disconnected applications use the SQLite database to store data, metadata and all the resource files to run the application.

The following procedure shows you how to configure SSO for Siebel Mobile if using Siebel Innovation Pack 2017 or later.

To configure SSO for Siebel Mobile (Innovation Pack 2017)

Log in to the Siebel Management Console.
Click Profiles in the navigation menu in the side pane, and then select Application Interface.
Existing Application Interface Profiles are listed, if any.
Select the application interface profile you want to modify and do the following:
1. Click Applications and then select the mobile application you want to configure for SSO (for example: epharmam, salesm, or servicem).
  When you select an application, the following options appear for the application: Basic Information, Mobile, Enhanced Authentication.
2. Select the Enhanced Authentication option and then select the Configure Web Single Sign-On (Web SSO) check box.
3. For Trust Token, specify the password to be used with SSO authentication.
4. For User Specification, specify the user specification to use for SSO authentication.
  Repeat these steps for each mobile application you want to configure for SSO.
Click Submit to save your changes to the application interface profile.

The following procedure shows you how to configure SSO for Siebel Mobile if using Siebel Innovation Pack 2016 or earlier.

To configure SSO for Siebel Mobile (Innovation Pack 2016)

Open the mobileapplist.lst file in a text editor.

Modify the mobileapplist.lst file by adding "authmode":"sso" as follows:

{
"1":{"id":"1","name":"Siebel ePharma 
Mobile","lang":"LanguageCode","url":"http(s):// webserver_hostname/epharmam_
LanguageCode/","authmode":"sso"},
"2":{"id":"2","name":"Siebel Service for 
Mobile","lang":"LanguageCode","url":"http(s):// webserver_hostname/servicem_
LanguageCode/","authmode":"sso"}
"3":{"id":"3","name":"Siebel Sales 
Mobile","lang":"LanguageCode","url":"http(s):// webserver_hostname/salesm_
LanguageCode/","authmode":"sso"}
}

Save and close the mobileapplist.lst file.

Configuring the Siebel App on iOS and Android Devices

This procedure shows you how to configure the Siebel app on iOS and Android devices, which involves the following:

Dynamically connecting to a Siebel Server by entering the Siebel Mobile host server address.
You must set up the host server as shown in Setting Up the Host Server for Siebel Mobile. After the host server is set up, you can connect to multiple applications in a single Siebel app.
Clearing the application cache for an application.

This procedure assumes that you have already downloaded and installed the Siebel app from either the Apple App Store for iOS devices or from Google Play for Android devices as shown in Downloading and Installing the Siebel App.

To configure the Siebel app

If not already done so, set up the Host Server where Siebel Mobile applications are located as shown in Setting Up the Host Server for Siebel Mobile.
Start your iOS or Android device and then tap Siebel to start the Siebel app.
In the Host section, type in the host server address where Siebel Mobile applications are located, for example, as follows:
- For Siebel Innovation Pack 2016 and earlier, the host server address follows: http://hostserveraddress.com
- For Siebel Innovation Pack 2017 and later, the host server address follows: http://hostserveraddress.com/siebel/v1.0/applicationlist
  You will be connected directly to this host server whenever you log in to an application located at this host server address.
Note: For HTTPS setup, the CA Certificate used to trust the Siebel Web Server must be installed on all mobile devices (iOS and Android).

Note: Use the Reset All option to reset the server. For more information, see Resetting the Host Server Using the Siebel App.
If this is your first time starting the Siebel app on your mobile device, then do the following:
- Tap Yes when prompted to Install Siebel Certificate, and install the certificate on your mobile device.
  
  Note: For iOS 10.3 and later, you must trust the certificate by going to iOS Settings, General, About, Certificate Trust Settings, and selecting the certificate (Siebel Mobile Internal CA) you installed. This step does not apply for Android devices.
- Accept the end-user license agreement.
Tap the arrow next to the host server address to go to the Home page (Application List screen) of the Siebel app.
The Application List screen lists the applications that you can connect to on the host server address. You can connect to multiple applications using the Siebel app.
The Application List is populated from the mobileapplist file that you must configure as shown in Setting Up the Host Server for Siebel Mobile.
Each application in the Application List has a unique icon. You can customize the icon associated with each application as shown in Customizing the Siebel App Application Icons (Siebel Innovation Pack 2016).
There is an Edit button and an arrow next to each application in the Application List. Use the Edit button to log in to the application and clear the application cache. Use the arrow to return to the application (having navigated back to the Home page).
Connect to an application as follows:
1. Tap the Edit button next to the application that you want to connect to.
2. Type in the Username and Password credentials for the application, and then tap Sign In.
  After successful login, the application starts and is rendered as normal in the Siebel app. The following buttons appear under the application banner and persist for all views in the application:
  - Refresh button for refreshing the page in the browser.
  - Attachment button for going to the Attachment Manager view. For more information, see Managing Attachment Downloads.
  - Home button for returning to the Home page (Application List screen, described in the previous step) of the Siebel app.
To clear the application cache for an application, see Clearing the Application Cache for Applications Using the Siebel App.
After successful login to disconnected applications (offline mode), the Identifier is populated with a unique ID (Sync Node ID) identifying the application that was synchronized after successful login.

Note: The Identifier does not apply to connected (online) applications; it applies to disconnected applications only.

Clearing the Application Cache for Applications Using the Siebel App

Note: This task applies only if using Siebel Mobile in offline mode.

Application cache files improve the way applications work on your mobile device by encouraging pages to load faster. Too much cache information, however, can cause application performance in general to slow down. To prevent a deterioration in application performance, it is recommended that you check the browser cache size and clear the application cache data accordingly from time to time.

The following procedure shows you how to clear the application cache for an application by using the Siebel app on iOS or Android devices. Clearing the application cache involves doing one or both of the following:

Deleting the attachment files downloaded to a device.
Removing all mobile application cookies, application cache, and web database data from a device.

To clear the application cache using the Siebel app

Start your iOS or Android device and then tap Siebel to start the Siebel app.
Tap the arrow next to the host server address to go to the Home page (Application List screen) of the Siebel app.
Log in to the application where you want to clear the cache.
Tap the Edit button next to the application where you want to clear the cache, and then do the following:
- Tap Clear Downloaded Attachments and tap OK when prompted for confirmation to delete all downloaded files for the selected application.
- Tap Clear Downloaded Data and tap OK when prompted for confirmation to delete all cookies and data for the selected application.

The application cache will be cleared when the application is restarted.

Resetting the Host Server Using the Siebel App

The following procedure shows you how to reset the host server for an application using the Siebel app on iOS or Android devices. When you reset the host server, all applications configured on the host server are reset.

To reset the host server using the Siebel app

Start your iOS or Android device and then tap Siebel to start the Siebel app.
Tap Reset All, and then tap Yes when prompted with the following message:
Application Data will be reset. This will take effect when the application is restarted.
The next time you start the Siebel app, the connection field or host server address field will be empty. For more information about connecting to the host server, see Configuring the Siebel App on iOS and Android Devices.

Managing Attachments Using the Siebel App

If you are using the Siebel app with Siebel Mobile version 2.0 or later, then you can manage the download and upload of attachments using the Attachment Manager view.

The Attachments Manager view has the following tabs:

Download Attachments. Lists all the attachments that have either finished downloading or are scheduled to download.
Upload Attachments. Lists all the attachments that have either finished uploading or are scheduled to upload.

Each attachment record contains the following information:

Check box. If checked, this indicates that the attachment record is selected for download or upload. If unchecked, the attachment record is not selected.
List Order. A number in the List Order field indicates the rank or sequence number for the attachment record. You can select and (without releasing the selection) then move each row to change the record sequence, or you can type in a number manually in the List Order field to change the record sequence.
Entity. The attachment type.
File Name. The name of the attachment record.
Size (KB). The size of the attachment file.
Progress. The attachment download or upload status.
- The attachment download status can be one of the following: Not Downloaded, Queued for Download, Downloaded, File not Available, or Downloading.
  Downloading indicates that the attachment is actively downloading and a progress bar shows the progress of the task.
- The attachment upload status can be one of the following: Not Uploaded, Queued for Upload, Uploaded, File not Available, or Uploading.
  Uploading indicates that the attachment is actively uploading and a progress bar shows the progress of the upload.
Speed. The attachment download or upload speed.
Time Left. The duration of time to complete the attachment download or upload.

Note: The attachment functionality is supported in both online and offline mode. In offline mode, attachment upload and download is supported only when customers install the Siebel app or use the Siebel Mobile Archive MAA file to create and deploy a customized Siebel app for iOS and Android devices. For more information, see Downloading and Installing the Siebel App.

Managing Attachment Downloads

The following procedure shows you how to manage the download of attachments using the Attachment Manager view in the Siebel app. The Attachment Manager view is available in online mode after the initial full download is complete, and in offline mode to download attachments during the synchronization process.

To manage attachment downloads

Start your iOS or Android device and then tap Siebel to start the Siebel app.
Log in to the application where you want to manage attachment downloads.
After successful login, the application starts and is rendered as normal in the Siebel app. The following buttons appear under the application banner and persist for all views in the application: Refresh, Attachment, and Home.
For more information about these buttons, see (Step 6 in) Configuring the Siebel App on iOS and Android Devices.
Create attachment records as required.
For more information, see Modifying Attachment Information for an Account and Modifying Attachment Information for a Contact.
In the Siebel app, tap the Attachment button to open the Attachment Manager view, and then tap Download Attachments.
Reorder the Download Attachments list as required by typing in a number in the List Order field.
Tap the check box next to each attachment record to select that record for download.
Tap the Download Only on Wi-Fi check box.
Choose one of the following download options as required:
- Download. Tap to queue the selected attachment records for download.
- Remove. Tap to delete attachments belonging to the selected attachment records from the mobile device, and cancel any future downloads of or updates to the selected attachment records.

Managing Attachment Uploads

The following procedure shows you how to manage the upload of attachments using the Attachment Manager view in the Siebel app. The Attachment Manager view is available in online mode after the initial full upload is complete, and in offline mode to upload attachments during the synchronization process.

To manage attachment uploads

Start your iOS or Android device and then tap Siebel to start the Siebel app.
Log in to the application where you want to manage attachment uploads.
After successful login, the application starts and is rendered as normal in the Siebel app. The following buttons appear under the application banner and persist for all views in the application: Refresh, Attachment, Home.
For more information about these buttons, see (Step 6 in) Configuring the Siebel App on iOS and Android Devices.
Create attachment records as required.
For more information, see Modifying Attachment Information for an Account and Modifying Attachment Information for a Contact.
If you create or modify attachment records in offline mode, then synchronize the data with the server as follows:
- Tap Go Online (the empty airplane icon) on the application banner.
- Select Sync and Stay Offline to queue attachments for upload on the server.
  Failure to synchronize your offline data changes with the server will result in an error message similar to the following appearing when you try to Upload Attachments in the following step: Unable to upload offline attachments. Please synchronize your data before uploading attachments to the server.
  
  Note: This step applies to Siebel Mobile disconnected applications only, it does not apply to Siebel mobile connected applications.
In the Siebel app, tap the Attachment button to open the Attachment Manager view, and then tap Upload Attachments.
Reorder the Upload Attachments list as required by typing in a number in the List Order field.
Tap the check box next to each attachment record to select that record for upload.
Tap the Upload Only on Wi-Fi check box.
Choose one of the following upload options as required:
- Upload. Tap to queue the selected attachment records for upload.
- Remove. Tap to delete attachments belonging to the selected attachment records from the mobile device, and cancel any future uploads of or updates to the selected attachment records.

Configuring the Privacy Settings for Native Device Feature

To use native device features such as location services with your Siebel Mobile application, then you must configure the privacy setting for the feature on your mobile device accordingly as shown in the following procedures:

Configuring the Privacy Settings on i OS Devices

The following procedure shows you how to configure the privacy settings on iOS devices.

To configure the privacy settings on iOS devices

Start your iOS device.
Tap Settings, tap Privacy and then tap Location Services to turn on the setting.
The map functionality is now enabled for Siebel Mobile. For more information about using the map functionality, see Displaying Location Details in Siebel Mobile.

Configuring the Privacy Settings on Android Devices

The following procedure shows you how to configure the privacy settings on Android devices.

To configure the privacy settings on Android devices

Start your mobile device.
Tap Google Settings, tap Location and then tap Location Reporting to turn on the setting.
The map functionality is now enabled for Siebel Mobile. For more information about using the map functionality, see Displaying Location Details in Siebel Mobile.

Setting Up CalDAV and CardDAV Publishing

CalDAV (Calendaring Extensions to WebDAV) is an internet standard allowing clients to access scheduling or meeting information on a remote server. It uses iCalendar format for data. CardDAV (vCard Extensions to WebDAV) is an address book client-server protocol allowing users to share contact data on a server.

The key requirement for using CalDAV and CardDAV publishing is email address. All contacts and employees must be associated with a valid email address. For CalDAV, the identification of meeting participants depends entirely on the email address. All users must have the same email address registered in the Siebel application and on their mobile device.

URL Syntax for CalDAV Account Setup

For CalDAV clients to access Siebel DAV, the following URL syntax is required for setting up new CalDAV accounts:

http://<server>:<port>/siebel/dav/<lang><user_name>/

For example: http://example:1661/siebel/dav/enu/JDOE/

If the client does not support service discovery, then use the collection URL instead:

http://<server>:<port>/siebel/dav/<lang>/<user_name)/calendar/event

For example: http://example:1661/siebel/dav/enu/JDOE/calendar/event/

URL Syntax for CardDAV Account Setup

For CardDAV clients to access Siebel DAV, the following URL syntax is required for setting up new CardDAV accounts:

http://<server>:<port>/siebel/dav/<lang>/<user_name>

For example: http://example:1661/siebel/dav/enu/JDOE/

If the client does not support service discovery, then use the collection URL instead:

http://<server>:<port>/siebel/dav/<lang>/<user_name>/addressbook/ contact

For example: http://example:1661/siebel/dav/enu/JDOE/addressbook/contact/

Setting Up CalDAV Publishing on an iOS Device

The following procedure shows you how to set up CalDAV publishing on an iOS mobile device. Before setting up CalDAV publishing on your mobile device, make sure that you can access the Siebel application on your device.

To set up CalDAV publishing on an iOS device (such as iPad)

Tap Settings, tap Mail, Contacts, Calender, and then tap Add Account.
Select Other, then select Add CalDAV Account and enter the following information:
- Server. The Siebel Application Interface host name (for example, caldav.example.com).
- Username. The user name to access the Siebel application (case sensitive).
- Password. The password to access the Siebel application (case sensitive).
- Description. A description to help identify the calendar in your list of calendars (for example, CalDAV Calendar Work).
Tap Next.

Note: If the following warning message appears, select Details to review the certificate details, and then select Trust if the certificate is correct: Cannot Verify Server Identify - The identity of <Server> cannot be verified by <Description>. Review the certificate details to continue.
Select Continue when the following message appears:
Cannot Connect Using SSL - Do you want to try setting up the account without SSL?
Select OK when the following message appears:
Calendar Account - CalDAV account verification failed.
Tap Advanced Settings, and then select Use SSL if required.
Your decision to Use SSL or not depends on how the Siebel Application Interface is configured to access Siebel CalDAV and CardDAV.
Specify the port number and then append siebel/dav/<language>/<user_name>/ to the Account URL, for example as follows:
```
caldav.example.com:16661/siebel/dav/enu/JDOE
```
Note: You can replace <user_name> with the name of whom ever granted you access to their calendar in Siebel.
Tap CalDAV, and then tap Next to start the account verification.
If account verification fails, go back and check that you have entered all the correct information.
After account verification is successful, select whether you want to synchronize Calendars, Reminders, or both, and then tap Save.
Make sure you select Calendars.
Tap Calendar on your mobile device, and then select Calendars.
The list of available calendars appears. The calendar that you just created shows up in this list.

Setting Up CardDAV Publishing on an iOS Device

The following procedure shows you how to set up CardDAV publishing on an iOS device. Before setting up CardDAV publishing on your mobile device, make sure that you can access the Siebel application on your device.

To set up CardDAV publishing on a iOS device (such as iPad)

Tap Settings, tap Mail, Contacts, Calender, and then tap Add Account.
Select Other, select Add CardDAV Account and then enter the following information:
- Server. The Siebel Application Interface host name (for example, carddav.example.com).
- Username. The user name to access the Siebel application (case sensitive).
- Password. The password to access the Siebel application (case sensitive).
- Description. A description to help identify the calendar in your list of calendars (for example, CardDAV Calendar Work).
Tap Next.

Note: If the following warning message appears, select Details to review the certificate details, and then select Trust if the certificate is correct: Cannot Verify Server Identify - The identity of <Server> cannot be verified by <Description>. Review the certificate details to continue.
Select Continue when the following message appears:
Cannot Connect Using SSL - Do you want to try setting up the account without SSL?
Select OK when the following message appears:
Contact Account - CardDAV account verification failed.
Tap Advanced Settings, and then select Use SSL if required.
Your decision to Use SSL or not depends on how the Siebel Application Interface is configured to access Siebel CalDAV and CardDAV.
Specify the port number and then append siebel/dav/<language>/<user_name>/ to the Account URL, for example as follows:
```
carddav.example.com:16661/siebel/dav/enu/JDOE/
```
Note: You can replace <user_name> with the name of whom ever granted you access to their calendar in Siebel.
Tap CardDAV, and then tap Next to start the account verification.
If account verification fails, go back and check that you have entered all the correct information.
After account verification is successful, specify what you want to do with existing local contacts, and then tap Done.
It is recommended that you choose the Keep on My iPad option.
Tap Contacts on your mobile device, tap Groups, and then select Show All Contacts.

Setting Up CalDAV and CardDAV Publishing on an Android Device

The native Calendar and Contact (address book) applications for Android do not support CalDAV and CardDAV and, as a result, require a third-party client to connect to the CalDAV and CardDAV server. To enable CalDAV and CardDAV on your Android device, you must follow the instructions of the selected third-party application.

Before setting up CalDAV or CardDAV publishing on your Android device, make sure that you can access the Siebel application on your device. Other items to note include the following:

Enable Use SSL on your Android device if required.
Your decision to Use SSL or not depends on how the Siebel Application Interface is configured to access Siebel CalDAV and CardDAV.
Use the following Home URL to connect to the server:
http://webserver_hostname:port/siebel/dav/language/user_name
For example: http://caldav.example.com:1661/siebel/dav/enu/JDOE/
Depending on the client, you might have to use the collection URLs instead:
- CalDAV: http://webserver_hostname:port/siebel/dav/language/user_name/calendar/event/
  
  For example: http://caldav.example.com:1661/siebel/dav/enu/JDOE/calendar/event/
- CardDAV: http://webserver_hostname:port/siebel/dav/language/user_name/addressbook/contact
  
  For example: http://carddav.example.com:16661/siebel/dav/enu/JDOE/addressbook/contact/
The user name and password credentials must be the same credentials used to log in to the Siebel application.
Accept the server certificate if Use SSL is enabled.
The CalDAV Provider is Generic.
The CardDAV Provider is Generic.
The WebDav Provider is Generic.