Col Lab Share PT

s
Siebel Collaboration
Guide
Version 7.8, Rev. A
May 2005
Siebel Systems, Inc., 2207 Bridgepointe Parkway, San Mateo, CA 94404

Copyright 2005 Siebel Systems, Inc.
All rights reserved.
Printed in the United States of America
No part of this publication may be stored in a retrieval system, transmitted, or reproduced in any way,
including but not limited to photocopy, photographic, magnetic, or other record, without the prior
agreement and written permission of Siebel Systems, Inc.
Siebel, the Siebel logo, UAN, Universal Application Network, Siebel CRM OnDemand, TrickleSync,
Universal Agent, and other Siebel names referenced herein are trademarks of Siebel Systems, Inc., and
may be registered in certain jurisdictions.
Other product names, designations, logos, and symbols may be trademarks or registered trademarks of
their respective owners.
PRODUCT MODULES AND OPTIONS. This guide contains descriptions of modules that are optional and
for which you may not have purchased a license. Siebels Sample Database also includes data related to
these optional modules. As a result, your software implementation may differ from descriptions in this
guide. To find out more about the modules your organization has purchased, see your corporate
purchasing agent or your Siebel sales representative.
U.S. GOVERNMENT RESTRICTED RIGHTS. Programs, Ancillary Programs and Documentation, delivered
subject to the Department of Defense Federal Acquisition Regulation Supplement, are commercial
computer software as set forth in DFARS 227.7202, Commercial Computer Software and Commercial
Computer Software Documentation, and as such, any use, duplication and disclosure of the Programs,
Ancillary Programs and Documentation shall be subject to the restrictions contained in the applicable
Siebel license agreement. All other use, duplication and disclosure of the Programs, Ancillary Programs
and Documentation by the U.S. Government shall be subject to the applicable Siebel license agreement
and the restrictions contained in subsection (c) of FAR 52.227-19, Commercial Computer Software Restricted Rights (June 1987), or FAR 52.227-14, Rights in DataGeneral, including Alternate III (June
1987), as applicable. Contractor/licensor is Siebel Systems, Inc., 2207 Bridgepointe Parkway, San
Mateo, CA 94404.
Proprietary Information
Siebel Systems, Inc. considers information included in this
documentation and in Siebel Business Applications Online Help to be
Confidential Information. Your access to and use of this Confidential
Information are subject to the terms and conditions of: (1) the
applicable Siebel Systems software license agreement, which has
been executed and with which you agree to comply; and (2) the
proprietary and restricted rights notices included in this
documentation.
Contents
Siebel Collaboration Guide 1
Chapter 1: Whats New in This Release

Chapter 2: Overview of Siebel Collaboration
About Siebel Collaboration
A Usage Example for Siebel Collaboration

Components of the Team Space
Chapter 3: Getting Started with Siebel Collaboration

About Getting Started with Siebel Collaboration
Process of Setting Up Siebel Collaboration
11
13
Collecting Server Names and Directory Paths for Siebel Collaboration Setup
Editing the Siebel Application CFG File for Siebel Collaboration
Setting Up the Single Sign-On Table for Siebel Collaboration
15
17
Setting Up the Symbolic URL for Access to the SharePoint Portal Server
Copying the Siebel-SharePoint Integration Files
18
19
Installing the Siebel Site Definition for SharePoint
19
Setting Up the Siebel-SharePoint Integration Web Service

Installing the Siebel Web Part
14
21
23
Installing Configuration Files for Siebel-SharePoint Integration
25
Setting Up Inbound and Outbound Web Services for Siebel Collaboration

Troubleshooting Siebel Collaboration Setup
30
31
Chapter 4: Using Siebel Collaboration

About Using Siebel Collaboration
37
Scenario for Using Siebel Collaboration

Process of Using Siebel Collaboration
Creating Team Spaces
38
39
39
Viewing Team Spaces Within the Siebel Application
40
Siebel Collaboration Guide Version 7.8, Rev. A
Contents
Viewing Team Spaces Without the Siebel Application
40
Chapter 5: Configuring Siebel Collaboration

About Configuring Siebel Collaboration
41
Scenario for Configuring Siebel Collaboration

Process of Configuring Siebel Collaboration
41
42
Changing the Number of Days That Determine the Status of the Team Space
Changing the Look and Feel of the Team Space Pages
43
Hiding and Showing the Navigation Bars on Team Space Pages

Configuring the Siebel Web Part for Team Spaces
Configuring Membership Lists for Team Spaces
47
48
Changing the Cache Setting for Siebel Collaboration
50
Extending Siebel Collaboration for Additional Siebel Objects

Configuring Siebel Collaboration for Another Language
Index
59
51
44
42
Whats New in This Release
Whats New in the Siebel Collaboration Guide, Version 7.8, Rev. A

Table 1 lists changes described in this version of the documentation to support release 7.8 of the
software.
Table 1.
What's New in the Siebel Collaboration Guide, Version 7.8, Rev. A
Topic
Description
Installing Configuration Files for

Siebel-SharePoint Integration on
page 25
Corrected the format of the URI for the Siebel inbound Web
Service. The correct format is
http://siebel_web_server/CustAppSvcs_enu/
start.swe?SWEExtSource=CustomUI&SWEExtCmd=Execute&WSSOAP=1
Whats New in the Siebel Collaboration Guide, Version 7.8

The Siebel Collaboration product and this book are new in release 7.8.
NOTE: Siebel Collaboration is not related to the discontinued Siebel eCollaboration product.
Whats New in This Release
Overview of Siebel
Collaboration
This chapter is an overview of the Siebel Collaboration product. It includes the following topics:
About Siebel Collaboration on page 7
A Usage Example for Siebel Collaboration on page 7
Components of the Team Space on page 9
NOTE: Siebel Collaboration is not related to the discontinued Siebel eCollaboration product.
About Siebel Collaboration

Siebel Collaboration integrates Microsoft SharePoint with Siebel Business Applications. It allows
Siebel users to create SharePoint sites (called team spaces) from within the Siebel application.
Each team space is based on a particular Siebel object record, such as an opportunity or service
request. The team space dynamically displays data about the record in the Siebel Web Part. The team
space contains other Web Parts such as discussion threads, online presence indicators, and
document-posting areas.
Siebel users can view and update team spaces associated with their records from within the Siebel
application. (See Figure 1 on page 9.)
Employees can also access the team spaces directly through their browser windows, in the same way
that they access other SharePoint sites.
Opportunity and service request objects are supported out-of-the-box. However, using Siebel Tools,
you can configure your application so that you can create team spaces for other business objects,
such as accounts or marketing campaigns.
A Usage Example for Siebel

Collaboration
A first-level support engineer at a large software company opens a service request on behalf of a
customer. One of the customers critical workflows, which routes quote requests, is running slowly.
The support engineer asks the customer the standard questions about server processing power and
system memory and then reviews the knowledge base for a solution. Unfortunately, he is unable to
find a solution, so he escalates the service request to the second-level support engineer who is the
call centers expert on workflow.
The second-level engineer reviews the service request and determines that a resolution requires
more workflow expertise than is available within the call center. She creates a team space area for
this service request by clicking the Create Team Space button on the Service Requests screen.
Overview of Siebel Collaboration A Usage Example for Siebel Collaboration
All users of the Siebel application who have visibility to the service request record can view the team
space. The support engineer clicks the Add Member button in the team space to invite other
employees in the company who she believes can help resolve the customers problem. The
employees she invites are the product manager and engineering manager for workflow, the
customers account manager, and the consultant who implemented the workflow.
The support engineer posts the problematic workflow in the documents area of the team space. Then,
she sees that the online presence indicators in the team space show both the product manager and
engineering manager are online. She initiates a chat session with them, and they review the problem
together.
The engineering manager takes an action item to create an alterative workflow for the customer. This
action item is posted in the action-item list in the team space so that other members can monitor
his progress on this item.
The support engineer captures the text from the chat session and posts it in the team space for the
benefit of others. She also starts a discussion thread to solicit solution ideas from other team-space
members.
When the customers account manager views the team space, he is immediately brought uptodate
about the service request. He downloads the new workflow posted by the engineering manager and
incorporates some ideas from the discussion thread. He takes an action item to work with the
customer to try the new workflow.
Meanwhile, the customers sales representative has heard about the service request and is concerned
that the current problem could cause the deal that she is working on with this customer to fall
through. However, she is reassured when she reviews the information in the team space and sees
the progress being made. She likes being able to access all this information without having to contact
each person involved.
The new workflow implemented by the account manager solves the problem. The account managers
and the support engineer document the solution. The document check out and revision features in
SharePoint allow them to work jointly on the report.
When the product manager and engineering manager next look at the team space, the report is
flagged as new. They are happy to learn that proposed workflow solved the problem and that all the
information about the problem is stored in the team space for future reference.
NOTE: This case describes the use of Siebel Collaboration in resolving a service request. For an
example of using Siebel Collaboration with opportunities, see Scenario for Using Siebel Collaboration
on page 38.
Overview of Siebel Collaboration Components of the Team Space
Components of the Team Space

Figure 1 on page 9 shows a team space for an opportunity. In this case, the team space is viewed
from within the Siebel application.
Membership list
Siebel Web Part containing information from the
opportunity record
Discussion area
Figure 1.
Posting area for documents

Action items with assignments
Sample Team Space (for an Opportunity Record)
Overview of Siebel Collaboration Components of the Team Space
10
Getting Started with Siebel

Collaboration
This chapter covers how to set up Siebel Collaboration. It includes the following topics:
About Getting Started with Siebel Collaboration on page 11
Process of Setting Up Siebel Collaboration on page 13
Collecting Server Names and Directory Paths for Siebel Collaboration Setup on page 14
Editing the Siebel Application CFG File for Siebel Collaboration on page 15
Setting Up the Single Sign-On Table for Siebel Collaboration on page 17
Setting Up the Symbolic URL for Access to the SharePoint Portal Server on page 18
Copying the Siebel-SharePoint Integration Files on page 19
Installing the Siebel Site Definition for SharePoint on page 19
Setting Up the Siebel-SharePoint Integration Web Service on page 21
Installing the Siebel Web Part on page 23
Installing Configuration Files for Siebel-SharePoint Integration on page 25
Setting Up Inbound and Outbound Web Services for Siebel Collaboration on page 30
Troubleshooting Siebel Collaboration Setup on page 31
About Getting Started with Siebel

Collaboration
This chapter lists the setup tasks that are specific to Siebel Collaboration. Use this chapter in
combination with the Applications Administration Guide and the Security Guide for Siebel Business
Applications.
The Applications Administration Guide and the Security Guide for Siebel Business Applications cover
the setup tasks that are common to all Siebel Business Applications, such as using license keys,
defining employees, and defining your companys structure. The Applications Administration Guide
also provides the information that you need to perform data administration and document
administration tasks.
Standard Setup
This chapter describes a standard setup of Siebel Collaboration:
For opportunity and service request objects
11
Getting Started with Siebel Collaboration About Getting Started with Siebel
Collaboration
In the ENU language and locale
NOTE: Siebel Collaboration is configurable. For information about configuring Siebel Collaboration,
including configuring for other business objects and languages, see Chapter 5, Configuring Siebel
Collaboration.
Prerequisites
This chapter assumes that you have installed and set up the:
Siebel application
SharePoint application and other required third-party software listed in System Requirements
and Supported Platforms on Siebel SupportWeb.
About User Authentication

When setting up Siebel Collaboration, there are three kinds of user credentials to consider (Table 2).
Table 2.
Credentials in a Siebel Collaboration Setup
User Credential
Used to Login into the . . .
Windows user
Client machine
Collaboration user
SharePoint application
Siebel user
Siebel application
SharePoint should be configured to use Integrated Windows Authentication (which uses the Windows
user credentials for authentication). Make sure that the SharePoint and client machines use the same
ADSI source for user authentication.
12
Getting Started with Siebel Collaboration Process of Setting Up Siebel Collaboration
For the Siebel application, you can use any of the user authentication methods described in the
Security Guide for Siebel Business Applications. However, you must make sure that there is a
mapping between the Siebel user credentials and the SharePoint user credentials. There are two
ways to set up this mapping: ADSI (Active Directory Service Interfaces) and SSO (single sign-on).
See Table 3 on page 13.
Table 3.
User Credential Mapping for SharePoint and Your Siebel Application
If You Use This Type of

