You are on page 1of 406

Siebel 8.

0 Essentials

Volume I • Activity Guide

D46318GC10
Edition 1.0
April 2007
D49912

®
Author Copyright © 2007, Oracle. All rights reserved.

Siebel Curriculum Disclaimer


Development Team
This document contains proprietary information and is protected by copyright and
other intellectual property laws. You may copy and print this document solely for your
Technical Contributors own use in an Oracle training course. The document may not be modified or altered in
any way. Except where your use constitutes "fair use" under copyright law, you may
and Reviewers not use, share, download, upload, copy, print, display, perform, reproduce, publish,
Siebel Review Team license, post, transmit, or distribute this document in whole or in part without the
express authorization of Oracle.

Publisher The information contained in this document is subject to change without notice. If you
find any problems in the document, please report them in writing to: Oracle University,
Joseph Fernandez 500 Oracle Parkway, Redwood Shores, California 94065 USA. This document is not
warranted to be error-free.

Restricted Rights Notice

If this documentation is delivered to the United States Government or anyone using


the documentation on behalf of the United States Government, the following notice is
applicable:

U.S. GOVERNMENT RIGHTS


The U.S. Government’s rights to use, modify, reproduce, release, perform, display, or
disclose these training materials are restricted by the terms of the applicable Oracle
license agreement and/or the applicable U.S. Government contract.

Trademark Notice

Oracle, JD Edwards, PeopleSoft, and Siebel are registered trademarks of Oracle


Corporation and/or its affiliates. Other names may be trademarks of their respective
owners.
Contents

Volume 1
Lab 0-1 Introduction................................................................................................................................1
Lab 2-1 Navigating the User Interface (UI) (Unguided)..........................................................................3
Solutions 2-1 Navigating the User Interface (UI) (Unguided).................................................................5
Lab 2-1 Navigating the User Interface (UI) (Guided)..............................................................................7
Solutions 2-1 Navigating the User Interface (UI) (Guided)...................................................................10
Lab 3-1 Querying Siebel Data (Unguided) ...........................................................................................11
Solutions 3-1 Querying Siebel Data (Unguided) ..................................................................................13
Lab 3-1 Querying Siebel Data (Guided) ...............................................................................................15
Solutions 3-1 Querying Siebel Data (Guided) ......................................................................................19
Lab 4-1 Exploring Responsibilities and Views (Unguided)...................................................................21
Solutions 4-1 Exploring Responsibilities and Views (Unguided)..........................................................23
Lab 4-1 Exploring Responsibilities and Views (Guided) ......................................................................25
Solutions 4-1 Exploring Responsibilities and Views (Guided)..............................................................29
Lab 5-1 Creating the Company Structure (Unguided)..........................................................................31
Lab 5-1 Creating the Company Structure (Guided)..............................................................................35
Solutions 5-1 Creating the Company Structure (Guided).....................................................................41
Lab 6-1 Exploring View Filters (Unguided)...........................................................................................43
Solutions 6-1 Exploring View Filters (Unguided) ..................................................................................46
Lab 6-1 Exploring View Filters (Guided)...............................................................................................49
Solutions 6-1 Exploring View Filters (Guided)......................................................................................52
Lab 6-2 Exploring Positions (Unguided)...............................................................................................55
Solutions 6-2 Exploring Positions (Unguided) ......................................................................................57
Lab 6-2 Exploring Positions (Guided)...................................................................................................59
Solutions 6-2 Exploring Positions (Guided)..........................................................................................61
Lab 7-1 Creating a Solutions Catalog (Unguided)................................................................................63
Lab 7-1 Creating a Solutions Catalog (Unguided)................................................................................67
Lab 7-1 Creating a Solutions Catalog (Guided) ...................................................................................69
Lab 7-1 Creating a Solutions Catalog (Guided) ...................................................................................74
Lab 8-1 Exploring the Siebel Web Architecture (Unguided).................................................................75
Lab 8-1 Exploring the Siebel Web Architecture (Guided) ....................................................................77
Solutions 8-1 Exploring the Siebel Web Architecture (Guided)............................................................81
Lab 9-1 Exploring Server Components and Parameters (Unguided)...................................................83
Lab 9-1 Exploring Server Components and Parameters (Guided) ......................................................85
Solutions 9-1 Exploring Server Components and Parameters (Guided)..............................................88

iii
Lab 9-2 Enabling and Assigning Component Groups (Unguided) .......................................................91
Solutions 9-2 Enabling and Assigning Component Groups (Unguided) ..............................................92
Lab 9-2 Enabling and Assigning Component Groups (Guided) ...........................................................93
Solutions 9-2 Enabling and Assigning Component Groups (Guided) ..................................................96
Lab 10-1 Exploring Server Management (Unguided)...........................................................................97
Lab 10-1 Exploring Server Management (Guided)...............................................................................99
Solutions 10-1 Exploring Server Management (Guided)....................................................................101
Lab 10-2 Using the Command-Line Server Manager (Unguided)......................................................103
Lab 10-2 Using the Command-Line Server Manager (Guided)..........................................................105
Solutions 10-2 Using the Command-Line Server Manager (Guided).................................................107
Lab 10-3 Invoking and Monitoring Jobs (Unguided)...........................................................................109
Lab 10-3 Invoking and Monitoring Jobs (Guided) ..............................................................................111
Solutions 10-3 Invoking and Monitoring Jobs (Guided)......................................................................113
Lab 11-1 Exploring Siebel Client Types (Unguided) ..........................................................................115
Lab 11-1 Exploring Siebel Client Types (Guided) ..............................................................................117
Solutions 11-1 Exploring Siebel Client Types (Guided) .....................................................................121
Lab 12-1 Securing Access to the Application (Unguided) ..................................................................123
Lab 12-1 Securing Access to the Application (Guided)......................................................................125
Solutions 12-1 Securing Access to the Application (Guided) .............................................................127
Lab 14-1 Exploring Relationships in the Application Architecture (Unguided) ...................................129
Solutions 14-1 Exploring Relationships in the Application Architecture (Unguided) ..........................132
Lab 14-1 Exploring Relationships in the Application Architecture (Guided).......................................135
Solutions 14-1 Exploring Relationships in the Application Architecture (Guided) ..............................139
Lab 15-1 Examining Object Definitions (Unguided) ...........................................................................143
Solutions 15-1 Examining Object Definitions (Unguided)...................................................................146
Lab 15-1 Examining Object Definitions (Guided) ...............................................................................147
Solutions 15-1 Examining Object Definitions (Guided) ......................................................................154
Lab 16-1 Exploring the Data Model (Unguided) .................................................................................155
Solutions 16-1 Exploring the Data Model (Unguided) ........................................................................162
Lab 16-1 Exploring the Data Model (Guided) .....................................................................................167
Solutions 16-1 Exploring the Data Model (Guided) ............................................................................177
Lab 17-1 Examining References Between Applets, Business Components,
and Tables (Unguided) ......................................................................................................................181
Solutions 17-1 Examining References Between Applets, Business Components,
and Tables (Unguided) ......................................................................................................................184
Lab 17-1 Examining References Between Applets, Business Components, and Tables (Guided)...187
Solutions 17-1 Examining References Between Applets, Business Components,
and Tables (Guided) ..........................................................................................................................190
Lab 18-1 Exploring Relationships Between Party Business Components and Tables (Unguided) ...193

iv
Lab 18-1 Exploring Relationships Between Party Business Components and Tables (Guided).......195
Solutions 18-1 Exploring Relationships Between Party Business Components
and Tables (Guided)..........................................................................................................................200
Lab 18-2 Identifying Objects When Using a Party Business Component (Unguided) .......................203
Solutions 18-2 Identifying Objects When Using a Party Business Component (Unguided) ..............205
Lab 18-2 Identifying Objects When Using a Party Business Component (Guided) ...........................207
Solutions 18-2 Identifying Objects When Using a Party Business Component (Guided) ..................209
Lab 19-1 Examining Relationships between Views, Business Objects,
Business Components, and Tables (Unguided)................................................................................211
Solutions 19-1 Examining Relationships between Views, Business Objects,
Business Components, and Tables (Unguided)................................................................................215
Lab 19-1 Examining Relationships between Views, Business Objects,
Business Components, and Tables (Guided)....................................................................................217
Solutions 19-1 Examining Relationships between Views, Business Objects,
Business Components, and Tables (Guided)....................................................................................223
Lab 21-1 Setting Up a Developer (Unguided) ....................................................................................227
Lab 21-1 Setting Up a Developer (Guided) ........................................................................................229
Lab 21-2 Extracting a Local Database (Unguided) ............................................................................233
Lab 21-2 Extracting a Local Database (Guided) ................................................................................235
Solutions 21-2 Extracting a Local Database (Guided) .......................................................................238
Lab 21-3 Populating the Local Developer Database (Unguided).......................................................239
Lab 21-3 Populating the Local Developer Database (Guided)...........................................................241
Lab 22-1 Exploring Projects (Unguided) ............................................................................................245
Solutions 22-1 Exploring Projects (Unguided)....................................................................................248
Lab 22-1 Exploring Projects (Guided) ................................................................................................249
Solutions 22-1 Exploring Projects (Guided) .......................................................................................255
Lab 23-1 Editing and Validating Object Definitions (Unguided) .........................................................259
Solutions 23-1 Editing and Validating Object Definitions (Unguided) ................................................260
Lab 23-1 Editing and Validating Object Definitions (Guided) .............................................................261
Solutions 23-1 Editing and Validating Object Definitions (Guided) ....................................................264
Lab 23-2 Exporting and Importing Object Definitions (Unguided)......................................................265
Solutions 23-2 Exporting and Importing Object Definitions (Unguided) .............................................266
Lab 23-2 Exporting and Importing Object Definitions (Guided)..........................................................267
Solutions 23-2 Exporting and Importing Object Definitions (Guided).................................................270
Lab 23-3 Creating a Custom Repository File (Unguided) ..................................................................273
Solutions 23-3 Creating a Custom Repository File (Unguided) .........................................................276
Lab 23-3 Creating a Custom Repository File (Guided) ......................................................................277
Solutions 23-3 Creating a Custom Repository File (Guided) .............................................................280
Lab 24-1 Exploring Template Files (Unguided)..................................................................................281
Lab 24-1 Exploring Template Files (Guided)......................................................................................283

v
Solutions 24-1 Exploring Template Files (Guided).............................................................................288
Lab 25-1 Modifying a Form Applet (Unguided) ..................................................................................291
Solutions 25-1 Modifying a Form Applet (Unguided)..........................................................................293
Lab 25-1 Modifying a Form Applet (Guided) ......................................................................................295
Solutions 25-1 Modifying a Form Applet (Guided) .............................................................................301
Lab 25-2 Creating a List Applet (Unguided) .......................................................................................303
Solutions 25-2 Creating a List Applet (Unguided) ..............................................................................305
Lab 25-2 Creating a List Applet (Guided) ...........................................................................................307
Solutions 25-2 Creating a List Applet (Guided) ..................................................................................311
Lab 26-1 Creating a View (Unguided) ................................................................................................313
Lab 26-1 Creating a View (Guided) ....................................................................................................317
Lab 27-1 Configuring Drilldowns (Unguided)......................................................................................325
Solutions 27-1 Configuring Drilldowns (Unguided).............................................................................328
Lab 27-1 Configuring Drilldowns (Guided) .........................................................................................329
Solutions 27-1 Configuring Drilldowns (Guided) ................................................................................335
Lab 28-1 Examine Existing Joins (Unguided).....................................................................................337
Solutions 28-1 Examine Existing Joins (Unguided)............................................................................340
Lab 28-1 Examine Existing Joins (Guided) ........................................................................................343
Solutions 28-1 Examine Existing Joins (Guided) ...............................................................................348
Lab 28-2 Adding a Joined Field to a Business Component (Unguided) ............................................351
Lab 28-2 Adding a Joined Field to a Business Component (Guided) ................................................355
Lab 29-1 Configuring Properties of Fields and Business Components (Unguided)...........................363
Solutions 29-1 Configuring Properties of Fields and Business Components (Unguided)..................365
Lab 29-1 Configuring Properties of Fields and Business Components (Guided)...............................367
Solutions 29-1 Configuring Properties of Fields and Business Components (Guided)......................371
Lab 30-1 Using the Standard 1:M Extension Table to Store Supply Plans (Unguided).....................373
Solutions 30-1 Using the Standard 1:M Extension Table to Store Supply Plans (Unguided) ............376
Lab 30-1 Using the Standard 1:M Extension Table to Store Supply Plans (Guided).........................379
Solutions 30-1 Using the Standard 1:M Extension Table to Store Supply Plans (Guided)................385
Lab 30-2 Creating a New List and View (Unguided) ..........................................................................387
Solutions 30-2 Creating a New List and View (Unguided) .................................................................390
Lab 30-2 Creating a New List and View (Guided) ..............................................................................391
Solutions 30-2 Creating a New List and View (Guided) .....................................................................396

vi
Volume 2
Lab 31-1 Creating a Static Picklist (Unguided).......................................................................................1
Solutions 31-1 Creating a Static Picklist (Unguided)..............................................................................4
Lab 31-1 Creating a Static Picklist (Guided) ..........................................................................................5
Solutions 31-1 Creating a Static Picklist (Guided)..................................................................................9
Lab 31-2 Creating a Dynamic Picklist (Unguided)................................................................................11
Solutions 31-2 Creating a Dynamic Picklist (Unguided).......................................................................14
Lab 31-2 Creating a Dynamic Picklist (Guided) ...................................................................................15
Solutions 31-2 Creating a Dynamic Picklist (Guided)...........................................................................20
Lab 32-1 Configuring a Multi-Value Field (Unguided) ..........................................................................23
Solutions 32-1 Configuring a Multi-Value Field (Unguided) .................................................................29
Lab 32-1 Configuring a Multi-Value Field (Guided) ..............................................................................31
Solutions 32-1 Configuring a Multi-Value Field (Guided) .....................................................................38
Lab 33-1 Adding Extension Columns (Unguided) ................................................................................41
Solutions 33-1 Adding Extension Columns (Unguided) .......................................................................43
Lab 33-1 Adding Extension Columns (Guided) ....................................................................................45
Solutions 33-1 Adding Extension Columns (Guided) ...........................................................................48
Lab 33-2 Adding New Fields (Unguided) .............................................................................................49
Lab 33-2 Adding New Fields (Guided) .................................................................................................51
Lab 33-3 Configuration Wrap-Up (Unguided).......................................................................................53
Lab 33-3 Configuration Wrap-Up (Guided) ..........................................................................................57
Lab 34-1 Examining a Business Service (Unguided) ...........................................................................61
Solutions 34-1 Examining a Business Service (Unguided) ..................................................................63
Lab 34-1 Examining a Business Service (Guided)...............................................................................65
Solutions 34-1 Examining a Business Service (Guided)......................................................................67
Lab 34-2 Testing a Business Service (Unguided) ................................................................................69
Solutions 34-2 Testing a Business Service (Unguided) .......................................................................71
Lab 34-2 Testing a Business Service (Guided)....................................................................................72
Solutions 34-2 Testing a Business Service (Guided) ...........................................................................74
Lab 35-1 Building a Siebel Workflow Process (Unguided)...................................................................75
Lab 35-1 Building a Siebel Workflow Process (Guided) ......................................................................79
Lab 35-2 Branching in a Siebel Workflow Process (Unguided) ...........................................................85
Lab 35-2 Branching in a Siebel Workflow Process (Guided) ...............................................................89
Lab 36-1 Testing a Siebel Workflow Process (Unguided)....................................................................93
Lab 36-1 Testing a Siebel Workflow Process (Guided) .......................................................................95
Lab 36-2 Testing Branching in a Siebel Workflow Process (Unguided) ..............................................99
Lab 36-2 Testing Branching in a Siebel Workflow Process (Guided) ................................................101
Solutions 36-2 Testing Branching in a Siebel Workflow Process (Guided) .......................................104

vii
Lab 37-1 Executing a Workflow Process using a Run-time Event (Unguided) ..................................105
Lab 37-1 Executing a Workflow Process using a Run-time Event (Guided) ......................................107
Lab 37-2 Executing a Workflow Process from a Control (Unguided).................................................111
Lab 37-2 Executing a Workflow Process from a Control (Guided).....................................................113
Lab 38-1 Creating a Workflow Policy (Unguided) ..............................................................................117
Lab 38-1 Creating a Workflow Policy (Guided) ..................................................................................119
Lab 38-2 Administering Server Components (Unguided)...................................................................121
Lab 38-2 Administering Server Components (Guided) ......................................................................123
Lab 38-3 Invoking a Workflow Process via Workflow Policy (Unguided) ...........................................127
Lab 38-3 Invoking a Workflow Process via Workflow Policy (Guided)...............................................129
Lab 39-1 Executing a UI Task (Unguided) .........................................................................................131
Lab 39-1 Executing a Task (Guided)..................................................................................................133
Lab 40-1 Creating a UI Task (Unguided)............................................................................................137
Lab 40-1 Creating a Task (Guided) ....................................................................................................143
Lab 40-2 Adding a Summary View (Unguided) ..................................................................................151
Lab 40-2 Adding a Summary View (Guided) ......................................................................................153
Lab 41-1 Adding Branching to a UI Task (Unguided).........................................................................157
Lab 41-1 Adding Branching to a Task (Guided) .................................................................................163
Lab 42-1 Examining Siebel Business Rules (Unguided)....................................................................173
Lab 42-1 Examining Siebel Business Rules (Guided)........................................................................175
Solutions 42-1 Examining Siebel Business Rules (Guided)...............................................................179
Lab 43-1 Creating Siebel Business Rules (Unguided) .......................................................................181
Lab 43-1 Creating Siebel Business Rules (Guided)...........................................................................189
Lab 45-1 Creating Assignment Rules for Sales Data (Unguided)......................................................197
Solutions 45-1 Creating Assignment Rules for Sales Data (Unguided) .............................................200
Lab 45-1 Creating Assignment Rules for Sales Data (Guided)..........................................................201
Solutions 45-1 Creating Assignment Rules for Sales Data (Guided).................................................205
Lab 45-2 Creating Assignment Rules for Service Data (Unguided)...................................................207
Solutions 45-2 Creating Assignment Rules for Service Data (Guided)..............................................211
Lab 45-2 Creating Assignment Rules for Service Data (Guided).......................................................213
Solutions 45-2 Creating Assignment Rules for Service Data (Guided)..............................................218
Lab 46-1 Prioritizing Assignment Rules (Unguided)...........................................................................219
Solutions 46-1 Prioritizing Assignment Rules (Unguided)..................................................................222
Lab 46-1 Prioritizing Assignment Rules (Guided) ..............................................................................223
Solutions 46-1 Prioritizing Assignment Rules (Guided)......................................................................226
Lab 46-2 Using Workload Distribution (Unguided) .............................................................................227
Lab 46-2 Using Workload Distribution (Guided) .................................................................................229
Lab 47-1 Invoking Assignment Manager in Dynamic Mode (Unguided) ............................................231

viii
Solutions 47-1 Invoking Assignment Manager in Dynamic Mode (Unguided) ...................................233
Lab 47-1 Invoking Assignment Manager in Dynamic Mode (Guided)................................................235
Solutions 47-1 Invoking Assignment Manager in Dynamic Mode (Guided).......................................238
Lab 48-1 Creating a Siebel State Model (Unguided) .........................................................................239
Solutions 48-1 Creating a Siebel State Model (Unguided).................................................................242
Lab 48-1 Creating a Siebel State Model (Guided) .............................................................................243
Solutions 48-1 Creating a Siebel State Model (Guided) ....................................................................247
Lab 50-1 Data Mapping: Solutions (Unguided) ..................................................................................249
Solutions 50-1 Data Mapping: Solutions (Unguided) .........................................................................253
Lab 50-1 Data Mapping: Solutions (Guided) ......................................................................................255
Solutions 50-1 Data Mapping: Solutions (Guided) .............................................................................260
Lab 50-2 Data Mapping: Products (Optional).....................................................................................263
Solutions 50-2 Data Mapping: Products (Optional) ............................................................................268
Lab 51-1 Loading EIM Tables with Legacy Data (Unguided).............................................................271
Lab 51-1 Loading EIM Tables with Legacy Data (Guided) ................................................................273
Solutions 51-1 Loading EIM Tables with Legacy Data (Guided)........................................................276
Lab 51-2 Running EIM to Import Solution Data (Unguided)...............................................................277
Solutions 51-2 Running EIM to Import Solution Data (Unguided)......................................................280
Lab 51-2 Running EIM to Import Solution Data (Guided) ..................................................................281
Solutions 51-2 Running EIM to Import Solution Data (Guided)..........................................................285
Lab 51-3 Running EIM to Load Product Data (Optional) ...................................................................287
Solutions 51-3 Running EIM to Load Product Data (Optional)...........................................................289
Lab 53-1 Exporting and Packaging Application Changes (Unguided) ...............................................291
Lab 53-1 Exporting and Packaging Application Changes (Guided) ...................................................293
Solutions 53-1 Exporting and Packaging Application Changes (Guided) ..........................................298
Lab 53-2 Configuring ADM (Unguided) ..............................................................................................299
Lab 53-2 Configuring ADM (Guided)..................................................................................................301
Lab 53-3 Deploying Application Changes (Unguided) .......................................................................305
Lab 53-3 Deploying Application Changes (Guided) ...........................................................................307
Solutions 53-3 Deploying Application Changes (Guided) ..................................................................309

ix
x
Module 0: Introduction

Lab 0-1 Introduction

Goals To describe the differences between Guided and Unguided labs in this lab guide

Time Less than 5 minutes

Guided and Unguided labs:


In this lab book you will find two versions of each lab: First an unguided version and then a guided
version. This introduction will help you decide which of the two lab versions is right for you.

Unguided labs provide as little information as possible while still allowing you to complete the labs.
They do not usually have step-by-step instructions, and instead provide the desired end result and a
few overall steps and parameters to help you achieve this result. A few questions are asked to help
guide you to a result, but typically you are left to work out how to accomplish your goal on your
own. In certain circumstances, such as in exploration labs or in labs where the end result is critical to
several future labs, there is no unguided lab; just an instruction to do the guided lab instead.

Use this format if:


- You want to figure out the details on your own.
- You want more of a challenge.
- You have some prior experience using and configuring Siebel applications.

Guided labs provide step-by-step instructions to achieve your goal, as well as additional content that
may be useful to you, plus questions designed to help you interpret your results. If you have
difficulty with an unguided lab, turn to the guided lab to see the steps required to perform an action.
The numbering in the guided labs does not match the numbering in the unguided labs, so it may take
a moment to orient yourself in the guided lab. If this is your first exposure to the Siebel Customer
Relationship Management (CRM) product, consider doing the guided labs throughout the course.

Use this format if:


- You want step-by-step instructions with additional context.
- You get stuck while doing the Unguided lab.
- You have little or no experience using and configuring Siebel applications.

Siebel 8.0 Essentials 1


Module 0: Introduction

2 Siebel 8.0 Essentials


Module 2: Using the Siebel Client

Lab 2-1 Navigating the User Interface (UI) (Unguided)

Goals To practice navigating in Siebel Call Center.

Time 10 – 15 minutes

Instructions:
In this lab you will practice simple navigation in the Siebel user interface (UI). You have been
provided with a new Siebel installation with a few records added to give you practice with UI
navigation. You will review information on screens frequently visited by an end user of Siebel Call
Center. These screens include Service Request, Accounts, and Contacts.

1. Start Siebel Call Center using the Siebel Web client and log in.
a. Open Internet Explorer and navigate to http://localhost/callcenter_enu.
b. In the login screen, enter these values:
User ID SADMIN
Password SADMIN
c. Click the Arrow button.

2. Examine service requests.


a. Locate service request SR#1-7010, drill down on the record, and answer the following
questions. If necessary, click the Show More button to see all the fields.
i. What is the Work Phone #?

ii. What is the service request Area?

iii. What is the service request’s Reproducible value?

iv. Who is the owner of the SR?

v. What is the Organization?

vi. What is the SR# of the next service request?

vii. What is the name of the person (first and last name) associated with this service
request?

Siebel 8.0 Essentials 3


Module 2: Using the Siebel Client

3. Examine contacts.
a. Create a new Contact record with the following information:
Last Name Matthews
First Name Jane
Mr/Ms Ms.
Work Phone # 415-999-5555
Job Title Account Executive
b. Associate the contact with the Cambrian Ventures account.

4. Examine accounts and opportunities.


a. Locate the Cambrian Ventures account and drill down on the Cambrian Ventures
hyperlink.
b. How many opportunities exist for this account?
c. How many contacts are associated with the Eternal Storage 10 TB NAS opportunity?

5. Leave Siebel Call Center open for the next lab.

4 Siebel 8.0 Essentials


Module 2: Using the Siebel Client

Solutions 2-1 Navigating the User Interface (UI)


(Unguided)

Answers:
2.a.i. What is the Work Phone #?
(250) 555-1234

2.a.ii. What is the service request Area?


Installation

2.a.iii. What is the service request’s Reproducible value?


Always

2.a.iv. Who is the owner of the SR?


SADMIN

2.a.v. What is the Organization?


Default Organization

2.a.vi. What is the SR# of the next service request?


1-7013

2.a.vii. What is the name of the person (first and last name) associated with this service request?
Jack Hutton

4.b. How many opportunities exist for this account?


2

4.c. How many contacts are associated with the Eternal Storage 10 TB NAS opportunity?
3

Siebel 8.0 Essentials 5


Module 2: Using the Siebel Client

6 Siebel 8.0 Essentials


Module 2: Using the Siebel Client

Lab 2-1 Navigating the User Interface (UI) (Guided)

Goals To practice navigating in Siebel Call Center.

Time 10 – 15 minutes

Instructions:
In this lab you will practice simple navigation in the Siebel user interface (UI). You have been
provided with a new Siebel installation with a few records added to give you practice with UI
navigation. You will review information on screens frequently visited by an end user of Siebel Call
Center. These screens include Service Request, Accounts, and Contacts.

1. You will log in to Siebel Call Center.


a. Select Start > Programs > Internet Explorer.
b. Navigate to http://localhost/callcenter_enu. localhost is the hostname of the Web server,
and callcenter_enu is the application and language. (enu = American English.) The login
screen may take a minute or two to load the first time.
c. In the login screen, enter these values:
User ID SADMIN
Password SADMIN
d. Click the Arrow button.
e. Wait until the application home page has completely loaded before continuing on to the next
step. This will take several seconds.

2. You will examine a service request.


a. Click the Service screen tab.
b. Click the My Service Requests link on the Service Requests Homepage.
c. Click the link for SR# 1-7010.

3. Review the service request details. If necessary, click the Show More button in the upper-right
corner of the Service Request form to see all available fields.
a. What is the Work Phone #?

b. What is the service request Area?

c. What is the service request’s Reproducible value?

d. Who is the owner of the SR?

e. What is the Organization?

Siebel 8.0 Essentials 7


Module 2: Using the Siebel Client

4. With SR# 1-7010 still selected, click the More Info view tab below the Service Request form to
navigate to the Service Request More Info View.
a. Click the Next arrow (to the right of the view tabs).
b. What is the SR# of the next service request?
c. What is the name of the person (first and last name) associated with this service request?

5. You will now examine Contacts.


a. Click the Contacts screen tab to navigate to the Contacts screen.
b. Click the Contacts List link in the link bar to display the list of SADMIN’s Contacts.

6. You will add a new contact and examine the behavior of the contact record as you associate it
with an account.
a. Click the New button in the Contacts list or form to enter new contact information.
b. Enter the following information for the new contact:
Last Name Matthews
First Name Jane
Mr/Ms Ms.
Work Phone # 415-999-5555
Job Title Account Executive
c. Now you will associate the contact with an account.
i. In the Account field, click the Select button (or use the F2 key on the keyboard).
ii. From the Accounts window, select the Cambrian Ventures account from the
Available records list on the left.
iii. Click the Add button to add the record to the Selected window on the right.
iv. Click OK.
d. How has the new contact record changed?

7. You will now examine Account records.


a. Click the Accounts screen tab to navigate to the Accounts screen.
b. Click All Accounts from the Frequently Viewed Accounts list.
c. Click the Account Name column header to sort the records in ascending order. You should
see an triangular indicator next to the column name:

8 Siebel 8.0 Essentials


Module 2: Using the Siebel Client

8. You will review opportunities for the Cambrian Ventures account.


a. Locate the Cambrian Ventures account and select it by clicking the Cambrian Ventures
account name hyperlink.
b. Navigate to the related opportunities by clicking the Opportunities view tab below the
Account form.
c. How many opportunities exist for this account?

d. Drill down on the opportunity named Eternal Storage 10 TB NAS. What entities are
displayed in the view you navigated to?

e. Which view tab is selected below the Opportunity form?

f. How many contacts are associated with this opportunity?

g. Drill down on the last name Wagoner. What entities are displayed in the view you navigated
to?

h. What information is now visible in the thread bar?

9. Leave Siebel Call Center open for the next lab.

Siebel 8.0 Essentials 9


Module 2: Using the Siebel Client

Solutions 2-1 Navigating the User Interface (UI) (Guided)

Answers:
3.a. What is the Work Phone #?
(250) 555-1234

3.b. What is the service request Area?


Installation

3.c What is the service request’s Reproducible value?


Always

3.d. Who is the owner of the SR?


SADMIN

3.e What is the Organization?


Default Organization

4.b. What is the SR# of the next service request?


1-7013

4.c. What is the name of the person (first and last name) associated with this service request?
Jack Hutton

6.d. How has the new contact record changed?


The account name and address fields are automatically populated.

8.c. How many opportunities exist for this account?


2

8.d. Drill down on the opportunity named Eternal Storage 10 TB NAS. What entities are
displayed in the view you navigated to?
The contacts associated with the Eternal Storage 10 TB NAS opportunity

8.e. Which view tab is selected below the Opportunity form?


Contacts

8.f. How many contacts are associated with this opportunity?


3

8.g. Drill down on the last name Wagoner. What entities are displayed in the view you
navigated to?
Contacts and Activities

8.h. What information is now visible in the thread bar?


Account: Cambrian Ventures > Opportunity: Eternal Storage 10 TB NAS > Contact:

10 Siebel 8.0 Essentials


Module 3: Working with Siebel Data

Lab 3-1 Querying Siebel Data (Unguided)

Goals To practice querying for data.

Time 15 – 20 minutes

Instructions:
In this lab you will create and execute queries and sort the results. Because the classroom application
has very little customer data (Accounts, Opportunities, and so on), you will explore Call Center’s
administrative seed data, which was created during product installation. Several administrative
screens offer large data sets that offer good practice for querying.

1. If necessary, start the Siebel Call Center Web Client and log in as SADMIN/SADMIN.

2. Navigate to the Administration - Data > Zip Code Administration screen.


Note: Zip Code refers to a U.S. postal code.
a. What city has a zip code of 90210?

b. How many ZIP codes are there for Los Angeles, California? The state code for California is
CA. To get a record count, right-click anywhere in the applet and select Record Count.

c. Execute an empty query to refresh the Zip Code list.


d. What city has the northernmost ZIP code (that is, the highest latitude)?

e. Execute a query to return ZIP codes with latitude greater than 49, excluding records with a
state of Alaska (AK).
Note: The western extent of the Canada – U.S. border runs along the 49th parallel of North
latitude.
f. How many ZIP codes outside of Alaska have latitude greater than 49 degrees?

g. Execute a query to locate ZIP codes between 87900 and 87999 using wildcards. How many
valid ZIP codes are in this range?

h. Some ZIP code records were created with zero or null longitude and latitude. Run a query for
these records.

Siebel 8.0 Essentials 11


Module 3: Working with Siebel Data

i. How many records are there without geographic coordinates or with coordinates of 0?

3. Get experience querying on multi-value group (MVG) fields. You will execute queries on iHelp
items, a Siebel object used help users with common application tasks.
a. Navigate to Administration - iHelp > All iHelp Items.
Note: Administration - iHelp appears at the end of the list of administration screens because
the sorting is case-sensitive.
b. Use the EXISTS operator to query for iHelp items that contain the word Sales in the
Applications field. What iHelp items are available for sales-like applications?

c. Verify your result by opening the MVG applet for the Applications field of the Create an
iHelp Item record and querying for application names containing the word Sales.

4. Use the query assistant to generate a query and then save that query.
a. Navigate to Administration - Application > Views. This view lists all Siebel application
views.
b. Use the Query Assistant to create the following query: View Name Contains Asset:
c. Save the query as Asset Views. This is a private query – it is only available to you. However,
an administrator can make it available to other users as a predefined query.

12 Siebel 8.0 Essentials


Module 3: Working with Siebel Data

Solutions 3-1 Querying Siebel Data (Unguided)

Answers:
2.a. What city has a zip code of 90210?
Beverly Hills

2.a. How many ZIP codes are there for Los Angeles, California? The state code for California
is CA. To get a record count, right-click anywhere in the applet and select Record Count.
99

2.d. What city has the northernmost ZIP code (that is, the highest latitude)?
Barrow, AK (Alaska) at 71.29N latitude

2.f. How many ZIP codes outside of Alaska have latitude greater than 49 degrees?
3
(Note: one of the results, for Eastport, Idaho, appears to have latitude equal to 49, but this
is a result of rounding the result for display in the user interface. The underlying value for
Eastport is 49.0005 degrees, which can be queried directly from the underlying database
table S_ZIPCODE.)

2.g. Execute a query to locate ZIP codes between 87900 and 87999 using wildcards. How many
valid ZIP codes are in this range?
12

2.i. How many records are there without geographic coordinates or with coordinates of 0?
972

3.b. Use the EXISTS operator to query for iHelp items that contain the word Sales in the
Applications field. What iHelp items are available for sales-like applications?
Create an iHelp Item

Siebel 8.0 Essentials 13


Module 3: Working with Siebel Data

14 Siebel 8.0 Essentials


Module 3: Working with Siebel Data

Lab 3-1 Querying Siebel Data (Guided)

Goals To practice querying for data.

Time 15 – 20 minutes

Instructions:
In this lab you will create and execute queries and sort the results. Because the classroom application
has very little customer data (Accounts, Opportunities, and so on), you will explore Call Center’s
administrative seed data, which was created during product installation. Several administrative
screens offer large data sets that offer good practice for querying.

1. If necessary, start Siebel Call Center and log in as SADMIN/SADMIN.


a. Start Internet Explorer.
b. Enter the URL: http://localhost/callcenter_enu. You may want to bookmark this URL.
c. In the login screen, enter these values:
User ID SADMIN
Password SADMIN
d. Click the arrow.
e. Wait until the application has completely loaded before continuing on to the next step.

2. Navigate to the Zip Code Administration screen and query for selected records.
Note: Zip Code refers to a U.S. postal code.
a. Click on the Site Map button on the global toolbar.
b. Click Administration - Data.
c. Scroll down and click Zip Code Administration.
Note: In future labs, these steps will be abbreviated as: Administration – Data > Zip Code
Administration. This notation uses ‘>’ to separate parts of a hierarchical path to be followed
using the Site Map.
d. Select New Query from the applet-level menu (or use the keyboard shortcut ALT+Q).
e. In the ZIP Code field, type 90210.
f. Click the Menu button and select Run Query (or use ALT+ENTER).
g. What value appears in the city column?

Siebel 8.0 Essentials 15


Module 3: Working with Siebel Data

h. Query again, this time on two fields: City Los Angeles and State CA. This query will return
records with City = Los Angeles and State = California; that is, a logical AND. How many
ZIP codes are there for Los Angeles? Click the Menu button and select Record Count, or use
CTRL+Shift+3, to find the answer.

3. Create and execute complex queries using the Zip Code seed data.
a. Execute an empty query to refresh the Zip Code list. This is a common technique used to
refresh a list applet so that it lists all visible records.
i. Click Query.
ii. Without entering any query, click Go.
b. Sort the list by latitude in descending order by clicking the Latitude column header until a
down arrow is displayed.
c. What city has the northernmost ZIP code (that is, the highest latitude)?

d. The western extent of the Canada – U.S. border runs along the 49th parallel of North latitude.
Execute a query to return ZIP codes with latitude greater than 49:
i. Click Query.
ii. Type >49 in the Latitude field.
iii. Click Go.
e. Refine your query to exclude records with state equal to Alaska (AK):
i. Select Menu > Refine Query. (Alt+R) Notice that your criterion for latitude appears
in the query form.
ii. Type <>AK in the State field. This will match records where the State is not Alaska.
iii. Execute the query.
iv. How many ZIP codes outside of Alaska have latitude greater than 49 degrees?

f. Execute a query to locate ZIP codes between 87900 and 87999 using wildcards:
i. Execute an empty query to refresh the Zip Code list.
ii. Click Query.
iii. Enter a Zip Code of 879?? and click Go. This query will match 5 digit numbers
starting with 879.
iv. How many valid ZIP codes are in this range?

g. Some ZIP code records were created with blank or null longitude and latitude. Run a query
for these records:
i. Create a new query.
ii. Type IS NULL OR 0 in the Latitude field. This will identify records without an
assigned latitude or with zero latitude. The latter category will catch records where
both the longitude and latitude have been set to zero.
iii. Execute the query.

16 Siebel 8.0 Essentials


Module 3: Working with Siebel Data

iv. How many records are there without geographic coordinates?

4. Get experience querying on multi-value group (MVG) fields. You will execute queries on iHelp
items, a Siebel object used help users with common application tasks.
a. Use the site map to navigate to Administration - iHelp > All iHelp Items.
b. Examine the Applications field in the lower form applet. What kind of field is it?

c. What query operator can you use to search in this field?

d. Create a query and type EXISTS(“*Sales*”) in the Applications field. This query will match
iHelp items that have at least one value in the Applications MVG that includes the substring
“Sales”. The asterisks are wild cards for any length substring.
e. Execute the query. What iHelp items are available for sales-like applications?

f. If necessary, select the Create an iHelp Item from the list of results by clicking to the left of
the record.
g. Click the MVG select icon in the Applications field. This brings up an MVG applet.
h. Query in this applet for Application *Sales*.
i. Which applications are returned from this last query?

j. Click OK to close the MVG applet.

5. You will navigate to the Views screen and query for application views related to Assets.
a. Navigate to Administration - Application > Views. This view lists all Siebel application
views.
b. Click the Query button.
c. Click the Query Assistant button. This tool simplifies query construction,
and is suitable for less technical users.

Siebel 8.0 Essentials 17


Module 3: Working with Siebel Data

d. Execute the following query: View Name Contains Asset:


i. Click the top left-hand dropdown and select View Name.
ii. Click the top center dropdown and select Contains.
iii. Type Asset into the top right-hand text box. The Query Assistant should be identical
to the picture on the next page. Notice that the text box below the dropdown lists
displays a description of the query.
iv. Click Go.

e. How many view records are returned by this query?

6. Save the query you just created so you can use it later.
a. Select Query > Save Query As from the application menu.
b. In the Query Name field, enter Asset Views.
c. Click OK.
d. Notice the query now appears in the Queries drop-down list (in alphabetical order, even
though only one appears for this view) and can be executed by selecting it from the list:

This is a private query – it is only available to you. However, an administrator can make it
available to other users as a predefined query.

18 Siebel 8.0 Essentials


Module 3: Working with Siebel Data

Solutions 3-1 Querying Siebel Data (Guided)

Answers:
2.g. What value appears in the city column?
Beverly Hills

2.h. Query again, this time on two fields: City Los Angeles and State CA. This query will
return records with City = Los Angeles and State = California; that is, a logical AND. How
many ZIP codes are there for Los Angeles? Click the Menu button and select Record
Count, or use CTRL+Shift+3, to find the answer.
99

3.c. What city has the northernmost ZIP code (that is, the highest latitude)?
Barrow, AK (Alaska) at 71.29N latitude

3.e.iv. How many ZIP codes outside of Alaska have latitude greater than 49 degrees?
3
(Note: one of the results, for Eastport, Idaho, appears to have latitude equal to 49, but this
is a result of rounding the result for display in the user interface. The underlying value for
Eastport is 49.0005 degrees, which can be queried directly from the underlying database
table S_ZIPCODE.)

3.f.iv. How many zip codes are in this range?


12

3.g.iv. How many records are there without geographic coordinates?


972

4.b. Examine the Applications field in the lower form applet. What kind of field is it?

An MVG field – the icon for an MVG differs from the icon for a dynamic picklist

4.c. What query operator can you use to search this field?
EXISTS( )

4.e. What iHelp items are available for sales-like applications?


Create an iHelp Item

4.i. What applications are returned from this last query?


Siebel Sales Enterprise and Siebel eSales

5. How many view records are returned by this query?


132

Siebel 8.0 Essentials 19


Module 3: Working with Siebel Data

20 Siebel 8.0 Essentials


Module 4: Responsibilities and Views

Lab 4-1 Exploring Responsibilities and Views


(Unguided)

Goals To explore the relationship between responsibilities and views in the application
To examine the seed responsibilities available in the application
To create and customize a new responsibility

Time 20 - 25 minutes

Instructions:
In this lab, you will explore responsibilities and views first by modifying a user’s responsibilities to
observe which views are available to them, then by creating a new responsibility and observing the
results.

1. Use the Administration - Application > Responsibilities view to explore the seed responsibilities.
In particular, examine the Call Center Representative - SMC responsibility and determine which
users have this responsibility and which views are associated with this responsibility.
a. Which users have the Call Center Representative - SMC responsibility?

b. Query for view names containing the string “Admin”. How many administrative views are
associated with this responsibility?

2. Use a second browser to log in as NBOHR/NBOHR and confirm that he only sees the views
associated with his responsibility.
a. What do you see when you first log in?

b. Does the Home Page View (WCC) appear in the list of views for the Call Center
Representative – SMC Responsibility? Is this what you expected to see?

c. Use File > Log out and close this browser when you are done.

3. Use the Administration - Application > Views view to confirm that the view you found above is
shared by multiple responsibilities. You have now confirmed that one responsibility contains
multiple views, while one view can be associated with multiple responsibilities.

4. Use the Administration - Application > Responsibilities view to locate the Call Center
Representative - SMC responsibility and delete NBOHR as a user for it. You must clear the

Siebel 8.0 Essentials 21


Module 4: Responsibilities and Views

responsibility cache for these changes to be immediately visible. Then open a new browser, log
in as NBOHR, and confirm that he does not have access to any screens or views. When you are
done, log out and close the browser.

5. Create a new responsibility named Call Center Representative - Modified by duplicating the
Call Center Representative - SMC responsibility and adding the Home Page View (WCC). Add
NBOHR to this responsibility. Consider making one or more of the views in this responsibility
read-only, or modifying the tabs displayed for this responsibility. You must clear the
responsibility cache for these changes to be immediately visible. Once you are done, log in as
NBOHR, and confirm your changes. Also examine the site map to get a rough idea as to how
many views NBOHR has access to.

6. Add the Call Center Manager responsibility to NBOHR and confirm that he sees the union of
views for the two responsibilities. Do not forget to clear the responsibility cache before logging
back in as NBOHR. Note that the responsibility shown in the administrative applets is his
primary responsibility, but he sees the views from both. Examine the site map and confirm that
NBOHR has access to more views than before.

22 Siebel 8.0 Essentials


Module 4: Responsibilities and Views

Solutions 4-1 Exploring Responsibilities and Views


(Unguided)

Answers
1.a. Which users have the Call Center Representative - SMC responsibility?
The Siebel Administrator and Norman Bohr.

1.b. Query for view names containing the string “Admin”. How many administrative views are
associated with this responsibility?
None.

2.a. What do you see when you first log in?


You see an error message that the responsibility of the user does not allow accessing the
Home Page view.

2.b. Does the Home Page View (WCC) appear in the list of views for the Call Center
Representative – SMC Responsibility? Is this what you expected to see?
No; the Home Page view does not appear in the list of views for this responsibility. This is
what you should expect to see when you receive that error message.

Siebel 8.0 Essentials 23


Module 4: Responsibilities and Views

24 Siebel 8.0 Essentials


Module 4: Responsibilities and Views

Lab 4-1 Exploring Responsibilities and Views (Guided)

Goals To explore the relationship between responsibilities and views in the application
To examine the seed responsibilities available in the application
To create and customize a new responsibility

Time 20 – 25 minutes

Instructions:
In this lab, you will explore responsibilities and views first by modifying a user’s responsibilities to
observe which views are available to them, then by creating a new responsibility and observing the
results.

1. If necessary, start the Siebel Call Center Web client and log in as SADMIN/SADMIN.

2. You will first examine the views associated with a responsibility. A responsibility is a set of
views usually corresponding to a specific job function.
a. Navigate to Administration - Application > Responsibilities. The responsibilities shown are
the seed responsibilities for the application. These responsibilities cannot be edited or
deleted. You will learn how to create your own custom responsibilities later in this lab.
b. Query for the Call Center Representative - SMC responsibility. Notice that more than one
view is associated with this responsibility. Which users have this responsibility?

c. In the Views applet, query for view names containing the string “Admin”. Note that no
administrative views are associated with this responsibility.

3. You will next confirm that a user with that responsibility sees only those views.
a. Open a second browser, start the Siebel Call Center Web client, and log in as
NBOHR/NBOHR. Using a second browser will allow you to switch back and forth between
the administrative and user logins without having to log in to and out of the application too
frequently.
b. What do you see when you first log in?

c. Switch back to the Call Center application where you are logged in as SADMIN and query
for Home Page in the view name. Does the Home Page view appear in the list of views for
the Call Center Representative - SMC responsibility? Is this what you expected to see?

Siebel 8.0 Essentials 25


Module 4: Responsibilities and Views

4. You will now confirm that a single view may be shared by multiple responsibilities.
a. While still logged in as SADMIN, click the Home tab to return to the home page.
b. Select Help > About View. What is the name of the home page view for Siebel Call Center?

c. Click OK to close the About View window.


d. Navigate to Administration - Application > Views.
e. Query for Home Page. Does the view you found above appear in the list of home page
views?

f. Select the view you found above and confirm that it is included in multiple responsibilities.
You have confirmed that a single responsibility contains multiple views, and that a single
view may be contained in multiple responsibilities.

5. You will next remove Norman Bohr from the list of users with the Call Center Representative -
SMC responsibility. It is unlikely that an administrator would intentionally remove all
responsibilities from a user, but it is quite possible that an administrator might accidentally
remove the user from all responsibilities in the manner shown here.
a. Return to the Siebel Call Center application where you are logged in as NBOHR.
b. Navigate to the Site Map and confirm that NBOHR has access to several views in the
application.
c. Log out of the Siebel Call Center application.
d. Return to the Siebel Call Center application where you are logged in as SADMIN.
e. Navigate to Administration – Application > Responsibilities.
f. Query for the Call Center Representative - SMC responsibility.
g. In the Users applet, select the NBOHR record and click the Delete button.
h. Click OK to confirm the deletion.
i. Click the Clear Cache button near the top of the screen. The responsibilities are cached to
enhance application performance, so it is necessary to clear the cache or restart the server for
the new settings to take effect.
j. Log in to the Siebel Call Center application as NBOHR/NBOHR. What do you notice?

k. Navigate to the Site Map and confirm that NBOHR does not have access to any screens or
views.
l. Log out as NBOHR.

6. You will now create a new responsibility and assign NBOHR to it. A common method of doing
this is to find an existing seed responsibility that closely matches the responsibility you desire,
duplicate it, and modify the new responsibility to have exactly the views you require.
a. Return to the Siebel Call Center application where you are logged in as SADMIN.
b. Select the Call Center Representative - SMC responsibility. Notice that the Delete button is
disabled in the Responsibility pane, and the Add and Delete buttons are disabled in the Views
pane. This shows that this is an application seed responsibility, and cannot be modified.

26 Siebel 8.0 Essentials


Module 4: Responsibilities and Views

c. Right-click Call Center Representative - SMC and select Copy Record. A new
responsibility is created containing the same views as Call Center Representative - SMC.
d. Enter Call Center Representative - Modified as the Responsibility name.
e. Enter Custom responsibility as the Description.
f. Click Add in the Views pane. A list of available views is shown.
g. Query for “Home Page View (WCC)”. Note that you cannot query for the full name without
using quotes, as parentheses are illegal search characters.
h. Click OK to add the view. Confirm that the view now appears in the list of views for the
responsibility. When you give this responsibility to NBOHR, he will no longer see the
inaccessible view error message when he logs in.
i. Locate the Service Contact Detail View and mark it as a Read Only view by checking the
checkbox.
j. Click Add in the Users pane. A list of available users is shown.
k. Select Norman Bohr and click OK. He is added as a user to the responsibility.
l. Click the Tab Layout tab. This allows you to customize which screen and view tabs are
available in each application for each responsibility when the user initially logs in. Once the
user has logged in, they can change their personal tab layout to suit their preferences.
m. Query for an application name of Siebel Universal Agent. This is the name of the Siebel
Call Center application. What screen tabs are shown in what order for this application and
this responsibility?

n. Click Clear Cache near the top of the screen.


o. Log in to the Siebel Call Center application as NBOHR/NBOHR. Confirm that you now
have access to the Home Page View (WCC). Notice that not all of the screen tabs you found
above are shown. Why might this be?
Hint: Does NBOHR have access to any of the views under the missing screen tabs?

p. Navigate to Contacts > Contact List.


q. Confirm that you cannot create a new record. This is because you marked this view as Read
Only.
r. Log out as NBOHR.

7. You will finally add a second responsibility to NBOHR, label the Call Center Representative -
Modified responsibility as the primary responsibility, and confirm that NBOHR still sees all of
the views available to either responsibility.
a. Return to the Siebel Call Center application where you are logged in as SADMIN.
b. Navigate to Administration – User > Users. This is the user administration screen, and allows
you to directly edit the responsibilities assigned to a user.
c. Select Norman Bohr. His details are shown in the lower applet.

Siebel 8.0 Essentials 27


Module 4: Responsibilities and Views

d. Click the Select icon next to the Responsibility field. Be careful not to select the New
Responsibility field.
e. Query for the Call Center Manager responsibility.
f. Click Add to add it to NBOHR’s responsibilities.
g. Verify that the Primary checkbox next to Call Center Representative - Modified is checked
to mark it as the primary responsibility for NBOHR. This ensures the initial tab layout
NBOHR will see when logging in is the one associated with the modified responsibility.
h. Click OK.
i. Navigate to the Administration - Application > Responsibilities screen.
j. Click the Clear Cache button to clear the Responsibilities cache.
k. Log in to the Siebel Call Center application as NBOHR. Notice the additional tabs; the
Quotes and Sales Orders tabs are now visible because NBOHR has access to views on those
screens.
l. Navigate to Contacts > Contact List and note that the New button is now enabled. Although
NBOHR’s primary responsibility of Call Center Representative - Modified lists this view as
Read Only, his secondary responsibility of Call Center Manager has the same view with
read/write permission. The union of the two responsibilities gives NBOHR the more
permissive permission; that is, he has write access because at least one of his responsibilities
has write access. You can confirm this by returning to the Siebel Call Center application
where you are logged in as SADMIN and examining the Call Center Manager responsibility
to confirm that it contains the Service Contact Detail View with the Read Only flag
unchecked.

8. Log out of the Siebel Call Center application where you are logged in as NBOHR and close the
browser.

28 Siebel 8.0 Essentials


Module 4: Responsibilities and Views

Solutions 4-1 Exploring Responsibilities and Views


(Guided)

Answers
2.b. Query for the Call Center Representative - SMC responsibility. Notice that more than
one view is associated with this responsibility. Which users have this responsibility?
The Siebel Administrator and Norman Bohr.

3.b. What do you see when you first log in?


You see an error message that the responsibility of the user does not allow accessing the
Home Page view.

3.c. Switch back to the Call Center application where you are logged in as SADMIN and query
for Home Page in the view name. Does the Home Page view appear in the list of views for
the Call Center Representative - SMC responsibility? Is this what you expected to see?
No; the Home Page view does not appear in the list of views for this responsibility. This is
what you should expect to see when you receive that error message.

4.b. Select Help > About View. What is the name of the home page view for Siebel Call
Center?
Home Page View (WCC).

4.e. Query for Home Page. Does the view you found above appear in the list of home page
views?
Yes.

5.j. Log in to the Siebel Call Center application as NBOHR/NBOHR. What do you notice?
There are no longer any tabs visible at the top of the screen.

6.m. Query for an application name of Siebel Universal Agent. This is the name of the Siebel
Call Center application. What screen tabs are shown in what order for this application and
this responsibility?
Home, Accounts, Contacts, Opportunities, Quotes, Sales Orders, and Service. The rest are
marked as hidden.

6.o. Log in to the Siebel Call Center application as NBOHR/NBOHR. Confirm that you now
have access to the Home Page View (WCC). Notice that not all of the screen tabs you found
above are shown. Why might this be?
Screen tabs only appear if the user’s responsibilities contain at least one view associated
with that screen. Since NBOHR’s responsibility does not include any Quotes or Sales Orders
views, those screen tabs do not appear.

Siebel 8.0 Essentials 29


Module 4: Responsibilities and Views

30 Siebel 8.0 Essentials


Module 5: Users, Positions, and Organizations

Lab 5-1 Creating the Company Structure


(Unguided)

Goals To implement a division hierarchy including divisions, organizations, positions, and


users

Time 20 – 25 minutes

Instructions:
In this lab you will extend an existing division hierarchy. You will implement the company structure
for a fictitious ABC Company, allowing you to explore Access Control in greater detail in later labs.
Because a richer company structure provides better examples of Access Control, some of the
structure has already been created for you in the database. You will implement the following
company structure:

Default Organization (Organization) Already exists as seed data


ABC Company (Division)
CEO (Position): Mark Planck

ABC Western Region (Organization)


VP of Sales - West (Position): Mary West

ABC Northwestern Region (Division)


Sales Rep NW1 (Position): Maxwell Westerly

ABC Southwestern Region (Division)


Sales Rep SW1 (Position): Raj Westerman

ABC Eastern Region (Organization)


ABC VP of Sales - East (Position): Natasha East

ABC Northeastern Region (Division)


ABC Sales Rep NE1 (Position): Catherine Eastman

ABC Southeastern Region (Division)


ABC Sales Rep SE1 (Position): Charles Eastwood

1. Use the Administration - Group > Internal Divisions view to extend the division structure of
ABC Company. The final hierarchy should appear as follows:

Siebel 8.0 Essentials 31


Module 5: Users, Positions, and Organizations

Default Organization LEGEND


Division
ABC Company Organization

ABC Western ABC Eastern


Region Region

ABC ABC ABC ABC


Northwestern Southwestern Northeastern Southeastern
Region Region Region Region

2. Use the Administration - Group > Positions view to create positions for the ABC Company.
Unlike responsibilities, the Siebel application comes with only four seed positions, and you must
create the rest to match your company’s structure. Also unlike responsibilities or divisions,
positions, including seed positions, can be deleted. When creating positions, consider:
- Although positions and employees are in a M:M relationship, most positions should contain
only one employee unless their job is completely interchangeable with another. A customer
might not mind working with three different call center representatives on a single problem, but
how would a customer feel about working with three different sales representatives? This is a
question only your company can answer, and it determines whether the three sales
representatives have three different positions, or all share one position.
- Also, data visibility is affected by position, hence unless those three sales representatives
should see the same accounts, they should have different positions.
- Positions do not have to report to parent positions within their organization. For example, if a
sales representative moved from the Western Region to the Eastern region, that sales
representative might still want to report to VP of the Western Region, outside of the sales rep’s
organization.

The final position hierarchy should look as follows. Note that the positions for the Western
organization are not prefixed with “ABC”. This is to help you easily distinguish the positions

32 Siebel 8.0 Essentials


Module 5: Users, Positions, and Organizations

you created from those pre-populated for this and other labs in the course:

3. Use the Administration - User > Employees view to create the eastern region employees and
assign positions to them. Use their first initial and last name as their User ID (for example,
NEAST or CEASTWOOD), and leave their responsibilities as Siebel Administrator. Your final
assignments should be as follows:

Default Organization (Organization) Already exists as seed data


ABC Company (Division)
CEO (Position): Mark Planck

ABC Western Region (Organization)


VP of Sales - West (Position): Mary West

ABC Northwestern Region (Division)


Sales Rep NW1 (Position): Maxwell Westerly

ABC Southwestern Region (Division)


Sales Rep SW1 (Position): Raj Westerman

ABC Eastern Region (Organization)


ABC VP of Sales - East (Position): Natasha East

ABC Northeastern Region (Division)


ABC Sales Rep NE1 (Position): Catherine Eastman

ABC Southeastern Region (Division)


ABC Sales Rep SE1 (Position): Charles Eastwood

Siebel 8.0 Essentials 33


Module 5: Users, Positions, and Organizations

34 Siebel 8.0 Essentials


Module 5: Users, Positions, and Organizations

Lab 5-1 Creating the Company Structure (Guided)

Goals To implement a division hierarchy including divisions, organizations, positions, and


users

Time 20 – 25 minutes

Instructions:
In this lab you will explore and extend an existing division hierarchy. You will implement the
company structure for a fictitious ABC Company, allowing you to explore Access Control in greater
detail in later labs. Because a richer company structure provides better examples of Access Control,
some of the structure has already been created for you in the database. You will implement the
following company structure:

Default Organization (Organization) Already exists as seed data


ABC Company (Division)
CEO (Position): Mark Planck

ABC Western Region (Organization)


VP of Sales - West (Position): Mary West

ABC Northwestern Region (Division)


Sales Rep NW1 (Position): Maxwell Westerly

ABC Southwestern Region (Division)


Sales Rep SW1 (Position): Raj Westerman

ABC Eastern Region (Organization)


ABC VP of Sales - East (Position): Natasha East

ABC Northeastern Region (Division)


ABC Sales Rep NE1 (Position): Catherine Eastman

ABC Southeastern Region (Division)


ABC Sales Rep SE1 (Position): Charles Eastwood

1. You will first explore and extend the division structure of ABC Company. The final hierarchy
should appear as follows:

Siebel 8.0 Essentials 35


Module 5: Users, Positions, and Organizations

Default Organization LEGEND


Division
ABC Company Organization

ABC Western ABC Eastern


Region Region

ABC ABC ABC ABC


Northwestern Southwestern Northeastern Southeastern
Region Region Region Region

a. If necessary, start Siebel Call Center and log in as SADMIN/SADMIN.


b. Navigate to Administration - Group > Internal Divisions. This view shows all of the existing
organizations and divisions. Those starting with ABC are the pre-populated ABC entries for
this training. Those without an ABC are the seed entities that are created when the Siebel
application is installed. There are three seed entities. What are they?

c. Click Organizations in the link bar near the top of the screen. This view shows only the
organizations. Which of the divisions you found above is an organization?

d. Click Internal Divisions to return to the Internal Divisions view. Because you can enter both
divisions and organizations in this view and it allows you to view the entire company
hierarchy, it is more common to add divisions and organizations from this view.
e. In the Tree applet, click the + sign for Default Organization to expand its hierarchy. The
child divisions of Default Organization are shown. Notice that the explorer tree shows each
division at the top level of the hierarchy for ease of navigation and also shows it within the
correct hierarchy. What are the child divisions of Default Organization?

f. In the Tree applet, expand the ABC Company hierarchy. Notice that the ABC Western
Region has already been entered. Expand the ABC Western Region and confirm that the
ABC Northwestern Region and ABC Southwestern Region have already been entered.

36 Siebel 8.0 Essentials


Module 5: Users, Positions, and Organizations

g. Select ABC Western Region in the explorer tree. In the bottom applet, notice that the Parent
Division is now listed as ABC Company. When you create new divisions with ABC Western
Region selected, they will automatically have the same parent. You can also override this, as
you will do below.
h. Click New in the top applet to create a new division.
i. Enter ABC Eastern Region as the division name. Notice that Currency is a required field
that has already been filled in for you in the form applet as the default currency for the
application. Note that divisions may also optionally have addresses and types assigned to
them.
j. Check the Organization Flag. Be very careful when checking this flag; once the record is
saved and the division is marked as an organization, it cannot be undone.
k. Step off the record to save it.
l. Create the ABC Northeastern Region as follows:
i. Click New to create a new division.
ii. Enter ABC Northeastern Region as the division name.
iii. Click the Select button next to Parent Division in the form applet. All of the available
parent divisions are shown.
iv. Select ABC Eastern Region as the parent division and click OK. Notice that the
required Organization Name field is now populated. The organization is the organization
to which the parent division belongs.
v. Ensure that the Organization Flag is not checked.
Note: If you accidentally label one of the divisions an organization, you will need to
rename it and try again, as you cannot delete a division or undo making a division an
organization.
vi. Step off the record to save it.
m. Follow similar steps to create the ABC Southeastern Region division.
n. Refresh the Explorer view by clicking the – sign next to the Divisions folder. Now expand it
by clicking the + sign. You will see the seven ABC Company divisions. Expand ABC
Company to see the division hierarchy. Continue this process to fully expand the ABC
Company division hierarchy. Make sure it matches the picture below. Although you cannot

Siebel 8.0 Essentials 37


Module 5: Users, Positions, and Organizations

delete divisions, you can change the parents or rename them if you made an error.

2. You will next explore and create positions for the ABC Company. Unlike responsibilities, the
Siebel application comes with only four seed positions, and you must create the rest to match
your company’s structure. Also unlike responsibilities or divisions, positions, including seed
positions, can be deleted. When creating positions, consider:
- Although positions and employees are in a M:M relationship, most positions should contain
only one employee unless their job is completely interchangeable with another. A customer
might not mind working with three different call center representatives on a single problem, but
how would a customer feel about working with three different sales representatives? This is a
question only your company can answer, and it determines whether the three sales
representatives have three different positions, or all share one position.
- Also, data visibility is affected by position, hence unless those three sales representatives
should see the same accounts, they should have different positions.
- Positions do not have to report to parent positions within their organization. For example, if a
sales representative moved from the Western Region to the Eastern region, that sales
representative might still want to report to VP of the Western Region, outside of the sales rep’s
organization.

The final position hierarchy should look as follows. Note that the positions for the Western
organization are not prefixed with “ABC”. This is to help you easily distinguish the positions

38 Siebel 8.0 Essentials


Module 5: Users, Positions, and Organizations

you created from those pre-populated for this and other labs in the course:

a. In the link bar, click Positions. Query for the Siebel Administrator position. How can there
be two positions with the same name?

b. Notice that the position explorer tree lists the primary employee for each position. Who is the
primary employee for the ERM AnonUser position?

c. In the Positions list applet, click New. Create a position record with the following values:
Division ABC Eastern Region
Position ABC VP of Sales, East
Parent Position CEO

d. Similarly, create the following positions:


Division ABC Northeastern Region
Position ABC Sales Rep NE1
Parent Position ABC VP of Sales, East

Division ABC Southeastern Region


Position ABC Sales Rep SE1
Parent Position ABC VP of Sales, East
e. In the Positions list or Explorer view, verify that you have created all of the above positions
correctly. Make any modifications, if necessary.

3. You will now create employees for ABC Company and assign positions to them. As in the
previous steps, the ABC Western Region has been completed for you.
a. Navigate to Administration - User > Employees. Note that there are four seed employees:
Administrator, Employee, Guest, and Queue. The other employees were added for this and
other labs. You will enter the rest of the employees.

Siebel 8.0 Essentials 39


Module 5: Users, Positions, and Organizations

b. Click New to create a new employee.


c. Enter East as the employee’s last name.
d. Enter Natasha as the employee’s first name.
e. Enter ABC VP of Sales, East as the employee’s Job Title. Note that Job Title is an optional
field that does not necessarily need to match the employee’s position or any other position. It
should be the employee’s actual job title, whereas the position may be a more generic term or
may even be a code.
f. Enter NEAST as the employee’s user ID. By convention, the user name is in all caps with no
special characters. This supports situations where the user ID may be passed to other
programs such as the database server for authentication purposes, so special characters
should be avoided.
g. Leave the Responsibility as its default Siebel Administrator. In real circumstances you
would change this to limit the views available to the employees. For the sake of this lab, you
will be logging in as several of these employees and you may need access to the entire
application, hence we leave it as its default.
h. Select Natasha East’s position:
i. Click the Select button in the Position field. The available positions are listed. Note
that only a few of them have names associated with them. Those without names are
unfilled positions; no employees have been assigned to them. Those with names list
the name of the primary employee in each position.
ii. Select ABC VP of Sales, East as the position.
iii. Click Add.
iv. Click OK.
i. Leave Natasha East’s organization as the Default Organization. This organization is not used
to determine which records Natasha can access; rather it is used to determine who has access
to her employee record.
j. Step off the record to save it.
k. Add two more employees as shown in the table below:
Last First Job Title User ID Responsibility Position
Name Name
Eastman Catherine ABC Sales Rep NE1 CEASTMAN Siebel ABC Sales Rep NE1
Administrator
Eastwood Charles ABC Sales Rep SE1 CEASTWOOD Siebel ABC Sales Rep SE1
Administrator

4. Log out of Siebel Call Center and leave the browser open on the login screen.

5. You will finally confirm that you successfully added the employees.
a. Log in to Siebel Call Center as CEASTMAN/CEASTMAN. If you cannot log in, log in as
SADMIN/SADMIN and confirm that you entered her User ID correctly.
b. Log out and log in as CEASTWOOD/CEASTWOOD. You should log in successfully.

6. Log out of Siebel Call Center.

40 Siebel 8.0 Essentials


Module 5: Users, Positions, and Organizations

Solutions 5-1 Creating the Company Structure (Guided)

Answers:
1.b. Navigate to Administration - Group > Internal Divisions. This view shows all of the
existing organizations and divisions. Those starting with ABC are the pre-populated ABC
entries for this training. Those without an ABC are the seed entities that are created when
the Siebel application is installed. There are three seed entities. What are they?
Default Organization, ERM AnonUser, and Siebel Administration

1.c. Click Organizations in the link bar near the top of the screen. This view shows only the
organizations. Which of the divisions you found above is an organization?
Default Organization is an organization.

1.e. In the Tree applet, click the + sign for Default Organization to expand its hierarchy. The
child divisions of Default Organization are shown. Notice that the explorer tree shows each
division at the top level of the hierarchy for ease of navigation and also shows it within the
correct hierarchy. What are the child divisions of Default Organization?
ABC Company and Siebel Administration.

2.a. In the link bar, click Positions. Query for the Siebel Administrator position. How can there
be two positions with the same name?
Positions are assigned to divisions, hence two positions with the same name can be in two
different divisions. Note that the first Siebel Administrator is part of the Siebel
Administration division, while the other is part of the Default Organization. Hence there is
no conflict.

2.b. Notice that the position explorer tree lists the primary employee for each position. Who is
the primary employee for the ERM AnonUser position?
ERM Guest, one of the seed employees.

Siebel 8.0 Essentials 41


Module 5: Users, Positions, and Organizations

42 Siebel 8.0 Essentials


Module 6: Controlling Access to Customer Data

Lab 6-1 Exploring View Filters (Unguided)

Goals To understand how view filters use users, positions, and organizations to control user
access to customer data

Time 15 – 20 minutes

Instructions:
In this lab, you will explore how access to customer data is controlled using employees, positions,
and organizations. You will explore Opportunities, which are controlled by position and
organization. Each opportunity is associated with a sales team consisting of one or more positions
and is also associated directly with one or more organizations. In each case, you will determine what
you expect to see for a given visibility filter and you will then confirm your expectations.

You will first explore Opportunities from the point of view of an individual user. You will configure
three Opportunities and examine how their visibility is affected by the various view filters. Refer
back to this table when answering visibility questions:
Opportunity Name Sales Team Organization
50 Laptops to ABC Sales Rep SW1: Raj Westerman (Primary) ABC Western Region
CPC ABC Sales Rep NE1: Catherine Eastman
120 Servers to ABC Sales Rep NW1: Maxwell Westerly (Primary) ABC Western Region
ABA
75 Printers to ABC Sales Rep SE1: Charles Eastwood (Primary) ABC Eastern Region
TWA ABC Sales Rep SW1: Raj Westerman

1. You will first configure the Opportunities in the system. Since the primary defaults to the creator
of the record, you will create the 75 Printers to TWA opportunity as CEASTWOOD.
a. Start Siebel Call Center and log in as CEASTWOOD/CEASTWOOD.
Create a new Opportunity named 75 Printers to TWA. Who is the default primary for this
Opportunity?

b. Add Raj Westerman to the sales team for this opportunity.


c. Add Catherine Eastman to the sales team for the 50 Laptops to CPC opportunity.
d. Log out of Siebel Call Center.

Siebel 8.0 Essentials 43


Module 6: Controlling Access to Customer Data

2. You will next explore the view filters from the point of view of a position with no reports. Recall
that Raj Westerman holds the position of ABC Sales Rep SW1 and belongs to the ABC
Southwest division, which is part of the ABC Western Region organization:
Name Position Position Position Parent Position
Division Organization
Raj Westerman ABC Sales Rep SW1 ABC ABC Western ABC VP of Sales,
Southwestern Region West
Region
a. Log in to the Siebel Call Center application as RWESTERMAN/RWESTERMAN.
b. Navigate to the Opportunities List view. What is the default view filter for Raj Westerman?

c. What Opportunities should Raj Westerman see in this view? Does he see them?
Hint: Refer back to the table of Opportunities at the beginning of this lab to refresh your
memory.

d. What Opportunities should Raj Westerman see using the My Team’s Opportunities view?
Does he see them?

e. What opportunities should Raj Westerman see using the All Opportunities view? Does he
see them?

f. What opportunities should Raj Westerman see using the All Opportunities Across My
Organizations view? Does he see them?

g. What opportunities should Raj Westerman see using the All Opportunities Across
Organizations view? Does he see them?

h. Log out of Siebel Call Center.

3. You will next explore the view filters from the point of view of the ABC Eastern Region
manager, Natasha East. As a reminder, only the 75 Printers to TWA opportunity is assigned the
ABC Eastern Region organization, while Catherine Eastman is on the 50 Laptops to CPC sales
team, but is not the primary.
a. Log in to Siebel Call Center as NEAST/NEAST.
b. Navigate to the Opportunities List view.
c. Confirm that the My Opportunities view contains no records.
d. Confirm that the My Team’s Opportunities view contains only the 75 Printers to TWA
opportunity. Why does it not show the 50 Laptops to CPC opportunity?

44 Siebel 8.0 Essentials


Module 6: Controlling Access to Customer Data

e. Confirm that the All Opportunities and All Opportunities Across My Organizations
views show only the 75 Printers to TWA opportunity.
f. Log out of Siebel Call Center.

4. You will finally verify that the company CEO, Mark Planck, sees opportunities from both his
direct reports and their reports as well.
a. Log in to Siebel Call Center as MPLANCK/MPLANCK.
b. Confirm that Mark Planck sees all three opportunities in his My Team’s Opportunities
view. Since his direct reports are not on any of the sales teams, this confirms that Mark
Planck is seeing opportunities from both his direct reports and those who report to them.
c. Confirm that Mark Planck sees only the 5 x Lagerstatte 25 GB SAN and Eternal Storage
10 TB NAS opportunities in his All Opportunities view. His organization is the Default
Organization, which is not associated with any of the opportunities from this lab.
d. Confirm that Mark Planck sees all five opportunities in his All Opportunities Across My
Organizations view. This view includes all of the child organizations of the Default
Organization, including the ABC Eastern Region and ABC Western Region organizations.
e. Log out of Siebel Call Center.

Siebel 8.0 Essentials 45


Module 6: Controlling Access to Customer Data

Solutions 6-1 Exploring View Filters (Unguided)

Answers
1.e. Create a new Opportunity named 75 Printers to TWA. Who is the default primary for this
Opportunity?
CEASTWOOD. The default primary team member is the creator of the record.

2.c. Click Opportunities List in the view link bar. What is the default view filter for the
Opportunities list for Raj Westerman?
The My Opportunities view.

2.d. What Opportunities should Raj Westerman see in this view? Does he see them?
He should see the 50 Laptops to CPC and 75 Printers to TWA opportunities, as his
position is on the sales team for both of them. Yes, he sees all opportunities for which his
position is on the sales team.

2.e. Before selecting the next view, answer the following question: What Opportunities should
Raj Westerman see using the My Team’s Opportunities view? Does he see them?
He should see the 50 Laptops to CPC opportunity. Yes, he sees it. The My Team’s
Opportunities view filter shows all opportunities for which Raj Westerman’s position or
one of his direct or indirect reports’ positions is the primary on that opportunity. Since Raj
Westerman has no reports, the view will only show opportunities for which his position is
the primary. Only the 50 Laptops to CPC opportunity satisfies this condition, so only the
50 Laptops to CPC opportunity should be shown.

2.g. What opportunities should Raj Westerman see using the All Opportunities view? Does he
see them?
He should see the 50 Laptops to CPC and 120 Servers to ABA opportunities. Yes, he sees
them. His position is assigned the ABC Western Organization, which includes the 50
Laptops to CPC and 120 Servers to ABA opportunities, but not the 75 Printers to TWA
opportunity. Notice that the 75 Printers to TWA opportunity appears in the My
Opportunities view but not the All Opportunities view.

2.i. What opportunities should Raj Westerman see using the All Opportunities Across My
Organizations view? Does he see them?
He should see the 50 Laptops to CPC and 120 Servers to ABA opportunities. Yes, he sees
them. The All Opportunities Across My Organizations view shows all opportunities in his
position’s organization and all its sub-organizations. The ABC Western Region
organization has no sub-organizations, so this view will not differ from the All
Opportunities view.

2.k. What opportunities should Raj Westerman see using the All Opportunities Across
Organizations view? Does he see them?
He should see the 50 Laptops to CPC, 120 Servers to ABA, 75 Printers to TWA, 5 x

46 Siebel 8.0 Essentials


Module 6: Controlling Access to Customer Data

Lagerstatte 25 GB SAN, and Eternal Storage 10 TB NAS opportunities. He should see all
of the opportunities that are assigned an organization.

3.d. Confirm that the My Team’s Opportunities view contains only the 75 Printers to TWA
opportunity. Why does it not show the 50 Laptops to CPC opportunity?
It does not show the 50 Laptops to CPC opportunity because Catherine Eastman’s position
is not the primary position of the sales team for that opportunity.

Siebel 8.0 Essentials 47


Module 6: Controlling Access to Customer Data

48 Siebel 8.0 Essentials


Module 6: Controlling Access to Customer Data

Lab 6-1 Exploring View Filters (Guided)

Goals To understand how view filters use users, positions, and organizations to control user
access to customer data

Time 15 – 20 minutes

Instructions:
In this lab, you will explore how access to customer data is controlled using employees, positions,
and organizations. You will explore Opportunities, which are controlled by position and
organization. Each opportunity is associated with a sales team consisting of one or more positions
and is also associated directly with one or more organizations. In each case, you will determine what
you expect to see for a given visibility filter and you will then confirm your expectations.

You will first explore Opportunities from the point of view of an individual user. You will configure
three Opportunities and examine how their visibility is affected by the various view filters. Refer
back to this table when answering visibility questions:
Opportunity Name Sales Team Organization
50 Laptops to ABC Sales Rep SW1: Raj Westerman (Primary) ABC Western Region
CPC ABC Sales Rep NE1: Catherine Eastman
120 Servers to ABC Sales Rep NW1: Maxwell Westerly (Primary) ABC Western Region
ABA
75 Printers to ABC Sales Rep SE1: Charles Eastwood (Primary) ABC Eastern Region
TWA ABC Sales Rep SW1: Raj Westerman

1. You will first configure the Opportunities in the system. Since the primary defaults to the creator
of the record, you will create the 75 Printers to TWA opportunity as CEASTWOOD.
a. Start Siebel Call Center and log in as CEASTWOOD/CEASTWOOD.
Note: If you cannot log in, confirm that you created Charles Eastwood as an employee in a
previous lab.
b. Click the Opportunities tab.
c. Click Opportunities List in the link bar. The My Opportunities view is shown.
d. Select All Opportunities Across Organizations in the visibility filter drop-down list. The
50 Laptops to CPC and 120 Servers to ABA opportunities should be visible, as well as the
two opportunities from other labs. (5 x Lagerstatte 25 GB SAN and Eternal Storage 10 TB
NAS).
e. Create a new Opportunity named 75 Printers to TWA. Who is the default primary for this
Opportunity?

Siebel 8.0 Essentials 49


Module 6: Controlling Access to Customer Data

f. Press the Select button next to Sales Team in the lower applet. The Team Members shuttle
applet is displayed.
g. Select Raj Westerman and click Add to add him to the sales team for this Opportunity.
h. Click OK to close the shuttle applet.
i. Select the 50 Laptops to CPC Opportunity.
j. Using the same steps as above, add Catherine Eastman to the sales team.
Note: If Catherine Eastman does not appear as an available employee, confirm that you
created her in a previous lab.
k. Log out of Siebel Call Center.

2. You will next explore the view filters from the point of view of a position with no reports. Recall
that Raj Westerman holds the position of ABC Sales Rep SW1 and belongs to the ABC
Southwest division, which is part of the ABC Western Region organization:
Name Position Position Position Parent Position
Division Organization
Raj Westerman ABC Sales Rep SW1 ABC ABC Western ABC VP of Sales,
Southwestern Region West
Region
a. Log in to the Siebel Call Center application as RWESTERMAN/RWESTERMAN.
b. Click the Opportunities tab.
c. Click Opportunities List in the view link bar. What is the default view filter for the
Opportunities list for Raj Westerman?

d. What Opportunities should Raj Westerman see in this view? Does he see them?
Hint: Refer back to the table of Opportunities at the beginning of this lab to refresh your
memory.

e. Before selecting the next view, answer the following question: What Opportunities should
Raj Westerman see using the My Team’s Opportunities view?

f. Select the My Team’s Opportunities view from the visibility filter drop-down list and
confirm your result. Note that Raj Westerman has access to all of the visibility filters. This is
because we assigned him the Siebel Administrator responsibility.
g. What opportunities should Raj Westerman see using the All Opportunities view?

h. Select the All Opportunities view from the visibility filter drop-down list and confirm that
you see the opportunities you listed above.
i. What opportunities should Raj Westerman see using the All Opportunities Across My
Organizations view?

50 Siebel 8.0 Essentials


Module 6: Controlling Access to Customer Data

j. Select the All Opportunities Across My Organizations view from the visibility filter drop-
down list and confirm your result.
k. What opportunities should Raj Westerman see using the All Opportunities Across
Organizations view?

l. Select the All Opportunities Across Organizations view from the visibility filter drop-
down list and confirm your result.
m. Log out of Siebel Call Center.

3. You will next explore the view filters from the point of view of the ABC Eastern Region
manager, Natasha East. Since you now have some familiarity with the view filters, the steps are
abbreviated here. As a reminder, only the 75 Printers to TWA opportunity is assigned the ABC
Eastern Region organization, while Catherine Eastman is on the 50 Laptops to CPC sales team,
but is not the primary.
a. Log in to Siebel Call Center as NEAST/NEAST.
b. Navigate to the Opportunities List view.
c. Confirm that the My Opportunities view contains no records.
d. Confirm that the My Team’s Opportunities view contains only the 75 Printers to TWA
opportunity. Why does it not show the 50 Laptops to CPC opportunity?

e. Confirm that the All Opportunities and All Opportunities Across My Organizations
views show only the 75 Printers to TWA opportunity.
f. Log out of Siebel Call Center.

4. You will finally verify that the company CEO, Mark Planck, sees opportunities from both his
direct reports and their reports as well.
a. Log in to Siebel Call Center as MPLANCK/MPLANCK.
b. Confirm that Mark Planck sees all three opportunities in his My Team’s Opportunities
view. Since his direct reports are not on any of the sales teams, this confirms that Mark
Planck is seeing opportunities from both his direct reports and those who report to them.
c. Confirm that Mark Planck sees only the 5 x Lagerstatte 25 GB SAN and Eternal Storage
10 TB NAS opportunities in his All Opportunities view. His organization is the Default
Organization, which is not associated with any of the opportunities from this lab.
d. Confirm that Mark Planck sees all five opportunities in his All Opportunities Across My
Organizations view. This view includes all of the child organizations of the Default
Organization, including the ABC Eastern Region and ABC Western Region organizations.
e. Log out of Siebel Call Center.

Siebel 8.0 Essentials 51


Module 6: Controlling Access to Customer Data

Solutions 6-1 Exploring View Filters (Guided)

Answers
1.e. Create a new Opportunity named 75 Printers to TWA. Who is the default primary for this
Opportunity?
CEASTWOOD. The default primary team member is the creator of the record.

2.c. Click Opportunities List in the view link bar. What is the default view filter for the
Opportunities list for Raj Westerman?
The My Opportunities view.

2.d. What Opportunities should Raj Westerman see in this view? Does he see them?
He should see the 50 Laptops to CPC and 75 Printers to TWA opportunities, as his
position is on the sales team for both of them. Yes, he sees all opportunities for which his
position is on the sales team.

2.e. Before selecting the next view, answer the following question: What Opportunities should
Raj Westerman see using the My Team’s Opportunities view?
He should see the 50 Laptops to CPC opportunity. The My Team’s Opportunities view
filter shows all opportunities for which Raj Westerman’s position or one of his direct or
indirect reports’ positions is the primary on that opportunity. Since Raj Westerman has no
reports, the view will only show opportunities for which his position is the primary. Only
the 50 Laptops to CPC opportunity satisfies this condition, so only the 50 Laptops to CPC
opportunity should be shown.

2.g. What opportunities should Raj Westerman see using the All Opportunities view?
He should see the 50 Laptops to CPC and 120 Servers to ABA opportunities. His position
is assigned the ABC Western Organization, which includes the 50 Laptops to CPC and 120
Servers to ABA opportunities, but not the 75 Printers to TWA opportunity. Notice that the
75 Printers to TWA opportunity appears in the My Opportunities view but not the All
Opportunities view.

2.i. What opportunities should Raj Westerman see using the All Opportunities Across My
Organizations view?
He should see the 50 Laptops to CPC and 120 Servers to ABA opportunities. The All
Opportunities Across My Organizations view shows all opportunities in his position’s
organization and all its sub-organizations. The ABC Western Region organization has no
sub-organizations, so this view will not differ from the All Opportunities view.

2.k. What opportunities should Raj Westerman see using the All Opportunities Across
Organizations view?
He should see the 50 Laptops to CPC, 120 Servers to ABA, 75 Printers to TWA, 5 x
Lagerstatte 25 GB SAN, and Eternal Storage 10 TB NAS opportunities. He should see all
of the opportunities that are assigned an organization.

52 Siebel 8.0 Essentials


Module 6: Controlling Access to Customer Data

3.d. Confirm that the My Team’s Opportunities view contains only the 75 Printers to TWA
opportunity. Why does it not show the 50 Laptops to CPC opportunity?
It does not show the 50 Laptops to CPC opportunity because Catherine Eastman’s position
is not the primary position of the sales team for that opportunity.

Siebel 8.0 Essentials 53


Module 6: Controlling Access to Customer Data

54 Siebel 8.0 Essentials


Module 6: Controlling Access to Customer Data

Lab 6-2 Exploring Positions (Unguided)

Goals To understand how an employee’s current position affects the data he or she sees

Time 5 – 10 minutes

Instructions:
In this lab, you will add the ABC Sales Rep SE1 position to Raj Westerman and observe how it
affects his visibility filters.

Recall these opportunities from the previous lab:


Opportunity Name Sales Team Organization
50 Laptops to ABC Sales Rep SW1: Raj Westerman (Primary) ABC Western Region
CPC ABC Sales Rep NE1: Catherine Eastman
120 Servers to ABC Sales Rep NW1: Maxwell Westerly (Primary) ABC Western Region
ABA
75 Printers to ABC Sales Rep SE1: Charles Eastwood (Primary) ABC Eastern Region
TWA ABC Sales Rep SW1: Raj Westerman

1. Log in to the Siebel Call Center application as RWESTERMAN/RWESTERMAN and use the
Administration - User > Employees view to add the ABC Sales Rep SE1 position to Raj
Westerman. You will need to log out and log in again to see the change.

2. Explore how this affects the changes to the various view filters.
a. If necessary, log in to Siebel Call Center as RWESTERMAN/RWESTERMAN.
b. Navigate to the Opportunities List view. Note that the My Opportunities view shows the
same opportunities as in the previous lab. These opportunities are those for which Raj
Westerman’s position is on the sales team. This is an important distinction from Raj
Westerman himself being on the sales team, as you will see when you change Raj
Westerman’s current position and observe the effects.
c. Change Raj Westerman’s current position to the ABC Sales Rep SE1 record.
d. Before navigating to the My Opportunities view, answer the following question: What
opportunities will Raj Westerman now see in his My Opportunities view? Why?

e. Navigate to the My Opportunities view and confirm your answer.


f. What opportunities should Raj Westerman now see in the All Opportunities view?

Siebel 8.0 Essentials 55


Module 6: Controlling Access to Customer Data

g. Select the All Opportunities view and confirm your answer.


h. What opportunities should Raj Westerman now see in the All Opportunities Across My
Organizations view?

i. Log out of Siebel Call Center.

56 Siebel 8.0 Essentials


Module 6: Controlling Access to Customer Data

Solutions 6-2 Exploring Positions (Unguided)

Answers
2.d. Before navigating to the My Opportunities view, answer the following question: What
opportunities will Raj Westerman now see in his My Opportunities view? Why?
He will see only the 75 Printers to TWA opportunity. Charles Eastwood’s position of ABC
Sales Rep SE1 is on the sales team for that opportunity, so now that Raj Westerman is in
that position, he will see that record. This shows that whereas a user sees the union of all
of his or her responsibilities, for position-based customer records he or she sees only the
customer records for his or her current position.

2.f. What opportunities should Raj Westerman now see in the All Opportunities view?
Only the 75 Printers to TWA opportunity, as it is the only one assigned the ABC Eastern
Region organization

2.h. What opportunities should Raj Westerman now see in the All Opportunities Across My
Organizations view?
Only the 75 Printers to TWA opportunity. Although Raj Westerman is assigned positions in
both the ABC Western Region and ABC Eastern Region organizations, only his current
position matters.

Siebel 8.0 Essentials 57


Module 6: Controlling Access to Customer Data

58 Siebel 8.0 Essentials


Module 6: Controlling Access to Customer Data

Lab 6-2 Exploring Positions (Guided)

Goals To understand how an employee’s current position affects the data he or she sees

Time 5 – 10 minutes

Instructions:
In this lab, you will add the ABC Sales Rep SE1 position to Raj Westerman and observe how it
affects his visibility filters.

Recall these opportunities from the previous lab:


Opportunity Name Sales Team Organization
50 Laptops to ABC Sales Rep SW1: Raj Westerman (Primary) ABC Western Region
CPC ABC Sales Rep NE1: Catherine Eastman
120 Servers to ABC Sales Rep NW1: Maxwell Westerly (Primary) ABC Western Region
ABA
75 Printers to ABC Sales Rep SE1: Charles Eastwood (Primary) ABC Eastern Region
TWA ABC Sales Rep SW1: Raj Westerman

1. You will first add the ABC Sales Rep SE1 position to Raj Westerman. He can do it himself
because we gave him the Siebel Administrator responsibility.
a. Log in to the Siebel Call Center application as RWESTERMAN/RWESTERMAN.
b. Navigate to Administration - User > Employees.
c. Select Raj Westerman. You may need to scroll down to see his record.
d. In the form applet, click the select button in the Position field. The Positions Occupied
shuttle applet is shown.
e. Select the ABC Sales Rep SE1 position (with a current primary of Charles Eastwood) and
click Add.
f. Click OK. Raj Westerman is now assigned two positions.
g. Log out of Siebel Call Center. You will need to log out and log in again to see the change.

2. You will next examine the effects of Raj Westerman’s current position on the data that is visible
to him.
a. Log in to Siebel Call Center as RWESTERMAN/RWESTERMAN.
b. Click the Opportunities tab.
c. Click Opportunities List in the view link bar. Note that the My Opportunities view shows
the same opportunities as in the previous lab. These opportunities are those for which Raj
Westerman’s position is on the sales team. This is an important distinction from Raj
Westerman himself being on the sales team, as you will see when you change Raj
Westerman’s current position and observe the effects.
d. Select Tools > User Preferences.

Siebel 8.0 Essentials 59


Module 6: Controlling Access to Customer Data

e. Click Change Position in the view link bar.


f. Select the ABC Sales Rep SE1 record.
g. Click Change Position. The checkbox should now appear next to this record.
h. Before navigating to the My Opportunities view, answer the following question: What
opportunities will Raj Westerman now see in his My Opportunities view? Why?

i. Navigate to the My Opportunities view and confirm your answer.


j. What opportunities should Raj Westerman now see in the All Opportunities view?

k. Select the All Opportunities view and confirm your answer.


l. What opportunities should Raj Westerman now see in the All Opportunities Across My
Organizations view?

m. Log out of Siebel Call Center.

60 Siebel 8.0 Essentials


Module 6: Controlling Access to Customer Data

Solutions 6-2 Exploring Positions (Guided)

Answers
2.h. What opportunities will Raj Westerman now see in his My Opportunities view? Why?
He will see only the 75 Printers to TWA opportunity. Charles Eastwood’s position of ABC
Sales Rep SE1 is on the sales team for that opportunity, so now that Raj Westerman is in
that position, he will see that record. This shows that whereas a user sees the union of all
of his or her responsibilities, for position-based customer records he or she sees only the
customer records for his or her current position.

2.j. What opportunities should Raj Westerman now see in the All Opportunities view?
Only the 75 Printers to TWA opportunity, as it is the only one assigned the ABC Eastern
Region organization

2.l. What opportunities should Raj Westerman now see in the All Opportunities Across My
Organizations view?
Only the 75 Printers to TWA opportunity. Although Raj Westerman is assigned positions in
both the ABC Western Region and ABC Eastern Region organizations, only his current
position matters.

Siebel 8.0 Essentials 61


Module 6: Controlling Access to Customer Data

62 Siebel 8.0 Essentials


Module 7: Catalogs and Master Data

Lab 7-1 Creating a Solutions Catalog (Unguided)

Goals To create catalogs, categories, and access groups, and restrict access to master data
contained in categories.

Time 20 – 25 minutes

Instructions:
In this lab you will explore catalogs, categories, and access groups by implementing a solution
catalog. This catalog contains links between problem descriptions and Frequently Asked Questions
(FAQ) documents, allowing users to quickly navigate to a FAQ related to their problem. You will
build the following catalog. Note that the contact information is public, while the product
information is private. This could be used to require users to register before giving them access to
product information:

Legend
Public Catalog Master Data

Public Category Master Data

Private Category
eService Catalog
About ABC ABC Products
• How to Contact Us ABC Copiers
• ABC Copier - Low Toner
• ABC Copier - Not Working
ABC Fax Machines
• ABC FAX - Copying Documents

1. Use the Administration - Catalog > Catalog Administration view to create the catalog. Recall
that the catalog acts as a container for categories.
a. Start Siebel Call Center and log in as SADMIN/SADMIN.

Siebel Essentials 8.0 63


Module 7: Catalogs and Master Data

b. Create a new catalog with the information below.


Name eService Catalog
Description ABC eService Catalog
Catalog Type eService FAQ
Active TRUE (checked)
c. Navigate to Info Center and confirm that eService Catalog with a description of ABC
eService Catalog now appears in Info Center. Notice that it does not yet have any categories.

2. Add the categories to the catalog. You will first make all of the categories public and confirm
that they are all visible, then you will mark the ABC Products category as private and confirm
that you can no longer see it.
a. Create four new categories for the eService Catalog catalog with the information below.
Name Display Name
About ABC About ABC
ABC Products ABC Products
ABC Copiers ABC Copiers
ABC Fax Machines ABC Fax Machines
b. Demote the ABC Copiers and ABC Fax Machines categories to make them sub categories
of the ABC Products category.
c. Return to Info Center and confirm that the ABC Products and About ABC categories now
appear.
d. Drill down on ABC Products and confirm that the ABC Copiers and ABC Fax Machines
subcategories now appear.

3. Create the solutions to add to your categories. Solutions are text entries that may be used to
provide information or product news to customers viewing the catalog. The FAQ text box is
capable of holding up to 2000 characters. You will enter simple descriptions of what the solution
should contain.
a. Navigate to Administration - Solution > Solutions.
b. Create the following records with the Status Final and Publish Internal and Publish External
boxes both checked.
Name FAQ
ABC Copier - Low Toner How to repair low toner.
ABC Copier – Not Working How to fix copiers.
ABC FAX - Copying a Document How to copy a document.
How to Contact Us How to contact us by phone or
e-mail.

64 Siebel Essentials 8.0


Module 7: Catalogs and Master Data

4. Add the solutions you just created to the appropriate categories and confirm your results.
a. Navigate back to the eService Catalog and add the following solutions to the appropriate
category:
Category Solution
About ABC How to Contact Us
ABC Copiers ABC Copier – Low Toner
ABC Copiers ABC Copier – Not Working
ABC Fax Machines ABC FAX – Copying Document
b. Return to Info Center and confirm your results. Verify that each category reflects the
appropriate solution.

5. Mark the ABC Products category as Private, and verify that the ABC Copiers and ABC Fax
Machines categories are now also marked as Private.

6. Navigate to Info Center and confirm the ABC Products category no longer appears.

7. Use the Administration - Group > Access Groups view to explore creating access groups to
access private categories. Recall that child access groups have more access than parent access
groups, rather than less. You will create one parent and one child access group and confirm this
relationship.
a. Create a new access group and name it ABC Access Group.
b. Create a second access group named ABC Child Access Group and set ABC Access Group
as its parent.
c. Click the Access Groups view link under the Categories tab. This is not the same as the
Access Groups tab above the middle applet. Try to associate the ABC Child Access Group
with the ABC Copiers category. What happens? Why?

d. Associate the ABC Access Group with the ABC Products category. Note that the Cascade
button is now enabled. This button would propagate the ABC Access group to all child
categories in the catalog; that is, to ABC Copiers and ABC Fax Machines. You will not
cascade the access group; instead you will add the ABC Child Access Group to the child
categories.
e. Associate the ABC Child Access Group with the ABC Copiers and ABC Fax categories.
f. Add the Siebel Administrator position to the ABC Access Group. You cannot add individual
users as a party to an access group, but you can add positions, organizations, or user lists. To
add an individual user you would make them the sole member of a user list.
g. Return to Info Center and confirm that the ABC Products category is now visible, while the
ABC Copiers and ABC Fax Machines subcategories are not visible.
h. Remove Siebel Administrator’s position from the ABC Access Group and add it to the ABC
Child Access Group. Since child access groups have more access than parent access groups,

Siebel Essentials 8.0 65


Module 7: Catalogs and Master Data

Siebel Administrator will still be able to see the ABC Products category even though it is not
explicitly assigned the ABC Child Access Group.
i. Return to Info Center and confirm that Siebel Administrator can now see all of the categories
and solutions, even though his position is only included in the ABC Child Access Group.

8. Log out of Siebel Call Center and close the browser.

66 Siebel Essentials 8.0


Module 7: Catalogs and Master Data

Lab 7-1 Creating a Solutions Catalog (Unguided)

Answers:
6.d.vii. Click the Access Groups view link under the Categories tab. This is not the same as the
Access Groups tab above the middle applet. Try to associate the ABC Child Access Group
with the ABC Copiers category. What happens? Why?
An error message is displayed indicating that the access group cannot be added because
the catalog does not contain its parent access group.

Siebel Essentials 8.0 67


Module 7: Catalogs and Master Data

68 Siebel Essentials 8.0


Module 7: Catalogs and Master Data

Lab 7-1 Creating a Solutions Catalog (Guided)

Goals To create catalogs, categories, and access groups, and restrict access to master data
contained in categories.

Time 20 – 25 minutes

Instructions:
In this lab you will explore catalogs, categories, and access groups by implementing a solution
catalog. This catalog contains links between problem descriptions and Frequently Asked Questions
(FAQ) documents, allowing users to quickly navigate to a FAQ related to their problem. You will
build the following catalog. Note that the contact information is public, while the product
information is private. This could be used to require users to register before giving them access to
product information:
Legend
Public Catalog Master Data

Public Category Master Data

Private Category
eService Catalog
About ABC ABC Products
• How to Contact Us ABC Copiers
• ABC Copier - Low Toner
• ABC Copier - Not Working
ABC Fax Machines
• ABC FAX - Copying Documents

1. You will first create the catalog. Recall that the catalog acts as a container for categories.
a. Start Siebel Call Center and log in as SADMIN/SADMIN.
b. Navigate to Administration - Catalog > Catalog Administration. Note that the application
contains several seed catalogs.

Siebel Essentials 8.0 69


Module 7: Catalogs and Master Data

c. In the Catalogs list, create a new catalog with the information below. Catalog type is used to
determine which applets will display the catalog, which is useful when creating catalogs for
customer Web sites. Setting the Active flag means the catalog will immediately be visible in
applets displaying the appropriate catalog type.
Name eService Catalog
Description ABC eService Catalog
Catalog Type eService FAQ
Active TRUE (checked)
d. Use the site map to navigate to Info Center and confirm that eService Catalog with a
description of ABC eService Catalog now appears in Info Center. Notice that it does not yet
have any categories.

2. You will next add the categories to the catalog. Recall that categories are containers for master
data (static, referential data) or other categories. You will first make all of the categories public
and confirm that they are all visible, then you will mark the ABC Products category as private
and confirm that you can no longer see it.
a. Return to the Administration - Catalog > Catalog Administration view.
b. Drill down on the eService Catalog record to navigate to the Categories view.
c. Create four new categories with the information below. Note that they are created in a flat
hierarchy:
Name Display Name
About ABC About ABC
ABC Products ABC Products
ABC Copiers ABC Copiers
ABC Fax Machines ABC Fax Machines
d. With the four records listed in the above order, select the ABC Copiers record and then click
the Demote one level button . Note that there are also Move Down/Move Up buttons so
you can put your categories in the proper order to build the hierarchy.
e. Repeat the above step for the ABC Fax Machines record. Your results should look as
follows:

70 Siebel Essentials 8.0


Module 7: Catalogs and Master Data

f. Return to Info Center and confirm that the ABC Products and About ABC categories now
appear.
g. Drill down on ABC Products and confirm that the ABC Copiers and ABC Fax Machines
subcategories now appear.

3. You will next create the solutions to add to your categories. Solutions are text entries that may be
used to provide information or product news to customers viewing the catalog. The FAQ text
box is capable of holding up to 2000 characters. You will enter simple descriptions of what the
solution should contain.
a. Navigate to Administration - Solution > Solutions.
b. Create the following records with the Status Final and Publish Internal and Publish External
boxes both checked (these fields can be found in the form applet). This ensures that these
records will be visible both internally and externally as soon as they are added to a visible
category.
Name FAQ
ABC Copier - Low Toner How to repair low toner.
ABC Copier – Not Working How to fix copiers.
ABC FAX - Copying a Document How to copy a document.
How to Contact Us How to contact us by phone or
e-mail.

4. You will now add the solutions you just created to the appropriate categories and confirm your
results.
a. Navigate back to the Administration - Catalog > Catalog Administration view and drill down
on the eService Catalog to return to the Categories view.
b. Select the About ABC category record and click the Solutions view link in the bottom
applet to navigate to the Solutions view. Note that you may need to use the drop-down list at
the end of the tab bar to locate this view link.
c. Click New to create a new solution record.
d. In the Add Solutions query window, click the Go button. This invokes a list of available
solutions displaying the solutions you created earlier.
e. Select the How to Contact Us record and click OK.
f. Repeat the above steps to associate the categories and solutions shown below. You will need
to expand the ABC Products category to see the ABC Copiers and ABC Fax Machines
subcategories.
Category Solution
ABC Copiers ABC Copier – Low Toner
ABC Copiers ABC Copier – Not Working
ABC Fax Machines ABC FAX – Copying Document
g. Return to Info Center and confirm your results.
i. Drill down on the About ABC category.
ii. Click the Solution link and confirm that the How to Contact Us solution appears.
iii. Click on the How to Contact Us solution and confirm that the text of the FAQ is
shown.

Siebel Essentials 8.0 71


Module 7: Catalogs and Master Data

iv. Return to Info Center and explore the ABC Products category hierarchy, including
the ABC Copiers and ABC Fax Machines subcategories, to confirm that the other
three solutions also appear in the appropriate locations.

5. You will now mark a category as private.


a. Return to the list of eService Catalog categories.
b. Mark the ABC Products category as Private and step off the record to save it.
c. Verify that the ABC Copiers and ABC Fax Machines categories are now also marked as
Private. If a parent category is private, the child categories must also be private.
d. Confirm this by unchecking the Private checkbox on ABC Copiers and stepping off the
record. What happens?

e. Click OK to dismiss the error message.


f. Navigate to Info Center and confirm the ABC Products category no longer appears.

6. You will finally explore creating access groups to access private categories. Recall that child
access groups have more access than parent access groups, rather than less. You will create one
parent and one child access group and confirm this relationship.
a. Navigate to Administration - Group > Access Groups. Notice that several seed access groups
already exist.
b. Create a new access group and name it ABC Access Group.
c. Create a second access group named ABC Child Access Group and set ABC Access Group
as its parent.
d. Try to associate the ABC Child Access Group with the ABC Copiers category.
i. Return to the eService Catalog category list.
ii. Expand the ABC Products category.
iii. Select the ABC Copiers category.
iv. Click the Access Groups view link under the Categories tab. This is not the same as
the Access Groups tab above the middle applet.
v. Click New.
vi. Select the ABC Child Access Group.
vii. Click OK. What happens? Why?

viii. Click OK to dismiss the error message.


ix. Click Cancel.
e. Associate the ABC Access Group with the ABC Products category.
i. Select the ABC Products category. Note that the Access Groups applet is still
displayed.
ii. Click New in the bottom applet.
iii. Select the ABC Access Group.

72 Siebel Essentials 8.0


Module 7: Catalogs and Master Data

iv. Click OK. Note that there is no error, as the ABC Access Group is not a child access
group. Also note that the Cascade button is now enabled. This button would
propagate the ABC Access group to all child categories in the catalog; that is, to ABC
Copiers and ABC Fax Machines. You will not cascade the access group; instead you
will add the ABC Child Access Group to the child categories.
f. Associate the ABC Child Access Group with the ABC Copiers and ABC Fax categories.
i. Select the ABC Copiers category.
ii. Add the ABC Child Access Group to the ABC Copiers category. Notice that this time
there is no error. Now that the parent access group is associated with the parent
catalog, the child access group may be associated with the child catalog.
iii. Add the ABC Child Access Group to the ABC Fax Machines category.
g. Add the Siebel Administrator position to the ABC Access Group. You cannot add individual
users to an access group, but you can add positions, organizations, or user lists. To add an
individual user you would make them the sole member of a user list.
i. Navigate to Administration - Group > Access Groups.
ii. Select the ABC Access Group record in the upper applet.
iii. Click New in the lower applet.
iv. Select the Siebel Administrator position. Make sure you have selected the position,
not the organization by using the position with a value under Group Type of Position.
v. Click Add.
h. Return to Info Center and confirm that the ABC Products category is now visible
i. Drill down on ABC Products to confirm that the ABC Copiers and ABC Fax Machines
categories are not visible.
j. You will now remove Siebel Administrator’s position from the ABC Access Group and add
it to the ABC Child Access Group. Since child access groups have more access than parent
access groups, Siebel Administrator will still be able to see the ABC Products category even
though it is not explicitly assigned the ABC Child Access Group.
i. Navigate to Administration - Group > Access Groups.
ii. Select the ABC Access Group.
iii. Click Delete in the lower applet to delete the Siebel Administrator record.
iv. Click OK to confirm the deletion.
v. Select the ABC Child Access Group.
vi. Add the Siebel Administrator position to the ABC Child Access Group.
k. Return to Info Center and confirm that Siebel Administrator can now see all of the categories
and solutions, even though his position is only included in the ABC Child Access Group.

7. Log out of Siebel Call Center and close the browser.

Siebel Essentials 8.0 73


Module 7: Catalogs and Master Data

Lab 7-1 Creating a Solutions Catalog (Guided)

Answers:
5.d. Confirm this by unchecking the Private checkbox on ABC Copiers and stepping off the
record. What happens?
An error message is displayed indicating that the Private flag cannot be set to false when
the parent category is marked as Private.

6.d.vii. Click OK. What happens? Why?


An error message is displayed indicating that the access group cannot be added because
the catalog does not contain its parent access group.

74 Siebel Essentials 8.0


Module 8: The Siebel Web Architecture

Lab 8-1 Exploring the Siebel Web Architecture


(Unguided)

Goals To examine the locations and settings of the Siebel Web architecture components

Time 15 - 20 minutes

Instructions:
Due to the conceptual nature of this lab, there is no Unguided version of it. Please turn the page and
do the Guided version.

Siebel 8.0 Essentials 75


Module 8: The Siebel Web Architecture

76 Siebel 8.0 Essentials


Module 8: The Siebel Web Architecture

Lab 8-1 Exploring the Siebel Web Architecture (Guided)

Goals To examine the locations and settings of the Siebel Web architecture components

Time 15 - 20 minutes

Instructions:
In this lab you will explore the Siebel Web architecture, starting with the Siebel Web client, and
moving all the way down to the Siebel database. This will help familiarize you with the components
involved in configuring and running a Siebel application.

1. You will first explore the Siebel Web client. For the high-interactivity (HI) client, an ActiveX
control is required for Internet Explorer. You will confirm the existence of that ActiveX control.
Be aware that when a user first tries to log in to the HI client they will be asked to download this
control.
a. Select Start > Programs > Internet Explorer.
b. Select Tools > Internet Options.
c. Click the Programs tab.
d. Click Manage Add-ons.
e. Confirm that several Siebel ActiveX controls are listed, including controls to display lists,
menus, toolbars, and trees, as well as the High Interactivity client.
f. Click OK to close the Manage Add-ons window.
g. Click OK to close the Internet Options window.
h. Close Internet Explorer.

2. You will next explore the Siebel Web Server Extension. Microsoft Internet Information Services
(IIS) is installed as the Web server on your machine. You will check the virtual directories,
examine the default Web page, and examine the configuration file.
a. Select Start > Programs > Administrative Tools > Internet Information Services.
b. In the left pane, expand your <machine name> and then expand Web Sites and then Default
Web Site.
c. Verify that the callcenter_enu virtual directory exists.
d. Select callcenter_enu.
e. In the right pane, right-click default.htm and select Properties. default.htm is the file users
are directed to when they enter http://<Web Server Name>/callcenter_enu.
f. Click the ASP.NET tab. What is the file location for default.htm?

g. Click Cancel to close the Properties window.

Siebel 8.0 Essentials 77


Module 8: The Siebel Web Architecture

h. Use Notepad to open D:\OUsea\SWEApp\public\enu\default.htm. Note that it is a very


simple HTML file that issues the ‘Start’ Siebel Web Server Extension command. This shows
that it is the Siebel Web Server Extension that is managing the Web server’s interaction with
the client. To open the file using Notepad, right-click the file and select Open With.
i. Close the file, not saving any changes.
j. Close Internet Information Services.
k. View the eapps.cfg file to determine the name of the Siebel Server, Enterprise, and
Application Object Manager for Siebel Call Center. This configuration file is used by the
Siebel Web Server Extension to determine how to connect to the Siebel Enterprise and which
Object Manager to use within that enterprise.
i. Use Notepad to open D:\OUsea\SWEApp\BIN\eapps.cfg.
ii. Select Edit > Find (or press CTRL+F) and search for /callcenter_enu.
iii. Within the connect string, identify the following:
Siebel Server
Enterprise
Call Center Object Manager
iv. Close eapps.cfg, not saving any changes.
l. Verify the information you recorded within the Siebel Call Center using the Web Client.
i. Start Siebel Call Center and log in as SADMIN/SADMIN.
ii. Navigate to Administration - Server Management > Enterprises.
iii. Verify that the Enterprise you found above is shown in the Enterprise Servers list, and
the Siebel Server you found above is shown in the Servers list.
m. Leave Call Center open.

3. You will next identify the critical components of the Siebel Gateway Name Server.
a. Using Windows explorer, navigate to D:\OUsea\gtwysrvr\ADMIN.
b. Confirm the existence of siebns.dat. This is the critical data file maintained by the Gateway
Name Server to keep track of such things as the Enterprise, which Servers are online, which
components on those servers are enabled, and so forth. Do not edit or delete this file!
c. Select Start > Programs > Administrative Tools > Services to open the services window.
d. Confirm that the Siebel Gateway Name Server service exists and is started.
e. Minimize the Services window.

4. You will now determine the name of the Siebel Server and its enabled server components.
a. Return to Siebel Call Center. You should still be on the Administration - Server
Configuration > Enterprises view. Note that most of the component groups are enabled for
this enterprise.
b. Within Administration - Server Configuration, click Servers. What is the name of the Siebel
Server within this Enterprise?

78 Siebel 8.0 Essentials


Module 8: The Siebel Web Architecture

c. Examine the components in the middle applet. Does it look like all of the components from
all of the enabled component groups are enabled on this server?

d. Display the Component Type column.


i. In the Components applet, right-click and select Columns Displayed.
ii. In the Available Columns left pane, select Component Type.
iii. Click the right arrow to move Component Type to the Selected Columns right pane.
iv. Click Save.
e. What type of server component is Call Center Object Manager (ENU)?

5. You will finally examine the other components that make up a Siebel Enterprise: The Siebel
Server service, files related to the Siebel server, the Siebel file system, and the database
connection. Understanding where these files and services are located is important in
implementing a Siebel Enterprise.
a. Return to the Services window and confirm that the Siebel Server [Siebel_OUsrvr] service
exists and is started. This service processes all server requests and manages all sessions; if it
is stopped or crashes, you will no longer be able to log in using the Siebel Web client.
b. Minimize the Services window.
c. Using Windows Explorer, navigate to D:\OUsea\siebsrvr\OBJECTS\ENU. This is the
location of the Siebel Repository File (srf), a compiled binary file containing run-time
information from the server such as data presentation and business rules and logic. It is used
to improve performance by reducing the need for the Siebel Server to access the database.
What is the name of the Siebel Repository File?

d. Navigate to D:\SUsea\siebsrvr\WEBTEMPL. These are the Siebel Web Templates. You will
need to change these to make the Web pages match your company’s “look and feel”.
e. Navigate to D:\siebfile. This is the Siebel File System used to store compressed files such as
attached documents. Note that it is a shared directory.
f. Select Start > Programs > Administrative Tools > Data Sources (ODBC). This is where the
Siebel Server’s connection to the database is defined.
g. Click the System DSN tab.
h. Select Siebel_DSN and click Configure.
i. Note that this class uses an MSSQL database on your local machine. Click Next.
j. Note that this class uses SQL Server authentication. Enter SADMIN as the user name and
SADMIN as the password.
k. Click Next.
l. Note that the default database is siebeldb. (Greyed out). This is the name of the database
used in this class. Click Next.
m. Click Finish.
n. Click Test Data Source. This confirms that you (and therefore the Siebel Server) can
connect to the siebeldb database.

Siebel 8.0 Essentials 79


Module 8: The Siebel Web Architecture

o. Click OK to confirm that the tests completed successfully.


p. Click Cancel three times to close the ODBC Administration tool.

80 Siebel 8.0 Essentials


Module 8: The Siebel Web Architecture

Solutions 8-1 Exploring the Siebel Web Architecture


(Guided)

Answers
2.f. What is the file location for default.htm?
D:\OUsea\SWEApp\public\enu\web.config (default.htm)

2.k.iii. Within the connect string, identify the following:


Siebel Server localhost
Enterprise Siebel
Call Center Object Manager SCCObjMgr_enu

4.b. Within Administration - Server Configuration, click Servers. What is the name of the
Siebel Server within this Enterprise?
OUsrvr.

4.c. Examine the components in the middle applet. Does it look like all of the components from
all of the enabled component groups are enabled on this server?
No. Only components from the CallCenter, SystemAux, and System component groups are
enabled on this server.

4.e. What type of server component is Call Center Object Manager (ENU)?
AppObjMgr (Application Object Manager)

5.c. Using Windows Explorer, navigate to D:\OUsea\siebsrvr\OBJECTS\ENU. This is the


location of the Siebel Repository File (srf), a compiled binary file containing run-time
information from the server such as data presentation and business rules and logic. It is
used to improve performance by reducing the need for the Siebel Server to access the
database. What is the name of the Siebel Repository File?
siebel.srf

Siebel 8.0 Essentials 81


Module 8: The Siebel Web Architecture

82 Siebel 8.0 Essentials


Module 9: Server Components and Parameters

Lab 9-1 Exploring Server Components and Parameters


(Unguided)

Goals To explore the Siebel Enterprise using the Enterprise Explorer


To modify parameters within the enterprise

Time 15 - 20 minutes

Instructions:
Due to the conceptual nature of this lab, there is no Unguided version of it. Please turn the page and
do the Guided version.

Siebel 8.0 Essentials 83


Module 9: Server Components and Parameters

84 Siebel 8.0 Essentials


Module 9: Server Components and Parameters

Lab 9-1 Exploring Server Components and Parameters


(Guided)

Goals To explore the Siebel Enterprise using the Enterprise Explorer


To modify parameters within the enterprise

Time 15 - 20 minutes

Instructions:
In this lab you will use the Enterprise Explorer to familiarize yourself with the concepts of
component groups, components, and parameters. You will then explore changing a component’s
parameters at multiple levels.

1. Start Siebel Call Center Web client and log in as SADMIN/SADMIN.

2. You will first explore the top level of the Siebel Enterprise using the Enterprise Explorer. This
will give you an overview of the enterprise-level configuration before expanding the tree to
examine it in more detail.
a. Navigate to Administration – Server Configuration > Enterprise Explorer. The explorer tree
is shown in the left pane. The top level of the explorer tree is the enterprise.
b. Click the (+) plus sign next to the enterprise to expand the explorer tree. The folders listed
indicate objects that can be configured or examined at the enterprise level. What objects can
be configured or examined at the enterprise level?

c. Select the Servers folder. Which Siebel Server is contained within the Siebel Enterprise?

d. Select the Component Groups folder. These are the component groups that are enabled for
the enterprise. Component groups must be enabled at the enterprise level to be available for
assignment to individual servers. Recommended practice is to disable those component
groups that you know you will never use on any server.
e. Sort on the Enable State of the component groups. Which component groups are disabled for
the enterprise?

f. Select the Component Definitions folder. Component definitions include the component
type (which can be thought of as the program that will run) and component parameters (input
parameters). Notice that each component definition has a run mode associated with it. What

Siebel 8.0 Essentials 85


Module 9: Server Components and Parameters

is the run mode for the Application Deployment Manager Object Manager (ENU)?

g. Select the Parameters folder. These are parameters that are set at the enterprise level. Query
for the ODBC Data Source parameter. This parameter determines the ODBC connection
Siebel servers will use to connect to the database. What is the value of the ODBC Data
Source parameter?

h. Select the System Alerts folder. The system alert components determine whom to e-mail
with system alerts.
i. Select the Profiles folder. These are sets of parameters that can be used by multiple
components. For example, the Server Datasource profile determines how the servers connect
to the database.

3. You will now examine the explorer tree in more detail.


a. Click the + (plus) sign to expand the Servers folder.
b. Expand the OUsrvr object. What objects can be configured or examined at the server level?

c. Expand the Component Groups folder. This lists all of the component groups assigned to
this server. What component groups are currently assigned to this server?

d. Expand the Components folder. This lists all of the components included in the assigned
component groups.
e. Expand the Call Center Manager (ENU) object. This is the Object Manager for the Siebel
Call Center application. Note that you can configure parameters or events on this specific
component on this specific server.
f. Expand the Parameters folder within the Call Center Object Manager (ENU) object. Recall
that you saw the ODBC Data Source parameter at the enterprise level.
g. Query for the ODBC Data Source parameter. This is an example of a component parameter
inheriting its value from the enterprise. What is the current value of the ODBC Data Source
parameter of the Call Center Object Manager (ENU) component?

h. Expand the Parameters folder within OUsrvr object. These are parameters set at the server
level.
i. Expand the Events folder within the OUsrvr object. Here you can set the logging levels for
various events on the server.
j. Continue exploring the explorer tree until you are comfortable with its navigation:
- Component groups contain components.
- Component definitions include a component type and parameters. Notice that for
component definitions, the definition names appear in the right pane, while the types appear

86 Siebel 8.0 Essentials


Module 9: Server Components and Parameters

in the left pane. For example, selecting Call Center Object Manager (ENU) in the right pane
shows the Application Object Manager component type in the left pane.

4. You will finally modify a component parameter and examine the effects of the Delete Parameter
Override function.
a. Using the explorer tree, locate the Call Center Object Manager (ENU) component
definition. That is, in the explorer tree select Siebel Enterprise > Siebel > Component
Definitions, and then locate Call Center Object Manager (ENU) in the right pane.
b. Expand the selected Application Object Manager object in the explorer tree. Recall that the
explorer tree shows object definitions by type rather than by name.
c. Expand the Parameters folder.
d. Query for the Log File parameter. What is the current value of the Log File parameter?

e. Using the explorer tree, navigate to Siebel Enterprise > Siebel > Servers > OUsrvr >
Components > Call Center Object Manager (ENU) > Parameters.
f. Query for the Log File parameter. What is the value of the Log File parameter? Where do
you think the default value comes from?

g. Change the Value on Restart value to test and step off the record to save it. What happens?

h. Select the Log File parameter and delete the Value on Restart parameter value, then step off
the record to save it. What happens?

i. Click OK to dismiss the error.


j. Select the Log File parameter, right-click, and select Delete Parameter Override. The value
returns to the inherited value.

5. Remain logged in to Siebel Call Center.

Siebel 8.0 Essentials 87


Module 9: Server Components and Parameters

Solutions 9-1 Exploring Server Components and


Parameters (Guided)

Answers
2.b. Click the (+) plus sign next to the enterprise to expand the explorer tree. The folders listed
indicate objects that can be configured or examined at the enterprise level. What objects
can be configured or examined at the enterprise level?
Servers, Component Groups, Component Definitions, Parameters, System Alerts, and
Profiles.

2.c. Select the Servers folder. Which Siebel Server is contained within the Siebel Enterprise?
OUsrvr

2.e. Sort on the Enable State of the component groups. Which component groups are disabled
for the enterprise?
PIM Server Integration.

2.f. Select the Component Definitions folder. Component definitions include the component
type (which can be thought of as the program that will run) and component parameters
(input parameters). Notice that each component definition has a run mode associated with
it. What is the run mode for the Application Deployment Manager Object Manager (ENU)?
Interactive. Object Managers manage user sessions, hence are always interactive.

2.g. Select the Parameters folder. These are parameters that are set at the enterprise level.
Query for the ODBC Data Source parameter. This parameter determines the ODBC
connection Siebel servers will use to connect to the database. What is the value of the
ODBC Data Source parameter?
Siebel_DSN.

3.b. What objects can be configured or examined at the server level?


Component Groups, Components, Parameters, and Events.

3.c. What component groups are currently assigned to this server?


Auxiliary System Management, Siebel Call Center, and System Management.

3.g. Query for the ODBC Data Source parameter. This is an example of a component
parameter inheriting its value from the enterprise. What is the current value of the ODBC
Data Source parameter of the Call Center Object Manager (ENU) component?
Siebel_DSN. This should look familiar, as it is the same value we saw at the Enterprise
level.

4.d. What is the current value of the Log File parameter?


SComm.log.

88 Siebel 8.0 Essentials


Module 9: Server Components and Parameters

4.f. What is the value of the Log File parameter? Where does the default value come from?
SComm.log. The component inherits the parameter value from the component definition,
hence the default value is the one specified in the component definition.

4.g. What happens?


Both the Value on Restart value and the default value are set to test. You have overridden
the parameter value at the component level, so it will use this value instead of the value
given in the component definition. This is why the default value becomes test as well.

4.h. What happens?


An error message is shown. You cannot delete the parameter value because it would cause
a null value to be passed to the system.

Siebel 8.0 Essentials 89


Module 9: Server Components and Parameters

90 Siebel 8.0 Essentials


Module 9: Server Components and Parameters

Lab 9-2 Enabling and Assigning Component Groups


(Unguided)

Goals To enable a component group and assign it to a server


To modify the startup behavior of components within that component group

Time 10 - 15 minutes

Instructions:
In this lab you will enable a component group and assign it to a server. You will then modify and
test its startup behavior. You will finally disable it to avoid consuming unnecessary resources.

1. Verify that the Siebel Sales component group is enabled in the enterprise and assigned to the
OUsrvr server, but that it is not enabled on the server.

2. Enable the Siebel Sales component group on the OUsrvr server.

3. Open a second browser and enter an address of http://localhost/sales_enu. You will receive an
error message that the server is busy. Why doesn’t the login screen appear?

4. Restart the Siebel Server service and confirm that you can now access the Siebel Sales login
screen.

5. Use the Administration - Server Configuration > Servers view to set the Sales Object Manager
(ENU) component to Manual Start. Then use the Administration - Server Management >
Components view to shut it down. Although the disabling of the component group does not take
effect until you restart the Siebel Server service, since you shut down the component it is not
taking up your resources, so you can wait to restart the service until you have performed
additional administration in a later lab.

Siebel 8.0 Essentials 91


Module 9: Server Components and Parameters

Solutions 9-2 Enabling and Assigning Component


Groups (Unguided)

Answers
3. Open a second browser and enter an address of http://localhost/sales_enu. You will
receive an error message that the server is busy. Why doesn’t the login screen appear?
Enabling or disabling a component group on a server requires a server restart for the
change to take effect.

92 Siebel 8.0 Essentials


Module 9: Server Components and Parameters

Lab 9-2 Enabling and Assigning Component Groups


(Guided)

Goals To enable a component group and assign it to a server


To modify the startup behavior of components within that component group

Time 10 - 15 minutes

Instructions:
In this lab you will enable a component group and assign it to a server. You will then modify and
test its startup behavior. You will finally disable it to avoid consuming unnecessary resources.

1. You will first verify that the Siebel Sales component group is enabled in the enterprise. You will
then verify that it is assigned to the OUsrvr server. Finally, you will enable it on the server.
Enabling a component group in the enterprise makes it available for assignment to servers.
Assigning a component group to a server makes the component group available on that server.
Enabling it on the server reserves memory on the server for the component group and starts tasks
associated with the component group components when the server starts up.
a. Using the enterprise explorer, locate the Siebel Sales component group. Is the Siebel Sales
component group currently enabled in the enterprise?

b. Open a second browser and enter an address of http://localhost/sales_enu. You will receive
an error message that the server is busy.
c. Close the browser and return to the Siebel Call Center application.
d. Click the Enterprises view link. Note that the Component Groups view tab is selected in the
middle applet and the Siebel Sales component group is selected.
e. Examine the bottom right applet. Is the Siebel Sales component group assigned to OUsrvr?

f. Is the Siebel Sales component group enabled on OUsrvr?

g. Click the Enable button in the lower right applet. This enables the component group on the
server.
Note: At this point you would normally synchronize components to ensure that the
component definitions are registered on the Siebel Gateway Name Server. However, there
are two considerations: First, because the Siebel Sales component group does not contain any
batch components, you will not synchronize here. This will confirm that only batch
components require synchronization. Second, synchronization registers assigned component

Siebel 8.0 Essentials 93


Module 9: Server Components and Parameters

groups rather than enabled component groups, so once you have performed an initial
synchronization, enabling a component group does not require an additional synchronization.
h. Click the Servers view link tab.
i. In the middle applet, query for the Sales Object Manager (ENU). Does the Sales Object
Manager (ENU) appear? Why or why not?

j. Log out of Siebel Call Center.

2. You will next restart the Siebel Server service in order for the assignments to take effect.
a. In the Services window, right-click the Siebel Server [Siebel_OUsrvr] service and select
Stop. It takes some time to stop, so this is safer than using the Restart command. If you
receive a timeout error, select Action > Refresh to refresh the view until the service is
completely stopped.
b. Once the Siebel Server service has stopped, right-click the Siebel Server [Siebel_OUsrvr]
service and select Start.
c. Minimize the Services window.

3. You will next test your changes by trying to access Siebel Sales on your local machine. If you
successfully enabled and assigned the component group, you should be able to get to the login
screen. However, remember that the Siebel Server service takes several minutes to start up, so be
patient.
a. Start Internet Explorer.
b. Enter an address of http://localhost/sales_enu. You should get the Siebel Sales login screen.
c. Close Internet Explorer.

4. You will finally modify the startup type for this component and disable it on the server. This is a
somewhat artificial exercise as you would usually do one or the other, but this allows you to
practice both steps at once.
a. Start Siebel Call Center and log in as SADMIN/SADMIN.
b. Navigate to Administration - Server Configuration > Servers.
c. In the middle applet, locate and select the Sales Object Manager (ENU) component.
d. Click Manual Start. This modifies the component so it does not come online when the
server first starts up, but instead waits for you to manually start it. Combined with the
Component Shutdown feature in server management, this allows you manually start up
certain components only when they are needed and shut them down afterwards, saving
resources on impacted servers.
e. Navigate to Administration - Server Management > Components.
f. Query for Sales Object Manager (ENU).
g. Click Shutdown. This shuts down the component so it no longer accepts new requests.
h. Open a browser and confirm that the address http://localhost/sales_enu no longer brings up a
login screen.
i. Return the Siebel Call Center and click the Enterprises view link.
j. Query for Siebel Sales in the component groups.
k. In the Component Group Assignments applet, click Disable. This disables the component
group on the Siebel Server. The advantage of disabling a component group instead of

94 Siebel 8.0 Essentials


Module 9: Server Components and Parameters

unassigning it is that a disabled component group continues to keep track of parameter


overrides, while unassigning a component group removes all parameter overrides.

5. Remain logged in to Siebel Call Center. Although the disabling of the component group does not
take effect until you restart the Siebel Server service, you shut down the component so it is not
taking up your resources, so you can wait to restart the service until you have performed
additional administration in a later lab.

Siebel 8.0 Essentials 95


Module 9: Server Components and Parameters

Solutions 9-2 Enabling and Assigning Component


Groups (Guided)

Answers
1.a. Is the Siebel Sales component group currently enabled in the enterprise?
Yes.

1.e. Examine the bottom right applet. Is the Siebel Sales component group assigned to OUsrvr?
Yes.

1.f. Is the Siebel Sales component group enabled on OUsrvr?


No.

1.i. In the middle applet, query for the Sales Object Manager (ENU). Does the Sales Object
Manager (ENU) appear? Why or why not?
It does not appear because you need to restart the Siebel Server and Siebel Gateway Name
Server services in order for any assignment changes to take effect.

96 Siebel 8.0 Essentials


Module 10: Server Management

Lab 10-1 Exploring Server Management (Unguided)

Goals To become familiar with the Server Management views

Time 5 - 10 minutes

Instructions:
Due to the conceptual nature of this lab, there is no Unguided version of it. Please turn the page and
do the Guided version.

Siebel 8.0 Essentials 97


Module 10: Server Management

98 Siebel 8.0 Essentials


Module 10: Server Management

Lab 10-1 Exploring Server Management (Guided)

Goals To become familiar with the Server Management views

Time 5 - 10 minutes

Instructions:
In this lab you will familiarize yourself with the Server Management views to help you understand
how to monitor a Siebel enterprise.

1. If necessary, start Siebel Call Center using the Web client and log in as SADMIN/SADMIN.

2. You will first examine the Administration – Server Management > Enterprises view. This view
allows you to examine the states of the servers in the enterprise, and components on each server.
a. Navigate to Administration - Server Management > Enterprises.
b. Scroll down to the Components list at the bottom of the view. Note that from this view you
can pause or shut down individual components. What is the current state of the following:
i. Server Manager?

ii. Call Center Object Manager (ENU)?

iii. File System Manager?

iv. Sales Object Manager (ENU)?

3. You will next examine the other views to note the similarities and differences among the various
monitoring views.
a. Click the Servers view link. How is the information displayed here different from the
information displayed in the Enterprises view?

b. Click the Log tab. This shows a list of activities logged by the server.

Siebel 8.0 Essentials 99


Module 10: Server Management

c. Click the Components view link. Once again you see the states of the components in the
enterprise. What additional information about the components is available here?

d. Click the Tasks view link. This view lists the tasks that are running or have run on the
enterprise. What additional information about tasks is available here?

e. Click the Sessions view link. This view lists user sessions and activity.
f. Select the running instance of the SCCObjMgr_enu component. What is the OM Login for
this instance?

g. Click the State Values view tab in the bottom applet. What is the current value of the Applet
Name state value?

h. Select Help > About View. Does the applet name match what you found above?

i. Click OK to close the About View window.

4. Remain logged in to Siebel Call Center.

100 Siebel 8.0 Essentials


Module 10: Server Management

Solutions 10-1 Exploring Server Management (Guided)

Answers
2.b.i. Server Manager?
Running.

2.b.ii. Call Center Object Manager (ENU)?


Running.

2.b.iii. File System Manager?


Online.

2.b.iv. Sales Object Manager (ENU)?


Shutdown.

3.a. Click the Servers view link. How is the information displayed here different from the
information displayed in the Enterprises view?
This view shows the component groups assigned to the server, and shows the component
states by component group.

3.c. Click the Components view link. Once again you see the states of the components in the
enterprise. What additional information about the components is available here?
The tasks that are currently running that component, the state values of that component,
and runtime statistics about the component.

3.d. Click the Tasks view link. This view lists the tasks that are running or have run on the
enterprise. What additional information about tasks is available here?
The task logs, parameters, state values, and runtime statistics.

3.f. Select the running instance of the SCCObjMgr_enu component. What is the OM Login
for this instance?
SADMIN

3.g. Click the State Values view tab in the bottom applet. What is the current value of the
Applet Name state value?
Completed: Server Session List Applet (PositionOnRow). This indicates that you just
selected a row on the server session list applet.

3.h. Select Help > About View. Does the applet name match what you found above?
Yes; the name of the applet you found in the previous step appears in the Help > About
View view.

Siebel 8.0 Essentials 101


Module 10: Server Management

102 Siebel 8.0 Essentials


Module 10: Server Management

Lab 10-2 Using the Command-Line Server Manager


(Unguided)

Goals To practice using the command-line Server Manager.

Time 5 - 10 minutes

Instructions:
In this lab, you will log in to the command-line server manager and familiarize yourself with its
function. The command-line server manager is useful for scripting server interaction. For more
details on using the command-line server manager, consult the Siebel System Administration Guide.

1. Open a Command Prompt window and enter the command hostname to determine your machine
name.

2. Enter the command below (replacing <Machine Name> with the name you recorded above).
Case is important.
Note: The Server Manager command-line program resides in the E:\OUsea\siebsrvr\BIN
directory. This directory has been added to the PATH environment variable so you do not have
to change directories.

srvrmgr /g <Machine Name> /e Siebel /s OUsrvr /u SADMIN /p


SADMIN

Note: When you are successfully connected to Server Manager, you will see the prompt:
srvrmgr:OUsrvr>

3. Execute the list tasks, list parameters, list component groups, and list servers for component
group Workflow commands to familiarize yourself with the command-line interface.

4. Enter quit to disconnect from the server.

5. Close the Command Prompt window.

Siebel 8.0 Essentials 103


Module 10: Server Management

104 Siebel 8.0 Essentials


Module 10: Server Management

Lab 10-2 Using the Command-Line Server Manager


(Guided)

Goals To practice using the command-line Server Manager.

Time 5 – 10 minutes

Instructions:
In this lab, you will log in to the command-line server manager and familiarize yourself with its
function. The command-line server manager is useful for scripting server interaction. For more
details on using the command-line server manager, consult the Siebel System Administration Guide.

1. Open the Command Prompt window by selecting Start > Programs > Accessories > Command
Prompt.

2. You will first log in to Server Manager by entering the appropriate values for your machine.
a. Enter the command hostname and record your machine name here:
b. Type the command below (replacing <Machine Name> with the name you recorded above)
and press ENTER. Case is important.
Note: The Server Manager command-line program resides in the D:\OUsea\siebsrvr\BIN
directory. This directory has been added to the PATH environment variable so you do not
have to change directories.

srvrmgr /g <Machine Name> /e Siebel /s OUsrvr /u SADMIN /p


SADMIN

Note: When you are successfully connected to Server Manager, you will see the prompt:
srvrmgr:OUsrvr>

c. View the list of Server Manager commands by entering help at the srvrmgr:OUsrvr>
prompt.
d. Review the commands. Is it possible to start up or shut down a server using these
commands? Why might you want to be able to do this?

Siebel 8.0 Essentials 105


Module 10: Server Management

3. You will next execute a few list commands to familiarize yourself with the data produced by the
command-line server manager.
a. At the srvrmgr:OUsrvr> prompt, enter list tasks to list the status of current tasks running on
your Siebel Server. Notice that there are several interactive and background tasks running on
your Siebel Server.
b. Enter list parameters to list parameter values for your Siebel Server.
c. Enter list component groups to list the enabled component groups on your Siebel Server.
d. You can create more complex lists as well. To list all servers where the Workflow
component group is enabled, enter list servers for component group Workflow. How many
Siebel Servers are listed?

4. Enter quit to disconnect from the server.

5. Close the Command Prompt window.

106 Siebel 8.0 Essentials


Module 10: Server Management

Solutions 10-2 Using the Command-Line Server


Manager (Guided)

Answers:
2.d. Review the commands. Is it possible to start up or shut down a server using these
commands? Why might you want to be able to do this?
Yes, you can start up or shut down a server from the command line. You might use this in a
script to assign a component group to a server, enable it, and then restart the server. Many
other answers are possible.

3.i. You can create more complex lists as well. To list all servers where the Workflow
component group is enabled, enter list servers for component group Workflow. How
many Siebel Servers are listed?
One. OUsrvr.

Siebel 8.0 Essentials 107


Module 10: Server Management

108 Siebel 8.0 Essentials


Module 10: Server Management

Lab 10-3 Invoking and Monitoring Jobs (Unguided)

Goals To synchronize components with the Gateway Name Server


To create a job template
To invoke and monitor a batch job on the server

Time 10 -15 minutes

Instructions:
In this lab, you will explore creating job templates and invoking and monitoring jobs. During this
process, you will need to perform an initial synchronization between the server and the Gateway
Name Server. This stores the component parameters and assignments on the Gateway Name Server.
Synchronization must be performed after an initial deployment and thereafter every time a
component group containing batch components is enabled or disabled on a server to ensure the
correct parameters for the batch component are stored in the gateway.

1. Use the Administration - Server Configuration > Synchronize view to synchronize components
on the server. This process takes about one minute to complete.

2. Create a job template with the values below. While it is not necessary to create a job template to
run a job, job templates are useful for repeating or frequently-run jobs to avoid having to re-enter
parameters.
Name Administrator Notification Template
Short Name AdmNotify
Component Siebel Administrator Notification Component
Description Sample Template
Note: Because all of the batch components from enabled component groups are available from
the component drop-down list, it is possible to submit a job for a component which is not
enabled on any server. This is intentional; the job will remain queued until a server with that
component enabled becomes available.

3. Add the following parameters to the job template.


Name Value
NotificationHandler AdminEmailAlert
Disable Notification True
The notification handler is the system alert alias used by this component; the Disable
Notification flag ensures that if this job fails, it will not generate an alert.

4. Navigate to Administration - Server Management > Jobs and create and submit a new job using
the job template you just created. Perform empty queries to determine when the job completes.

Siebel 8.0 Essentials 109


Module 10: Server Management

5. Remain logged in to Siebel Call Center for the next lab.

110 Siebel 8.0 Essentials


Module 10: Server Management

Lab 10-3 Invoking and Monitoring Jobs (Guided)

Goals To synchronize components with the Gateway Name Server


To create a job template
To invoke and monitor a batch job on the server

Time 10 – 15 minutes

Instructions:
In this lab, you will explore creating job templates and invoking and monitoring jobs. During this
process, you will need to perform an initial synchronization between the server and the Gateway
Name Server. This stores the component parameters and assignments on the Gateway Name Server.
Synchronization must be performed after an initial deployment and thereafter every time a
component group containing batch components is enabled or disabled on a server to ensure the
correct parameters for the batch component are stored in the gateway.

1. You will first synchronize components on the server.


a. In Siebel Call Center, navigate to Administration - Server Configuration > Enterprises.
b. Click the Synchronize view tab. Since you have not yet synchronized any components, no
records are displayed.
c. Click the Synchronize button. You will see the clock/timer symbol, indicating that
synchronization is in progress. The process takes about one minute. When this completes,
server components appear in the Synchronize list.
d. Examine the list of components shown in the Synchronize list. Are all of these components
enabled on the server OUsrvr?

2. You will next create a job template to specify parameters for a job. While it is not necessary to
create a job template to run a job, job templates are useful for repeating or frequently-run jobs to
avoid having to re-enter parameters.
a. Click Job Templates in the view link bar.
b. In the Job Templates list, create a new Job Template with the following values. The
component generates database triggers for invoking workflows and other business process
automations. This will have no impact on your system at the moment, so it is an excellent
example you can practice with.
Name Administrator Notification Template
Short Name AdmNotify
Component Siebel Administrator Notification Component
Description Sample Template

Siebel 8.0 Essentials 111


Module 10: Server Management

Note: Because all of the batch components from enabled component groups are available
from the component drop-down list, it is possible to submit a job for a component which is
not enabled on any server. This is intentional; the job will remain queued until a server with
that component enabled becomes available.
c. In the Job Parameters list, create two new records and enter the following parameters in order
to successfully execute this job. Notice that when you step off the Privileged User Password
record, the password is obscured to protect it.
Name Value
NotificationHandler AdminEmailAlert
Disable Notification True
The notification handler is the system alert alias used by this component; the Disable
Notification flag ensures that if this job fails, it will not generate an alert.
d. Step off the record to save the newly created Job Template.
e. Notice in the Job Templates list that the newly created Job Template is enabled
automatically.

3. You will finally use the job template you just created to execute and monitor a job.
a. Navigate to Administration - Server Management > Jobs.
b. Create a new record. Note that the ID is automatically populated.
c. Click the Select button in the Component/Job field. The Components/Jobs pick applet is
shown. Note that the Administrator Notification Template is the first item listed. Job
templates are shown before components, but here you can select either a component or a job
template.
d. Select the Administrator Notification Template and click OK. Note that the job parameters
at the bottom of the screen are populated using the values from the template. Otherwise you
would have had to populate them manually.
e. Check the Repeating checkbox in the middle applet and step off the checkbox to commit the
change. Notice that you can now specify the repeat unit (seconds, minutes, hours, days,
weeks, months, or years), the repeat interval, and the number of repetitions.
f. Uncheck the Repeating checkbox and step off of it.
g. What is the current status of the job?

h. Click Submit Job to start the job. What is the current status of the job?

i. Perform an empty query. Because the views do not automatically update, you must manually
refresh the view. The job should complete with a status of Success after a few moments.
j. Click the Tasks link. If necessary, query to locate the Administrator Notification task. This is
another location where you can monitor the progress of a job. The Tasks view has the
advantage that it shows more information; for instance: the process ID, start time, and end
time. However, it has the disadvantage that it shows all tasks, not just jobs (tasks run in batch
mode).

4. Remain logged in to Siebel Call Center for the next lab.

112 Siebel 8.0 Essentials


Module 10: Server Management

Solutions 10-3 Invoking and Monitoring Jobs (Guided)

Answers
1.d. Examine the list of components shown in the Synchronize list. Are all of these components
enabled on the server OUsrvr?
No. Initial synchronization registers all of the components contained in component groups
enabled in the enterprise, so the list contains many more components than are enabled on
our server, OUsrvr.

1.e. What do you think happens when you try to run a job that isn’t registered as available on
any of the available servers?
Two possible answers are: Either you get an error message when you submit the job, or the
job is queued until a server with that component enabled becomes available. In fact, the
latter occurs; you can submit a job for a component that is not enabled on any server, and
the Gateway Name Server will queue that job until a server becomes available.

3.g. What is the current status of the job?


Creating.

3.h. Click Submit Job to start the job. What is the current status of the job?
Queued.

Siebel 8.0 Essentials 113


Module 10: Server Management

114 Siebel 8.0 Essentials


Module 11: Siebel Client Types

Lab 11-1 Exploring Siebel Client Types (Unguided)

Goals To explore the Siebel Web Client, Mobile Web Client, and Developer Web Client
To explore the Sample database

Time 10 - 15 minutes

Instructions:
Due to the conceptual nature of this lab, there is no Unguided version of it. Please turn the page and
do the Guided version.

Siebel 8.0 Essentials 115


Module 11: Siebel Client Types

116 Siebel 8.0 Essentials


Module 11: Siebel Client Types

Lab 11-1 Exploring Siebel Client Types (Guided)

Goals To explore the Siebel Web Client, Mobile Web Client, and Developer Web Client
To explore the Sample database

Time 10 - 15 minutes

Instructions:
In this lab you will compare the Siebel Web Client to the Siebel Mobile and Developer Web Clients.
The Siebel Mobile Web Client runs a local executable and connects to a local SQL Anywhere
database. The Siebel Developer Web Client runs the same executable as the Mobile Web Client, but
can also connect to the server database.

1. You will first examine some of the features of the Siebel Web client.
a. If necessary, start Siebel Call Center using the Web client and log in as SADMIN/SADMIN.
b. Select Help > Technical Support. What is the connect string for this client?

c. What is the full path to the repository file for this client?

d. Click OK to close the Technical Support window.


e. What is the HTTP address of this client? This is the address shown before the first question
mark.

f. Select File > Log Out to log out of the Siebel Web client and close the browser window.
g. Using Windows Explorer, navigate to D:\OUsea\siebsrvr\bin\enu. This is where the server
configuration files are located.
h. Use Notepad to open uagent.cfg. This is the configuration file for Siebel Call Center. Note
that almost all of the sections are marked as “client-only”, meaning that the parameters are
read from the component definitions.
i. Locate the section that starts with [Preload]. Which views are pre-loaded to improve
performance in the Siebel Call Center application?

j. Close uagent.cfg, not saving any changes.

Siebel 8.0 Essentials 117


Module 11: Siebel Client Types

2. You will next explore the Siebel Developer Web Client. This is a local executable that emulates
the functionality of the Siebel application and which connects to the server database without the
need to go through an object manager on the server. To prove this, you will disable the Siebel
Server service and still use the Developer Web Client.
a. Restore the Services window.
b. Right-click the Siebel Server [Siebel_OUsrvr] service and select Stop.
c. Once the service is stopped, minimize the Services window.
d. Confirm that you can no longer start Siebel Call Center by entering
http://localhost/callcenter_enu in the address bar. You should receive a server error.
e. From the Start menu, right-click Start > Programs > Siebel Web Client 8.0 > Siebel Call
Center – ENU and select Properties. This shortcut is the starting point for both the Siebel
Developer Web Client and the Siebel Mobile Web Client. What is the name of the executable
run by this shortcut?

f. Note that the /c flag passes the full path to the configuration file. What is the full path to the
configuration file? Does this match the path you found above?

g. Click Cancel to close the Properties window.


h. Select Start > Programs > Siebel Web Client 8.0 > Siebel Call Center - ENU to start the local
executable. The Siebel Call Center Mobile or Developer Web Client login screen is
displayed:

Note that it differs from the Siebel Web Client login screen in that it allows you to select a

118 Siebel 8.0 Essentials


Module 11: Siebel Client Types

database to use. The available databases are specified in the configuration file, as you will
see.
i. Enter SADMIN as the User ID.
j. Enter SADMIN as the password.
k. Select the Server database from the drop-down list. This is only available to the Developer
Web Client; the Mobile Web Client only lists the local and sample databases by default.
l. Click OK. After a few seconds, you are logged in to the Developer Web Client. What is the
HTTP address shown in the address bar?

m. Select Help > Technical Support. What is the connect string for this client?

n. What is the full path to the repository file for this client?

o. Click OK to close the Technical Support Window.


p. Navigate to Administration – Server Configuration > Enterprises. You can still enable,
disable, and assign component groups using the Dedicated Web client.
q. Navigate to Administration – Server Management > Servers. What do you notice about the
state of the server?

r. Log out of the Dedicated Web Client.


s. Start the Siebel Server service.
t. Once the Siebel Server service has fully started, log back in to the Dedicated Web Client and
navigate to Administration - Server Management > Servers. The server status is now visible.
u. Log out of the Dedicated Web Client.

3. You will now explore the Siebel Mobile Web Client. This client may be used to connect to any
local Siebel database. Oracle provides a sample Siebel database as part of the installation, so you
will explore it.
a. Select Start > Programs > Siebel Web Client 8.0 > Siebel Call Center – ENU.
b. Enter the following parameters and click OK to log in.
User ID SADMIN
Password SADMIN
Connect to Sample
c. What is the connect string for this client?
Hint: Use Help > Technical Support.

d. What is the full path to the repository file for this client?

Siebel 8.0 Essentials 119


Module 11: Siebel Client Types

e. Explore the client and notice that the database is populated with accounts, contacts,
employees, and a large amount of other data. You will be using the Mobile Web Client with
this database frequently in future labs in order to have some exposure to sample data.
f. Log out of the Siebel Mobile Web Client.

120 Siebel 8.0 Essentials


Module 11: Siebel Client Types

Solutions 11-1 Exploring Siebel Client Types (Guided)

Answers
1.b. What is the connect string for this client?
Siebel_DSN.

1.c. What is the full path to the repository file for this client?
D:\OUsea\siebsrvr\objects\enu\siebel.srf.

1.e. What is the HTTP address of this client?


http://localhost/callcenter_enu/start.swe

1.i. Locate the section that starts with [Preload]. Which views are pre-loaded to improve
performance in the Siebel Call Center application?
The Opportunity List View and the All Service Request List View. If the Siebel QuickStart
agent is enabled, preloaded views are cached the first time the application starts up. In
subsequent application sessions, navigation to a preloaded view is faster. See the Siebel
Performance Tuning Guide for more information.

2.e. What is the name of the executable run by this shortcut?


siebel.exe.

2.f. What is the full path to the configuration file? Does this match the path you found above?
D:\OUsea\Client\Bin\ENU\uagent.cfg. No; it does not mach the path found before. The
siebsrvr directory has been replaced by the Client directory. The Siebel Web Client uses a
different configuration file from that used by the Mobile and Developer Web Clients.

2.l. What is the HTTP address shown in the address bar?


http://localhost:8080/start.swe. This is the fastest way to tell that you are not using the
“plain” Web client. Both the Mobile and Developer Web Clients have a port number in
their HTTP addresses.

2.m. What is the connect string for this client?


SEAW Siebel. The Siebel Developer Web Client uses a different connect string from the
server.

2.n. What is the full path to the repository file for this client?
D:\OUsea\Client\objects\enu\siebel.srf. The Siebel Developer Web Client uses a different
repository file from the server.

2.q. What do you notice about the state of the server?


Its state is unavailable, which makes sense because we shut it down.

Siebel 8.0 Essentials 121


Module 11: Siebel Client Types

3.c. What is the connect string for this client?


D:\OUsea\Client\sample\UTF8\sse_samp.dbf –q –m –x NONE –gp 4096 –c40m –ch60m.
This is a local SQL Anywhere database.

3.d. What is the full path to the repository file for this client?
D:\SUsea\Client\objects\enu\siebel.srf.

122 Siebel 8.0 Essentials


Module 12: Securing Access to the Application

Lab 12-1 Securing Access to the Application (Unguided)

Goals To add a login and user to the database

Time 10 - 15 minutes

Instructions:
Due to the fact that this lab uses database utilities to update the Siebel database, there is no Unguided
version of it. Please turn the page and do the Guided version.

Siebel 8.0 Essentials 123


Module 12: Securing Access to the Application

124 Siebel 8.0 Essentials


Module 12: Securing Access to the Application

Lab 12-1 Securing Access to the Application (Guided)

Goals To add a login and user to the database

Time 10 - 15 minutes

Instructions:
In this lab, you will add a user using database authentication. Configuring LDAP or ADSI
authentication is beyond the scope of this course.

1. You will now add a user to the database and confirm that this grants the user access to the
application using database authentication.
a. Start Siebel Call Center using the Web client and log in as SADMIN/SADMIN.
b. Navigate to Administration - User > Users.
c. Create a new user with the following values:
Last Name Fermi
First Name Ernest
User ID EFERMI
Responsibility Siebel Administrator
d. Log out of Siebel Call Center.
e. Attempt to log in to Siebel Call Center as EFERMI/EFERMI. What happens? Why?

f. Use Notepad to open D:\Labs\Essentials\add login for PPENGUIN.sql.


i. Use Windows Explorer to navigate to D:\Labs\Essentials.
ii. Right-click add login for PPENGUIN.sql and select Open With > Notepad.
iii. If Notepad is not listed, select Open With > Choose Program and select Notepad from
the list of programs.
g. Examine add login for PPENGUIN.sql. This is a SQL script created to add users to the
Microsoft SQL Server database. Based on your RDBMS and or DBA standards, your scripts
may look different.
h. Press CTRL+A to select all of the text in the document.
i. Press CTRL+C to copy all of the text in the document.
j. Close add login for PPENGUIN.sql, not saving any changes.
k. Select Start > Programs > Microsoft SQL Server 2005 > SQL Server Management Studio
Express. This is the database management tool used in the classroom. Your company’s
installation will use a different tool.

Siebel 8.0 Essentials 125


Module 12: Securing Access to the Application

l. In the Connect to Server window, enter or confirm the following values:


Server Name localhost
Authentication SQL Server Authentication
Login sa
Password sa1
Remember password Checked
m. Click Connect. After a few moments, you should be successfully logged in to Microsoft
SQL Server Management Studio Express.
n. Click the New Query button in the upper left part of the screen. A query pane opens on the
right.
o. Click anywhere within the query pane to select it and then press CTRL+V to paste your
script.
p. Change every instance of PPENGUIN to EFERMI. You should make 4 replacements.
q. Click Execute. The script should execute successfully. If it does not, check your editing and
try again, or contact your instructor.
r. Select File > Exit to close Microsoft SQL Server Management Studio Express.
s. Attempt to log in to Siebel Call Center as EFERMI/EFERMI. What happens? Why?

126 Siebel 8.0 Essentials


Module 12: Securing Access to the Application

Solutions 12-1 Securing Access to the Application


(Guided)

Answers
1.e. What happens? Why?
The user ID or password that you entered is incorrect. EFERMI has not yet been given a
database login.

1.s. What happens? Why?


You successfully log in because EFERMI has been added as a database user.

Siebel 8.0 Essentials 127


Module 12: Securing Access to the Application

128 Siebel 8.0 Essentials


Module 14: Siebel Application Architecture

Lab 14-1 Exploring Relationships in the Application


Architecture (Unguided)

Goals To practice using About View to determine object definitions.


To observe how UI object definitions reference business object definitions.

Time 20 - 25 minutes

Instructions:

In this lab, you will gain a better understanding of the nature of the relationships between the user
interface (UI), business, and data layers of the Siebel application. You will map the UI objects to
business objects. As you complete this lab, think about the relationships between screens, views, and
applets at the UI layer, and business objects and business components at the business layer.

1. Identify some of the major application architecture objects being used for the Opportunities
Screen. Enter your responses into this diagram:

a. Open Siebel Call Center using the Siebel Developer Web Client and log in as
JRUBIN/JRUBIN to the Sample database.

Siebel 8.0 Essentials 129


Module 14: Siebel Application Architecture

b. Navigate to the Opportunities List view use Help > About View to complete the job aid
above.

2. Use Help > About View to identify the views and related business objects for selected contact
views.
Navigation This View. . . . . . references this
Business Object
Contacts Home

Contacts List

Consumers List

Personal Contacts
List

3. Based on your work so far in this lab, how many Business Objects do you think can be displayed
in a view?
One
Many

4. How many views can display the same business object?


One
Many

5. Examine the relationship between applets and business components. Identify the applet and
business components used in the Service Request Calendar view. Applets reference business
components that are contained within a business object.
a. Navigate to Service Requests > Service Request List > Calendar.
b. What are the names of the Applets?

________________________________________________________________________
c. What are the names of the Business Components?

d. Based on your work so far in this lab, how many business components map to an applet?
One
Many

130 Siebel 8.0 Essentials


Module 14: Siebel Application Architecture

e. How many applets can reference a given business component?


One
Many

6. Log out of all Siebel Call Center sessions.

Siebel 8.0 Essentials 131


Module 14: Siebel Application Architecture

Solutions 14-1 Exploring Relationships in the


Application Architecture (Unguided)

Answers:
1.

132 Siebel 8.0 Essentials


Module 14: Siebel Application Architecture

2. Identify the views and related business objects for selected contact views.
Navigation This View. . . . . . references this
Business Object
Contacts Home Contact Screen Homepage Contact
View

Contacts List Visible Contact List View Contact

Consumers List Consumer List View Consumer

Personal Contacts Personal Contact List View Contact(Personal)


List

3. Based on your work so far in this lab, how many Business Objects do you think can be
displayed in a view?
One

4. How many views can display the same business object?


Many

5.b. What are the names of the Applets?


Service Request Detail Applet; eCalendar Monthly Applet Without Employee

5.c. What are the names of the Business Components?


Service Request and Action

5.d. Based on your work so far in this lab, how many business components map to an applet?
One

5.e. How many applets can reference a given business component?


Many

Siebel 8.0 Essentials 133


Module 14: Siebel Application Architecture

134 Siebel 8.0 Essentials


Module 14: Siebel Application Architecture

Lab 14-1 Exploring Relationships in the Application


Architecture (Guided)

Goals To practice using About View to determine object definitions.


To observe how UI object definitions reference business object definitions.

Time 20 – 25 minutes

Instructions:

In this lab, you will gain a better understanding of the nature of the relationships between the user
interface (UI), business, and data layers of the Siebel application. You will map the UI objects to
business objects. As you complete this lab, think about the relationships between screens, views, and
applets at the UI layer, and business objects and business components at the business layer.

1. In this step, you will identify some of the major application architecture objects being used for
the Opportunities Screen. For each question in this step, enter your response into this diagram:

a. Open Siebel Call Center using the Siebel Developer Web Client and log in as
JRUBIN/JRUBIN to the Sample database.

Siebel 8.0 Essentials 135


Module 14: Siebel Application Architecture

b. View the application title in Internet Explorer’s banner (located at the top of the browser
window). Enter the Application name into the diagram.
c. Navigate to Opportunities > List.
d. Select Help > About View. Enter the names for Screen, View, Applets, Business Object and
Business Components into the diagram.
e. Click OK to close the About View window.

2. In this step, you will explore the relationship between views and business objects in various
contacts views.
a. Identify the views and related business objects for the selected contact views.
i. Click the Contacts tab.
ii. Use the hyperlinks in the Link bar to select each of the views listed under the Navigation
column in the table, below. For each navigation path, determine the name of the view and
the Business Object it references. For assistance, use About View. Enter your responses
directly into this table:
Navigation This View. . . . . . references this
Business Object
Contacts Home

Contacts List

Consumers List

Personal Contacts
List

b. Based on your work so far in this lab, how many Business Objects do you think can be
displayed in a view?
One
Many
c. How many views can display the same business object?
One
Many

136 Siebel 8.0 Essentials


Module 14: Siebel Application Architecture

3. In this step, you will consider the relationship between applets and business components. You
will identify the applet and business components used in the Service Request Calendar view.
Applets reference business components which are contained within a business object.
a. Navigate to Service Requests > Service Request List > Calendar. How many applets are
displayed?

________________________________________________________________________
b. Select Help > About View. What are the names of the Applets?

________________________________________________________________________
c. What are the names of the Business Components?

d. Based on your work so far in this lab, how many business components map to an applet?
One
Many
e. How many applets can reference a given business component?
One
Many

4. In this step, you will explore screen navigation available in the application. Screens are
associated with major functional areas of the enterprise, such as Accounts, Contacts, and
Opportunities. You access screens explicitly through Screen Tabs or the Site Map (you can also
access them implicitly when you drill down on an object that takes you to a view in a different
screen). Screen object definitions specify the default view that appears when a tab is clicked.
Screens group views together to enable users to quickly access the data they require by
navigating to an area of functionality and be taken to the appropriate view.
a. Note the number of screens that appear as screen tabs for JRUBIN.

b. Click the Site Map button to display the Site Map. Approximately how many screens appear
in the Site Map?
15
30
60+
c. Why might the number of screens accessible as screen tabs be less than the number
accessible from the Site Map?

5. In this step, you will examine administration views to observe references to business objects.
Screens may contain one or many views, each of which references a business object. However,
screens themselves do not directly map to business objects.
a. Log out of the Siebel Call Center session where you are logged in as JRUBIN.

Siebel 8.0 Essentials 137


Module 14: Siebel Application Architecture

b. Start another Siebel Call Center session using the Siebel Developer Web Client and logging
in as SADMIN/SADMIN to the Sample database.
c. Navigate to Administration - Application > State Models. Which business object is
displayed?

d. Navigate to Administration - Application > Responsibilities. Which business object is


displayed?

e. Are different business objects being displayed under the System Administration Screen? If so
why might this be the case?

6. Log out of all Siebel Call Center sessions.

138 Siebel 8.0 Essentials


Module 14: Siebel Application Architecture

Solutions 14-1 Exploring Relationships in the


Application Architecture (Guided)

Answers:
1.

Siebel 8.0 Essentials 139


Module 14: Siebel Application Architecture

2.a.ii. Use the hyperlinks in the Link bar to select each of the views listed under the Navigation
column in the table, below. For each navigation path, determine the name of the view and the
Business Object it references. For assistance, use About View. Enter your responses directly
into this table:
Navigation This View. . . . . . references this
Business Object
Contacts Home Contact Screen Homepage Contact
View

Contacts List Visible Contact List View Contact

Consumers List Consumer List View Consumer

Personal Contacts Personal Contact List View Contact(Personal)


List

2.b. Based on your work so far in this lab, how many Business Objects do you think can be
displayed in a view?
One

2.c. How many views can display the same business object?
Many

3.a. Navigate to Service Requests > Service Request List > Calendar. How many applets are
displayed?
2. Due to your screen resolution, it is possible, that you may only see one applet.

3.b. Select Help > About View. What are the names of the Applets?
Service Request Detail Applet; eCalendar Monthly Applet Without Employee

3.c. What are the names of the Business Components?


Service Request and Action

3.d. Based on your work so far in this lab, how many business components map to an applet?
One

3.e. How many applets can reference a given business component?


Many

140 Siebel 8.0 Essentials


Module 14: Siebel Application Architecture

4.a. Note the number of screens that appear as screen tabs for JRUBIN.
7

4.b. Click the Site Map button to display the Site Map. Approximately how many screens appear
in the Site Map?
60+

4.c. Why might the number of screens accessible as screen tabs be less than the number
accessible from the Site Map?
The screen tabs typically show only the more commonly used screens. Also, note that the
screen tabs displayed is determined by the responsibilities associated with the user.

5.c. Navigate to Administration - Application > State Models. Which business object is
displayed?
State Model

5.d. Navigate to Administration - Application > Responsibilities. Which business object is


displayed?
Responsibility

5.e. Are different business objects being displayed under the System Administration Screen? If so
why might this be the case?
Yes. Administration screens are the exception in that the screen consists of a collection of
views that reference different business objects. In the case of other screens, the views
reference the same business object to maintain the same data context.

Siebel 8.0 Essentials 141


Module 14: Siebel Application Architecture

142 Siebel 8.0 Essentials


Module 15: Using Siebel Tools to Examine Object Definitions

Lab 15-1 Examining Object Definitions (Unguided)

Goal To practice examining object definitions in the repository.

Time 25 - 30 minutes

Instructions:
Siebel Tools is an integrated environment for configuring Siebel applications. You use Siebel Tools
to modify standard Siebel object definitions and create new object definitions to meet your
organization’s business requirements. Siebel Tools is a declarative configuration tool, not a
programming environment. You use Siebel Tools to create and modify the object definitions
(metadata) that define Siebel applications. You do not modify the source code or directly write SQL.
In this lab, you will explore some of the basic Siebel Tools navigation features.

1. Start Siebel tools then log in as SADMIN/SADMIN connecting to the Sample database.

2. Select Application in the Object Explorer (OE). How many application object definitions are
listed in the Object List Editor (OBLE)?

3. Explore child object types.


a. Expand the parent Application object type.

b. How many child object types are listed for the Application object type?

4. Navigate to Screen :: Contacts Screen | Screen View and query for all screen view object
definitions whose names contain the string “Contact Detail”. Your query should return 14
records.

Siebel 8.0 Essentials 143


Module 15: Using Siebel Tools to Examine Object Definitions

5. From the same view, query for all records whose names contain the string “Contact” AND the
string “View”. Your query should return 16 records.

6. From the same view, query for all records whose names contain the string “Contact” OR the
string “View”. Your query should return 67 records.

7. Use Columns Displayed to reorder columns for the screen views. Reorder columns to place the
Sequence column next to the View column.

8. Query for an object definition that contains special characters by selecting Business Component
in the OE and querying for the name Account (Contact Us).

9. Use the Flat tab to determine the parent screen of the Action Plan View screen view object. Use
the screen shot below as an aid.

144 Siebel 8.0 Essentials


Module 15: Using Siebel Tools to Examine Object Definitions

10. Click the Types tab to restore the Object Explorer to the hierarchical display mode.

11. Leave Siebel Tools open for the next lab.

Siebel 8.0 Essentials 145


Module 15: Using Siebel Tools to Examine Object Definitions

Solutions 15-1 Examining Object Definitions (Unguided)

Answers:
2.a. Select Application in the Object Explorer (OE). How many application object definitions
are listed in the Object List Editor (OBLE)?
28.

3.b. How many child object types are listed for the Application object type?
2, Page Tab and Screen Menu Item.

9. Use the Flat tab to determine the parent screen of the Action Plan View screen view object.
The Opportunities Screen.

146 Siebel 8.0 Essentials


Module 15: Using Siebel Tools to Examine Object Definitions

Lab 15-1 Examining Object Definitions (Guided)

Goal To practice examining object definitions in the repository.

Time 25 - 30 minutes

Instructions:
Siebel Tools is an integrated environment for configuring Siebel applications. You use Siebel Tools
to modify standard Siebel object definitions and create new object definitions to meet your
organization’s business requirements. Siebel Tools is a declarative configuration tool, not a
programming environment. You use Siebel Tools to create and modify the object definitions
(metadata) that define Siebel applications. You do not modify the source code or directly write SQL.
In this lab, you will explore some of the basic Siebel Tools navigation features.

1. In this step, you will start Siebel tools then log in as SADMIN connecting to the Sample
database.
a. Select Start > Programs > Siebel Tools 8.0 > Siebel Tools.
b. If necessary, select Agree to Terms in the licensing dialog box.
c. In the login screen, enter the following:
Field Value
User ID SADMIN
Password SADMIN
Connect to Server
The Object Explorer (OE) should be displayed. The Types tab in the OE should be selected
by default. Siebel object definitions are the metadata that define Siebel applications. Object
definitions are stored in a set of database tables called the Siebel Repository. The Siebel
Repository File (SRF) contains compiled object definitions for improved performance. Some
example object types are applets, views, business components, and tables. The Object
Explorer (OE) displays the types, and the Object List Editor (OBLE) displays definitions for
those types. Together, they provide a view into the objects and object definitions in the
repository database tables.

When you select an object type in the OE then create a new record in the OBLE, you are
presented a template in the OBLE for the object type currently selected in the OE. Once you
enter values into the template, you will have created a definition for the object. Hence,
“object definition”.

Siebel 8.0 Essentials 147


Module 15: Using Siebel Tools to Examine Object Definitions

2. In this step, you will explore the record counter. Many objects in tools are displayed as
individual records in the OBLE. The total number of records currently displayed can be
determined by viewing the record counter, which is visible immediately underneath the OBLE.
a. Select Application in the OE. How many application object definitions are listed in the
Object List Editor (OBLE)?

b. In cases where a large number of records are present, you can cause the record counter to
numerate from the end of the list.
i. Select Table in the OE.
ii. Use the vertical scrollbar at the far right of the OBLE to navigate to the last record.
To do so, select the slider control inside the vertical scrollbar and pull the slider all
the way down to the bottom of the vertical scrollbar.
iii. Slowly scroll up.
iv. Observe the record counter behavior.

3. In this step, you will learn how Tools indicates the active object definition.
a. Select Application in the OE.
b. Select the Siebel Universal Agent object definition in the OBLE by clicking the row tab to
the left of the record. What visual cues indicate that a definition has been selected?

4. In this step, you will explore child object types. Object definitions have hierarchical relationships
called parent-child relationships. For example, when you expand an object type in the OE, such
as Applet, you see child object types, including Applet Method Menu Item, Applet Browser
Script, Applet Server Script, and Applet Toggle. Parent-child relationships between these objects
imply that the child object is in, or belongs to the parent object, but it does not imply inheritance
among objects. The set of properties of a parent object is generally unrelated to the set of
properties of a child object.

The Types tab in the OE shows the object hierarchy. Clicking the plus sign (+) to the left of an
object type displays all the child object types of the top-level object type. Clicking the minus
sign (–) to the left of an object type collapses all its child object types. By default, not all object
types are visible in the Object Explorer. Later in this course you will learn how to show and hide
additional object types.

148 Siebel 8.0 Essentials


Module 15: Using Siebel Tools to Examine Object Definitions

a. Expand the parent Application object type.

b. How many child object types are listed for the Application object type?

5. In this step, you will query to display all the page tabs that are included in the Siebel Universal
Agent application.
a. Select Application :: Siebel Universal Agent | Page Tab. This notation means to first select
the Application object type in the OE, next select the Siebel Universal Agent record in the
OBLE, and then select the Page Tab child object type in the OE.
b. Perform a null query to ensure that all the Page Tab child object definitions are listed.
i. From the application-level menu, select Query > New Query (or click the New Query
button ).
ii. Select Query > Execute Query (or click the Execute Query button ).
iii. Based on the number of child page tab object definitions displayed, what can you
infer about the object definition’s relationship with the parent Page Tab object type?
There can be zero to many object definitions for a given object type.
There can only be one object definition for a given object type.

6. In this step, you will navigate to Screen :: Contacts Screen | Screen View. Then, you will use a
wildcard to query similar items. A number of common operators are available, such as =, >, <,
<>, LIKE, etc. You can also use AND, OR, and NOT to issue a compound query. By default,
Siebel Tools queries are case sensitive. For more information, reference Using Siebel Tools.
a. Select Screen in the OE.
b. Click anywhere in the OBLE.
c. Click the New Query button.
d. Enter Contacts Screen in the name property.
e. Click the Execute Query button.
f. Expand the Screen object type in the OE.

Siebel 8.0 Essentials 149


Module 15: Using Siebel Tools to Examine Object Definitions

g. Select Screen View in the OE. Your interface should look similar to this:

h. Query for all screen view object definitions named “Contact Detail”. To run this query,
bracket the string with asterisks. For example *Contact Detail*. Your query should return 14
records.
i. Now use an operator in your query: *Contact* AND *Detail*. Your query should return 16
records. AND returns all strings, even those that are merely concomitant, not contiguous.
j. Use the OR operator. Query *Contact* OR *Detail*. Your query should return 67 records.
k. Query for an object definition that contains special characters.
i. Select Business Component in the OE.
ii. In the Name property of the OBLE, query for 'Account (Contact Us)'. Ensure you
bracket the query with single quotes.

7. In this step, you will use Columns Displayed to reorder columns. When working in Tools, it is
often useful to display and reorder columns to only display properties you seek, or to move
desired properties into the immediately viewable area of the OBLE.
a. Reorder columns to place the Sequence column next to the View column.
i. Right-click anywhere in the Screen Views window.
ii. Select Columns Displayed.

150 Siebel 8.0 Essentials


Module 15: Using Siebel Tools to Examine Object Definitions

iii. Select Sequence in the Displayed columns dialog box, and use the arrows to move it
to follow immediately after View.

iv. Click OK.


v. Observe the change in the OBLE. You should see the Sequence property immediately
to the right of the View property. If necessary, use the OBLE’s horizontal scroll bar.

8. In this step, you will use Siebel Tools hyperlinks to quickly navigate between related objects. For
example, the UI layer Account Entry Applet references the business layer Account business
component, which in turn references the data layer S_PARTY table. In Tools, these references
are manifested as hyperlinks.
a. Select Applet :: Account Entry Applet. Querying for a specific object definition is a quick
way to access and isolate it (rather than scrolling). What is the value of the Business
Component property?

b. Drill down to the Account business component by clicking the Account hyperlink.
c. Identify the value of the table property. When working with a frequently viewed property,
such as Table, use Columns Displayed to move the property into the immediately viewable
area of the OBLE, thus avoiding horizontal scroll bar use. Additionally, you can drag and
drop column headers to re-order them. What is the value of the Table property?

d. Drill down on the Table property. Note that you have now navigated from the UI layer,
through the business layer to the data layer via hyperlinks.

Siebel 8.0 Essentials 151


Module 15: Using Siebel Tools to Examine Object Definitions

e. Click the back arrow to return to the Account business component.

9. In this step, you will use Flat tab to display object types (parent and child) in a single,
alphabetically-arranged list, without displaying the parent-child relationship. When Flat tab is
used, if the object selected is the child in a parent/child relationship, additional parent
information is included in the OBLE that is not present when the Type tab is used. For example,
the Screen View object is the child of the Screen object type. In flat tab, the Parent Screen
property provides direct hyperlink access to the parent:

In this screen print, you can also see that if there are multiple parents that reference the same
child, then the child is repeated in flat view for each parent that references it. That is why the
screen view A Account Partner View has more than one entry in the list.

The Flat tab is particularly helpful in finding a child object with an unknown parent. For
example, if you created a new field but do not remember what business component it is in, you
can select the Field object type in the Flat tab and search the Name property for the field name in
question.
a. Select the Flat tab in the OE.
b. Select the Screen View object type. When you use the Flat tab, you may notice a slight delay
before the list of objects is displayed in the OBLE. This is due to that fact that all objects in
the repository of the type you select, such as Screen View, are displayed. This is significantly
different compared to when objects are viewed via Types tab, where the parent/child
relationship greatly reduces the number of object definitions to be retrieved and displayed.
c. In the OBLE, query for the screen view object definition named Action Plan View. What
screen is its parent (look for the Parent Screen property)?

152 Siebel 8.0 Essentials


Module 15: Using Siebel Tools to Examine Object Definitions

d. Click on the Opportunities Screen hyperlink in the Parent Screen property of the OBLE.
What happens in the OE?

e. What happens in the OBLE?

f. Identify a Screen View that is referenced by multiple parent Screens.


i. Select the Screen View object type in the OE.
ii. Query for a screen view named Account List. Your query should return four object
definitions, each referenced by a different parent screen.
g. Click the Types tab to restore the Object Explorer to the hierarchical display mode.

10. Leave Siebel Tools open for the next lab.

Siebel 8.0 Essentials 153


Module 15: Using Siebel Tools to Examine Object Definitions

Solutions 15-1 Examining Object Definitions (Guided)

Answers:
2.a. Select Application in the OE. How many application object definitions are listed in the
Object List Editor (OBLE)?
28

3.b. Select the Siebel Universal Agent object definition in the OBLE by clicking the row tab to
the left of the record. What visual cues indicate that a definition has been selected?
An active record indicator appears at the far left, and the record is highlighted in color.

4.b How many child object types are listed for the Application object type?
2, Page Tab and Screen Menu Item

5.b.iii. Based on the number of child page tab object definitions displayed, what can you infer about
the object definition’s relationship with the parent Page Tab object type?
There can be zero to many object definitions for a given object type.

8.a. Select Applet :: Account Entry Applet. Querying for a specific object definition is a quick
way to access and isolate it (rather than scrolling). What is the value of the Business
Component property?
Account

8.c. Identify the value of the table property. When working with a frequently viewed property,
such as Table, use Columns Displayed to move the property into the immediately viewable
area of the OBLE, thus avoiding horizontal scroll bar use. Additionally, you can drag and
drop column headers to re-order them. What is the value of the Table property?
S_PARTY

9.c. In the OBLE, query for the screen view object definition named Action Plan View. What
screen is its parent (look for the Parent Screen property)?
Opportunities Screen

9.d. Click on the Opportunities Screen hyperlink in the Parent Screen property of the OBLE.
What happens in the OE?
The Screen object type is automatically selected.

9.e. What happens in the OBLE?


The Opportunities Screen object definition is displayed.

154 Siebel 8.0 Essentials


Module 16: The Siebel Data Model

Lab 16-1 Exploring the Data Model (Unguided)

Goal To examine some of the tables, indexes, user keys, and foreign keys that
make up the Siebel Data Model.

Time 30 - 40 minutes

Instructions:
In this lab, you will investigate the Siebel Data Model. You will gain a better understanding of the
relationships between the user interface, business and data layers. First, you will navigate Tools to
determine how a user interface object references an object in the business layer and how that object
references an object in the data layer. Next, you will explore Tools to gain a better understanding of
various table properties and system columns. You will then explore user keys and indexes for a
table. You will finally review the different extension tables and their parent/base tables.

1. Identify some of the major application architecture objects being used for the Opportunities
Screen. Determine the data table and column that map to the Opportunity Name list column in
the Opportunities List Applet. To assist with this task, you will use the job aid, below. Enter your
responses into the job aid, as directed.
Layer Object You’re
Step Tip for Finding Information Enter Value Here
looking For

Look for text label


User • List applet: column heading above
Interface 1 Display Name field in question
Objects
• Form applet: control label next to
field

  2 Applet Name In UI: Help > About View

Business
3 In UI: Help > About View
Business Component
Objects
a. In Tools: <applet name> | List :: List |
List Column.
Business
4 Component b. Query Display Name for <display
Field name>.

c. Value you need is the Field property.

Siebel 8.0 Essentials 155


Module 16: The Siebel Data Model

Layer Object You’re


Step Tip for Finding Information Enter Value Here
looking For

In Tools: Business Component :: <BC


name>| Field :: <field name>
IF Join property is empty
Enter base table name
Data 5 Table Name ELSE
Objects Enter value in Join property

Note: if query fails, Field property is


calculated. Try this: query Calculated
Value for *<field name>*

In Tools: Business Component :: <BC


Table Column
6 name>| Field :: <field name>. Value in
Name
Column property.

a. If necessary, open Siebel Call Center using the Siebel Web Client and log in as
SADMIN/SADMIN.
b. Navigate to the opportunities list and enter the display name (for the opportunity name),
name of the list applet, and business component of the list applet into the job aid.
c. If necessary, start Siebel Tools and log in as SADMIN/SADMIN connecting to the Sample
database.
d. Enter the field corresponding to the Opportunity Name list column displayed in the applet
into the job aid.
e. Enter the table name and table column name for this field into the job aid.

156 Siebel 8.0 Essentials


Module 16: The Siebel Data Model

2. Use Siebel Tools to inspect some important table properties, such as Required, Physical Type,
Length, and Default, for columns in the S_SRV_REQ table.
a. Select Table :: S_SRV_REQ | Column.
b. Examine the Type property. What two column types are included in this table?

c. Review the system columns that are representative of the columns that appear in all tables.
Of these system columns, which one is the primary key for this table?

d. Query the table for all columns that have Physical Type of Date Time. What column in
S_SRV_REQ has a Physical Type of Date Time?

3. Examine how user keys can enforce uniqueness when records are created. The user key is a
column or set of columns on a Siebel table that uniquely identifies a row.
a. Expose the User Key Column in Object Explorer.

Siebel 8.0 Essentials 157


Module 16: The Siebel Data Model

b. Select Table :: S_OPTY | User Key :: S_OPTY _U1 | User Key Column. Identify which
columns make up this user key. Enter your answer directly into the diagram, below.

S_OPTY
ROW_ID

S_OPTY _U1
User Key
c. Open Siebel Call Center using the Siebel Developer Web Client and log in as
SADMIN/SADMIN to the Sample database.
d. Create a new opportunity record using the values in the table, below. Use Columns Displayed
to expose the Organization column. When adding the Organization via the shuttle applet, set
Capital Systems to the Primary, then remove Default Organization.
Property Value
Opportunity Name A Big Deal
Account Bay Builders
Organization Capital Systems
e. Create another new record with exactly the same values. Save it. What happens? Why?

f. Now, change Organization to ABC Reseller. You should be able to now step off the record
and save it since both records are unique.
g. Delete the records.
h. Log out of the Call Center application.

4. Use Siebel Tools to examine indices.


a. In Siebel Tools, select Table :: S_OPTY | Index to display the indexes for the table. How
many indices are defined for the S_OPTY table?
More than 10
More than 40

158 Siebel 8.0 Essentials


Module 16: The Siebel Data Model

b. Select Table :: S_OPTY | Index :: S_OPTY_P1 | Index Column. Which column(s) make up
this index?

c. Which column(s) make up the S_OPTY_U1 index?

5. Practice locating foreign key columns. You will use this skill while exploring the Siebel Data
Model and in configuring the Siebel application.
a. Select Table :: S_SRV_REQ | Column to display the columns in the S_SRV_REQ table.
b. What is the Foreign Key Table for the AGREE_ID column? Enter your answer into the table
header on the right-hand side of the diagram.

S_SRV_REQ
ROW_ID

AGREE_ID

ROW_ID

FK PK

c. What column(s) serve(s) as a foreign key to S_PROD_INT? Enter your answer into the table
on the left-hand side of the diagram. Draw line(s) between the tables to indicate FK/PK
relationship(s).

S_SRV_REQ S_PROD_INT
ROW_ID

ROW_ID

Siebel 8.0 Essentials 159


Module 16: The Siebel Data Model

6. Examine a 1:1 extension table to see how it relates to its base table.
a. Select Table :: S_SRV_REQ_X.
b. View the Type property. What is the type of the table?

c. What is the Base Table to S_SRV_REQ_X?

d. What is the value of the foreign key Column Name for the foreign key to S_SRV_REQ in the
S_SRV_REQ_X extension table?

e. Enter the column name into the table on the right-hand side of the diagram, above.
f. Draw a line between the tables to indicate the FK/PK relationship.

7. Identify any pre-built intersection tables that support the M:M relationship between project and
contacts. The query below works by selecting tables with foreign keys for either S_PROJ or
S_CONTACT.
a. Select the Flat tab and then select Column in the Object Explorer (OE).
b. Execute a compound query with the following values:
Property Value
User Key Sequence 1 OR 2
Foreign Key Table S_PROJ OR S_CONTACT
c. Sort the results of the query in ascending order for both the Parent Table list column and the
User Key Sequence list column.
d. Look for a Parent Table that appears in two adjacent rows where the Foreign Key Table
property is S_PROJ in one row and S_CONTACT in the other row. Note that the parent table
name has a _CON suffix. Which table satisfies these criteria?

160 Siebel 8.0 Essentials


Module 16: The Siebel Data Model

e. Complete the diagram, below.


i. Enter the names of the two data tables that have a M:M relationship.
ii. Enter the name of the intersection table.
iii. Enter the names of the two FK columns in the intersection table.
Intersection
Data Table Table Data Table
S_PROJ S_CONTACT
ROW_ID

ROW_ID
ROW_ID
PK PK

FK FK

f. Select the Types tab to restore the Object Explorer to the hierarchical display mode.

Siebel 8.0 Essentials 161


Module 16: The Siebel Data Model

Solutions 16-1 Exploring the Data Model (Unguided)

Answers:
1.
Job Aid: Identify Table Column That Supplies Data for an Applet Control
Layer Object You’re
Step Tip for Finding Information Enter Value Here
looking For

Look for text label


User Opportunity Name
• List applet: column heading above
Interface 1 Display Name field in question
Objects • Form applet: control label next to
field

  2 Applet Name In UI: Help > About View


Opportunity List
Applet
Business
3 In UI: Help > About View
Business Component Opportunity
Objects
a. In Tools: <applet name> | List :: List |
Name
List Column.
Business
4 Component b. Query Display Name for <display
Field name>.

c. Value you need is the Field property.

In Tools: Business Component :: <BC


name>| Field :: <field name> S_OPTY
IF Join property is empty
Enter base table name
Data 5 Table Name ELSE
Objects Enter value in Join property

Note: if query fails, Field property is


calculated. Try this: query Calculated
Value for *<field name>*

In Tools: Business Component :: <BC


Table Column NAME
6 name>| Field :: <field name>. Value in
Name
Column property.

162 Siebel 8.0 Essentials


Module 16: The Siebel Data Model

2.b. Examine the Type property. What two column types are included in this table?
Data(Public) and System.

2.c. Of these system columns, which one is the primary key for this table?
ROW_ID.

2.d. What column in S_SRV_REQ has a Physical Type of Date Time?


POST_MORTEM_RVW_DT.

3.b. Select Table :: S_OPTY | User Key :: S_OPTY_U1 | User Key Column. Identify which
columns make up this user key. Enter your answer directly in to the diagram, below.
S_OPTY
BU_ID

NAME
ROW_ID

PR_DEPT_OU_ID

S_OPTY _U1
User Key

3.e. Create another new record with exactly the same values. Save it. What happens? Why?
The new record cannot be saved because a record with the same name, account, and
organization already exists. BU_ID stores a unique value to identify the business unit, in
this case, Bay Builders under Account. NAME stores Opportunity Name, in this case, A Big
Deal. PR_DEPT_OU_ID stores a unique value for the Organization. When an attempt is
made to save the record, a check is made against the S_OPTY _U1 user key. If all three
fields are identical, that is, the user key matches, the save is disallowed.

4.a. In Siebel Tools, select Table :: S_OPTY | Index to display the indexes for the table. How
many indices are defined for the S_OPTY table?
More than 10

4.b. Select Table :: S_OPTY | Index :: S_OPTY_P1 | Index Column. Which column(s) make up
this index?
ROW_ID.

4.c. Which column(s) make up the S_OPTY_U1 index?


BU_ID, CONFLICT_ID, NAME, PR_DEPT_OU_ID

Siebel 8.0 Essentials 163


Module 16: The Siebel Data Model

5.b. What is the Foreign Key Table for the AGREE_ID column? Enter your answer into the
table header on the right-hand side of the diagram.
S_SRV_REQ
ROW_ID S_ENTLMNT

AGREE_ID

FK ROW_ID PK

5.c. What column(s) serve(s) as a foreign key to S_PROD_INT? Enter your answer into the
table on the left-hand side of the diagram. Draw line(s) between the tables to indicate
FK/PK relationship(s).
S_SRV_REQ S_PROD_INT
PRDINT_ID
ROW_ID

ROW_ID

FK PK

6.b. View the Type property. What is the type of the table?
Extension.

6.c. What is the Base Table to S_SRV_REQ_X?


S_SRV_REQ.

6.d. What is the value of the foreign key Column Name for the foreign key to S_SRV_REQ in
the S_SRV_REQ_X extension table?
PAR_ROW_ID.

6.f. Draw a line between the tables to indicate the FK/PK relationship.
(see diagram, above).

7.d. Look for a Parent Table that appears in two adjacent rows where the Foreign Key Table
property is S_PROJ in one row and S_CONTACT in the other row. Note that the parent
table name has a _CON suffix. Which table satisfies these criteria?
S_PROJ_CON.

164 Siebel 8.0 Essentials


Module 16: The Siebel Data Model

7.e. Complete the diagram, below.


Intersection
Data Table Table Data Table
S_PROJ S_CONTACT

ROW_ID
ROW_ID

S_PROJ_CON

PROJ_ID
ROW_ID

CON_ID
PK PK

FK FK

Siebel 8.0 Essentials 165


Module 16: The Siebel Data Model

166 Siebel 8.0 Essentials


Module 16: The Siebel Data Model

Lab 16-1 Exploring the Data Model (Guided)

Goal To examine some of the tables, indexes, user keys, and foreign keys that
make up the Siebel Data Model.

Time 30 - 40 minutes

Instructions:
In this lab, you will investigate the Siebel Data Model. You will gain a better understanding of the
relationships between the user interface, business and data layers. First, you will navigate Tools to
determine how a user interface object references an object in the business layer and how that object
references an object in the data layer. Next, you will explore Tools and gain a better understanding
of various table properties and system columns. You will then explore user keys and indexes for a
table. You will then review the different extension tables and their parent/base tables.

1. In this step, you will identify some of the major application architecture objects being used for
the Opportunities Screen. You will determine the data table and column that maps to the UI
Opportunity Name list column in the Opportunities List Applet. To assist with this task, you will
use the job aid, below. Enter your responses into the job aid, as directed.
Layer Object You’re
Step Tip for Finding Information Enter Value Here
looking For

Look for text label


User • List applet: column heading above
Interface 1 Display Name field in question
Objects
• Form applet: control label next to
field

  2 Applet Name In UI: Help > About View

Business
3 In UI: Help > About View
Business Component
Objects
a. In Tools: <applet name> | List :: List |
List Column.
Business
4 Component b. Query Display Name for <display
Field name>.

c. Value you need is the Field property.

Siebel 8.0 Essentials 167


Module 16: The Siebel Data Model

Layer Object You’re


Step Tip for Finding Information Enter Value Here
looking For

In Tools: Business Component :: <BC


name>| Field :: <field name>
IF Join property is empty
Enter base table name
Data 5 Table Name ELSE
Objects Enter value in Join property

Note: if query fails, Field property is


calculated. Try this: query Calculated
Value for *<field name>*

In Tools: Business Component :: <BC


Table Column
6 name>| Field :: <field name>. Value in
Name
Column property.

a. If necessary, Open Siebel Call Center using the Siebel Web Client and log in as
SADMIN/SADMIN.
b. Navigate to Opportunities > List.
c. Locate the display name for the left-most column in the list applet. Enter your response into
the job aid.
d. Enter the Applet Name being used to display this list into the job aid.
e. Enter the Business Component into the job aid.
f. If necessary, start Siebel Tools and log in as SADMIN connecting to the Sample database.
g. Enter the Business Component Field into the job aid.
h. Enter the Table Name into the job aid. Remember to use Columns Displayed to move the
table property into the immediately viewable area of the OBLE.
i. Enter the Table Column Name into the job aid.

168 Siebel 8.0 Essentials


Module 16: The Siebel Data Model

2. In this step, you will diagram some of the objects you just identified. The objects you identified
in an earlier lab are already completed for you in the diagram, below. The diagram illustrates
how data in a table column is used by a list column in an applet. The Opportunity business
component references a base table, which in turn contains many columns. One of these columns
contains data referenced by a business component field called Name. This field, in turn, is
referenced by the applet’s list column, and the data is displayed. Base tables will be covered in
more detail later in this course.

Refer to the job aid completed in the previous step to complete the values in the empty boxes.

3. In this step, you will inspect some important table properties, such as Required, Physical Type,
Length, and Default, for columns in the S_SRV_REQ table. The Table object type is metadata
about the physical tables in the underlying database management system. The column child
object type is metadata about the columns in those physical tables. As you have discovered with
objects at the UI layer and business layer, objects at the data layer are also represented in the OE
as object types with their definitions displayed in the OBLE.
a. Select Table :: S_SRV_REQ | Column. Most table columns in Siebel applications are data
columns. Sometimes called base columns, data columns provide the data for fields, or serve
as foreign keys that point to rows in other tables. You cannot modify the properties of data
columns.
b. Examine the Type property.
i. To simplify viewing, lock the Name property column in place by double-clicking the
Name property column heading

Siebel 8.0 Essentials 169


Module 16: The Siebel Data Model

ii. Scroll to the Type property and note that the Name property remains in place. What
two column types are included in this table?

c. Review the system columns that are representative of the columns that appear in all tables.
i. Right-click anywhere in the lower window of the OBLE
ii. Click Sort Order.
iii. Sort by Type, descending.
iv. Of these system columns, which one is the primary key for this table? For assistance,
view the Primary Key property.

d. Query the Required property for True (checked). Is MODIFICATION_NUM a required


column?
Yes
No
e. Review the Physical Type and Length properties. There are several options for physical type
and length.
i. From the Tools application-level menu, select View > Windows > Properties
Window to open the Properties Window.

ii. Click the push-pin to auto-hide the properties window.

170 Siebel 8.0 Essentials


Module 16: The Siebel Data Model

f. Query the table for all columns that have Physical Type of Date Time. What column in
S_SRV_REQ has a Physical Type of Date Time?

4. In this step, you will examine how user keys can enforce uniqueness when records are created.
The user key is a column or set of columns on a Siebel table that uniquely identifies a row. This
is in addition to the ROW_ID column, which is also unique. Below, you will see how the three
columns displayed under User Key Columns make up the S_OPTY_U1 user key.
a. Expose the User Key Column in Object Explorer.
i. Select View > Options > Object Explorer.
ii. Scroll down to Table and expand the Table object type.
iii. Expand the User Key object type and ensure User Key Column has a checkmark.

iv. Click OK.


v. Select Table :: S_OPTY | User Key to display the user keys for the table. When
querying for S_OPTY, ensure you query the Name property, not the Base Table
property. Which user keys are defined?

Siebel 8.0 Essentials 171


Module 16: The Siebel Data Model

b. Select Table :: S_OPTY | User Key :: S_OPTY _U1 | User Key Column. Identify which
columns make up this user key. Enter your answer directly into the diagram, below.

S_OPTY
ROW_ID

S_OPTY _U1
User Key
c. Log out of your current Call Center session.
d. Open Siebel Call Center using the Siebel Developer Web Client and log in as
SADMIN/SADMIN to the Sample database.
e. Navigate to Opportunities > My Opportunities.
f. Create a new opportunity record using the values in the table, below. Use Columns Displayed
to expose the Organization column. When adding the Organization via the shuttle applet, set
Capital Systems to the Primary, then remove Default Organization.
Property Value
Opportunity Name A Big Deal
Account Bay Builders
Organization Capital Systems

172 Siebel 8.0 Essentials


Module 16: The Siebel Data Model

g. Create another new record with exactly the same values. Save it. What happens? Why?

You should have received an error message similar to this:

h. Click OK to dismiss the warning.


i. Now, change Organization to ABC Reseller. You should be able to now step off the record
and save it since both records are unique.
j. Delete the record.
k. Log out of the Call Center application.

5. In this step, you will use Siebel Tools to examine indices. Index object definitions are metadata
representations of physical indices in the underlying database management system. Siebel
applications include a set of standard indices.
a. In Siebel Tools, select Table :: S_OPTY | Index to display the indexes for the table. How
many indices are defined for the S_OPTY table?
More than 10
More than 40
b. Select Table :: S_OPTY | Index :: S_OPTY_P1 | Index Column. Which column(s) make up
this index?

c. Which column(s) make up the S_OPTY_U1 index?

6. In this step, you will practice locating foreign key columns. You will use this skill while
exploring the Siebel Data Model and in configuring the Siebel application.
a. Select Table :: S_SRV_REQ | Column to display the columns in the S_SRV_REQ table.

Siebel 8.0 Essentials 173


Module 16: The Siebel Data Model

b. What is the Foreign Key Table for the AGREE_ID column? For assistance, use Columns
Displayed or the Properties window. Enter your answer into the table header on the right-
hand side of the diagram.

S_SRV_REQ
ROW_ID

AGREE_ID

ROW_ID

FK PK

c. Query the Foreign Key Table property for S_PROD_INT. What column(s) serve(s) as a
foreign key to S_PROD_INT? Enter your answer into the table on the left-hand side of the
diagram. Draw line(s) between the tables to indicate FK/PK relationship(s).

S_SRV_REQ S_PROD_INT
ROW_ID

ROW_ID

7. In this step, you will examine a 1:1 extension table to see how it relates to its base table. Base
tables and extension tables maintain a primary key / foreign key relationship. Extension tables
have a foreign key that references the primary key of its base table. PAR_ROW_ID reads as
“parent row ID”.
a. Select Table :: S_SRV_REQ_X.
b. View the Type property. What is the type of the table?

174 Siebel 8.0 Essentials


Module 16: The Siebel Data Model

c. What is the Base Table to S_SRV_REQ_X?

d. What is the value of the foreign key Column Name for the foreign key to S_SRV_REQ in the
S_SRV_REQ_X extension table?

e. Select Table :: S_SRV_REQ_X | Column :: PAR_ROW_ID.


f. Enter the column name into the table on the right-hand side of the diagram, above.
g. Draw a line between the tables to indicate the FK/PK relationship.

8. In this step, you will identify any pre-built intersection tables that support the M:M relationship
between project and contacts. The query below works by selecting tables with foreign keys for
either S_PROJ or S_CONTACT.
a. Select the Flat tab and then select Column in the Object Explorer (OE).
b. Use Columns Displayed in the OBLE to move the Parent Table, Name, Foreign Key Table,
and User Key Sequence columns to the left side of the OBLE.
c. Execute a compound query with the following values:
Property Value
User Key Sequence 1 OR 2
Foreign Key Table S_PROJ OR S_CONTACT
d. Sort the results of the query in ascending order for both the Parent Table list column and the
User Key Sequence list column.
i. Right-click in the OBLE and select Sort Order.
ii. In the Sort Order dialog box select the Sort by field.
iii. Select Parent Table from the drop-down list.
iv. In the Then by field click the drop-down arrow and select User Key Sequence.
v. Accept the default Ascending for both fields.
vi. Click OK.
e. Look for a Parent Table that appears in two adjacent rows where the Foreign Key Table
property is S_PROJ in one row and S_CONTACT in the other row. Note that the parent table
name has a _CON suffix. Which table satisfies these criteria?

Siebel 8.0 Essentials 175


Module 16: The Siebel Data Model

f. Complete the diagram, below.


i. Enter the names of the two data tables that have a M:M relationship.
ii. Enter the name of the intersection table.
iii. Enter the names of the two FK columns in the intersection table.
Intersection
Data Table Table Data Table
S_PROJ S_CONTACT
ROW_ID

ROW_ID
ROW_ID
PK PK

FK FK

g. Select the Types tab to restore the Object Explorer to the hierarchical display mode.

176 Siebel 8.0 Essentials


Module 16: The Siebel Data Model

Solutions 16-1 Exploring the Data Model (Guided)

Answers:
1.
Job Aid: Identify Table Column That Supplies Data for an Applet Control
Layer Object You’re
Step Tip for Finding Information Enter Value Here
looking For

Look for text label


User Opportunity Name
• List applet: column heading above
Interface 1 Display Name field in question
Objects • Form applet: control label next to
field

  2 Applet Name In UI: Help > About View


Opportunity List
Applet
Business
3 In UI: Help > About View
Business Component Opportunity
Objects
a. In Tools: <applet name> | List :: List |
Name
List Column.
Business
4 Component b. Query Display Name for <display
Field name>.

c. Value you need is the Field property.

In Tools: Business Component :: <BC


name>| Field :: <field name> S_OPTY
IF Join property is empty
Enter base table name
Data 5 Table Name ELSE
Objects Enter value in Join property

Note: if query fails, Field property is


calculated. Try this: query Calculated
Value for *<field name>*

In Tools: Business Component :: <BC


Table Column NAME
6 name>| Field :: <field name>. Value in
Name
Column property.

Siebel 8.0 Essentials 177


Module 16: The Siebel Data Model

2.

3.b.ii. Scroll to the Type property and note that the Name property remains in place. What two
column types are included in this table?
Data(Public) and System

3.c.iv. Of these system columns, which one is the primary key for this table? For assistance, view
the Primary Key property.
ROW_ID.

3.d. Query the Required property for True (checked). Is MODIFICATION_NUM a required
column?
Yes

3.f. What column in S_SRV_REQ has a Physical Type of Data Time?


POST_MORTEM_RVW_DT.

4.a.v. When querying for S_OPTY, ensure you query the Name property, not the Base Table
property. Which user keys are defined?
S_OPTY_II, S_OPTY_U1.

178 Siebel 8.0 Essentials


Module 16: The Siebel Data Model

4.b. Select Table :: S_OPTY | User Key :: S_OPTY _U1 | User Key Column. Identify which
columns make up this user key. Enter your answer directly into the diagram, below.
S_OPTY

BU_ID

NAME
ROW_ID

PR_DEPT_OU_ID

S_OPTY _U1
User Key

4.g. Create another new record with exactly the same values. Save it. What happens? Why?
The new record cannot be saved because a record with the same name, account, and
organization already exists. BU_ID stores a unique value to identify the business unit, in
this case, Bay Builders under Account. NAME stores Opportunity Name, in this case, A Big
Deal. PR_DEPT_OU_ID stores a unique value for the Organization. When an attempt is
made to save the record, a check is made against the S_OPTY _U1 user key. If all three
fields are identical, that is, the user key matches, the save is disallowed.

5.a. In Siebel Tools, select Table :: S_OPTY | Index to display the indexes for the table. How
many indices are defined for the S_OPTY table?
More than 10

5.b. Select Table :: S_OPTY | Index :: S_OPTY_P1 | Index Column. Which column(s) make up
this index?
ROW_ID.

5.c. Which column(s) make up the S_OPTY_U1 index?


BU_ID, CONFLICT_ID, NAME, PR_DEPT_OU_ID.

6.b. What is the Foreign Key Table for the AGREE_ID column? For assistance, use Columns
Displayed or the Properties window. Enter your answer into the table header on the right-
hand side of the diagram.
S_SRV_REQ S_ENTLMNT
ROW_ID

AGREE_ID

ROW_ID

FK PK

Siebel 8.0 Essentials 179


Module 16: The Siebel Data Model

6.c. Query the Foreign Key Table property for S_PROD_INT. What column(s) serve(s) as a
foreign key to S_PROD_INT? Enter your answer into the table on the left-hand side of the
diagram. Draw line(s) between the tables to indicate FK/PK relationship(s).
S_SRV_REQ S_PROD_INT

PRDINT_ID
ROW_ID

ROW_ID

FK PK

7.b. View the Type property. What is the type of the table?
Extension.

7.c. What is the Base Table to S_SRV_REQ_X?


S_SRV_REQ.

7.d. What is the value of the foreign key Column Name for the foreign key to S_SRV_REQ in
the S_SRV_REQ_X extension table?
PAR_ROW_ID.

7.g. Draw a line between the tables to indicate the FK/PK relationship.
(see diagram, above).

8.e. Look for a Parent Table that appears in two adjacent rows where the Foreign Key Table
property is S_PROJ in one row and S_CONTACT in the other row. Note that the parent
table name has a _CON suffix. Which table satisfies these criteria?
S_PROJ_CON.

8.f. Complete the diagram, below.


Intersection
Data Table Table Data Table
S_PROJ S_CONTACT
ROW_ID
ROW_ID

S_PROJ_CON
PROJ_ID
ROW_ID

CON_ID

PK PK

FK FK

180 Siebel 8.0 Essentials


Module 17: Siebel Business Components

Lab 17-1 Examining References Between Applets,


Business Components, and Tables (Unguided)

Goal To describe the key relationships between business components, fields, columns, and
tables in the Siebel Application Architecture.

Time 15 - 20 minutes

Instructions:
In this lab, you will use the same method used in previous labs to identify all the major objects
involved in getting data from the data layer to the UI layer. This lab focuses on the business
component. You will navigate both the application and Tools in order to document the architectural
relationships for a business component called Internal Product.

1. Identify the table column name that provides data for the Product column in the Internal Product
List applet by filling out the job aid, below.
a. If necessary, open Siebel Call Center using the Siebel Developer Web Client and log in as
SADMIN/SADMIN connecting to the Sample database.
b. Navigate to Products > Internal Product List. Notice the Product column in the list applet.
c. Enter the display name, applet name, and business component name into the job aid, below.
d. If necessary, start Siebel Tools and log in as SADMIN/SADMIN connecting to the Sample
database.
e. Enter the business component field, table name, and table column into the job aid, below.

Siebel 8.0 Essentials 181


Module 17: Siebel Business Components

Job Aid: Identify Table Column Supplying Data for Applet Control
Layer Object You’re
Step Tip for Finding Information Enter Value Here
looking For

Look for text label


• List applet: column heading above
User 1 Display Name field in question
Interface • Form applet: control label next to
Objects field
 

2 Applet Name In UI: Help > About View

Business
3 In UI: Help > About View
Component
Business
Objects
a. In Tools: <applet name> | List :: List
| List Column.
Business
b. Query Display Name for <display
4 Component
name>.
Field
c. Value you need is the Field
property.

In Tools: Business Component :: <BC


name>| Field :: <field name>
IF Join property is empty
Enter base table name
Table Name
Data 5 ELSE
Objects Enter value in Join property

Note: if query fails, Field property is


calculated. Try this: query Calculated
Value for *<field name>*

In Tools: Business Component :: <BC


Table Column
6 name>| Field :: <field name>. Value in
Name
Column property.

182 Siebel 8.0 Essentials


Module 17: Siebel Business Components

2. Use Tools’ visualization feature to verify some of the mappings between business components
and tables you just identified. This feature provides a way to view relationships between entities
graphically, similar to the way entities are represented in an Entity Relationship Diagram (ERD).
a. Select Business Component :: Internal Product.
b. From the Tools application-level menu bar, select View > Visualize > View Details. Scroll
down slowly, then select the Name field in the left column. What table and column does it
reference?

c. What columns do the Part # and Unit of Measure fields reference?

d. Close the visualization window.

Siebel 8.0 Essentials 183


Module 17: Siebel Business Components

Solutions 17-1 Examining References Between Applets,


Business Components, and Tables (Unguided)

Answers:
1. Job Aid: Identify Table Column Supplying Data for Applet Control

Layer Object You’re


Step Tip for Finding Information Enter Value Here
looking For

Look for the text label:


Product
User • In a list applet, column heading
Interface 1 Display Name above the field in question
Objects • In a form applet, control label next

 
to the field

2 Applet In UI: Help > About View


Product List Applet

Business
3 In UI: Help > About View
Component Internal Product
Business
Objects a. In Tools: <applet name> | List :: List |
List Column. Name
b. Query Display Name for <display
4 Field
name> (from step 1).

Value you need is the Field property.

In Tools: Business Component :: <BC


name>| Field :: <field name> S_PROD_INT
IF Join property is empty
Enter base table name
Data 5 Table ELSE
Objects Enter value in Join property

Note: if query for field fails, Field


property is calculated. Try this: query
Calculated Value for *<field name>*

In Tools: Business Component :: <BC


6 Table Column name>| Field :: <field name>. Value in NAME
Column property.

2.b. From the Tools application-level menu bar, select View > Visualize > View Details. Scroll
down slowly, then select the Name field in the left column. What table and column does it
reference?
S_PROD_INT table, NAME column

184 Siebel 8.0 Essentials


Module 17: Siebel Business Components

2.c. What columns do the Part # and Unit of Measure fields reference?
PART_NUM and UOM_CD columns

Siebel 8.0 Essentials 185


Module 17: Siebel Business Components

186 Siebel 8.0 Essentials


Module 17: Siebel Business Components

Lab 17-1 Examining References Between Applets,


Business Components, and Tables (Guided)

Goal To describe the key relationships between business components, fields, columns, and
tables in the Siebel Application Architecture.

Time 15 - 20 minutes

Instructions:
In this lab, you will use the same method used in previous labs to identify all the major objects
involved in getting data from the data layer to the UI layer. This lab focuses on the business
component. You will navigate both the application and Tools in order to document the architectural
relationships for a business component called Internal Product.

1. In this step, you will identify the table column name that provides data for the Product column in
the Internal Product List applet. As you complete each step, use the instructions under the Tip for
Finding Information column of the job aid, below.
a. If necessary, open Siebel Call Center using the Siebel Developer Client and log in as
SADMIN/SADMIN connecting to the Sample database.
b. Navigate to Products > Internal Product List. Notice the Product column in the list applet.
c. Enter the Display Name in the job aid, below.
d. Select Help > About View.
e. Enter the Applet Name into the job aid, below.
f. Enter the Business Component Name into the job aid, below.
g. If necessary, start Siebel Tools and log in as SADMIN/SADMIN connecting to the Sample
database.
h. Using the UI Display Name that you identified earlier, enter the business component field
that the user interface references and enter the value of the Field property for this object
definition into the job aid, below.
i. Identify the Table Name for the data source then enter it into the job aid.
j. The value in the Column property in Tools is the table column referenced by the business
component. Enter this value into the job aid, below.

Siebel 8.0 Essentials 187


Module 17: Siebel Business Components

Job Aid: Identify Table Column Supplying Data for Applet Control
Layer Object You’re
Step Tip for Finding Information Enter Value Here
looking For

Look for text label


• List applet: column heading above
User 1 Display Name field in question
Interface • Form applet: control label next to
Objects field
 

2 Applet Name In UI: Help > About View

Business
3 In UI: Help > About View
Component
Business
Objects
d. In Tools: <applet name> | List :: List
| List Column.
Business
e. Query Display Name for <display
4 Component
name>.
Field
f. Value you need is the Field
property.

In Tools: Business Component :: <BC


name>| Field :: <field name>
IF Join property is empty
Enter base table name
Table Name
Data 5 ELSE
Objects Enter value in Join property

Note: if query fails, Field property is


calculated. Try this: query Calculated
Value for *<field name>*

In Tools: Business Component :: <BC


Table Column
6 name>| Field :: <field name>. Value in
Name
Column property.

188 Siebel 8.0 Essentials


Module 17: Siebel Business Components

2. In this step, you will use Tools’ visualization feature to verify some of the mappings between
business components and tables you just identified. This feature provides a way to view
relationships between entities graphically, similar to the way entities are represented in an Entity
Relationship Diagram (ERD).
a. Select Business Component :: Internal Product.
i. From the Tools application-level menu bar, select View > Visualize > View Details.
Scroll down slowly, then select the Name field in the left column. What table and
column does it reference?

ii. What columns do the Part # and Unit of Measure fields reference?

iii. Close the visualization window.


iv. If the Properties Window is open, close it now. To dock or close the Properties
Window, right-click in the properties window and select either Docked or Hide.
v. In Call Center, close About View.

Siebel 8.0 Essentials 189


Module 17: Siebel Business Components

Solutions 17-1 Examining References Between Applets,


Business Components, and Tables (Guided)

Answers:
1. Job Aid: Identify Table Column Supplying Data for Applet Control

Layer Object You’re


Step Tip for Finding Information Enter Value Here
looking For

Look for the text label:


User Product
• In a list applet, column heading
Interface 1 Display Name above the field in question
Objects • In a form applet, control label next

 
to the field

2 Applet In UI: Help > About View


Product List Applet

Business
3 In UI: Help > About View
Component Internal Product
Business
Objects a. In Tools: <applet name> | List :: List |
List Column. Name
b. Query Display Name for <display
4 Field
name> (from step 1).

Value you need is the Field property.

In Tools: Business Component :: <BC


name>| Field :: <field name> S_PROD_INT
IF Join property is empty
Enter base table name
Data 5 Table ELSE
Objects Enter value in Join property

Note: if query for field fails, Field


property is calculated. Try this: query
Calculated Value for *<field name>*

In Tools: Business Component :: <BC


6 Table Column name>| Field :: <field name>. Value in NAME
Column property.

2.a.i. From the Tools application-level menu bar, select View > Visualize > View Details. Scroll
down slowly, then select the Name field in the left column. What table and column does it
reference?
S_PROD_INT table, NAME column

190 Siebel 8.0 Essentials


Module 17: Siebel Business Components

2.a.ii. What columns do the Part # and Unit of Measure fields reference?
PART_NUM and UOM_CD columns

Siebel 8.0 Essentials 191


Module 17: Siebel Business Components

192 Siebel 8.0 Essentials


Module 18: Siebel Party Business Components

Lab 18-1 Exploring Relationships Between Party


Business Components and Tables (Unguided)

Goal To examine how person-related and organization-related business components store their
fields in S_PARTY and related tables.

Time 15 - 20 minutes

Instructions:
Due to the question-and-answer nature of this lab, there is no Unguided version of it. Please turn the
page and do the Guided version.

Siebel 8.0 Essentials 193


Module 18: Siebel Party Business Components

194 Siebel 8.0 Essentials


Module 18: Siebel Party Business Components

Lab 18-1 Exploring Relationships Between Party


Business Components and Tables (Guided)

Goal To examine how person-related and organization-related business components store their
fields in S_PARTY and related tables.

Time 15 - 20 minutes

Instructions:
At the beginning of this lab, you will examine two person-related party business components to
determine which tables they use to store their main data. You will examine this general structure:
Person-Related Party Business Component

Field X Field X Field X Field X

S_PARTY S_CONTACT S_USER S_EMP_PER


ROW_ID

PAR_ROW_ID

PAR_ROW_ID

PAR_ROW_ID

PK FK FK FK
Base Table Extension Tables – Record Data Stored Here

You will see how multiple party business components reference the same column in the same base
table. You will also see that extension tables contain most of the data needed by the party business
component. Since business component fields reference extension table fields directly, you may not
see S_PARTY in object definitions or properties. Rather, you will see the S_PARTY extension
table.

1. In this step, you will explore how a person-related party business component called Contact
references its extension tables. If necessary, start Siebel Tools and log in as SADMIN
connecting to the Sample database.
a. Select Business Component :: Contact.
b. Select View > Visualize > View Details. Scroll down slowly until you find First Name in the
left column and select it. What table and column does it reference?

Siebel 8.0 Essentials 195


Module 18: Siebel Party Business Components

c. About how many fields in the Contact party business component reference columns in the
S_CONTACT table? Pick one choice from the following three options.
Zero
One to ten
Greater than ten
d. Scroll down slowly until you find the S_EMP_PER table in the right column. Are there any
fields in the Contact business component that reference columns in the S_EMP_PER table?
If yes, list them.

e. Scroll down slowly until you find the S_USER table in the right column. Are there any fields
in the Contact business component that reference columns in the S_USER table? If yes, list
them.

f. Close the visualization window.

2. In this step, you will explore how a person-related party business component called Employee
references its extension tables. Note that both this party business component, Employee, and
Contact, the party business component you studied in the previous step, have S_PARTY as their
base table and, in many cases, reference the same extension table for their data.
a. Select Business Component :: Employee.
b. Select View > Visualize > View Details. Scroll down slowly until you find First Name in the
left column and select it. What table and column does it reference?

c. How many fields in the Employee business component reference columns in the
S_CONTACT table? Pick one choice from the following three options.
Zero
One to ten
Greater than ten
d. Scroll down slowly until you find the S_EMP_PER table in the right column. Are there any
fields in Employee that reference columns in the S_EMP_PER table?

e. Scroll down slowly until you find the S_USER table in the right column. Are there any fields
in Employee that reference columns in the S_USER table?

196 Siebel 8.0 Essentials


Module 18: Siebel Party Business Components

3. In this step, you will observe how some organization-related party business components use the
S_ORG_EXT table. As with person-related party BCs, here you will observe that organization-
related party BCs also reference the same column in the same extension tables to gather their
data, and that the extension tables contain most of the data. Use the Visualize technique you
followed in the previous steps to answer the questions, below. You will examine this general
structure:
Organization-Related Party Business Component

Field X Field X

S_PARTY S_ORG_EXT
ROW_ID

PAR_ROW_ID

PK FK
Base Table Extension Tables

a. Does the Organization party business component use the INT_ORG_FLG column in the
S_ORG_EXT table?

b. Does the Organization party business component use the NAME and LOC columns in the
S_ORG_EXT table?

c. Does the Account party business component use the INT_ORG_FLG column in the
S_ORG_EXT table?

d. Does the Account party business component use the NAME and LOC columns in the
S_ORG_EXT table?

4. In this step, you will examine how party business components reference S_PARTY.
a. Select Business Component :: Account. What is the base Table for the Account business
component?

Siebel 8.0 Essentials 197


Module 18: Siebel Party Business Components

b. Use the visualization tool to examine references from the Account fields to tables and
columns. About how many columns in the S_PARTY table are referenced?

Less than five


More than five

c. Consider the Party Type Code field in the Account business component. What column in
S_PARTY does it reference?

d. Which field references ROW_ID in S_PARTY? Note that Id is a predefined field for every
business component. It serves as the primary key field. Since it is predefined you will not
find it in the single value field object definitions for a business component, but you will be
able to refer to it and use it during configuration.

e. Verify that the Contact and Organization party business components also use S_PARTY as
their base table. Do they use roughly the same S_PARTY columns as the Account business
component?

5. In this step, you will inspect single value field object definitions to determine the referenced
columns.
a. Select Business Component :: Account | Single Value Field :: Party Name. What is the value
of the Column property?

i. Which table contains this column?

b. Select Business Component :: Account | Single Value Field :: Location. What is the value of
the Column property? What is the value of the Join property?

198 Siebel 8.0 Essentials


Module 18: Siebel Party Business Components

6. In this step, you will examine how the S_CONTACT and S_CONTACT_X tables are related to
the S_PARTY table. Note that, since multiple business components may reference the same base
table, it is critical that you be able to distinguish between how business components reference
tables, and the various extension tables that are referenced.
a. Select Table :: S_CONTACT. What is the type of the table?

b. What base table does this party table reference?

c. Select Table :: S_CONTACT_X. This is the standard 1:1 extension table for the
S_CONTACT table. What base table does this party extension table reference?

d. Determine which S_CONTACT_X column is the FK to S_PARTY.


i. Select Table :: S_CONTACT_X | Column.
ii. Query the Foreign Key Table property for S_PARTY. Which S_CONTACT_X
column is the FK to S_PARTY?

7. Leave Tools open.

Siebel 8.0 Essentials 199


Module 18: Siebel Party Business Components

Solutions 18-1 Exploring Relationships Between Party


Business Components and Tables (Guided)

Answers:
1.b. Select View > Visualize > View Details. Scroll down slowly until you find First Name in
the left column and select it. What table and column does it reference?
The FST_NAME column in the S_CONTACT table

1.c. About how many fields in the Contact party business component reference columns in the
S_CONTACT table? Pick one choice from the following three options.
Greater than ten

1.d. Scroll down slowly until you find the S_EMP_PER table in the right column. Are there any
fields in the Contact business component that reference columns in the S_EMP_PER table?
If yes, list them.
Yes: Work Phone Extension and Share Home Phone Flag

1.e. Scroll down slowly until you find the S_USER table in the right column. Are there any
fields in the Contact business component that reference columns in the S_USER table? If
yes, list them.
Yes: Challenge Answer, Challenge Question, and Login Name

2.b. Select View > Visualize > View Details. Scroll down slowly until you find First Name in
the left column and select it. What table and column does it reference?
The FST_NAME column in the S_CONTACT table.

2.c. How many fields in the Employee business component reference columns in the
S_CONTACT table? Pick one choice from the following three options.
Greater than ten

2.d. Scroll down slowly until you find the S_EMP_PER table in the right column. Are there any
fields in the Contact business component that reference columns in the S_EMP_PER table?
If yes, list them.
Yes, there are many fields (>10).

2.e. Scroll down slowly until you find the S_USER table in the right column. Are there any
fields in the Contact business component that reference columns in the S_USER table? If
yes, list them.
Yes, there are several fields.

3.a. Does the Organization party business component use the INT_ORG_FLG column in the
S_ORG_EXT table?
Yes

200 Siebel 8.0 Essentials


Module 18: Siebel Party Business Components

3.b. Does the Organization party business component use the NAME and LOC columns in the
S_ORG_EXT table?
It uses both NAME and LOC.

3.c. Does the Account party business component use the INT_ORG_FLG column in the
S_ORG_EXT table?
Yes

3.d. Does the Account party business component use the NAME and LOC columns in the
S_ORG_EXT table?
It uses both NAME and LOC.

4.a. Select Business Component :: Account. What is the base Table for the Account business
component?
S_PARTY

4.b. Use the visualization tool to examine references from the Account fields to tables and
columns. About how many columns in the S_PARTY table are referenced?
More than five

4.c. Consider the Party Type Code field in the Account business component. What column in
S_PARTY does it reference?
PARTY_TYPE_CD

4.d. Which field references ROW_ID in S_PARTY? Note that Id is a predefined field for every
business component. It serves as the primary key field. Since it is predefined you will not
find it in the single value field object definitions for a business component, but you will be
able to refer to it and use it during configuration.

Id

4.e. Verify that the Contact and Organization party business components also use S_PARTY as
their base table. Do they use roughly the same S_PARTY columns as the Account business
component?
Yes, they do.

5.a. Select Business Component :: Account | Single Value Field :: Party Name. What is the
value of the Column property?
NAME

5.a.i. Which table contains this column


S_PARTY

5.b. Select Business Component :: Account | Single Value Field :: Location. What is the value
of the Column property?
LOC

5.b. What is the value of the Join property?


S_ORG_EXT

Siebel 8.0 Essentials 201


Module 18: Siebel Party Business Components

6.a. Select Table :: S_CONTACT. What is the type of the table?


Extension (Siebel)

6.b. What base table does this party table reference?


S_PARTY

6.c. Select Table :: S_CONTACT_X. This is the standard 1:1 extension table for the
S_CONTACT table. What base table does this party extension table reference?
S_PARTY

6.d.ii. Query the Foreign Key Table property for S_PARTY. Which S_CONTACT_X column is
the FK to S_PARTY?
PAR_ROW_ID

202 Siebel 8.0 Essentials


Module 18: Siebel Party Business Components

Lab 18-2 Identifying Objects When Using a Party


Business Component (Unguided)

Goal To examine how the elements of a party business component are represented in the
application architecture.

Time 10 - 15 minutes

Instructions:
In this lab, you will identify the major objects involved in getting data from the data layer to the UI
layer for a standard business component that uses an explicit join to pull data from a party extension
table.

1. If necessary, open Siebel Call Center using the Siebel Web Client and log in as
SADMIN/SADMIN.

2. Navigate to Assets > List and use Columns Displayed to display the Account column in the list
applet. Enter the display name, applet name, and business component name for account data into
the job aid, below.

3. Verify that an applet references only one business component.


a. In Tools, select Applet :: <applet name from previous step>
b. Compare the business component property for this applet against what you entered into the
job aid, below.

4. Identify whether the business component is standard or party by examining its base table.

5. Identify the field that the display name references and enter the value into the job aid.

6. Identify the table name and enter the value into the job aid.

7. Verify that this table is an S_PARTY extension table by examining the base table property of
Table :: S_ORG_EXT.

Siebel 8.0 Essentials 203


Module 18: Siebel Party Business Components

Job Aid: Identifying Objects When Using a Party Business Component


Layer Part You’re Source Where Information About The
Step Enter Value Here
looking For Object Can Be Found
Look for the text label:
User • In a list applet, column heading above
Interface Display the field in question
1
Objects Name • In a form applet, control label next to
the field

  2 Applet Name
In UI: Help > About View

Business In UI: Help > About View


3
Component
In Tools: Applet <applet name>. Drill down
on BC property. Party
Business
IF BC’s base table (table property) is
Business Component Standard
4 S_PARTY
Objects Type
It’s a party BC
ELSE
It’s a standard BC

a. In Tools: <applet name> | List :: List | List


Column.
b. Query Display Name for <display name>
5 Field (from step 1).

Value you need is the Field property.

Data a. In Tools: Business Component :: <BC


Objects name> | Field :: <field name>.
6 Table b. Enter value under Join property

204 Siebel 8.0 Essentials


Module 18: Siebel Party Business Components

Solutions 18-2 Identifying Objects When Using a Party


Business Component (Unguided)

Answers:
Job Aid: Identifying the Parts of a Party Business Component
Layer Part You’re Source Where Information About The
Step Enter Value Here
looking For Object Can Be Found
Look for the text label:
• In a list applet, column heading above
User Account
Display the field in question
Interface 1
Name • In a form applet, control label next to
Objects the field

  2 Applet Name
In UI: Help > About View
Asset Mgmt - Asset List
Applet
Business In UI: Help > About View
3
Component Asset Mgmt – Asset
In Tools: Applet <applet name>. Drill down
on BC property. Party


Business
IF BC’s base table (table property) is
Business Component Standard
4 S_PARTY
Objects Type
It’s a party BC
ELSE
It’s a standard BC

a. In Tools: <applet name> | List :: List | List


Column.
b. Query Display Name for <display name> Account Name
5 Field (from step 1).

Value you need is the Field property.

Data a. In Tools: Business Component :: <BC


Objects name> | Field :: <field name>.
b. Enter value under Join property S_ORG_EXT
6 Table

Siebel 8.0 Essentials 205


Module 18: Siebel Party Business Components

206 Siebel 8.0 Essentials


Module 18: Siebel Party Business Components

Lab 18-2 Identifying Objects When Using a Party


Business Component (Guided)

Goal To examine how the elements of a party business component are represented in the
application architecture.

Time 10 - 15 minutes

Instructions:
In this lab, you will identify the major objects involved in getting data from the data layer to the UI
layer for a standard business component that uses an explicit join to pull data from a party extension
table.

1. If necessary, open Siebel Call Center using the Siebel Web Client and log in as
SADMIN/SADMIN.
a. Navigate to Assets > List.
b. Display the Account column for the list applet.
i. From the application-level menu, select View > Columns Displayed. As a shortcut, right-
click then select Columns Displayed, or press CTRL+SHIFT+K.
ii. Use the shuttle applet to move Account from Available Columns to Selected Columns.
iii. Use the up arrow to move Account to the top of the list.
iv. Click Save.
c. Enter the Display Name for account data into the job aid, below.

2. Identify the Applet Name and business component.


a. Select Help > About View.
b. Enter the applet name into the job aid, below.
c. Enter the business component name into the job aid, below.

3. Verify that the applet references only one business component.


a. In Tools, select Applet :: <applet name from previous step>
b. Compare the business component property for this applet against what you entered into the
job aid.

4. Identify whether the business component is standard or party.

Siebel 8.0 Essentials 207


Module 18: Siebel Party Business Components

5. Identify the field name that the display name references.


a. In Tools, select Applet :: <applet name> | List :: List | List Column.
b. Select the List Column object definition whose Display Name property is Account. Enter the
value of the Field property for this record into the job aid.

6. Identify the Table Name for the data source. Select Business Component :: <business component
name>| Field :: <field name, from previous step>. You can also access this business component
by drilling down on the applets business component property in the OBLE.
a. Enter the value under the join property into the job aid. If this value is empty, the data source
is from the base table. Otherwise, it is from a join table. Since we know this is a standard BC
referencing data from a party BC, we know a join is involved.
b. Verify this table is an S_PARTY extension table. Select Table :: S_ORG_EXT. If the value
of the Base Table Name property is S_PARTY, it is an S_PARTY extension table. Note that
most of the data resides in the extension table, not the base table. Thus, the extension table is
the source of the data.
Job Aid: Identifying Objects When Using a Party Business Component
Layer Part You’re Source Where Information About The
Step Enter Value Here
looking For Object Can Be Found
Look for the text label:
User • In a list applet, column heading above
Interface Display the field in question
1
Objects Name • In a form applet, control label next to
the field

  2 Applet Name
In UI: Help > About View

Business In UI: Help > About View


3
Component
In Tools: Applet <applet name>. Drill down
on BC property. Party
Business
IF BC’s base table (table property) is
Business Component Standard
4 S_PARTY
Objects Type
It’s a party BC
ELSE
It’s a standard BC

a. In Tools: <applet name> | List :: List | List


Column.
b. Query Display Name for <display name>
5 Field (from step 1).

Value you need is the Field property.

Data a. In Tools: Business Component :: <BC


Objects name> | Field :: <field name>.
6 Table b. Enter value under Join property

208 Siebel 8.0 Essentials


Module 18: Siebel Party Business Components

Solutions 18-2 Identifying Objects When Using a Party


Business Component (Guided)

Answers:
6.b.
Job Aid: Identifying the Parts of a Party Business Component
Layer Part You’re Source Where Information About The
Step Enter Value Here
looking For Object Can Be Found
Look for the text label:
• In a list applet, column heading above
User Account
Display the field in question
Interface 1
Name • In a form applet, control label next to
Objects the field

  2 Applet Name
In UI: Help > About View
Asset Mgmt - Asset List
Applet
Business In UI: Help > About View
3
Component Asset Mgmt – Asset
In Tools: Applet <applet name>. Drill down
on BC property. Party


Business
IF BC’s base table (table property) is
Business Component Standard
4 S_PARTY
Objects Type
It’s a party BC
ELSE
It’s a standard BC

a. In Tools: <applet name> | List :: List | List


Column.
b. Query Display Name for <display name> Account Name
5 Field (from step 1).

Value you need is the Field property.

Data a. In Tools: Business Component :: <BC


Objects name> | Field :: <field name>.
b. Enter value under Join property S_ORG_EXT
6 Table

Siebel 8.0 Essentials 209


Module 18: Siebel Party Business Components

210 Siebel 8.0 Essentials


Module 19: Siebel Business Objects

Lab 19-1 Examining Relationships between Views,


Business Objects, Business Components, and Tables
(Unguided)

Goal To explore Business Object and Link definitions in Siebel Tools.

Time 25 - 30 minutes

Instructions:
Recall that business objects are used to focus data presented in views depending on the context in
which the data is accessed, and that any given view references one, and only one business object.
Business objects also organize business components into a major business area, such as Accounts,
Opportunities, Contacts and Actions. In this lab, you will examine how business objects relate to
other objects in the Siebel repository.

1. Examine references for the Opportunities business object. Views reference a single business
object and business objects reference multiple business components.
a. Open Siebel Call Center using the Siebel Call Center Developer Web Client and log in as
SADMIN/SADMIN to the Sample database.
b. Drill down on any opportunity from the opportunities list applet.

Siebel 8.0 Essentials 211


Module 19: Siebel Business Objects

c. Enter the name of the view, the name of the business object, and the names of the two
business components into this diagram:

d. In Siebel Tools, navigate to the view object definition you found above and confirm that its
business object property matches the one you found above.
e. Navigate to the business object object definition you found above and confirm that the
business component you found above is one of the business object’s business object
components.

212 Siebel 8.0 Essentials


Module 19: Siebel Business Objects

2. Identify references between fields and business components for a 1:M link referenced by the
Opportunity business object where many opportunity records may be associated with a single
revenue record. Enter your answers directly into this diagram:
a. Select Business Object :: Opportunity | Business Object Component :: Revenue.
b. Drill down on the link property to identify the parent and child business components. Add the
link, parent BC, and child BC to the diagram above.
c. Enter the name of the base table for the parent into the diagram.
d. Enter the name of the base table for the child into the diagram.
e. Use the properties of the link to identify the primary and foreign key references; that is, the
source field of the parent BC and the destination field of the child BC.
f. Identify the column name in the child base table that holds the foreign key.

Siebel 8.0 Essentials 213


Module 19: Siebel Business Objects

3. Identify references between fields and business components for a M:M link used by the
Opportunity business object where there could be multiple opportunity records that have
relationships with multiple contact records. Enter your responses directly into the diagram
below:
a. Select Business Object :: Opportunity | Business Object Component :: Contact.
b. Enter the business object name into the diagram.
c. Enter the link name into the diagram.
d. Inspect the Link definition to verify the relationship between opportunities and contacts is
M:M and enter the value of the Inter Table property into the top of the intersection table in
the diagram.
e. Identify the parent and child business components and their base tables and enter them into
the diagram
f. Identify the primary key / foreign key mappings and enter them into the diagram. Note that
the Inter Parent Column property holds the value for the intersection table FK column that
maps to the parent base table while the Inter Child Column property holds the value for the
intersection table FK column that maps to the child base table.

4. Exit Siebel Tools and log out of Siebel Call Center.

214 Siebel 8.0 Essentials


Module 19: Siebel Business Objects

Solutions 19-1 Examining Relationships between Views,


Business Objects, Business Components, and Tables
(Unguided)

Answers:
1.c.

Siebel 8.0 Essentials 215


Module 19: Siebel Business Objects

2.

3.

216 Siebel 8.0 Essentials


Module 19: Siebel Business Objects

Lab 19-1 Examining Relationships between Views,


Business Objects, Business Components, and Tables
(Guided)

Goal To explore Business Object and Link definitions in Siebel Tools.

Time 25 - 30 minutes

Instructions:
Recall that business objects are used to focus data presented in views depending on the context in
which the data is accessed, and that any given view references one, and only one business object.
Business objects also organize business components into a major business area, such as Accounts,
Opportunities, Contacts and Actions. In this lab, you will examine how business objects relate to
other objects in the Siebel repository.

1. In this step, you will examine references for the Opportunities business object. Views reference a
single business object and business objects reference multiple business components.
a. Open Siebel Call Center using the Siebel Call Center Developer Web Client and log in as
SADMIN/SADMIN to the Sample database.
b. Navigate to Opportunities > List. If no records appear in the list, execute a blank query to
populate the list.
c. Drill down on any opportunity from the list applet.

Siebel 8.0 Essentials 217


Module 19: Siebel Business Objects

d. Select Help > About View. Enter the name of the view, the name of the business object, and
the names of the two business components into this diagram:

e. If necessary, start Siebel Tools and log in as SADMIN connecting to the Sample database.
f. Select View:: Opportunity Detail - Contacts View. Check the value you entered into the
diagram for View. It should match the value of the Business Object property in Tools.
g. Explore the relationship between business objects and business components.
i. Select Business Object :: Opportunity | Business Object Component. The Bus Comp
property displays all business components used for this business object. Peruse the
list.
ii. Now execute a null query in the Name property of the OBLE upper window. The
query should return a list of all business objects in the repository.
iii. With the cursor positioned in the Name property, use the down arrow to slowly scroll
through 15 or 20 business objects. As you scroll, observe changes in the OBLE’s
lower window.
iv. What can you infer about the relationship between business objects and business
components?
A given business object references one or more business components
A given business object only references one business component

218 Siebel 8.0 Essentials


Module 19: Siebel Business Objects

2. In this step, you will identify references between fields and business components for a 1:M link
referenced by the Opportunity business object where many opportunity records may be
associated with a single revenue record. Enter your answers directly into this diagram:

a. Identify the parent and child business components and their base tables.
i. Select Business Object :: Opportunity | Business Object Component :: Revenue.
ii. Drill down on the Link property.
iii. Enter the names of the business object, the parent business component, the child
business component, and the link into the diagram.
iv. Drill down on the Parent Business Component property.
v. Enter the name of the base table for the parent into the diagram.
vi. Click the back arrow.
vii. Drill down on the Child Business Component property.
viii. Enter the name of the base table for the child into the diagram.
b. Identify the primary key references.
i. Navigate back to the object definition for the Opportunity/Revenue link.
ii. View the values in the Properties window.
iii. In the structure diagram, enter the value that maps the Source Field to the parent base
table. Note that the Source Field property defaults to the primary key ROW_ID for
the parent base table. This appears as Id in the Source Field property.
c. Identify the foreign key references.
i. View the values in the Properties window to identify the Destination Field.
ii. Enter this value into the diagram. Note that the Destination Field property points to a
field in the child business component, which in turn has a column property that
identifies the table column.
d. Identify the column name in the child base table that holds the foreign key:
i. Drill down on the child business component.

Siebel 8.0 Essentials 219


Module 19: Siebel Business Objects

ii. Select Business Component :: Revenue | Field.


iii. In the name property, query for the Destination Field you identified in the previous
step.
iv. The column name that this field maps to is displayed under the Column property.
Enter this value into the child base table in the diagram. Note that you are now
viewing definitions for the data layer.

3. In this step, you will identify references between fields and business components for a M:M link
used by the Opportunity business object where there could be multiple opportunity records that
have relationships with multiple contact records. This example illustrates how the link focuses
the data while the intersection table resolves the M:M relationship. Enter your responses directly
into this diagram:

a. Inspect the Link definition to verify the relationship between opportunities and contacts is
M:M.
i. Select Business Object :: Opportunity | Business Object Component :: Contact.
ii. Enter the business object name specified under the Name property into the diagram.
iii. Enter the link name specified under the Link property into the diagram.
iv. Drill down on the Opportunity/Contact link.
v. Set a bookmark:

vi.
vii. Enter the value of the Inter Table property into the top of the intersection table in the
diagram.
b. Identify the parent and child business components and their base tables.

220 Siebel 8.0 Essentials


Module 19: Siebel Business Objects

i. Enter the name of the parent business component into the diagram. In Tools, it is the
value of the Parent Business Component property for the link object definition.
ii. Enter the name of the child business component into the diagram. It is the value of the
Child Business Component property for the link object definition.
iii. To identify the name of the base table for the parent, drill down on the parent
business component. Enter the value for the parent base table into the diagram. Note
that the table property listed for the business component is always the base table.
c. Identify the name of the base table for the child.
i. Use the bookmark to navigate back to the link object definition:
ii. Drill down on the child business component.
iii. Enter the value for the child business component’s base table into the diagram.
iv. Use the bookmark to navigate back to the link object definition:

d. Identify the primary key / foreign key mapping.


i. Open the properties window.
ii. The Inter Parent Column property holds the value for the intersection table FK
column that maps to the parent base table. Enter the foreign key for the parent base
table into the diagram.
iii. The Inter Child Column property holds the value for the intersection table FK column
that maps to the child base table. Enter the foreign key for the child base table into the
diagram.

4. In this step, you will examine the relationship for several more parent/child business
components.
a. Verify that the Account-Business Address relationship is one-to-many (1:M) by inspecting
the link definition.
i. Select Business Object :: Account | Business Object Component :: Business Address.
What link is used?

ii. Drill down on the Account/Business Address (w/Primary) link. What is the value of
the Inter Table property?

iii. What does this convey about the form of the Account – Business Address relationship?

b. In the Account/Position link, how can you verify that the form of the relationship between
Account and Position is M:M?

Siebel 8.0 Essentials 221


Module 19: Siebel Business Objects

c. In the Account/Contact link, what is the form of the relationship between Account and
Contact?

d. In the Service Request/Product Defect link, which intersection table supports the M:M
relationship between Service Request and Product Defect?

5. Log out and close Siebel Tools.

222 Siebel 8.0 Essentials


Module 19: Siebel Business Objects

Solutions 19-1 Examining Relationships between Views,


Business Objects, Business Components, and Tables
(Guided)

Answers:
1.d.

1.g.iv. What can you infer about the relationship between business objects and business
components?
A given business object references one or more business components

Siebel 8.0 Essentials 223


Module 19: Siebel Business Objects

2.

3.

4.a.i. Select Business Object :: Account | Business Object Component :: Business Address. What
link is used?
Account/Business Address (w/Primary).

4.a.ii. Drill down on the Account/Business Address (w/Primary) link What is the value of the
Inter Table property?
The field is blank.

224 Siebel 8.0 Essentials


Module 19: Siebel Business Objects

4.a.iii. What does this convey about the form of the Account – Business Address relationship?
It is a one-to-many (1:M) relationship.

4.b. In the Account/Position link, how can you verify that the form of the relationship between
Account and Position is M:M?
Inspect the Account/Position link (which has a value for the Inter Table property).

4.c. In the Account/Contact link, what is the form of the relationship between Account and
Contact?
The Inter Table property is not null, so the relationship is M:M.

4.d. In the Service Request/Product Defect link, which intersection table supports the M:M
relationship between Service Request and Product Defect?
S_SR_DEFECT.

Siebel 8.0 Essentials 225


Module 19: Siebel Business Objects

226 Siebel 8.0 Essentials


Module 21: The Configuration Process

Lab 21-1 Setting Up a Developer (Unguided)

Goal To set up a developer on your configuration team.

Time 15 - 20 minutes

Instructions:
Due to the critical nature of this lab, there is no Unguided version of it. Please turn the page and do
the Guided version.

Siebel 8.0 Essentials 227


Module 21: The Configuration Process

228 Siebel 8.0 Essentials


Module 21: The Configuration Process

Lab 21-1 Setting Up a Developer (Guided)

Goal To set up a developer on your configuration team.

Time 15 - 20 minutes

Instructions:
In this lab you will create an employee record for a developer, Pat Penguin. In future labs, you will
create a local database for Pat to use for Siebel application configuration. The tasks you will do in
this lab are:
• Create a position for Pat Penguin
• Create a responsibility associated with views that Pat will use
• Add Pat Penguin as an employee
• Create a mobile client, needed to create a local database for Pat
• Add Pat as a database user and login to allow access to the server database

1. Open the Siebel Web client and log in to Siebel Call Center as SADMIN/SADMIN.

2. You will create a position for Pat Penguin.


a. Navigate to Administration – Group > Positions.
b. Create a new position with the following values:
Division Default Organization
Position ABC Developer

3. Next, you will create the ABC Developer responsibility that will be assigned to Pat Penguin.
a. Navigate to Administration – Application > Responsibilities.
b. Create a new responsibility record named ABC Developer.
c. You will add the required application views to the ABC Developer responsibility. Two types
of views will be added to this responsibility: all views that will be used in this course, as well
as all repository views. Instead of associating one view at a time to the new responsibility,
you will use a provided text file to speed the process.
i. Using Windows Explorer, navigate to D:\Labs\Essentials and open ABC Developer
views.txt. This file contains a query that you execute to select the views for the ABC
Developer responsibility.
ii. Select Edit > Select All.
iii. Select Edit > Copy to copy the text in the file.
iv. Switch to the Siebel Call Center window.

Siebel 8.0 Essentials 229


Module 21: The Configuration Process

v. Click Add in the Views applet to create a new record. The application will display a list
applet entitled Add Views.
vi. Click Query.
vii. In the View Name field, paste the query string copied from ABC Developer views.txt.
viii. Click Go. 45 views will be returned.
ix. Press CTRL+A to select all 45 views. Click OK to add them. Verify that 45 views were
added to the responsibility.
x. Close ABC Developer views.txt.
d. You will add the required repository views to the ABC Developer responsibility.
i. In Siebel Call Center, click Add in the Views list to create a new record. The
application will display the Add Views association applet.
ii. Find all views beginning with the word Repository. Enter Repository in the “Starting
with” field and click Go. Scroll to the bottom of the list to verify 122 view records
matched the query. These views are used by Siebel Tools, where they allow drilldown
access to objects, such as the ability to drill down on the Table property in a business
component definition.
iii. Press CRTL+A to select all records.
iv. Click OK to add them. Verify that you now have 167 views added to the ABC
Developer responsibility.
v. Make sure the Local Access field is checked for each view. This will allow you to
access these views while connected to a local database. There should be five views with
Local Access flag unchecked. Check the flag for each of them.
All Accounts across Organizations
All Contacts across Organizations
All Service Requests across Organizations
Asset Mgmt – Assets View
Contact List View
Note: To query for views with Local Access unchecked, check the Local Access flag in
your query, then uncheck it.
e. In the Responsibilities applet, click Clear Cache to ensure that the ABC Developer
responsibility is not cached.

4. You will create Pat Penguin as an ABC developer by creating an employee record.
a. Navigate to Administration – User > Employees.
b. Create a new employee record using the position you just created:
Last Name Penguin
First Name Pat
User ID PPENGUIN
Responsibility ABC Developer (use the
shuttle applet to add this
responsibility and remove
the Siebel Administrator
responsibility for
PPENGUIN )
Position ABC Developer

230 Siebel 8.0 Essentials


Module 21: The Configuration Process

c. Verify that PPENGUIN has only the ABC Developer responsibility before proceeding.

5. You will add a corresponding database login for Pat Penguin.


a. Select Start > Programs > Microsoft SQL Server 2005 > SQL Server Management Studio
Express.
b. Click Connect.
c. Select File > Open > File.
d. Select the file D:\Labs\Essentials\add login for PPENGUIN.sql.
e. Click Connect. The script you see was created by modifying grantusr.sql. It contains the
statements to create a user login and assign that user a default database and a role. The syntax
is specific to MS SQL Server. In a real-world implementation, the database administrator on
your team would create these scripts for you.
f. Click Execute.
g. The results should state:
Command(s) completed successfully.
h. Exit SQL Server Management Studio Express.

6. You will register Pat Penguin as a mobile client. This will allow you to run a database extract
job and create a local database for Pat, as you will do later in this lab.
a. In Siebel Call Center, navigate to Administration - Siebel Remote > Mobile Clients.
b. In the Mobile Clients list, create a new record with the following values:
Mobile Client PPENGUIN
User ID PPENGUIN
Routing Model MOBILE CLIENT - STANDARD

c. Save the record.

7. You will configure Siebel Remote security preferences by disabling password expiration,
password syntax checking and remote user lockout. These security features are important, but are
unnecessary in the classroom environment.
a. Click the Remote System Preferences link.
b. Uncheck three check boxes in the Remote System Preferences applet:
Enable Mobile Password Expiration
Enable Mobile Password Syntax Check
Enable Mobile Web Client Lockout
c. Click Save.

8. Finally, you will verify your work.


a. Log out of Siebel Call Center.
b. Start Siebel Call Center using the Web client and log in as PPENGUIN/PPENGUIN.
c. You should see five screen tabs: Home, Accounts, Contacts, Opportunities, Service.
Note: If the login was not successful or you do not see the proper screens, do not continue.
Speak with your instructor. You must be able to log in as PPENGUIN to continue.
d. Log out of Siebel Call Center.

Siebel 8.0 Essentials 231


Module 21: The Configuration Process

232 Siebel 8.0 Essentials


Module 21: The Configuration Process

Lab 21-2 Extracting a Local Database (Unguided)

Goal To execute server tasks to generate a database template and extract a local database for
Pat Penguin.

Time 25 - 40 minutes

Instructions:
Due to the critical nature of this lab, there is no Unguided version of it. Please turn the page and do
the Guided version.

Siebel 8.0 Essentials 233


Module 21: The Configuration Process

234 Siebel 8.0 Essentials


Module 21: The Configuration Process

Lab 21-2 Extracting a Local Database (Guided)

Goal To execute server tasks to generate a database template and extract a local database for
Pat Penguin.

Time 25 - 40 minutes

Instructions:
Before you create a local database to be used by the developer, you need to run two server jobs.
First, you must generate a database template that represents the Siebel schema. Second, you must run
a database extract on the server for mobile user PPENGUIN. This extracted data will be used to
build Pat Penguin’s local database.

1. Start Siebel Call Center using the Web client and log in as SADMIN/SADMIN.

2. You will enable the Siebel Remote component group.


a. Navigate to Administration – Server Configuration > Enterprises > Component Groups.
b. In the Component Groups child applet, query for the component group Siebel Remote.
c. Locate the grandchild applet titled Component Group Assignments. You will see a single
record for server OUsrvr. If the Enabled on Server checkbox is not checked, click Enable.
d. If necessary, synchronize components with the Gateway Name Server. It should not be
necessary, as you synchronized all assigned component groups in a previous lab.
i. Click the Synchronize view tab.
ii. Query for the Database Extract component. This is one of the components from the
Siebel Remote component group.
iii. If this component is not found, click the Synchronize button. Synchronization will take
1-2 minutes.
e. Log out of Siebel Call Center.

3. You will restart the Siebel Server so that it will reflect the new configuration.
a. If necessary, select Start > Programs > Administrative Tools > Services.
b. Locate the Siebel Server [Siebel_OUsrvr] service. Right-click on it and select Stop. Your
Siebel Server may take a few minutes to completely shut down, and sometimes the Service
Control dialog box will generate a warning that it could not stop this service. However, click
OK and update the status for the Siebel Server service by selecting Action > Refresh
periodically. Within a minute or so, you should see this service’s status change from
Stopping to blank.
c. Right-click on Siebel Server [Siebel_OUsrvr] and select Start. Right-click on an empty
part of the Windows task bar and select Task Manager. Monitor CPU usage until percentage
used drops to near 0% and remains there.

Siebel 8.0 Essentials 235


Module 21: The Configuration Process

d. Start Siebel Call Center using the Web client and log in as SADMIN/SADMIN.

4. You will verify that the Siebel Remote server components are online, and synchronize
component definitions with the Siebel Gateway. These steps are prerequisites for running the
server jobs to create a local database.
a. Navigate to Administration > Server Management > Components.
b. In the Components list applet, locate Database Extract, Generate New Database, and
Synchronization Manager. Make sure these three components have state Online. If any of
these components is not online, notify your instructor.
c. Navigate to Administration – Server Configuration > Enterprises > Synchronize.
d. In the Synchronize child applet, click Synchronize. Synchronization will take 1-2 minutes to
complete, and will be done when your cursor returns to normal from hourglass form.

5. Next, you will submit a job to start a Generate New Database server task.
a. Navigate to Administration – Server Management > Jobs.
b. In the Jobs list, click New.
c. In the Component/Job field, select Generate New Database from the Components/Jobs
applet and click OK.
d. Scroll down to the bottom of the page, and in the Job Parameters list, click New.
i. In the Name field, select Client Db Type.
ii. Verify that the default parameter value, Sql Anywhere, is entered in the Value field.
e. In the Jobs list, what is the status of the job?

f. Click the Submit Job button to run the task.


g. What is the status of the job?

6. You will monitor the Generate New Database task.


a. Click Servers in the link bar.
b. Select the Tasks view link.
c. Locate the Generate New Database task in the Tasks list. Monitor the task for a few minutes.
The best way to refresh a list in Siebel applications is to run a null query.
i. Click the Query button.
ii. Leave all the fields blank.
iii. Click the Go button.
d. Record the task number of the Generate New Database task:

e. Monitor the task until it completes by executing the query periodically. On the Tasks list, the
Status field will have value Completed successfully.
f. Select the Generate New Database task to view the Task Information Log in the lower
portion of the screen. No records appear if the task executed successfully.

236 Siebel 8.0 Essentials


Module 21: The Configuration Process

7. You will verify the existence of the database template file.


a. Navigate to D:\OUsea\siebsrvr\DBTEMPL.
b. There should be a subdirectory with a name similar to “db43r105” Verify that it contains four
files.

8. Now you will run a Database Extract job to build a local database for Pat Penguin that contains
the user data visible to Pat.
a. Click Jobs in the link bar.
b. In the Jobs list, click New.
c. In the Component/Job field, select Database Extract.
d. Scroll down to the bottom of the page, and in the Job Parameters list, enter the following job
parameters:
Name Value
Client Database encryption method None (don’t leave
blank)
Client Name PPENGUIN
Encrypt client Db password False
e. In the Jobs list applet at the top of the page, click Submit Job.
f. In the Jobs list applet, click Query, and then click Go (to execute a null query to refresh the
view). The status for the Database Extract job should change from “Queued” to “Active.”
g. Click on Tasks in the link bar to view the task.
h. Query for Component = Database Extract. Monitor the status of the task until completion
by re-querying the applet. The State field will be set to Completed when the database extract
is done. This should be within 5-10 minutes after you submitted the job.

9. Finally, you will verify your work.


a. Navigate to D:\OUsea\siebsrvr\docking.
b. Verify that there is a PPENGUIN directory.
i. In the PPENGUIN directory, verify that there is a file called dobjinst.dbf and
subdirectories called inbox and outbox.
ii. Verify that the outbox subdirectory contains several files. There should be at least one
with each of the following extensions: .uaf, .dat, and .toc.
c. Select File > Log Out to close the Siebel Call Center application, and then close the Internet
Explorer window.

Siebel 8.0 Essentials 237


Module 21: The Configuration Process

Solutions 21-2 Extracting a Local Database (Guided)

Answers:
5.e. In the Jobs applet, what is the status of the job?
Creating

5.g. What is the status of the job?


Queued

238 Siebel 8.0 Essentials


Module 21: The Configuration Process

Lab 21-3 Populating the Local Developer Database


(Unguided)

Goal To initialize and populate the local developer database.

Time 20 - 30 minutes

Instructions:
Due to the critical nature of this lab, there is no Unguided version of it. Please turn the page and do
the Guided version.

Siebel 8.0 Essentials 239


Module 21: The Configuration Process

240 Siebel 8.0 Essentials


Module 21: The Configuration Process

Lab 21-3 Populating the Local Developer Database


(Guided)

Goal To initialize and populate the local developer database.

Time 20 - 30 minutes

Instructions:
Before you create Pat Penguin’s local database, you will need to check configuration files and
ODBC connection settings. The last step in creating the local database is to start Siebel Tools
connected to the local database. Because this database doesn’t exist yet, Tools will create it, using
the database extract files that you generated in the last lab.

1. You will verify that Tools is correctly configured to connect to the server and local databases.
a. In Windows Explorer, navigate to D:\OUsea\tools\BIN\ENU.
b. Double-click tools.cfg to open it with Notepad.
c. Scroll down and find the [Local] section.
i. Verify that the ConnectString parameter is set to:
D:\OUsea\tools\local\sse_data.dbf –q –m –x NONE –gp 4096 –c256m –ch256m
ii. Set the DockConnString parameter to localhost.
d. Scroll down and find the [ServerDataSrc] section.
i. Verify that the FileSystem parameter is set to D:\siebfile.
ii. Set the GatewayAddress parameter to localhost.
iii. Verify that the EnterpriseServer parameter = Siebel.
e. Save and close tools.cfg.

2. Next, you will verify or update the ODBC data source for Tools, connecting to the server.
a. Select Start > Programs > Administrative Tools > Data Sources (ODBC).
b. In the ODBC Data Source Administrator dialog box, click the System DSN tab.
c. Select SSD default instance and click Configure.
d. In the first dialog box of the Microsoft SQL Server DSN Configuration wizard, verify the
following entries:
Name SSD default instance
Description Siebel MS SQL Database
Server localhost

e. Click Next.
f. Select With SQL Server authentication.

Siebel 8.0 Essentials 241


Module 21: The Configuration Process

g. Select Connect to SQL Server and enter the following values:


Login ID PPENGUIN
Password PPENGUIN

h. Click Next.
i. Select the Change the default database to option and, if necessary, select siebeldb from the
drop-down menu and click Next.
j. Click Finish.
k. Click the Test Data Source button in the ODBC Microsoft SQL Server Setup dialog box.
l. You should see the message “TESTS COMPLETED SUCCESSFULLY!” in the SQL Server
ODBC Data Source Test dialog box. Click OK to close the dialog box.
m. Click OK to close the ODBC Microsoft SQL Server Setup dialog box.
n. Click OK to close the ODBC Data Source Administrator dialog box.

3. You will initialize the sse_data.dbf SQL Anywhere local database using Siebel Tools. In this
step the local database is populated.
a. Start Siebel Tools and log in as PPENGUIN/PPENGUIN connecting to the Local database.
b. In the siebdev dialog box window that appears, click Yes to initialize the local database.
c. In the Siebel Remote Parameters dialog box that appears, enter the following values:
Client Name PPENGUIN
User Name PPENGUIN
Password PPENGUIN
Confirm Password PPENGUIN
d. Click Continue.
e. The Siebel Upgrade wizard will be started and a progression window will show the status of
the initialization process. This process will take 3 to 5 minutes to complete.

4. When initialization completes, Siebel Tools will open. You will verify the local login.
a. Select Help > Technical Support.
b. Verify the User name = PPENGUIN
c. Verify the Connect string = D:\OUsea\tools\local\sse_data.dbf –q –m –x
d. Verify the Table owner = SIEBEL
Note: If Siebel Tools did not open successfully, or you do not see the proper information, do
not continue. Speak with your instructor. You must be able to log in as PPENGUIN to
continue with the labs.
e. Click OK.
5. Now you will verify the ODBC Data Sources in Siebel Tools.
a. Select View > Options.
b. Select Check In/Out.
c. Click the Change button next to Data Sources: Server.

242 Siebel 8.0 Essentials


Module 21: The Configuration Process

d. Verify the ODBC data source for the server:


Client Name SSD default instance (There are two spaces
between “SSD” and “default instance”.)
User Name PPENGUIN
Password not verifiable, as it is not visible
Table Owner dbo
e. Click OK to close the Change Data Source window.
f. Click the Change button next to the Client Data source.
g. Verify the ODBC data source for the client:
Client Name SSD Local Db default instance
User Name PPENGUIN
Password not verifiable, as it is not visible
Table Owner SIEBEL
h. Click OK to close the Change Data Source window.
i. Click OK to close the Development Tools Options window.

6. You will test the local database login.


a. Close Siebel Tools
b. Start Siebel Tools and log in as SADMIN/SADMIN connecting to the Local database.
Note: You should receive an error. This is expected. The local database is initialized for a
given user, PPENGUIN. Other users, such as SADMIN, do not have access.
c. Click OK.

7. Populate the local database with object definitions from the repository.
a. Start Siebel Tools and log in as PPENGUIN/PPENGUIN connecting to the Local database.
b. Select Applet in the Object Explorer. You should not see any object definitions, since you
have not populated the repository tables yet.
c. Select Tools > Check Out.
d. Click All projects.
e. Click the Get button (not Check Out).
Note: This process will run for 45 minutes to an hour. You will learn about this dialog in the
next module.

Siebel 8.0 Essentials 243


Module 21: The Configuration Process

244 Siebel 8.0 Essentials


Module 22: Managing Object Definitions

Lab 22-1 Exploring Projects (Unguided)

Goals To explore how projects work in Siebel Tools.


To perform project and object-level check outs.

Time 30 - 40 minutes

Instructions:
In this lab, you will modify the Asset Mgmt – Assets View object definition. To do this, you need to
determine the proper project, check it out from the server, and then change the object definition.

1. Open Siebel Tools and log in as PPENGUIN/PPENGUIN connecting to the Local database.

2. Explore what needs to be done to modify an object definition. You will use the Asset Mgmt -
Asset business component for this step.
a. Select Business Component :: Asset Mgmt – Asset. Note that you cannot modify it because
you have not yet locked the project to which it belongs.
b. The Project property specifies the project to which the object definition belongs. What is the
value of the Project property?

3. Determine what other object definitions you will be able to edit when you check out the project.
a. Select Asset Management from the Project drop-down list at the top of the Object Explorer
window. After you check out the Asset Management project, will another team member be
able to edit the Asset Mgmt – Account Pick Applet object definition? Why or why not?

b. Reset your OE display so that you have an unrestricted list of all the projects. Select ** All
Projects ** at the top of the Project drop-down list in the Object Explorer window.

4. Enable project checkout for the Asset Management project, as well as other projects you will
modify during this course.
a. Start a new Tools session and log in as SADMIN/SADMIN to the Server database.
b. Toggle Allows Object Locking to FALSE for the Asset Management project.

Siebel 8.0 Essentials 245


Module 22: Managing Object Definitions

c. Toggle Allows Object Locking to FALSE for the following projects:


Account
Account (SSE)
Contact
Contact (SSE)
Service
Service (SSV)
Table Asset.

5. In the Siebel Tools session where you are logged in as PPENGUIN/PPENGUIN, check out the
Asset Management project.
Note: Use Help > Tech Support if you have trouble determining which session is which.

6. Return to the Siebel Tools session where you are logged in as SADMIN/SADMIN and confirm
that the project has been checked out by PPENGUIN.

7. In the Siebel Tools session where you are logged in as PPENGUIN/PPENGUIN, perform an
object-level check out of the User List business component.

8. Return to the Siebel Tools session connected to Server as SADMIN. What signs are there that
the User List object is checked out?

9. Exit from SADMIN’s Siebel Tools session. Leave PPENGUIN’s session open. Log out of
Siebel Call Center.

10. Return to Siebel Tools and observe the visual cues that indicate whether object definitions are a
part of a locked or unlocked project.
a. Select Screen in the OE.
b. Examine Asset Management Screen and Asset Management Screen (eService) in the
OBLE.
c. What differences do you notice between the two screen definitions?

246 Siebel 8.0 Essentials


Module 22: Managing Object Definitions

11. One of your colleagues noticed that a developer could invoke Tools > Lock Project to lock the
project locally and make the definitions available for editing. What are the consequences of
doing this to edit the Asset Management Screen object definition?

12. Select Tools > Check In. What appears in the check in list and why?

13. Check in the Asset Management project while maintaining the lock.
Note: You will use the technique in this step as you continue through the configuration labs. Get
into the habit of checking your work in to the server at the end of the labs, but maintaining your
locks to avoid unnecessary additional check outs.

Siebel 8.0 Essentials 247


Module 22: Managing Object Definitions

Solutions 22-1 Exploring Projects (Unguided)

Answers:
2.b. The Project property specifies the project to which the object definition belongs. What is
the value of the Project property?
Asset Management

3.a. Select Asset Management from the Project drop-down list at the top of the Object
Explorer window. After you check out the Asset Management project, will another team
member be able to edit the Asset Mgmt – Account Pick Applet object definition? Why or
why not?
No. When you check out a project from the server, it locks the project on the server, thus
preventing other developers from modifying it, and the Asset Mgmt – Account Pick Applet
is part of this project.

8. Return to the Siebel Tools session connected to Server as SADMIN. What signs are there
that the User List object is checked out?
The Object Locked property is TRUE (checked), and Object Locked By is PPENGUIN.

10.c. What differences do you notice between the two screen definitions?
(1) The “W” (for writeable) column has a pencil icon in the Asset Management Screen, but
not in the Asset Management Screen (eService).
(2) When you select one of the fields in the Asset Management Screen, the background is
white and you can edit the field. When you select one of the fields in the Asset Management
Screen (eService), the background is gray and you cannot edit the field.

11. One of your colleagues noticed that a developer could invoke Tools > Lock Project to lock
the project locally and make the definitions available for editing. What are the
consequences of doing this to edit the Asset Management Screen object definition?
They will be able to create and edit the object definitions, but they will not be able to check
them into the server. In addition, another developer can check out the Asset Management
project from the server and make a different set of changes.

12. Select Tools > Check In. What appears in the check in list and why?
Asset Management is the only locked project you have checked out, and is therefore the
only project that you can check in. User List appears with type Business Component,
because you did an object check out.

248 Siebel 8.0 Essentials


Module 22: Managing Object Definitions

Lab 22-1 Exploring Projects (Guided)

Goals To explore how projects work in Siebel Tools.


To perform project and object-level check outs.

Time 30 - 40 minutes

Instructions:
In this lab, you will modify the Asset Mgmt – Assets View object definition. To do this, you need to
determine the proper project, check it out from the server, and then change the object definition.

1. Open Siebel Tools and log in as PPENGUIN/PPENGUIN connecting to the Local database.

2. You will now explore what needs to be done to modify an object definition. You will use the
Asset Mgmt - Asset business component for this step.
a. Select Business Component :: Asset Mgmt - Asset.
b. Click the Comments property in the Object List Editor (OBLE) for the Asset Mgmt - Asset
object definition. You will probably have to scroll to the far right of the window to find the
Comments property. You may want to right-click in the OLBE and select Columns
Displayed and then move the Comments column so that it appears in the first few columns
displayed.
i. Can you change its value?

ii. What visual cues reinforce this?

iii. What must you do before you can edit the Asset Mgmt - Asset business component
object definition?

iv. The Project property specifies the project to which the object definition belongs.
What is the value of the Project property?

Siebel 8.0 Essentials 249


Module 22: Managing Object Definitions

v. If you do not see the Properties window, select View > Windows > Properties
Window. Does the Project property appear in the Properties window?

vi. Right-click the Properties window and select Hide to hide it.
c. Verify that the project is, in fact, not already locked:
i. Select Project in the OE.
ii. Query for Name = Asset Managment. Is the project locked?

iii. Query for Locked=checked. Are any projects locked at this point?

3. Select View : Asset Mgmt – Assets View in the Object Explorer. Which project will you need to
check out to be able to modify the Asset Mgmt - Assets View object definition?

4. Before you check out a project, you might want to know what other object definitions you will
be able to edit when you check out the project.
a. Select Asset Management from the Project drop-down list at the top of the Object Explorer
window. Do you see more or fewer object types displayed in the OE?

b. After you check out the Asset Management project, will another team member be able to edit
the Asset Mgmt – Account Pick Applet object definition? Why or why not?

c. Reset your OE display so that you have an unrestricted list of all the projects. Select ** All
Projects ** at the top of the Project drop-down list in the Object Explorer window.

5. Next, you will check out the Asset Management project from the server so you are prepared to
make changes to the Asset Mgmt - Assets View object definition.
a. Select Tools > Check Out.
b. Select Asset Management from the list. Can you check out this project?

c. What do you have to do first?

d. Click Cancel to close the window.

250 Siebel 8.0 Essentials


Module 22: Managing Object Definitions

e. Now you will enable project checkout for the Asset Management project, as well as other
projects you will modify during this course.
i. Start a new Tools session and log in as SADMIN/SADMIN to the Server database.
ii. Select Project :: Asset Management.
iii. Right-click and select Toggle Allows Object Locking.
iv. Verify the change by querying for projects with Allow Object Locking equals FALSE
(unchecked). Do this by checking and then unchecking the check box in the query.
Asset Management should be one of the projects returned by this query.
v. Before you exit from Tools as SADMIN, you will unset Allow Object Locking for
several other projects that you will use later. Refresh the project list, and right-click
and select Toggle Allows Object Locking for the following projects:
Account
Account (SSE)
Contact
Contact (SSE)
Service
Service (SSV)
Table Asset
vi. Verify your changes by querying for projects with Allow Object Locking equals
FALSE (unchecked) and Changed is TRUE (checked).
vii. Exit SADMIN’s Siebel Tools session.
f. You will check out the Asset Management project.
i. Return to the other Siebel Tools session, where you are logged on as PPENGUIN
connected to the local database.
ii. Cancel the previous Check Out.
iii. Select Tools > Check Out and select Asset Management from the project list.
iv. Click Check Out. Observe the communication between the server and the local
database displayed in the dialog box. Notice that the OBLE disappears towards the
end of the checkout. The check out will take several minutes.
g. Observe what other developers see when you have the Asset Management project checked
out.
i. Start a second instance of Siebel Tools as SADMIN/SADMIN and connect to the
Server database.
ii. Select Project :: Asset Management.
iii. Will other developers know PPENGUIN has the project locked? Why or why not?

iv. Attempt to lock the project and confirm that you get an error message.
v. Click OK to close the error dialog.
vi. Leave this session of Tools open and return to where you are logged in to Siebel
Tools as PPENGUIN, connected to the Local database.
h. Verify that the checkout was successful.
i. Select Project in the OE.

Siebel 8.0 Essentials 251


Module 22: Managing Object Definitions

ii. Query for Locked = TRUE


iii. Do you have any projects locked?

iv. What is the value of the Locked By Name property for the Asset Management
project?

6. This step will allow you to test object-level check out and check in. In the rest of the course you
will only perform project check outs, not object-level check outs.
a. In the OE, select Business Component :: User List.
b. What project does this object belong to?

c. Right-click and select Check Out Object.


d. Click Check Out.
e. Return to the Siebel Tools session connected to Server as SADMIN.
f. Select Project in the OE and query for locked projects in the OBLE. What project(s) are
locked?

g. Select Business Component :: User List in the OE. What signs are there that this object is
checked out?
Hint: Scroll to the right.

h. Exit from SADMIN’s Siebel Tools session. Leave PPENGUIN’s session open.

7. When you check out a project, a local copy of the project, called an archive file, is also created in
the tools\TEMP directory. You will learn about archive files in a later module.
a. Use Windows Explorer to navigate to the D:\OUsea\Tools\TEMP\Projects directory. What is
the name of the file located in this directory?

Note: If you need extra drive space during the configuration process, you may delete these
.sif files. Do not delete this file now!
b. Navigate to D:\OUsea\Tools\TEMP\Objects. What file appears in this directory?

8. Return to Siebel Tools and observe the visual cues that indicate whether object definitions are a
part of a locked or unlocked project.
a. Select Screen in the OE.

252 Siebel 8.0 Essentials


Module 22: Managing Object Definitions

b. Examine Asset Management Screen and Asset Management Screen (eService) in the
OBLE.

c. What differences do you notice between the two screen definitions?

9. One of your colleagues noticed that a developer could invoke Tools > Lock Project to lock the
project locally and make the definitions available for editing. What are the consequences of
doing this to edit the Asset Management Screen object definition?

10. Now you will explore which projects can be used to assign new object definitions.
a. Select Screen in the OE.
b. You want to add a new Screen object definition.
i. Right-click in the OBLE and select New Record to add a new screen object
definition.
ii. Click the drop-down arrow to open the Project picklist in the newly created record.
Why is Asset Management the only project listed?

iii. Click Close to close the Project picklist window.


iv. Right-click and select Undo Record to delete the newly created record.

11. Imagine you have implemented changes to the Asset Mgmt - Assets View object definition,
tested them locally, and they work. These modified definitions can stand alone, and you want to
make certain that the next set of changes will not affect the Asset Mgmt - Assets View object
definition. You decide to check the project into the server to save the snapshot (milestone) before
continuing with the next set of changes.
a. Select Tools > Check In. What appears in the check in list and why?

Siebel 8.0 Essentials 253


Module 22: Managing Object Definitions

b. Select Asset Management.


c. Check the Maintain lock check box, because you still need to make more changes. You will
still be using this project, and this will allow you to modify object definitions in the Asset
Management project without checking it out again.
d. Click Check In. Observe how the status is displayed during check-in.
e. Check in the User List business component.
i. Select Tools > Check In.
ii. Select User List in the Check In dialog box.
iii. Select the Maintain lock check box.
iv. Click Check In.
f. Verify the results of the project check-in.
i. Select Project in the OE.
ii. Query for Locked = TRUE. You should still see that you have the Asset Management
project locked. If not, then repeat the checkout.
Note: You will use the technique in this step as you continue through the configuration labs. Get
into the habit of checking your work into the server at the end of the labs (with the lock
maintained as directed by the project development plan).

254 Siebel 8.0 Essentials


Module 22: Managing Object Definitions

Solutions 22-1 Exploring Projects (Guided)

Answers:
2.b.i. Can you change its value?
No

2.b.ii. What visual cues reinforce this?


(1) The background of the field appears gray.
(2) The “W” field, which indicates whether the record is writeable, is null (blank).

2.b.iii What must you do before you can edit the Asset Mgmt - Asset Business Component object
definition?
Best practice is to check out the object or its project from the server. Checking an object
or project out from the server prevents other developers from modifying it and allows
checking back to the server. You can also lock the project locally to edit the object
definition. This should only be considered when prototyping or intending to discard
changes. Locking projects locally prevents the developer from checking them in to the
server repository, so be careful when using this option!

2.b.iv. The Project property specifies the project to which the object definition belongs. What is
the value of the Project property?
Asset Management

2.b.v. If you do not see the Properties window, select View > Windows > Properties Window.
Does the Project property appear in the Properties window?
No

2.c.ii. Query for Project = Asset Management. Is the project locked?


No

2.c.iii. Are any projects locked at this point? (Hint: Query for Locked=checked.)
Yes – ABC WF

3. Select View : Asset Mgmt – Assets View in the Object Explorer. Which project will you
need to check out to be able to modify the Asset Mgmt - Assets View object definition?
You will need to check out Asset Management.

4.a. Select Asset Management from the Project drop-down list at the top of the Object
Explorer window. Do you see more or fewer object types displayed in the OE?
Fewer (there are ten displayed).

Siebel 8.0 Essentials 255


Module 22: Managing Object Definitions

4.b. After you check out the Asset Management project, will another team member be able to
edit the Asset Mgmt – Account Pick Applet object definition? Why or why not?
No. When you check out a project from the server, it locks the project on the server, thus
preventing other developers from modifying it, and the Asset Mgmt – Account Pick Applet
is part of this project.

5.b. Select Asset Management from the list. Can you check out this project?
No. The Check Out button remains grayed out.

5.c. What do you have to do first?


Set Allow Object Locking to FALSE for the Asset Management project on the Server. This
can only be done by a user with administrative privileges (such as SADMIN). This will
allow project-level check out for PPENGUIN.

5.g.iii. Will other developers know you have the project locked? Why or why not?
Yes, because the Locked property is true, and the Locked By Name property shows
PPENGUIN’s user ID.

5.h.iii. Do you have any projects locked?


Yes, the Asset Management project is now locked, as well as the ABC WF project.

5.h.iv. What is the value of the Locked By Name property for the Asset Management project?
PPENGUIN

6.b. What project does this object belong to?


Division

6.f. Select Project in the OE and query for locked projects in the OBLE. What project(s) are
locked?
Asset Management and ABC WF

6.g. Select Business Component :: User List in the OE. What signs are there that this object is
checked out?
Hint: Scroll to the right.
The Object Locked property is TRUE (checked), and Object Locked By is PPENGUIN.

7.a. Use Windows Explorer to navigate to the D:\OUsea\Tools\TEMP\Projects directory. What


is the name of the file located in this directory?
Asset_Management.sif

7.b. Navigate to D:\OUsea\Tools\TEMP\Objects. What file appears in this directory?


Business_Component_User_List.sif

256 Siebel 8.0 Essentials


Module 22: Managing Object Definitions

8.c. What differences do you notice between the two?


(1) The “W” (for writeable) column has a pencil icon in the Asset Management Screen, but
not in the Asset Management Screen (eService).
(2) When you select one of the fields in the Asset Management Screen, the background is
white and you can edit the field. When you select one of the fields in the Asset Management
Screen (eService), the background is gray and you cannot edit the field.

9. One of your colleagues noticed that a developer could invoke Tools > Lock Project to lock
the project locally and make the definitions available for editing. What are the
consequences of doing this to edit the Asset Management Screen object definition?
They will be able to create and edit the object definitions, but they will not be able to check
them into the server. In addition, another developer can check out the Asset Management
project from the server and make a different set of changes.

10.b.ii. Click the drop-down arrow to open the Project picklist in the newly created record. Why
is Asset Management the only project listed?
Asset Management is the only project locked by PPENGUIN, and you can only add object
definitions to a project locked by the current user. ABC WF is also locked, but it is locked
by SADMIN, so PPENGUIN cannot use it.

11.a. Select Tools > Check In. What appears in the check in list and why?
Asset Management is the only locked project you have checked out, and is therefore the
only project that you can check in. User List appears with type Business Component,
because you did an object check out.

Siebel 8.0 Essentials 257


Module 22: Managing Object Definitions

258 Siebel 8.0 Essentials


Module 23: Editing and Compiling Object Definitions

Lab 23-1 Editing and Validating Object Definitions


(Unguided)

Goal To practice using Siebel Tools for editing and validating object definitions.

Time 10 - 15 minutes

Instructions:
You will practice modifying object definitions in Siebel Tools in this lab. You will verify your
changes using Tools’ Validation tool. These definition changes will be examined and archived in
the next lab.

1. If necessary, open Siebel Tools and log in as PPENGUIN/PPENGUIN connecting to the Local
database.

2. Change the Visibility Applet and Comments properties for the Asset Mgmt - Assets View.
Which properties change is not important; in this and the next steps you will see how Siebel
Tools tracks changes to objects and projects, and how you can validate object definitions.
a. Blank out the Visibility Applet property of the Asset Mgmt - Assets View.
b. Use the properties window to set the Comments property column of the Asset Mgmt -
Assets View record to “Deleted visibility applet”.

3. Explore the Inactive property. Each object definition has a property called Inactive. If Inactive is
set, the object definition will not be referenced by Siebel applications.
a. Mark View :: Asset Mgmt - Assets View as inactive and observe the results.
b. Reset the view to active.

4. Validate the Asset Mgmt - Assets View object definition. Which rule number was violated?

5. Deactivate that rule by clicking Options, then selecting it and clicking Ignore.

6. Rerun the validation and confirm that it no longer generates any errors.

7. Reset the rule so that it is once again enforced.

Siebel 8.0 Essentials 259


Module 23: Editing and Compiling Object Definitions

Solutions 23-1 Editing and Validating Object Definitions


(Unguided)

Answers:
4. Validate the Asset Mgmt - Assets View object definition. Which rule number was
violated?
Rule number 7.

260 Siebel 8.0 Essentials


Module 23: Editing and Compiling Object Definitions

Lab 23-1 Editing and Validating Object Definitions


(Guided)

Goal To practice using Siebel Tools for editing and validating object definitions.

Time 10 - 15 minutes

Instructions:
You will practice modifying object definitions in Siebel Tools in this lab. You will verify your
changes using Tools’ Validation tool. These definition changes will be examined and archived in
the next lab.

1. If necessary, open Siebel Tools and log in as PPENGUIN/PPENGUIN connecting to the Local
database.

2. You will start this lab by changing the value of properties in both the Object List Editor (OBLE)
and the Properties window. You will change the Visibility Applet and Comments properties for
Asset Mgmt – Assets View. Which properties change is not important, but in this and the next
steps you will see how Siebel Tools tracks changes to objects and projects, and how you can
validate object definitions.
a. Select View :: Asset Mgmt – Assets View.
b. In the OBLE, tab over to the Visibility Applet property column and delete the field contents
so that it is blank (or null). Be careful not to click the drilldown to the Asset Mgmt – Asset
List Applet. Step off the record to commit your change.
c. Click the Properties tab to the left side of the OE. (If it is not there, select View > Windows
> Properties Window, then right-click on the Properties window display bar and select Auto-
Hide.)
d. In the Properties window, click the Comments property column of the Asset Mgmt – Assets
View record and enter Deleted visibility applet. Step off the record to commit your change.

3. You will now observe that some properties have picklists and some do not.
a. Select View :: Asset Mgmt – Assets View.
b. Double click the column header of the Name property to lock the Name column in place.
Scroll right and find the Thread Field property. Type in “Asset Tag” rather than using the
dropdown list. Tab out of the field. What happens?

c. Click Close.

Siebel 8.0 Essentials 261


Module 23: Editing and Compiling Object Definitions

4. Each object definition has a property called Inactive. If Inactive is set, the object definition will
not be referenced by Siebel applications.You will now explore this property.
a. Make sure View :: Asset Mgmt – Assets View is selected.
b. Click the Inactive column in the OBLE (this will toggle the setting of a TRUE/FALSE
value). Aside from the checkmark, what visual indication appears?

c. Look in the Properties window and verify that the Inactive property is set to TRUE; if not, set
it to TRUE.
d. Reset the Inactive property to FALSE and tab out of the column.
Note: You will use these techniques to edit property values throughout the configuration labs.
Be careful where you click, because you might set a property to TRUE or FALSE in the
OBLE by mistake. You might find it safer to use the tab key when moving from one column
to another in the OBLE.

5. Next, you will practice using the Validate option to verify your changes.
a. With View :: Asset Mgmt – Assets View selected in the OBLE, right-click and select
Validate.
b. Click Start to validate the Asset Mgmt – Assets View object definition. Wait a few moments
for the validation to complete.
i. Select the error listed and inspect the details listed in the Details box. Which rule
number was violated?

ii. Click Save As to save the details in a log file.


iii. Click Save.
c. Click Options to examine the rules that are checked during validation.
i. Click the Object column heading to sort the rules list by object type.
ii. Which rule numbers are specific to View objects?

iii. Which two rules apply to all objects?

iv. Select Rule 7.


v. Click Ignore to deactivate the rule. If necessary, scroll right to find the Enforce
column. Notice that its value is now No.
vi. Click OK.

262 Siebel 8.0 Essentials


Module 23: Editing and Compiling Object Definitions

d. Click Start to rerun your validation. Were any errors listed in the errors list? Why or why
not?

e. Click Load to examine the original validation error message. Click Open to view the former
log file.
f. Click Options to reactivate the screen rule.
i. Select Rule 7.
ii. Click Enforce to reactivate the rule. Notice the Enforce column value changes to
Yes.
iii. Click OK.
g. Click Cancel to close the dialog box.
Note: Validating your work frequently is a recommended practice.

Siebel 8.0 Essentials 263


Module 23: Editing and Compiling Object Definitions

Solutions 23-1 Editing and Validating Object Definitions


(Guided)

Answers:
3.b. Double click the column header of the Name property to lock the Name column in place.
Scroll right and find the Thread Field property . Set the value to Asset Tag. Tab out of the
field. What happens?
The value you entered disappeared and a pick applet showing a list of available fields
appears. Because Tag Asset isn’t a value that appears in the drop-down list, and this field
doesn’t accept any such values, Siebel Tools disallows this entry.

4.b. Click the Inactive column in the OBLE (this will toggle the setting of a TRUE/FALSE
value). Aside from the checkmark, what visual indication appears?
The color of the text for this record changes to red.

5.b.i. Select the error listed and inspect the details listed in the Details box. Which rule number
was violated?
Rule number 7

5.c.ii. Which rule numbers are specific to View objects?


Rule numbers 3, 5, 6, 7, 10, 11, 97, 118

5.c.iii. Which two rules apply to all objects?


Rule numbers 1 and 61

5.d. Click Start to rerun your validation. Were any errors listed in the errors list? Why or why
not?
No errors were detected, because the relevant error check has been deactivated.

264 Siebel 8.0 Essentials


Module 23: Editing and Compiling Object Definitions

Lab 23-2 Exporting and Importing Object Definitions


(Unguided)

Goal To explore the use of the Diff and Archive options in Siebel Tools.

Time 10 - 15 minutes

Instructions:
In this lab you will walk through the following scenario:
You are unclear what changes you have made to the Asset Mgmt - Assets View object definition,
and you want to compare your local version to the version on the server. Having compared them,
you decide that you would like to keep the changes you have made to Asset Mgmt - Assets View.
However, the changes are not complete, so you do not want to check them in to the server yet. You
decide to use an archive file to save your version of the Asset Mgmt - Assets View object definition.
Later, you decide you want to delete your changes, but you cannot access the server. You decide to
import the original archive file that was created when you checked out the project.

1. Select Tools > Check In and select the Asset Management project. Use the Diff feature to
compare the object definitions you checked out, with those in the repository.

2. Add the Asset Mgmt - Assets View to an archive. Keep the archive window open.

3. Add the Asset Mgmt - Asset List Applet to the same archive and save it as myasset.sif.

4. Open myasset.sif using Notepad++ and examine the file. What does this file appear to contain?

5. Practice importing modified object definitions from an archive file. After further testing you
decide to start configuration again. You could check out the project again from the server, but
you are traveling and do not have access to the server. You decide to import the original archive
file that was created when you checked out the project.
a. Import the file Asset_Management.sif. This is the entire Asset Management project.
Replace the definitions in your repository.
b. Inspect the imported definition of View :: Asset Mgmt - Assets View and confirm that it is
back to its original form; that is, that it has a visibility applet specified.

6. Check in the original version of the project to release the local lock and the server lock.

Siebel 8.0 Essentials 265


Module 23: Editing and Compiling Object Definitions

Solutions 23-2 Exporting and Importing Object


Definitions (Unguided)

Answers:
4. Open myasset.sif using Notepad++ and examine the file. What does this file appear to
contain?
XML data with object definition information

266 Siebel 8.0 Essentials


Module 23: Editing and Compiling Object Definitions

Lab 23-2 Exporting and Importing Object Definitions


(Guided)

Goal To explore the use of the Diff and Archive options in Siebel Tools.

Time 10 - 15 minutes

Instructions:
In this lab you will walk through the following scenario:
You are unclear what changes you have made to the Asset Mgmt – Assets View object definition,
and you want to compare your local version to the version on the server. Having compared them,
you decide that you would like to keep the changes you have made to Asset Mgmt – Assets View.
However, the changes are not complete, so you do not want to check them in to the server yet. You
decide to use an archive file to save your version of the Asset Mgmt – Assets View object definition.
Later, you decide you want to delete your changes, but you cannot access the server. You decide to
import the original archive file that was created when you checked out the project.

1. You will start by using the Diff feature to compare the object definitions you checked out, stored
in an archive file, with those in the repository.
a. Select Tools > Check In. The Check In dialog box will appear.
b. Select Asset Management and click the button marked Diff…
Note: Diff uses the local archive file to assist with the comparison.
c. In the left-hand Compare Objects window, expand Asset Management. Notice how the
right-hand window mirrors this action.
d. Examine the folder icon next to each node in the tree. Blue indicates no difference between
server and local definitions of an object or type. Pink indicates a difference. What object
type is marked with pink in the tree?

e. Expand the View type.


f. Scroll through the list of views in the Asset Management project. Which view has a
definition in the local database that differs from its definition on the server?

g. Select Asset Mgmt – Assets View.


h. Inspect the differences listed in the Properties window in the lower part of the dialog box.
Are there any differences?

Siebel 8.0 Essentials 267


Module 23: Editing and Compiling Object Definitions

i. Click Close.
j. Click Cancel.

2. Now you will practice saving modified object definitions to an archive file.
a. Select View :: Asset Mgmt – Assets View.
b. Select Tools > Add to Archive. Do not close the Export to Archive File window. You will be
adding more objects to the archive, and closing the window creates the archive file. Move the
window out of your way if necessary by dragging and dropping it to the side of the OBLE.
What is the default name of the archive file?

c. Select Applet :: Asset Mgmt – Asset List Applet to select the second definition you wish to
include. You have not changed this definition, but this technique shows you how to include
multiple object definitions in a single archive file.
d. Right-click the Asset Mgmt – Asset List Applet record and select Add to Archive. What do
you observe?

e. In the Archive file field, change the name of the archive file to
D:\OUsea\Tools\objects\myasset.sif.
f. Click Save.

3. Verify the archive file was created in the directory.


a. In Windows Explorer, navigate to D:\OUsea\Tools\OBJECTS.
b. Verify that it contains a myasset.sif file.
c. Right-click the myasset.sif file and select Open.
d. Select Select the program from a list and click OK.
e. In the Open With dialog box, select Notepad++. Click OK.
f. Observe the structure of the file. Do not make any changes.
g. What does this file appear to contain?

h. When you are finished, close the WordPad application.

4. Now, you will practice importing modified object definitions from an archive file. After further
testing you decide to start configuration again. You could check out the project again from the
server, but you are traveling and do not have access to the server. You decide to import the
original archive file that was created when you checked out the project.
a. In Siebel Tools, select Tools > Import from Archive.

268 Siebel 8.0 Essentials


Module 23: Editing and Compiling Object Definitions

b. Navigate to the D:\OUsea\Tools\TEMP\Projects directory in the Select Archive to Import


window and select Asset_Management.sif.
c. Click Open.
d. Inspect the list. It displays all the object definitions that are part of the archive. This is the
entire Asset Management project.
e. Click the Overwrite the object definition in the repository radio button to replace the
definition in your repository.
Note: Notice that you could also merge the definition from the file with the changes you
made in your repository.
f. Click Next. You may need to wait a few moments while the contents of the wizard screen are
generated. Notice that the display you see is somewhat similar to the Diff window. Select and
then expand the objects in the left-hand window. What appears in the right-hand window?

g. Click Next. Notice the summary information that informs you what will be changed.
h. Click Yes to proceed. Notice that the OBLE disappears as the import archive operation
completes.
i. Click Finish to close the Import Wizard Summary window.

5. Inspect the imported definition.


a. Select View :: Asset Mgmt – Assets View.
b. What is the value of the Visibility Applet property?

6. Check in the original version of the project to release the local lock and the server lock.
a. Select Tools > Check In.
b. Select Asset Management. Make sure Maintain Lock is not checked.
c. Click Check In.

7. When you check in the local version of the project (called an archive file), it is deleted from the
TEMP directory.
a. Navigate to D:\OUsea\Tools\TEMP\Projects.
b. Are there any files in the directory? Do you think releasing the lock on the project makes a
difference?

Note: You will use these techniques throughout the configuration labs. You should get into
the habit of using the Diff option if you cannot remember what you changed.

Siebel 8.0 Essentials 269


Module 23: Editing and Compiling Object Definitions

Solutions 23-2 Exporting and Importing Object


Definitions (Guided)

Answers:
1.d. Examine the icon next to each node in the tree. Blue indicates no difference between
server and local definitions of an object or type. Pink indicates a difference. What object
type is marked with pink in the tree?
View – the folder icon next to this type has a pink diamond on it, unlike the folder icon for
other object types.

1.f. Scroll through the list of views in the Asset Management project. Which view has a
definition in the local database that differs from its definition on the server?
Asset Mgmt – Assets View

1.h. Inspect the differences listed in the Properties window. Are there any differences?
Yes – two differences. The client (local) version of the view has its Comment property
equal to the string you entered in the first part of this lab, and the server version has its
visibility applet property set.

2.b. Select Tools > Add to Archive. Do not close the Export to Archive File window. You will
be adding more objects to the archive, and closing the window will create the archive file..
Move the window out of your way if necessary by dragging and dropping it to the side of
the OBLE. What is the default name of the archive file?
D:\OUsea\Tools\objects\objects.sif

2.d. Right-click the Asset Mgmt – Asset List Applet record and select Add to Archive. What
do you observe?
The second object definition selected appears in the list of objects to archive.

3.g. What does this file appear to contain?


XML data with object definition information

4.f. Click Next. You may need to wait a few moments while the contents of the wizard screen
are generated. Notice that the display you see is somewhat similar to the Diff window.
Select and then expand the objects in the left-hand window. What appears in the right-hand
window?
When you select an object that has been modified, the differences between the file and the
repository attributes are displayed, as well as a proposed resolution to the conflict. This
resolution has a value of File or Repository, and can be set by right-clicking on the
Resolution column.

5.b. What is the value of the Visibility Applet property?


The value is now Asset Mgmt – Asset List Applet. In an earlier lab, you deleted this field
value. As a result of importing the archive file, the field value was overwritten.

270 Siebel 8.0 Essentials


Module 23: Editing and Compiling Object Definitions

7.b. Are there any files in the directory? Do you think releasing the lock on the project makes a
difference?
No, as the Maintain Lock is not checked. If the Maintain Lock is checked the file(s) will not
be removed as the lock indicates that further work will be done with the project.

Siebel 8.0 Essentials 271


Module 23: Editing and Compiling Object Definitions

272 Siebel 8.0 Essentials


Module 23: Editing and Compiling Object Definitions

Lab 23-3 Creating a Custom Repository File (Unguided)

Goal To create a custom.srf file, which you will use in the remaining configuration labs.

Time 45 minutes

Instructions:
1. It is generally recommended that you use Compile All Projects to create a brand new .srf file to
build your configuration upon. You would not need to do this until you wished to test your first
configuration change. However, you are doing so now in preparation for labs in the coming
modules.
a. In which directory should siebel.srf be located?

b. In Windows Explorer, navigate to D:\OUsea\client\OBJECTS\ENU and rename siebel.srf to


siebel_back.srf. This file will be a backup in case the compile fails.
c. You should still be logged in to Siebel Tools as PPENGUIN connected to the Local database.
Note: You might wish to resize your window so that it does not take up the whole desktop.
The window will be frozen after you start compiling.
i. Select Tools > Compile Projects.
ii. Click Browse. Click the directory drop-down to see the full directory structure. What
directory are you in?

iii. Navigate to the D:\OUsea\client\OBJECTS\ENU directory and enter siebel.srf.


iv. Click Save.
v. Select All Projects.
vi. Click Compile.
Note: This might take 20 minutes. Continue with the next steps.

2. Edit D:\OUsea\client\bin\ENU\uagent.cfg to modify the application title for the ABC Call
Center application that you will be creating, to use the appropriate ODBC connection, and to set
the connection string to point at the local database.
a. Open uagent.cfg with Notepad and set the following parameter:
Application Title ABC Call Center
b. Scroll down and find a line that starts with “LocalDbODBCDataSource”. Change the value
of this parameter from SEAW Local Db default instance to SSD Local Db default
instance. An ODBC data source stores information how to connect to a data source, and
includes parameters such as the database file location(s) and the executable to access the
database. The first ODBC data source, starting with SEAW, describes a database in the

Siebel 8.0 Essentials 273


Module 23: Editing and Compiling Object Definitions

client subdirectory. The second, starting with SSD, refers to a database in the tools
subdirectory. Because you first initialized the local database using Siebel Tools, the local
database file was created in D:\OUsea\tools\LOCAL. Because of its location in the tools
subdirectory, this data source is described by the SSD Local Db default instance.
c. Find the line that reads “[Local]”. Below this, change the ConnectString parameter to read:
D:\OUsea\tools\local\sse_data.dbf –q –m –x NONE –gp 4096 –c15p –ch25p
Note: You will probably only need to change the word “Client” to “Tools”. You are
changing this connect string to point to the local database (sse_data.dbf).
d. Set the DockConnString parameter to localhost.
e. Save the changes and exit the uagent.cfg file.

3. When the compile you started earlier is complete, verify your work.
a. Navigate to the D:\OUsea\Client\OBJECTS\ENU directory and verify the directory contains
siebel.srf with a recent Date Modified.
b. Select Start > Programs > Siebel Web Client 8.0 > Siebel Call Center – ENU and log in as
PPENGUIN/PPENGUIN to the Local database.
c. Select Help > Technical Support. Verify the parameters are as follows:
User ID PPENGUIN
ConnectString D:\OUsea\tools\local\sse_data.dbf –q –m –x NONE –gp
4096 –c15p –ch25p
Table Owner SIEBEL
Repository File D:\OUsea\client\objects\enu\siebel.srf

d. Exit the application.

4. You will now make some changes to Tools options to make modifying and testing your
application easier.
a. First you will set up Tools so that you can launch the Siebel Developer Web Client directly
from Siebel Tools.
i. From the application View menu, select Options > Debug, and then enter the values
in the table below. These parameters will be used to start up the modified Siebel Call
Center application directly from Siebel Tools.
IMPORTANT: Click the ellipsis buttons to locate the file names for CFG and
Browser.
Executable D:\OUsea\client\BIN\siebel.exe
CFG file D:\OUsea\client\BIN\ENU\uagent.cfg
Browser D:\Program Files\Internet Explorer\IEXPLORE.exe
Working directory D:\OUsea\client\BIN
Arguments /h
User name PPENGUIN
Password PPENGUIN
Data source Local
ii. Click OK.

274 Siebel 8.0 Essentials


Module 23: Editing and Compiling Object Definitions

b. Verify in Siebel Tools that you can modify Web templates using the Web Layout editor.
i. In the Target Browser field of the Configuration Context toolbar, select Target
Browser Config.
Note: If Target Browser Config does not appear in your toolbars, from the application
View menu, select Toolbars > Configuration Context and add it.
ii. In the Selected browsers: field, verify that IE 6.0 appears in the list. If it does not,
select IE 6.0 in the Available browsers: field and click the right-arrow to move IE
6.0 into the Selected Browsers field.
iii. Click OK.
iv. Select IE 6.0 in the Target Browser drop-down list.
c. Test your work.
i. Select Debug > Start (or press the F5 key on your keyboard).
ii. If the application does not start, check the values you typed above. If this does not
work, ask your instructor for assistance.
iii. Log out of Siebel Call Center.

Siebel 8.0 Essentials 275


Module 23: Editing and Compiling Object Definitions

Solutions 23-3 Creating a Custom Repository File


(Unguided)

Answers:
1.a. In which directory should siebel.srf be located?
D:\OUsea\client\OBJECTS\ENU. The .srf file should be in the OBJECTS\ENU
subdirectory of the directory where you install the Siebel client software.

1.c.ii. Click Browse. Click the directory drop-down to see the full directory structure. What
directory are you in?
D:\OUsea\tools\OBJECTS\ENU

276 Siebel 8.0 Essentials


Module 23: Editing and Compiling Object Definitions

Lab 23-3 Creating a Custom Repository File (Guided)

Goal To create a custom.srf file, which you will use in the remaining configuration labs.

Time 45 minutes

Instructions:
1. It is generally recommended that you use Compile All Projects to create a brand new .srf file to
build your configuration upon. You would not need to do this until you wished to test your first
configuration change. However, you are doing so now in preparation for labs in the coming
modules.
a. In which directory should siebel.srf be located?

b. In Windows Explorer, navigate to D:\OUsea\client\OBJECTS\ENU and rename siebel.srf to


siebel_back.srf. This file will be a backup in case the compile fails.
c. You should still be logged in to Siebel Tools as PPENGUIN connected to the Local database.
Note: You might wish to resize your window so that it does not take up the whole desktop.
The window will be frozen after you start compiling.
i. Select Tools > Compile Projects.
ii. Click Browse. Click the directory drop-down to see the full directory structure. What
directory are you in?

iii. Navigate to the D:\OUsea\client\OBJECTS\ENU directory and enter siebel.srf.


iv. Click Save.
v. Select All Projects.
vi. Click Compile.
Note: This might take 20 minutes. Continue with the next steps.

2. Edit D:\OUsea\client\bin\ENU\uagent.cfg to modify the application title for the ABC Call
Center application that you will be creating, to use the appropriate ODBC connection, and to set
the connection string to point at the local database.
a. Open uagent.cfg with Notepad and set the following parameter:
Application Title ABC Call Center
b. Scroll down and find a line that starts with “LocalDbODBCDataSource”. Change the value
of this parameter from SEAW Local Db default instance to SSD Local Db default
instance. An ODBC data source stores information how to connect to a data source, and
includes parameters such as the database file location(s) and the executable to access the
database. The first ODBC data source, starting with SEAW, describes a database in the

Siebel 8.0 Essentials 277


Module 23: Editing and Compiling Object Definitions

client subdirectory. The second, starting with SSD, refers to a database in the tools
subdirectory. Because you first initialized the local database using Siebel Tools, the local
database file was created in D:\OUsea\tools\LOCAL. Because of its location in the tools
subdirectory, this data source is described by the SSD Local Db default instance.
c. Find the line that reads “[Local]”. Below this, change the ConnectString parameter to read:
D:\OUsea\tools\local\sse_data.dbf –q –m –x NONE –gp 4096 –c15p –ch25p
Note: You will probably only need to change the word “Client” to “Tools”. You are
changing this connect string to point to the local database (sse_data.dbf).
d. Set the DockConnString parameter to localhost.
e. Save the changes and exit the uagent.cfg file.

3. When the compile you started earlier is complete, verify your work.
a. Navigate to the D:\OUsea\Client\OBJECTS\ENU directory and verify the directory contains
siebel.srf with a recent Date Modified.
b. Select Start > Programs > Siebel Web Client 8.0 > Siebel Call Center – ENU and log in as
PPENGUIN/PPENGUIN to the Local database.
c. Select Help > Technical Support. Verify the parameters are as follows:
User ID PPENGUIN
ConnectString D:\OUsea\tools\local\sse_data.dbf –q –m –x NONE –gp
4096 –c15p –ch25p
Table Owner SIEBEL
Repository File D:\OUsea\client\objects\enu\siebel.srf

d. Exit the application.

4. You will now make some changes to Tools options to make modifying and testing your
application easier.
a. First you will set up Tools so that you can launch the Siebel Developer Web Client directly
from Siebel Tools.
i. From the application View menu, select Options > Debug, and then enter the values
in the table below. These parameters will be used to start up the modified Siebel Call
Center application directly from Siebel Tools.
IMPORTANT: Click the ellipsis buttons to locate the file names for CFG and
Browser.
Executable D:\OUsea\client\BIN\siebel.exe
CFG file D:\OUsea\client\BIN\ENU\uagent.cfg
Browser D:\Program Files\Internet Explorer\IEXPLORE.exe
(or wherever you have IEXPLORE installed)
Working directory D:\OUsea\client\BIN
Arguments /h
User name PPENGUIN
Password PPENGUIN
Data source Local
ii. Click OK.

278 Siebel 8.0 Essentials


Module 23: Editing and Compiling Object Definitions

b. Verify in Siebel Tools that you can modify Web templates using the Web Layout editor.
i. In the Target Browser field of the Configuration Context toolbar, select Target
Browser Config…
Note: If Target Browser Config… does not appear in your toolbars, from the
application View menu, select Toolbars > Configuration Context and add it.
ii. In the Selected browsers: field, verify that IE 6.0 appears in the list. If it does not,
select IE 6.0 in the Available browsers: field and click the right-arrow to move IE
6.0 into the Selected Browsers field.
iii. Click OK.
iv. Select IE 6.0 in the Target Browser drop-down list.
c. Test your work.
i. Select Debug > Start (or press the F5 key on your keyboard).
ii. If the application does not start, check the values you typed above. If this does not
work, ask your instructor for assistance.
iii. Log out of Siebel Call Center.

Siebel 8.0 Essentials 279


Module 23: Editing and Compiling Object Definitions

Solutions 23-3 Creating a Custom Repository File


(Guided)

Answers:
1.a. In which directory should siebel.srf be located?
D:\OUsea\client\OBJECTS\ENU. The .srf file should be in the OBJECTS\ENU
subdirectory of the directory where you install the Siebel client software.

1.c.ii. Click Browse. Click the directory drop-down to see the full directory structure. What
directory are you in?
D:\OUsea\tools\OBJECTS\ENU

280 Siebel 8.0 Essentials


Module 24: UI Layer Configuration - Web Templates

Lab 24-1 Exploring Template Files (Unguided)

Goal To practice using the Web Template Explorer and to examine the relationship between
views and applets, and their associated templates.

Time 10 - 20 minutes

Instructions:
Due to the exploratory nature of this lab, there is no Unguided version of it. Please turn the page and
do the Guided version.

Siebel Essentials 8.0 281


Module 24: UI Layer Configuration - Web Templates

282 Siebel Essentials 8.0


Module 24: UI Layer Configuration - Web Templates

Lab 24-1 Exploring Template Files (Guided)

Goal To practice using the Web Template Explorer and to examine the relationship between
views and applets, and their associated templates.

Time 10 - 20 minutes

Instructions:
Siebel applications are specified by a set of physical UI files that determine how the logical UI will
be physically rendered in a browser. These files are not composed of object definitions and are the
main focus of this module. In this lab, you will use Tools to explore various template files.

1. In this step, you will practice using the Web Template Explorer to examine the contents of Web
template files. Web Template Explorer is a template browser that allows you to examine the
contents of template files without having to open them directly. It functions very similarly to the
OE and the OBLE. Templates are displayed in a parent / child relationship, with the child
template files available for viewing by clicking the parent file in the tree.
a. If necessary, start Siebel Tools and log in as PPENGUIN connecting to the Local database.
b. From the application-level menu, select View > Windows > Web Templates Window to view
the Web Template Explorer.
c. Scroll down until you locate CCPopupContainer. Select CCPopupContainer to display the
contents of the template file.
d. Examine the first line in the file. What is the full name of the template file?

e. What is the name of the first file that is included in this template file?

f. Expand CCPopupContainer by clicking the + (plus) sign. Expanding the CCPopupContainer


parent web template exposes all child template files included within the parent. How many
template files are included in the CCPopupContainer template file?

g. Click the child CCStylesChoice template. What did you observe in the pane that displays the
contents?

h. Close the Web Template File window and the Web Template Explorer.

Siebel Essentials 8.0 283


Module 24: UI Layer Configuration - Web Templates

2. In this step, you will examine how multiple views can use the same template.
a. Select the Flat tab in Object Explorer.
b. Select View Web Template.
c. Execute a query to select View Web Templates where Web Template property = View
Detail. This query displays all views that use the View Detail web template. When using Flat
Tab, the associated view appears under the Parent View property. About how many views
use this template (10; 100; 500 or more)? Depress the down arrow in the vertical scrollbar of
the OBLE until you are comfortable answering the question.

d. Click the Types tab to restore the Object Explorer to the hierarchical display mode.

3. In this step, you will examine how views map to templates and how applets in views map to
swe:applet tags in the corresponding template file. Web Template Item is a child object of the
applet. It defines mappings between controls and list columns to placeholder tags or locations in
the Web template file. They contain the name of a control or list column as well as an identifier
of a template placeholder. At run time, the placeholder determines the position of the control or
list column in the Web page. For more information, reference the Configuring Screens and
Views chapter in Configuring Siebel eBusiness Applications.
a. Select View :: Account List View | View Web Template :: Base. What is the name of the
Web Template associated with the Account List view?

b. Select View :: Account List View | View Web Template :: Base | View Web Template Item.
Which applets are listed and what is the corresponding Item Identifier?

c. Next, determine the file name for View Detail (Parent with Pointer). Select Web Template ::
View Detail (Parent with Pointer) | Web Template File. If you are querying for the template,
recall that you must bracket the object name with single quotes when the query includes
special characters, such as parentheses: ( ). What is the Filename of the Web Template File?
Ensure you write the name in the blank space provided, below. You will reference this later
in the lab.

4. In this step, you will explore the Item Identifier property. The Web Template Item property Item
Identifier specifies a unique numeric identifier for each control. The value is used in the markup
language tag that specifies the corresponding control in a template, binding the control to a
specific position on the page. It does not impose a hierarchy or priority of web template items.
a. Open the Web Template Explorer.
Tip: Select View > Windows > Web Templates Window to view the Web Template
Explorer.
b. Select the CCViewDetail_ParentPntr.swt template file.

284 Siebel Essentials 8.0


Module 24: UI Layer Configuration - Web Templates

c. Peruse the Main Content Area to locate the swe:applet tag with id=1. Look for the following:

Note the Item Identifier property in the View Web Template Items window. You may need to
re-position the template file window or navigate to Account List View | View Web Template
:: Base | View Web Template Item.
d. Compare the item identifier in the View Web Template Items window to the HTML
“Applet” id value. You can also view the HTML hintText value. In this case, its value is
“Parent Applet”. The diagram, below, illustrates the mapping.

e. Which applet is bound to Item Identifier 1?

f. Close the Web Template File window and the Web Template Explorer.

5. In this step, you will examine how applets map to templates and how controls in applets map to
swe:control tags in the corresponding template file. You will do this for the Contact Service
Request List Applet (eService), which has been configured for use in a standard interactivity
application.
a. Select Applet :: Contact Service Request List Applet (eService) | Applet Web Template.
b. View the Web Template property. What are the names of the Web Templates for the list
applet?

c. Next, you will observe individual Web templates and see how Controls map to Web
Template Item Identifiers.
i. Select Applet :: Contact Service Request List Applet (eService) | Applet Web
Template:: Query | Applet Web Template Item. Be sure to select Query in the Applet

Siebel Essentials 8.0 285


Module 24: UI Layer Configuration - Web Templates

Web Template window. Notice the number of web template items displayed and their
names.
ii. Compare Query mode to Edit Mode. Select Applet :: Contact Service Request List
Applet (eService) | Applet Web Template:: Edit | Applet Web Template Item. Notice
the number of web template items displayed and their names. How do web template
items vary when using query mode versus edit mode?

iii. Think about the level of user interaction when querying versus editing. Typically,
editing interactions are more involved. When comparing Query against Edit mode,
why are there differences in the controls that are rendered in the applet?

d. Now you will examine the template file used for query mode. Select Web Template ::
DotCom Applet Form 1-Column | Web Template File. It is the file used for both Edit and
Query modes for the Contact Service Request List Applet (eService). What is the Filename
of the Web template file?

6. In this step, you will identify which controls in the Web template map to the Item Identifier
property in Tools.
a. Open the Web Template Explorer.
b. Select the dCCAppletForm1Col template file. Note that this file includes additional
template files.
c. Expand the template file and click dCCForm1Col.
d. In the bottom window, scroll down to the first purple colored tag.
e. Locate the following swe for-each tag.

<swe:for-each count=”6” startValue=”1300” iteratorName=


”currentId”

286 Siebel Essentials 8.0


Module 24: UI Layer Configuration - Web Templates

f. This tag starts with an ID of 1300 and iterates six times, incrementing the ID value by one
each time. The screen print, below, displays the Applet Web Template Items for the DotCom
Applet Form 1-Column web template. Draw directly on the screen print, below, to indicate
which controls will be rendered by the SWE tag, above.

Siebel Essentials 8.0 287


Module 24: UI Layer Configuration - Web Templates

Solutions 24-1 Exploring Template Files (Guided)

Answers:
1.d. Examine the first line in the file. What is the full name of the template file?
CCPopupContainer.swt.

1.e. What is the name of the first file that is included in this template file?
CCStylesChoice.swt.

1.f. Expanding the CCPopupContainer parent web template exposes all child template files
included within the parent. How many template files are included in the
CCPopupContainer template file?
1, CCStylesChoice.swt.

1.g. Click the child CCStylesChoice template. What did you observe in the pane that displays
the contents?
The HTML code window displays both parent and child templates in a split view. The
upper pane displays the contents of the parent template file while the lower pane displays
the child template.

2.c. Execute a query to select View Web Templates where Web Template property = View
Detail. This query displays all views that use the View Detail web template. When using
Flat Tab, the associated view appears under the Parent View property. About how many
views use this template (10; 100; 500 or more)?
Over 500 views use the View Detail template.

3.a. Select View :: Account List View | View Web Template :: Base. What is the name of the
Web Template associated with the Account List view?
View Detail (Parent with Pointer).

3.b. Select View :: Account List View | View Web Template :: Base | View Web Template
Item. Which applets are listed and what is the corresponding Item Identifier?
Account List Applet (1) and Account Entry Applet (2).

3.c. Next, determine the file name for View Detail (Parent with Pointer). Select Web Template
:: View Detail (Parent with Pointer) | Web Template File. If you are querying for the
template, recall that you must bracket the object name with single quotes when the query
includes special characters, such as parentheses: ( ). What is the Filename of the Web
Template File?
CCViewDetail_ParentPntr.swt.

4.e. Which applet is bound to Item Identifier 1?


The Account List Applet (the parent applet in the Account List view) is bound to tag 1.

288 Siebel Essentials 8.0


Module 24: UI Layer Configuration - Web Templates

5.b. View the Web Template property. What are the names of the Web Templates for the list
applet?
DotCom Applet List Tabbed and DotCom Applet Form 1-Column

5.c.ii. Compare Query mode to Edit Mode. Select Applet :: Contact Service Request List Applet
(eService) | Applet Web Template:: Edit | Applet Web Template Item. Notice the number
of web template items displayed and their names. How do web template items vary when
using query mode versus edit mode?
The number and type of web template item varies depending on the mode. For example,
edit mode includes items not present with query mode, such as Cancel, HelpText, and
WriteRecord. Conversely, query mode includes items not present with edit mode, such as
CancelQuery and ExecuteQuery.

5.c.iii. Think about the level of user interaction when querying versus editing. Typically, editing
interactions are more involved. When comparing Query against Edit mode, why are there
differences in the controls that are rendered in the applet?
They are used in different contexts: one for querying and one for editing. In this case, more
fields are required when the applet is used for editing.

5.d. Now you will examine the template file used for query mode. Select Web Template ::
DotCom Applet Form 1-Column | Web Template File. It is the file used for both Edit and
Query modes for the Contact Service Request List Applet (eService). What is the Filename
of the Web template file?
dCCAppletForm1Col.swt.

Siebel Essentials 8.0 289


Module 24: UI Layer Configuration - Web Templates

6.f. This tag starts with an ID of 1300 and iterates six times, incrementing the ID value by one
each time. The screen print, below, displays the Applet Web Template Items for the
DotCom Applet Form 1-Column web template. Draw directly on the screen print, below, to
indicate which controls will be rendered by the SWE tag, above.

290 Siebel Essentials 8.0


Module 25: UI Layer Configuration - Applets

Lab 25-1 Modifying a Form Applet (Unguided)

Goal To modify a form applet by removing and adding controls.

Time 20 - 30 minutes

Instructions:
In this lab, you will update an applet to display a few changes that your business requires. To meet
some of your business requirements, you will remove the Manufactured Date field that appears on
the Asset Management – Asset Detail Applet. You will then add a Status field named “ABC Code”
to the applet.

1. Determine which applet you need to modify.


a. If necessary, start Siebel Tools and log in as PPENGUIN/PPENGUIN connecting to the
Local database.
b. Open Siebel Call Center using the Siebel Developer Web Client and log in as
PPENGUIN/PPENGUIN to the Local database.
c. Navigate to Assets > List.
d. Inspect the form applet for the manufactured date that will be removed from the display:

e. What is the name of the form applet in this view?

f. What is the name of the view?

Siebel 8.0 Essentials 291


Module 25: UI Layer Configuration - Applets

2. Perform the configurations necessary to be able to modify symbolic strings.


a. Verify that tools.cfg parameters are set to allow string creation. To be able to create symbolic
strings or string override fields, EnableToolsConstrain must be set to FALSE.
i. Use Notepad to open D:\OUSea\tools\bin\enu\tools.cfg and verify or set the
EnableToolsConstrain parameter.
b. Create and lock a new ABC Strings project to hold your symbolic string. There is an existing
Symbolic String project, but it is very large, so recommended practice is to create a new
project and store all new or modified strings in that project.
c. Expose the Symbolic String object type in the OE. Recall that the OE has the ability to
display many object types.
d. Create a new symbolic string that will be used to display the ABC status code. After you
have defined the string object once, you can reference it anywhere in the application. Any
change you wish to make to this string can be made a single time in Tools, and the resulting
change will appear wherever it is referenced in the application.
Note: The X_ prefix is automatically generated to differentiate new from existing strings.
Property Value
Name X_ASSET_CODE
Current String Value ABC Code

Project ABC Strings

3. Modify the Asset Mgmt - Asset Detail Applet to match the requirements detailed above.
a. Remove the Manufactured control and label from the applet.
b. In the Object Explorer, select Applet :: Asset Mgmt - Asset Detail Applet | Control :: Status
c. Change the Caption - String Reference property of the Status control to
X_ASSET_CODE. This will cause the Status Label to display the new ABC Code string.
Changing String Reference to X_ASSET_CODE also sets the Caption to the reference’s
associated string you created earlier, ABC Code. .
d. Add the Status text control to where the Manufactured text control previously appeared.

4. Use the Format menu to format the form applet.

5. Compile and check your work. Verify that the Status field is displayed in the form applet where
Manufactured previously appeared. It should look like this:

6. Log out of Siebel Call Center.

292 Siebel 8.0 Essentials


Module 25: UI Layer Configuration - Applets

Solutions 25-1 Modifying a Form Applet (Unguided)

Answers:
1.e. Select Help > About View. What is the name of the form applet in this view?
Asset Mgmt - Asset Detail Applet

1.f. What is the name of the view?


Asset Mgmt - Assets View

Siebel 8.0 Essentials 293


Module 25: UI Layer Configuration - Applets

294 Siebel 8.0 Essentials


Module 25: UI Layer Configuration - Applets

Lab 25-1 Modifying a Form Applet (Guided)

Goal To modify a form applet by removing and adding controls.

Time 20 – 30 minutes

Instructions:
In this lab, you will update an applet to display a few changes that your business requires. To meet
some of your business requirements, you will remove the Manufactured Date field that appears on
the Asset Management – Asset Detail Applet. You will then add a Status field named “ABC Code”
to the applet.

1. In this step, you will determine which applet you need to modify.
a. If necessary, start Siebel Tools and log in as PPENGUIN/PPENGUIN connecting to the
Local database.
b. Open Siebel Call Center using the Siebel Developer Web Client and log in as
PPENGUIN/PPENGUIN to the Local database. As an alternative, to quickly launch the
Developer Web Client from Tools, select Debug > Start or press F5.
c. Navigate to Assets > List.
d. Inspect the form applet for the manufactured date that will be removed from the display:

e. Select Help > About View. What is the name of the form applet in this view?

f. What is the name of the view?

g. Click OK to close the About View dialog box.

Siebel 8.0 Essentials 295


Module 25: UI Layer Configuration - Applets

2. In this step, you will verify tools.cfg parameters are set to allow string creation. To be able to
create symbolic strings or string override fields, EnableToolsConstrain must be set to FALSE.
This parameter determines the constrain mode. When set to TRUE, you must choose from a list
of string references in order to enter values for translatable text strings, such as an Applet Title,
and you cannot create new symbolic strings. When FALSE, you can override the string reference
using the string override property, and you can create new symbolic strings.
a. Log out and close Siebel Tools.
b. Use Notepad to open D:\OUSea\tools\bin\enu\tools.cfg.
c. Verify the following parameter under the [Siebel] section:
Parameter Value
EnableToolsConstrain = FALSE
d. If necessary, save any changes, then close tools.cfg.
e. Start Siebel Tools then log in as PPENGUIN/PPENGUIN to the Local database.

3. In this step, you will create a new project to hold your symbolic string. There is an existing
Symbolic String project, but it is very large. Due to its size, checking in or checking out the
entire project can be very time consuming. Thus, it is not recommended that you check out the
entire Symbolic String Project. Instead, create a new project and store all new or modified strings
in that project. When you want to add or work on new strings you can then use this new project.
a. In the Object Explorer, select Project.
b. Create a new record with the following values:
Property Value
Name ABC Strings
Locked True (Checked)

Note: You can use strings from the Siebel repository (denoted by the “SBL_” prefix in the
Symbolic String Name property) by selecting the strings you wish to modify and changing
their Project property to your new project.

4. In this step, you will expose the Symbolic String object type in the OE. Recall that the OE has
the ability to display many object types. To simplify usage, you can show or hide these types as a
group or individually.
a. From the Tools application-level menu, select View > Options.
b. Click the Object Explorer tab.
c. Click the checkbox next to the Symbolic String object. The checkbox should have a
checkmark with a white background. This will expose the Symbolic String object type and
its child object in the Object Explorer.
d. Click OK to return to Siebel Tools.

5. In this step, you will create a new symbolic string that will be used to display the ABC status
code. After you have defined the string object once, you can reference it anywhere in the
application. Any change you wish to make to this string can be made a single time in Tools, and
the resulting change will appear wherever it is referenced in the application.
a. In the OE, select Symbolic String.

296 Siebel 8.0 Essentials


Module 25: UI Layer Configuration - Applets

b. Click anywhere in the OBLE then enter CTRL+N to create a new record.
c. Set the properties for this new symbolic string object definition using values from the table,
below.
Property Value
Name X_ASSET_CODE
Current String Value ABC Code

Project ABC Strings

6. In this step, you will modify the Asset Mgmt - Asset Detail Applet.
a. Select Applet :: Asset Mgmt - Asset Detail Applet. Note that it is currently read-only. What
must be done to make this object definition editable?

b. To which project does the Asset Management – Asset Detail Applet belong?

c. Select Tools > Check Out.


d. Select Asset Management from the list.
e. Click Check Out. If Check Out is not available, you must disable object locking for the
project:
i. Start Siebel Tools and log in as SADMIN/SADMIN connecting to the Server
database.
ii. Select Project :: Asset Management.
iii. Right-click and select Toggle Allows Object Locking.
iv. Exit Siebel Tools.
f. Click OK.
Note: Instead of checking out an entire project, you could check out a single object, such as
the Asset Detail Applet. Checking out individual objects allows multiple developers to work
on objects within a single project, improves check-out and check-in times, and reduces
network traffic. However, there could be some additional management overhead in checking
out objects instead of projects (more items to track and keep synchronized across
developers). An administrator enables or disables Allow Object Locking on the project in
which the object resides. This feature is enabled by default. For more information, reference
Using Siebel Tools.
g. Select Applet :: Asset Mgmt - Asset Detail Applet. Right-click and select Edit Web Layout.
h. In the Controls/Columns window, ensure the Mode: field is set to 1: Edit. If not, set it now.
Applet modes determine how a given applet is rendered at run time. In this case, you want to
allow users to edit records, create new records, and query records in a form applet. Edit mode
enables this usage.
i. In the Controls/Columns window, increase the width of the Mapped column until it is
sufficiently wide to read. Note that fields have a Mapped value of Y or N (yes or no).
Mapped indicates whether a given control is mapped in the selected applet.
j. In the Controls/Columns window, ensure Show unmapped controls only has a checkmark.
Any given applet can incorporate the use of a large number of controls. You can limit the

Siebel 8.0 Essentials 297


Module 25: UI Layer Configuration - Applets

controls visible in the Controls / Columns window to display only those controls that are
unmapped in the currently selected applet.
k. At your discretion, you may choose to auto-hide the OE, Controls / Columns, and Palettes
windows in order to make more room for the Web Layout Editor.

7. In this step, you will remove the manufactured control and label from the applet.
a. In the Web Layout editor, select the Manufactured control:

b. Right-click and select Delete.


c. Select the Manufactured label.

d. Right-click and select Delete. Note that the Manufactured text control and label you just
removed from the applet now appear in the Controls / Columns window as an unmapped
control.
e. Select File > Save to save the applet.
f. Close the applet using File > Close.

8. In this step, you will edit the Status Label to show the caption ABC Code that was created
above.
a. In the Object Explorer, select Applet :: Asset Mgmt - Asset Detail Applet | Control :: Status
b. In the OBLE, change the property Caption – String Reference to X_ASSET_CODE. This
will cause the Status Label to display the new ABC Code string. Changing String Reference
to X_ASSET_CODE also sets the Caption to the reference’s associated string you created
earlier, ABC Code.

9. In this step, you will add a control to the form Applet.


a. In the OBLE, right-click the Asset Mgmt – Asset Detail Applet and select Edit Web Layout.
b. In the Controls/Column window, ensure mode is set to 1:Edit.
c. To provide enough space for the web layout editor to fully display in the viewable area, auto-
hide the Palette and Object Explorer windows.
d. In the Controls/Columns window, find the StatusLabel control. Drag and drop it onto the
form applet where the Manufactured label previously appeared. Note that the StatusLabel
control is now labeled “ABC Code:”.
e. In the Controls/Columns window, find the Status text control. Drag and drop it onto the form
applet where the Manufactured text control previously appeared. Note that the Status text
control now displays “ABC Code”.

10. In this step, you will format the form applet.


a. Hold down the Shift key and select the Status text control. Do not select the label.
b. Continue to hold the Shift key down, and select the Shipped text control. Both controls
should now be selected. When selecting multiple items, any format changes you make will
conform to the format of the last item selected. Ensure the Shipped text control was selected
last or the next steps in this lab will not work properly.

298 Siebel 8.0 Essentials


Module 25: UI Layer Configuration - Applets

c. Siebel Tools includes an application-level menu that allows you to perform a number of
formatting tasks. From the application-level menu, select Format > Make Same Size > Both.
This will make the Status text control the same size as Shipped.

d. Select Format > Align > Lefts. This will align the left edges of the controls so they appear in
a single column.
e. Click in the gray area of the applet to unselect all controls.
f. Select the Status text control (not the label).
g. Shift+click the Product control.
h. Select Format > Align > Bottoms. This will align the bottom edges of the controls so they
appear in a single row.
i. Click in the gray area of the applet to unselect all controls.
j. Repeat these steps for the labels that appear next to the text controls.
k. Close the Layout Editor. When prompted, ensure you save your changes.

11. Compile your work.


a. If necessary, navigate to Applet :: Asset Mgmt - Asset Detail Applet.
b. In the OBLE, right-click Asset Mgmt - Asset Detail Applet and select Compile Selected
Objects.
c. In the dialog box, ensure the path for the Siebel repository file is set to
D:\OUsea\client\OBJECTS\ENU\siebel.srf. For these labs, since you are working as a local
developer you will be compiling into D:\OUsea\client\OBJECTS\ENU\siebel.srf. When
compiling, Tools defaults to D:\OUsea\tools\OBJECTS\ENU\siebel.srf, which is also the srf
Tools runs against. Therefore, to avoid overwriting the SRF file used by Siebel Tools and
save the changes to the client application, you must compile to
D:\OUsea\client\OBJECTS\ENU\siebel.srf.
d. Check the box marked “Auto Start Web Client”.
e. Click Compile.

12. Check your work.


a. In the Siebel client, navigate to Assets > List.

Siebel 8.0 Essentials 299


Module 25: UI Layer Configuration - Applets

b. Verify that the Status field is displayed in the form applet where Manufactured previously
appeared. It should look like this:

13. Log out of Siebel Call Center.

300 Siebel 8.0 Essentials


Module 25: UI Layer Configuration - Applets

Solutions 25-1 Modifying a Form Applet (Guided)

Answers:
1.e. Select Help > About View. What is the name of the form applet in this view?
Asset Mgmt – Asset Detail Applet

1.f. What is the name of the view?


Asset Mgmt – Assets View

6.a Select Applet :: Asset Mgmt - Asset Detail Applet. Note that it is currently read-only. What
must be done to make this object definition editable?
Either the project or the object must be checked out.

6.b. To which project does the Asset Management – Asset Detail Applet belong?
Asset Management

Siebel 8.0 Essentials 301


Module 25: UI Layer Configuration - Applets

302 Siebel 8.0 Essentials


Module 25: UI Layer Configuration - Applets

Lab 25-2 Creating a List Applet (Unguided)

Goal To create a list applet.

Time 10 – 15 minutes

Instructions:
In this lab, you will create an applet to display some of the most important data about assets for use
by field service representatives.

1. Create a project to contain the new applets you will build for your application. You could use an
existing project for your applet, but we’ll create a new project for new items we create.
Property Value
Name ABC New Applets
Locked TRUE

2. Use the List Applet Wizard to create the ABC Asset Characteristics list applet.
a. In the General dialog box of the List Applet Wizard, set the properties to the values shown in
the table, below. To ensure field properties are set correctly, use dropdown lists to populate
fields, when available.
Property Value
Project ABC New Applets
Name ABC Asset Characteristics List Applet
Display Title Characteristics
Business Component Asset Mgmt – Asset
Upgrade Behavior Preserve
b. In the top list of the wizard, select the templates for Base and Edit List modes using the
values in the table, below.
Field Value
Template for Base read-only mode Applet List (Base/EditList)
Template for Edit List mode Applet List (Base/EditList)
Note: the Web Layout – General wizard screen lets you select among a variety of potential
web templates. To assist in selecting the most appropriate template for your display
requirements, consider doing the following: In the UI, find an existing applet with a layout
similar to the display you require, then use About View and Siebel Tools to find out which
template is used.

Siebel 8.0 Essentials 303


Module 25: UI Layer Configuration - Applets

c. In the bottom dialog box of the wizard, select the template for Edit mode:
Field Value
Template for Edit mode Applet List Edit (Edit/New/Query)
d. In the Web Layout – Fields dialog box of the wizard, add the fields that will be in the applet.
Sequence Field Name
1 Asset Number
2 Serial Number
3 Asset Description
4 Product Name
5 Product Part Number
6 Product Description
7 Status
e. Click Next to accept the defaults in the Web Layout – Fields dialog box.
f. Click Finish in the Finish dialog box.

3. Preview the wizard output.

4. Set up the Product Name field so that it enables the end-user to select from a list of available
products using the Asset Mgmt - Internal Product Pick Applet.

5. Validate the applet you created then compile your changes into the client .srf file. Can you view
the new customization in your application now? Why, or why not?

304 Siebel 8.0 Essentials


Module 25: UI Layer Configuration - Applets

Solutions 25-2 Creating a List Applet (Unguided)

Answers:
5.c. Can you view the new customization in your application now? Why, or why not?
No, because the applet has not been added to a view visible in the application.

Siebel 8.0 Essentials 305


Module 25: UI Layer Configuration - Applets

306 Siebel 8.0 Essentials


Module 25: UI Layer Configuration - Applets

Lab 25-2 Creating a List Applet (Guided)

Goal To create a list applet.

Time 10 - 15 minutes

Instructions:
In this lab, you will create an applet to display some of the most important data about assets for use
by field service representatives.

1. In this step, you will create a project to contain the new applets you will build for your
application. You could use an existing project for your applet, but we’ll create a new project for
new items we create. This way, applets associated with the existing project remain available to
other developers. Since locking the project ensures other developers cannot access it or any of its
objects, the Project then becomes available to the developer to make associations to it in other
settings, such as in Wizards, as you’ll see later in this lab.
a. If necessary, start Siebel Tools and log in as PPENGUIN/PPENGUIN connecting to the
Local database.
b. Select Project in the Object Explorer. Add a new project record with the following values:
Property Value
Name ABC New Applets
Locked TRUE
c. Why can you not check the project out?

2. In this step, you will use the List Applet Wizard to create the ABC Asset Characteristics list
applet. It is highly recommended you use wizards, where possible. In this example, the List
Applet Wizard helps you identify all the correct properties and automatically creates the list
applet; child objects, such as the Web Template and Web Template Items; the list; the list
column; and controls. The wizard also relates the applet to a business component. Alternatively,
you create applets manually by defining all the necessary properties and child objects.
a. To start the wizard, select File > New Object.
b. Click the Applets tab in the New Object Wizards dialog box.
c. Select List Applet.
d. Click OK.
e. In the General dialog box of the List Applet Wizard, set the properties to the values shown in
the table, below. To ensure field properties are set correctly, use dropdown lists to populate

Siebel 8.0 Essentials 307


Module 25: UI Layer Configuration - Applets

fields, when available. This prevents typographical errors. It also ensures any required hidden
characters or spaces are included.

When specifying the Project property, only locked projects will appear as an option in the
wizard. This is also true for the Project property in the OBLE on any applet. A project must
be locked before it can be related to an object. If the project is not locked, it won’t appear as
a selectable option in the project property in the OBLE.

Upgrade Behavior determines whether a UI object can be preserved during an upgrade. In


general, we set it to Preserve, which makes the object available for Incorporate Custom
Layout (ICL) when performing a repository merge. Upgrade Behavior is defined on screens,
views, and applets. At each release, Oracle sets the value of Upgrade Behavior for UI
objects. Do not change these values. For more information, reference Siebel Database
Upgrade Guide.
Property Value
Project ABC New Applets
Name ABC Asset Characteristics List Applet
Display Title Characteristics
Business Component Asset Mgmt – Asset
Upgrade Behavior Preserve
f. Click Next.
g. In the top list of the wizard, select the templates for Base and Edit List modes using the
values in the table, below. The wizard prompts you to select templates for three different
modes: Base (displays fields in read-only mode.), Edit List (allows users to edit records,
create new records, and query in a list applet), and Edit. Applet List (Base/EditList) is used
here for the first two modes since: 1), it most closely mirrors display requirements for your
application; 2), it combines both Base and Edit mode requirements. For additional
information about edit modes, reference Configuring Applets, Configuring Siebel eBusiness
Applications.
Field Value
Template for Base read-only mode Applet List (Base/EditList)
Template for Edit List mode Applet List (Base/EditList)
Note: the Web Layout – General wizard screen lets you select among a variety of potential
web templates. To assist in selecting the most appropriate template for your display
requirements, consider doing the following. In the UI, find an existing applet with a layout
similar to the display you require, then use About View and Siebel Tools to find out which
template is used. Another method to explore various template designs is to navigate to Select
Web Templates in the OE, click a familiar template name, right-click, and select View Web
Layout.

308 Siebel 8.0 Essentials


Module 25: UI Layer Configuration - Applets

h. In the bottom dialog box of the wizard, select the template for Edit mode:
Field Value
Template for Edit mode Applet List Edit (Edit/New/Query)
i. Click Next.
j. In the Web Layout – Fields dialog box of the wizard, add the fields that will be in the applet.
i. Select Asset Number in the Available Fields window.
ii. Click the right arrow to move this field to the Selected Fields window.
iii. Select Serial Number in the Available Fields window. When using a dialog box in
Tools that includes a long pick list, type the first letter of the object you seek into the
prompt box. This will place the active selection in close alphabetical proximity to the
field you seek. For example, click anywhere in the Available Fields window, then
type “S”. Scroll to select the field you seek.
iv. Click the right arrow to move this field to the Selected Fields window.
v. Repeat these steps to move the fields in the order listed in the table below from the
Available Fields to the Selected Fields window. This list represents the sequence in
which the fields will appear in the list applet in the user interface. Add these
individually to ensure proper display sequence.
Sequence Field Name
1 Asset Description
2 Product Name
3 Product Part Number
4 Product Description
5 Status
k. You should now have seven fields in the Selected Fields window, starting with Asset
Number and ending with Status. Click Next.
l. The Web Layout – Fields dialog box allows you to add controls to the applet. By default, all
controls have been selected for you. Click Next to accept the default.
m. In the Finish dialog box, click Finish. Siebel wizards often provide a Finish dialog that lists
your configuration settings. This dialog provides a quick way to verify your configuration
settings.

3. In this step, you will preview wizard output. Upon exiting the wizard, Tools will automatically
start the Web Layout Editor.
a. Right-click anywhere on the grid in the Web Layout Editor and select Preview to view a
close approximation of how the new applet will appear in the interface.
b. Right-click and deselect Preview to return to the Web Layout Editor’s edit mode.

Siebel 8.0 Essentials 309


Module 25: UI Layer Configuration - Applets

4. In this step, you will set up the Product Name field so that it enables the end-user to select from a
list of available products.
a. Select the Product Name list column in the Web Layout Editor.

i. If the Properties window is in auto-hide mode, reveal it now by rolling the mouse
over the Properties window tab on the far left side of the Tools interface. If the
Properties window is closed, right-click and select View Properties Window.
ii. In the Properties window, Set the Pick Applet property to Asset Mgmt - Internal
Product Pick Applet. In a later module, you will assign a pick applet to the Product
Name field. When the user selects a field with a pick applet, a dropdown list appears
and the user picks from this list of predefined items. The Pick Applet property you
specify here determines the applet to be used for that dropdown display.
iii. Ensure the Runtime property is set to True (checked). When you configure this
column with a pick applet in a later module, that applet will have a button tht is used
to invoke the pick applet. The Runtime property determines whether or not that
button is active at runtime.
b. Select File > Save to save your changes.
c. Close the Web Layout Editor.

5. In this step, you will validate the applet you created then compile your changes.
a. Validate your work.
i. In the OBLE, Select Applet :: ABC Asset Characteristics List Applet.
ii. Right-click the ABC Asset Characteristics List Applet and select Validate.
iii. Click Start to begin the validation process.
iv. Review the results. If the previous lab steps were followed correctly, the dialog will
display Total tests failed: 0.
v. Click Cancel to close the validation dialog.
b. Compile your changes.
i. Select Tools > Compile Projects.
ii. Make sure Selected Projects is selected.
iii. Ensure Auto-start web client is not selected.
iv. In the Projects window, select ABC New Applets.
v. Click Compile. You must specify an .srf file in which to compile. Local developers
should compile into an srf in the client\objects\enu directory. In this case, enu was set
during installation (enu for US English). This directory could change based on the
languages installed. For this lab, use OUsea\client\OBJECTS\ENU\siebel.srf.
c. Can you view the new customization in your application now? Why, or why not?

Note: You will create a view to display this applet in a later lab.

310 Siebel 8.0 Essentials


Module 25: UI Layer Configuration - Applets

Solutions 25-2 Creating a List Applet (Guided)

Answers:
1.c Why can you not check the project out?
When you create a new project on the local database, there is no project on the server to
check out.

5.c Can you view the new customization in your application now? Why, or why not?
No, because the applet has not been added to a view visible in the application.

Siebel 8.0 Essentials 311


Module 25: UI Layer Configuration - Applets

312 Siebel 8.0 Essentials


Module 26: UI Layer Configuration - Applications, Screens, and Views

Lab 26-1 Creating a View (Unguided)

Goals To create a view with several applets.

Time 25 - 30 minutes

Instructions:
In the previous lab you created list applets that will display service-oriented data about customer
assets. Now, you need to create a view to display these applets. They will be displayed as children,
and an existing account form applet will act as the parent. You will then add the view to a screen.
You will implement the following:

1. Create the ABC New Views project. You may have noticed that, in these labs, you frequently
create new projects. This is done for several reasons. It reduces the amount of time required to
check in and check out. If you used one big project for all your development work, the time
required to complete check in and check out would increase. It also provides a way to minimize
the number of objects locked on the server, freeing up those resources so other developers can
work on them.
Property Value
Name ABC New Views
Locked TRUE

Siebel 8.0 Essentials 313


Module 26: UI Layer Configuration - Applications, Screens, and Views

2. Create the ABC Account Asset View.


a. In the New View dialog, specify the following:
Property Value
Project ABC New Views
Name ABC Account Asset View
Title ABC Account Asset View
Business Object Account
Upgrade Behavior Preserve
b. Associate the view with the View Detail (Parent with Pointer) Web template.
c. In the Web Layout - Applets dialog, add the Account Form Applet and ABC Asset
Characteristics List Applet. The Account Form Applet will allow end users to enter data,
and the ABC Asset Characteristics List Applet will allow users to view an asset list.
d. Preview the view. It should look similar to this:

3. Make the child applet by changing its Applet Mode property to Edit List. Edit List mode renders
list applets as persistently editable.

4. Add the view to the Accounts Screen. Type and Parent Category together determine where the
screen view appears in the user interface. Recall that there are four types of views:

Detail View is the only view that allows users to interact directly with data. All other views are
groups or categories of views and appear as tabs, links or in drop-down lists. Since the part of the
application you are working on requires data entry, Detail View is used.

Parent Category allows you to specify which view is the parent. For example, when you drill
down on a record in the Account List aggregate category, it displays a detail form applet and

314 Siebel 8.0 Essentials


Module 26: UI Layer Configuration - Applications, Screens, and Views

detail categories that appear below the form applet on the tab bar. These detail categories are
child categories of the parent, Account List.

Add a new screen view to the Account Screen with the values shown in the table, below. When
specifying either the Menu Text - String Reference or the Viewbar Text - String Reference,
locate Assets in the pop-up dialog then click Pick. At that point, the property should populate
with a direct reference to the string, such as SBL_ASSETS-1004224605-1C1.
Property Value
View ABC Account Asset View
Type Detail View
Parent Category Account List
Menu Text – String Reference Assets
Viewbar Text – String Reference Assets

5. Compile your changes to the Accounts Screen to the client .srf.

6. Administer the view in the application. You must specify the correct view exactly as it appears in
Tools and then add it to one or more responsibilities. In this case, add it to the ABC Developer
responsibility.

7. Verify you can see the ABC Account Asset View in the application.

Siebel 8.0 Essentials 315


Module 26: UI Layer Configuration - Applications, Screens, and Views

316 Siebel 8.0 Essentials


Module 26: UI Layer Configuration - Applications, Screens, and Views

Lab 26-1 Creating a View (Guided)

Goals To create a view with several applets.

Time 25 - 30 minutes

Instructions:
In the previous lab you created list applets that will display service-oriented data about customer
assets. Now, you need to create a view to display these applets. They will be displayed as children,
and an existing account form applet will act as the parent. You will then add the view to a screen.
You will implement the following:

1. In this step, you will create the ABC New Views project. You may have noticed that, in these
labs, you frequently create new projects. This is done for several reasons. It reduces the amount
of time required to Check in and Check out. If you used one big project for all your development
work, the time required to complete Check In and Check Out would increase. It also provides a
way to minimize the number of objects locked on the server, freeing up those resources so other
developers can work on them.
a. If necessary, start Siebel Tools and log in as PPENGUIN/PPENGUIN connecting to the
Local database.
b. In the Object Explorer, select Project.
c. Add a new project with the following values:
Property Value
Name ABC New Views
Locked TRUE

Siebel 8.0 Essentials 317


Module 26: UI Layer Configuration - Applications, Screens, and Views

2. In this step, you will create the ABC Account Asset View. Recall that a view is a collection of
applets that present data referenced from one, and only one, business object. Views can contain
lists, forms, charts, and other types of applets. The applets in the view reference business
components in the business object.
a. Use the View wizard to create a new view. Select File > New Object.
b. Under the General Tab, select View.
c. Click OK.
d. In the New View dialog, specify the following:
Property Value
Project ABC New Views
Name ABC Account Asset View
Title ABC Account Asset View
Business Object Account
Upgrade Behavior Preserve
e. Click Next.
f. Associate the view with a Web template. This makes the web template available to the view,
which can then be used to specify data display. In the View Web Layout - Select Template
dialog, specify the following:
Property Value
Web Template View Detail (Parent with Pointer)
g. Click Next.
h. In the Web Layout - Applets dialog, add the applets to the view that are listed in the table,
below. The Account Form Applet will allow end users to enter data, and the ABC Asset
Characteristics List Applet will allow users to view an asset list. Note the slight delay that
occurs immediately before this dialog is displayed. This is due to the fact that the business
object you selected in the wizard in a previous dialog box influences the applets displayed.
The business object should have the master business component that matches the top or
driving applet in the view.
Property Value
Applet Account Form Applet
Applet ABC Asset Characteristics List Applet
i. Click Next.
j. Click Finish. The wizard will create the view object definition and its child objects. It will
also open the Web Layout Editor with the parent and child applets already added to the web
template. The first applet you specify in the wizard is placed in the parent position on the
template. Subsequent applets are placed in subordinate positions, such as Child Applet.

318 Siebel 8.0 Essentials


Module 26: UI Layer Configuration - Applications, Screens, and Views

3. In this step, you will verify wizard output. In a typical development environment it is not
necessary to verify wizard output. You are doing so here to gain a full understanding of the tasks
the wizard performs.
a. Navigate to the ABC Account Asset View object definition. Select View :: ABC Account
Asset View, or use the navigation tabs to toggle between the Web Layout Editor and the
OBLE:

Toggle

b. In the OBLE, verify the business object property is Account. When you created the ABC
Account Asset View you associated it to the Account business object.
c. Navigate to View :: ABC Account Asset View | View Web Template :: Base | View Web
Template Item. Verify Account Form Applet and ABC Asset Characteristics List Applet
have been added as web template items.
d. Toggle back to the Web layout editor via the Tools navigation tab.
e. Click the form applet in the Web Layout Editor. It will be activated, as indicated by a blue
outline around the form applet.
f. Right-click in the activated applet and select View Properties Window. Verify, via the
properties window, that the Applet property is Account Form Applet.

Siebel 8.0 Essentials 319


Module 26: UI Layer Configuration - Applications, Screens, and Views

g. Verify the form applet is in the parent position on the template, above the list applet.
Temporarily drag and drop the form applet to the empty top placeholder. The Parent Applet
placeholder should become exposed, as shown below.

Form applet temporarily moved up to


expose Parent Applet placeholder

h. Move the form applet back into the Parent Applet position.
i. Click the list applet and verify the Applet property is ABC Asset Characteristics List Applet.
j. Verify the list applet is in the Child Applet position on the web template by temporarily
moving it to a vacant placeholder, in similar fashion as you did with the form applet.
k. Right-click anywhere in the layout editor and select Preview. It should look similar to this:

l. Right-click anywhere in the layout editor and select Preview again to close Preview.

4. In this step, you will make the child applet editable. In the scenario for this lab, the child applet is
used to allow data entry into the record, such as asset number, serial number, and so forth. Since
the default Applet Mode property is set to Base when the applet is created, it must be changed to
allow editing.
a. In the Web Layout Editor, click the ABC Asset Characteristics List Applet.

320 Siebel 8.0 Essentials


Module 26: UI Layer Configuration - Applications, Screens, and Views

b. Note how the applet is represented in the layout editor. It displays list columns that cannot be
edited.
c. In the Properties window, note that Applet Mode is set to Base.
d. In the Properties window, Set the Applet Mode property to Edit List. Note how the
appearance of the list applet in the layout editor changes: list columns are now represented as
editable. Edit List mode renders list applets as persistently editable. The purpose of an
editable list applet is to allow users to modify the records in a list applet without switching to
an edit page.
e. Close the edit window. Save changes when prompted.

5. In this step, you will add the view to a screen. Type and Parent Category together determine
where the screen view appears in the user interface. Recall that there are four types of views:

Detail View is the only view that allows users to interact directly with data. All other views are
groups or categories of views and appear as tabs, links or in drop-down lists. Since the part of the
application you are working on requires data entry, Detail View is used.

Parent Category allows you to specify which view is the parent. For example, when you drill
down on a record in the Account List aggregate category, it displays a detail form applet and
detail categories that appear below the form applet on the tab bar. These detail categories are
child categories of the parent, Account List.

a. Check out the Account (SSE) project.


b. Select Screen :: Accounts Screen | Screen View.
Add a new screen view with the values shown in the table, below. When specifying either the
Menu Text - String Reference or the Viewbar Text - String Reference, locate Assets in the
pop-up dialog then click Pick. At that point, the property should populate with a direct
reference to the string, such as SBL_ASSETS-1004224605-1C1.
Property Value
View ABC Account Asset View
Type Detail View
Parent Category Account List
Menu Text – String Reference Assets
Viewbar Text – String Reference Assets
c. In the Screens window in the OBLE, right-click Accounts Screen and select Edit Screen
View Sequence
d. Position the view.
i. Click Detail View - ABC Account Asset View to select it (about the fourth item
down).

Siebel 8.0 Essentials 321


Module 26: UI Layer Configuration - Applications, Screens, and Views

ii. Right-click the same view, then notice that the view is currently in the highest
Position. This would cause the View to appear at the far left of the Viewbar in the
Accounts screen. You will move the View so it appears between Contacts and ESP in
the Viewbar tab.
iii. Select Move to Next Lower Position. Notice that the View moves down in sequence.
iv. Use the keyboard shortcut Ctrl+Down (the Control key and the Down arrow key).
Notice that the View moves down in sequence again.
v. Repeat until the new view appears directly below the Detail View - Account Detail –
Contacts View and directly above the Detail Category – ESP.
e. Save your changes.
f. Close the editor.
g. Right-click anywhere in the Screen Views window in the OBLE.
h. Sort on the Sequence property in ascending order.
i. Note that ABC Account Asset View appears before Detail Category – ESP, and after
Account Detail – Contacts View.

6. Compile your changes to the Accounts Screen.


a. From the application-level menu, select Tools > Compile Projects.
b. Select Locked Projects.
c. Ensure Auto-start web client is enabled.
d. Click Compile.

7. In this step, you will administer the view. You must specify the correct view exactly as it appears
in Tools. Otherwise, it will not be recognized in your application. One way to ensure the correct
view is specified is to copy the view name from Tools then paste it into the proper field in your
application’s Administration screen. This procedure is detailed, below.
a. Copy the view name.
i. Return to Siebel Tools.
ii. Select View :: ABC Account Asset View.
iii. In the OBLE, tab into the Name property.
iv. Press Ctrl+C to copy it to the clipboard.
v. Return to Siebel Call Center.
b. Add the view.
i. Navigate to Administration – Application > Views.
ii. Click New.
iii. In the View Name field, press Ctrl+V to paste the view name ABC Account Asset
View.
iv. In the Description field, enter “Used to display service data about customer assets”
v. Ensure Default Local Access flag is checked. Each view and each responsibility has
a Local Access flag. Together, these settings determine whether views can be
accessed by Mobile Web Client users. The setting of the Local Access flag does not
affect access to a view for users using either the Siebel Web Client or Siebel
Developer Web Client connecting to the Server database. When Local Access is
checked, all users with the view in one of their responsibilities can access the view
when using the Siebel Mobile Web Client (connected to the Local database). When

322 Siebel 8.0 Essentials


Module 26: UI Layer Configuration - Applications, Screens, and Views

Local Access is unchecked, users cannot access the view when using Mobile Web
Client.
c. Assign responsibilities to the new view. Recall that, in order for a view to be visible to a
given user, the user’s responsibility must be assigned to the view.
i. In the Responsibilities list applet (toward the bottom of the page), click the New
button.
ii. Select the ABC Developer responsibility and click OK.
iii. Navigate to Administration – Application > Responsibilities.
iv. Select the ABC Developer responsibility in the Responsibilities list applet.
v. In the Views applet, verify that ABC Account Asset View appears.
vi. Click Clear Cache.

8. In this step, you will verify you can see the ABC Account Asset View.
a. Log out of Siebel Call Center. You must close and re-open the application to allow the cache
to refresh.
b. Start the Developer Web Client from within Tools.
c. Navigate to Accounts > Accounts List.
d. Verify the Asset view tab is visible.
i. If there are no account records in the list, create a new record now.
ii. Drill down on a record in the Account Name field of the Accounts list applet.
iii. There should be an Assets tab. Click it.
iv. Use Help > About View to verify the view is ABC Account Asset View and the
applet is the ABC Asset Characteristics List Applet.
v. Click OK to close About View.
vi. Create a new record in the ABC Asset Characteristics List Applet.
vii. Confirm your new view appears as expected. It should look similar to the screen
print, below.

Siebel 8.0 Essentials 323


Module 26: UI Layer Configuration - Applications, Screens, and Views

324 Siebel 8.0 Essentials


Module 27: UI Layer Configuration - Drilldowns

Lab 27-1 Configuring Drilldowns (Unguided)

Goal To configure drilldowns and the thread bar.

Time 25 - 30 minutes

Instructions:
In your custom application, your users have a need to drill down on a service request number to see
the Service Request Related SR View, and drill down on the product name in the ABC Account
Asset Characteristics List Applet to see the product. In this lab you will configure object definitions
to enable this desired drilldown behavior.
First, you will configure a drilldown so that clicking the service request number field (in certain
views) will display the Service Request Related SR View for that service request. Then you will
configure a drilldown in the ABC Asset Characteristics List Applet so that drilling down on the
product name hyperlink field will display the Product Detail Key Features View.

1. In Siebel Tools, modify the drilldown object definition of the Service Request List Applet to
enable drilling down on SR # to get to the Service Request Related SR View and compile the
project. Verify your results in the application by drilling down on an SR # and confirming that
you are navigated to the Service Request Related SR View. Compare your view against the
screen print, below:

Siebel 8.0 Essentials 325


Module 27: UI Layer Configuration - Drilldowns

2. Use Siebel Call Center to identify the view used when drilling down on the Product field of the
asset list.
a. What applet is used to display the asset list?

b. Drill down on the Product field of an asset record in the list. What view appears?

3. Gather the information required to configure the ABC Asset Characteristics List Applet so that
users can drill down on the Product Name field in the applet in order to see product details. This
drilldown involves going from an asset record to a product record and requires additional
configuration. This is because you are drilling down to a different business component than were
you started. Enter the information you gather into the diagram below.
a. Use Siebel Tools to determine the name of the drilldown object used to drill down on the
Product field of the Asset Mgmt - Asset List Applet.

b. Identify the source business component from which you are drilling down and enter it into
the diagram.
c. Identify the destination business component to which you are drilling and enter it into the
diagram.
d. Identify the source field that serves as the foreign key field to the destination business
component and enter it into the diagram.
e. Identify the destination field that serves as the primary key field and enter it into the diagram.
Recall that the Id field is used by default when a field is blank

Source Business Component:

Source Field:

FK PK

Destination Business Component:

Destination Field:

4. Use the diagram above to configure a new drilldown on the ABC Asset Characteristics List
Applet that allows users to drill down on the Product to get to the Product Detail Key Features
View.

5. Compile the ABC Asset Characteristics List Applet.

326 Siebel 8.0 Essentials


Module 27: UI Layer Configuration - Drilldowns

6. Enable the ABC Account Asset View to support the thread bar using the properties shown
below:
Property Value
Thread Applet Account Form Applet
Thread Field Name
Thread Title – String Reference Account

7. Compile the ABC Account Asset View.

8. Add the Product Detail Key Features View to the ABC Developer responsibility and test your
drilldown and your thread bar. They should look similar to the screen shots below:

Drilling down should take you to this view:

Siebel 8.0 Essentials 327


Module 27: UI Layer Configuration - Drilldowns

Solutions 27-1 Configuring Drilldowns (Unguided)

Answers:
2.a. What applet is used to display the asset list?
Asset Mgmt - Asset List Applet

2.b. Drill down on the Product field of an asset record in the list. What view appears?
Product Detail Key Features View

3.a. Use Siebel Tools to determine the name of the drilldown object used to drill down on the
Product field of the Asset Mgmt - Asset List Applet.
ProductToProductKeyFeatures.

4.

328 Siebel 8.0 Essentials


Module 27: UI Layer Configuration - Drilldowns

Lab 27-1 Configuring Drilldowns (Guided)

Goal To configure drilldowns and the thread bar.

Time 25 - 30 minutes

Instructions:
In your custom application, your users have a need to drill down on a service request number to see
the Service Request Related SR View, and drill down on the product name in the ABC Account
Asset Characteristics List Applet to see the product. In this lab you will configure object definitions
to enable this desired drilldown behavior.
First, you will configure a drilldown so that clicking the service request number field (in certain
views) will display the Service Request Related SR View for that service request. Then you will
configure a drilldown in the ABC Asset Characteristics List Applet so that drilling down on the
product name hyperlink field will display the Product Detail Key Features View.

1. In this step, you will begin by examining the drilldown behavior in the standard Siebel
application. As you complete the step, notice the differences between the Service Request Detail
View and the Service Request Related SR View. The first view you access will display the
standard list applet on top with its related detail form applet below. The second view displays the
detail form applet on top with detail categories below. You will modify this behavior in this lab
so that the user drills down to the Service Request Related SR View.
a. In your application, navigate to Service Requests > Service Request List.
b. If necessary, add a service request record.
c. Drill down on SR #. What view does it take you to?

d. From the Site Map, navigate to Service Requests > Service Request List > Related SRs.
Which view appears?

e. Log out of your application.

Siebel 8.0 Essentials 329


Module 27: UI Layer Configuration - Drilldowns

2. In this step, you will modify the drilldown object definitions to enable drilling down from the
Service Request List Applet to the Service Request Related SR View.
a. In Siebel Tools, select Applet :: Service Request List Applet | Drilldown Object. Scan the
Hyperlink Field property for a value of SR Number. Which view is listed for the SR
Number? Select the record without (SCW) in the View field.

b. What project must be checked out to modify the Service Request List Applet?

c. Check out the project.


d. Modify the view to reflect the new drilldown.
i. Select Applets: Service Request List Applet | Drilldown Object :: Original.
ii. Change the View property to Service Request Related SR View.
e. Compile the Service Request List Applet.
i. Right-click the Service Request List Applet and select Compile Selected Objects.
ii. Click Service Request List Applet in the window of the Object Compiler dialog box.
iii. Click Compile. Ensure Auto-start web client is enabled.
f. In Siebel Call Center, navigate to Service > Service Request List.
i. Drill down on an SR #.
ii. Do you see the Service Request Related SR View? To verify, compare your view
against the screen print, below.

g. Log out of Siebel Call Center.

330 Siebel 8.0 Essentials


Module 27: UI Layer Configuration - Drilldowns

3. In this step, you will identify the view used when drilling down on the asset list.
a. Open Siebel Call Center using the Siebel Developer Web Client and log in as
SADMIN/SADMIN connecting to the Sample database.
b. Navigate to Assets > List.
c. What applet is used to display the list?

d. Drill down on the Product field of an asset record in the list. What view appears?

e. Log out of the Call Center application.

4. In this step, you will gather the information required to configure the ABC Asset
Characteristics List Applet so that users can drill down on the Product Name field in the applet
in order to see product details. This drilldown involves going from an asset record to a product
record and requires additional configuration. This is because you are drilling down to a different
business component than were you started. Enter the information you gather into this diagram:

Source Business Component:

Source Field:

FK PK

Destination Business Component:

Destination Field:
a. In Tools, select Applet :: Asset Mgmt - Asset List Applet | List :: List | List Column.
b. In the Display Name property, query for Product. This is the list column that contains the
drilldown object you just used in the client. Note that the value in the Field property is
Product Name, which is the business component field the list column references.
c. Select Applet :: Asset Mgmt - Asset List Applet | Drilldown Object.
d. Query the Hyperlink Field property for Product Name. The query should return a drilldown
object whose name property is ProductToProductKeyFeatures.
e. Identify the source business component from which you are drilling down. It is displayed in
the Business Component property of the Asset Mgmt - Asset List Applet. Enter it into the
diagram.
f. Identify the destination business component to which you are drilling. It is displayed in the
Business Component property of the ProductToProductKeyFeatures drilldown object. Enter
it into the diagram.
g. Identify the source field that serves as the foreign key field to the destination business
component. It is displayed in the Source Field property of the ProductToProductKeyFeatures
drilldown object. Enter it into the diagram.

Siebel 8.0 Essentials 331


Module 27: UI Layer Configuration - Drilldowns

h. Identify the destination field that serves as the primary key field. It is displayed in the
Destination Field property of the ProductToProductKeyFeatures drilldown object. Recall that
the Id field is used by default when a field is blank

5. In this step, you will configure the drilldown. Note that the information you entered in the
diagram, above, is used to configure the properties represented in the table, below.
a. Select Applet :: ABC Asset Characteristics List Applet | Drilldown Object.
b. Add a new drilldown object definition using the property values in the table, below.
Hyperlink Field specifies the list column or control that has hyperlink capabilities. View
specifies the destination view when the hyperlink is clicked. Sequence specifies the order in
which drilldown objects are activated when using dynamic drilldowns. In this case, we assign
1 since there are no other drilldown object definitions for this applet. For additional
information, reference About Drilldowns, Configuring Siebel Business Applications.
Property Value
Name Product
Hyperlink Field Product Name
View Product Detail Key Features View
Source Field Product Id
Business Component Internal Product
Sequence 1
c. Compile the ABC Asset Characteristics List Applet. In the compile dialog, ensure the Auto-
start web client box is not checked.

6. In this step, you will enable the ABC Account Asset View to support the thread bar, which
assists user navigation among views.
a. Select View :: ABC Account Asset View.
b. Set the properties as shown in the table, below. The Thread Applet property specifies which
of the applets appearing in the view will supply data for the thread field. Thread Field is the
name of the field whose data is included in the arrow box, following Thread Title. Thread
Field is in the business component related to the applet identified via Thread Applet. Thread
Title is the text used in the thread to identify the view. To select the Thread Title value
shown in the table, enter Account into the Starting with window in the pop-up pick list.
Then select the first record in the list.
Property Value
Thread Applet Account Form Applet
Thread Field Name
Thread Title – String Reference Account (Select the first one in the list.)

7. Compile the ABC Account Asset View. In the compile dialog, ensure Auto-start web client is
checked.

332 Siebel 8.0 Essentials


Module 27: UI Layer Configuration - Drilldowns

8. In this step, you will add the Product Detail Key Features View to the ABC Developer
responsibility.
a. Navigate to Administration – Application > Responsibilities.
b. Add the Product Detail Key Features View to the ABC Developer responsibility to ensure
PPENGUIN can see this view when testing the application.
c. Ensure the Local Access flag is checked.
d. Click Clear Cache.
e. Close the Call Center application.

9. Test your work.


a. Start your application from within Tools.
b. In your application, navigate to Accounts > Accounts List.
c. Create an Account record.
d. Drill down on Account Name.
e. Click the Assets view tab.
f. Create an asset record.
i. Select the Product Name field.
ii. Click the MVG button.
iii. Click the Go button.
iv. Click the OK button to select the first record in the list.
v. Step off the record to save it.
g. Is the Product Name field hyperlinked? To verify, compare your view against the screen
print, below. It should look similar. If the Product Name field appears but values in the field
are not hyperlinked, ensure you added Product Detail Key Features View to Penguin’s
responsibility.

Siebel 8.0 Essentials 333


Module 27: UI Layer Configuration - Drilldowns

i. Drill down on the product name.


ii. Do you see the Product Detail Key Features View? Your view should look similar to
the screen print, below.

h. Log out of Siebel Call Center.

334 Siebel 8.0 Essentials


Module 27: UI Layer Configuration - Drilldowns

Solutions 27-1 Configuring Drilldowns (Guided)

Answers:
1.c. Drill down on SR #. What view does it take you to?
Service Request Detail View

1.d. From the Site Map, navigate to Service Requests > Service Request List > Related SRs.
Which view appears?
Service Request Related SR View

2.a. In Siebel Tools, select Applet :: Service Request List Applet | Drilldown Object. Scan the
Hyperlink Field property for a value of SR Number. Which view is listed for the SR
Number? Select the record without (SCW) in the View field.
Service Request Detail View

2.b. What project must be checked out to modify the Service Request List Applet?
The Service (SSV) project. Service Request Related SR View is the view you need to relate
to the SR Number Hyperlink Field. By navigating to the view’s object definition via the
Object Explorer, you can see that this view’s project property is set to Service (SSV).

3.c. What applet is used to display the list?


Asset Mgmt - Asset List Applet

3.d. Drill down on the Product field of an asset record in the list. What view appears?
Product Detail Key Features View

4.

Siebel 8.0 Essentials 335


Module 27: UI Layer Configuration - Drilldowns

336 Siebel 8.0 Essentials


Module 28: Business Layer Configuration - Joins

Lab 28-1 Examine Existing Joins (Unguided)

Goals To examine existing joins in a business component.

Time 15 - 25 minutes

Instructions:
In this lab you will examine references between fields and columns in the base and joined tables.
This exercise will assist you in understanding how joins are structured.

In this lab you will examine references between fields and columns in the base and joined tables.
This exercise will assist you in understanding how joins are structured.

1. Examine how the Commit Time single value field object definition in the Service Request
business component references a database table and column when a join is not present. Use
Siebel Tools to complete the following diagram, including the business component, field, base
table, and column:

Siebel 8.0 Essentials 337


Module 28: Business Layer Configuration - Joins

2. Examine how the Account single value field object definition in the Service Request business
component maps to database tables and columns when a join is present. Use Siebel Tools to
complete the following diagram, including the business component, field, base table, joined
table, primary key, foreign key, and column. Do not forget to examine the join and join
specification object definitions to help you complete your work.

338 Siebel 8.0 Essentials


Module 28: Business Layer Configuration - Joins

3. Examine several fields for the Service Request business component. This activity provides
practice in mapping the column and table referenced by a business component. Complete the
following table for the Service Request business component.
Service Request Business Component
Field Join Column Table
Contact Last Name

Owner

Resolution Code

Serial Number

Status

Siebel 8.0 Essentials 339


Module 28: Business Layer Configuration - Joins

Solutions 28-1 Examine Existing Joins (Unguided)

Answers:
1.

2.

340 Siebel 8.0 Essentials


Module 28: Business Layer Configuration - Joins

3.
Service Request Business Component
Field Join Column Table
Contact Last Name S_CONTACT LAST_NAME S_CONTACT
Owner Owner-S_USER LOGIN S_USER
Resolution Code RESOLUTION_CD S_SRV_REQ
Serial Number S_ASSET SERIAL_NUM S_ASSET
Status SR_STAT_ID S_SRV_REQ

Siebel 8.0 Essentials 341


Module 28: Business Layer Configuration - Joins

342 Siebel 8.0 Essentials


Module 28: Business Layer Configuration - Joins

Lab 28-1 Examine Existing Joins (Guided)

Goals To examine existing joins in a business component.

Time 15 - 25 minutes

Instructions:
In this lab you will examine references between fields and columns in the base and joined tables.
This exercise will assist you in understanding how joins are structured.

1. In this step, you will examine how a Single Value Field object definition in the Service Request
business component references a database table and column when a join is not present. For each
question in this step, enter your response into this diagram:

Siebel 8.0 Essentials 343


Module 28: Business Layer Configuration - Joins

a. In Siebel Tools, Select Business Component :: Service Request.


b. Recall that the Table property for the business component displays the base table. Enter the
business component name and its base table into the diagram.
c. Select Business Component :: Service Request | Single Value Field :: Commit Time.
d. Enter the field name into the diagram.
e. Enter the value of the column property into the base table in the diagram. As indicated in the
diagram, note that this field references a single column in the base table. What is the value of
the Join property?

f. What does a null Join property tell you about the database table that contains the column?

g. Verify EXP_CLOSE_DT references the base table in the diagram you just completed, above.
Select Table :: S_SRV_REQ | Column :: EXP_CLOSE_DT. Does such a column exist in the
S_SRV_REQ table?

344 Siebel 8.0 Essentials


Module 28: Business Layer Configuration - Joins

2. In this step, you will examine how a Single Value Field object definition in the Service Request
business component maps to database tables and columns when a join is present. For each
question, enter your response into this diagram:

a. Select Business Component :: Service Request.


b. Enter the business component name and base table name.
c. Select Business Component :: Service Request | Single Value Field :: Account.
i. Enter the field name into the diagram.
ii. Enter the joined table name into the diagram. The value displayed in the Join property
is the joined table name. When a join property is not null, its value specifies the
joined table.
iii. Enter the joined table column name that contains the data. The value of the Column
property for the Single Value Field displays the joined table column name that
contains data to be brought into this business component.

Siebel 8.0 Essentials 345


Module 28: Business Layer Configuration - Joins

d. Determine the name of the column in the base table that serves as the foreign key to the
joined table.
i. Select Business Component :: Service Request | Join.
ii. Query for the record in which the Alias is S_ORG_EXT.
iii. In the OE, select Join Specification.
iv. What is the value of the Source Field?

e. Determine the Column that the Source Field references.


i. Select Business Component :: Service Request | Single Value Field :: Account Id.
ii. What is the value of the Join property?

iii. What is the value of the Column property?

iv. Enter the name of the Column into the base table’s FK column in the diagram.
f. Determine the name of the column in the joined table that serves as the primary key.
i. Select Table :: S_ORG_EXT | Column.
ii. Query for Primary Key = TRUE.
iii. In the diagram, enter the name of the primary key column into the joined table’s PK
column. Recall that most Siebel tables use ROW_ID as their primary key.

3. In this step, you will examine several fields for the Service Request business component. This
activity provides practice in mapping the column and table referenced by a business component.
Since the join property may or may not have a value, you will gain exposure in mapping fields
that either reference the base table or a joined table.
a. Select Business Component :: Service Request | Single Value Field.
b. Use Columns Displayed to arrange the SVF join and column properties into the immediately
viewable area of the OBLE.
c. Bookmark the SVF window.
d. Query for the field, then enter the values for the join and column properties.
e. Drill down on the join hyperlink to determine the table property.
f. Use the bookmark to return to the SVF window.

346 Siebel 8.0 Essentials


Module 28: Business Layer Configuration - Joins

g. Fill in the table with your observations for each field.


Service Request Business Component
Field Join Column Table
Contact Last
Name

Owner

Resolution
Code

Serial Number

Status

Siebel 8.0 Essentials 347


Module 28: Business Layer Configuration - Joins

Solutions 28-1 Examine Existing Joins (Guided)

Answers:
1.

1.e. Enter the value of the column property into the base table in the diagram. As indicated in
the diagram, note that this field references a single column in the base table. What is the
value of the Join property?
It is blank.

1.f. What does a null Join property tell you about the database table that contains the column?
A blank Join property indicates that the column maps to the base table (S_SRV_REQ).
Since the column references directly to the base table, there is no need for a join.

1.g. Does such a column exist in the S_SRV_REQ table?


EXP_CLOSE_DT column does exist in S_SRV_REQ table. Commit time does indeed
reference a column in the base table.

348 Siebel 8.0 Essentials


Module 28: Business Layer Configuration - Joins

2.

2.d.iv. What is the value of the Source Field?


Account Id.

2.e.ii. What is the value of the Join property?


Blank. The field is blank because the Account Id field references a column in the base table
(S_SRV_REQ) of the Service Request business component.

2.e.iii. What is the value of the Column property?


CST_OU_ID.

3.g. Fill in the table with your observations for each field.
Service Request Business Component
Field Join Column Table
Contact Last Name S_CONTACT LAST_NAME S_CONTACT
Owner Owner-S_USER LOGIN S_USER
Resolution Code RESOLUTION_CD S_SRV_REQ
Serial Number S_ASSET SERIAL_NUM S_ASSET
Status SR_STAT_ID S_SRV_REQ

Siebel 8.0 Essentials 349


Module 28: Business Layer Configuration - Joins

350 Siebel 8.0 Essentials


Module 28: Business Layer Configuration - Joins

Lab 28-2 Adding a Joined Field to a Business


Component (Unguided)

Goals To add fields from a related table to an existing business component.

Time 35 - 45 minutes

Instructions:
Your application has a requirement to display the original order number for a piece of equipment
and, if available, the purchase order number given by the customer who purchased or leased it. To
make this possible, you will need to add fields to the Asset Mgmt - Asset business component to
capture these numbers.

A colleague has determined that the business component where this information is stored in the
Order Entry - Orders business component, and the underlying table is S_ORDER. In addition, she
has determined that the column containing the original order number is ORDER_NUM, and the
column containing the customer’s purchase order number is ACCNT_ORDER_NUM. She used the
same technique you used in previous labs to identify table columns at the data layer that supply data
for controls at the UI layer.

In the remainder of this lab you will construct Join and Join Specification object definitions that
allow you to create new fields in the Asset Mgmt - Asset business component that reference columns
in the S_ORDER table. You will then create Original Order Number and Customer PO Number
fields in the Asset Mgmt - Asset business component. Finally you will expose these new fields on
the Asset Mgmt - Asset Detail Applet (no title) applet.

1. Examine the existing Join definitions of the Asset Mgmt business component to see if the
required join already exists. In order to display the original order number and the purchase order
number, the business component must establish a join between S_ASSET (the base table for the
Asset Mgmt - Asset business component) and S_ORDER (the table that contains the purchase
order number).

Siebel 8.0 Essentials 351


Module 28: Business Layer Configuration - Joins

2. Since there is no existing Join to S_ORDER, you will need to construct the appropriate Join
Definition and Join Specification. Complete the following diagram with your join requirements,
including the business component, base table, joined table, primary key, and foreign key.
Examine the base table to find the foreign key column to the joined table.

3. Inspect the business component to determine if it has a field that maps to the foreign key column.
The join specification uses the name of the foreign key field in the business component that
references the foreign key column. When you configure a join specification you will need to
create the foreign key field if it does not already exist.

4. Complete the diagram by entering the name of the foreign key field into the diagram. Optionally,
add the columns in the joined table that you will be accessing.

5. Create the join definition to add the joined table to the Asset Mgmt - Asset business component.
Set the alias to Order Information and the Outer Join Flag to True.

6. Create the join specification. It identifies the foreign key field in the business component and the
primary key column in the joined table the foreign key points to.

352 Siebel 8.0 Essentials


Module 28: Business Layer Configuration - Joins

7. Create a new field that references the order number column from the joined table. Recall that the
required column is ORDER_NUM. Set the Name property to Original Order Number. This
property is used in the business component to display the order number. Recall that our scenario
requires display of both the original order and the customer’s purchase order number.

8. Create a new field that references the customer purchase order column from the joined table.
Recall that the required column is ACCNT_ORDER_NUM. Set the Name property to Customer
PO Number.

9. Compile the Asset Mgmt - Asset business component.

10. Display these new fields in the ABC Asset Characteristics List Applet by adding them as two
list columns with the properties shown below. Do not forget to add them to the applet Web
templates.
Property Value
Name Original Order Number
Field Original Order Number
Display Name – String Override Original Order #

Property Value
Name Customer PO Number
Field Customer PO Number
Display Name – String Override Customer PO #

11. Compile the ABC Asset Characteristics List Applet.

12. Verify your work. Make sure that the new fields, Original Order # and Customer PO #, appear in
the ABC Asset Characteristics List Applet with their proper display names. Your view should
look like something like this:

New Fields From


Joined Table

Siebel 8.0 Essentials 353


Module 28: Business Layer Configuration - Joins

Solutions 28-2 Adding a Joined Field to a Business


Component (Unguided)

Answers:
2.

354 Siebel 8.0 Essentials


Module 28: Business Layer Configuration - Joins

Lab 28-2 Adding a Joined Field to a Business


Component (Guided)

Goals To add fields from a related table to an existing business component.

Time 35 - 45 minutes

Instructions:
Your application has a requirement to display the original order number for a piece of equipment
and, if available, the purchase order number given by the customer who purchased or leased it. To
make this possible, you will need to add fields to the Asset Mgmt – Asset business component to
capture these numbers.

A colleague has determined that the business component where this information is stored in the
Order Entry - Orders business component, and the underlying table is S_ORDER. In addition, she
has determined that the column containing the original order number is ORDER_NUM, and the
column containing the customer’s purchase order number is ACCNT_ORDER_NUM. She used the
same technique you used in previous labs to identify table columns at the data layer that supply data
for controls at the UI layer.

In the remainder of this lab you will construct Join and Join Specification object definitions that
allow you to create new fields in the Asset Mgmt – Asset business component that reference
columns in the S_ORDER table. You will then create Original Order Number and Customer PO
Number fields in the Asset Mgmt – Asset business component. Finally you will expose these new
fields on the Asset Mgmt – Asset Detail Applet (no title) applet.

1. In this step, you will examine the existing Join definitions to see if the required join already
exists. In order to display the original order number and the purchase order number, the business
component must establish a join between S_ASSET (the base table for the Asset Mgmt – Asset
business component) and S_ORDER (the table that contains the purchase order number). If such
a join exists, S_ORDER will display in the Table property.
a. Select Business Component :: Asset Mgmt - Asset | Join.
b. Inspect the Table property. Is there a join defined for the S_ORDER table?

Siebel 8.0 Essentials 355


Module 28: Business Layer Configuration - Joins

2. Since there is no existing Join to S_ORDER, you will need to construct the appropriate Join
Definition and Join Specification. Use the diagram, below, to record your answers in this section
of the lab. The diagram is provided as a learning tool. If you encounter difficulties during this lab
you should, at your discretion, feel free to view the solutions section for assistance.

a. Identify the base table name for the Asset Mgmt – Asset business component. View the
business component’s Table property. Enter it into the diagram.
b. The join definition specifies the joined table. Enter the name of the joined table into the
diagram. It is the table your colleague identified as containing the required data.
Tip: Refer to the introduction for an explanation of what your colleague is looking for.

356 Siebel 8.0 Essentials


Module 28: Business Layer Configuration - Joins

3. In this step, you will determine the names of the columns that serve as foreign key and primary
keys. The join specification specifies the foreign key(s) used to retrieve the relevant record(s)
from the joined table.
a. Determine the name of the column in the base table that serves as the foreign key to the
joined table.
i. Drilldown on the table property for the Asset Mgmt – Asset business component
(S_ASSET) in the OBLE.
ii. Select Table :: S_ASSET | Column.
iii. Query the Foreign Key Table property for S_ORDER. Due to your colleague’s work,
you know S_ORDER contains the required information. Querying for S_ORDER in
the Foreign Key Table property returns all columns in S_ASSET that are foreign keys
which map to S_ORDER.
iv. Enter the name of the column into the base table’s FK column in the diagram.
b. Determine the name of the column in the joined table that serves as the primary key.
i. Select Table :: S_ORDER | Column.
ii. Query the Primary Key property for TRUE (checked).
iii. Enter the name of the primary key column into the joined table’s PK column in the
diagram.

4. In this step, you will inspect the business component to determine if it has the required foreign
key field. The join specification uses the name of the foreign key field in the business component
that references the foreign key column of ORIG_ORDER_ID. When you configure a join
specification you will need to create the foreign key field if it does not already exist.
a. Select Business Component :: Asset Mgmt – Asset | Single Value Field.
b. Check to see if there is an existing reference. Query the Column property for
ORIG_ORDER_ID.
c. Since there is an existing reference between the ORIG_ORDER_ID column and a business
component field, you do not need to add a new single value field. Instead, complete your
diagram by entering the name of the single value field into the diagram. Next, you can refer
to this diagram when creating the join in Tools.

5. In this step, you will create a join definition to add the joined table to the Asset Mgmt - Asset
business component. Note that the join definition specifies the joined table from which to
retrieve data. The join specification, covered in the next step, specifies how to retrieve the related
row from the joined table based on the foreign and primary keys used to relate the base and
joined tables.
a. Select Business Component :: Asset Mgmt - Asset | Join.
b. Add a join definition object definition.
i. Create a new join definition.
ii. Set the Table property to S_ORDER.
iii. Set the Alias property to Order Information. The alias makes it possible for a
business component to have more than one join with the same destination table. In the
example here, you could have an additional join that brings in, say, tax amount data
for this order. Therefore, it is important that the Alias property be distinct even

Siebel 8.0 Essentials 357


Module 28: Business Layer Configuration - Joins

though the destination table is the same.

Important: It is usually not a good practice to use the table name as the Alias name,
even though this is common in the standard repository. This is because implicit joins
will use the table name as the Alias to make sure that the explicit join name is not
used instead. To make sure that no conflict exists, you should always give the join a
distinct and custom alias name.

iv. Set the Outer Join Flag property to True (checked).


v. Set the Comments property to Join to bring Order Information into Asset Mgmt -
Asset BC. Entering information in Comments is optional. Thoroughly documenting
your work can simplify application creation, maintenance, and troubleshooting.

6. In this step, you will create the join specification. It identifies the foreign key field in the
business component and the primary key column in the joined table the foreign key points to.
a. Select Business Component :: Asset Mgmt - Asset | Join :: Order Information | Join
Specification.
b. Add a new join specification object definition.
i. Set the Name property to Original Order Id. Note that you can assign any random
string to the Name field. To assist application creation, choose a name that reflects the
nature of the join. Since this specification is bringing original order ID data into the
business component, that is the name we give it here.
ii. Set the Destination Column property to ROW_ID. Destination Column identifies the
primary key column in the joined table.
iii. Set the Source Field property to Original Order Id.
c. What would happen at run time if you added the join, but forgot to add the join specification?

7. In this step, you will create a new field that references the order number column from the joined
table. At this point you have created a join between S_ASSET and S_ORDER, and you are ready
to add fields to the Asset Mgmt - Asset business component that reference columns which
contain data in S_ORDER, the joined table.

You know from your colleague’s work that the column containing the original order number is
ORDER_NUM, and the column containing the customer’s purchase order number is
ACCNT_ORDER_NUM.
a. Enter ORDER_NUM into the diagram in the joined table next to ROW_ID.
b. Enter ACCNT_ORDER_NUM into the diagram in the joined table in the next available
column.
c. Select Business Component :: Asset Mgmt - Asset | Single Value Field.
d. Add a new single value field object definition.
i. Set the Name property to Original Order Number. This property is used in the
business component to display the order number.

358 Siebel 8.0 Essentials


Module 28: Business Layer Configuration - Joins

ii. Set the Join property to Order Information, which is the name of the join you just
created.
iii. Set the Column property to ORDER_NUM, which is the name of the column in
S_ORDER that contains the order number information you need to display in the UI.
The columns made available to you in the pop-up list are all from S_ORDER (the
joined table).
iv. Verify the Type property is DTYPE_TEXT.
e. Why must you set the Join property before you set the Column property?

8. In this step, you will create a new field that references the customer purchase order column from
the joined table. Recall that our scenario requires display of both the original order and the
customer’s purchase order number.
a. Add a new Single Value Field to the Asset Mgmt - Asset business component. Set the
following properties:
Property Value
Name Customer PO Number
Join Order Information
Column ACCNT_ORDER_NUM
Type DTYPE_TEXT

b. Compile the Asset Mgmt - Asset business component. Ensure Auto-start web client is not
checked.

9. In this step, you will display these new fields in the ABC Asset Characteristics List Applet.
(Recall that in an earlier lab, you created this applet).
a. Add list columns to the applet.
i. Select Applet :: ABC Asset Characteristics List Applet | List :: List | List Column.
ii. Add a new list column object definition.

Siebel 8.0 Essentials 359


Module 28: Business Layer Configuration - Joins

iii. Set properties to the values in the table, below. The Name property can be any
descriptive text. For Display Name, consider the many strings that already exist in the
repository. Using existing strings can reduce maintenance efforts. Before creating a
string override, query the Display Name – String Reference property to determine if
the desired string exists. If a string reference does not exist, you will have to use the
Display Name – String Override property and create a string override. Notice that
when you enter a value into the String Override property, the property’s value is
duplicated in the Display Name property immediately upon tabbing out of the
override property or stepping off the record.
Property Value
Name Original Order Number
Field Original Order Number
Display Name – String Override Original Order #
iv. Add a second list column object definition.
v. Set the following properties:
Property Value
Name Customer PO Number
Field Customer PO Number
Display Name – String Override Customer PO #

10. In this step, you will add the columns to the applet template.
a. Select Applet :: ABC Asset Characteristics List Applet.
b. Right-click and select Edit Web Layout.
c. Verify the Mode: field in the Web Controls toolbar is 1: Base. To simplify navigation, auto-
hide the Palette and Object Explorer windows.
d. Drag and drop the Original Order # field from the Control / Columns window to an
available field in the applet. To view an available field, scroll-right in the Web Template
Layout Editor window. You will see a series of available fields that look like this:

e. Repeat this step for the Customer PO # field.


f. Preview the applet. Verify that the fields appear where you put them.
g. Deselect Preview (right-click then deselect the preview option).
h. In the Mode: field of the Web Controls toolbar, select 2: Edit.
i. Drag and drop the Original Order # field from the Control/Columns window to an available
field in the applet. The FormSection field immediately below the existing controls will
suffice. Available fields in Edit mode have this appearance:

360 Siebel 8.0 Essentials


Module 28: Business Layer Configuration - Joins

j. Drag and drop the Customer PO # field from the Control/Columns window to an available
field in the applet.
k. Preview the applet. Verify that the fields appear where you put them. After you have
reviewed the applet, close the preview mode.
l. Deselect Preview.
m. In the Mode: field of the Web Controls toolbar, select 3: Edit List.
n. Drag and drop the Original Order # field from the Control / Columns window to an
available field in the applet.
o. Drag and drop the Customer PO # field from the Control / Columns window to an available
field in the applet.
p. Preview the applet. Verify that the fields appear where you put them.
q. Close the Web Layout editor. Click Yes to save changes.
r. Compile the ABC Asset Characteristics List Applet. Ensure auto-start is enabled.

11. Test your work.


a. In the application, navigate to Accounts > Accounts List > Assets.
b. Verify that the new fields, Original Order # and Customer PO #, appear in the ABC Asset
Characteristics List Applet with their proper display names. Your view should look like
something like this:

New Fields From


Joined Table

c. Log out of the Siebel Call Center.

Siebel 8.0 Essentials 361


Module 28: Business Layer Configuration - Joins

Solutions 28-2 Adding a Joined Field to a Business


Component (Guided)

Answers:
1.b. Inspect the Table property. Is there a join defined for the S_ORDER table?
No.

2. Since there is no existing Join to S_ORDER, you will need to construct the appropriate
Join Definition and Join Specification. Use the diagram, below, to record your answers in
this section of the lab.

6.c. What would happen at run time if you added the join, but forgot to add the join
specification?
The application would use a default join specification of ROW_ID = ROW_ID. Since row
IDs are unique, the resulting query would return no records.

7.e. Why must you set the Join property before you set the Column property?
If the Join property is blank, the columns available on the Column property are base table
columns (in this case, S_ASSET). The ORDER_NUM column is located on S_ORDER, not
S_ASSET. In order to get the pop-up list to display the correct columns, you must first
specify the join so that the pop-up list is populated with S_ORDER columns Try an
experiment: change the value in the join property to another value, then notice how values
in the column property change.

362 Siebel 8.0 Essentials


Module 29: Business Layer Configuration - Existing Business Components and Fields

Lab 29-1 Configuring Properties of Fields and Business


Components (Unguided)

Goal To configure field and business component properties.

Time 15 - 25 minutes

Instructions:
In this lab, you will incorporate additional business logic into your application by configuring
several properties in field and business component object definitions. You will observe how
validation properties can be used to prevent unwanted data from being entered into the database.
You will see how default values for data can be specified and how user properties can be set to
incorporate business logic into the application.

As a result of your work in this lab:


• Users should not be able to enter a negative value for the original cost of an asset
• The Source of new Service Requests should default to Phone
• When an owner is assigned to an asset, the sub-status should be changed to Assigned.

1. Add a validation to the Original Cost field of the Asset Mgmt - Asset business component so
that negative values cannot be entered into the database and compile the Asset Mgmt - Asset
business component.

2. Use a Post Default Value to ensure that the Source field of the Service Request business
component defaults to Phone. Right now, your application only accepts new service requests
over the phone. As such, setting phone as the default value will enable call center agents to take
service requests over the phone more quickly by reducing the amount of data entry. If your
application accepted new service requests over the Web or other channels, the call center agent
would have to ensure the source was set appropriately. Using Post Default Value ensures the
value you specify, such as Phone, will be populated after the user saves the record only if the
user has not entered a value.

3. Expose the Business Component User Prop object type in the Object Explorer.

4. Configure an “On Field Update Set n” user property on the business component. You would like
the application to change the SR Sub-Status to Assigned when an SR Owner is assigned. You
will accomplish this by configuring a user property.
a. Add a new user property to the Service Request business component. Set the Name property
to On Field Update Set 5. This user property allows you to set the value of a field in the
business component when another field is updated. When there is more than one instance of
this user property, each instance is executed sequentially by number (for example, On Field

Siebel 8.0 Essentials 363


Module 29: Business Layer Configuration - Existing Business Components and Fields

Update Set 1, then On Field Update Set 2, and so forth). You used Set 5 because there are
already several other instances of this user property in the Service Request business
component.
b. Set the Value property to “Owned By Id”, “Sub-Status”, “Assigned”. Pay careful attention
to the spaces between the words, the use of double quotes, and the hyphen in Sub-Status. The
value of this user property consists of three quoted parameters separated by a comma and a
space: the field to check (in this case Owned By Id), the field to set (in this case Sub-Status),
and the value to assign to that field (in this case Assigned). At run-time, Sub-Status is set to
Assigned when Owned By Id is updated. For additional information about user properties,
consult Siebel Developer’s Reference.
c. Compile the Service Request business component.

5. Test your changes.


a. Create or modify an asset record and enter a negative number in the Original Cost field to
confirm that your validation works correctly. If you do not see the Original Cost field in the
list applet, use Columns Displayed to display it.
b. Create a new service request record, tab into the owner field and delete the value there. Do
not tab out of the field nor step off the record.
i. What value appears in the Source field in the form applet?

ii. What are the current values of the Owner and Substatus fields?

iii. In the Owner field, click the Select button and select PPENGUIN as the new Owner
for the Service Request. Now what are the values of the Owner and Substatus fields?
Why?

iv. Save the record. What is the new value of the Source field? Why?

6. For an additional challenge, set validation for the Email Address field in the Contact business
component so that the email address entered must contain an “at” sign (@) and a period (.). You
can also check that the user enters at least one character for each of the text strings that surround
the @ sign and two characters after the period (.). Compile and test the customization in your
application.

364 Siebel 8.0 Essentials


Module 29: Business Layer Configuration - Existing Business Components and Fields

Solutions 29-1 Configuring Properties of Fields and


Business Components (Unguided)

Answers
5.b.i. What value appears in the Source field in the form applet?
No value. It is empty.

5.b.ii. What are the current values of the Owner and Substatus fields?
The Owner field is set to the login ID for the current user, PPENGUIN if logged in as Pat
Penguin, and the Substatus is Unassigned.

5.b.iii. In the Owner field, click the Select button and select PPENGUIN as the new Owner for
the Service Request. Now what are the values of the Owner and Substatus fields? Why?
The Owner field is PPENGUIN and the Substatus is Assigned. The User Property you
created (On Field Update Set) was configured to update the Substatus to Assigned
whenever the Owner field is updated.

5.b.iv. Save the record. What is the new value of the Source field? Why?
The new value is Phone. The Source field had a Post default value, so the value is not
updated until after the record is saved.

6. F or an additional challenge, set validation for the Email Address field in the Contact
business component so that the email address entered must contain an “at” sign (@) and a
period (.). You can also check that the user enters at least one character for each of the text
strings that surround the @ sign and two characters after the period (.).
First, check out the Contact project. Then, set the Validation property for the Single Value
Field Email Address on the Contact business component as follows:
Validation *?@?*.*??

Note: The wildcard (*) can match zero or more characters. The question marks in the
expression ensure that there is at least one character in each text string. The “at” symbol
(@) and period are literals.)

Siebel 8.0 Essentials 365


Module 29: Business Layer Configuration - Existing Business Components and Fields

366 Siebel 8.0 Essentials


Module 29: Business Layer Configuration - Existing Business Components and Fields

Lab 29-1 Configuring Properties of Fields and Business


Components (Guided)

Goal To configure field and business component properties.

Time 15 – 25 minutes

Instructions:
In this lab, you will incorporate additional business logic into your application by configuring
several properties in field and business component object definitions. You will observe how
validation properties can be used to prevent unwanted data from being entered into the database.
You will see how default values for data can be specified and how user properties can be set to
incorporate business logic into the application.

As a result of your work in this lab:


• Users should not be able to enter a negative value for the original cost of an asset
• The Source of new Service Requests should default to Phone
• When an owner is assigned to an asset, the sub-status should be changed to Assigned.

1. In this step, you will add validation to the Original Cost field of the Asset Mgmt - Asset business
component so that negative values cannot be entered into the database.
a. If necessary, start Siebel Tools and log in as PPENGUIN connecting to the Local database.
b. Select Business Component :: Asset Mgmt - Asset | Single Value Field :: Original Cost.
c. Set the following properties:
Property Value
Validation >=0
Validation Message – The Original Cost field must have a
String Override value that is greater than or equal to
zero.
Message Display Mode User Msg with Error Code Only
d. Compile the Asset Mgmt - Asset business component. Ensure the Auto-start web client
option is not checked.

2. In this step, you will use Post Default Value to ensure a field is not empty after record creation is
completed. On the Service Request business component, you would like the Source field to
default to Phone. Right now, your application only accepts new service requests over the phone.
As such, setting phone as the default value will enable call center agents to take service requests
over the phone more quickly by reducing the amount of data entry. If your application accepted
new service requests over the Web or other channels, the call center agent have to ensure the

Siebel 8.0 Essentials 367


Module 29: Business Layer Configuration - Existing Business Components and Fields

source was set appropriately. Using Post Default Value ensures the value you specify, such as
Phone, will be populated after the user saves the record and before it is saved to the database.
a. If necessary, check out the Service project.
b. Select Business Component :: Service Request | Single Value Field :: Source.
c. Navigate back to the Source single-value field for the Service Request business component.
d. Set the Post Default Value property to Phone.

3. In this step, you will expose the Business Component User Property object type in the Object
Explorer.
a. In the Tools Menu Bar, select View > Options.
b. Click the Object Explorer tab.
c. Expand Business Component.
d. Select the checkbox next to Business Component User Prop. This will cause the Business
Component User Property object type to appear in the Object Explorer.
e. Click OK to accept the change and close the Development Tools Options dialog.

4. In this step, you will configure a User Property on the business component. You would like the
application to change the SR Sub-Status to Assigned when an SR Owner is assigned. You will
accomplish this by configuring a User Property. A Business Component User Property is an
object definition added as a child to the business component. You can use it to configure
specialized behavior beyond what is configured in the parent object definition's properties.
a. Select Business Component :: Service Request | Business Component User Prop.
b. Add a new Business Component User Prop object definition.
c. Set the Name property to On Field Update Set 5. On Field Update Set n is one of the many
user properties available with Siebel. It allows you to set the value of a field in the business
component when another field is updated. When there is more than one instance of this user
property, each instance is executed sequentially by number (for example, On Field Update
Set 1, then On Field Update Set 2, and so forth). We used Set 5 because there are already
several other instances of this user property in the Service Request business component.
d. Set the Value property to “Owned By Id”, “Sub-Status”, “Assigned”. Pay careful attention
to the spaces between the words, the use of double quotes, and the hyphen in Sub-Status. The
value of this user property consists of three quoted parameters separated by a comma and a
space: the field to check (in this case Owned By Id), the field to set (in this case Sub-Status),
and the value to assign to that field (in this case Assigned). At run-time, Sub-Status is set to
Assigned when Owned By Id is updated. For additional information about user properties,
consult Siebel Developer’s Reference.
e. View another instance of this user property in the Service Request business component. In
the Name property, query for On Field Update Set 3. For this user property, what role does
Entitlement Id play?

368 Siebel 8.0 Essentials


Module 29: Business Layer Configuration - Existing Business Components and Fields

f. What role does Billable Flag play?

g. Compile the Service Request business component. Ensure the Auto-start web client option is
checked.

5. Test your changes.


a. In Siebel Call Center, navigate to Assets > List.
b. Create a new Asset record.
i. In the Product field, click the Select button.
ii. Select a product from the Pick Product list and click OK.
iii. Find the Original Cost field. If you do not see it in the list applet, use Columns
Displayed to make it visible.
iv. Enter a negative number in the Original Cost field.
v. Save the record. What happens?

vi. Click OK.


vii. Enter a positive value in the Original Cost field. Click Save Record again. What
happens now when you attempt to save the record?

c. Navigate to Service Requests > Service Request List.


i. Create a new service request record.
ii. Tab into the owner field and delete the value there. Do not tab out of the field nor step
off the record. What value appears in the Source field in the form applet?

iii. What are the current values of the Owner and Substatus fields?

iv. In the Owner field, click the Select button and select PPENGUIN as the new Owner
for the Service Request. Now what are the values of the Owner and Substatus fields?
Why?

Siebel 8.0 Essentials 369


Module 29: Business Layer Configuration - Existing Business Components and Fields

v. Save the record. What is the new value of the Source field? Why?

6. If you would like a challenge, set validation for the Email Address field in the Contact business
component so that the email address entered must contain an “at” sign (@) and a period (.). You
can also check that the user enters at least one character for each of the text strings that surround
the @ sign and two characters after the period (.).
a. Compile and test the customization in your application.
b. See solutions, below, for assistance.

370 Siebel 8.0 Essentials


Module 29: Business Layer Configuration - Existing Business Components and Fields

Solutions 29-1 Configuring Properties of Fields and


Business Components (Guided)

Answers
4.e. View another instance of this user property in the Service Request business component. In
the Name property, query for On Field Update Set 3. For this user property, what role does
Entitlement Id play?
Entitlement Id is the trigger that initiates the user property action. When Entitlement Id is
updated, the user property logic is executed.

4.f. What role does Billable Flag play?


Billable Flag is the acted-upon field. When the user property logic is executed, Billable
Flag is set to the value of the user property’s third parameter. In this case, that parameter
is a conditional statement: "IIF ([Entitlement Id] IS NULL, ""N"", [Billable Flag])”.

5.b.v. Save the record. What happens?


You should receive an error message similar to the following:

5.b.vii. Enter a positive value in the Original Cost field. Click Save Record again. What happens
now when you attempt to save the record?
The record saves without error, because the Original Cost does not violate its validation
rule.

5.c.ii. What value appears in the Source field in the form applet?
No value. It is empty.

5.c.iii. What are the current values of the Owner and Substatus fields?
The Owner field is set to the login ID for the current user, PPENGUIN if logged in as Pat
Penguin, and the Substatus is Unassigned.

5.c.iv. In the Owner field, click the Select button and select PPENGUIN as the new Owner for
the Service Request. Now what are the values of the Owner and Substatus fields? Why?
The Owner field is PPENGUIN and the Substatus is Assigned. The User Property you
created (On Field Update Set) was configured to update the Substatus to Assigned
whenever the Owner field is updated.

Siebel 8.0 Essentials 371


Module 29: Business Layer Configuration - Existing Business Components and Fields

5.c.v. Save the record. What is the new value of the Source field? Why?
The new value is Phone. The Source field had a Post default value, so the value is not
updated until after the record is saved. After saving the record, your view should look
something like this:

Owner changed?

Updates to
“Assigned” after
Updates to “Phone”
Owner is changed
after record is saved

6. I f you would like a challenge, set validation for the Email Address field in the Contact
business component so that the email address entered must contain an “at” sign (@) and a
period (.). You can also check that the user enters at least one character for each of the text
strings that surround the @ sign and two characters after the period (.).
First, check out the Contact project. Then, set the Validation property for the Single Value
Field Email Address on the Contact business component as follows:
Validation *?@?*.*??

Note: The wildcard (*) can match zero or more characters. The question marks in the
expression ensure that there is at least one character in each text string. The “at” symbol
(@) and period are literals.)

372 Siebel 8.0 Essentials


Module 30: Business Layer Configuration - New Business Components and Fields

Lab 30-1 Using the Standard 1:M Extension Table to


Store Supply Plans (Unguided)

Goal To create a new business component using a standard 1:M extension table.

Time 25 - 30 minutes

Instructions:
Many customers rely on your company to provide a variety of supplies (consumable goods) for their
durable assets. A given asset may require a variety of different supplies at a variety of different
times. For example, a copier might require paper frequently, toner less frequently, and lubricant
occasionally. For each asset that consumes supplies, your company creates a supply plan, consisting
of a list of supplies, stocking level, and frequency of stocking.
In this lab you will create a new business component, ABC Asset Supply Plan, which is related to
the Asset Mgmt - Asset business component. Each record will identify a supply, stocking level, and
stocking frequency. Since the records for these new components will have a many-to-one
relationship with asset records, you can use the standard 1:M extension table for the Asset Mgmt -
Asset business component.

1. Determine data storage requirements.


a. The asset-to-supply plan relationship is 1:M, so you decide to use the 1:M extension table for
the Asset Mgmt - Asset business component. Note that the 1:M extension table has the name
of the parent table appended with _XM. What is the name of the 1:M extension table you
should use?

b. Identify the columns in which to store supply plan data. Which column in S_ASSET_XM
table is a foreign key to S_ASSET?

c. A supply plan specifies the name of the supply, the stocking level and stocking frequency.
Which column looks like it should hold the name of the item being supplied?

Siebel 8.0 Essentials 373


Module 30: Business Layer Configuration - New Business Components and Fields

d. The stocking frequency field should be able to store at least 20 characters. Which columns
will serve this need most efficiently?

e. The stocking level field should be a number. Which columns will serve this need?

2. Determine if a business component already exists that can be used to store supply plan data in
the S_ASSET_XM table. Are there any existing business components that use this table?

3. Create a new project named ABC New Bus Comps to contain your new business component.
Recall that you are using a separate project to hold each object type. This is done to facilitate
managing the development environment.

4. Use the business component wizard to create a new business component, ABC Asset Supply
Plan, based on the S_ASSET_XM table, which will be capable of storing multiple supply plans
for each asset.
a. Create single value fields that reference the required user key columns and additional
ATTRIB columns you will need from the S_ASSET_XM table.
Column Name

PAR_ROW_ID Asset Id

NAME Supply

TYPE Type

ATTRIB_03 Stocking
Frequency

ATTRIB_14 Stocking Level

5. Set the Search Specification property for the business component you just created to [Type] =
‘SP’.

6. Add the three fields that make up the user key: Asset Id, Supply, and Type. The user key is
specified in the base table, and adding these columns as fields in the business component ensure
that users gain full advantage of the user key. Make these fields required.

7. Set the Predefault Value for Type to SP.

374 Siebel 8.0 Essentials


Module 30: Business Layer Configuration - New Business Components and Fields

8. Specify the fields that store the data. Set and verify the properties listed for each field in the
table, below.
Name Column Predefault Required Type
Value

Stocking Frequency ATTRIB_03 DTYPE_TEXT

Stocking Level ATTRIB_14 DTYPE_NUMBER

9. Gather the information required to configure a new link to support the 1:M relationship between
Asset Mgmt - Asset and ABC Asset Supply Plan. Enter your responses directly into this
diagram, including parent business component, child business component, source field, and
destination field:

10. Use the diagram above to create the link between the two business components. Create the link
in the ABC New Bus Comps project. Validate the link once you have created it.

11. Add the ABC Asset Supply Plan business component to the Asset Management business object
using the link you just created. You will compile and test your changes in the next lab.

Siebel 8.0 Essentials 375


Module 30: Business Layer Configuration - New Business Components and Fields

Solutions 30-1 Using the Standard 1:M Extension Table


to Store Supply Plans (Unguided)

Answers:
1.a. The asset-to-supply plan relationship is 1:M, so you decide to use the 1:M extension table
for the Asset Mgmt - Asset business component. Note that the 1:M extension table has the
name of the parent table appended with _XM. What is the name of the 1:M extension table
you should use?
S_ASSET_XM.

1.b. Identify the columns in which to store supply plan data. Which column in S_ASSET_XM
table is a foreign key to S_ASSET?
PAR_ROW_ID. To find out, navigate to Table :: S_ASSET_XM / Column. Query the
Foreign Key Table property for S_ASSET.

1.c. A supply plan specifies the name of the supply, the stocking level and stocking frequency.
Which column looks like it should hold the name of the item being supplied?
NAME.

1.d. The stocking frequency field should be able to store at least 20 characters. Which columns
will serve this need most efficiently?
ATTRIB_03 through ATTRIB_07 are Varchar columns and have a length over 20. Other
columns, such as ATTRIB_01, have the correct data type but have a value in the Length
property that is much longer than what is required for this field.

1.e. The stocking level field should be a number. Which columns will serve this need?
ATTRIB_14 through ATTRIB_25. These columns have a Physical Type of number.

2.b. Are there any existing business components that use this table?
No.

376 Siebel 8.0 Essentials


Module 30: Business Layer Configuration - New Business Components and Fields

5. In this step, you will gather information required to configure a new link to support the
1:M relationship between Asset Mgmt - Asset and ABC Asset Supply Plan. Enter your
responses directly into this diagram:

Siebel 8.0 Essentials 377


Module 30: Business Layer Configuration - New Business Components and Fields

378 Siebel 8.0 Essentials


Module 30: Business Layer Configuration - New Business Components and Fields

Lab 30-1 Using the Standard 1:M Extension Table to


Store Supply Plans (Guided)

Goal To create a new business component using a standard 1:M extension table.

Time 25 - 30 minutes

Instructions:
Many customers rely on your company to provide a variety of supplies (consumable goods) for their
durable assets. A given asset may require a variety of different supplies at a variety of different
times. For example, a copier might require paper frequently, toner less frequently, and lubricant
occasionally. For each asset that consumes supplies, your company creates a supply plan, consisting
of a list of supplies, stocking level, and frequency of stocking.
In this lab you will create a new business component, ABC Asset Supply Plan, which is related to
the Asset Mgmt - Asset business component. Each record will identify a supply, stocking level, and
stocking frequency. Since the records for these new components will have a many-to-one
relationship with asset records, you can use the standard 1:M extension table for the Asset Mgmt -
Asset business component.
Since you have already explored fields and business components in previous labs, the steps in this
lab focus on creating a new business component.

1. In this step, you will determine data storage requirements.


a. The asset-to-supply plan relationship is 1:M, so you decide to use the 1:M extension table for
the Asset Mgmt - Asset business component. Note that the 1:M extension table has the name
of the parent table appended with _XM. What is the name of the 1:M extension table you
should use?

b. Identify the columns in which to store supply plan data. Which column in S_ASSET_XM
table is a foreign key to S_ASSET?

c. A supply plan specifies the name of the supply, the stocking level and stocking frequency.
Which column looks like it should hold the name of the item being supplied?

Siebel 8.0 Essentials 379


Module 30: Business Layer Configuration - New Business Components and Fields

d. The stocking frequency field should be able to store at least 20 characters. Which columns
will serve this need most efficiently?

e. The stocking level field should be a number. Which columns will serve this need?

2. In this step, you will determine if a business component already exists that can be used to store
supply plan data in the S_ASSET_XM table.
a. Select Business Component in the OE.
b. Query for Table = S_ASSET_XM. Are there any existing business components that use this
table?

3. In this step, you will create a new project to contain your new business component. Recall that
you are using a separate project to hold each object type. This is done to facilitate managing the
development environment.
a. Select Project in the OE.
b. Add a new object definition with the following values:
Property Value
Name ABC New Bus Comps
Locked TRUE

4. In this step, you will use the business component wizard to create a new business component,
ABC Asset Supply Plan, which will be capable of storing multiple supply plans for each asset.
a. Select File > New Object.
i. Select BusComp under the General tab.
ii. Click OK.
b. In the New Business Component dialog box, enter the following:
Property Value
Project ABC New Bus Comps
Name ABC Asset Supply Plan
Table S_ASSET_XM
c. Click Next.

380 Siebel 8.0 Essentials


Module 30: Business Layer Configuration - New Business Components and Fields

d. Create single value fields that reference the required user key columns and additional
ATTRIB columns you will need from the S_ASSET_XM table. Use the wizard’s Single
Value Fields dialog box to create each of the following fields:
Column Name

PAR_ROW_ID Asset Id

NAME Supply

TYPE Type

ATTRIB_03 Stocking
Frequency

ATTRIB_14 Stocking Level


e. Click Finish.
f. In the OBLE, set the Search Specification property for the business component you just
created to [Type] = ‘SP’. The Search Specification specifies that when this BCs Type single-
value field = ‘SP’, the record will be retrieved. SP, in this case, stands for Supply Plan.
g. Specify fields that make up the user key. The three fields, Asset Id, Supply, and Type,
together make up the user key. DTYPE_ID references the data as the primary key
automatically generated by the application. Specifying TRUE in the Required property
ensures the user enters data for the Supply field in the UI. The user will not be able to
proceed without either entering data into the Supply field or undoing the record. Setting SP
as the Predefault Value for Type causes the Type field to automatically populate with SP
when the user creates a new record in the UI. This provides a way to flag every record
created in this business component as a supply plan record. Then, when the BC needs to
retrieve its records, it uses the value in the required TYPE column to determine which
records to bring up from the data layer.
i. Query for the Asset Id field then set the field’s values to those shown in the table,
below. Dock the Properties window to quickly view and change property values.
ii. Query for then set values for the Supply field, as shown in the table, below.
iii. Query for then set values for the Type field, as shown in the table, below.
Single Value Field Column Predefault Required Type
Name Value

Asset Id PAR_ROW_ID DTYPE_ID

Supply NAME TRUE DTYPE_TEXT

Type TYPE SP DTYPE_TEXT

Siebel 8.0 Essentials 381


Module 30: Business Layer Configuration - New Business Components and Fields

h. Specify fields that store the data. Use the OBLE to set and verify the properties listed for
each field in the table, below.
Name Column Predefault Required Type
Value

Stocking Frequency ATTRIB_03 DTYPE_TEXT

Stocking Level ATTRIB_14 DTYPE_NUMBER

5. In this step, you will gather information required to configure a new link to support the 1:M
relationship between Asset Mgmt - Asset and ABC Asset Supply Plan. Enter your responses
directly into this diagram:

a. What is the parent business component?


b. What is the child business component?
c. What field in the child is the foreign key field to the parent?
d. What field in the parent is the primary key field? Recall that Id is a Siebel-supplied field in
all business components that refers to ROW_ID in the base table. However, you will not find
the Id field when you examine the single value fields for a business component.

382 Siebel 8.0 Essentials


Module 30: Business Layer Configuration - New Business Components and Fields

6. In this step, you will create the link.


a. Select Link in the OE.
b. Add a new object definition and set the following properties:
Property Value
Project ABC New Bus Comps
Parent Business Component Asset Mgmt - Asset
Child Business Component ABC Asset Supply Plan
Source Field Asset Id
Destination Field Asset Id
c. What happened to the Name property of the link you just created?

d. Examine pop-up list behavior. Similar to behavior you’ve observed elsewhere in Tools,
choices displayed in the pop-up list for Source Field are context-sensitive. In this case, the
pop-up list displays all fields in Asset Mgmt - Asset, the business component you just
specified for the Parent Business Component property. The same context-sensitivity is true
for the Child Business Component property. When creating new objects in Tools, it is
important to remain cognizant of how pop-up lists are populated.
i. Try an experiment. Create a new link object definition. Leave the Parent Business
Component property empty, then view the Source Field pop-up list. What fields are
available?

ii. Close the pop-up list. Now specify Asset Mgmt - Asset as the Parent Business
Component. Are the fields available different?

iii. Right-click and select Undo Record.

7. In this step, you will verify your work.


a. Right-click the Asset Mgmt - Asset/ABC Asset Supply Plan link object definition and
select Validate.
b. Click Start to begin the validation process.
c. Wait for the validation to complete. If the previous lab steps were followed correctly, you
should not have any errors.
d. Click Cancel to close the validate dialog box.

8. In this step, you will establish a relationship between the new business component, the new
business component’s link, and the Asset Management business object.
a. Select Business Object :: Asset Management | Business Object Component.

Siebel 8.0 Essentials 383


Module 30: Business Layer Configuration - New Business Components and Fields

b. Add a new object definition and set the following properties:


Property Value
BusComp ABC Asset Supply Plan
Link Asset Mgmt - Asset/ABC Asset Supply Plan
c. If you compiled now, would you be able to test your changes? Why or why not?

384 Siebel 8.0 Essentials


Module 30: Business Layer Configuration - New Business Components and Fields

Solutions 30-1 Using the Standard 1:M Extension Table


to Store Supply Plans (Guided)

Answers:
1.a. The asset-to-supply plan relationship is 1:M, so you decide to use the 1:M extension table
for the Asset Mgmt - Asset business component. Note that the 1:M extension table has the
name of the parent table appended with _XM. What is the name of the 1:M extension table
you should use?
S_ASSET_XM.

1.b. Identify the columns in which to store supply plan data. Which column in S_ASSET_XM
table is a foreign key to S_ASSET?
PAR_ROW_ID. To find out, navigate to Table :: S_ASSET_XM / Column. Query the
Foreign Key Table property for S_ASSET.

1.c. A supply plan specifies the name of the supply, the stocking level and stocking frequency.
Which column looks like it should hold the name of the item being supplied?
NAME.

1.d. The stocking frequency field should be able to store at least 20 characters. Which columns
will serve this need most efficiently?
ATTRIB_03 through ATTRIB_07 are Varchar columns and have a length over 20. Other
columns, such as ATTRIB_01, have the correct data type but have a value in the Length
property that is much longer than what is required for this field.

1.e. The stocking level field should be a number. Which columns will serve this need?
ATTRIB_14 through ATTRIB_25. These columns have a Physical Type of number.

2.b. Are there any existing business components that use this table?
No.

Siebel 8.0 Essentials 385


Module 30: Business Layer Configuration - New Business Components and Fields

5. In this step, you will gather information required to configure a new link to support the
1:M relationship between Asset Mgmt - Asset and ABC Asset Supply Plan. Enter your
responses directly into this diagram:

6.c. What happened to the Name property of the link you just created?
It automatically populated to Asset Mgmt - Asset/ABC Asset Supply Plan.
6.d.i. Try an experiment. Create a new link object definition. Leave the Parent Business
Component property empty, then view the Source Field pop-up list. What fields are
available?
Created, Created By, Id, Updated, Updated By.

6.d.ii. Now specify Asset Mgmt - Asset as the Parent Business Component. Are the fields
available different?
Yes. The fields available in the Source Field pop-up list are the fields in the business
component specified in Parent Business Component.

8.c. If you compiled now, would you be able to test your changes? Why or why not?
No. There are no user interface objects (views or applets) in which the new business
component is displayed. You will create them in the next lab.

386 Siebel 8.0 Essentials


Module 30: Business Layer Configuration - New Business Components and Fields

Lab 30-2 Creating a New List and View (Unguided)

Goal To create a new list applet that displays the ABC Supply Plan business component data,
and a view that displays the applet.

Time 25 - 35 minutes

Instructions:
In this lab you will create a new applet to display supply plans. The applet will be based on the ABC
Asset Supply Plan business component you have created. You will also create a new master-detail
view that includes the new list applet. You will use wizards to build the applets.

1. Create a new list applet called ABC Asset Supply Plan List Applet in project ABC New Applets
to display the data from the ABC Asset Supply Plan business component.
a. In the General dialog box, enter the following:
Property Value
Project ABC New Applets
Name ABC Asset Supply Plan List Applet
Title Supply Plans
Business Component ABC Asset Supply Plan
Upgrade Behavior Preserve
b. Select the applet for each edit mode.
i. Select Applet List (Base/EditList) for the Base read-only mode.
ii. Select Applet List (Base/EditList) for the Edit List mode.
iii. Select Applet List Edit (Edit/New/Query) for the Edit mode.
c. In the Web Layout - Fields dialog box, add Supply, Stocking Frequency, and Stocking
Level.
d. Accept the default controls.

Siebel 8.0 Essentials 387


Module 30: Business Layer Configuration - New Business Components and Fields

2. Create a new view called ABC Asset Supply Plan List View that displays the Asset Mgmt -
Asset Detail Applet on the top and the ABC Asset Supply Plan List Applet on the bottom.
a. In the New View dialog box enter the following:
Property Value
Project ABC New Views
Name ABC Asset Supply Plan List View
Title Supply Plans
Business Object Asset Management
Upgrade Behavior Preserve
b. Select View Detail in the View Web Layout dialog box.
c. In the Web Layout - Applets dialog box, add the Asset Mgmt - Asset Detail Applet and then
the ABC Asset Supply Plan List Applet. Make sure Asset Mgmt - Asset Detail Applet is on
the top and ABC Asset Supply Plan List Applet is immediately below it.
d. Ensure the configuration allows users to add and edit supply plans directly in the list applet.
i. Select View :: ABC Asset Supply Plan List View | View Web Template :: Base |
View Web Template Item :: ABC Asset Supply Plan List Applet and change the
Applet Mode property to Edit List.
ii. Select View :: ABC Asset Supply Plan List View | View Web Template :: Base |
View Web Template Item :: Asset Mgmt - Asset Detail Applet and verify that the
Applet Mode property was set to Edit by the View Wizard.

3. Add the ABC Asset Supply Plan List View you just created to the Asset Management Screen
using the properties below:
Property Value
View ABC Asset Supply Plan List View
Type Detail View
Parent Category Asset Management List
Viewbar Text – String Override Supply Plans
Menu Text – String Override Supply Plans

4. Set the view sequence so that the Detail View - ABC Asset Supply Plan List View appears
immediately after the Detail View - Asset Mgmt - Assets View (Detail).

5. Compile all Locked projects.

6. Administer the ABC Supply Plan List View and add it to the ABC Developer responsibility.

388 Siebel 8.0 Essentials


Module 30: Business Layer Configuration - New Business Components and Fields

7. Test your changes.


a. Add two Asset records to the assets list.
b. Add supply plan record sto the assets you created.Your view should look similar to this:

c. In the asset form applet, move between the asset records: click Next Record or Previous
Record. Test your link by verifying the supply plan shows up for one and not the other. How
was the foreign key on the supply plan record set?

d. If you were to see the same supply plan records for both assets, what would you need to fix
in Siebel Tools?

Siebel 8.0 Essentials 389


Module 30: Business Layer Configuration - New Business Components and Fields

Solutions 30-2 Creating a New List and View (Unguided)

Answers:
6.h. In the asset form applet, move between the asset records: click Next Record or Previous
Record. Test your link by verifying the supply plan shows up for one and not the other.
How was the foreign key on the supply plan record set?
The Link object definition updated the foreign key. The Link specifies that, when a Supply
Plan is created, the Asset Id is set to the Id of the Asset for which it was created.

6.i. If you were to see the same supply plan records for both assets, what would you need to fix
in Siebel Tools?
If you can scroll from Asset to Asset, and the list of related supply plans does not change, it
means the Link is not being used. You would need to add the Link to the ABC Asset Supply
Plan business object component of the Asset Management business object.

390 Siebel 8.0 Essentials


Module 30: Business Layer Configuration - New Business Components and Fields

Lab 30-2 Creating a New List and View (Guided)

Goal To create a new list applet that displays the ABC Supply Plan business component data,
and a view that displays the applet.

Time 25 - 35 minutes

Instructions:
In this lab you will create a new applet to display supply plans. The applet will be based on the ABC
Asset Supply Plan business component you have created. You will also create a new master-detail
view that includes the new list applet. You will use wizards to build the applets.

1. In this step, you will create a new list applet called ABC Asset Supply Plan List Applet in
project ABC New Applets to display the data from the ABC Asset Supply Plan business
component.
a. Select File > New Object.
b. Click the Applets tab.
c. Select List Applet.
d. Click OK.
e. In the General dialog box, enter the following:
Property Value
Project ABC New Applets
Name ABC Asset Supply Plan List Applet
Title Supply Plans
Business Component ABC Asset Supply Plan
Upgrade Behavior Preserve
f. Click Next.
g. Select the applet for each edit mode. For each mode, ensure the displayed thumbnail is
similar to how the applet should appear in the application. In the Web Layout - General
dialog box:
i. Select Applet List (Base/EditList) for the Base read-only mode.
ii. Select Applet List (Base/EditList) for the Edit List mode.
iii. Select Applet List Edit (Edit/New/Query) for the Edit mode.
iv. Click Next.
h. In the Web Layout – Fields dialog box:
i. Double-click Supply in the Available Fields list. Notice how it moved to the Selected
Fields list.
ii. Select Stocking Frequency in the Available Fields list.

Siebel 8.0 Essentials 391


Module 30: Business Layer Configuration - New Business Components and Fields

iii. Click the right arrow to move it to the Selected Fields list.
iv. Select Stocking Level in the Available Fields list.
v. Click the right arrow to move it to the Selected Fields list.
vi. Click Next.
i. In the Web Layout - Fields dialog box, click Next to accept the default selected controls (all
controls available).
j. In the Finish dialog box, review the Applet properties displayed and click Finish. The Web
Layout Editor will appear.

2. In this step, you will verify wizard output.


a. Ensure the list applet is laid out properly. The fields should be arranged left to right, in this
order: Supply, Stocking Frequency, Stocking Level. If they do not appear in this order, re-
arrange the columns as necessary.
b. Close the Web Layout Editor window. If the Confirm dialog box appears, click Yes to save
your changes.
c. Inspect the object definitions created by the List Applet wizard.
i. Select Applet :: ABC Asset Supply Plan List Applet | List :: List | List Column. What
object definitions were created? List them, according to the value in the Name
property.

ii. Select Applet :: ABC Supply Plan List Applet | Control. Some controls must be
present for a list applet to operate properly. If you configure an applet manually, you
must remember to include these controls. One major benefit of the wizard is that the
controls are configured automatically for you. How many Control object definitions
were created?

3. In this step, you will create a new view called ABC Asset Supply Plan List View that displays
the Asset Mgmt - Asset Detail Applet on the top and the ABC Asset Supply Plan List Applet on
the bottom.
a. Select File > New Object.
i. Under the General tab, select View.
ii. Click OK.
b. In the New View dialog box enter the following:
Property Value
Project ABC New Views
Name ABC Asset Supply Plan List View
Title Supply Plans
Business Object Asset Management
Upgrade Behavior Preserve
i. Click Next.

392 Siebel 8.0 Essentials


Module 30: Business Layer Configuration - New Business Components and Fields

c. In the View Web Layout dialog box:


i. Select View Detail.
ii. Check to make sure that the displayed thumbnail looks like how you expect the view
to look in the application.
iii. Click Next.
d. In the Web Layout - Applets dialog box:
i. In the Available Applets window, double-click Asset Mgmt - Asset Detail Applet.
ii. In the Available Applets window, double-click ABC Asset Supply Plan List Applet.
iii. In the Selected Applets window, ensure Asset Mgmt - Asset Detail Applet is on the
top and ABC Asset Supply Plan List Applet is immediately below it.
iv. Click Next.
e. Review the properties displayed in the Finish window. If you are satisfied with the values,
click Finish.
f. The Web Layout Editor for your view will open. Right-click and select Preview.
g. Confirm that the layout looks as you expected.
h. Close the layout window. If asked, click Yes to save your changes.
i. Ensure the configuration allows users to add and edit supply plans directly in the list applet.
i. Select View :: ABC Asset Supply Plan List View | View Web Template :: Base |
View Web Template Item :: ABC Asset Supply Plan List Applet.
ii. Change the Applet Mode property to Edit List.
iii. Select View :: ABC Asset Supply Plan List View | View Web Template :: Base |
View Web Template Item :: Asset Mgmt - Asset Detail Applet.
iv. Verify the Applet Mode property was set to Edit by the View Wizard.

4. In this step, you will add the ABC Asset Supply Plan List View you just created to the Asset
screen.
a. Select Screen :: Asset Management Screen | Screen View.
b. Add a new object definition.
c. Set the properties for the new object definition to those listed in the table, below. Recall that
a screen references one or more views. In this case, you are creating a reference from the
Asset Management Screen to the ABC Asset Supply Plan List View.
Property Value
View ABC Asset Supply Plan List View
Type Detail View
Parent Category Asset Management List
Viewbar Text – String Override Supply Plans
Menu Text – String Override Supply Plans
d. Set the view sequence.
i. Right-click on the Asset Management Screen object definition in the OBLE’s upper
window.
ii. Select Edit Screen View Sequence. The Detail View - ABC Asset Supply Plan List
View should appear immediately after the Detail View - Asset Mgmt – Assets View
(Detail). If it does not, move it into the correct position.

Siebel 8.0 Essentials 393


Module 30: Business Layer Configuration - New Business Components and Fields

e. Close the sequence editor. Save your changes, when prompted.


f. Compile all Locked projects. Ensure auto-start web client is enabled.

5. In this step, you will administer the ABC Supply Plan List View.
a. In the application, navigate to Administration – Application > Views.
b. Add the ABC Asset Supply Plan List View. To ensure the record you create in the
application matches exactly the record you create in Tools, copy and paste the view name
from Tools.
c. Add the following description: Used for supply plan Stocking Frequency and Stocking
Level data entry.
d. Click the Responsibilities list at the bottom of the view.
e. Add the ABC Developer responsibility to the ABC Supply Plan List View.
f. Click Responsibilities on the link bar.
g. Click Clear Cache.
h. Log out of your application.

6. Test your changes.


a. Start the Developer Web Client from Tools.
b. In the application, navigate to Assets > Supply Plans. Click the link for Supply Plans.

Troubleshooting Tips: If you do not see the new view, did you administer the view properly?
Did you add the view to the screen? Did you set the proper text properties? Did you add the
view to the ABC Developer responsibility?

c. Select Assets > List.


d. Add two Asset records. Ensure you fill in any required fields.
e. Navigate to Assets > List > Supply Plans.
f. Notice the Supply Plan view tab is highlighted.

394 Siebel 8.0 Essentials


Module 30: Business Layer Configuration - New Business Components and Fields

g. Add a Supply Plan record to the asset you created. Set the Supply to Toner, Stocking
Frequency to Weekly, and Stocking Level to 3. Your view should look similar to this:

h. In the asset form applet, move between the asset records: click Next Record or Previous
Record. Test your link by verifying the supply plan shows up for one and not the other. How
was the foreign key on the supply plan record set?

i. If you were to see the same supply plan records for both assets, what would you need to fix
in Siebel Tools?

j. Log out of Siebel Call Center.

Siebel 8.0 Essentials 395


Module 30: Business Layer Configuration - New Business Components and Fields

Solutions 30-2 Creating a New List and View (Guided)

Answers:
2.c.i. Select Applet :: ABC Asset Supply Plan List Applet | List :: List | List Column. What
object definitions were created? List them, according to the value in the Name property.
Stocking Frequency, Stocking Level, Supply.

2.c.ii. Select Applet :: ABC Supply Plan List Applet | Control. Some controls must be present for
a list applet to operate properly. If you configure an applet manually, you must remember
to include these controls. One major benefit of the wizard is that the controls are configured
automatically for you. How many Control object definitions were created?
14.

6.h. In the asset form applet, move between the asset records: click Next Record or Previous
Record. Test your link by verifying the supply plan shows up for one and not the other.
How was the foreign key on the supply plan record set?
The Link object definition updated the foreign key. The Link specifies that, when a Supply
Plan is created, the Asset Id is set to the Id of the Asset for which it was created.

6.i. If you were to see the same supply plan records for both assets, what would you need to fix
in Siebel Tools?
If you can scroll from Asset to Asset, and the list of related supply plans does not change, it
means the Link is not being used. You would need to add the Link to the ABC Asset Supply
Plan business object component of the Asset Management business object.

396 Siebel 8.0 Essentials

You might also like