User Authentication for
Your Siebel
Application . . .
ADSI
LDAP
Database
Authentication
Custom
Web Single Sign-On

(SSO)
1.
Then Mapping of User Credentials

Between Siebel and SharePoint
Applications Is . . .
And You Set the CFG

UserAuthentication
Parameter1 to . . .
Based on ADSI. The same user names and

passwords are used for:
ADSI
Client machine
SharePoint
Siebel application
Set up through an SSO table.
SSO
You are instructed on setting this parameter in Editing the Siebel Application CFG File for Siebel Collaboration on page 15.
Related Topics
Security Guide for Siebel Business Applications
Process of Setting Up Siebel

Collaboration
To set up Siebel Collaboration, perform the following tasks:
Before you begin:
Collecting Server Names and Directory Paths for Siebel Collaboration Setup on page 14
Set up on the Siebel side, part 1:
Setting Up the Single Sign-On Table for Siebel Collaboration on page 17
13
Getting Started with Siebel Collaboration Collecting Server Names and Directory Paths
for Siebel Collaboration Setup
Setting Up the Symbolic URL for Access to the SharePoint Portal Server on page 18
Set up on the SharePoint side:
Copying the Siebel-SharePoint Integration Files on page 19
Installing the Siebel Site Definition for SharePoint on page 19
Setting Up the Siebel-SharePoint Integration Web Service on page 21
Installing the Siebel Web Part on page 23
Set up on the Siebel side, part 2:
10 Setting Up Inbound and Outbound Web Services for Siebel Collaboration on page 30
Collecting Server Names and Directory

Paths for Siebel Collaboration Setup
Table 4 lists some information that you need to know about your system in order to carry out the
tasks in this chapter.
This task is a step in Process of Setting Up Siebel Collaboration on page 13.
To make sure you have the information you need to complete the Siebel
Collaboration setup
Print Table 4 and write in the values for your SharePoint environment under the examples.
Table 4.
Information You Need to Complete Siebel Collaboration Setup

Names Used as Examples in This
Chapter
Item
Format and Comments
SharePoint host
machine name
The name of the machine where the

SharePoint server is installed.
sharepoint_server
SharePoint
portal site
The URL for the SharePoint portal site.
sharepoint_portal_site
Web Site
directory for the
SharePoint
portal site
The directory where the Web site files

for the SharePoint portal site are
stored.
14
http://sharepoint_portal_site:port
C:\inetpub\sharepoint_portal_site
local drive:
\inetpub\sharepoint_portal_site
Getting Started with Siebel Collaboration Editing the Siebel Application CFG File for
Table 4.
Information You Need to Complete Siebel Collaboration Setup

Names Used as Examples in This
Chapter
Item
Format and Comments
SharePoint
Services Web
Service
Extension
directory
local drive:\Program Files\Common
Siebel Web
Server host
machine name
The name of the machine where the

Siebel Web Server is installed.
siebel_web_server
ADSI domain
name
The domain name for the ADSI user.
domain_name
Addin directory
on the
SharePoint
server
Fill in this value after completing

Step 2 in Copying the SiebelSharePoint Integration Files on
page 19.
C:\IntegrationInstall\Addin
SiebelSharePoint
Integration
directory

Step a in Setting Up the SiebelSharePoint Integration Web Service on
page 21.
C:\Siebel\SharePointIntegration
SiebelSharePoint
Integration Web
Service URI

Step 6 in Setting Up the SiebelSharePoint Integration Web Service on
page 21.
http://sharepoint_server:port/
siebelsharepointintegration.asmx
Files\Microsoft Shared\web server

extensions\60
C:\Program Files\Common
Files\Microsoft Shared\web server
extensions\60
Editing the Siebel Application CFG File

for Siebel Collaboration
The following procedure describes how to enable Siebel Collaboration by editing the CFG file for your
Siebel application.
For general information about editing CFG files, see the Siebel System Administration Guide.
To edit the CFG file for your application

1
Open the CFG file for the application and, if the file does not already contain a [Collaboration]
section, add this one:
15
Getting Started with Siebel Collaboration Editing the Siebel Application CFG File for
[Collaboration]
CollaborationEnabled = TRUE
SecurityToken = l5t42j6d9w73
VerifyCollaborationUser = TRUE
UserAuthentication = CHANGE_ME (ADSI/SSO)
DomainName = CHANGE_ME
SSOSystem = "Team Space Collaboration"
Edit the [Collaboration] section, referring to this table:

Parameter
Value
CollaborationEnabled
TRUE
Set to TRUE to enable Siebel Collaboration for

the Siebel application.
SecurityToken
SecurityToken
This security token must be the same as the

security token set in the config.xml file. (See
Installing Configuration Files for SiebelSharePoint Integration on page 25.)
For example:
l5t42j6d9w73
Notes
The security token is used by the Siebel Web

Service running on the SharePoint server to
verify the request is from a Siebel application.
Choose a value that:
VerifyCollaborationUser
TRUE
FALSE
Is less than 65 characters
Contains only Unicode characters that are

recognized by common text editors
Is sufficiently unique that a malicious user

cannot guess it
If set to TRUE, the Siebel application checks

that the user of the client machine is the same
as the user logged into the Siebel application.
If set to FALSE, no check is performed. For
example, if multiple Siebel users share one
Windows user, set this parameter to FALSE.
UserAuthentication
16
ADSI
SSO
Set the value corresponding to the user

authentication method used for your Siebel
application: ADSI or SSO. (See Table 3 on
page 13.)
Getting Started with Siebel Collaboration Setting Up the Single Sign-On Table for
Parameter
Value
DomainName
domain_name
Notes
Set the value to the domain of the Windows
user. This value is case sensitive.
NOTE: If user credentials are not prefixed
with the domain name, then this domain is
used.
SSOSystem
Team Space
Collaboration
You only need to set this parameter if

UserAuthentication=SSO.
This value specifies the SSO record that
contains the mapping between the Siebel and
Windows users.
If, in Step 2, you set UserAuthentication to ADSI, then make sure that in the [LDAPSecAdpt]
section of the CFG file, the UsernameAttributeType and UseAdapterUsername parameters are set
like this:
[LDAPSecAdpt]
UsernameAttributeType = sAMAccountName
UseAdapterUsername = FALSE
Setting Up the Single Sign-On Table for

This section describes how to set up the SSO (single sign-on) table from within your Siebel
application. You do not need to set up the SSO table if you use ADSI authentication for your Siebel
application. (See Table 3 on page 13.)
To set up the single sign-on table

1
In the Siebel application, navigate to Administration - Integration screen > SSO Systems Admin
List view.
In the SSO Systems Administration list, select the Team Space Collaboration record.
17
Getting Started with Siebel Collaboration Setting Up the Symbolic URL for Access to
the SharePoint Portal Server
In the SSO System Users list, for each Siebel Collaboration user: create a new record and
complete the necessary fields.
Some fields are described in the following table.
Field
Comments
Login Name
Windows user login name. For example, MSTERN or domain_name\CCHENG. If

the domain name is not included, it is read from the CFG file.
Password
This field is not required.
Multiple Siebel users can be mapped to one Windows user.
Setting Up the Symbolic URL for Access

to the SharePoint Portal Server
This URL format specifies the addresses of new team spaces that are created from within the Siebel
application:
http://SharepointHost/sites/[ObjectType]_[ROW_ID]/default.aspx
Where:
[ObjectType] is Opp or SR, depending on whether the team space is based on an opportunity or
service request record.
[ROW_ID] is the ID number of the originating opportunity or service request record.
To set up the symbolic URL for access to the SharePoint Portal Server
1
Navigate to the Administration - Integration screen > WI Symbolic URL List view.
From the Show drop-down list, choose Host Administration.
In the Host Administration list, select the record whose Virtual Name is SharepointHost.
Set the Name field for this record to the name of your SharePoint portal site. Do not include the
protocol prefix.
For example, if the URL of your SharePoint portal site is at http://sharepoint_server:88 then
enter sharepoint_server:88 in the Name field.
From the Show drop-down list, choose Symbolic URL Administration.
In the Symbolic URL Administration list, select the CollaborationTeamspace record, and make
sure the URL is http://SharepointHost/sites/[ObjectType]_[ROW_ID]/default.aspx
18
Getting Started with Siebel Collaboration Copying the Siebel-SharePoint Integration

Files
Copying the Siebel-SharePoint

Integration Files
There are some files that you need to configure and add to various directories in the SharePoint
server in order to integrate the Siebel and SharePoint applications. These files are in a directory
called Addin on your Siebel Server installation.
This procedure describes copying the files to a directory on your SharePoint server. The files reside
in this holding directory while you unzip and configure them before copying them into their final
locations in the SharePoint installation. (This holding directory is referred to as the Addin directory
on the SharePoint server in the procedures in this chapter.)
To copy the Siebel-SharePoint Integration Files

1
Locate the SiebSrvr\Addin directory in your Siebel Server installation directory.

NOTE: The exact capitalization of this directory is platform dependent. For example, on UNIX
platforms, it is siebsrvr\addin.
Copy the Addin directory and its contents to a new directory on your SharePoint server.
For example, create a directory called IntegrationInstall on the C drive of the SharePoint server
and copy the Addin directory into it. (C:\IntegrationInstall\Addin.)
If your Siebel Server is installed on a platform other than win32, copy the files in binary mode.
Verify that the following directories appear within the Addin directory on the SharePoint server:
sharepoint\config
sharepoint\integrationwebservice
sharepoint\integrationwebservice\bin
sharepoint\template
sharepoint\webparts
sharepoint\webparts\bin
Installing the Siebel Site Definition for

SharePoint
About Site Definitions
SharePoint comes with several site definitions that determine the content and layout of an individual
SharePoint site.
The Siebel site definition is a custom SharePoint site definition. The Siebel site definition was created
by copying an existing SharePoint site definition and then customizing it to display Siebel data.
19
Getting Started with Siebel Collaboration Installing the Siebel Site Definition for
SharePoint
About Themes
The Siebel theme determines the colors and fonts used to display the Siebel site. You need to copy
the Siebel theme files to the appropriate directory on your SharePoint server and edit the SharePoint
SPTHEMES.xml file so that SharePoint application can recognize the Siebel theme.
Procedure
To install the Siebel site definition and theme

1
Locate the Siebeltemplate.exe file in the Addin\sharepoint\template directory on the

SharePoint server.
For example, in the C:\IntegrationInstall\addin\sharepoint\template directory.
Double-click Siebeltemplate.exe and unzip into the same Addin\sharepoint\template directory.
Copy the directory \Siebel:
From the addin\sharepoint\template\1033 directory (on your SharePoint server)
To the local drive:\Program Files\Common Files\Microsoft Shared\web server

extensions\60\TEMPLATE\1033 directory
Copy the file WEBTEMPSIEBEL.xml:
From the addin\sharepoint\template\1033\XML directory (on your SharePoint server)

extensions\60\TEMPLATE\1033\XML directory
Copy the directory \Siebel:
From the addin\sharepoint\template\themes directory

extensions\60\TEMPLATE\THEMES directory
Edit the file SPTHEMES.XML, which is in the local drive:\Program Files\Common

Files\Microsoft Shared\web server extensions\60\TEMPLATE\LAYOUTS\1033, by adding the
following text between the themes for satin and sky:
<Templates>
<TemplateID>siebel</TemplateID>
<DisplayName>Siebel</DisplayName>
<Description>Siebel Specific Theme</Description>
20
Getting Started with Siebel Collaboration Setting Up the Siebel-SharePoint Integration

Web Service
<Thumbnail>../images/thice.png</Thumbnail>
<Preview>../images/thice.gif</Preview>
</Templates>
For example:
Setting Up the Siebel-SharePoint

Integration Web Service
It is the Siebel-SharePoint Integration Web Service which handles the interaction between the Siebel
application and the Sharepoint application.
The following procedure describes how to copy the files you need for the Siebel-SharePoint
Integration Web Service from the Addin directory and how to set up the Integration Web Service as
a Web site on your SharePoint server.
To set up the Siebel-SharePoint Integration Web Service

1
Set up the Siebel-SharePoint Integration directory:
Create a new directory on the SharePoint server to use as the Siebel-SharePoint Integration
directory.
For example, C:\Siebel\SharePointIntegration.
Copy the contents of the \integrationwebservice directory:
From the addin\sharepoint directory (on your SharePoint server)
To the Siebel-SharePoint Integration directory you created in Step a

For example, to C:\Siebel\SharePointIntegration.
Verify that the Siebel-SharePoint Integration directory contains these files and directories:
21
Getting Started with Siebel Collaboration Setting Up the Siebel-SharePoint Integration

Web Service
web.config
bin\SiebelSharePointIntegration.dll
Identify a domain user account in Active Directory to be used by the Siebel-SharePoint

Integration Web Service.
This is the account that the Siebel-SharePoint Integration Web Service runs under in IIS. In
addition, this account is used for accessing the SQL database.
Alternatively, you can create a new domain user account in Active Directory. For example, create
a domain user called SiebelSharePointIntegrationUser.
If your SharePoint application is using a remote SQL Server database (instead of Microsoft SQL
Server 2000 Desktop Engine), give this domain user the role of db_owner for these SQL
databases (which are used by the SharePoint Server):
SPS_Config_db
_SITE
Add the domain user to the IIS_WPG group on the SharePoint server.
This gives the user access to the Siebel-SharePoint Integration Web Service.
In Internet Information Services (IIS), create a new application pool.

For example, create an application pool called SiebelSPInt with these parameters:
Application Pool Id: SiebelSPInt
Application Pool Settings: Use the default settings for new application pool.
In the Identity tab of the Properties window set:
Configurable: selected
User Name: SiebelSharepointIntegrationUser
In Internet Information Services (IIS), create a new Web site that allows anonymous access and
uses the application pool created in Step 5 and the directory in Step 1.
For example, create a Web site with these parameters:
22
Name: Siebel SharePoint Integration
Port: 2330
Home Directory: C:\Siebel\SharePointIntegration
Allow anonymous access: selected
Getting Started with Siebel Collaboration Installing the Siebel Web Part
Application Pool: SiebelSPInt
In this example, after completing the preceding steps, you have created the Siebel-SharePoint
Integration Web Service which has a URI of:
http://sharepoint_server:2330/siebelsharepointintegration.asmx
TIP: Make a note of the URI, you enter it again when Setting Up Inbound and Outbound Web
Services for Siebel Collaboration on page 30.
Installing the Siebel Web Part

Web Part is a Microsoft SharePoint term that refers to a modular unit of information that appears on
a page. In the SharePoint application, a Web Part has a similar function to an applet in the Siebel
application.
The Siebel Web Part is the Web Part that displays data for a specific Siebel object.
This procedure describes how to:
Copy a DLL for the Siebel Web Part into the Web Site directory for the SharePoint portal site
Configure SharePoints web.config file so that the Siebel Web Part is recognized as a safe control
Modify the trust settings in the policy file to give the Siebel Web Part full trust permissions
23
Getting Started with Siebel Collaboration Installing the Siebel Web Part
To install the Siebel Web Part

1
Copy the file SiebelWebParts.dll:
From the addin\sharepoint\webparts\bin directory (on your SharePoint server)
To the local drive:\inetpub\sharepoint_portal_site\bin directory (If the bin directory

does not exist, create it.)
Edit the file web.config that is in the Web Site directory for the SharePoint portal site
(C:\inetpub\sharepoint_portal_site) by adding the following text to the Safe Control group:
<SafeControl Assembly="SiebelWebParts, Version=1.0.0.0, Culture=neutral,
PublicKeyToken=20916967cfa1c936" Namespace="Siebel.WebParts" TypeName="*"
Safe="True"/>
Determine the file name for the policy file used by the SharePoint portal site:
In the web.config file, locate the element trust, and note the value of the level attribute for this
element, for example, WSS_Minimal.
Locate the securityPolicy section and locate the trustLevel element with the attribute whose
name matches the level attribute that you noted in Step a, for example, WSS_Minimal.
Make note of the file name for the policy file.
Edit the policy file that you noted in Step c by adding the following text before the CodeGroup
element for ASP.NET:
TIP: Search for the string PermissionSetName="ASP.Net" to find the ASP.NET code group.
CAUTION: Make sure that the value in the PublicKeyBlob does not contain carriage returns. If it
does, team spaces do not display.
24
Getting Started with Siebel Collaboration Installing Configuration Files for SiebelSharePoint Integration
<CodeGroup
class="UnionCodeGroup"
version="1"
PermissionSetName="FullTrust">
<IMembershipCondition
class="StrongNameMembershipCondition"
version="1"
PublicKeyBlob="002400000480000094000000060200000024000052534131000400000100010093A
41BEFD89921C1E63B058F52B8A10587E2F3376D645EC37F4F341521D235C33984CE67A69347CB102FF
1742FE1058FD109621606E234CC1388D736BC84E2426626AED47A9AC87E3473A483ECF47316D64BB3D
DC7B547E2550E72724F5889F11246B0789B27D6816A2761089D172E16125059F914AA13C595ED38C70
EF6FABB"/>
</CodeGroup>
Installing Configuration Files for SiebelSharePoint Integration

This procedure describes copying and editing these files and importing the registry files:
WebParts.reg and IntegrationWebService.reg. These are registry key files used by the
Siebel Web Part and the Siebel-SharePoint Integration Web Service.
siebelSR.xsl and siebelOpp.xsl. These are XSL stylesheets used to control layout and
formatting properties of the Siebel Web Part for service request and opportunity objects.
Config.xml. This file contains configuration and customization settings used by the SiebelSharePoint Integration Web Service and the Siebel Web Part.
25
Installing and configuring the configuration files

1
Copy the directory \config:
From the addin\sharepoint\config directory (on your SharePoint server)
To the Siebel-SharePoint Integration directory

For example, to C:\Siebel\SharePointIntegration.
Edit the file WebParts.reg that is in the \config directory that you copied in Step 1:
Parameter
Example and Comments
Integration Web Service URI
Service Request XSL File
C:\\Siebel\\SharePointIntegration\\config\\siebelSR.x
sl
Opportunity XSL File
C:\\Siebel\\SharePointIntegration\\config\\siebelOpp.
xsl
EnableEventLogging
Log level for the Siebel Web Part:
1 (to enable log) This is the recommended value.
0 (to disable log)
You can view log entries in the Event Viewer (Application log).
Edit the file IntegrationWebService.reg that is in the \config directory that you copied in Step 1:
Parameter
Value and Comments
Configuration File
C:\\Siebel\\SharePointIntegration\\config\\config.xml
EnableWebServiceEventLog
ging
Log level for the Siebel Web Service:
1 (to enable log)
0 (to disable log) This is the recommended value.
You can view log entries in the Event Viewer (Application log).
Import the two registry files into the registry.

This setting can be verified at HKEY_LOCAL_MACHINE\SOFTWARE\Siebel Systems,
Inc.\Collaboration\Sharepoint.
26
Edit the config.xml file that is in the \config directory that you copied in Step 1:
In the SiebelConnectInfo element, edit these attributes:

Attribute
Suggested Value and Comments
WebServiceURI
Specify the URI for the Siebel inbound Web Service.

The format for this URI is
NOTE: This is the same URI that you enter when Setting Up
Inbound and Outbound Web Services for Siebel Collaboration on
page 30.
Username
Specify Siebel user credentials to access the Siebel application.
Password
MaxSessions
Session tokens are used by the Siebel Web Part to improve

response time when communicating with the Siebel application.
The MaxSessions attribute sets the maximum number of
session tokens that can be stored. Typically, set this number a
little higher than the expected average user load.
For example,
<SiebelConnectInfo WebServiceURI="http://siebel_web_server/CustAppSvcs_enu/
start.swe?SWEExtSource=CustomUI&SWEExtCmd=Execute&WSSOAP=1"
Username="CHANGE_ME" Password="CHANGE_ME" MaxSessions="10" />
27
In the SharepointConfigInfo element, edit these attributes:

Attribute
Suggested Value and Comments
WebServerURI
SharePoint portal site
AdminUsername
The user entered here must be a SharePoint Administrator.

TIP: A SharePoint Administrator is either a member of the
Administrators group on the SharePoint host machine or a
member of the SharePoint Administration group.
You can specify the name with or without the domain. If you do
not specify a domain name, specify it in the Domain attribute.
For example,
AdminUsername="domain\Administrator"
or
AdminUsername="Administrator"
Domain="domain"
AdminPassword
Password for the AdminUsername user.
SecurityToken
Enter the same string that you entered for the SecurityToken in
your Siebel CFG file. (See Editing the Siebel Application CFG File
for Siebel Collaboration on page 15.)
Domain
Use this attribute to specify the domain name. If you did not
specify a domain name with the AdminUsername attribute, this
domain is used.
NOTE: The domain name is case sensitive.
AddSiteToPortalSiteList
Determines if the team space appears in the site list on the

SharePoint portal site. Set to TRUE or FALSE.
MaxConnections
This attribute determines the maximum number of connections

between the Siebel-SharePoint Integration Web Service and
SharePoint. Increasing this value increases memory usage but
can improve speed of integration. Set and adjust the value
according to expected load.
For example,
<SharepointConfigInfo
WebServerURI=http://PortalServer:88
AdminUsername="domain\Administrator"
AdminPassword="sample"
SecurityToken="l5t42j6d9w73"
Domain="domain"
AddSiteToPortalSiteList="TRUE"
MaxConnections="50"/>
28
Edit the UserGroups elements.

The UserGroups identify which users are added as members of a team space and what rights
they are given. You can specify users to be added to all team spaces and users to be added
to those team spaces associated with a particular object. Rights assigned to a user are
specified using SharePoint role identifiers. Users are identified by an ADSI group name or a
user login account on the SharePoint host machine.
Locate the first UserGroups element. This element identifies the users who are added to
all team spaces.
Add a UserGroup element for each user group that you want to have access to all team
spaces. Role is the SharePoint Role identifier, and Login is the login account for the user
on the SharePoint host machine.
<SiebelCollaborationConfig>
....
<UserGroups>
<UserGroup Role="Administrator">
<User Login=" CHANGE_ME" />
</UserGroup>
<UserGroup Role="Contributor">
</UserGroup>
</UserGroups>
....
</SiebelCollaborationConfig>
Locate the UserGroups element contained in the ObjectType elements. This element
identifies the users who are added to team spaces for that object. For example, the
following text shows the UserGroups element for the team spaces associated with service
request objects:
<ObjectTypes>
<ObjectType Type="Service Request" SitePrefix="SR" SiteTemplate="SIEBEL#0"
SiteTheme="SIEBEL" ActiveDays="30" ActiveNewDays="1" UserRole="Contributor">
. . .
<UserGroups>
</UserGroup>
</UserGroups>
<UserGroup Role="Contributor">
</UserGroup>
</UserGroups>
. . .
</ObjectType>
Add a UserGroup element for each user group you want to have access to the team
spaces for the object.
Restart Internet Information Services (IIS).
29
Getting Started with Siebel Collaboration Setting Up Inbound and Outbound Web
Services for Siebel Collaboration
Setting Up Inbound and Outbound Web

Services for Siebel Collaboration
The inbound Web Service specifies the location of the Siebel Server. This inbound Web Service,
named Web Collaboration Service, is a component in the Enterprise Application Integration
component (EAI) group.
The outbound Web Service directs the Siebel application to the Siebel-SharePoint Integration Web
Service, which handles the interaction between the Siebel application and the Sharepoint application.
To set up inbound and outbound Web Services

1
Make sure that the Enterprise Application Integration component group is enabled.
This enables the component Custom Application Object Manager which corresponds to the Web
Collaboration Service, inbound Web Service. For general information about checking your
enterprise and Siebel Server Configurations, see the Siebel System Administration Guide.
Set up the inbound Web Service:
Navigate to Administration - Web Services screen > Inbound Web Services view.
Select the record named Web Collaboration Service.
In the Service Ports list, Address field, enter the path for the Siebel Server.
Make sure that Custom Application Object Manager component is online and running.
NOTE: This is the same URI that you entered when Installing Configuration Files for SiebelSharePoint Integration on page 25.
Set up the outbound Web Service:
In the link bar, click Outbound Web Services.
In the Outbound Web Services list, select the record named SiebelSharePointIntegration.
In the Service Ports list, Address field, enter the URL for your Siebel-SharePoint Integration
Web Service, which you set up in Setting Up the Siebel-SharePoint Integration Web Service
on page 21.
For example, http://sharepoint_server:port/siebelsharepointintegration.asmx
This task completes the process of setting up Siebel Collaboration. After completing this task, see
Chapter 4, Using Siebel Collaboration. Alternatively, if you have problems with your setup, see
Troubleshooting Siebel Collaboration Setup on page 31.
30
Getting Started with Siebel Collaboration Troubleshooting Siebel Collaboration Setup
Troubleshooting Siebel Collaboration

Setup
Sources of Diagnostic Information for Troubleshooting Siebel
Collaboration
You can find information to help you diagnose setup problems with Siebel Collaboration in:
Siebel Server log files:
The log file for the Siebel application, for example, the log file for the Call Center application
contains SCCObjMgr_enu in the file name.
The log file for the Siebel inbound Web Service. This is the log file associated with the Custom
Application Service and contains CustomAppObjMgr in the file name.
For debugging Siebel Collaboration, it is recommended that you set the log level to 5.
For general information about Siebel log files, see the System Monitoring and Diagnostics Guide
for Siebel Business Applications.
The Event Viewer (Application log) on the SharePoint server:

The . . .
Logs Entries with the Event Source of . . .
Siebel Web Part
Siebel Web Part
Siebel-SharePoint Integration Web Service
Siebel SharePoint Integration Web Service
Logging to the Event Viewer is enabled through the registry files as described in Installing
Configuration Files for Siebel-SharePoint Integration on page 25.
If an error occurs in the Siebel application, check the log files on the Siebel Server. If an error occurs
in the team space, check the Event Viewer log. If the log indicates a problem on the Siebel Server,
then check the Siebel Server log also.
31
Refer to Table 5 on page 32 if you have problems with setting up Siebel Collaboration.
Table 5.
Troubleshooting the Siebel Collaboration Setup
Symptom/Error Message
Diagnostic Steps/Causes
In the Siebel application, the

Collaborate and Create Team
Space buttons do not
appear.
Siebel Collaboration is not

enabled in the Siebel
application CFG file.
License key for Siebel

Collaboration has not been
entered.

Team Space column does not
appear.
In the Siebel application,

Collaborate and Team Space
buttons are disabled.
Team Space column is empty
(does not show any icons).
Solution
Confirm that the parameter CollaborationEnabled is

set to TRUE in application CFG file. (See Editing the
Siebel Application CFG File for Siebel Collaboration on
page 15.)
The Internet Explorer browser

cache needs to be cleared.
Confirm that the license key for Collaboration has

been installed. (See Applications Administration
Guide.)
User authentication is not set

correctly.
Clear the Internet Explorer cache. Delete cached

files, all offline content, and objects.
Confirm that UserAuthentication is set to ADSI or

SSO. If set to ADSI, then confirm that the
[LDAPSecAdpt] section is configured correctly. (See
Editing the Siebel Application CFG File for Siebel
Collaboration on page 15.)
The Siebel Server is not

configured correctly with the
Siebel-SharePoint Integration
Web Service.
Confirm the configuration for the Siebel-SharePoint

Integration Web Service. (See Setting Up Inbound
and Outbound Web Services for Siebel Collaboration
on page 30.)
The Siebel application cannot

communicate with the SiebelSharePoint Integration Web
Service on the SharePoint host
machine
Confirm that IIS and the World Wide Web Publishing

Service are running on the SharePoint host machine.
Confirm that the Siebel-SharePoint Integration Web

Service is running.
Confirm that application CFG has been edited

correctly; in particular, make sure that the
SecurityToken in the CFG file matches the
SecurityToken in the config.xml file. (See Editing the
Siebel Application CFG File for Siebel Collaboration on
page 15.)
32
Troubleshooting Reference for Siebel Collaboration Setup
Solution

when a user clicks
Collaborate, the application
displays the message,
Collaboration user ID
cannot be located.
Siebel Collaboration has been

configured for SSO user
authentication and the user has not
been added to the Siebel Servers
SSO Team Space Collaboration
record.
Add the user to the Team Space Collaboration record in

the SSO Systems Administration list. (See Setting Up the
Single Sign-On Table for Siebel Collaboration on page 17.)

when a user clicks
Collaborate, a Windows login
dialog box appears.
The user does not have access

to the SharePoint host
machine.
Confirm that, external to the Siebel application, the

user has login access to the SharePoint host
machine.
The SharePoint host machine

has not be added to the
browser as a local or trusted
site with automatic logon.
Add the SharePoint host machine as a local or trusted

site:

when a user clicks
Collaborate, the team site
page displays an error page
with the message, The
SiebelWebPart Web Part
appears to be causing a
problem.
The Siebel Web Part is incorrectly

configured on the SharePoint
server.
In Internet Explorer, navigate to Tools > Internet

Options > Security.
Add the SharePoint host machine in either the

Local intranet or Trusted sites zone.
For the security level of the zone, set the User

Authentication > Logon setting to Automatic logon
with current username and password.
Confirm that the policy file for the SharePoint portal site
is correctly configured. (See Installing the Siebel Web
Part on page 23.)
33
Table 5.
Solution
The Siebel Web Part displays

the message, Web Part
Error: A Web Part or Web
Form Control on this Web
Part Page cannot be
displayed or imported
because it is not registered
on this site as safe.
The Siebel Web Part is incorrectly

configured on the SharePoint
server.
Confirm that Siebel Web Part has been registered as a

safe control in the web.config file for the SharePoint
portal site. (See Installing the Siebel Web Part on
page 23.)

the message, An
Unexpected Error occurred.
The Siebel Web Part cannot

communicate with the SiebelSharePoint Integration Web
Service.
Confirm that the Siebel-SharePoint Integration Web

Service is running.
Confirm that the URI for the Siebel-SharePoint

Integration Web Service is correctly specified in the
registry. (See Installing Configuration Files for SiebelSharePoint Integration on page 25.)

the message, Unable to
retrieve the Siebel data for
this site.
The Siebel-SharePoint
Integration Web Service cannot
communicate with the Siebel
inbound Web Service.
Confirm that the correct URI for the Siebel inbound

Web Service is specified in the config.xml file. (See
Installing Configuration Files for Siebel-SharePoint
Integration on page 25.)
Integration Web Service is not
configured correctly.
Confirm that the Siebel inbound Web Service is

running. (See Setting Up Inbound and Outbound Web
Services for Siebel Collaboration on page 30.)
Confirm that the correct values are specified in the

registry settings through the WebParts.reg and
IntegrationWebService.reg files; in particular, make
sure that the names for the XSL files are correct.
(See Installing Configuration Files for SiebelSharePoint Integration on page 25.)
34
Table 5.
Solution

any other error message.
The Siebel Web Part is not

Check the Event Viewer (Application log) on the

SharePoint server.
Integration Web Service is not
Integration Web Service cannot
communicate with the Siebel
inbound Web Service.
Confirm that the correct values are specified in the

registry settings through the WebParts.reg and
IntegrationWebService.reg files. (See Installing
Configuration Files for Siebel-SharePoint Integration
on page 25.)
Confirm that the correct URI for the Siebel inbound

Web Service is specified in the config.xml file. (See
Installing Configuration Files for Siebel-SharePoint
Integration on page 25.)
Confirm that the Siebel inbound Web Service is

running. (See Setting Up Inbound and Outbound Web
Services for Siebel Collaboration on page 30.)
35
Table 5.
36
Using Siebel Collaboration
This chapter covers how the end user (such as a sales representative or a technical support engineer)
uses Siebel Collaboration. It includes the following topics:
About Using Siebel Collaboration on page 37
Scenario for Using Siebel Collaboration on page 38
Process of Using Siebel Collaboration on page 39
Creating Team Spaces on page 39
Viewing Team Spaces Within the Siebel Application on page 40
Viewing Team Spaces Without the Siebel Application on page 40
About Using Siebel Collaboration

Users create and access team spaces for individual opportunity and service request records.
About the Team Space Field

The Team Space field appears in the Opportunities and Service Request list views (Figure 2 on
page 37).
Team Space field
Figure 2.
Team Space Field in the Opportunities List View
37
Using Siebel Collaboration Scenario for Using Siebel Collaboration
The icon in the field indicates whether or not a team space exists for the record. See Table 6 on
page 38 for information about the icons that appear in the Team Space field.
Table 6.
The Team Space Field in the Opportunities and Service Requests List Views
An Icon Like
This . . .
Indicates That, for This Record, . . .

No team space exists, or the team space is not available.
A team space has been created or modified within the past day. This is an
active-new team space.
A team space has not been modified within the past 2-30 days. The team
space is still considered to be active.
A team space has not been modified for over 30 days. This is an inactive
team space.
About the Membership List for the Team Space

There are several ways that users can become members of a team space:
Those Siebel users who belong to the sales team (opportunities) or account team (service
requests) automatically become members when the team space is created.
Other Siebel users become team space members when they click the Create Team Space or
Collaborate buttons for the first time.
By being named in the User Group entries in the Siebel-SharePoint Integration Web Services
config.xml file.
Scenario for Using Siebel Collaboration

A sales representative is working on an opportunity. He receives an RFP (request for proposal) for
the opportunity. The sales representative does not have the technical expertise to prepare the
proposal himself. In fact, no single person in his company has all the answers. In order to
successfully prepare the proposal, the sales representative needs the help of other company
employees: some in the engineering department, others in the technical services center, and still
others in his own sales force.
He creates a team space associated with the opportunity. The basic information about the
opportunity (such as name, account, and description) appear in the team space. The other members
of the sales team automatically become members of the team space. He adds, as members, other
individuals in the company who he thinks can help him with the RFP.
The team space becomes the central repository for all information related to the RFP:
38
Using Siebel Collaboration Process of Using Siebel Collaboration
Discussions give visibility and can capture ongoing conversation taking place around the
opportunity. Employees brought in midstream can read the discussions to update themselves
about the status of the opportunity.
The documents section is used for posting technical documents and for drafts of sections of the
RFP; document check-out prevents shared files from getting overwritten.
The task list helps to make sure that everything is done on time.
The online presence indicator makes it easy to use instant messaging and get answers fast.
The sales team access the team space from within their Siebel application. Others, such as the
engineers who do not have access to the Siebel application, access the team space from their Sites
pagein the same way that they access their other SharePoint sites.
Process of Using Siebel Collaboration

To create and use team spaces for collaboration, perform the following tasks:
Creating Team Spaces on page 39
Viewing Team Spaces Within the Siebel Application on page 40
Viewing Team Spaces Without the Siebel Application on page 40
Creating Team Spaces

Siebel users can create team spaces associated with individual opportunity and service request
records. Any user with visibility to the record can create a team space for the record.
Ownership of the team space is determined as follows:
For opportunity records, the creator of the opportunity record becomes the owner of the team
space.
For service request records, the owner of the service request record becomes the owner of the
team space.
This task is a step in Process of Using Siebel Collaboration on page 39.
To create a team space

1
Navigate to one of the following views:
Opportunities screen > List view
Service Requests screen > Service Request List view
Select a record where the Team Space field shows a grey icon.
The grey icon indicates that a team space has not yet been created for the record.
Click Create Team Space.

This action:
39
Using Siebel Collaboration Viewing Team Spaces Within the Siebel Application
Creates a team space
Creates a membership list for the team space
Sets the Team Space field to show a green icon
Click Collaborate.
This action opens the team space.
Use the SharePoint interface to create additional members, start discussion threads, post
documents, and assign action items.
See the Microsoft Office SharePoint Help system for general information about how to use the
SharePoint application.
Viewing Team Spaces Within the Siebel

Application
Users with access to the Siebel application can navigate to team spaces through the Siebel UI. When
they view opportunity or service request records, the Team Space field indicates if there is a team
space associated with the record and if it has recently been updated.
To view a team space that is associated with a record

1
Navigate to one of the following views:
Opportunities screen > List view
Service Requests screen > Service Request List view
Select a record where the Team Space field shows a green icon.
The green icon indicates that a team space exists for the record.
Click Collaborate.
See the Microsoft Office SharePoint Help system for general information on how to use the
SharePoint application.
Viewing Team Spaces Without the Siebel

Application
Users who do not have access to the Siebel application can access team spaces in the same way that
they access their other SharePoint sites.
To view a team space without the Siebel application

1
Browse to the SharePoint portal site and navigate to the Sites page.
Click on the team space site.
40
Configuring Siebel Collaboration
This chapter covers how to configure Siebel Collaboration using Siebel Tools and the config.xml file.
It includes the following topics:
About Configuring Siebel Collaboration on page 41
Scenario for Configuring Siebel Collaboration on page 41
Process of Configuring Siebel Collaboration on page 42
Changing the Number of Days That Determine the Status of the Team Space on page 42
Changing the Look and Feel of the Team Space Pages on page 43
Hiding and Showing the Navigation Bars on Team Space Pages on page 44
Configuring the Siebel Web Part for Team Spaces on page 47
Configuring Membership Lists for Team Spaces on page 48
Changing the Cache Setting for Siebel Collaboration on page 50
Extending Siebel Collaboration for Additional Siebel Objects on page 51
Configuring Siebel Collaboration for Another Language on page 59
About Configuring Siebel Collaboration

Both SharePoint and Siebel applications are highly configurable. Other chapters in this guide describe
how to set up and use Siebel Collaboration out-of-the-box. Once you are familiar with this
preconfigured functionality, you can configure Siebel Collaboration to more exactly address your
businesss needs.
Proficiency with both SharePoint and Siebel configuration is required to carry out the tasks in this
chapter.
Scenario for Configuring Siebel

Collaboration
A company is using Siebel Collaboration for opportunities. The IT group wants to make a variety of
changes to the configuration to tailor the functionality to address the companys specific business
needs.
They decide to:
Change the number of days that determine whether a team space is marked as new, active, or
inactive.
41
Configuring Siebel Collaboration Process of Configuring Siebel Collaboration
Change who gets automatically added to the team space when the team space is created. They
want to give a team from the finance and legal departments visibility to all team spaces created
for opportunities.
Change the appearance of some of the pages in response to user feedback.
Edit the Siebel Web Part to include the anticipated close date for the opportunity.
Improve display performance of the Opportunities List view by implementing caching for the
team space icon.
Enable team spaces for accounts.
Configure Siebel Collaboration for other languages so that it can be rolled out to the companys
international offices where the Siebel application is localized.
Process of Configuring Siebel

Collaboration
Process below reflects the scenario. You can pick and choose which of these tasks you want to do,
based on your business needs.
To configure Siebel Collaboration, perform the following tasks:
Changing the Number of Days That Determine the Status of the Team Space on page 42
Changing the Look and Feel of the Team Space Pages on page 43
Hiding and Showing the Navigation Bars on Team Space Pages on page 44
Changing the Cache Setting for Siebel Collaboration on page 50
Extending Siebel Collaboration for Additional Siebel Objects on page 51
Configuring Siebel Collaboration for Another Language on page 59
If you make configuration changes to files or registry settings on the SharePoint server, restart
Internet Information Services (IIS) in order for the changes to take effect.
Changing the Number of Days That

Determine the Status of the Team Space
The color of the icon in the Team Space field in the Opportunity and Service Request list views
indicates:
Whether or not a team space exists for the record
And, if a team space does exist, how recently it has been modified
42
Configuring Siebel Collaboration Changing the Look and Feel of the Team Space Pages
For general information about the Team Space field, see About Using Siebel Collaboration on
page 37.
This task is a step in Process of Configuring Siebel Collaboration on page 42.
To configure the number of days that determine the team space status
1
Open the config.xml file in the Siebel-SharePoint Integration\config directory.

For example, C:\Siebel\SharePointIntegration\config\config.xml
Locate the Object Type element for the object you want to configure: for example, Opportunity
or Service Request.
Edit the ActiveDays and ActiveNewDays attributes for the object.

For example, if you edit the Service Request object as follows (setting ActiveDays to 45 and
ActiveNewDays to 2), then team spaces are indicated as active-new if they have been created or
updated within the last two days. Team spaces are indicated as inactive if they have not been
updated within the last 45 days.
<ObjectTypes>
Changing the Look and Feel of the Team

Space Pages
You can change the look and feel of the team space pages by editing the Siebel site definition and
theme files in the same way that you edit site definition and theme files for other SharePoint sites.
To change the look and feel of the team space

1
Edit the Siebel site definition files in the SharePoint Services Web Service Extension
Directory, C:\Program Files\Common Files\Microsoft Shared\web server
extensions\60\TEMPLATE\1033 directory.
Edit the Siebel theme files in the SharePoint Services Web Service Extension Directory,
C:\Program Files\Common Files\Microsoft Shared\web server

extensions\60\TEMPLATE\THEMES directory.
43
Configuring Siebel Collaboration Hiding and Showing the Navigation Bars on Team
Space Pages
Hiding and Showing the Navigation Bars

on Team Space Pages
ASPX pages in the Siebel site definition are modified so that when a page is viewed from within the
Siebel application, those menu items that normally appear in the SharePoint top navigation bar
appear in the left navigation bar. (See Figure 3 on page 44 and Figure 4 on page 45.) This is to make
better use of the limited window height within the Siebel application.
NOTE: The Siebel left navigation bar does not appear in the team space home page.
Siebel left navigation bar
Figure 3.
44
Sample Page Displayed Within the Siebel Application
Space Pages
SharePoint top navigation bar
Figure 4.
Sample Page Displayed Directly from SharePoint Application
These navigation bar modifications were only made to the ASPX pages within the Siebel site
definition. If you want to apply navigation bar modifications for pages in the LAYOUTS directory, to
hide the SharePoint top navigation bar within the Siebel application, see the following procedure.
CAUTION: Pages in the LAYOUTS directory are not part of the Siebel site definition. Any changes to
these pages may be lost when updates, Service Packs, or version upgrades are applied to the
SharePoint installation. Before you edit these pages, refer to the SharePoint documentation for
general information about making changes to pages in the LAYOUTS directory.
For information about making navigation bar modifications to ASPX pages in the LISTS directory of
the Siebel site definition, see Configuring Siebel Collaboration for Another Language on page 59.
To hide the SharePoint top navigation bar for pages displayed in the Siebel
application
1
Open the ASPX file (contained in a subdirectory of the SharePoint Services Web Service
Extension Directory\Template\LAYOUTS directory).
Wrap this pair of tags around the Web Part for the SharePoint top navigation bar:
45
Space Pages
<SIEBEL:HideDataInSiebelApp runat=server> . . . </SIEBEL:HideDataInSiebelApp>

The SharePoint top navigation bar Web Part is coded differently in different SharePoint templates.
Refer to this table to determine where to place the <SIEBEL... tags.
If the Template...
Then Wrap the <SIEBEL... Tag Around this Set of Tags in the File:
Contains the
pattern
<SPSWC:TopPageSection . . . </SPSWC:TopPageSection>
SPSWC:CategoryNav
igationWebPart
Contains the
pattern
SharePoint:Portal
Connection
is
layouts/1033/
PortalHeader.aspx
is
For example:
<SIEBEL:HideDataInSiebelApp runat=server><SPSWC:TopPageSection
runat="server">
<SPSWC:PageHeader id="PageHeader" runat="server"
TitleLocId="AudienceAdminMain_PageTitle_Text" HelpID="ManageAudiences" />
<div class="ms-phnav1wrapper ms-navframe"> <SPSWC:CategoryNavigationWebPart
runat="server" id="HorizontalNavBar" DisplayStyle="HorizontalOneLayer" />
</div>
</SPSWC:TopPageSection> </SIEBEL:HideDataInSiebelApp>
<tr> ... </tr> found after the text AlternateHeader

For example:
if (alternateHeader == null || alternateHeader == "")
{
%>
<SIEBEL:HideDataInSiebelApp runat=server>
<TR>
<TD COLSPAN=3 WIDTH=100%>  <table class="ms-bannerframe"
border="0" cellspacing="0" cellpadding="0" width="100%"> <tr> <td nowrap
valign="middle"><img ID=onetidHeadbnnr0 alt="Logo" src="/_layouts/images/
logo.gif"> </td>
<td class=ms-banner width=99% nowrap ID="HBN100" valign="middle">  <SharePoint:Navigation LinkBarId="1002"
runat="server"/> </td>
<td class=ms-banner> </td>
<td nowrap class=ms-banner style="padding-right: 7px">
<SharePoint:PortalConnection runat="server" /> </td>
</tr></table></TD>
</TR>
</SIEBEL:HideDataInSiebelApp>
<SPSWC:CategoryNavigationWebPart . . .
</SPSWC:CategoryNavigationWebPart>
<SPSWC:PersonalSpaceNavigation HelpID="MySite" runat="server"/>
layouts/1033/
QuickLinks.aspx
TIP: You can use these <SIEBEL... tags to configure other HTML to only appear when the page
is viewed directly in the SharePoint application.
46
Configuring Siebel Collaboration Configuring the Siebel Web Part for Team Spaces
Configuring the Siebel Web Part for

Team Spaces
There are two kinds of changes that you can make to the Siebel Web Part. You can change:
Which fields from the opportunity or service request records are displayed in the team spaces
The layout and formatting of the Siebel Web Part
The ObjectType element in the config.xml file determines which fields from the objects business
component can appear in the Siebel Web Part.
The siebelSR.xsl and siebelOpp.xsl files determine the layout and formatting of the service request
data and the opportunity data in the Siebel Web Part. (The colors and fonts come from CSS style
sheets referenced in the ASPX pages.) After you add or delete fields from the config.xml file, you
need to make the corresponding changes to the XSL file; each field must be referenced in both files,
otherwise they do not appear in the Siebel Web Part.
To add or delete fields from the Siebel Web Part

1
Open the config.xml file in the Siebel-SharePoint Integration\config directory.

Locate the ObjectType element for the Web Part object you want to change (Opportunity or
Service Request).
Add or delete Field elements as necessary. When you add a field, the name of the field must
match the name of the field in the business component.
For example, to add the Area field and delete the Account field from the Service Request Web
Part, edit the config.xml file by adding the bold text and deleting the italic text from the Service
Request object.
<ObjectType Type="Service Request" SitePrefix="SR" SiteTemplate="SIEBEL#0" SiteTheme="SIEBEL"
ActiveDays="30" ActiveNewDays="1" UserRole="Contributor">
<Name>
<LocaleText lcid="1033" text="Service Request" />
</Name>
<SiteGroup Role="Contributor">
<LocaleText lcid="1033" text="Siebel Users" />
</SiteGroup>
<UserGroups>
<User Login="CHANGE_ME (or delete user groups element)" />
</UserGroup>
</UserGroups>
<Fields>
<Field name="SR Number">
<LocaleText lcid="1033" text="Service Request #" />
</Field>
<Field name="Abstract">
<LocaleText lcid="1033" text="Summary" />
</Field>
<Field name="Description">
<LocaleText lcid="1033" text="Description" />
</Field>
<Field name="Account">
47
Configuring Siebel Collaboration Configuring Membership Lists for Team Spaces
<LocaleText lcid="1033" text="Account" />

</Field>
<Field name="Area">
<LocaleText lcid="1033" text="SR Area" />
</Field>
<Field name="Status">
<LocaleText lcid="1033" text="Status" />
</Field>
</Fields>
</ObjectType>
Open the XSL file corresponding to the object you are modifying.
For example, for the service request object, open the file
C:\Siebel\SharePointIntegration\config\SiebelSR.xsl
Add or delete Field elements as necessary to match the changes you made in Step 3.
For example,
<xsl:template match="/SiebelCollaboration/FieldList">
<xsl:apply-templates select="Field[@Name='SR Number']" />
<xsl:apply-templates select="Field[@Name='Abstract']" />
<xsl:apply-templates select="Field[@Name='Description']" />
<xsl:apply-templates select="Field[@Name='Status']" />
<xsl:apply-templates select="Field[@Name='Area']" />
<xsl:apply-templates select="Field[@Name='Account']" />

</xsl:template>
To edit the formatting and layout in the Siebel Web Part

1
Open the XSL file for the Siebel Web Part in the Siebel-SharePoint Integration\config
directory.
For example, C:\Siebel\SharePointIntegration\config\SiebelSR.xsl
Edit the file; use standard XSL syntax to modify the XSL file.
The XML that the XSL manipulates has the following format:
<SiebelCollaboration>
<FieldList>
<Field Name="Area">
<Value>Help Desk<Value>
<Caption>SR Area</Caption>
</Field>
<Field Name="Abstract">
<Value>Printer isn't working<Value>
<Caption>Summary</Caption>
</Field>
<Field>
. . .
</SiebelCollaboration>
Configuring Membership Lists for Team

Spaces
There are two areas where you can configure who becomes a member of the team spaces:
48
The config.xml file:
Configuring Siebel Collaboration Configuring Membership Lists for Team Spaces
You can edit this file to change which users are added each time a team space is created.
You can edit this file to determine what rights users have (for example, Reader, Contributor,
Administrator).
Siebel Tools:
The CollaborationField:Owner user property on the Opportunity and Service Request

business components determines which Siebel user becomes the team spaces owner.
The business components called Opportunity Teamspace Members and Service Request
Teamspace Members represent the Siebel users who become members when the team space
is created: you can create new business components that return different lists of Siebel
users, and substitute your new business components for the Opportunity Teamspace
Members and Service Request Teamspace Members business components supplied.
To edit the config.xml file to configure team space membership

1
Open the file config.xml in the Siebel-SharePoint Integration\config directory.

Edit UserGroup elements and UserRole elements as required.
For example, the text added here in bold gives Reader rights to the Finance user group for
all team spaces created for opportunity records.
<ObjectType Type="Opportunity" SitePrefix="SR" SiteTemplate="SIEBEL#0"
. . .
<UserGroups>
<User Login="OpptyAdmin"/>
</UserGroup>
<UserGroup Role="Reader">
<User Login="FinsGroup"/>
</UserGroup>
</UserGroups>
For example, the text edited here in bold gives Web Designer rights to new owners of team
spaces based on service requests.
SiteTheme="SIEBEL" ActiveDays="30" ActiveNewDays="1" UserRole="Web Designer">
Related Topic
To change which Siebel user becomes the owner of team space upon creation
1
Locate one of the following business components:
49
Configuring Siebel Collaboration Changing the Cache Setting for Siebel Collaboration
Opportunity
Service Request
Edit the CollaborationField:Owner user property.

Change the value of the user property to the name of the field that contains a Siebel user. This
field determines which Siebel user becomes the owner when a new team space is created.
To change which Siebel users become members of new team spaces

1
Locate one of the following business components:
Opportunity Teamspace Members
Service Request Teamspace Members
These business components represent the Siebel users who automatically become members of
the team space. In the preconfigured application, this is the sales team or account team
members.
Replace the business component with a new business component that you create yourself and
which returns the list of Siebel users that you want to automatically become members of the
team space.
Make the name of the new business component the same as the original business component
(Object Type Teamspace Members) that you are replacing.
Make sure that your business component contains these fields:
Field
Comments
Login
The LOGIN column from the S_USER table, representing the users who are to
be added as team space members.
Object Id
The row ID of the primary business component (the object for which the team
space is being created).
Changing the Cache Setting for Siebel

Collaboration
The CFG files contain configuration settings for caching the team space status on Siebel Server.
You can improve display performance for your Siebel application by setting up caching for the team
space icons. Without caching, each time the list applet containing the Team Space field is rendered,
the Siebel application has to query the SharePoint Portal Server to determine the status of each team
space. Caching the team space status makes subsequent pages display faster.
50
Configuring Siebel Collaboration Extending Siebel Collaboration for Additional Siebel

Objects
To set up caching for Siebel Collaboration

1
Open the CFG file for the application and, if the file does not already contain a [Collaboration
Teamspace Existence Cache] section, add this one:
;; This section is for collaboration teamspace existence cache parameters
[Collaboration Teamspace Existence Cache]
MaxItems
= 1000
ItemTimeout
= 300
;; Object specific unique cache identifier
Opportunity Cache Key
= OP
Service Request Cache Key = SR
Edit the [Collaboration] section if necessary.

The parameters are described in the following table.
Parameter
Comments
MaxItems
Determines the number of team-space icon existence states that

can be cached in a user session.
ItemTimeout
The cache is invalidated after this many seconds.
Opportunity Request
Cache Key
This key is used as a cache key for object Opportunity.
Service Request Cache

Key
This key is used as a cache key for object Service Request.
If you have extended Siebel Collaboration for additional Siebel objects, such as accounts, add a
unique cache key parameter to the section.
Keep this string short (two letters), for example:
Account Cache Key
= AC
Extending Siebel Collaboration for

Additional Siebel Objects
In the preconfigured Siebel application, Siebel Collaboration is enabled for the Opportunity and the
Service Request objects. You can configure other Siebel objects to be enabled for Siebel
Collaboration.
The final result is:
A new Collaboration business object which contains two business components:
A primary business component, representing the Siebel object that you want to configure (for
example, Account)
51

Objects
A team space business component, representing the Siebel users who automatically become
members of a new team space.
NOTE: You can omit this business component. Without this business component, the team
space owner is the only Siebel user automatically made a member of the team space. The
owner then invites the other members.
A new view and applet setup to display the team space within the Siebel application.
On the SharePoint side, an updated config.xml file and a new XSL file configured to include the
new object.
Object Requirements
Only business objects that meet these requirements can be enabled for Siebel Collaboration:
The primary business component must use the class CSSBCBase or a class derived from
CSSBCBase
The applet used must:
Be a list applet
Use the class CSSFrameList or a class derived from the CSSFrameList class
Two Part Task

This task is a step inProcess of Configuring Siebel Collaboration on page 42. It involves two
procedures:
The first procedure is carried out in Siebel Tools. (See Siebel Tools Procedure on page 52.)
The second procedure is carried out on the SharePoint server. (See SharePoint Procedure on
page 57.)
Siebel Tools Procedure

This procedure outlines the steps you carry out in Siebel Tools. Throughout this procedure, the
example is enabling accounts for Siebel Collaboration.
TIP: Review the Opportunity or Service Request configuration, and use it as a guide as you extend
Siebel Collaboration for other objects.
To extend Siebel Collaboration to other Siebel objects: Siebel Tools part

1
Identify the business component and the applet that you want to configure, making sure that the
preceding requirements are met.
For example, the Account business component is based on the CSSBCBase class and the Account
List Applet is based on the CSSFrameList class.
52

Objects
Add these three fields to the primary business component.

Name
Calculated
Calculated Value
Comments
TeamspaceExi
stenceState
TRUE
TeamspaceNone
This calculated field has possible values

of TeamspaceActive,
TeamspaceInactive, TeamspaceNone,
and TeamspaceActiveNew.
TeamspaceSy
mbolicURL
TRUE
Collaboration
Teamspace
This calculated field indicates the

symbolic URL for the team space.
TeamspaceObj
ectType
TRUE
Abbreviation of
Object Type
This text is added to the team space's

URL to indicate what kind of object the
team space is based on. This text should
be the same as the SitePrefix you enter
in Step 2 on page 57.
For example, Acc
Add these three user properties to the primary business component:

User Property Name
Value
Comments
CollaborationField:Description
A description field
This field indicates the

business component field that
provides the description for the
site.
For example, Description
CollaborationField:Owner
A user login field

For example, Primary
Employee Login
CollaborationField:Title
Object name
For example, Name

business component field
representing owner for the
team space.
business component field that
provides the title for the team
space.
Configure the list applet (for example, the Account List Applet) by adding the column that
displays the team space icon and the buttons for Collaborate and Create Team Space:
Add the following column to the list applet.

Attribute
Value
Name
TeamspaceExistenceState
Field
TeamspaceExistenceState
Available
TRUE
Display Name
Team Space
Display Name - String Reference
SBL_COLLABORATION_TEAM_SPACE_HOR
53

Objects
Value
HTML Display Mode
EncodeData
HTML Icon Map
TeamspaceState
HTML List Edit
TRUE
HTML Row Sensitive
TRUE
HTML Type
ImageButton
Read Only
TRUE
Text Alignment
Left
Type
TextBox
Show in List
TRUE
Width
20
Text Alignment-Label
Right
Add this column to the list applets Edit List template.
Add the following two controls to the list applet:
54
Attribute
Attribute
Value for Control 1
Value for Control 2
Name
CreateTeamSpace
Collaborate
Caption
Create Team Space
Collaborate
Caption - String
Reference
SBL_COLLABORATION_CREATE_
TEAM_SPACE_HOR
SBL_COLLABORATE1004224858-039
Height
10
10
HTML Display Mode
DontEncodeData
DontEncodeData
HTML Only
TRUE
TRUE
HTML Type
MiniButton
MiniButton
Method Invoked
CreateTeamSpace
Collaboration
Tab Stop
TRUE
TRUE
Text Alignment
Left
Left
Type
TextBox
TextBox
Visible
TRUE
TRUE
Add the two controls to the toolbar on the list applets Edit List template.

Objects
Add following applet user properties to the list applet.

User Property
Name
Value
Comments
CollaborationView
Object Teamspace View
This is the view used for

collaboration. See Step 8 on
page 56.
For example, Account Teamspace

View
CollaborationApplet
Object Teamspace Applet

For example, Account Teamspace
Applet
This is the applet used to support

the symbolic URL for the team
space. See Step 6 on page 56.
(Optional) If you want to have some Siebel users (in addition to the team spaces owner)
automatically become members of newly created team space, then create the Teamspace
Members business component as follows:
Identify which users you want to have added as members when a team space is created.
Create a business component that represents these users and name it Object Teamspace
Members.
Make sure that your business component contains these fields:

Field
Comments
Login
The LOGIN column from the S_USER table, representing the users who are to
be added as team space members.
Object Id
The row ID of the primary business component (the object for which the team
space is being created).
For example, create a business component called Account Teamspace Members that
represents the account team.
Create a link between the new Object Teamspace Members business component and your
primary business component.
For example, create a link between the Account Teamspace Members business component
and the Account business component as follows:
Attribute Name
Value
Name
Account/Account Teamspace Members
Parent Business Component
Account
Child Business Component
Account Teamspace Members
Source Field
Leave blank
55

Objects
Attribute Name
Value
Destination Field
Object Id
Cascade Delete
None
Create the applet to display the team space:
Copy the Service Request Teamspace Applet and rename it Object Teamspace Applet (for
example, Account Teamspace Applet).
Change the Business Component property from Service Request to Object (for example,
Account).
Create and configure the Collaboration business object:
Create a new business object and name it Collaboration Object, for example, Collaboration
Account.
Add the primary business component, for example Account. Make sure to indicate that this is the
primary business component for the object.
(Optional) Add the Teamspace Members business component, for example Account Teamspace
Members.
Create and configure the collaboration view; this is the view that will contain the Teamspace
Applet that you created in Step 6 on page 56:
Copy the Service Request Teamspace View and rename it Object Teamspace View, for example
Account Teamspace View.
Change its Business Object property from Service Request to Object, for example, Account.
Change the properties for the view web template item as follows:
Attribute
Value
Name

For example, Account Teamspace Applet
Applet
change the Visibility Applet attribute for the view to Object Teamspace Applet, for example
Account Teamspace Applet.
Add the Object Teamspace View in the required screen as an Aggregate View type with an
appropriate sequence number; set Display In Page and Display In Site Map to FALSE.
(Do not specify any labels or parent category.)
Add this view to the appropriate responsibilities.
Related Topic
56

Objects
SharePoint Procedure
This procedure outlines the steps you carry out on the SharePoint Portal Server to edit the config.xml
file, XSL file, and registry to accommodate a new object. Throughout this procedure, the example is
enabling accounts for Siebel Collaboration.
TIP: Review the Opportunity or Service Request configuration, and use it as a guide as you extend
Siebel Collaboration for other objects.
To extend Siebel Collaboration to other Siebel objects: SharePoint part

1
Open the file config.xml in the Siebel-SharePoint Integration\config directory.

Add a new ObjectType element the ObjectTypes element to describe your new object. Make sure
that you:
Create a field element for each of the data fields that you want to display in the Siebel Web
Part.
Set the SitePrefix to the same text that you entered for TeamspaceObjectType in Step 2 on
page 53.
TIP: Copy and edit one of the existing ObjectType elements in the file.
For example, an ObjectType for accounts:
<ObjectType
Type="Account"
SitePrefix="Acc"
SiteTemplate="SIEBEL#0"
ActiveNewDays="0"
ActiveDays="30"
UserRole="Contributor">
<Name>
<LocaleText lcid="1033" text="Account"/>
</Name>
<SiteGroup Role="Contributor">
<LocaleText lcid="1033" text="Siebel Users"/>
</SiteGroup>
<Fields>
<Field name="Id">
<LocaleText lcid="1033" text="Account #'"/>
</Field>
<Field name="Name">
<LocaleText lcid="1033" text="Name"/>
</Field>
<Field name="Type">
<LocaleText lcid="1033" text="Type"/>
</Field>
<Field name="Account Status">
<LocaleText lcid="1033" text="Account Status"/>
57

Objects
</Field>
<Field name="Description">
<LocaleText lcid="1033" text="Description"/>
</Field>
</Fields>
</ObjectType>
Create a new XSL file for the object:
Copy the SiebelSR.xsl file and rename it SiebelObject.xsl, for example, SiebelAccount.xsl.
Locate the SiebelSR.xsl file in the Siebel-SharePoint Integration\config directory. (For
example, C:\Siebel\SharePointIntegration\config\SiebelSR.xsl)
Modify the <xsl:template match="/SiebelCollaboration/FieldList" > section of the new XSL

file to reference the data fields that you added in Step 2 on page 57.
For example, a template for accounts looks like this:
<xsl:template match="/SiebelCollaboration/FieldList" >
<xsl:apply-templates select="Field[@Name='Id']" />
<xsl:apply-templates select="Field[@Name='Name']" />
<xsl:apply-templates select="Field[@Name='Type']" />
<xsl:apply-templates select="Field[@Name='Account Status']"
<xsl:apply-templates select="Field[@Name='Description']" />
</xsl:template>
/>
NOTE: The @Name value is the name of the field used by the business component.
Create and run a registry entry to specify the location of the new SiebelObject.xsl file:
Create a new string type registry entry file.

TIP: Copy and edit the WebParts.reg (in the Siebel-SharePoint Integration
directory\config directory).
The registry entry must be named ObjectType XSL File, where ObjectType is the Type
attribute in the ObjectType element of the config.xml file.
For example, for accounts, the registry entry looks like this:
[HKEY_LOCAL_MACHINE\SOFTWARE\Siebel Systems, Inc.\Collaboration\Sharepoint]
"Account XSL File"="C:\\Siebel\SharePointIntegration\\config\\SiebelAccount.xsl"
Execute the registry file.
Related Topics
58
Configuring Siebel Collaboration Configuring Siebel Collaboration for Another Language
Configuring Siebel Collaboration for

Another Language
In the preconfigured application, Siebel Collaboration is configured for U.S. English (ENU). After you
have set up the Siebel site definition for ENU as described in Chapter 3, Getting Started with Siebel
Collaboration, you can configure the Siebel site definition for other languages.
The following procedure provides some information about configuring Siebel Collaboration for other
languages. The steps involve:
Downloading the SharePoint language pack for the new language from Microsoft
Copying the STS site definition that is provided in the language pack
Customizing the copied site definition to be the Siebel site definition in the new language
Adding elements for the new language to the config.xml file
To configure Siebel Collaboration in another language

1
Create the base Siebel site definition in the new language:
Download and install the Microsoft Windows SharePoint Services Language Template Pack for the
new language.
http://www.microsoft.com/downloads/details.aspx?FamilyID=E7EEC77D-4365-4B66-8E8D9D079C509679&displaylang=en
The installer places the new language template pack in a folder called SharePoint Services
Web Service Extension Directory\Template\lcid (where lcid is the language identifier
(ID) associated with the language). For example, C:\Program Files\Common
Files\Microsoft Shared\Web Server Extensions\60\Template\1036
Make a copy of the STS directory and rename it SIEBEL. (Use all capital letters to name the
folder.)
Source: SharePoint Services Web Service Extension Directory\Template\lcid\STS
Destination: SharePoint Services Web Service Extension

Directory\Template\lcid\SIEBEL
Copy the file WEBTEMPSIEBEL.xml:
From the SharePoint Services Web Service Extension Directory\TEMPLATE\1033\XML

directory
To the SharePoint Services Web Service Extension Directory\TEMPLATE\lcid\XML

directory
Copy the file default.aspx:
From the SharePoint Services Web Service Extension

Directory\TEMPLATE\1033\SIEBEL directory
59
To the SharePoint Services Web Service Extension Directory\TEMPLATE\lcid\SIEBEL

directory
Localize the default.aspx file (copied from the Siebel ENU site definition) by replacing lines from
the default.aspx file in the lcid STS site definition:
Edit the file default.aspx, which is in the SharePoint Services Web Service Extension
Directory\TEMPLATE\lcid\SIEBEL directory, by copying lines from the version of the
default.aspx that is in the STS directory (SharePoint Services Web Service Extension
Directory\Template\lcid\STS) and pasting them into the default.aspx file in the SIEBEL
directory.
Replace the Line

Containing the . . .
The Line Looks Like This . . .
Locale id

html element
<html dir="ltr" xmlns:v="urn:schemas-microsoft-com:vml"

xmlns:o="urn:schemas-microsoft-com:office:office">
Title element
<Title ID=onetidTitle>Home - <SharePoint:ProjectProperty

Property="Title" runat="server"/></Title>
TD element that
contains the logo
<td nowrap valign="middle"><img ID=onetidHeadbnnr0

alt="Logo" src="/_layouts/images/dws.gif"></td>
tr element that contains

the HTML for displaying
the site name.


<tr> <td colspan=3 class="ms-titleareaframe"> <div
class="ms-titleareaframe">
Edit the file WEBTEMPSIEBEL.XML, which is in SharePoint Services Web Service Extension
Directory\TEMPLATE\lcid\XML directory:
For each of the Configuration elements, translate the strings in the Title and Description
attributes.
Edit the file ONET.XML, which is in the SharePoint Services Web Service Extension
Directory\TEMPLATE\lcid\SIEBEL\XML directory:
TIP: For Step a, Step c, and Step e, you can also copy the text from the ONET.XML file for the
U.S. English site definition (SharePoint Services Web Service Extension
Directory\TEMPLATE\1033\SIEBEL\XML\ONET.XML).
Add the following text into the NavBars element in the NavBars section (this text defines the
Siebel navigation bar):
<NavBar Name="Siebel Navbar" Prefix="<TABLE style='padding-top: 8px' class=msnavframe CELLPADDING=0 CELLSPACING=0 BORDER=0 width=100%> <TR> <TD
valign=top width=4px><IMG SRC='/_layouts/images/blank.gif' width=1
height=1 alt=''></TD> <TD valign=top class=ms-viewselect>
<TABLE style='margin-left: 3px' width=115px cellpadding=0 cellspacing=2
BORDER=0> <TR><TD width=100%>Team Space</TD></TR>
<TR><TD class='ms-navline'><IMG SRC='/_layouts/images/blank.gif'
width=1 height=1 alt=''></TD></TR> </TABLE> <table
border=0 cellpadding=4 cellspacing=0>"
60
Body="<tr><td><table border=0 cellpadding=0

cellspacing=0><tr><td><img src='/_layouts/images/blank.gif'
ID='100' alt='Icon' border=0> </td><td valign=top><a
ID=onetleftnavbar#LABEL_ID# href='#URL#'>#LABEL#</td></tr></
table></td></tr>"
Suffix="</table>  </TD><TD style='padding-right:
2px;' class=ms-verticaldots> </TD></TR></TABLE>"
ID="1012">
<NavBarLink Name="Home" Url="default.aspx"> </NavBarLink>
<NavBarLink Name="Documents and Lists" Url="_layouts/
[%=System.Threading.Thread.CurrentThread.CurrentUICulture.LCID%]/
viewlsts.aspx"> </NavBarLink>
<NavBarLink Name="Create" Url="_layouts/
[%=System.Threading.Thread.CurrentThread.CurrentUICulture.LCID%]/create.aspx">
</NavBarLink>
<NavBarLink Name="Site Settings" Url="_layouts/
[%=System.Threading.Thread.CurrentThread.CurrentUICulture.LCID%]/
settings.aspx"> </NavBarLink>
<NavBarLink Name="Help" Url='javascript:HelpWindowKey("NavBarHelpHome")'>
</NavBarLink>
</NavBar>
In the Configurations element, remove all Configuration elements except for the one
Configuration element where ID=-1.
Add the following text to the Configurations element, add the text after the one Configuration
element that you did not remove in Step b.
<Configuration ID="0" Name="Opportunity">
<Lists>
<List Title="Document Library" Type="101" />
<List Title="Discussion"
Url="Lists/Discussion"
QuickLaunchUrl="Lists/Discussion/AllItems.aspx"
Type="108" />
<List Title="Announcements" Type="104"
Url="Lists/Announcements" />
<List Title="Contacts"
Url="Lists/Contacts"
QuickLaunchUrl="Lists/Contacts/AllItems.aspx"
Type="105" />
<List Title="Links" Type="103"
Url="Lists/Links" />
<List Title="Events"
Url="Lists/Events"
QuickLaunchUrl="Lists/Events/AllItems.aspx"
Type="106" />
<List Title="Action Items" Type="107" />
<List Title="Site Template Gallery"
Type="111"
Url="_catalogs/wt"
RootWebOnly="TRUE" />
<List Title="Web Part Gallery"
Type="113"
Url="_catalogs/wp"
61
<List Title="List Template Gallery"
Type="114"
Url="_catalogs/lt"
</Lists>
<Modules>
<Module Name="SiebelTeamspace"/>
<Module Name="WebPartPopulation"/>
</Modules>
</Configuration>
<Configuration ID="1" Name="Service Request">
<Lists>
<List Title="Document Library" Type="101" />
<List Title="Discussion"
Url="Lists/Discussion"
QuickLaunchUrl="Lists/Discussion/AllItems.aspx"
Type="108" />
<List Title="Announcements" Type="104"
Url="Lists/Announcements" />
<List Title="Contacts"
Url="Lists/Contacts"
QuickLaunchUrl="Lists/Contacts/AllItems.aspx"
Type="105" />
<List Title="Links" Type="103"
Url="Lists/Links" />
<List Title="Events"
Url="Lists/Events"
QuickLaunchUrl="Lists/Events/AllItems.aspx"
Type="106" />
<List Title="Action Items" Type="107" />
<List Title="Site Template Gallery"
Type="111"
Url="_catalogs/wt"
<List Title="Web Part Gallery"
Type="113"
Url="_catalogs/wp"
<List Title="List Template Gallery"
Type="114"
Url="_catalogs/lt"
</Lists>
<Modules>
<Module Name="SiebelTeamspace"/>
<Module Name="WebPartPopulation"/>
</Modules>
</Configuration>
62
In the Modules element, remove all Module elements except for the one Module element where
Name="WebPartPopulation".
NOTE: Make sure you are in the top-level Modules element, below the configurations
element. Do not delete the single-line module elements contained in the Configuration
elements.
Add the following text to the Modules element; add the text after the one Module element that
you did not remove in Step d.
<Module Name="SiebelTeamspace" Url="">
<File Url="default.aspx">
<AllUsersWebPart WebPartZoneID="Top" WebPartOrder="1">
<![CDATA[
<WebPart xmlns="http://schemas.microsoft.com/WebPart/v2">
<Title>Siebel Collaboration</Title>
<Description>Summary data for Siebel Collaboration team sites
</Description>
<Assembly>SiebelWebParts, Version=1.0.0.0, Culture=Neutral,
PublicKeyToken=20916967cfa1c936</Assembly>
<TypeName>Siebel.WebParts.SiebelWebPart</TypeName>
<UnexpectedError xmlns="Siebel.WebParts">An unexpected error has
occurred. Please contact your System Administrator.</UnexpectedError>
</WebPart>
]]>
</AllUsersWebPart>
<AllUsersWebPart WebPartZoneID="Left" WebPartOrder="1">
<![CDATA[
<WebPart xmlns="http://schemas.microsoft.com/WebPart/v2">
<Assembly>Microsoft.SharePoint, Version=11.0.0.0,
Culture=neutral, PublicKeyToken=71e9bce111e9429c</Assembly>
<TypeName>Microsoft.SharePoint.WebPartPages.MembersWebPart
</TypeName>
<Title>Members</Title>
<Description>Use the Members Web Part to see a list of the site
members and their online status.</Description>
<FrameType>Standard</FrameType>
</WebPart>
]]>
63
</AllUsersWebPart>
<View List="108" BaseViewID="1" WebPartZoneID="Right" WebPartOrder="1"/>
<NavBarPage Name="Home" ID="1002" Position="Start"> </NavBarPage>
<NavBarPage Name="Home" ID="0" Position="Start"> </NavBarPage>
</File>
</Module>
Translate strings as described in the following table.

Translate the . . .
Found in the . . .
Appears in Bold in . . .
Strings "Siebel
Navbar" and "Team
Space"
NavBar element named Siebel Navbar
Step a
String for the Name

attributes
NavBarLink element in the NavBar

element named Siebel Navbar
Step a
Strings for the Title

attributes
List elements of the Configuration

elements named Opportunity and
Service Request
Step c
Strings for Title,

Description, and
UnexpectedError
attributes
WebParts elements titled Siebel

Collaboration and Members in the
SiebelTeamspace module
Step e
Strings for the Name

attributes
NavBarPage elements in the

SiebelTeamspace module
Step e
Edit the ASPX files in the LISTS directory (SharePoint Services Web Service Extension
Directory\TEMPLATE\lcid\SIEBEL\LISTS).
The files in the DISCUSS, TASKS, and DOCLIB directories need to be edited. Files in the other
directories only need to be edited if you have customized your Siebel site definition to include
display pages from other directories.
Locate the line beginning with <%@ Page language="C#"... and add this line immediately above
it:
<%@ Register Tagprefix="SIEBEL" Namespace="Siebel.WebParts"
Assembly="SiebelWebParts, Version=1.0.0.0, Culture=neutral,
PublicKeyToken=20916967cfa1c936" %>
64
Locate the HTML for the SharePoint top navigation bar, which begins with  and
wrap these HTML tags around it:
<SIEBEL:HideDataInSiebelApp runat=server> .... </SIEBEL:HideDataInSiebelApp>
Locate the HTML for the left navigation bar, which begins below <TD valign=top height=100%
class=ms-nav> and insert this HTML:
<SIEBEL:HideDataInSiebelApp ShowInSiebel="true"
runat=server><SharePoint:Navigation LinkBarId="1012" runat="server"/>
</SIEBEL:HideDataInSiebelApp>
Edit the config.xml file in the Siebel-SharePoint Integration\config directory:
Locate the Languages element.

The Languages element in the config.xml file maps the Siebel language (for example ENU)
to the SharePoint locale.
CAUTION: Do not change the value for defaultlcid in the config.xml file. Leave it set to 1033
to indicate that the default is U.S. English if a language mapping is not found.
Add additional language mappings to the Languages element as follows:

<Language code=Siebel Language <Language code="Siebel language" lcid="language
ID" />
For example, to add French:
<Languages defaultlcid="1033">
<Language code="ENU" lcid="1033" />
<Language code="FRA" lcid="1036" />
</Languages>
65
Search the config.xml file for strings of the format:

<LocaleText lcid="1033" text="
and, for each found, add a LocaleText element for the new language that contains the
translated text.
For example:
<Name>
<LocaleText lcid="1033" text="Service Request" />
<LocaleText lcid="1036" text="Demande dassistance" />
</Name>
66
Index
Addin directory on the SharePoint

server
14
ADSI domain name
14
ADSI parameter for Siebel
Collaboration
11, 15
application CFG file, editing for Siebel
Collaboration
15
languages, extending Siebel Collaboration

for additional
59
LDAPSecAdpt section of application CFG file,
editing for Siebel Collaboration
15
log files for troubleshooting Siebel
Collaboration
31
C
cache setting for Siebel Collaboration,
configuring
50
CollaborationEnabled parameter in
application CFG file
15
config.xml file for Siebel Collaboration
25
configuration files for Siebel-SharePoint
Integration
25
configuring Siebel Collaboration
about
41
process for
42
scenario for
41
D
directory paths for Siebel Collaboration
setup
14
DomainName parameter in application CFG
file
15
membership lists for team spaces

about
37
configuring
48
Microsoft SharePoint about
using with Siebel Collaboration
7
Microsoft SharePoint, about
site definitions
19
themes
19
N
navigation bars on Collaboration pages
adding Siebel bar
59
hiding and showing
44
O
outbound Web Service for Siebel
Collaboration, setting up
30
E
error messages in Siebel Collaboration
F
features, new in this release of Siebel
Collaboration
5
I
inbound Web Service for Siebel
Collaboration, setting up
30
Integration Web Service for SiebelSharePoint
See Siebel-SharePoint Integration Web
Service
IntegrationWebService.reg file for Siebel
Collaboration
25
31
SecurityToken parameter
in application CFG file
15
in config.xml file
25
server names for Siebel Collaboration
setup
14
setting up Siebel Collaboration
about
11
process for
13
SharePoint
See Microsoft SharePoint
SharePoint host machine name
14
SharePoint Portal Server, setting up
Symbolic URL for
18
SharePoint portal site
14
SharePoint Services Web Service Extension
Directory
14
67
Index T
about
7
configuring
41
extending for additional languages
59
extending for new Siebel objects
51
prerequisites
11
setting up
11
usage example
7
using
37
Siebel objects, adding to Siebel
Collaboration
51
Siebel site definition for SharePoint,
installing
19
Siebel Web Part for Siebel Collaboration
installing
23
Siebel Web Part for Siebel Collaboration,
configuring
47
Siebel Web Server host machine name
14
siebelOpp.xsl file for Siebel
Collaboration
25
Siebel-SharePoint Integration
directory
14
Siebel-SharePoint integration files, copying
to the SharePoint server
19
Siebel-SharePoint Integration Web
Service
21
Siebel-SharePoint Integration Web Service
URI
14
siebelSR.xsl file for Siebel
Collaboration
25
single sign-on
See SSO
site definitions, Microsoft SharePoint
19
SSO parameter for Siebel Collaboration
11
SSO table, setting up for Siebel
Collaboration
17
SSOSystem parameter
in application CFG file
15
symbolic URL
setting up for access to SharePoint Portal
Server
18
68
T
team space field
about
37
configuring icon for
42
team spaces
components of
9
configuring page appearance
43
creating
39
membership lists for
37
configuring membership lists for
48
viewing within the Siebel application
40
viewing without the Siebel application
40
themes in Microsoft SharePoint
19
troubleshooting Siebel Collaboration
setup
31
U
usage example for Siebel Collaboration
7
user authentication for Siebel
Collaboration
11
UserAuthentication parameter in application
CFG file
15
using Siebel Collaboration
process for
39
scenario for
38
V
VerifyCollaborationUser parameter in
application CFG file
15
version 7.8, new features in Siebel
Collaboration
5
W
Web Services for Siebel Collaboration,
setting up
30
Web Site directory for the SharePoint portal
site
14
WebParts.reg file for Siebel
Collaboration
25

Col Lab Share PT

Uploaded by

Copyright:

Available Formats

Col Lab Share PT

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Col Lab Share PT

Uploaded by

Copyright:

Available Formats

s

Siebel Systems, Inc., 2207 Bridgepointe Parkway, San Mateo, CA 94404

Siebel Collaboration Guide 1

Chapter 1: Whats New in This Release

A Usage Example for Siebel Collaboration

Chapter 3: Getting Started with Siebel Collaboration

Installing the Siebel Site Definition for SharePoint

Setting Up the Siebel-SharePoint Integration Web Service

Installing Configuration Files for Siebel-SharePoint Integration

Setting Up Inbound and Outbound Web Services for Siebel Collaboration

Chapter 4: Using Siebel Collaboration

Scenario for Using Siebel Collaboration

Viewing Team Spaces Within the Siebel Application

Siebel Collaboration Guide Version 7.8, Rev. A

Viewing Team Spaces Without the Siebel Application

Chapter 5: Configuring Siebel Collaboration

Scenario for Configuring Siebel Collaboration

Hiding and Showing the Navigation Bars on Team Space Pages

Changing the Cache Setting for Siebel Collaboration

Extending Siebel Collaboration for Additional Siebel Objects

Siebel Collaboration Guide Version 7.8, Rev. A

Whats New in This Release

Whats New in the Siebel Collaboration Guide, Version 7.8, Rev. A

What's New in the Siebel Collaboration Guide, Version 7.8, Rev. A

Installing Configuration Files for

Whats New in the Siebel Collaboration Guide, Version 7.8

Siebel Collaboration Guide Version 7.8, Rev. A

Whats New in This Release

Siebel Collaboration Guide Version 7.8, Rev. A

About Siebel Collaboration on page 7

A Usage Example for Siebel Collaboration on page 7

Components of the Team Space on page 9

About Siebel Collaboration

A Usage Example for Siebel

Siebel Collaboration Guide Version 7.8, Rev. A

Overview of Siebel Collaboration A Usage Example for Siebel Collaboration

Siebel Collaboration Guide Version 7.8, Rev. A

Overview of Siebel Collaboration Components of the Team Space

Components of the Team Space

Posting area for documents

Sample Team Space (for an Opportunity Record)

Siebel Collaboration Guide Version 7.8, Rev. A

Overview of Siebel Collaboration Components of the Team Space

Siebel Collaboration Guide Version 7.8, Rev. A

Getting Started with Siebel

About Getting Started with Siebel Collaboration on page 11

Process of Setting Up Siebel Collaboration on page 13

Setting Up the Single Sign-On Table for Siebel Collaboration on page 17

Copying the Siebel-SharePoint Integration Files on page 19

Installing the Siebel Site Definition for SharePoint on page 19

Setting Up the Siebel-SharePoint Integration Web Service on page 21

Installing the Siebel Web Part on page 23

Installing Configuration Files for Siebel-SharePoint Integration on page 25

Troubleshooting Siebel Collaboration Setup on page 31

About Getting Started with Siebel

For opportunity and service request objects

Siebel Collaboration Guide Version 7.8, Rev. A

In the ENU language and locale

About User Authentication