You are on page 1of 596

Oracle CRM Application Foundation

User Guide

Release 11i

August 2002
Part No. A97632-01
Oracle CRM Application Foundation User Guide, Release 11i

Part No. A97632-01

Copyright © 2000, 2002, Oracle Corporation. All rights reserved.

Primary Authors: Kellie Briesach, Charles Colt, Carol Fager-Higgins, Robert Geiwitz, Melody Yang

The Programs (which include both the software and documentation) contain proprietary information of Oracle
Corporation; they are provided under a license agreement containing restrictions on use and disclosure and are also
protected by copyright, patent and other intellectual and industrial property laws. Reverse engineering, disassembly
or decompilation of the Programs, except to the extent required to obtain interoperability with other independently
created software or as specified by law, is prohibited.

The information contained in this document is subject to change without notice. If you find any problems in the
documentation, report them to us in writing. Oracle Corporation does not warrant that this document is error free.
Except as may be expressly permitted in your license agreement for these Programs, no part of these Programs may
be reproduced or transmitted in any form or by any means, electronic or mechanical, for any purpose, without the
express written permission of Oracle Corporation.

If the Programs are delivered to the US Government or anyone licensing or using the Programs on behalf of the US
Government, the following notice is applicable:

RESTRICTED RIGHTS NOTICE

Programs delivered subject to the DOD FAR Supplement are 'commercial computer software' and use, duplication
and disclosure of the Programs including documentation, shall be subject to the licensing restrictions set forth in the
applicable Oracle license agreement. Otherwise, Programs delivered subject to the Federal Acquisition Regulations
are 'restricted computer software' and use, duplication, and disclosure of the Programs shall be subject to the
restrictions in FAR 52.227-19, Commercial Computer Software - Restricted Rights (June, 1987). Oracle
Corporation, 500 Oracle Parkway, Redwood City, CA 94065.

The Programs are not intended for use in any nuclear, aviation, mass transit, medical, or other inherently dangerous
applications. It shall be licensee's responsibility to take all appropriate fail-safe, back up, redundancy and other
measures to ensure the safe use of such applications if the Programs are used for such purposes, and Oracle
Corporation disclaims liability for any damages caused by such use of the Programs.

Oracle is a registered trademark, and PL/SQL and SQL*Plus are trademarks or registered trademarks of Oracle
Corporation. Other names may be trademarks of their respective owners.
Contents

Send Us Your Comments ................................................................................................................ xxiii

Preface......................................................................................................................................................... xxv
Intended Audience ............................................................................................................................. xxv
Typographic Conventions ................................................................................................................. xxv
Documentation Accessibility ........................................................................................................... xxvi
Other Information Sources .............................................................................................................. xxvii
Do Not Use Database Tools to Modify Oracle Applications Data ............................................ xxxii
About Oracle ..................................................................................................................................... xxxiii

Part I Resource Manager

1 Introduction to Oracle Resource Manager


1.1 Overview of the Oracle Resource Manager....................................................................... 1-1
1.1.1 What is the Resource Manager?................................................................................... 1-2
1.1.2 What are Resources? ...................................................................................................... 1-3
1.1.3 Understanding Roles ..................................................................................................... 1-4
1.1.4 Understanding Groups ................................................................................................. 1-6
1.1.5 Determining Group Hierarchy..................................................................................... 1-7
1.1.6 Understanding Teams ................................................................................................... 1-7
1.1.7 What is a Salesperson? .................................................................................................. 1-8
1.1.8 How are the Different Resource Name Fields Used? ............................................... 1-8
1.2 Oracle Resource Manager Integrations ............................................................................ 1-11
1.3 Process Flow for Oracle Resource Manager .................................................................... 1-12

iii
1.4 What’s New in This Release............................................................................................... 1-13
1.5 Terms and Definitions ........................................................................................................ 1-15
1.6 Resource Manager Rules for HTML ................................................................................. 1-17

2 Overview of Using Oracle Resource Manager


2.1 Accessing Oracle Resource Manager Interface ................................................................. 2-1
2.2 Summary of Oracle Resource Manager Tasks................................................................... 2-2

3 Managing Employee Resources


3.1 Viewing Your Personal Information................................................................................... 3-1
3.2 Defining Your Personal Information .................................................................................. 3-2
3.3 Viewing Your Organizational Structure ............................................................................ 3-5
3.4 Defining Your Skill Rating ................................................................................................... 3-7
3.5 Viewing a Resource’s Skill Ratings ..................................................................................... 3-9
3.6 Making a Resource Web Available ................................................................................... 3-10

4 Searching for Resources


4.1 Using the Quick Find Search ............................................................................................... 4-1
4.2 Initiating an Advanced Search for a Resource .................................................................. 4-2
4.3 Initiating an Advanced Search for a Group....................................................................... 4-3

5 Managing Group Resources


5.1 Viewing Your Group Membership Information............................................................... 5-1
5.2 Defining Your Group Membership Information .............................................................. 5-2
5.3 Defining Group Hierarchy ................................................................................................... 5-3
5.4 Viewing Your Group Membership History....................................................................... 5-5

Part II Notes

6 Introduction to Oracle Notes


6.1 Overview of Oracle Notes .................................................................................................... 6-1
6.2 Oracle Notes Key Features ................................................................................................... 6-2
6.3 Oracle Notes Integrations..................................................................................................... 6-3

iv
6.4 Process Flow for Oracle Notes............................................................................................. 6-4
6.5 What’s New in This Release ................................................................................................ 6-4
6.6 Terms and Definitions .......................................................................................................... 6-4

7 Overview of Using Oracle Notes


7.1 Accessing the Oracle Notes Interface ................................................................................. 7-1
7.2 Summary of Oracle Notes Tasks ......................................................................................... 7-2

8 Managing Notes
8.1 Creating a Note...................................................................................................................... 8-1
8.2 Adding an Attachment ......................................................................................................... 8-2
8.3 Viewing Existing Attachments............................................................................................ 8-2
8.4 Using the Relate To Function .............................................................................................. 8-2

9 Viewing Note Information


9.1 Using the Notes Summary Window................................................................................... 9-1
9.2 Viewing All Notes ................................................................................................................. 9-3
9.3 Viewing Note Details............................................................................................................ 9-4

10 Searching for a Note


10.1 Using the Quick Find Search ............................................................................................. 10-1
10.2 Searching for a Note............................................................................................................ 10-2

11 Using Forms-based Notes


11.1 Creating Notes ..................................................................................................................... 11-1
11.2 Finding Notes....................................................................................................................... 11-2

Part III Territory Manager

12 Introduction to Oracle Territory Manager


12.1 Overview of Oracle Territory Management................................................................... 12-1
12.1.1 What is a Territory? ..................................................................................................... 12-2
12.1.2 What is Territory Manager?........................................................................................ 12-2

v
12.1.3 What is the Territory Lookup Tool? .......................................................................... 12-3
12.2 Oracle Territory Manager Integrations ............................................................................ 12-3
12.3 Process Flow for Oracle Territory Manager .................................................................... 12-4
12.4 Terms and Definitions ........................................................................................................ 12-5
12.5 Basic Territory Building Blocks ......................................................................................... 12-7
12.5.1 Qualifiers ....................................................................................................................... 12-7
12.5.2 Transaction Qualifiers ................................................................................................. 12-8
12.5.3 Customer Name............................................................................................................ 12-9
12.5.4 Customer Name Range................................................................................................ 12-9
12.5.5 Customer Name Range Group................................................................................. 12-10
12.5.6 Resource Qualifiers .................................................................................................... 12-11
12.5.7 Using Qualifiers.......................................................................................................... 12-11
12.5.8 Territories .................................................................................................................... 12-11
12.5.9 Territory Types ........................................................................................................... 12-12
12.5.10 Territory Templates.................................................................................................... 12-12
12.5.11 Escalation Territories ................................................................................................. 12-12
12.6 Different Ways of Creating Territories.......................................................................... 12-13
12.6.1 Creating Individual Territories ................................................................................ 12-13
12.6.2 Creating a Territory Using a Territory Type .......................................................... 12-13
12.6.3 Creating a Territory Using a Territory Template .................................................. 12-14
12.7 Territory Hierarchies......................................................................................................... 12-14
12.8 Territory Winning Rules................................................................................................... 12-15
12.9 Understanding the Territory Details Tab....................................................................... 12-17

13 Overview of Using Oracle Territory Manager


13.1 Accessing the Oracle Territory Manager Interface ......................................................... 13-1
13.2 Summary of Oracle Territory Manager Tasks................................................................. 13-2

14 Using the Territory Lookup Tool


14.1 Using the Territory Lookup Tool ...................................................................................... 14-1
14.2 Finding a Salesperson Using the Lookup Subtab ........................................................... 14-2
14.3 Finding a Salesperson Using the Lookup by Organization Subtab ............................. 14-3
14.4 Finding a Salesperson Using the Advanced Lookup Subtab........................................ 14-5

vi
15 Running Reports in Territory Manager
15.1 Territory Definition Report (Forms) ................................................................................. 15-1
15.2 Territory Changes Report (Forms).................................................................................... 15-2
15.3 Territory Definition Report (HTML) ................................................................................ 15-3
15.4 Territory Changes Report (HTML)................................................................................... 15-4

Part IV Assignment Manager

16 Introduction to Oracle Assignment Manager


16.1 Overview of Oracle Assignment Manager ...................................................................... 16-1
16.1.1 What is Assignment Manager? .................................................................................. 16-2
16.1.2 What is an Assignment?.............................................................................................. 16-3
16.2 Oracle Assignment Manager Integrations....................................................................... 16-3
16.3 Ownership and Resources ................................................................................................. 16-4
16.3.1 Assigning Ownership.................................................................................................. 16-4
16.3.2 Assigning Resources .................................................................................................... 16-5
16.3.3 Assisted Assignment Option...................................................................................... 16-6
16.3.4 Unassisted Assignment Option ................................................................................. 16-8
16.3.5 Intelligent Assignment Option................................................................................... 16-9
16.3.6 Window to Promise Assignment Option ............................................................... 16-10
16.4 The Gantt Chart ................................................................................................................. 16-11
16.4.1 Shift Displays in the Gantt Chart ............................................................................. 16-12
16.5 Assigning a Process........................................................................................................... 16-14
16.5.1 Assignment Manager Dependencies....................................................................... 16-14
16.5.2 Assignment Manager Selection Criteria ................................................................. 16-15
16.5.2.1 Preferred Resources ............................................................................................ 16-15
16.5.2.2 Territories ............................................................................................................. 16-16
16.5.2.3 Resource Availability ......................................................................................... 16-17
16.6 Selecting Assignment Criteria ......................................................................................... 16-17
16.7 Process Flow for Oracle Assignment Manager............................................................. 16-18
16.8 What’s New In This Release ............................................................................................ 16-19
16.9 Terms and Definitions ...................................................................................................... 16-21

vii
17 Overview of Using Oracle Assignment Manager
17.1 Accessing the Oracle Assignment Manager Interface.................................................... 17-1
17.2 Summary of Oracle Assignment Manager Tasks ........................................................... 17-2

18 Assigning Options
18.1 Overview............................................................................................................................... 18-1
18.2 Assisted Assignment Option ............................................................................................. 18-1
18.3 Unassisted Assignment Option ......................................................................................... 18-3
18.4 Intelligent Assignment Option .......................................................................................... 18-4
18.5 Assigning with the Window To Promise......................................................................... 18-4

19 Viewing Resource Information in Assignment Manager


19.1 Overview............................................................................................................................... 19-1
19.2 Viewing and Assigning Resources in the Gantt Chart .................................................. 19-1
19.3 Viewing Resource Web Availability in the Gantt Chart................................................ 19-3
19.4 Viewing Support Site Name Information ........................................................................ 19-4
19.5 Viewing a Resource’s Product Skills Rating.................................................................... 19-5

Part V Task Manager

20 Introduction to Oracle Task Manager


20.1 Overview of Oracle Task Manager ................................................................................... 20-1
20.1.1 What is a Task? ............................................................................................................. 20-2
20.1.2 Task Manager Roles ..................................................................................................... 20-2
20.1.3 Task Manager Rules..................................................................................................... 20-3
20.2 Forms-based Task Manager User Interface ..................................................................... 20-5
20.3 Oracle Task Manager Integrations .................................................................................... 20-7
20.4 Notes and Calendar Integration ........................................................................................ 20-8
20.5 Process Flow for Oracle Task Manager ............................................................................ 20-9
20.6 What’s New in This Release............................................................................................. 20-10
20.7 Terms and Definitions ..................................................................................................... 20-11

viii
21 Overview of Using the HTML Task Manager
21.1 Accessing the Oracle Task Manager Interface ................................................................ 21-1
21.2 Summary of Oracle Task Manager Tasks ........................................................................ 21-2

22 Viewing Task Information


22.1 Viewing the Task Summary............................................................................................... 22-1
22.2 Using the Quick Find Search ............................................................................................. 22-3
22.3 Customizing Your Task Summary Display Options ..................................................... 22-4
22.4 Selecting Sort Options......................................................................................................... 22-6
22.5 Personalizing Your Saved Searches.................................................................................. 22-7
22.6 Viewing Task Details ........................................................................................................ 22-10

23 Managing Tasks
23.1 Creating a Task .................................................................................................................... 23-1
23.2 Defining Dates for the Task ............................................................................................... 23-3
23.3 Associating a Task with a Customer ................................................................................ 23-5
23.4 Relating Appointments and Tasks to Source Objects .................................................... 23-6
23.5 Assigning a Resource to a Task ......................................................................................... 23-6
23.6 Specifying the Task Effort .................................................................................................. 23-8
23.7 Creating a Repeating Task or Appointment ................................................................. 23-10
23.8 Mass Creating Tasks ......................................................................................................... 23-11
23.9 Viewing Existing Attachments........................................................................................ 23-12
23.10 Adding an Attachment ..................................................................................................... 23-12
23.11 Viewing Your Task Bin..................................................................................................... 23-12
23.12 Editing Your Task Bin....................................................................................................... 23-13
23.13 Reassigning Tasks ............................................................................................................. 23-15

24 Managing Task Preferences


24.1 Defining Your Preferences ................................................................................................. 24-1
24.2 Setting User Preferences..................................................................................................... 24-1
24.3 Viewing Notifications in Your Worklist .......................................................................... 24-2

ix
25 Managing Task Contacts
25.1 Viewing Task Contact Information................................................................................... 25-1
25.2 Defining Task Contacts....................................................................................................... 25-2

26 Working with Forms-based Tasks


26.1 Creating, Updating, and Finding Tasks ........................................................................... 26-1
26.2 Setting Dependencies for Tasks......................................................................................... 26-4
26.3 Linking Tasks to Source Documentation ......................................................................... 26-5
26.4 Setting Task Flags ................................................................................................................ 26-6
26.5 Documenting Multiple Contact Information .................................................................. 26-7
26.6 Launching the Task Workflow .......................................................................................... 26-8

27 Scheduling and Tracking Forms-based Tasks


27.1 Assigning and Scheduling Resources............................................................................... 27-1
27.2 Scheduling Recurring Tasks............................................................................................... 27-3
27.3 Tracking Planned, Scheduled, and Actual Dates............................................................ 27-4
27.4 Tracking a Task Record ...................................................................................................... 27-5

Part VI HTML Calendar

28 Introduction to the Oracle HTML Calendar


28.1 Overview of Oracle HTML Calendar ............................................................................... 28-1
28.1.1 Calendar Rules.............................................................................................................. 28-2
28.1.2 Types of Calendars....................................................................................................... 28-2
28.1.3 Calendar Views............................................................................................................. 28-3
28.1.4 Who Uses Calendar?.................................................................................................... 28-4
28.2 Oracle Calendar Key Features ........................................................................................... 28-5
28.2.1 Managing Appointments ............................................................................................ 28-5
28.2.2 Personalization and Preferences ................................................................................ 28-6
28.3 Integration with Notes and Tasks ..................................................................................... 28-6
28.4 Oracle HTML Calendar Integrations................................................................................ 28-7
28.5 Calendar Process Flow........................................................................................................ 28-7
28.6 What’s New in This Release............................................................................................... 28-8
28.7 Terms and Definitions ...................................................................................................... 28-10

x
29 Overview of Using the Oracle HTML Calendar
29.1 Accessing the Oracle HTML Calendar Interface ............................................................ 29-1
29.2 Summary of Oracle HTML Calendar Tasks .................................................................... 29-2

30 Viewing Your Calendar


30.1 Viewing Your Personal Calendar ..................................................................................... 30-1
30.2 Viewing Different Dates on the Calendar........................................................................ 30-2
30.3 Viewing Your Tasks and Your Calendar Simultaneously ............................................ 30-3
30.4 Viewing the Availability of a Resource............................................................................ 30-4
30.5 Adding a New Resource to Your Availability View...................................................... 30-5
30.6 Viewing a Public Calendar ................................................................................................ 30-6

31 Managing Appointments
31.1 Using the Quick Find Search ............................................................................................. 31-1
31.2 Viewing and Updating Appointment Details................................................................. 31-2
31.3 Creating an Appointment .................................................................................................. 31-4
31.4 Deleting an Appointment .................................................................................................. 31-6
31.5 Defining Attendees for an Appointment ......................................................................... 31-7
31.6 Receiving an Invitation....................................................................................................... 31-9
31.7 Creating a Repeating Task or Appointment ................................................................. 31-10
31.8 Viewing Existing Attachments........................................................................................ 31-11
31.9 Adding an Attachment ..................................................................................................... 31-12
31.10 Relating Appointments and Tasks to Source Objects .................................................. 31-13
31.11 Working with Bins ............................................................................................................ 31-14
31.12 Viewing Your Calendar and Appointment Bins .......................................................... 31-15

32 Customizing Your Calendar Preferences


32.1 Changing Your Personal Preferences ............................................................................... 32-1
32.2 Defining Privileges for Your Calendar............................................................................. 32-3
32.3 Working with Group Calendars ....................................................................................... 32-4
32.4 Requesting a New Group or Public Calendar................................................................. 32-4
32.5 Subscribing to a Group Calendar...................................................................................... 32-6
32.6 Switching to Another Calendar......................................................................................... 32-7
32.7 Adding and Removing Task Categories .......................................................................... 32-9

xi
32.8 Defining Your Time Zone................................................................................................. 32-10

33 Administering Group Calendars


33.1 Viewing and Approving New Group Calendar Requests ............................................ 33-1
33.2 Viewing and Approving Subscription Requests ............................................................ 33-2
33.3 Viewing Group Calendar Subscription Information...................................................... 33-4
33.4 Updating Group Calendar Subscription Information.................................................... 33-5

Part VII Forms-based Calendar

34 Introduction to the Oracle Forms-based Calendar


34.1 Overview of the Oracle Forms-based Calendar.............................................................. 34-1
34.1.1 Calendar Setup window.............................................................................................. 34-1
34.1.2 Calendar Datebook ...................................................................................................... 34-3
34.2 Oracle Forms-based Calendar Integrations ..................................................................... 34-3
34.3 Process Flow for the Oracle Forms-based Calendar....................................................... 34-3

35 Overview of Using the Oracle Forms-based Calendar


35.1 Accessing the Oracle Forms-based Calendar Interface.................................................. 35-1
35.2 Summary of Oracle Forms-based Calendar Tasks ......................................................... 35-1

36 Managing the Oracle Forms-based Calendar


36.1 Creating Tasks and ToDos in a Calendar......................................................................... 36-1
36.2 Viewing the Datebook ........................................................................................................ 36-2
36.3 Creating a ToDo List ........................................................................................................... 36-3

Part VIII Interaction History

37 Introduction to Oracle Interaction History


37.1 Overview of Oracle Interaction History........................................................................... 37-1
37.1.1 What is Interaction Data? ............................................................................................ 37-2
37.1.2 What is an Interaction? ................................................................................................ 37-2
37.1.3 What Is an Activity?..................................................................................................... 37-3

xii
37.1.4 What Are Media and Media Items? .......................................................................... 37-3
37.2 Interaction History’s Dependencies and Integration ..................................................... 37-3
37.3 Process Flow for Oracle Interaction History ................................................................... 37-4
37.4 What’s New In This Release .............................................................................................. 37-5
37.5 Terms and Definitions ........................................................................................................ 37-6
37.6 How does Interaction History Work? .............................................................................. 37-8
37.7 Interaction History Features .............................................................................................. 37-8
37.7.1 Viewing Migrated 3i Attachments ............................................................................ 37-9
37.7.2 Importing Mass Data .................................................................................................. 37-9
37.7.3 Viewing Open or Closed Activities ......................................................................... 37-10
37.7.4 SMTP Email Identifier Available ............................................................................. 37-10
37.7.5 Integration With Scripting ........................................................................................ 37-10

38 Overview of Using Oracle Interaction History


38.1 Accessing the Oracle Interaction History Interface........................................................ 38-1
38.2 Summary of Oracle Interaction History Tasks................................................................ 38-1

39 Working with Forms-based Interactions


39.1 Searching Interactions......................................................................................................... 39-1
39.2 Viewing Interactions ........................................................................................................... 39-2
39.3 Viewing Interaction Notes ................................................................................................. 39-3

40 Working with Forms-based Activities


40.1 Searching Activities............................................................................................................. 40-1
40.2 Viewing Activities ............................................................................................................... 40-2
40.3 Viewing Activity Notes ...................................................................................................... 40-3
40.4 Drilling Down on Reference Documents ......................................................................... 40-4

41 Working with HTML Interactions


41.1 Searching Interactions......................................................................................................... 41-1
41.2 Viewing Interactions ........................................................................................................... 41-2
41.3 Viewing Notes in Interaction History .............................................................................. 41-3

xiii
42 Working with HTML Activities
42.1 Searching Activities............................................................................................................. 42-1
42.2 Viewing Activities ............................................................................................................... 42-2
42.3 Changing Profile Options................................................................................................... 42-4

Part IX 1-to-1 Fulfillment

43 Introduction to Oracle 1-to-1 Fulfillment


43.1 Overview of Oracle 1-to-1 Fulfillment.............................................................................. 43-1
43.1.1 What is a Fulfillment? .................................................................................................. 43-2
43.1.2 Who Handles Fulfillments? ........................................................................................ 43-3
43.1.3 What is a Fulfillment Server?...................................................................................... 43-3
43.1.4 What is a Query? .......................................................................................................... 43-4
43.1.5 What are Datasource Files?......................................................................................... 43-4
43.1.6 What Are Some Elements of Fulfillments? ............................................................... 43-5
43.1.7 Faxing a Fulfillment Request ...................................................................................... 43-7
43.1.8 Previewing and Printing a Fulfillment Request ...................................................... 43-8
43.1.9 Redirecting the Finish Button ..................................................................................... 43-8
43.1.10 Using the Fetch SMTP Identifier ................................................................................ 43-9
43.2 Oracle 1-to-1 Fulfillment Integrations .............................................................................. 43-9
43.3 What’s New in This Release............................................................................................. 43-10
43.4 Terms and Definitions ...................................................................................................... 43-10
43.5 Process Flow Oracle 1-to-1 Fulfillment .......................................................................... 43-13

Part X Escalation Management

44 Introduction to Oracle Escalation Management


44.1 Overview of Oracle Escalation Management .................................................................. 44-1
44.1.1 What is an Escalation? ................................................................................................. 44-2
44.1.2 What is a Reactive Escalation?.................................................................................... 44-2
44.1.3 What is a Proactive Escalation? .................................................................................. 44-2
44.1.4 Escalation Features....................................................................................................... 44-3
44.2 What’s New in This Release............................................................................................... 44-3
44.3 Oracle Escalation Management Integrations................................................................... 44-4

xiv
44.4 Process Flow for Oracle Escalation Manager .................................................................. 44-5
44.5 Terms and Definitions ........................................................................................................ 44-5

45 Overview of Using Oracle Escalation Management


45.1 Accessing the Oracle Escalation Manager Interface....................................................... 45-1
45.2 Summary of Oracle Escalation Management Tasks ....................................................... 45-2

46 Overview of Reactive Escalations: Escalation Manager


46.1 What is Escalation Manager?............................................................................................. 46-1
46.2 Workflow Notifications ...................................................................................................... 46-2
46.3 Escalation Territories .......................................................................................................... 46-2
46.4 Escalation Owners and Owner Types .............................................................................. 46-3
46.4.1 Owners........................................................................................................................... 46-3
46.4.2 Owner Types................................................................................................................. 46-3

47 Overview of Proactive Escalations: Business Rule Monitor


47.1 What is a Business Rule? .................................................................................................... 47-1
47.2 What is the Business Rule Monitor? ................................................................................. 47-2
47.3 Workflow and Workflow Attributes ................................................................................ 47-2
47.3.1 Notification Only.......................................................................................................... 47-3
47.3.2 Create a Task Only....................................................................................................... 47-3
47.3.3 Notification and Create Task...................................................................................... 47-3
47.3.4 Escalated Object............................................................................................................ 47-3
47.3.5 Workflow Attributes.................................................................................................... 47-3
47.4 Resource Types .................................................................................................................... 47-5
47.5 General Tips for Defining Rules........................................................................................ 47-7

48 Using Escalation Manager


48.1 CreatingEscalations............................................................................................................. 48-1
48.2 Creating a Document Whose Owner is a Group ............................................................ 48-3
48.3 Managing Different Types of Escalations ........................................................................ 48-4
48.4 Managing a Service Request Escalation ........................................................................... 48-4
48.5 Managing a Task Escalation .............................................................................................. 48-6
48.6 Managing a Defect Escalation ........................................................................................... 48-7

xv
Part XI User Management

49 Introduction to Oracle User Management


49.1 Overview............................................................................................................................... 49-1
49.2 What’s New in This Release............................................................................................... 49-2
49.3 User Types ............................................................................................................................ 49-5
49.3.1 Primary User ................................................................................................................. 49-5
49.3.2 Business User ................................................................................................................ 49-5
49.3.3 Individual User............................................................................................................. 49-5
49.4 Enrollments .......................................................................................................................... 49-5
49.4.1 Self-service Enrollments .............................................................................................. 49-6
49.4.2 Automatic Enrollments ............................................................................................... 49-6
49.4.3 Delegation Only............................................................................................................ 49-6
49.4.3.1 Required Roles....................................................................................................... 49-6
49.4.4 Delegation and Self-service......................................................................................... 49-6
49.4.4.1 Required Roles....................................................................................................... 49-7
49.5 Templates.............................................................................................................................. 49-7
49.6 Approval Processes ............................................................................................................. 49-7
49.6.1 Approval........................................................................................................................ 49-8
49.6.2 Approval Definition..................................................................................................... 49-8
49.6.3 Approval Flow.............................................................................................................. 49-8
49.6.4 Approver Lists .............................................................................................................. 49-8
49.6.5 Approvers...................................................................................................................... 49-9
49.6.5.1 System Administrators......................................................................................... 49-9
49.6.5.2 Primary Users ........................................................................................................ 49-9
49.6.5.3 Request Owner ...................................................................................................... 49-9
49.6.6 Approval Groups ......................................................................................................... 49-9
49.7 Access Control.................................................................................................................... 49-10
49.7.1 Responsibilities ........................................................................................................... 49-10
49.7.1.1 CRM HTML Administration ............................................................................. 49-10
49.7.1.2 CRM User Management..................................................................................... 49-10
49.7.1.3 CRM Primary User.............................................................................................. 49-10
49.7.2 Permissions.................................................................................................................. 49-10
49.7.2.1 JTA_UM_SETUP ................................................................................................. 49-11
49.7.2.2 JTA_UM_DELEGATION_ACCESS.................................................................. 49-11

xvi
49.7.2.3 JTF_APPROVER.................................................................................................. 49-11
49.7.2.4 JTF_PRIMARY_USER_SUMMARY ................................................................. 49-11
49.7.2.5 JTF_REG_APPROVAL ....................................................................................... 49-12
49.7.2.6 JTF_SECURITY_ASSIGN_ROLE ...................................................................... 49-12
49.7.3 Roles ............................................................................................................................. 49-12
49.7.3.1 JTA_UM_DELEGATION_ACCESS ................................................................. 49-12
49.7.3.2 JTA_UM_SETUP_ADMIN ................................................................................ 49-12
49.7.3.3 JTF_APPROVER.................................................................................................. 49-12
49.7.3.4 JTF_PRIMARY_USER ........................................................................................ 49-13
49.7.3.5 JTF_SYSTEM_ADMIN_ROLE........................................................................... 49-13
49.8 Self-Service Registration................................................................................................... 49-13
49.8.1 Registration ................................................................................................................. 49-13
49.8.2 Registration Self-service Administration UI .......................................................... 49-13
49.8.3 Registration Self-service User UI ............................................................................. 49-13
49.9 Terms and Definitions ...................................................................................................... 49-13
49.9.1 Customers.................................................................................................................... 49-14
49.9.2 Java Server Pages (JSPs) ............................................................................................ 49-14
49.9.3 Merchants .................................................................................................................... 49-14
49.9.4 Users............................................................................................................................. 49-14
49.9.5 Workflow..................................................................................................................... 49-14

50 Working with Oracle User Management


50.1 Introduction.......................................................................................................................... 50-2
50.2 Creating the User Management Administrative User ................................................... 50-3
50.3 Logging into User Management ....................................................................................... 50-4
50.4 Approving Pending User Requests .................................................................................. 50-5
50.5 Viewing Your Notifications ............................................................................................... 50-6
50.6 Approving Requests from the Notification Window..................................................... 50-7
50.7 Viewing All Users ............................................................................................................... 50-8
50.8 Searching for a User ............................................................................................................ 50-9
50.9 Creating a New User......................................................................................................... 50-10
50.10 Editing a User's Details..................................................................................................... 50-12
50.11 Deleting a User .................................................................................................................. 50-13
50.12 Defining a User’s Roles..................................................................................................... 50-15
50.13 Defining a User’s Account ............................................................................................... 50-16

xvii
50.14 Defining a User’s Enrollment .......................................................................................... 50-17
50.15 Creating a New Approval ................................................................................................ 50-19
50.16 Removing an Approval .................................................................................................... 50-21
50.17 Searching for an approval ................................................................................................ 50-22
50.18 Editing an Approval Details ............................................................................................ 50-23
50.19 Enabling and Disabling Approval .................................................................................. 50-24
50.20 Searching for an Organization......................................................................................... 50-25
50.21 Viewing Approval Preferences........................................................................................ 50-26
50.22 Updating Approval Preferences...................................................................................... 50-27
50.23 Creating an Enrollment .................................................................................................... 50-29
50.24 Removing an Enrollment.................................................................................................. 50-30
50.25 Enabling and Disabling Enrollments.............................................................................. 50-31
50.26 Editing an Enrollment's Details....................................................................................... 50-32
50.27 Creating a User Type ........................................................................................................ 50-33
50.28 Removing a User Type ..................................................................................................... 50-36
50.29 Activating and Deactivating User Types ....................................................................... 50-37
50.30 Searching for a User Type ................................................................................................ 50-37
50.31 Editing a User Type's Details........................................................................................... 50-38
50.32 Creating a Template .......................................................................................................... 50-40
50.33 Removing a Template ....................................................................................................... 50-42
50.34 Enabling and Disabling Templates ................................................................................. 50-42
50.35 Editing a Template's Details ............................................................................................ 50-43
50.36 Searching for a Template.................................................................................................. 50-44

Part XII Appendices

A Oracle Resource Manager User Interface Reference


A.1 Employees............................................................................................................................... A-1
A.2 Advanced Search ................................................................................................................... A-2
A.3 Resource Detail ...................................................................................................................... A-3
A.4 Resource Detail Administrator............................................................................................ A-5
A.5 Resource Detail Read-only ................................................................................................... A-8
A.6 Resource Detail Confirmation ........................................................................................... A-10
A.7 Create An Employee Resource .......................................................................................... A-11
A.8 Define Resource Fields for Update ................................................................................... A-12

xviii
A.9 Group Summary Window ................................................................................................. A-14
A.10 Create Group........................................................................................................................ A-14
A.11 Group Detail......................................................................................................................... A-15
A.12 Group Hierarchy ................................................................................................................. A-17
A.13 Advanced Group Search .................................................................................................... A-19
A.14 Skills ...................................................................................................................................... A-20
A.15 Rate Skills ............................................................................................................................. A-20
A.16 Define Skill Levels ............................................................................................................... A-21

B Oracle Notes User Interface Reference


B.1 Notes Summary Window..................................................................................................... B-1
B.2 Notes Search Window in HTML......................................................................................... B-2
B.3 Create Note Window ............................................................................................................ B-4
B.4 All Notes Window................................................................................................................. B-6
B.5 Note Details Window ........................................................................................................... B-6
B.6 Attachment Summary Window .......................................................................................... B-8
B.7 Add Attachment Window.................................................................................................... B-9
B.8 Relate To Window............................................................................................................... B-10

C Oracle Territory Manager User Interface Reference


C.1 The Overview Tab ................................................................................................................. C-1
C.2 The Transaction Qualifiers Tab ........................................................................................... C-3
C.3 The Resource Qualifiers Tab................................................................................................ C-4
C.4 The Resources Tab................................................................................................................. C-5
C.5 The Subterritories Tab .......................................................................................................... C-6
C.6 Territory Lookup Tool Field Descriptions......................................................................... C-7
C.7 Territory Lookup Search Results ...................................................................................... C-10

D Oracle Task Manager User Interface Reference


D.1 Create Task ............................................................................................................................. D-1
D.2 Create Quick Task ................................................................................................................. D-5
D.3 Task Summary ....................................................................................................................... D-6
D.4 Task Search............................................................................................................................. D-9
D.5 Task Details .......................................................................................................................... D-13

xix
D.6 Reference.............................................................................................................................. D-16
D.7 Assignments ........................................................................................................................ D-18
D.8 Efforts ................................................................................................................................... D-19
D.9 Repeating ............................................................................................................................. D-20
D.10 Task Contacts ...................................................................................................................... D-23
D.11 Attachments ........................................................................................................................ D-24
D.12 Add Attachments ............................................................................................................... D-26
D.13 Mass Create ......................................................................................................................... D-27

E Oracle HTML Calendar User Interface Reference


E.1 Daily View .............................................................................................................................. E-1
E.2 Weekly View .......................................................................................................................... E-2
E.3 Monthly View ........................................................................................................................ E-4
E.4 Yearly View ............................................................................................................................ E-5
E.5 Combination View................................................................................................................. E-6
E.6 Availability View................................................................................................................... E-8
E.7 Group Calendar Summary................................................................................................... E-9
E.8 Group Calendar Description.............................................................................................. E-10
E.9 Request New Group............................................................................................................ E-11
E.10 Switch to Another Calendar............................................................................................... E-11
E.11 Calendar Personal Preferences .......................................................................................... E-11
E.12 Privileges............................................................................................................................... E-12
E.13 Categories ............................................................................................................................. E-13
E.14 User Time Zone.................................................................................................................... E-14
E.15 Appointment Details........................................................................................................... E-14
E.16 Create Appointment............................................................................................................ E-16
E.17 Attendees .............................................................................................................................. E-18
E.18 Appointment Invitation...................................................................................................... E-19
E.19 Reference............................................................................................................................... E-20
E.20 Repeating .............................................................................................................................. E-21
E.21 Attachments ......................................................................................................................... E-23
E.22 Add Attachments ................................................................................................................ E-24

F Oracle Interaction History User Interface Reference


F.1 The Outcomes Window ........................................................................................................ F-1

xx
F.2 The Results window.............................................................................................................. F-2
F.3 The Reasons Window ........................................................................................................... F-3
F.4 The Outcome-Result Window ............................................................................................. F-4
F.5 The Result-Reason Window ................................................................................................ F-4
F.6 The Action Item Window..................................................................................................... F-5
F.7 The Action Window.............................................................................................................. F-5
F.8 The Wrap Up Window ......................................................................................................... F-6

G Oracle Escalation Management User Interface Reference


G.1 Explanation of Escalation Manager Components ............................................................ G-1
G.2 Explanation of Business Rule Monitor Components ....................................................... G-3
G.3 Business Rule Monitor window .......................................................................................... G-3

Glossary

xxi
xxii
Send Us Your Comments
Oracle CRM Application Foundation User Guide, Release 11i
Part No. A97632-01

Oracle Corporation welcomes your comments and suggestions on the quality and
usefulness of this document. Your input is an important part of the information
used for revision.
■ Did you find any errors?
■ Is the information clearly presented?
■ Do you need more information? If so, where?
■ Are the examples correct? Do you need more examples?
■ What features did you like most?

If you find any errors or have any other suggestions for improvement, please
indicate the document title and part number, and the chapter, section, and page
number (if available). You can send comments to us at:
Oracle Corporation
CRM Application Foundation Content Development Manager
500 Oracle Parkway
Redwood Shores, CA 94065, USA

If you would like a reply, please give your name, address, telephone number, and
(optionally) electronic mail address.
If you have problems with the software, please contact your local Oracle Support
Services.

xxiii
xxiv
Preface

Intended Audience
Welcome to Release 11i of the Oracle CRM Application Foundation User Guide.
This guide assumes you have a working knowledge of the following:
■ The principles and customary practices of your business area
■ Oracle CRM Application Foundation
If you have never used Oracle CRM Application Foundation, Oracle suggests you
attend one or more of the Oracle CRM Application Foundation training classes
available through Oracle University.
■ The Oracle Applications graphical user interface
To learn more about the Oracle Applications graphical user interface, read the
Oracle Applications User Guide.
See Other Information Sources for more information about Oracle Applications
product information.

Typographic Conventions
The following table describes this documents typographic conventions.
:

Monospace text Monospace text represents code or SQL statements.


lowercase italics Lowercase italics in the text represent variables. Substitute an
appropriate value for the variable.

xxv
UPPERCASE Uppercase characters within the text represent command
names, SQL reserved words and keywords, and terms
associated with the Oracle database.
Indentation Indentation helps to show structure within code examples,
but is not required.
<text> Text inside angle brackets can mean either of the following:
■ It denotes a variable that is replaced with an actual value at
runtime.
■ In indicates XML elements in discussions about XML code.
Bold Text in bold either represents a button name or is used for
emphasis.

Documentation Accessibility
Our goal is to make Oracle products, services, and supporting documentation
accessible, with good usability, to the disabled community. To that end, our
documentation includes features that make information available to users of
assistive technology. This documentation is available in HTML format, and contains
markup to facilitate access by the disabled community. Standards will continue to
evolve over time, and Oracle Corporation is actively engaged with other
market-leading technology vendors to address technical obstacles so that our
documentation can be accessible to all of our customers. For additional information,
visit the Oracle Accessibility Program web site at
http://www.oracle.com/accessibility/.

Accessibility of Code Examples in Documentation


JAWS, a Windows screen reader, may not always correctly read the code examples
in this document. The conventions for writing code require that closing braces
should appear on an otherwise empty line; however, JAWS may not always read a
line of text that consists solely of a bracket or brace.

Accessibility of Links to External Web Sites in Documentation


This documentation may contain links to Web sites of other companies or
organizations that Oracle Corporation does not own or control. Oracle Corporation
neither evaluates nor makes any representations regarding the accessibility of these
Web sites.

xxvi
Other Information Sources
You can choose from many sources of information, including online documentation,
training, and support services, to increase your knowledge and understanding of
Oracle CRM Application Foundation.
If this guide refers you to other Oracle Applications documentation, use only the
Release 11i versions of those guides.

Online Documentation
All Oracle Applications documentation is available online (HTML or PDF). Online
help patches are available on MetaLink.

Related Documentation
Oracle CRM Application Foundation shares business and setup information with other
Oracle Applications products. Therefore, you may want to refer to other product
documentation when you set up and use Oracle CRM Application Foundation.
Oracle CRM Technology Foundation Implementation Guide contains information
relating to User Management including user registration and management
performed through the System Administrator’s Console.
You can read the documents online by choosing Library from the expandable menu
on your HTML help window, by reading from the Oracle Applications Document
Library CD included in your media pack, or by using a Web browser with a URL
that your system administrator provides.
If you require printed guides, you can purchase them from the Oracle Store at
http://oraclestore.oracle.com.

Documents Related to All Products

Oracle Applications User Guide


This guide explains how to enter data, query, run reports, and navigate using the
graphical user interface (GUI) available with this release of Oracle CRM Application
Foundation (and any other Oracle Applications products). This guide also includes
information on setting user profiles, as well as running and reviewing reports and
concurrent processes.
You can access this user guide online by choosing ”Getting Started with Oracle
Applications” from any Oracle Applications help file.

xxvii
Documents Related to This Product

Oracle CRM Application Foundation Implementation Guide


The Implementation Guide contains important reference and background
information on each of the CRM Application Foundation modules. In addition, it
contains procedures and implementing and System Administration tasks that are
necessary to perform in each of the modules.

Oracle CRM Application Foundation API Reference Guide


This manual describes the public, supported Application Foundation APIs. It
includes API information for the following Application modules:
■ Interaction History
■ Resource Manager
■ Task Manager
■ Fulfillment
■ Notes

Installation and System Administration

Oracle Applications Concepts


This guide provides an introduction to the concepts, features, technology stack,
architecture, and terminology for Oracle Applications Release 11i. It provides a
useful first book to read before an installation of Oracle Applications. This guide
also introduces the concepts behind Applications-wide features such as Business
Intelligence (BIS), languages and character sets, and Self-Service Web Applications.

Installing Oracle Applications


This guide provides instructions for managing the installation of Oracle
Applications products. In Release 11i, much of the installation process is handled
using Oracle Rapid Install, which minimizes the time to install Oracle Applications,
the Oracle8 technology stack, and the Oracle8i Server technology stack by
automating many of the required steps. This guide contains instructions for using
Oracle Rapid Install and lists the tasks you need to perform to finish your
installation. You should use this guide in conjunction with individual product user
guides and implementation guides.

xxviii
Oracle Applications Supplemental CRM Installation Steps
This guide contains specific steps needed to complete installation of a few of the
CRM products. The steps should be done immediately following the tasks given in
the Installing Oracle Applications guide.

Upgrading Oracle Applications


Refer to this guide if you are upgrading your Oracle Applications Release 10.7 or
Release 11.0 products to Release 11i. This guide describes the upgrade process and
lists database and product-specific upgrade tasks. You must be either at Release 10.7
(NCA, SmartClient, or character mode) or Release 11.0, to upgrade to Release 11i.
You cannot upgrade to Release 11i directly from releases prior to 10.7.

Maintaining Oracle Applications


Use this guide to help you run the various AD utilities, such as AutoUpgrade,
AutoPatch, AD Administration, AD Controller, AD Relink, License Manager, and
others. It contains how-to steps, screenshots, and other information that you need to
run the AD utilities. This guide also provides information on maintaining the
Oracle applications file system and database.

Oracle Applications System Administrator’s Guide


This guide provides planning and reference information for the Oracle Applications
System Administrator. It contains information on how to define security, customize
menus and online help, and manage concurrent processing.

Oracle Alert User’s Guide


This guide explains how to define periodic and event alerts to monitor the status of
your Oracle Applications data.

Oracle Applications Developer’s Guide


This guide contains the coding standards followed by the Oracle Applications
development staff. It describes the Oracle Application Object Library components
needed to implement the Oracle Applications user interface described in the Oracle
Applications User Interface Standards for Forms-Based Products. It also provides
information to help you build your custom Oracle Forms Developer 6i forms so that
they integrate with Oracle Applications.

Oracle Applications User Interface Standards for Forms-Based Products


This guide contains the user interface (UI) standards followed by the Oracle
Applications development staff. It describes the UI for the Oracle Applications

xxix
products and how to apply this UI to the design of an application built by using
Oracle Forms.

Other Implementation Documentation

Multiple Reporting Currencies in Oracle Applications


If you use the Multiple Reporting Currencies feature to record transactions in more
than one currency, use this manual before implementing Oracle CRM Application
Foundation. This manual details additional steps and setup considerations for
implementing Oracle CRM Application Foundation with this feature.

Multiple Organizations in Oracle Applications


This guide describes how to set up and use Oracle CRM Application Foundation with
Oracle Applications' Multiple Organization support feature, so you can define and
support different organization structures when running a single installation of
Oracle CRM Application Foundation.

Oracle Workflow Guide


This guide explains how to define new workflow business processes as well as
customize existing Oracle Applications-embedded workflow processes. You also
use this guide to complete the setup steps necessary for any Oracle Applications
product that includes workflow-enabled processes.

Oracle Applications Flexfields Guide


This guide provides flexfields planning, setup and reference information for the
Oracle CRM Application Foundation implementation team, as well as for users
responsible for the ongoing maintenance of Oracle Applications product data. This
manual also provides information on creating custom reports on flexfields data.

Oracle eTechnical Reference Manuals


Each eTechnical Reference Manual (eTRM) contains database diagrams and a
detailed description of database tables, forms, reports, and programs for a specific
Oracle Applications product. This information helps you convert data from your
existing applications, integrate Oracle Applications data with non-Oracle
applications, and write custom reports for Oracle Applications products. Oracle
eTRM is available on Metalink

xxx
Oracle Manufacturing APIs and Open Interfaces Manual
This manual contains up-to-date information about integrating with other Oracle
Manufacturing applications and with your other systems. This documentation
includes APIs and open interfaces found in Oracle Manufacturing.

Oracle Order Management Suite APIs and Open Interfaces Manual


This manual contains up-to-date information about integrating with other Oracle
Manufacturing applications and with your other systems. This documentation
includes APIs and open interfaces found in Oracle Order Management Suite.

Oracle Applications Message Reference Manual


This manual describes Oracle Applications messages. This manual is available in
HTML format on the documentation CD-ROM for Release 11i.

Oracle CRM Application Foundation Implementation Guide


Many CRM products use components from CRM Application Foundation. Use this
guide to correctly implement CRM Application Foundation.

Training and Support

Training
Oracle offers training courses to help you and your staff master Oracle CRM
Application Foundation and reach full productivity quickly. You have a choice of
educational environments. You can attend courses offered by Oracle University at
any one of our many Education Centers, you can arrange for our trainers to teach at
your facility, or you can use Oracle Learning Network (OLN), Oracle University's
online education utility. In addition, Oracle training professionals can tailor
standard courses or develop custom courses to meet your needs. For example, you
may want to use your organization’s structure, terminology, and data as examples
in a customized training session delivered at your own facility.

Support
From on-site support to central support, our team of experienced professionals
provides the help and information you need to keep Oracle CRM Application
Foundation working for you. This team includes your Technical Representative,
Account Manager, and Oracle’s large staff of consultants and support specialists
with expertise in your business area, managing an Oracle8i server, and your
hardware and software environment.

xxxi
OracleMetaLink
OracleMetaLink is your self-service support connection with web, telephone menu,
and e-mail alternatives. Oracle supplies these technologies for your convenience,
available 24 hours a day, 7 days a week. With OracleMetaLink, you can obtain
information and advice from technical libraries and forums, download patches,
download the latest documentation, look at bug details, and create or update TARs.
To use MetaLink, register at (http://metalink.oracle.com).
Alerts: You should check OracleMetaLink alerts before you begin to install or
upgrade any of your Oracle Applications. Navigate to the Alerts page as follows:
Technical Libraries/ERP Applications/Applications Installation and
Upgrade/Alerts.
Self-Service Toolkit: You may also find information by navigating to the
Self-Service Toolkit page as follows: Technical Libraries/ERP
Applications/Applications Installation and Upgrade.

Do Not Use Database Tools to Modify Oracle Applications


Data
Oracle STRONGLY RECOMMENDS that you never use SQL*Plus, Oracle Data
Browser, database triggers, or any other tool to modify Oracle Applications data
unless otherwise instructed.
Oracle provides powerful tools you can use to create, store, change, retrieve, and
maintain information in an Oracle database. But if you use Oracle tools such as
SQL*Plus to modify Oracle Applications data, you risk destroying the integrity of
your data and you lose the ability to audit changes to your data.
Because Oracle Applications tables are interrelated, any change you make using
Oracle Applications can update many tables at once. But when you modify Oracle
Applications data using anything other than Oracle Applications, you may change a
row in one table without making corresponding changes in related tables. If your
tables get out of synchronization with each other, you risk retrieving erroneous
information and you risk unpredictable results throughout Oracle Applications.
When you use Oracle Applications to modify your data, Oracle Applications
automatically checks that your changes are valid. Oracle Applications also keeps
track of who changes information. If you enter information into database tables
using database tools, you may store invalid information. You also lose the ability to
track who has changed your information because SQL*Plus and other database
tools do not keep a record of changes.

xxxii
About Oracle
Oracle Corporation develops and markets an integrated line of software products
for database management, applications development, decision support, and office
automation, as well as Oracle Applications, an integrated suite of more than 160
software modules for financial management, supply chain management,
manufacturing, project systems, human resources and customer relationship
management.
Oracle products are available for mainframes, minicomputers, personal computers,
network computers and personal digital assistants, allowing organizations to
integrate different computers, different operating systems, different networks, and
even different database management systems, into a single, unified computing and
information resource.
Oracle is the world’s leading supplier of software for information management, and
the world’s second largest software company. Oracle offers its database, tools, and
applications products, along with related consulting, education, and support
services, in over 145 countries around the world.

xxxiii
xxxiv
Part I
Resource Manager

This part of the Oracle CRM Application Foundation User Guide contains the
following chapters:
■ Introduction to Oracle Resource Manager
■ Overview of Using Oracle Resource Manager
■ Managing Employee Resources
■ Searching for Resources
■ Managing Group Resources
1
Introduction to Oracle Resource Manager

This chapter covers the following topics:


■ Overview of the Oracle Resource Manager
■ Oracle Resource Manager Integrations
■ Process Flow for Oracle Resource Manager
■ What’s New in This Release
■ Terms and Definitions
■ Resource Manager Rules for HTML

1.1 Overview of the Oracle Resource Manager


Resource Manager enables other modules and applications to use resources no
matter where they were created. It acts as a central repository for various types of
resources. You can further define your resources by organizing them into groups
and teams and assigning various roles to them. Whether or not resources are
created in Resource Manager, you can import various types of resources, such as
employees, suppliers, parties, or partners, which are created in other Oracle
applications into Resource Manager. Once imported, they become available for
other modules and applications to use. You can also update information about
resources (which were created in other applications) by using a variety of
concurrent programs to synchronize your information.
Resource Manager can be accessed from Forms and HTML depending on use and
who is using it. Furthermore, depending on whether or not it is used as a
stand-alone module, or if it is integrated with other applications or modules, its
appearance can change. For example, when coupled with the HTML Calendar,

Introduction to Oracle Resource Manager 1-1


Overview of the Oracle Resource Manager

Resource Manager appears as a tab labeled "People". This section covers the
following topics:
■ What is the Resource Manager?
■ What are Resources?
■ Understanding Roles
■ Understanding Groups
■ Determining Group Hierarchy
■ Understanding Teams
■ What is a Salesperson?
■ How are the Different Resource Names Fields Used?

1.1.1 What is the Resource Manager?


Resource Manager provides lists of resources, as individuals, groups, and teams, for
applications to access and manage their resources. Defining and organizing your
resource information makes your resources available to the calling application
modules for work action.
Use Resource Manager to:
■ Import employees from Oracle HRMS, parties and partners from Oracle
Accounts Receivables, and supplier contacts from Purchasing.
■ Identify resources as salespeople. The only resource you can define in the
Forms-based Resource Manager is a salesperson. In the HTML-based Resource
Manager, you can define and identify employee resources as salespeople. This
employee information is also recorded in the Oracle Human Resources
Management System (HRMS) tables and automatically becomes a CRM
resource.
■ Assign additional attributes to the resources so that these resources can be
used by other applications. In the Forms-based Resources window, you can
enter or view additional information in the Service, Interaction Center,
Compensation, or Receivables tab for any selected resource.
■ Create a resource group and team structure by using Resource Manager to
better manage resources for particular business needs. Team resources can be
created in the Forms-based Resource Manager only.

1-2 Oracle CRM Application Foundation User Guide


Overview of the Oracle Resource Manager

■ Assign individual resources with resource roles and role types to groups and
teams. This allows you to assign groups of people with the appropriate
resources to specific tasks.

Example
Sue Smith, a new sales manager at Vision, Inc. wants to establish all her employees
and outside contacts in the E-Business suite. She imports her subordinate group of
salespeople from HRMS, her list of top ten customers (parties) from various
customer accounts, and her list of plant managers (supplier contacts) from the
companies that design and engineer her products. To make sure her sales team gets
paid their commissions, she defines each one as a salesperson. This information is
recorded in the HRMS tables.
To make her organization more efficient, Sue decides to create two resource groups,
one of all her outside salespeople and one for all her inside sale people. She also
decides that an upcoming sales campaign will need a group of cross functional
people to target her goal. So she also creates a team called Campaign Z. This team is
made up of ten sales people, six marketing representatives, two collateral writers,
and a project manager to oversee the group.

1.1.2 What are Resources?


Resources are defined as the employees, supplier contacts, parties, and partners that
are used by the different CRM components to accomplish business objectives. The
following table describes all five resource categories used in Resource Manager.

Table 1–1 Resource Category Descriptions


Resource Description
Employee An employee is a person who has been hired to work for a
company. Resources of type "Employee" are imported as
resources from Human Resources Management System
(HRMS). Examples of an Employee resource include a Sales
Representative or a Field Service Engineer.
Supplier Contact A supplier contact is the contact information for a person or
agency that sells raw material or goods. Resources of type
"Supplier" can be imported as resources from the Oracle
Purchasing (PO) application. An example of a supplier contact
is a Sales Representative or Field Service Engineer who is a
contact for a vendor.

Introduction to Oracle Resource Manager 1-3


Overview of the Oracle Resource Manager

Table 1–1 Resource Category Descriptions


Resource Description
Party A party is an entity that can enter into a business relationship.
Resources of type "Party" can be imported as resources from
Oracle Accounts Receivables. An example of a party is a
customer.
Partner A partner is one of two or more persons who contribute
capital to establish or maintain a commercial venture and who
usually share in the risks and profits. A Partner resource can
be imported as resources from Accounts Receivables.
Other/TBH Other/TBH is the only resource that is created and not
imported in the Forms-based Resource Manager. Use this
resource to create a salesperson that is going to be hired (TBH)
but is not yet an employee.

Resources can be organized into groups and teams. Each group or team is defined
in one of two ways, a role or a role type.

1.1.3 Understanding Roles

Roles
A role can encompass one or more job descriptions and job titles (Field Service
Representative), or functions within the applications (such as default marketing
approver, MES_Publish, and Channel_Manager). You assign roles to resources,
resource groups, and resource teams. For example, the seeded roles for Sales
include manager, administrator, approver, and representative. The seeded roles for
Telesales include manager, administrator, and agent. You can define custom roles
for your business needs. Ensure that a role type exists so that you can associate the
new role.

Role Types
A role type is a collection of roles associated with a particular CRM module.
Examples are Sales, Telesales, Marketing, Sales Compensation, Support, and Call
Center are all role types. Role types are seeded by the different modules that access
the Resource Manager. You can define custom role types for your business needs.

Example
Think of role types as a "family" and its members as having the various "roles" with
in the family.

1-4 Oracle CRM Application Foundation User Guide


Overview of the Oracle Resource Manager

Sales (role type)


Roles: manager, administrator, representative, and sales approver

Role Attributes
Role attributes are associated with each role, and define its responsibility within the
group. In addition to these responsibilities, a role attribute can also be designated as
active (currently), and seeded (available out-of-the-box).
There are four seeded role attributes that can be associated to roles at role creation:
■ Member: Default when another attribute is not chosen (Lead, Administrator,
Manager.)
■ Lead: Used in the context of team lead.
■ Administrator: Used to grant this user permission to view information about
other group members. In the HTML-based Resource Manager, only a user in a
group with either the Administrator or Manager group member role attribute
can update group member and group hierarchy information.
■ Manager: Used to set up the group reporting hierarchy. For example, all the
forecasts for a group of sales representatives will roll up to the person with the
Manager role attribute in that group. In addition, a user with the Manager
group member role attribute can update the group member and group
hierarchy information in the HTML Resource Manager.
You use these role attributes to define how a resource is reporting hierarchy. This
hierarchy is used in sales product families, such as Sales Online and Telesales, to
control the data access privilege (customer, sales lead, and sales opportunity) as
well as sales forecast rollup and incentive compensation plan through the group
functionality. It is also used for workflow notifications and escalations. For example,
if you set up an escalation for service requests and tasks, notifications for members
of groups go to the manager.

Introduction to Oracle Resource Manager 1-5


Overview of the Oracle Resource Manager

Example
The following table lists example role types, and the seeded roles associated with
each along with their attributes.

Table 1–2 Example of Roles, Role Attributes, and Role Types


Role Type Seeded Roles Role Attribute
Sales ■ Manager ■ Manager, Active, Seeded
■ Administrator ■ Admin, Active, Seeded
■ Approver ■ Member, Active, Seeded
■ Representative ■ Member, Active, Seeded
Telesales ■ Manager ■ Manager, Active, Seeded
■ Administrator ■ Admin, Active, Seeded
■ Agent ■ Member, Active, Seeded

See Also
■ Understanding Groups
■ Understanding Teams

1.1.4 Understanding Groups


The following concepts are useful in understanding the groups function in Resource
Manager.

Resource Groups
A group is based on the similar functionality or the roles of its members. It can
consist of individual resources and groups. For example, Linda’s group includes
individual resources, John, Mark, and Carol, as well as another resource group,
Mary’s group. A resource can belong to one or many groups at one time.

Group Member Roles


Roles and responsibilities are commonly associated with all members of a resource
group, but not all group roles need to be filled. For example, a sales group has one
sales manager and a few sales representatives. The sales manager and the sales
representative are job roles assigned to the group members.

1-6 Oracle CRM Application Foundation User Guide


Overview of the Oracle Resource Manager

Each member can have multiple roles defined within a group. For example, Mid
West Sales Group consists of only two people due to resource constraints, one of
them plays two roles, sales manager and field sales agent, at the same time.

Group Roles
Multiple roles can be assigned to a resource group. For example, Group A has three
resources (an employee, a Party, and a Partner). Those three resources play a role in
Group A, even if they have different roles assigned to them individually. The Party
can have an individual Team role but the role it plays in group A is the Manager
role.

1.1.5 Determining Group Hierarchy


Individual resources can be assigned to a group, and a group can belong to another
group or to multiple groups. Resources therefore can be organized through a group
hierarchy with a parent-child relationship.

Example
Jack William and Frank Nelson are sales representatives who belong to the Product
A group and directly report to Pat Smith, the Sales Manager of Product A. However,
Jack and Frank indirectly report to Jeff Walsh who leads the Field Sales Group as
Field Sales Manager. The Field Sales Group and the Product A group have a
parent-child relationship. You can use the group hierarchy to view direct reporting
or all reporting information for a resource. Refer to the Viewing Group Hierarchy
procedure in the Implementation Guide for detailed information.

1.1.6 Understanding Teams


You create Teams only in the Forms-based Resource Manager. The following
concepts are useful in understanding the Teams function in Resource Manager.

Resource Teams
A team is a collection of cross-functional resources. Team members are chosen for
their availability and qualifications. You define a team to organize the necessary
resources to accomplish an objective or a particular task. Teams consists of groups
and individual resources that work together to efficiently complete a project. A
resource can belong to multiple resource teams. For example, a solution team can
have support and sales groups as well as a telesales agent as an individual resource.

Introduction to Oracle Resource Manager 1-7


Overview of the Oracle Resource Manager

Team Member Roles


Each team member, whether or not it is an individual resource or a resource group,
can have multiple roles assigned to a team. For example, a team member can have
both Sales Manager and Sales Representative roles due to resource constraints in a
team.

Team Roles
You can assign multiple roles to a team. For example, a solution team plays a
support manager role, and a sales approver role at the same time while sales
demand is strong.

1.1.7 What is a Salesperson?


A salesperson is any person involved in the sale or support of products and
services. Salespeople are typically field personnel, but can also be support groups
and other product specialists involved either directly or indirectly in generating
revenue for the organization.
Depending on their relationship to the sales organization, salespeople can be
internal employees or external people or organizations. Employees, Parties,
Partners, and Supplier Contacts can all be further defined as salespeople by having
sales numbers and relevant information assigned to them after being imported to
the Resource Manager. However, these imported resources always carry their
original resource categories of Employee, Party, Partner, or Supplier Contact. These
resource categories never change.

Example
Your company partners with Vision Enterprises to promote certain products. Vision
Enterprises can be imported as category “Partner” from Accounts Receivables and
be given a sales number and relevant information, thus Vision Enterprises becomes
a salesperson and can be assigned to your group or team, still with the same
category "Partner" for marketing campaign or opportunities.
In addition to imported resources, the only resources you can create, and not
import, is a salesperson with resource category of OTHER, or TBH (to be hired) in
Forms, and a salesperson in HTML.

1.1.8 How are the Different Resource Name Fields Used?


There are several name fields that are associated with Resource Manager:
■ Employee Name

1-8 Oracle CRM Application Foundation User Guide


Overview of the Oracle Resource Manager

■ Source Name
■ Resource (Preferred) Name
■ Salespersons Name
■ User Name
An employee name is usually your legal name. It is also the source name which
you can see in the Forms UI. The source name derives from HRMS before the
resource is imported, or when a resource is created in Resource Manager.
The resource (preferred) name is the name that is available to the other modules or
applications from Resource Manager. For example, perhaps your first name is
difficult to pronounce and you have always used a nickname. That nickname is
your resource name.
The salespersons name is not visible in either of the Forms or HTML UIs but is
recorded in the Resource Manager Salesreps table. However, there is a Salesperson
Name field in the HRMS application.
The user name is generally one brief name that is used for e-mail and logging into
applications and it never changes.

Understanding the Differences of the Various Name Fields


An employee can be created in HRMS. When the employee is imported into
Resource Manager, the full name is populated in the Resource Name and Source
Name fields. If the resource is also a salesperson, then the salespersons name is
populated with the resource name. Any changes made to the resource name, are
automatically reflected to the salespersons name.

Note: The resource name and salespersons name are always the
same regardless of resource category. The source name and
employee name are always the same for category Employee.

Example
Penelope Smith joins Vision Enterprises as a salesperson. Her employee data was
created in HRMS, and imported into Resource Manager.

Resource Name: Penelope Smith


Source or Employee Name: Penelope Smith

Introduction to Oracle Resource Manager 1-9


Overview of the Oracle Resource Manager

Salespersons Name: Penelope Smith

Her customers know her by the nickname Penny. So she changes her resource name
in the HTML version of Resource Manager to Penny since that is what she prefers
people to call her.

Resource Name: Penny Smith


Source or Employee Name: Penelope Smith
Salespersons Name: Penny Smith

Later in the year she marries and decides to use her husband’s last name, Jones. So
HRMS changes her last name as requested and the Resource Administrator runs the
Synchronize Employees concurrent program. At this time, she prefers to use her
given name so customers will not be confused.

Resource Name: Penny Smith


Source or Employee Name: Penelope Jones
Salespersons Name: Penny Smith

Later in the year, she decides that she wants to append her new last name to her
maiden name. The Resource Administrator changes her resource name accordingly
which is reflected in her salespersons name as well. In this example, the
Synchronize Employees concurrent program was run.

Resource Name: Penny Smith-Jones


Source or Employee Name: Penelope Jones
Salespersons Name: Penny Smith-Jones

Later in the year, she decides that she wants to append her new last name to her
maiden name. The Resource Administrator changes her resource name accordingly
which is reflected in her salespersons name as well. In this example, the
Synchronize Employees concurrent program was not run.

1-10 Oracle CRM Application Foundation User Guide


Oracle Resource Manager Integrations

Resource Name: Penny Smith-Jones


Source Name: Penelope Jones
Employee Name: Penelope Smith-Jones
Salespersons Name: Penny Smith-Jones

1.2 Oracle Resource Manager Integrations


The entire CRM suite uses Resource Manager to import and view resources, define
resources (salespeople), define roles and role types, create teams and groups, and
organize resources within those teams and groups.
For example, the following CRM modules use Resource Manager to define or
schedule resources:
■ Marketing uses Resource Manager to set up marketing groups and execute
marketing campaigns.
■ Service uses group and team lists of resources from Resource Manager for
service request assignments.
■ iSupport uses Resource Manager to set up support groups to fulfill service and
support needs.
■ Incentive Compensation uses Resource Manager to set up sales representatives
and sales compensation group hierarchies.
■ Call Center uses Resource Manager for call center routing.
■ Sales Online uses Resource Manager to set up a sales hierarchy.

The following CRM Application Foundation modules also use Resource Manager:
■ Forms-based Calendar uses Resource Manager to track the availability of
resources.
■ Interaction History uses Resource Manager to provide touch points.
■ Assignment Manager uses Resource Manager to provide a list of qualified
resources.
■ Territory Manager uses Resource Manager to select the resources for a
particular territory.

Introduction to Oracle Resource Manager 1-11


Process Flow for Oracle Resource Manager

■ Task Manager uses Resource Manager to provide single, group, and team lists
of resources for task assignments.

Resource Manager uses the concept of the Oracle Trading Community Architecture
(TCA). You can import resources from the following different sources:
■ Resources of category “Party” and “Partner” can be imported from Accounts
Receivables (AR) to Resource Manager and can become available resources. You
can only import partners that are defined as an organization, however you can
subsequently define the imported party as a sales person and assign it a sales
number and other relevant information.
■ Resources of category “Supplier Contact” can be imported as resources from
one or more supplier sites. When importing supplier contacts from Purchasing
(PO), the supplier contact must exist in the PO_VENDOR_CONTACTS table
and be effective on the given date of import.
■ Resources of category “Employee” can be imported as resources from Human
Resource Management System (HRMS). The employee must exist in table
PER_ALL_PEOPLE_F and be effective on the given date of import.

1.3 Process Flow for Oracle Resource Manager


The following table describes the order and process of using Resource Manager.

1-12 Oracle CRM Application Foundation User Guide


What’s New in This Release

Table 1–3 Resource Manager User Process


Steps Description Type Performed By
View and Update: ■ (Optional) View and update your personal HTML All Users
information to keep it current.
■ Personal Information
■ Use the organizational structure to view
■ Organizational
managers and subordinates.
Structure
■ View and update Group membership
■ Group Membership
information.
Information
■ View and Define a ■ (Optional) View a resource’s skill rating, as HTML All Users
Skill Rating well as define your own skills. This allows
Only the System
others to see where your level of expertise is,
■ Change the Name of Administrator can
for example if your manager was manually
a Skill Rating assign a numeric
reassigning a service request through the
value to a skill
■ Assign a Numeric Assignment Manager module and needed
rating.
Value to a Skill someone who was immediately available and
Rating with your set of skills.
■ (Optional) The Skill levels are editable, but
you cannot delete any of them without
entering a new name or its value.
■ (Optional) Convert the skill rating to a
numeric system.
Search for Resources (Optional) Use Resource Manager to search for a Forms All Users
resource. HTML
Define Group Hierarchy (Optional) Use Resource Manager to define group HTML All Users
hierarchy.
View: (Optional) Use Resource Manager to view role Forms All Users
types, roles, and role attributes to verify they are HTML
■ Role Types
consistent with your business logic.
■ Roles
■ Role Attributes

1.4 What’s New in This Release


This release of CRM Application Foundation has the following new features in
Resource Manager subsequent to the 11.5.7.4 release:

Profile Option: Resource Active Days After Termination of Relationship


The Synchronize Parties and Partners concurrent program end dates a resource in
Resource Manager when either the party is inactivated or the relationship is end

Introduction to Oracle Resource Manager 1-13


What’s New in This Release

dated in TCA. However there are times, for example, for compensation reasons,
where it is important that the resource stay active in Resource Manager even if it is
end dated in TCA. This profile option, which is defaulted at 30 days, will keep the
resource active in Resource Manager until the day after the default date. Set at the
site level, a system administrator can enter the day equal to any positive whole
integer.

Ability to View and Run Skills Report


Using a new concurrent program, Resource Skills Report, you can view skills and
their ratings associated to a resource either as a Resource report or a Group report.
If you choose to run a Skills Report by resource, then any direct reports under the
resource will be included in the report. If you choose to run a Skills Report by
group, then the entire group’s skill set will be displayed.

Ability to Synchronize End Dates for Partner Relationship Resources


You can now synchronize the end date of an imported partner relationship resource
in Resource Manger with the end date of the partner relationship resource from
which it was imported. For instance, if you import a partnership resource from OSO
and the end date for that partnership resource is subsequently changed in that
environment, synchronization enables you to provide the imported resource with
an identical end date and to augment that end date with the value specified in a
profile option if necessary.

Resources Can be Assigned Skills by Product and Problem Code


You can now define skills by problem code and product. Resource Manager enables
you to define skills using the following combinations:
■ Product
■ Product and component
■ Product and problem code
■ Problem code
■ Problem code and category
■ Platform
■ Platform and Category

1-14 Oracle CRM Application Foundation User Guide


Terms and Definitions

Note: Resources created in the Forms version of Resource


Manager are viewable in the HTML version. The same is true for
resources created in HTML.

1.5 Terms and Definitions


The following table describes terms and definitions associated with the Resource
Manager.

Table 1–4 Resource Manager Terms and Definitions


Term Description
Employee An employee is a person who has been hired to work for a
company. Employee resources can be imported as resources
from the Human Resources Management System (HRMS).
Resource Manager A single place for defining, accessing, and maintaining all
CRM and ERP resources.
Category A category is the highest level that a resource can be rated in
relation to skills management. If a resource is rated at the
category level, and not rated at any one of the product,
platform, or product code levels, it does not imply the resource
is also rated at those levels. Categories can be rated with the
following: Foundation, Intermediate, Skilled, Advanced,
Expert, or N/A.
Component Within a product in skills management, there are numerous
components. A resource can be rated individually for each of
those components. Components can be rated with the
following: Foundation, Intermediate, Skilled, Advanced,
Expert, or N/A.
Other/TBH This is the only resource that is created and not imported. Use
this resource to create a salesperson that is going to be hired
(TBH) but is not yet an employee.
Partner A partner is one of two or more persons who contribute
capital to establish or maintain a commercial venture and who
usually share in the risks and profits. A Partner resource can
be imported as resources from Accounts Receivables.
Party A party is an entity that can enter into a business relationship.
A party resource can be imported as resources from Accounts
Receivables.

Introduction to Oracle Resource Manager 1-15


Terms and Definitions

Table 1–4 Resource Manager Terms and Definitions


Term Description
Platform Within a category, there could be numerous platforms in Skills
Management. A resource can be rated individually for each of
those platforms. Platforms can be rated with the following:
Foundation, Intermediate, Skilled, Advanced, Expert, or N/A.
Problem Code Within a category in Skills Management, there could be
numerous problem codes. A resource can be rated
individually for each of those problem codes. Problem Codes
can be rated with the following: Foundation, Intermediate,
Skilled, Advanced, Expert, or N/A.
Product Within a category in Skills Management, it is possible to have
numerous products. A resource can be rated individually for
each of those products. A product can be sub-divided into
components. Products can be rated with the following:
Foundation, Intermediate, Skilled, Advanced, Expert, or N/A.
Resource A resource is the basic element of the Resource Manager and is
defined as people, places and things.
Resource Category There are five types of resources: Party, Employee, Partner,
Supplier Contact, To Be Hired (TBH), and Other.
Skills Management Skills Management provides the ability to add a new skill
rating to a resource. The resource can update and maintain
their skill rating, attach a numeric value to each skill level, and
change the actual name of each skill level.
Supplier Contact A supplier contact is the contact information for a person or
agency that sells raw material or goods. Supplier resources can
be imported as resources from the Purchasing (PO)
application.
Workflow Oracle Workflow automates and continuously improves
business processes, routing information of any type according
to business rules you can change. The rules, which we call a
workflow process definition, include the activities that occur
in the process and the relationship between those activities. An
activity in a process definition can be an automated function
defined by:
■ a PL/SQL stored procedure or an external function
■ a notification to a user or role that may request a response
■ a business event
■ a subflow that itself is made up of many activities

1-16 Oracle CRM Application Foundation User Guide


Resource Manager Rules for HTML

1.6 Resource Manager Rules for HTML


Resource Manager has several rules it follows for security purposes:
■ The logged in user can only modify his information.
■ A user can not update their own job title.
■ A manager of a group cannot change his directs personal information except for
skills.
■ An administrator can change any resource’s personal information.
■ Group Hierarchy is the ability to alter the group structure.
– A member of a group who has a role within that group and the role type of
admin can update the group hierarchy.
– A member of a group who has a role within that group and the role type of
admin can edit group structure of the child groups of the parent group
where they have this role.
– A manager of a group who has a role within that group and the role type of
admin or manager can update the group hierarchy.
– A manager of a group who has a role within that group and the role type of
admin or manager can edit group structure of the child groups of the parent
group where they have this role.
■ Skills Management is the ability to rate resources based on skill level.
– Only positive integers are acceptable for skill ratings.
– No two skill ratings can have the same numeric value.
– You cannot change the numeric value of the category N/A.
– Skill rating names are editable for specific business needs.
– No two skill ratings can have the same name.
– A resource’s manager cannot add or modify new skill levels to his
subordinates.
– Any user can view a resource’s skill rating.
■ Web Availability is the ability for a resource to make their status web available
or unavailable in Forms.
– Only the logged in resource can make their status available or unavailable.

Introduction to Oracle Resource Manager 1-17


Resource Manager Rules for HTML

1-18 Oracle CRM Application Foundation User Guide


2
Overview of Using Oracle Resource
Manager

This chapter covers the following topics:


■ Accessing Oracle Resource Manager Interface
■ Summary of Oracle Resource Manager Tasks

2.1 Accessing Oracle Resource Manager Interface


The Resource Manager can be called from other applications. In HTML, it is a tab,
called "People" within other applications or modules. Therefore the responsibilities
and navigation path will vary. The following tables describes how you can access
the Resource Manager:

Table 2–1 Resource Manager Navigation Paths


Description Responsibility Navigation Path
The Stand-alone ■ CRM Administrator or Select Resource Manager
Forms-based Resource in the Navigator window.
■ CRM Resource Manager
Manager
responsibility
The Stand-alone CRM Application Foundation Select the People tab. Use
HTML-based Resource User responsibility the Employees subtab or
Manager Groups subtab to access
the employee or group
resource windows.
HTML-based Resource Resource Self Service Select the Administration
Manager for Administrator responsibility tab to access the setup
administrative duties windows.

Overview of Using Oracle Resource Manager 2-1


Summary of Oracle Resource Manager Tasks

Table 2–1 Resource Manager Navigation Paths


Description Responsibility Navigation Path
The Forms-based or Resource Manager can be Example: Select Resource
HTML-based Resource accessed through different CRM Manager > Maintain
Manager from other CRM applications. Resources > Groups.
applications
Example: You can create group
resources in Forms by selecting
the Customer Support
responsibility.

Note: There is a bug in the Netscape browser that can affect


Resource Manager. Do not use the Back button, as you may loose
your data. It is recommended that you use the Resource Manager
user interface (UI). The Internet Explorer browser does not have
this issue.

2.2 Summary of Oracle Resource Manager Tasks


Use Oracle Resource Manager to perform the following types of tasks:
■ Chapter 3, Managing Employee Resources
■ Chapter 4, Searching for Resources
■ Chapter 5, Managing Group Resources

2-2 Oracle CRM Application Foundation User Guide


3
Managing Employee Resources

This chapter covers the following topics:


■ Viewing Your Personal Information
■ Defining Your Personal Information
■ Viewing Your Organizational Structure
■ Defining your Skill Rating
■ Viewing a Resource’s Skill Ratings
■ Making a Resource Web Available

3.1 Viewing Your Personal Information


In HTML, by clicking the Preferred Name hyperlink in the Employees window, you
can open the Resource Details window to view and maintain personal information.
Perform the following steps to view your personal information.

Note: Click the People tab to return to the Employee summary


window.

Prerequisites
None

Responsibility
CRM Application Foundation User

Managing Employee Resources 3-1


Defining Your Personal Information

Navigation
Navigate to the People tab.

Steps
1. After you log in to Resource Manager, the Employee’s window opens with your
employee details. The information that appears is based on the user login.
2. Click on your preferred name.
The Resource Detail window opens with your personal information.

See Also
■ Defining Your Personal Information
■ Viewing Your Organizational Structure

3.2 Defining Your Personal Information


Your personal information is maintained by you, or a resource administrator with
the Resource Self Service Administrator responsibility only. Your direct manager
cannot update your personal information, but can view it.
In HTML, by clicking the Preferred Name hyperlink in the Employees window, you
can open the Resource Details window to maintain personal information. Perform
the following steps to define or change your personal information.

Note:
■ Click the People tab to return to the Employee summary
window.
■ Use the links following the navigation bar to quickly navigate
to the designated section within the Resource Details window.
■ Fields can only by updated if set by the administrator.

Prerequisites
None

Responsibility
CRM Application Foundation User

3-2 Oracle CRM Application Foundation User Guide


Defining Your Personal Information

Navigation
Navigate to the People tab.

Steps
1. After you log in to the Resource Manager, the Employee’s window opens with
your employee details. The information that appears is based on the user login.
2. Click your preferred name.
3. (Optional) Update your preferred name.
4. (Optional) Enter your various numbers:
■ Work
■ Mobile
■ Pager
5. Enter your email address.
No validation is made to determine if the email address is correct or even exists.
6. Enter your personal information:
a. Enter search criteria for your Job Title (at least three characters) and click
Go to search for matching titles.
The Select a Job Title window opens.
b. Click your job title to populate the field.
c. To search for your manager, enter at least three characters and click Go.
d. Click on your manager’s name to populate the text field.
The category (Employee), resource number, source number, and start date
are automatically populated.
e. (Optional) Enter your end date.
7. Enter your location information following the Work Location heading.
a. Use the drop-down to select your work address.
b. Enter your office number.
c. Enter your mailstop.
d. Enter your office location.

Managing Employee Resources 3-3


Defining Your Personal Information

8. Under the Sales Team Details heading, your salesperson number is


automatically populated.
9. Use the drop-down list to select a sales credit type.
10. Under the Service Heading, enter the following information:

a. Use the drop-down list to select your time zone.


b. Use the drop-down list to select the support site.
c. Use the drop-down lists to select your primary and secondary languages.
d. Enter a numeric value for your pay rate per hour.
11. Under the Resource Roles heading, define the following information:

a. Use the drop-down list to select the role type.


b. Click Go in the role column to select the role that corresponds to the role
type.
c. Click on the role to populate the text field.
The start date is automatically populated with the current date.
d. Enter the end date in the following format (24-Jul-2001) or click the Date
Picker to select a date.
12. Under the Group Membership heading, enter your group membership
information.
a. Enter search criteria for the group name (at least three characters) and click
Go.
The Select a Group window opens.
b. Click the group to populate the field.
c. Use the drop-down list to select the role type.
d. Enter search criteria for a role (at least three characters) and click Go.
The Select a Role window opens.
e. Click the role to populate the field.
f. Enter the start date in the following format (24-Jul-2001) or click the Date
Picker to select a date.
g. Enter the end date in the following format (24-Jul-2001) or click the Date
Picker to select a date.

3-4 Oracle CRM Application Foundation User Guide


Viewing Your Organizational Structure

h. Click the Remove icon to clear the row so you can reenter your information.
i. Click Show History to view the group membership history.
13. Click Update to save your information or click Restore to reset the original
values in the window.

See Also
■ Viewing Your Personal Information
■ Viewing Your Organizational Structure

3.3 Viewing Your Organizational Structure


The HR organization information can be viewed in HTML either by selecting a job
title hyperlink in the Employees window, or by selecting the Organization
hyperlink from the side navigation menu for a selected resource.

Example
After displaying a subordinate’s personal information in the Resource Details
window, a manager can select the Organization hyperlink from the side navigation
menu to display the organization structure. If she has any subordinates reporting to
her, then her direct’s information is also shown in this organization chart. She can
then click any of her direct’s hyperlinks to view detailed personal information.
Besides using the Organization side navigation link, she can click the Job Title
hyperlink in the Employees window to get to the same screen.
She can also use the Quick find or Advanced Search to first locate the desired
resource and then either select the Organization hyperlink on the side navigation
bar, or the Job Title hyperlink in the Employees window to see the organization
structure. Perform the following steps to view the organizational structure of a
resource.

Managing Employee Resources 3-5


Viewing Your Organizational Structure

Note:
■ Click the People tab to return to the Employee summary
window.
■ If changes are made to the employee’s manager field in the
Resource Details window, then the Flatten Employee Hierarchy
concurrent program should to be run in order to reflect the
changes in the organization chart when you view them. Refer
to Appendix B in the CRM Application Foundation
Implementation Guide for details on running Concurrent
Programs.

Prerequisites
None

Responsibility
CRM Application Foundation User

Navigation
Navigate to the People tab.

Steps
1. The Employee’s window opens (default) with your employee details.
2. Click Organization from the side navigation bar.
Your organizational structure, including information about you and your
manager, appears in the Details window.
3. To see the next upper level, click the job title hyperlink.

See Also
■ Viewing Your Personal Information
■ Defining Your Personal Information

3-6 Oracle CRM Application Foundation User Guide


Defining Your Skill Rating

3.4 Defining Your Skill Rating


Using Skills Management, a resource can maintain their skills at various levels
including category (such as CRM or ERP), product name (1198 – CRM Application
Foundation), product component (JTF_RES), platform (Sun Server), and problem
code (such as fix server, install problem, or documentation problem). These ratings
are used by customer support teams to select the best resource to assign to a service
request. Perform the following steps to rate the resource skill at the category level.

Example
Rhonda Abbott, a support agent, has experience in Resource Manager, one
component within CRM Application Foundation. After logging in, she can select
herself in the Employees window, and then select Skills from the side bar to access
the Skills window. Clicking the Add New Skill button to open the Rate Skill
window, she can then select appropriate category code (CRM), type (Product),
product name (Application Foundation), and product component name (Resource
Manager). Rhonda can rate herself as “Experienced” in the Level field for this
specific product component. By clicking the Create button, Rhonda can view her
skill summary information in the Skills window.

Note:
■ Category, Product Name and Component information are set
up in Oracle Inventory.
■ If a Problem Code or Platform is selected in the Type field, then
the Component field is not available.
■ Managers and team leads can review and adjust a
subordinate’s ratings.

Prerequisites
None

Responsibility
CRM Application Foundation User

Navigation
Navigate to the People tab.

Managing Employee Resources 3-7


Defining Your Skill Rating

Steps
1. After logging in to Resource Manager, the Employee’s window opens with
employee details.
2. Click on your preferred name.
3. Click Skills on the side navigation bar.
4. Click Add New Skill.
5. Click Go next to the Category text field.
6. Click the category you want to use.
The information automatically populates the text field and you are returned to
the Skills window.
7. Use the drop-down list to select a Type. Options include: Platform, Problem
Code, or Product.

Note: If you want to assign a problem code to a product within a


category then choose Product from the drop-down list. When the
page refreshes, you can optionally specify a problem code for the
product. If you want to assign a problem code directly to a
category, choose Problem Code from the drop down menu. When
the page refreshes no product information is associated with the
problem code.

8. Click Go next to the Name text field.


Depending on the type you selected, one of three windows will appear: The
Select a Platform window, the Select a Problem Code Window, or the Select a
Product window opens.
9. Click the choice you want to use.
The information automatically populates the text field and you are returned to
the Skills window.
10. If you select Product:

a. Click Go next to the Component text field.


The Select a Component window opens.
b. Select the component you want to use.

3-8 Oracle CRM Application Foundation User Guide


Viewing a Resource’s Skill Ratings

The information automatically populates the text field and you are returned
to the Skills window.
11. Use the drop-down list to select your Skill Level. Options include: Not
Applicable, Expert, Experienced, Knowledged.
12. Click Create.
The new skill is added to the Skills window.

3.5 Viewing a Resource’s Skill Ratings


Any logged in resource can view another resource’s skill ratings. Perform the
following steps to view a resource’s skill rating.

Prerequisites
None

Responsibility
CRM Application Foundation User

Navigation
Navigate to the People tab.

Steps
1. After logging in to Resource Manager, the Employee’s window opens with your
employee details.
2. Search for the resource whose skill rating you want to view.
3. Click the resource’s preferred name.
The Resource Details window opens.
4. Click Skills on the side navigation bar.
The Skills window opens with a list of skills and ratings.
5. Click the skill to view the details.

See Also
Defining Your Skill Rating

Managing Employee Resources 3-9


Making a Resource Web Available

3.6 Making a Resource Web Available


The purpose of making a resource web available (or unavailable) is so they can
instantly be assigned a task through the web. This feature is only available in
Oracle Support Service (OSS) and is only Forms-based. Using this functionality,
logged in users can set whether or not web service requests can be assigned to
them. This action can be done automatically (through backend processes) or
manually through the Assignment Manager. In the Assignment Manager, a
supervisor can view who is web available and make an appropriate decision.

Note: Whenever a resource is newly created or imported into the


Resource Manager, they are web available by default.

Prerequisites
None

Responsibilities
Customer Support responsibility

Navigation
Navigate to the Navigator - Customer Support window

Steps
1. Select Service Requests > Create Service Requests or Search Service Requests.
The Create Service Requests or Search Service Requests window opens.
2. Select Tools > Web Available.
3. Check the Available check box.

3-10 Oracle CRM Application Foundation User Guide


4
Searching for Resources

This chapter covers the following topics:


■ Using the Quick Find Search
■ Initiating an Advanced Search for an Employee
■ Initiating an Advanced Search for a Group

4.1 Using the Quick Find Search


Use the quick find search to find your resources. Perform the following steps to
execute a search.

Prerequisites
None

Responsibility
CRM Application Foundation User

Navigation
Navigate to the People tab.

Steps
1. Using the Quick Find drop-down list, select search criteria:
■ Employees
■ Groups

Searching for Resources 4-1


Initiating an Advanced Search for a Resource

2. Enter a keyword or character for the search (at least three characters). To search
for all employees or groups, enter "%%%" and click Go.
The Search Results window opens with a list of resources containing the
specified character.
3. Click any item to display the details.

Note: It is possible to see the name of a resource be repeated


several times. You can have resources with the same name, or even
the same employee number. Click on the individual resource to
view the details such as different e-mail addresses, different
manager names, different locations.

See Also
■ Initiating an Advanced Search for an Employee
■ Initiating an Advanced Search for a Group

4.2 Initiating an Advanced Search for a Resource


You can further define your search criteria by using the Advanced Search function.
Perform the following steps to search for a resource.

Note: The Preferred Name field displays only if the value of the
profile "JTFRS: Resource Lookup Audience" is "ADMIN".

Prerequisites
None

Responsibility
CRM Application Foundation User

Navigation
Navigate to the People tab.

Steps
1. From the Employee window, click Advanced Search.

4-2 Oracle CRM Application Foundation User Guide


Initiating an Advanced Search for a Group

The Advanced Search window opens.


2. Enter as much information as possible for your search criteria. Fields include:
■ Employee Number
■ Resource Number
■ Preferred Name (Use this field to search for resources of Other or TBH.)
■ User Name
■ Salesperson Number
■ Work Phone
■ Email
■ First name
■ Last Name
■ Manager Name
■ Job Title
3. Click Search.
The Employees window opens with a list of resources that match your search
criteria.
4. Click the Preferred Name to view the resource’s details.
5. Click the Job title to view the organizational structure.
6. Click the resources email address to send them an email.

See Also
■ Using the Quick Find Search
■ Initiating an Advanced Search for a Group

4.3 Initiating an Advanced Search for a Group


Perform the following steps to search for a group resource.

Searching for Resources 4-3


Initiating an Advanced Search for a Group

Note: The date range will return all the groups which are active
during the user input active date range.
Example:
Group From Date End Date
-------------------------------------------
G1 01-JAN-51 NULL
G2 01-JAN-01 NULL
G3 01-JAN-01 01-SEP-01
G4 01-SEP-01 NULL
If you input in the search window for Active from Date as
02-SEP-01 and End Date as empty. The Expected result is: G1, G2,
G4
How these three records are derived?
From 02-SEP-01 till no end, G3 is not active because it was end
dated at 01-SEP-01. But all other groups are active.

Prerequisites
None

Responsibility
CRM Application Foundation User

Navigation
Navigate to the People tab.

Steps
1. Click Groups on the main navigation bar.
2. Click Advanced Search.
3. Enter as much information as possible for your search criteria. Fields include:
■ Group Name
■ Group Email

4-4 Oracle CRM Application Foundation User Guide


Initiating an Advanced Search for a Group

■ Group Usage
■ Description
4. Use the drop-down list to select a group usage.
5. Enter the Active From Date or use the Date Picker icon to select a date. The
date should use the following format: 24-Jul-2001.
6. Enter the To date or use the Date Picker icon to select a date. The date should
use the following format: 24-Jul-2001.
7. Click Search.
The Group window opens with a list of groups that match your search criteria.
8. Click any link to view the Group Details window.

See Also
■ Using the Quick Find Search
■ Initiating an Advanced Search for an Employee

Searching for Resources 4-5


Initiating an Advanced Search for a Group

4-6 Oracle CRM Application Foundation User Guide


5
Managing Group Resources

This chapter covers the following topics:


■ Viewing Your Group Membership Information
■ Defining Your Group Membership Information
■ Defining Group Hierarchy
■ Viewing Your Group Membership History

5.1 Viewing Your Group Membership Information


Perform the following steps to view your group membership information.

Prerequisites
None

Responsibility
CRM Application Foundation User

Navigation
Navigate to the People tab.

Steps
1. After you log in to the Resource Manager, the Employee’s window opens with
your employee details.
2. Click your preferred name.
The Resource Detail window opens with your personal information.

Managing Group Resources 5-1


Defining Your Group Membership Information

3. Click Groups on the main navigation bar.


The Groups window opens with a list of groups that you are currently a
member.

See Also
■ Defining Your Group Membership Information
■ Defining Group Hierarchy
■ Viewing Your Group Membership History

5.2 Defining Your Group Membership Information


Maintaining group membership information is an essential function required by
sales and service managers. By using the Group Detail window, a user with
appropriate access (with either the Admin or Manager group member role) is able
to maintain group information. These activities include: changing the group name,
e-mail, effective date, the ability to add additional resources to a group with
appropriate member roles, end date a resource’s role and remove a resource’s role.
Perform the following steps to define your group membership information.

Note: You should not modify an HTML Calendar in the Resource


Manager or add either Calendar Group usages (PUBLIC
CALENDAR or HTML GROUP CALENDAR) to a new or existing
Resource Manager Group.

Prerequisites
■ Only a group member with a role of Admin or Manager can update group
information.
■ The JTFRS: Group Update Access profile option must be set to None for a group
member to be able to update group information.

Responsibility
CRM Application Foundation User

Navigation
Navigate to the People tab.

5-2 Oracle CRM Application Foundation User Guide


Defining Group Hierarchy

Steps
1. In the Group Usages region, use the drop-down list to select the usage.
2. In the Members region, use the drop-down list to select a resource category.
Options include: Employee, Other, Partner, Party, Supplier Contact, and To Be
Hired.
3. Enter at least three characters or enter "%%%" to search all resources and click
Go.
The Select a Resource window opens.
4. Click the resource to populate the field.
5. Use the drop-down list to select a Role Type.
6. Enter at least three characters or enter "%%%" to search all roles and click Go.
The Select a Role window opens. The roles that appear in the window
correspond with the role type you selected. Check marks in the table cells
define role responsibility.
7. Click the role to populate the field.
8. Enter the start (which defaults to the current date) and the end dates in the
specified field or click the Date Picker icon to select a date. The date format
must be in the following format: 28-Jul-2001.
9. Click Update to save your changes.

See Also
■ Viewing Your Group Membership Information
■ Defining Group Hierarchy
■ Viewing Your Group Membership History

5.3 Defining Group Hierarchy


To maintain group hierarchy information by selecting the Hierarchy hyperlink from
the side navigation menu, a user with appropriate access (with either the Admin or
Manager group member role) can add additional child or parent groups, as well as
set an end date to an existing child or parent group.
Who Has the Update Ability? Not every member within a group can update their
group information. Only a group member with a role of Admin or Manager role
assigned to it can perform these activities. In addition, the JTFRS: Group Update

Managing Group Resources 5-3


Defining Group Hierarchy

Access profile option must be set to None. The Admin or Manager role attribute can
be identified when you click the Go button to open the Select a Role window. These
attributes are defined in the setup window. Perform the following steps to define
your group hierarchy information.

Note:
■ If the row contains a Remove check box, you can select the
check box and update the window to delete the record. If the
row contains a Remove icon, you can click it to clear the row.
■ A person in a group with the role of Manager or Admin can
change his or her role and group hierarchy information but not
phone or address information.

Prerequisites
None

Responsibility
CRM Application Foundation User

Navigation
Navigate to the People tab.

Steps
1. With the Group Detail window open, click Hierarchy in the side navigation bar.
The Group Detail Child and Parent Groups window opens. The name,
description, start date, end date, and email appear in the window (if available)
in the top portion of the window.
2. Click the Group Name to view group details.
3. In the Parent Groups region, enter at least three character in the Group Name
field or enter "%%%" to search all roles and click Go.
The Select a Group window opens.
4. Click the group to populate the group name and description.

5-4 Oracle CRM Application Foundation User Guide


Viewing Your Group Membership History

5. Enter the start date (which defaults to the current date) and the end date in the
specified field or click the Date Picker icon to select a date. The date format
must be in the following format: 28-Jul-2001.
6. In the Child Groups region, enter at least three character in the Group Name
field or enter "%%%" to search all roles. and click Go.
The Select a Group window opens.
7. Click the group to populate the group name and description.
8. Enter the start date (which defaults to the current date) and the end date in the
specified field or click the Date Picker icon to select a date. The date format
must be in the following format: 28-Jul-2001.

See Also
■ Viewing Your Group Membership Information
■ Defining Your Group Membership Information
■ Viewing Your Group Membership History

5.4 Viewing Your Group Membership History


Perform the following steps to view your group membership history.

Prerequisites
None

Responsibility
CRM Application Foundation User

Navigation
Navigate to the People tab.

Steps
1. Navigate to the Details window.
2. Scroll down to view your active group memberships.
3. Click Show History in the lower portion of the window to view any inactive
group memberships.

Managing Group Resources 5-5


Viewing Your Group Membership History

Note: There is a bug in the Netscape browser that can affect Resource
Manager. Do not use the Back button, as you may loose your data. It is
recommended that you use the Resource Manager user interface (UI). The
Internet Explorer browser does not have this issue.

See Also
■ Viewing Your Group Membership Information
■ Defining Your Group Membership Information
■ Defining Group Hierarchy

5-6 Oracle CRM Application Foundation User Guide


Part II
Notes

This part of the Oracle CRM Application Foundation User Guide contains the
following chapters:
■ Introduction to Oracle Notes
■ Overview of Using Oracle Notes
■ Managing Notes
■ Viewing Note Information
■ Searching for Notes
■ Using Forms-based Notes
6
Introduction to Oracle Notes

This chapter covers the following topics:


■ Overview of Oracle Notes
■ Oracle Notes Key Features
■ Oracle Notes Integrations
■ Process Flow for Oracle Notes
■ What’s New in This Release
■ Terms and Definitions

6.1 Overview of Oracle Notes


A note is a record of descriptive information attached to a CRM object. It is created
by an agent, customer care or service representative, or end user, to help retain
information such as directions, special instructions, or reminders. The Notes
module is used from different applications in the eBusiness Suite to access
additional information that relates to a specific transaction. The Notes module can
be accessed through both Forms and HTML.

Example
A customer support agent enters a note for a service request. The note states that
the customer is in a business meeting from 10:00 a.m. to 12:00 p.m. and is
unavailable to assist the technician with the problem. The support agent also
attaches a copy of the log file provided by the customer.

Introduction to Oracle Notes 6-1


Oracle Notes Key Features

Note: Although users can use notes through Forms or HTML,


implementation tasks for both modules are still performed in the
Forms-based Notes module and can be accessed through the CRM
Administrator responsibility.

Once a note is created in the HTML Notes module, it appears in the Notes
Summary window with a description of what the note is about. If your note exceeds
2000 characters, you can choose to add an additional 32KB of note text.
Alternatively, you may add an attachment to a note, such as a spreadsheet, picture,
presentation, or even a hyperlink to a web site.

6.2 Oracle Notes Key Features


The following are key features of the Notes module:
■ The Notes module can hold free form text up to 2000 characters.
■ There are three statuses of notes: private, public, or publish.
■ Note types are available to help you categorize notes.
■ You can attach additional text, a file, or a URL to a note.
■ Notes are created in the context of a CRM source object.
■ Notes can be related to other CRM objects.

Note: The Notes module is a stand-alone module in HTML only.


However, it is commonly accessed from many applications under
various responsibilities. For example, Customer Support, Task
Manager, Escalation Manager, and Installed Base all use the Notes
module.

What is a Note Type?


Note types help categorize notes. They are selected from a drop-down list in HTML
or from list of values in Forms. Users can define additional note types and associate
those types to specific source objects, which makes the note types visible only to
that source. Only note types that are mapped to a source object appear in the note
window. Note types that are not mapped to any source object are considered
general note types and are shown for all source objects.

6-2 Oracle CRM Application Foundation User Guide


Oracle Notes Integrations

Who Uses Notes?


Notes are created and accessed from various applications under various
responsibilities. Oracle Customer Support, Task Manager, Escalation Manager,
Installed Base, Sales Online, Telesales Marketing Online, and the HTML Calendar
all use the Notes module.

What is the Notes Summary Window?


The Notes Summary window is the main entry window for HTML Notes. If you are
using the stand-alone HTML Notes module, then all the notes that you create for
yourself appear in the Notes Summary window. These stand-alone notes are
considered your personal notes and can only be created through the stand-alone
HTML Notes module.
If notes are created from other applications for a CRM object, such as a sales lead,
task, or a service request, then all notes for that source ID (such as, Task Manager
10935) and task name (such as, Monthly Conference Call) appear in this window.
Notes created in this way are referred to as contextual notes.
Both contextual and stand-alone notes can be related to other CRM objects allowing
you to view the note from various windows. Contextual and stand-alone notes can
be marked as private, which means the note can only be viewed by the user that
created it.

6.3 Oracle Notes Integrations


Notes is widely used by various Oracle modules across CRM.
■ Collections use the Notes module to add additional information for late
payments or overdue accounts.
■ Sales and Telesales applications use the Notes module to enter additional
information for an opportunity, a lead, or a task.
■ Service applications use the Notes module to enter more information for a
service request, defect, or task such as a special customer request or deadline
that must be met.
■ E-Commerce applications use the Notes module to enter additional information
for online service requests, tasks, and campaigns.
■ Marketing applications use the Notes module to enter additional information
about marketing activities, such as campaigns, events, budgets, or claims.
■ Task Manager uses the Notes module to enter more task related information.

Introduction to Oracle Notes 6-3


Process Flow for Oracle Notes

■ Escalation Manager uses the Notes module to enter additional information for
an escalation document.

6.4 Process Flow for Oracle Notes


The following table describes the order and process of using the Notes module.

Table 6–1 Notes Process


Steps Description Type
Search for a Note (Optional) Search for a note in the system. Forms and HTML
Create a Note (Optional) Create a note. Forms and HTML
Relate a Note to a Business Object (Optional) Relate a note to a business object Forms and HTML
such as a party or employee resource.
Add an Attachment to a Note (Optional) View, create, and add attachments to Forms and HTML
a note.

6.5 What’s New in This Release


This release of CRM Application Foundation has the following new features in
Notes subsequent to the 11.5.7.4 release:

A New Filter Is in the Notes Summary Window (HTML)


While accessing the Notes Summary window from other HTML-based applications,
a new drop-down filter allowing users to view notes is added with two values:
Relate To (References) and Source. The default value is set to "Relate To". Use this
filter to further restrict the notes that appear in the summary page. For example, use
this filter to view all the notes that are related to a specific sales opportunity.

An Error Message Appears in the Relate To Window (HTML)


For HTML Notes, if a user tries to search a relate to object name without first
identifying the note type (such as Task Manager), an error message would appear in
the window, "To perform a search on relate to name, a valid relate to object must be
selected." However, when a user selects All as the note type, the relate to object
name must be left blank.

6.6 Terms and Definitions


The following table describes Notes terms and definitions.

6-4 Oracle CRM Application Foundation User Guide


Terms and Definitions

Table 6–2 Notes Terms and Definitions


Term Description
Attachment An attachment is any document associated with one or more
application module. You can view attachments as you review
and maintain a module.
For example: operating instructions, purchase order, notes,
item drawings, presentations, or an employee photo can be an
attachment.
Created By This is the person who created the note.
Note This is the note text.
Note Status There are three statuses available for notes:
■ Private: Only the creator can view the note. This status is
used in HTML Notes and it is reserved for future use in
Forms.
■ Public: Any user can read or write to the note.
■ Publish: The note is publishable over the internet.
Everyone can view it. This status is reserved for future
use.
Note Text A large note, such as a customer’s letter or directions. It can
capture data up to 32KB.
Note Type Note types help categorize notes.
Relate To Both contextual and stand-alone notes can be related to other
CRM objects allowing you to view the note from various
windows.
Source If a note is created for a CRM object, like a sales lead or a
service request, that object is considered the source object for
that Note. Notes created in this way are referred to as
contextual notes.

Introduction to Oracle Notes 6-5


Terms and Definitions

6-6 Oracle CRM Application Foundation User Guide


7
Overview of Using Oracle Notes

This chapter covers the following topics:


■ Accessing the Oracle Notes Interface
■ Summary of Oracle Notes Tasks

7.1 Accessing the Oracle Notes Interface


Since the HTML Notes module is integrated with the HTML Calendar and Task
Manager, you can only access HTML Notes through the Calendar tab. Perform the
following steps to log in to the Notes module.

Prerequisites
You must be an active resource in the Resource Manager tables to access the Notes
module.

Responsibility
CRM Application Foundation User

Navigation
Navigate to any Notes window.

Steps
1. Navigate to the login portal.
2. Enter your user ID.
3. Enter your password and click Go.

Overview of Using Oracle Notes 7-1


Summary of Oracle Notes Tasks

4. Click Notes on the main navigation bar.


The Notes Summary window opens with a list of your current notes.

7.2 Summary of Oracle Notes Tasks


Use Oracle Notes to perform the following types of tasks:
■ Chapter 8, Managing Notes
■ Chapter 9, Viewing Note Information
■ Chapter 10, Searching for Notes
■ Chapter 11, Using Forms-based Notes

7-2 Oracle CRM Application Foundation User Guide


8
Managing Notes

This chapter covers the following topics:


■ Creating a Note
■ Adding an Attachment
■ Viewing Existing Attachments
■ Using the Relate To Function

8.1 Creating a Note


A note is a record of descriptive information attached to a CRM object. It is created
by an agent, customer care or service representative, or end user, to help retain
information such as directions, special instructions, or reminders. Notes created in a
specific CRM module are not visible from another module. For example, notes
created in the Task Manager are not visible in Service Request. Perform the
following steps to create a note.

Prerequisites
None

Responsibility
CRM Application Foundation User

Navigation
Navigate to the Create Note window by clicking Create in the Notes Summary.

Managing Notes 8-1


Adding an Attachment

Steps
1. Select an appropriate note type from the LOV.
2. (Optional) Change the default note status from the LOV if necessary.
3. Enter up to 2000 characters of text in the description field. If your note exceeds
2000 characters, click More to enter an additional 32kb of text.
4. (Optional) Enter reference information including the resource type and
corresponding resource name.
The description field automatically populates depending on the information
available for the resource you select.
5. Click either Create, to create a single note or click Create and Create Another to
return to the Create Note window in order to create another note.
A confirmation appears that your note was created successfully.

8.2 Adding an Attachment


See the HTML Calendar documentation for information regarding Adding an
Attachment.

Note: The attachment types Short Text and Long Text used in the
forms-based version of Notes are not available in HTML.

8.3 Viewing Existing Attachments


See the HTML Calendar documentation for information regarding Viewing Existing
Attachments.

8.4 Using the Relate To Function


You can associate one or more business object to a Note. For example, a note may be
created for a Task (the source) but also relate to an employee. A note can be related
to two different tasks, but the same note cannot be related to the same task twice.
Perform the following steps to relate a business object to a note.

8-2 Oracle CRM Application Foundation User Guide


Using the Relate To Function

Note:
■ The Relate To drop-down list is limited depending on which
Oracle module is integrated with Notes.
■ Click the source link to view the source or the name link to
view the details of the record.

Prerequisites
A note must already exist.

Responsibility
CRM Application Foundation User

Navigation
Navigate to the Relate To window by clicking Relate To in the Note Details window.

Steps
1. Select the note type from the drop-down list. You cannot select a type without
selecting a name.
2. Enter a name that corresponds to the type.
3. Click Go to search for a name.
The Search and Select window opens.
a. Enter at least two character in the search field and click Go.
A list of names appear in the window.
b. Select the option button of the name you want to add and click Select.
The name and description populates the text field.
4. Click Update to save your changes.
5. To remove a relate to object, select the remove check box next to the
corresponding row and click Update.

Managing Notes 8-3


Using the Relate To Function

Note: If the default value of Relate To is deleted, then you will not
be able to see the notes when trying to search using Relate To.
These notes can be retrieved when filtered under Source.
For example, if a note is created for a task, then Task Manager
becomes the default value in the Relate To field. If the default Task
Manager is removed, then you can only view the note if Source is
selected from the drop-down list in the Notes Summary window.
You won’t see the note if Relate To is selected as the criteria.

8-4 Oracle CRM Application Foundation User Guide


9
Viewing Note Information

This chapter covers the following topics:


■ Using the Notes Summary Window
■ Viewing All Notes
■ Viewing Note Details

9.1 Using the Notes Summary Window


Use the Notes Summary to:
■ View a list of all your notes
■ Create a new note
■ Search for a note
■ Display note details
When a note is associated with an appointment or task, the note is only visible in
the context of that source and does not appear in your Notes Summary or All Notes
window. However, you can search for a note associated with a specific source.
Perform the following steps to view the Notes Summary window.

Viewing Note Information 9-1


Using the Notes Summary Window

Note:
■ Use the First, Previous, Next, and Last links to view all of your
existing notes.
■ If you are running Notes integrated with another Oracle CRM
application (Context Sensitive window), there is a filter on the
Notes Summary window that lets you search on either the
source of the note, or the relate to information.

Prerequisites
None

Responsibility
CRM Application Foundation User

Navigation
Navigate to any Notes window.

Steps
1. Click Notes on the main navigation bar.
The Notes Summary window opens with a list of your notes.
2. Click the note name hyperlink to view the note’s details.
3. The window provides the following information for each note:
■ The date the note was created
■ The source and source name
■ The creator of the note
■ The note type
■ The status of the note
■ The name of the note
■ Whether or not there is additional note text
■ Whether or not there is an attachment accompanying the note
4. Click the icon in the Text column to view additional text added to the note.

9-2 Oracle CRM Application Foundation User Guide


Viewing All Notes

5. Click the paperclip icon in the Attachments column to add or update an


attachment. If there is an attachment provided with the note, the paperclip icon
has a small paper icon associated with it. If there is no attachment, only the
paperclip icon appears.

9.2 Viewing All Notes


Use the All Notes window to view all notes that are in the Notes Summary window
arranged in a non-table format. Perform the following steps to view all notes.

Note: Use the First, Previous, Next, and Last links to view all your
existing notes.

Prerequisites
None

Responsibility
CRM Application Foundation User

Navigation
Navigate to the Notes Summary window by clicking Notes on the Main Navigation
bar.

Steps
1. In the Notes Summary window, click All Notes.
The All Notes window opens with a list of your notes. If no notes are found, an
error message appears. The window provides the following information for
each note:
■ The date and time the note was created
■ The user who created the note
■ The source and source name
■ The note type
■ The note details icon
■ The note text

Viewing Note Information 9-3


Viewing Note Details

2. Click the Note icon to open the Note Details window. Details of the note appear
along with information about the creator, and the time and date the note was
created and updated.
3. Click Return to Summary to view the Notes Summary window.

9.3 Viewing Note Details


Use the Note Details window to view and update a note. Perform the following
steps to view the details of a specific note.

Note: The Source provides information on who created the note


and the name provides the name of the note. If the note was created
from a source other than the Notes stand-alone module, you can
click the source or name to drill down on the details of the record.

Prerequisites
A note must already exist.

Responsibility
CRM Application Foundation User

Navigation
Navigate to the Note Summary window.

Steps
1. Click the note name to view more information about the note in the Note
Details window
2. Modify the type, status, attachment, or relate to information as necessary and
click Update.

9-4 Oracle CRM Application Foundation User Guide


10
Searching for a Note

This chapter covers the following topics:


■ Using the Quick Find Search
■ Searching for a Note

10.1 Using the Quick Find Search


Use the Quick Find search to find your appointments, tasks, notes, employees, and
groups. Perform the following steps to execute a search.

Prerequisites
None

Responsibility
CRM Application Foundation User

Navigation
Navigate to any Notes window.

Steps
1. Using the Quick Find drop-down list, select your search criteria:
■ Appointments
■ Task
■ Notes
■ Employees

Searching for a Note 10-1


Searching for a Note

■ Groups
2. Enter a keyword or letter (at least three characters) for the search and click Go.
The Search Results window opens.
3. Click any item to display the details.

10.2 Searching for a Note


Find notes by performing a search for a source number, owner, date, or note type.
Perform the following steps to find an existing note.

Prerequisites
None

Responsibility
CRM Application Foundation User

Navigation
Navigate to the Notes Search window by clicking Search in the Notes Summary.

Steps
1. In the Notes Search window, enter a keyword for the search.
The keyword search is to search the text entered in the regular notes only, not
the large notes.
2. Select a source to search on. You must choose a source to select the
corresponding record name or select All (Sources).
The created by field defaults to the logged in user’s ID.
3. Select relate to information for the note. You must select a relate to in order to
select the corresponding record name. Depending on what you enter, the
created by field populates automatically.
4. Select a note type.
5. Enter a date range.
6. Select your sorting preferences.
7. Select how many rows you want to display and click Search.

10-2 Oracle CRM Application Foundation User Guide


Searching for a Note

The Notes Summary window opens with a list of your notes.

Searching for a Note 10-3


Searching for a Note

10-4 Oracle CRM Application Foundation User Guide


11
Using Forms-based Notes

This chapter covers the following topics:


■ Creating Notes
■ Finding Notes

11.1 Creating Notes


A note is a record of descriptive information attached to a CRM object. It is created
by an agent, customer care or service representative, or end user, to help retain
information such as directions, special instructions, or reminders. Notes created in a
specific CRM module are not visible from another module. For example, Notes
created in the Task Manager are not visible in Service Request. Perform the
following steps to create a note.

Note: View the note through the Notes tab and any additional
note text through the Summary tab. Clicking Latest First in the
Summary tab organizes the note history so that the most recent
note appears first.

Prerequisites
None

Responsibility
End User

Using Forms-based Notes 11-1


Finding Notes

Navigation
Navigate to Tools > Notes in any application integrated with Notes.

Steps
1. Click New in the Notes window.
The application populates the source, owner, and date fields.
2. Enter up to 2000 characters of text in the Notes field. If your note exceeds 2000
characters, click More to enter an additional 32kb of text in the detailed Note
window.
3. Select note type and status from the list of values (LOV) for each field.
4. Select reference information from the Relate To LOV.
5. Enter a value for the reference information.
Define the information you enter in the Related To and Value fields according to
the relationship between the note and business transaction. Use the Related To
field to identify the source type and the Value field to specify the source name
or number.
6. Click Save.

See Also
Finding Notes

11.2 Finding Notes


Find a note by performing a search for the source number, owner, date, or note type.
Perform the following steps to find an existing note.

Prerequisites
None

Responsibility
Responsibilities used in Support Applications

Navigation
Navigate to Tools > Notes in any application integrated with Notes.

11-2 Oracle CRM Application Foundation User Guide


Finding Notes

Steps
1. On the application toolbar, click Find.
The Find Notes window opens.
2. Select the source and number from the list of values (LOV) for each field and
click Search.
The note information appears in the main note window.
3. Enter the owner, date, or note type and click Search.
The application populates the Notes tab in the Notes window with the possible
matches.
4. Click to select your note and scroll right for additional information.
5. Further refine your note search by entering Relate To information in the Find
Notes window. Selecting a match option also helps you refine your search.

See Also
Creating Notes

Using Forms-based Notes 11-3


Finding Notes

11-4 Oracle CRM Application Foundation User Guide


Part III
Territory Manager

This part of the Oracle CRM Application Foundation User Guide contains the
following chapters:
■ Introduction to Oracle Territory Manager
■ Overview of Using Territory Manager
■ Using the Territory Lookup Tool
■ Running Reports in Territory Manager
12
Introduction to Oracle Territory Manager

This topic group provides overviews of the application and its components,
explanations of key concepts, features, and functions, as well as the application's
relationships to other Oracle or third-party applications.
This chapter covers the following topics:
■ Overview of Oracle Territory Management
■ Oracle Territory Manager Integrations
■ Process Flow for Oracle Territory Manager
■ Terms and Definitions
■ Basic Territory Building Blocks
■ Different Ways of Creating Territories
■ Territory Hierarchies
■ Territory Winning Rules
■ Understanding the Territory Details Window

12.1 Overview of Oracle Territory Management


The following topics describe what Territory Manager is and when and why you
use it:
■ What is a Territory?
■ What is the Territory Manager?
■ What is the Territory Lookup Tool?

Introduction to Oracle Territory Manager 12-1


Overview of Oracle Territory Management

12.1.1 What is a Territory?


A territory is an organizational domain with boundaries defined by attributes of
customers, products, services, and resources.
Territories can be created on multiple criteria including postal code, area code,
country, vertical market, size of company, and product expertise. It can be created
based on geographical locations, for example, East Coast and West Coast territories.
It can also be based on customer name if targeting specific customers or products,
for example, Business World territory, or the combination of both geographical
location and customers, such as a West Coast Business World territory.

12.1.2 What is Territory Manager?


Territory Manager provides user interfaces and assignment functionality that
organizations can use to manage territories. Think of Territory Manager as a large
filtering engine which will return desired resources based on your filtering criteria.
Transaction qualifiers are the main filtering criteria. Next you determine how many
winners you want. Then rank is used to determine what order the winning
territories will be in.
Use Territory Manager to automatically set up sales and service teams based on
their availability and expertise. Also use it to make sales, and service information
more secure by restricting personnel access to customer data.
Most sales and service territories are one dimensional. They can assign tasks to
employees based on:
■ Postal code
■ Area code
■ Country
■ Vertical market
■ Size of company
■ Product expertise
Territory Manager makes it possible for you to create multidimensional territories
using a number of such criteria.
For example, you can assign all large customers within a specific geographical area
only to those sales representatives who have an expert knowledge of a product and
have been with the company for more than one year.

12-2 Oracle CRM Application Foundation User Guide


Oracle Territory Manager Integrations

You can create multiple such territories for individuals or for teams of sales and
service representatives. Think of Territory Manager as a high-level programming
tool that determines the assignment of tasks and resources within your company.

12.1.3 What is the Territory Lookup Tool?


Many Oracle Sales users need to have the ability to lookup territories, which have
been defined for Oracle Sales and Telesales, and the representatives assigned to
those territories. The Territory Lookup Tool allows these users to view the
appropriate sales representatives that have been assigned to specific territories that
have been defined by qualifier values.
Use the Territory Lookup Tool to find:
■ An organization
■ A sales representative
The Territory Lookup Tool returns the names of the sales representatives attached to
the winning territories based on the Territory setup and search criteria. It searches
down the territory hierarchy to find the resources of the winning territory.

Note: In the Organization field, you can use a wild card with at
least two letters.

The Territory Lookup Tool is HTML based.

See Also
■ Basic Territory Building Blocks
■ Different Ways of Creating Territories

12.2 Oracle Territory Manager Integrations


Territory Manager uses resources defined in Resource Manager to display and
assign any type of CRM resource to a territory. Territory Manager is widely used by
various Oracle modules across CRM.
■ Service uses Territory Manager to set up territories so that an incoming service
request or task can be routed to an appropriate resource.

Introduction to Oracle Territory Manager 12-3


Process Flow for Oracle Territory Manager

■ Quality Online (formerly known as Oracle Defect and Enhancement


Management) uses Territory Manager to set up territories so that a defect can be
assigned to an appropriate resource.
■ TeleSales (OTS), Sales and Sales Online (OSO) use Territory Manager to set up
territories so that accounts, leads, and opportunity can be assigned to a sales
agent based on territory definitions. OTS and OSO also uses Territory Lookup
Tool, the HTML Territory Manager, to search for sales representatives.
■ Trade Management uses Territory Manager to set up territories so that offers
and claims can be assigned to qualified resources.
■ Assignment Manager uses Territory Manager to retrieve qualified resources
identified in territories.

12.3 Process Flow for Oracle Territory Manager


Before using the Territory Manager, your territory planning team must analyze
your business and organization needs for better territory planning and future
management. This step should be in place before implementing the Territory
Manager.
The implementation team enables seeded qualifiers used in your territories
based on the planning decisions.
The territory administrator then begins the territory creation process, according
to the territory plan, using the concept of basic territory building blocks. This
territory creation process may use different ways to create territories either with
or without using templates or types. It can include the use of escalation
territories to help manage future escalations.
After territories have been created, users with an appropriate responsibility can
search and view territory hierarchies through either the Administration menu
or the Navigator tree. The territory administrator must run the “Generate
Territory Package” concurrent program to generate correct territories with
changes reflected before calling modules assign resources defined in your
territories.
The following table describes the order and process of using Territory Manager.

12-4 Oracle CRM Application Foundation User Guide


Terms and Definitions

Table 12–1 Territory Manager User Process


Steps Description Required Performed By
Territory Lookup Use this HTML-based window to search for sales Optional All Users
Tool representatives. The winning territory is based on
the Territory setup and search criteria. It searches
down the territory trees to find the winning
territory.
Run Reports Run reports to track your selections and changes. Optional Users who have the
Territory
There are two types of reports you can generate in
Administration HTML
either HTML or export to Microsoft Excel:
responsibility or the
Territory Definition Report CRM Administrator
responsibility can
Territory Changes Report
access territory reports.

12.4 Terms and Definitions


The following table describes Territory Manager terms and definitions.

Table 12–2 Territory Manager Terms and Definitions


Term Description
Automatic Assignment Automatic Assignment refers to the matching of territories to
resources resulting in a "Winning Territory".
Catch All A Catch All territory is a placeholder used at the top of a
territory hierarchy when no other has been defined.
Effective Dates The date a territory, member assignment, and so on, is
effective, or to be in use.
Escalation Territories Escalation territories provide you with the ability to define the
escalation path in the event of exceptions. This is necessary for
all administrative purposes and accountability purposes.
Territory based escalation definition will provide you with the
multi-level escalation path for each territory.
When defining a territory, the user has the option of
designating the escalation territory. An escalation territory
must be defined with the escalation flag checked before it will
be present in the Escalation LOV.
Number of Winners The Number of Winners field is used to specify the maximum
number of potential winning territories.

Introduction to Oracle Territory Manager 12-5


Terms and Definitions

Table 12–2 Territory Manager Terms and Definitions


Term Description
Operators Operators refer to the ability to use arithmetic operators.
While defining territories, the qualifier values should be either
discreet using operators (for example, <>,=<>,<=,>=, LIKE, or
a range using BETWEEN.
Qualifiers Qualifiers are used to define Territories.
Dynamic Mode Dynamic qualifiers are used to control the number of
(Default) territories after creating a mass number of territories. The
values of both transaction and resource dynamic qualifiers are
exclusively mixed together while assigning them to the new
territories.
Static Mode Static qualifiers are used to transfer the qualifier’s values to
every new territory no matter if it is a transaction or a resource
qualifier after territory mass creation. Therefore, you can treat
the values of the static qualifiers as the required values for
every new territory.
Rank Rank is used to specify the priority of a territory among
territory random selection. It is used with number of winners.
Resource Qualifiers Resource Qualifiers are the criteria used specifically in
selecting resources.
TAE TAE is an acronym for Territory Assignment Engine. After
territories are defined, a calling module uses backend
processes to retrieve resources identified in the winning
territories among competing territories.
TM TM is an acronym for Territory Manager. This is used as a tool
that helps manages territories.
Territory A territory is an organizational domain with boundaries
defined by attributes of customers, products, services, and
resources.
Territory Administrator This person administers the specific and periodic duties of
Territory Manager.
Territory Templates A territory template is used to create many similar territories
simultaneously. They can be based upon territory types.
(Optional) Whenever a new set of territories needs to be
generated, a template can be used.

12-6 Oracle CRM Application Foundation User Guide


Basic Territory Building Blocks

Table 12–2 Territory Manager Terms and Definitions


Term Description
Territory Type Territory Types are used to group transaction qualifiers when
creating territories. In usage, territory types are based on the
specific business need. Consequently, territory types can be
defined to organize the business. Types are also able to be
based on usage, such as, Marketing, Sales, and Service.
A territory type can be based also upon customer and product.
Another example can include customer type and location.
Top-level Territory A top-level territory is a territory that has the "Catch All" as a
parent.
Transaction Qualifiers Transaction Qualifiers are the criteria used to determine the
winning territory.

12.5 Basic Territory Building Blocks


Use the following basic building blocks to define a territory:
■ Qualifiers
■ Territories
■ Territory Types
■ Territory Templates
■ Escalation Territories

Note: When creating a territory, you may not need all of the
building blocks. You can create a stand-alone individual territory
by entering territory qualifiers and their values directly, without
using a territory type, a territory template, or an escalation territory.

12.5.1 Qualifiers
The following section describes qualifiers in detail:
■ Qualifier Components
■ Transaction Qualifiers
■ Resource Qualifiers
■ Using Qualifiers

Introduction to Oracle Territory Manager 12-7


Basic Territory Building Blocks

■ Seeded Qualifiers

Qualifier Components
There are two types of qualifiers that help define a territory: Transaction Qualifiers
and Resource Qualifiers. A qualifier also consists of three components: name,
operator, and value. The following table describes each component:

Table 12–3 Qualifier Components


Components Description
Name The name of the qualifier. It can be postal code, item, task priority, request
status, job title, or others.
Operator Use operator to connect a qualifier name and its values to make a qualifier
meaningful. The operator’s list of values (LOV) depends on the data type
of the qualifier. Possible values are =, < >, >, <, >=, <=, Like and Between.
The default value for this field is "=".
Value The selection from the LOV in this field is based on the selected qualifier.
For example, the LOV for the request status qualifier can be Open or
Closed. If the qualifier is area code, then manually enter this field, for
example, 408, 415, and so on.

12.5.2 Transaction Qualifiers


Transaction Qualifiers are used to specify the criteria about how the territory
module assigns resources to transactions. It is the first key decision point when
Assignment Manager tries to assign resources to a document or a task.
For example, use area code, postal code, company name, or opportunity channel as
the criteria to help assign qualified resources for transaction needs.
Different territory usages, like Oracle Sales or Service, use different sets of
transaction qualifiers and those transaction qualifiers are grouped by transaction
type. For example, a sales or telesales territory has three predefined transaction
types: Account, Lead, and Opportunity. Some examples of transaction qualifiers
within the Account Transaction Type are company name, area code, and postal
code. Opportunity channel is one transaction qualifier for the Opportunity
Transaction Type.

Note: You must enable transaction qualifiers before using them.

12-8 Oracle CRM Application Foundation User Guide


Basic Territory Building Blocks

Sample List of Seeded Transaction Qualifiers


Territory Manager includes seeded qualifiers for the following CRM modules:
■ Oracle Defect Management
■ Oracle Sales and Marketing
■ Oracle Service
■ Trade Management
The following table describes a small sample of both resource and transaction
qualifiers.

Example of Predefined Territory Qualifiers


Application Type Qualifier Type Qualifier Name
Defect Management Defect Transactions Product
Sales Account Customer Name Range
Trade Management Trade Account State
Service Service Request Request Type

Customer Name, Customer Name Range, and Customer Name Range


Group
Among all the transaction qualifiers, there are three which should be explained to
avoid confusion:
■ Customer Name
■ Customer Name Range
■ Customer Name Range Group

12.5.3 Customer Name


This transaction qualifier defines a customer name.

12.5.4 Customer Name Range


In contrast to a Customer Name qualifier, a Customer Name Range qualifier is used
to indicate more than one customer (or customer names) by entering appropriate
values. This qualifier captures a range of the business names.

Introduction to Oracle Territory Manager 12-9


Basic Territory Building Blocks

Example
Business World Worldwide has the following branches and subsidiaries: Business
World Motor, Business World Book, Business World Service, USA Business World,
Russia Business World, and UK Business World. You can use the Customer Name
Range qualifier to group similar customer names together by using the following
values:
Like “Business World %”: This value represents Business World Motor, Business
World Book, and Business World Service.
Between “A% Business World” to “Z% Business World”: This value represents USA
Business World, UK Business World, and Russia Business World.

12.5.5 Customer Name Range Group


Instead of entering the Customer Name Range values every time when defining a
territory, you can use the Customer Name Range Group qualifier to group these
frequently used values together and give them a group name, for example, Business
World. This qualifier was developed so that businesses can conveniently group
together all names of a company including its subsidiaries.

Example
Create a Customer Name Range Group qualifier called “Business World” with a
grouping of the following values that you used for Customer Name Range qualifier:
Like “Business World %”
Between “A% Business World” to “Z% Business World”
In this way, you can use “Business World” as the Customer Name Range Group
qualifier to list all Business World related branches and subsidiaries in one step
when you define a territory. Continuing from the previous example, a customer
name range group, Business World, may have the following values:
Like (Operator) “Business World %”
Between (Operator) “A% Business World” (Value From) to “Z% Business World”
(Value To)
After defining a group qualifier and its values, you can use this transaction qualifier
in defining a territory for Oracle Sales and Telesales.
If you want to define more than one customer name range group, select the next
line in the Name field to create additional group information.

12-10 Oracle CRM Application Foundation User Guide


Basic Territory Building Blocks

12.5.6 Resource Qualifiers


Resource Qualifiers specify what attributes are used to select the individuals
responsible for those transactions. Examples include job title, competence, and
language. These qualifiers act as filters which define resource selections.
For example, if you are looking for specific resources who speak Italian for your
customer needs, then the resource qualifier can be identified as "Language =
Italian.” This aids in selecting resources that qualify for your condition.
You can still make selections from the qualified resources suggested by the resource
qualifier before assigning them to a territory.
There is no need to specify the resource qualifiers if you know exactly which
resources are needed for a certain territory. Instead, identify the resource names on
the Resources tab of the Territory Details window.

12.5.7 Using Qualifiers

Why Use Transaction and Resource Qualifiers?


After understanding the concepts of transaction qualifiers and resource qualifiers, it
is easier to understand how a territory works. A territory uses resource qualifiers to
filter resources that you want to attach to a territory. A territory uses transaction
qualifiers and values to determine if a territory can win in that transaction. If the
territory happens to win, then the resources attached to the territory can be
assigned to the transaction.

Seeded Qualifiers
Territory Manager provides a large number of seeded qualifiers for Defect
Management, Sales and Marketing, Service, and Trade Management.

12.5.8 Territories
A territory consists of qualifiers and their values. You can create a territory
individually or you can create a large number of territories all at the same time
using a territory template.

Example
Suppose your company wants to finalize a business transaction with Business
World Inc. and that it also requires a manager position to close the deal. A territory
is set up with two qualifiers: "Customer Name = Business World Inc." and "Job Title

Introduction to Oracle Territory Manager 12-11


Basic Territory Building Blocks

= Manager" for this one time deal. You do not need to use any of the existing
Territory Type or Territory Template for this territory creation. You can add an
escalation territory later with a different manager who has a superior record for
handling complex cases if the assigned manager is not able to close the deal.
The territory creation process can use some or all of the following basic building
blocks:
■ Territory Types
■ Escalation Territories
■ Territory Templates

See Also
Different Ways of Creating Territories

12.5.9 Territory Types


A Territory Type is a grouping of transaction qualifiers. Without setting qualifier
values, you can use it to simplify and systematize the territory creation process. Use
territory types to group transaction qualifiers used for creating territories. This
saves time when creating similar territories.
Suppose you want to create territories by geographical area. In this case, create a
territory type with the Country and Postal Code qualifiers.

Note: Plan your territories and enable existing transaction


qualifiers before creating territory types.

12.5.10 Territory Templates


Use a Territory Template to create many similar territories at the same time.
Suppose you have two large customers and you want to create a territory for each
of them for every state in the United States. Creating individual territories requires
repeating the same procedure 100 times, once for each of the 50 states and again for
each company. Using a territory template, you can create all of the 100 territories at
the same time.

12.5.11 Escalation Territories


An escalation territory provides the resources responsible for managing escalations.

12-12 Oracle CRM Application Foundation User Guide


Different Ways of Creating Territories

You use Escalation territories to define the escalation path with appropriate
resources that the escalation owner identified for the territory in the event of
exceptions. In case of automatic assignment by using an escalation territory, the
Assignment Manager is used in conjunction with the Territory Manager. The
escalation can be automatically assigned to an owner if the escalated document (like
service request, tasks, or defect) has an escalation territory defined.
You can create alternate escalation territories to automatically reassign a service call
when certain conditions are not met.
a. A repair team assigned to a repair does not take action within five business
days, so now that repair can be assigned automatically to another group.
b. A service engineer cannot service a request within a certain time frame
which is set up in the Business Rule Monitor (BRM), so now the service
request will be automatically escalated to the resource.

12.6 Different Ways of Creating Territories


You can create territories in one of three ways:
■ Individually
■ With a territory type
■ With a template

12.6.1 Creating Individual Territories


Create a stand-alone territory by entering territory qualifiers and their values
directly. This method does not leverage your work because you have to add both
qualifiers and their values for each territory you create.

12.6.2 Creating a Territory Using a Territory Type


Create territories using a territory type in a three step process:
■ Create the territory types by adding chosen transaction qualifiers.
■ Use territory types to create territories.
■ Set qualifier values for each territory.
Use this method for creating multiple territories with similar characteristics. Using
territory types to create territories saves time because you do not have to add

Introduction to Oracle Territory Manager 12-13


Territory Hierarchies

qualifiers to each individual territory, but you still have to create each individual
territory separately by entering values for the qualifiers.

Note: You must use territory templates to create territories if you


plan to use resource qualifiers. Territory types limit you to using
transaction qualifiers only.

12.6.3 Creating a Territory Using a Territory Template


Create a large number of territories all at the same time using a territory template.
For example, suppose you want to create a separate territory for every state in the
United States for two large customers. Creating individual territories requires you
to repeat the procedure 100 times, once for each of the 50 states for each company.
Using territory types, you still must create each 100 territories separately although
the process is somewhat shorter. By following the procedure outlined in Using a
Template to Create Large Numbers of Territories, you can create all 100 territories at
the same time.

12.7 Territory Hierarchies


The purpose of having territory hierarchies is to make the territory assignments and
searches more efficient. Territory hierarchies also have the ability to store the
parent-child relationship among territories.

Parent-Child Territory
Any territory consisting of one or more subterritories is considered as a parent
territory. For example, a West Coast territory could consist of three subterritories:
Washington, Oregon, and California. This West Coast territory and the three
subterritories have the parent-child relationship.

Features of a Child Territory (Subterritory)


To help maintain integrity in the hierarchy, each child territory logically inherits the
qualifiers and values of the parent territory. Also, additional qualifiers and values
can be added.

12-14 Oracle CRM Application Foundation User Guide


Territory Winning Rules

12.8 Territory Winning Rules


Territory Manager uses the Number of Winners field set to the top level of territory
hierarchy to determine the winning territories. This field cannot be entered if it is
not the top level territory.
Territory winning rules are used in several different ways in the Oracle E-Business
Suite. For example, Oracle Service tends to enter ONE in the Number of Winners
field, which helps to select the most qualified resources for the service requests.
Multiple winners are commonly used in Oracle Sales to meet the business needs,
but a single winner is also used in Sales. If the Number of Winners field is not set,
then the number of winning territories defaults to one for the hierarchy under that
top-level territory.
There are two possible outcomes based on values entered in the Number of Winners
field:
■ One Winner
■ Multiple Winners

One Winner
If you enter 1 in the Number of Winners field in the Overview tab, then Territory
Manager assigns the transaction to a single territory in the territory hierarchy.
Use the territory ranking mechanism for breaking ties between wining territories.
The highest rank of competing territories (which is represented by a lower number)
wins against the lowest rank of the territories (which would be the higher number)
in the territory hierarchy.

Multiple Winners
If you enter a number greater than 1 in the Number of Winners field in the
Overview tab, then Territory Manager assigns a transaction to multiple qualifying
territories.
Use the Number of Winners field to limit the number of winning territories.
However, if there are three territories that qualify for the criteria, but it can only
have two winners, then ranking determines the final two winners among the three
territories.

Note: Only the territory that has resources attached can be a


winning territory.

Introduction to Oracle Territory Manager 12-15


Territory Winning Rules

Rank
Rank is used to specify the priority of a territory among multiple winners. The
choice is only random if no rank has been defined. The lowest rank of competing
territories wins at the same level in the hierarchy. For example, from rank 1 to 10 for
the same hierarchy level, rank 1 has the highest priority.

Example
The following example shows how zip codes are used to set up three overlapping
territories:
Territory 1: zip code Between 90001 and 90051
Territory 2: zip code Between 90020 and 90070
Territory 3: zip code Between 90049 and 90052
Note that the transaction value: zip code = 90050
The previous three territories are all qualified for this transaction. If the Number of
Winners is set to ONE, then the single winning territory in the following both
situations is:
■ Condition A:
– Territory 1: Rank 2
– Territory 2: Rank 3
– Territory 3: Rank 2
Winner can be either Territory 1 or Territory 3.
Reason: Any territory with rank 2 can be the winner. The Assignment Manager
selects Territory 1 or Territory 3 randomly.
■ Condition B:
– Territory 1: Rank 3
– Territory 2: Rank 2
– Territory 3: Rank 4
The winner is Territory 2.
Reason: The territory with rank 2 wins over the territories with rank 3 and 4.

12-16 Oracle CRM Application Foundation User Guide


Understanding the Territory Details Tab

12.9 Understanding the Territory Details Tab


The following table describes the different tabs available in the Territory Details
Windows.

Territory Details Window Tabs


Tab Description
Overview Tab Use this tab to enter basic territory information including name,
description, effective dates, and crucial information like rank,
number of winners, and transaction types.
Transaction Qualifiers Specify transaction qualifiers and their values for a territory.
Tab
Resource Qualifiers (Optional) Use this tab to specify resources qualifiers and their
Tab values.
It is not mandatory to enter resource qualifier information if you
know exactly what resources you want to use in a territory.
Resources Tab Use this tab to specify resources manually or click the Auto
Assign Resources button to display and select qualifying
resources based on resource qualifiers and their values defined in
the Resource Qualifiers tab.
Subterritories Tab (Optional) Use this tab when a territory hierarchy includes
territories following the current territory. Click New Subterritory
and repeat the territory creation procedure for new subterritories.

WARNING: After creating or modifying a territory, you must run


the concurrent program “Generate Territory Package.” This
allows the system to compile the business rules defined in the
territory creation.
If this step is not completed, changes to territories will not be
reflected when the Territory Assignment Engine assigns
transactions.

Introduction to Oracle Territory Manager 12-17


Understanding the Territory Details Tab

12-18 Oracle CRM Application Foundation User Guide


13
Overview of Using Oracle Territory Manager

This chapter covers the following topics:


■ Accessing the Oracle Territory Manager Interface
■ Summary of Oracle Territory Manager Tasks

13.1 Accessing the Oracle Territory Manager Interface


You can access the Territory Manager in two ways:
■ From the Administration pull-down menu
You can create territories, types, templates, or escalation territories using
appropriate windows. In addition, open the Territory Search window to
perform a search. By entering search criteria in the Basic or Advanced tab, you
can locate the territories, types, templates, or escalation territories that match
your criteria.
■ From the territory tree Navigator window
By accessing the Territory Manager, you are able to view and search for
territories. Use the Navigator to:
– View the structure of territories in a tree format and create new territories.
– View and modify territory types and the territories created by using them.
– View and modify your created escalation territories.
– View and modify territory templates and the territories created by using
them.
– Search for the territory you want to view or modify from the tree structure.

Overview of Using Oracle Territory Manager 13-1


Summary of Oracle Territory Manager Tasks

– View and modify any item in the tree by double-clicking on it. If this is the
first territory you are creating, then select the node of an Application, for
example, Oracle Service or Oracle Sales and Telesales applications.

See Also
Searching and Viewing Territories

13.2 Summary of Oracle Territory Manager Tasks


Use Oracle Territory Manager to perform the following types of tasks:
■ Chapter 14, Using the Territory Manager Lookup Tool
■ Chapter 15, Running Reports in Territory Manager

13-2 Oracle CRM Application Foundation User Guide


14
Using the Territory Lookup Tool

This chapter covers the following topics:


Using the Territory Lookup Tool

14.1 Using the Territory Lookup Tool


Use the Territory Lookup Tool to find:
■ An organization
■ A sales representative
The HTML based Territory Lookup Tool returns the names of the sales
representatives who are defined under the Sales and Telesales usage. It searches
down the territory hierarchy to find the resources of the winning territories.

Note: In the Organization field, you can use a wild card with at
least two letters.

In the Territory Lookup tab, there are three ways to search for information that are
based on the responsibility described in the following table:

Territory Lookup Tool Access Privileges


Lookup Lookup by Advanced
Responsibility Name Subtab Organization Lookup Subtab
Subtab
Territory Lookup User Yes No No
Territory Lookup Yes Yes No
Intermediate User

Using the Territory Lookup Tool 14-1


Finding a Salesperson Using the Lookup Subtab

Territory Lookup Tool Access Privileges


Lookup Lookup by Advanced
Responsibility Name Subtab Organization Lookup Subtab
Subtab
Territory Administration Yes Yes Yes
HTML

How to use each subtab is described as follows:


■ Territory Lookup using the Lookup subtab
■ Territory Lookup using the Lookup by Organization subtab
■ Territory Lookup using the Advanced Lookup subtab

14.2 Finding a Salesperson Using the Lookup Subtab


Perform the following steps to look up a customer’s assigned sales representatives.

Note: This subtab uses the following qualifiers which aid in the
search:
■ Country Code transaction qualifier (Country field)
■ Postal Code transaction qualifier (Postal Code field)
■ Customer Name Range transaction qualifier (Organization
field)

Prerequisites
■ Customer Name Range, Country Code and Postal Code qualifiers are enabled.
■ Create the necessary territories using the appropriate enabled transaction
qualifiers.
■ Acquire the appropriate responsibilities

Responsibilities
■ Territory Lookup User
The Territory Lookup User responsibility allows you access to the Lookup
subtab only.

14-2 Oracle CRM Application Foundation User Guide


Finding a Salesperson Using the Lookup by Organization Subtab

Navigation
Navigate to the Territory Lookup window.

Steps
1. Enter your user ID and password and click Go.
The Territory Lookup window opens.
2. (Optional) Enter the organization name in the Organization field. You can use
two wildcards after entering one letter. For example, A%%.
3. Select the country from the drop-down menu.
4. Enter the complete postal code.
5. Select Lookup.
The results will be listed at the bottom of the window. The results include
columns which display the salesperson’s name, role, job title, phone number,
e-mail address, manager’s name, manager’s phone number, territory name, and
top level parent territory.

14.3 Finding a Salesperson Using the Lookup by Organization Subtab


If you don’t know the postal code of the company of which the sales representative
belongs to, then use the Lookup by Organization subtab to find the name of the
company.
This subtab uses the following criteria:
■ Customer Name in the Organization field
■ (Optional) State in the State/Province field
■ (Optional) Country in the Country field
■ (Optional) Postal Code transaction qualifier in the Postal Code field
Searching for salespersons is a two-step process. First you search for your
organization which is based on the TCA model and will return all values that match
your criteria in the Results region. Then click Lookup for the desired organization
which is based on sales account transaction qualifiers.

Prerequisites
■ Enable qualifiers

Using the Territory Lookup Tool 14-3


Finding a Salesperson Using the Lookup by Organization Subtab

■ Create the necessary territories


■ Acquire the appropriate responsibilities

Responsibilities
■ Territory Lookup Intermediate User
The Territory Lookup Intermediate User responsibility allows you access to the
following subtabs:
– Lookup subtab
– Lookup by Organization subtab

Note: The Territory Administration HTML responsibility also


allows you access to the Territory Report tab to run the Territory
Definitions Report (HTML) and Territory Changes Report (HTML).

Navigation
Navigate to the Territory Lookup window.

Steps
1. Enter your user ID and password and click Go.
The Territory Lookup window opens.
2. Select the Lookup by Organization subtab.
The Territory Lookup by Organization window opens.
3. Enter the name of the company in the Organization field. You can use wildcards
to aid your search.
4. (Optional) Select the state from the State/Province drop-down menu.
5. (Optional) Select the country from the Country drop-down menu.
6. (Optional) Enter complete postal code in the Postal Code field.
7. Click Go.
The results will be listed at the bottom of the window. The results list the
matching organizations and addresses.
8. If you see your selection listed, click Lookup in the matching column.

14-4 Oracle CRM Application Foundation User Guide


Finding a Salesperson Using the Advanced Lookup Subtab

The Territory Lookup Results window opens displaying the salesperson’s


name, role, job title, phone number, e-mail address, manager’s name, manager’s
phone number, territory name, and top level parent territory.
If you do not see your selection listed, you can either scroll to the bottom of the
page and use the navigation links, or perform another search.

14.4 Finding a Salesperson Using the Advanced Lookup Subtab


The Territory Lookup Tool, with the Territory Administration HTML responsibility,
has a dynamic window format that requires no customizing. It dynamically
displays the enabled account qualifiers for sales that are selected in Territory
Manager. Use the advanced search to search for territories using specific criteria.

Note: The organization field uses the Customer Name Range


transaction qualifier and NOT the Customer Name transaction
qualifier.

Prerequisites
■ Enable qualifiers
■ Create the necessary territories using at least one qualifier
■ Acquire the appropriate responsibilities

Responsibilities
■ Territory Administration HTML
The Territory Administration HTML responsibility allows you access to the
following subtabs:
– Lookup subtab
– Lookup by Organization subtab
– Advanced Lookup subtab

Note: The Territory Administration HTML responsibility also


allows you access to the Territory Report tab to run the Territory
Definitions Report (HTML) and Territory Changes Report (HTML).

Using the Territory Lookup Tool 14-5


Finding a Salesperson Using the Advanced Lookup Subtab

Navigation
Navigate to the Territory Lookup window.

Steps
1. Enter your user ID and password and click Go.
The Territory Lookup window opens.
2. Select the Advanced Lookup subtab.
The Advanced Lookup window opens.
3. Enter your search criteria in any of the following fields.
■ Organization (corresponds to the Customer Name Range qualifier)
■ Country (from the drop-down menu)
■ State (from the drop-down menu)
■ Province (from the drop-down menu)
■ Postal Code
■ County
■ Area Code
■ Customer Category (from the drop-down menu)
■ Company Annual Revenue
■ SIC Code
■ Number of Employees
■ City
4. Select Lookup.
The results will be listed at the bottom of the window. The results list the
matching organizations and addresses.
5. If you see your selection listed, click Lookup in the matching column.
The Territory Lookup Results window opens displaying the salesperson’s
name, role, job title, phone number, e-mail address, manager’s name, manager’s
phone number, territory name, and top level parent territory.
If you do not see your selection listed, you can either scroll to the bottom of the
page and use the navigation links, or perform another search.

14-6 Oracle CRM Application Foundation User Guide


15
Running Reports in Territory Manager

This chapter covers the following topics:


■ Territory Definitions Report (Forms)
■ Territory Changes Report (Forms)
■ Territory Definitions Report (HTML)
■ Territory Changes Report (HTML)

15.1 Territory Definition Report (Forms)


Run the Territory Definition Report to see a list of each territory, including
transaction types, qualifier conditions, resources, and resource access information.

Note: If you want to view your report as a spreadsheet, it is faster


to verify your selection in HTML and then export it to Microsoft
Excel.

Perform the following steps to retrieve specific territory information based on


certain criteria, such as a specific resource or a transaction qualifier.

Prerequisites
None

Responsibility
CRM Administrator

Running Reports in Territory Manager 15-1


Territory Changes Report (Forms)

Navigation
Navigate to the Territory Definition Report window.

Steps
1. Select Territory Manager > Territory Reports > Territory Definition Report.
The Territory Report window opens.
2. Select Output Format from the drop-down menu.
Choose either HTML or Excel.
3. Select Sales Representatives from the drop-down menu.
4. Select Qualifiers from the drop-down menu and click OK.

15.2 Territory Changes Report (Forms)


Perform the following steps to trace territory change information for a specific
period of time. This report displays your updated territory information but does not
show the differences from what existed before any changes were made. It also will
only show changes that were done in the Overview tab.

Prerequisites
None

Responsibility
CRM Administrator

Navigation
Navigate to the Territory Changes Report window.

Steps
1. Select Territory Manager > Territory Reports > Territory Changes Report.
The Territory Changes Report window opens.
2. Select Output Format from the drop-down menu.
Choose either HTML or Excel.
3. Enter values for the Earliest Change Date and the Latest Change Date.
4. Click OK.

15-2 Oracle CRM Application Foundation User Guide


Territory Definition Report (HTML)

15.3 Territory Definition Report (HTML)


Perform the following steps to retrieve specific territory information based on
certain criteria, such as a specific resource or a transaction qualifier. To narrow your
search, you can additionally select from the resource and qualifiers that are
associated from that usage.

Prerequisites
None

Responsibilities
■ Territory Lookup Intermediate User
■ Territory Administration HTML
Use the Territory Lookup Intermediate User responsibility and the Territory
Administration HTML responsibility to access the Territory Report tab in addition
to the Territory Lookup tab.

Navigation
Navigate to the Territory Lookup window.

Steps
1. Enter your user ID and password and click Go.
The Territory Lookup window opens.
2. Select the Territory Report tab.
The Definitions report window opens.
3. From the drop-down list in the Usage field, make your selection.
4. To refine your report, use the drop-down lists in the Resource and Qualifier
fields.
5. In the Active On field, either keep the default date (current date) or click the
Date Picker to select the desired date.
6. Click View Report.
The Territory Definitions window displays your requested data.

Running Reports in Territory Manager 15-3


Territory Changes Report (HTML)

Note: You can click on the Comma Separated Format icon to


download your report in a Microsoft Excel format.

15.4 Territory Changes Report (HTML)


Perform the following steps to trace territory change information for a specific
period of time. This report displays your updated territory information but does not
show the differences from what existed before any changes were made. It also will
only show changes that were done in the Overview tab excluding usage changes.

Prerequisites
None

Responsibilities
■ Territory Lookup Intermediate User
■ Territory Administration HTML
Use the Territory Lookup Intermediate User responsibility and the Territory
Administration HTML responsibility to access the Territory Report tab in addition
to the Territory Lookup tab.

Navigation
Navigate to the Territory Lookup window.

Steps
1. Enter your user ID and password and click Go.
The Territory Lookup window opens.
2. Select the Territory Report tab.
The Definitions report window opens.
3. Select the Changes Report from the subtab.
The Territory Changes Report window opens.
4. From the drop-down list in the Usage field, make your selection.
5. Enter your required date in the Earliest Change Date field.
6. To refine your report, you can enter the date in the Latest Change Date field.

15-4 Oracle CRM Application Foundation User Guide


Territory Changes Report (HTML)

7. In the Active On field, either keep the default date (current date) or click the
Date Picker to select the desired date.
8. Click View Report.
The Territory Changes Report window displays your requested data.

Note: You can click on the Comma Separated Format icon to


download your report in a Microsoft Excel format.

Running Reports in Territory Manager 15-5


Territory Changes Report (HTML)

15-6 Oracle CRM Application Foundation User Guide


Part IV
Assignment Manager

This part of the Oracle CRM Application Foundation User Guide contains the
following chapters:
■ Introduction to Oracle Assignment Manager
■ Overview of Using Oracle Assignment Manager
■ Assigning Options
■ Viewing Resource Information in Assignment Manager
16
Introduction to Oracle Assignment Manager

This topic group provides overviews of the application and its components,
explanations of key concepts, features, and functions, as well as the application's
relationships to other Oracle or third-party applications.
This chapter covers the following topics:
■ Overview of Oracle Assignment Manager
■ Oracle Assignment Manager Integrations
■ Ownership and Resources
■ The Gantt Chart
■ Assigning a Process
■ Selecting Assignment Criteria
■ Process Flow for Oracle Assignment Manager
■ What’s New in This Release
■ Terms and Definitions

16.1 Overview of Oracle Assignment Manager


The following topics describe Assignment Manager and its use:
■ What is the Assignment Manager?
■ What is an Assignment?

Introduction to Oracle Assignment Manager 16-1


Overview of Oracle Assignment Manager

16.1.1 What is Assignment Manager?


Assignment Manager is a tool used to select and designate qualified resources to a
document or a task. It is not a stand-alone module so that it can only be accessed
from other modules and applications. It supports all resource categories defined in
the Resource Manager module.

Note: Documents can be leads, opportunities, service requests,


defects, or escalations. Once a document is created, it can require
multiple tasks to fulfill the requirements.

Using Assignment Manager, you can assign resources for a task or document as
well as assign ownership.

Designate Resources
For example, you log a service request. Before sending qualified resources, use
Assignment Manager to determine:
■ Resources that are responsible for the company’s geographical location
■ Resources that are available for a specific time frame, such as, by the end of the
week
■ Resources with the lowest labor rate and available time slot information
■ Resources preferred by the company

Assign Ownership
Besides assigning qualified resources to a task or a document, Assignment Manager
can also assign ownership to a task or a document. Use Assignment Manager to:
■ Assign responsibility for documents and tasks
■ Assess the availability of qualified resources needed to be an owner for a task or
document
The assignment process uses criteria based on preferred resources, availability, and
territories. An optional module, Oracle Scheduler provides additional features to
optimize scheduling resources.

16-2 Oracle CRM Application Foundation User Guide


Oracle Assignment Manager Integrations

16.1.2 What is an Assignment?


An assignment is any given task or responsibility. It can be delegated to you, due to
your skill or due to your availability during a specific time frame.

Example
A support manager promises to fix all hardware computer problems in the
company. You, as a desktop support technician, are requested to fix all the desktop
computer problems by the end of this week due to your expertise in the hardware
support group. This assignment, assigned by your manager, can either be accepted
or rejected depending on your availability. In this example, the support manager is
the owner of the assignment. You are the assignee if you accept the assignment. The
assigning criteria is based on your expertise and resource availability for a specific
period of time.

16.2 Oracle Assignment Manager Integrations


The following Oracle CRM applications integrate with Assignment Manager:
■ Contracts provides preferred engineers.
■ Installed Base determines preferred engineers.
■ TeleSales uses Assignment Manager to assign appropriate resources to a lead.
■ Teleservice (formerly known as Customer Support) uses Assignment Manager
to help assign an owner to a service request.
■ Field Service uses Assignment Manager in the Dispatch Center (previously the
Control Tower) to assign an owner to a field service request.
The following Oracle Application Foundation modules integrate with Assignment
Manager:
■ Territory Manager provides qualified resources identified in a territory.
■ Escalation Manager uses Assignment Manager to help assign an owner to an
escalation document.
■ Forms-based Calendar offers resource work shift information.
■ Task Manager (Forms-based) determines task duration. Tasks also uses
Assignment Manager to help assign resources (an owner and an assignee) to a
task.

Introduction to Oracle Assignment Manager 16-3


Ownership and Resources

Note: When assigning resources to a HTML task, you can


manually assign resources, or use backend processes to call
Assignment Manager and then update the resource assignment
table for a task assignment.

Oracle Quality Online, Sales Online and iSupport applications can either manually
select resources or use backend processes to call Assignment Manager for resource
selection.

16.3 Ownership and Resources


Use Assignment Manager to assign ownership and resources to a specific task or
document based on selection criteria including customer preferred resources,
territories, and resource availability. The following section discusses the concept of
ownership and resource assignment options.
■ Assigning Ownership
– Assisted Assignment Option
– Unassisted Assignment Option
■ Assigning Resources
– Assisted Assignment Option
– Unassisted Assignment Option
– Intelligent Assignment Option
– Window to Promise Assignment Option

16.3.1 Assigning Ownership


You must assign an owner when you create a document or task to ensure that some
type of action is taken.
■ A document owner can be a service manager, expediter, marketing person,
service support, or a salesperson.
■ A task owner can be a planner, dispatcher, or service representative. An owner
is defined as a resource within Assignment Manager.
In order for a task or service request to be fulfilled, that task or service request must
have a person (owner) responsible for subsequent actions. The actions are

16-4 Oracle CRM Application Foundation User Guide


Ownership and Resources

performed either by that person or by someone else (assignee) for task completion.
The assignee is selected based on ability or availability.

Note: Task assignments are time sensitive and dependent on


resource availability. Therefore, the Intelligent and Window to
Promise options are limited to selecting assignees. They are not
used for assigning ownership.

The following table describes the two options used for assigning ownership.

Table 16–1 Assigning Ownership


Option Description
Assisted Assignment Use this option to find a list of qualified resources based on a
Option predefined set of criteria.
When no resource can be found based upon the selection
criteria, you must adjust your criteria and perform a search
again.
Unassisted Assignment Use this option to assign a task or document without taking
Option the criteria into account, or to overrule the criteria set.

16.3.2 Assigning Resources


Use Assignment Manager to designate qualified resources for a task or a document
based on certain criteria, such as availability and resource location.
The following table describes the four options for assigning resources.

Table 16–2 Assigning Resources


Option Description
Assisted Assignment Use this option to find a list of qualified resources based on a
Option predefined set of criteria. The Gantt chart displays tasks and
task statuses. When no qualified resource is shown, you must
adjust your criteria and search again.
When no resource can be found based upon the selection
criteria, you must adjust your criteria and perform a search
again.

Introduction to Oracle Assignment Manager 16-5


Ownership and Resources

Table 16–2 Assigning Resources


Option Description
Unassisted Use this option to assign a document or task without
Assignment Option considering search criteria.
For example, to assign a group to a task, either specify the exact
group name or partial name, if known, or search for all group
resources and then select them based on resource availability for
the task.
Intelligent This is an option specific to field service that is only available
Assignment Option when Oracle Scheduler is installed. This option provides
relative cost and travel time information, which is particularly
useful to Field Service. The Intelligent option has been disabled
as a menu choice in Service Request and in Escalations. It is
used only in the Field Service Dispatch Center.
Window to Promise This is an option specific to field service that is only available
Assignment Option when Oracle Scheduler is installed. The Window to Promise
displays time intervals at which a resource (service
representative) can visit the customer to perform the task. The
Window to Promise option has been disabled as a menu choice
in Service Request and in Escalations. It is used only in the Field
Service Dispatch Center.

16.3.3 Assisted Assignment Option


Instead of selecting resources based on your own choices, use the Assisted
Assignment option to find a list of active resources in Assignment Manager based
on a predefined set of criteria. When Assignment Manager is invoked, the Assisted
option is the default assigning mode.

Note: In the Unassisted and Assisted assignment options,


Assignment Manager does not return any end dated resources. All
resources populated in the Gantt chart are active resources.

For task assignments, save your task first before launching Assignment Manager.
Otherwise, the task start and end date information will not populate automatically
in the document details region.
Use this option if you want Assignment Manager to assist you in selecting qualified
resources to be the owner of a document or to fulfill a task based on certain criteria.
This selection criteria can help you assign qualified resources to a task or a
document.

16-6 Oracle CRM Application Foundation User Guide


Ownership and Resources

Example
Business World is having computer problems and has requested its vendor, Vision
Corporation’s support department. Vision’s customer support representative needs
to send resources to Business World for this assignment. The representative can use
the Assisted option in Assignment Manager to help select qualified resources. The
search criteria are:
■ Resources preferred by Business World
■ Resource recommendations based on territory assignment
■ Resource recommendations based on time availability for the next five business
days
The following selection criteria are available in the Assisted option:
Preferred Resources: This is used to retrieve a customer’s preferred resources
(engineers) defined in Oracle Contracts or Installed Base.
Territories: If the Territories check box is selected, then you can identify the
transaction qualifiers, for example Customer Name, to be used in territory selection.
If this is the first time running Assisted option, all transaction qualifiers are
automatically checked. After a search, all resources in the winning territories with
transaction qualifier "Customer Name" are displayed in the Resource region.
Resource Availability: This is used to search for all available resources based on a
task or a document duration.
After a search, you can view shift schedules and assigned tasks in the Gantt chart.

See Also
■ Unassisted Assignment Option
■ Intelligent Assignment Option
■ Window to Promise Assignment Option
■ Viewing and Assigning Resources in the Gantt Chart
■ Viewing Resource Web Availability in the Gantt Chart
■ Viewing Support Site Name Information in the Gantt Chart
■ Viewing a Resource’s Product Skills Rating

Introduction to Oracle Assignment Manager 16-7


Ownership and Resources

16.3.4 Unassisted Assignment Option


Use the Unassisted Assignment option if you want to assign a document without
taking search criteria into account. If you want to assign a group resource to a task,
then either specify the group name (if you know it) or search for all group
resources, and then make your choice based on resource availability for the task.

Note: In the Unassisted and Assisted assignment options,


Assignment Manager does not return any end dated resources. All
resources populated in the Gantt chart are active resources.

Example
Business World Inc. buys computers from Vision Corporation as well as having a
service agreement with Vision. Vision’s customer support representative receives a
call from Business World requesting Vision to repair one of the on-site computers
within five business days. The representative logs a service request and then creates
a task for the request. She also enters the current date as the planned start date and
adds five business days to establish the end date. In addition, she enters Business
World’s location for this request. Before assigning qualified resources to this task,
she calls to a hardware support manager for resource recommendations. The
supporting manager suggests John Doe, as he has previously worked with Business
World.
The customer support representative then uses Assignment Manager to view the
availability information for Doe before assigning him to the request. After
launching the Assignment Manager from a service request or a task, she selects the
Unassisted Assignment option and enters the following resource information to
limit resource selection:
Resource Partial Name: If she knows exactly what resources she is going to assign
to a task or document, then she can enter the resource name or partial name to limit
the selection.
Resource Type: This field limits resource selection to a specific resource type. For
example, select group resource in the Resource Type field to retrieve all the group
resources information.
If the Unassisted Assignment option is selected, predefined selection criteria will
not be available. After a search, she can view shift schedules and assigned tasks in
the Gantt chart.

16-8 Oracle CRM Application Foundation User Guide


Ownership and Resources

See Also
■ Assisted Assignment Option
■ Window to Promise Assignment Option
■ Viewing and Assigning Resources in the Gantt Chart

16.3.5 Intelligent Assignment Option


The Intelligent assignment option is used only in the Field Service Dispatch Center.
It displays resources with costs and travel time information which is particularly
useful to Field Service. When Oracle Scheduler is installed, the Intelligent
assignment option enables you to assign a task based on predefined constraints to
qualified service representatives. These constraints, travel time, travel distance,
working overtime, delay time, and so on, are cost related and are set up based on
your business needs.
The result of using this option is the creation of sequenced tasks for each qualified
resource. Therefore, the travel time is indicated in the beginning of each task and
between tasks. You can optimize this schedule later or reassign a task before
dispatching the schedule to the service representative.

Note: Oracle Scheduler uses the Time Distance Server to


determine the cost for a qualified resource. It is based on the field
service representative’s starting and ending locations for a task (or
between two tasks) and the amount of time that it takes to travel.
Therefore, each task needs location information that is derived from
the address using street, city, country, and zip code.
The Intelligent option has been disabled as a menu choice in
Service Request and in Escalations. This option is used only in the
Field Service Dispatch Center. Refer to Oracle Field Service
documentation for detailed information.

Once the Intelligent option is selected, you can select any combination of the same
three search criteria that are used in the Assisted option.

See Also
■ Assisted Assignment Option
■ Assisted Assignment Option

Introduction to Oracle Assignment Manager 16-9


Ownership and Resources

■ Unassisted Assignment Option


■ Window to Promise Assignment Option
■ Viewing and Assigning Resources in the Gantt Chart

16.3.6 Window to Promise Assignment Option


As with the Intelligent assignment option, use the Window to Promise assignment
option only in the Field Service Dispatch Center. This option displays time slots at
which a service representative can visit a customer to perform a task. This time slot
is reserved for a customer and is defined in the Oracle Scheduler setup window.
One time slot can be reserved for multiple customers.
The time window is also calculated through the Time Distance Server. It is based on
the field service representative’s starting and ending locations for a task (or between
two tasks) and the amount of time that it takes to travel between the two. Therefore,
each task needs location information that is derived from the address.
This option is especially useful, as it not only provides you with the functionality to
select the qualified resource based on predefined resource selection criteria, it also
takes into consideration the customer’s preferred time frame with possible costs
identified for task completion.

Example
Business World reports network problems and asks Vision Corporation to send a
field technician for hardware repair. To minimize costs, Business World requests
that the work is to be done between 10:00 am to 12:00 p.m. on Wednesday or 8:00
a.m. to 12:00 p.m. on Friday. Vision estimates that this repair would take four hours
to complete.
Vision’s field service dispatcher logs a service request and selects the Window to
Promise option in Assignment Manager. This helps her identify a resource who is
available from 8:00 a.m. to 12:00 p.m. on May 4, 2001 (Friday) with a reasonable cost
for the assignment. After the Window to Promise option is selected, she selects the
following options:
Preferred Resources: She unchecks all the preferred resources if no preferred
engineers are identified in Contracts or Installed Base.
Territories: She selects the Territories check box to use territories to assist in the
resource assignment.
Resource Availability: She checks this to see the available resource. This is not
available if neither Preferred Resources nor Territories are used.

16-10 Oracle CRM Application Foundation User Guide


The Gantt Chart

After a search, she can view shift schedules with relative cost information displayed
in a window format, instead of in a Gantt chart.

Note: The Window to Promise option has been disabled as a


menu choice in Service Request and in Escalations. This option is
used only in the Field Service Dispatch Center. Refer to Oracle Field
Service documentation for detailed information.

See Also
■ Assisted Assignment Option
■ Unassisted Assignment Option
■ Intelligent Assignment Option

16.4 The Gantt Chart


The Gantt chart provides a quick graphical overview of the scheduled tasks based
on a specific period of time.

Note: The Thin Client Framework (TCF) server must be set up


correctly and running in order for the Gantt chart to work properly.

After a search, you can view the following information for a specific resource in the
Gantt chart:
■ Shift Schedules (yellow background)
■ First Available Time (green bar)
■ Assigned Tasks (blue bar)
■ Escalated Tasks (red bar)
Shift schedules are defined in the Forms-based Calendar module.
You can drag the scroll bar to move across the Gantt if the shift or current time line
is not synchronized properly.

Introduction to Oracle Assignment Manager 16-11


The Gantt Chart

16.4.1 Shift Displays in the Gantt Chart

How to determine the resource’s available time?


The default for the First Available slot for a resource depends on the following:
■ The time the shift starts
■ The current time
Assignment Manager takes into consideration what the current time is and when
the resource’s shift actually starts. The end time for the first available slot equals
start time plus the duration. If no duration is specified, the default assumed is one
hour.

Examples
If the resource's shift runs from 9:00 a.m. to 6:00 p.m., and if the current time is 11:47
a.m., then if no start or end date-time is specified for the search, the Assignment
Manager defaults to 11:47 a.m. as the first available slot for a resource.
If the resource's shift runs from 9:00 a.m to 6:00 p.m., and if the current time is 8:47
a.m, then if no start or end date-time is specified for the search, the Assignment
Manager defaults to 9:00 a.m as the first available slot for a resource.

How does Assignment Manager determine duration and planned date


over duration when both are defined in task?
While assigning available time for a selected resource, Assignment Manager also
checks the planned start and end dates for the required task time frame to locate the
work shifts if identified, as well as checks the planned effort and duration effort to
determine the required work hours (or days) for a task assignment.
The following table describes the effort information that can be entered while
defining a task.

Table 16–3 Effort Information


Dates for a Task Description
Planned This is the effort required to complete a task. For example, a
task requires 10 hours work and is assigned to Mary and John.
Each needs to contribute five hours to complete this
assignment. The planned effort to complete this task is 10
hours.

16-12 Oracle CRM Application Foundation User Guide


The Gantt Chart

Table 16–3 Effort Information


Dates for a Task Description
Duration This is the actual time for task completion. For example:
■ If Mary works from 10:00 a.m. to 2:00 p.m., and John
continues from 2:00 p.m. to 7:00 p.m., then the duration of
this task is nine hours (10:00 a.m. - 7:00p.m.)
■ If John starts at 10:00 a.m., instead of 2:00 p.m., and
finishes at 3:00 p.m., then the duration is five hours (10:00
a.m. - 3:00 p.m.)
Actual This is the actual effort for a task. For example, the actual
effort for Mary to complete her work is four hours (10:00 a.m. -
2:00 p.m.) and for John is five hours (10:00 a.m. - 3:00 p.m.)

The following table describes the date information which can be entered while
defining a task.

Table 16–4 Date Information


Dates for a Task Description
Planned The planning start and end dates are required for a task. For
example, a hardware repair task is specifically required to
occur from February 12 to February 14, 2002.
Scheduled The scheduled start and end dates are shown here after the
resources are assigned through Assignment Manager, such as
February 12 at 8:00 a.m. to February 12 at 11:30 a.m., 2002.
Actual The actual start and end dates for the task.

The planned effort and duration effort do not always require the same work hours
or days. For example, if a task is assigned to one resource, from start to finish, then
the planned and duration efforts should be the same. However, if it is assigned to
more than one resources, then the planned effort (10 hours work to complete the
task) and duration effort (the actual time for a task completion, such as five hours
work) might not be the same.
Assignment Manager uses the following rules to determine the effort required for a
task assignment:
■ If the planned effort is provided while creating a task, but there is no duration
effort, then display the planned effort in Assignment Manager.

Introduction to Oracle Assignment Manager 16-13


Assigning a Process

■ If both planned effort and duration efforts are provided while creating a task,
then display the planned effort in Assignment Manager.
■ If the planned effort is not provided, but duration is provided while creating a
task, then display the duration effort in Assignment Manager.
In summary, planned effort always takes precedence and the Actual Effort is of no
significance while using Assignment Manager for a task assignment.

16.5 Assigning a Process


The process of selecting a qualified resource is based upon selection criteria and
customer selections. To make these criteria effective, some requirements need to be
met.
To understand the process for assigning documents and availability, the following is
explained in more detail:
■ Assignment Manager Dependencies
■ Assignment Manager Selection Criteria

16.5.1 Assignment Manager Dependencies


To make optimal use of Assignment Manager’s capability of assigning ownership
and resource availability, the following table describes required dependencies.

Table 16–5 Dependencies


Dependency Description
Preferred Resource A preferred resource is a single person or a resource group that
Information is defined in Oracle Contracts or is recommended from the
Installed Base in Oracle Service.
Territory Definition Territories are defined in Territory Manager. A territory has
resources or resource groups assigned to it.
For more information, see the module Territory Manager.
Task Duration Task duration is essential for checking the availability of the
Information resource and for designating a resource as unavailable in the
resources calendar after a task has been assigned.
Resource’s Availability Availability of the resource is provided by the Forms-based
Information Calendar component in which availability is defined.
For more information, see the Forms-based Calendar
documentation.

16-14 Oracle CRM Application Foundation User Guide


Assigning a Process

16.5.2 Assignment Manager Selection Criteria


In addition to the requirements listed in Assignment Manager Dependencies, the
following table describes the criteria Assignment Manager uses to select a qualified
resource for a document or task.

Table 16–6 Assigning Resource Availability


Criteria Description
Preferred Resources The first criterion the Assignment Manager considers in the
assignment process.
Territories Territories are used to retrieve all the qualified resources for the
assignment from the winning territories.
Resource Availability The availability of the resource is considered after a preferred or
qualified resource, based upon territories, is selected.

16.5.2.1 Preferred Resources


Preferred resources must first be set up in the following applications:
■ Oracle Service Installed Base
■ Oracle Contracts
A customer’s preferred resources can be employees, groups, or team resources set
up in Oracle Contracts or recommended from the Installed Base in Oracle Service.
Once the preferred engineers are identified in either application, you can retrieve
recommended resources based on specific customer preferences.

Examples:
1. Mary Smith and Jane Doe are specified as preferred engineers in contract
agreements with Company A. A service representative can use the Assisted
assignment option, by selecting the Contracts check box in Assignment
Manager, to display both engineers in the Resource region.
2. John Doe is specified as the Installed Base preferred engineer for Business
World. The Service Representative sees John’s name in the Resource region if
the Installed Base check box is checked.
For a service request assignment, when Contracts, Installed Base, and Territories
check boxes are all selected in the Assignment Manager window, the Assignment
Manager engine checks Contracts preferred resources first. If a Contracts preferred
resource is found, Assignment Manager displays this resource in the Gantt chart
and stop the process. If no resource is found, then Installed Base preferred resources

Introduction to Oracle Assignment Manager 16-15


Assigning a Process

will then be checked. If a preferred resource is found, then return the resource and
stop the process. If not, then Assignment Manager checks Territories for qualified
resources.
Default resource selection order is:
1. Contracts
2. Installed Base
3. Territories
You can change the default resource selection order by using the profile option
"Resource Search Order" if necessary.

Note: The Assignment Manager engine uses the "Activate


Contracts Preferred Engineers" and "Activate Installed Base
Preferred Engineers" profile options to determine whether or not
the preferred engineers are chosen automatically.

16.5.2.2 Territories
Territories defined in Territory Manager are used to provide resources for a task or
document. This assistance is done through the transaction qualifiers and qualified
resources identified in a territory. Transaction qualifiers aid (filter) in a territory win
over competitions between territories. The qualified resources in the winning
territories can then be assigned to a task or document. See the section on Territory
Manager for additional details.
When setting up resources in a territory, if resources are end dated in Resource
Manager, these end dated resources will not be displayed in the Assignment
Manager when using Assisted and Unassisted assignment options. See the section
on Resource Manager for additional details.

Example
Bob Black and Jack Green are the qualified resources in the West Coast Territory.
When a support manager tries to assign an open service request to the proper
resources located in the West Coast, she uses territories to assist Assignment
Manager in the selection. If the West Coast Territory happens to be the winning
territory, then Bob and Jack are listed in the Resource region in the Assignment
Manager window. The support manager can assign either one to the service request
based on their availability and customer needs.

16-16 Oracle CRM Application Foundation User Guide


Selecting Assignment Criteria

16.5.2.3 Resource Availability


Assignment Manager uses the Forms-based Calender to check the availability of a
resource. When a task is assigned to a resource, that resource becomes unavailable
for the period of time designated by the task.
After a preferred or qualified resource is identified, the next important criteria to
consider is the availability of that qualified resource. Resource availability
information is provided by the Application Foundation Forms-based Calendar
module in which the shift schedule is defined. Resource availability for a specific
time frame is determined by task planned start and end date. After a task or
document has been assigned to a resource, this designated resource becomes
unavailable and then will be reflected in the Assignment Manager window.

Note: The resource availability discussed here has a specific time


frame required by a task or document (task planned start and end
date). However, the resource Web availability always indicates
current time.

Example
Rhonda Abbott receives a call regarding a task that might take four hours (planned
efforts) work and needs to be completed next week. She can select territory as the
criteria and also check resource availability in the Assignment Manager window for
next week’s time frame. If Ralph Karmer is available, but Fred Bramer is fully
booked until next month, Ralph is selected for this job based on his availability even
though both are qualified. Rhonda can update the start and end date if necessary
and the time line for four hours work to Ralph accordingly.

16.6 Selecting Assignment Criteria


Use the following table to help you decide which options to choose when setting up
assignment criteria. This is done in the Assisted window of Assignment Manager.
The following table describes the list of required criteria:

Table 16–7 Assignment Criteria


Preferred Resource
Resources Territories Availability Selection Results in:
Yes No No A search for the preferred resource,
availability is not taken into account.

Introduction to Oracle Assignment Manager 16-17


Process Flow for Oracle Assignment Manager

Table 16–7 Assignment Criteria


Preferred Resource
Resources Territories Availability Selection Results in:
No Yes No A search for a qualified resource in the
selected territories, availability is not taken
into account.
No No No A search for an available preferred resource or
territories is not taken into account.
Yes Yes No A search for the preferred resource,
availability is not taken into account. When
no preferred resource is available, a search for
a qualified resource in the selected territories
is done, availability is not taken into account.
No No Yes The search looks for all resources in the
system taking availability into account.
No Yes Yes A search for a qualified resource in the
territories selected and availability is taken
into account.
Yes Yes Yes A search for the preferred resource or
territory, availability is taken into account. If
no preferred resource is available, a search for
a qualified resource in the selected territories
is done, availability is taken into account.

16.7 Process Flow for Oracle Assignment Manager


The following table describes the order and process of using Assignment
Manager.

Table 16–8 Assignment Manager User Process


Step Description Required Performed By
Assisted Assignment The Assisted assignment option is used to assign a Yes All Users
Option resource to a task or a document based on
predefined criteria.

16-18 Oracle CRM Application Foundation User Guide


What’s New In This Release

Table 16–8 Assignment Manager User Process


Step Description Required Performed By
Unassisted Assignment The Unassisted assignment option is used to Yes All Users
Option assign a resource to a document or task without
taking predefined criteria into account.
Intelligent Assignment (Optional) The Intelligent assignment option is No All Users
Option used to assign the resource, with the lower cost
and travel information, to a service request.
Window to Promise (Optional) The Window to Promise assignment No All Users
Assignment Option option is used to assign a resource to a specific
time slot to fulfill a task created within a service
request.

16.8 What’s New In This Release


The following new features have been added to Assignment Manager subsequent to
the 11.5.7.4 release.

Assignment Manager Has New Profile Options


There are several new profile options for use in this release of Assignment Manager.
They are:
■ JTFAM: Usage for Groups and Teams
■ JTFAM: Resource Search Order
For more information on these profile options, see Oracle CRM Application
Foundation Implementation Guide, Appendix A: Profile Options.

Use a Profile Option to Control Team and Group Resource Selection


Assignment Manager uses the value set in the JTFAM: Usage for Groups and Teams
profile option to control the selection criteria for group or team resources in a
service request assignment. If the usage value defined in the profile option matches
the usage identified in the Resource Manager, then the matched groups or teams
will be displayed in the Assignment Manager.
For example, if Support usage is selected for the profile option, then only the group
or team resources with Support usage also defined in the Resource Manager can
then be retrieved and displayed in the Assignment Manager for a service request
assignment. However, if there is no Support usage specified for any groups or

Introduction to Oracle Assignment Manager 16-19


What’s New In This Release

teams in the Resource Manager, then no group or team resource will be retrieved for
this assignment.

Resource Selection Order Is Prioritized for a Service Request


Assignment
For a service request assignment, when Contracts, Installed Base, and Territories
check boxes are selected in the Assignment Manager window, the Assignment
Manager engine checks Contracts preferred resources first. If a Contracts preferred
resource is found, Assignment Manager displays this resource in the Gantt chart
and stops the process. If no resource is found, then Installed Base preferred
resources will be checked. If a preferred resource is found, then return the resource
and stop the process. If not, then Assignment Manager checks Territories for
qualified resources.
Default resource selection order is:
1. Contracts
2. Installed Base
3. Territories
You can change the default resource selection order by using the profile option
JTFAM: Resource Search Order if necessary.

Individual Resources Can Be Displayed for a Service Request Group


Resource Assignment
This feature enables Assignment Manager to return qualifying individual resources
who belong to a selected resource group in a service request assignment with
territory assisted option.
For example, Linda Jones belongs to Group A which is assigned to Territory A.
Linda Jones and another resource, Marsha Abbott, are also assigned to Territory B.
For a service request assignment with territory assisted option, after selecting a
group type and clicking Assign Group to launch Assignment Manager, Group A
should be displayed in the Gantt chart if Group A happens to be the winning
territory. Additionally, if Assign Owner is then selected, then Assignment Manager
passes the selected group ID which is the ID of Group A as a parameter to retrieve
each qualifying resource and filters out those resources who do not belong to the
selected group. If Territory A and Territory B happen to the winning territories, then
only Linda Jones who belongs to the Group A can be displayed in the Gantt chart.

16-20 Oracle CRM Application Foundation User Guide


Terms and Definitions

16.9 Terms and Definitions


The following table describes the Assignment Manager terms and definitions.

Table 16–9 Assignment Manager Terms and Definitions


Term Description
Assignee An assignee is the designated person who commits to fulfill a
specific task or an assignment.
AM module The Assignment Manager is a tool that helps you assign
resources to a task or a document.
Assisted Assignment The Assisted assignment option is used to assign a resource to
Option a task or a document based on predefined criteria.
Unassisted Assignment The Unassisted assignment option is used to assign a resource
Option to a document or task of your choice without taking
predefined criteria into account.
Intelligent Assignment The Intelligent assignment option is used to assign the
Option resource with the lowest cost to a task created within a service
request.
Window to Promise The Window to Promise assignment option is used to assign a
Assignment Option resource to a specific time slot to fulfill a task created within a
service request.
Dispatch Center The Dispatch Center is a window in Field Service where you
can view resource availability or assign resources to a task. It
was originally called the Control Tower.
Gantt Chart The Gantt chart provides a graphical overview of the
scheduled tasks for resources.
Owner An owner is a person (resource) who oversees a task or a
document.
Resource Web Availability Resource web availability is defined as a resource who has the
immediate ability to work on a service request that is created
online.

Introduction to Oracle Assignment Manager 16-21


Terms and Definitions

16-22 Oracle CRM Application Foundation User Guide


17
Overview of Using Oracle Assignment
Manager

This topic group provides overviews of the application and its components,
explanations of key concepts, features, and functions, as well as the application's
relationships to other Oracle or third-party applications.
This chapter covers the following topics:
■ Accessing the Oracle Assignment Manager Interface
■ Summary of Oracle Assignment Manager Tasks

17.1 Accessing the Oracle Assignment Manager Interface


The Assignment Manager module is embedded within CRM Application
Foundation or other CRM products. It is not used as a stand-alone module and is
only accessible through other CRM applications, such as Customer Support and
Field Service, and Foundation modules, such as Task and Escalation Managers.
For example, you can access Assignment Manager through a stand-alone task in the
Forms-based Task Manager or through a task associated with a service request in
Teleservice and Field Service applications.
If accessing from Task Manager, first click More to bring up the Task Details
window. Then click the Assignment Manager icon in the Resources tab.

Note: Save your task first before launching the Assignment


Manager. Otherwise, the task’s start and end date information will
not automatically populate in the Document Details region.

Overview of Using Oracle Assignment Manager 17-1


Summary of Oracle Assignment Manager Tasks

17.2 Summary of Oracle Assignment Manager Tasks


Use Oracle Assignment Manager to perform the following types of tasks:
■ Chapter 19, Assigning Options
■ Chapter 20, Viewing Resource Information in Assignment Manager

17-2 Oracle CRM Application Foundation User Guide


18
Assigning Options

This topic group provides process-oriented, task-based procedures for using the
application to perform essential business tasks.

18.1 Overview
Choose one of the following assigning options for assigning tasks:
■ Assisted Assignment Option
■ Unassisted Assignment Option
■ Intelligent Assignment Option
■ Window To Promise Assignment Option

18.2 Assisted Assignment Option


Perform the following steps to use the Assisted option to assign a resource based
upon the selection criteria. The Gantt chart displays those tasks that have already
been assigned in blue and plan options in green. Move your cursor over a task to
view details.

Note: In the Unassisted and Assisted assignment options,


Assignment Manager does not return any end dated resources. All
resources populated in the Gantt chart are active resources.

Prerequisites
■ Oracle Contracts must be installed only if using Contracts preferred resources.

Assigning Options 18-1


Assisted Assignment Option

■ Oracle Installed Base must be installed only if using Installed Base preferred
resources.
■ Territory Manager must be installed and set up correctly if using territory
assisted option.

Responsibility
Since Assignment Manager is not a stand-alone module, the responsibility will vary
depending on the calling application or module.

Navigation
Navigate to the Assignment Manager window.

Steps
1. Select the Assisted option from the Selection Criteria.
2. Select appropriate selection criteria for your search.
3. Click Search.
The Gantt chart for the qualified resource appears.
4. If the Gantt chart is empty, then adjust the selection criteria and click Search
again.
5. Double-click on the resource who you want to use for this assignment.
The selection appears in the Resources, Resource Type, Start Time, and End
Time fields automatically.
If the selected resource has support site identified in Resource Manager, the
support site information also displays in the Support Site Name field.
6. Edit the preferred Start Time and End Time if needed.
7. Click OK to commit the assignment or click Cancel to leave Assignment
Manager without saving your changes.

See Also
■ Ownership and Resources
■ Unassisted Assignment Option
■ Intelligent Assignment Option
■ Window To Promise Assignment Option

18-2 Oracle CRM Application Foundation User Guide


Unassisted Assignment Option

■ Viewing and Assigning Resources in the Gantt Chart


■ Viewing Resource Web Availability in the Gantt Chart
■ Viewing Support Site Name Information in the Gantt Chart
■ Viewing a Resource’s Product Skills Rating

18.3 Unassisted Assignment Option


Perform the following steps to use the Unassisted option to assign a resource of
your choice to a task, without using the criteria set and the features of Oracle
Scheduler. The Gantt chart displays tasks previously assigned in blue. Move your
cursor over a task to view details.

Note: In the Unassisted and Assisted assignment options,


Assignment Manager does not return any end dated resources. All
resources populated in the Gantt chart are active resources.

Prerequisites
None

Responsibility
Since Assignment Manager is not a stand-alone module, the responsibility will vary
depending on the calling application or module.

Navigation
Navigate to the Assignment Manager window.

Steps
1. Select the Unassisted option from the Selection Criteria.
2. Make an entry in the Resource Partial Name or Resource Type field.
3. Click Search.
The Gantt chart for the resource or resources found appears.
4. Double-click on the preferred resource.
The selection appears in the Resources, Resource Type, Start Time, and End
Time fields automatically.

Assigning Options 18-3


Intelligent Assignment Option

If the selected resource has support site identified in Resource Manager, the
support site information also displays in the Support Site Name field.
5. Edit the preferred Start Time and End Time if needed.
6. Click OK to save the assignment or click Cancel to leave Assignment Manager
without saving your changes.

See Also
■ Viewing and Assigning Resources in the Gantt Chart
■ Ownership and Resources
■ Assisted Assignment Option
■ Intelligent Assignment Option
■ Window To Promise Assignment Option

18.4 Intelligent Assignment Option


This functionality has been disabled as a menu choice in assigning resources from
an escalation document and a Service Request. It is used only in the Field Service
Dispatch Center. Refer to Oracle Field Service documentation for detailed
information on how to use this option.

18.5 Assigning with the Window To Promise


This functionality has been disabled as a menu choice in assigning resources from
an escalation document and a Service Request. It is used only in the Field Service
Dispatch Center. Refer to Oracle Field Service documentation for detailed
information on how to use this option.

18-4 Oracle CRM Application Foundation User Guide


19
Viewing Resource Information in
Assignment Manager

This topic group provides process-oriented, task-based procedures for using the
application to perform essential business tasks.

19.1 Overview
Use the following topics to view resource information in Assignment Manager:
■ Viewing and Assigning Resources in the Gantt Chart
■ Viewing Resource Web Availability in the Gantt Chart
■ Viewing Support Site Name Information in the Gantt Chart
■ Viewing a Resource’s Product Skills Rating

19.2 Viewing and Assigning Resources in the Gantt Chart


The Gantt chart provides a quick graphical overview of the scheduled tasks based
on a specific period of time.

Prerequisites
The Thin Client Framework (TCF) server must be configured correctly and running
in order for the Gantt chart to work properly if using the Intelligent and Window to
Promise assignment options.

Login
Log in to Oracle Forms.

Viewing Resource Information in Assignment Manager 19-1


Viewing and Assigning Resources in the Gantt Chart

Responsibility
Since Assignment Manager is not a stand-alone module, the responsibility depends
on the calling application or module.

Navigation
Navigate to the Assignment Manager window.

Steps
1. Select either Assisted, Unassisted, or Intelligent mode in the Selection Criteria
section and click Search.
The Gantt chart populates with a list of resources in the Resource Name field.
2. View the following information for a specific resource.
■ Shift schedules (yellow background)
■ First available time (green bar)
■ Assigned tasks (blue bar)
■ Escalated tasks (red bar)
■ Travel time (first segment of an assigned task in white)
3. You can drag the scroll bar to move across the Gantt if the shift or current time
line is not synchronized properly.
4. Double-click on the resource that you are going to assign to a task or a
document.
The selected resource name, resource type, start and end time information
populates automatically.
5. You can manually change the start and end time, and the date, before clicking
OK to save the assignment.
6. When you are finished, either close the form or exit the application.

Guidelines
The start and end time information is based on the resource first availability for a
specific task time frame. If the selected resource has shift schedule defined in the
Forms-based Calendar, and the assigned shift is within the task time frame, then the
start and end time is based on the assigned shift time.
Shifts are defined in the Application Foundation Forms-based Calendar.

19-2 Oracle CRM Application Foundation User Guide


Viewing Resource Web Availability in the Gantt Chart

19.3 Viewing Resource Web Availability in the Gantt Chart


This feature is used for web-generated service requests, such as a service request
created through the iSupport application, to automatically assign resources (such as
support agents) who are currently web available to work on the request
immediately with customers. This automated resource selection process is done
through backend processes (Service Request’s and Assignment Manager’s internal
APIs) to select the appropriate resources who are currently Web available
automatically.
After the system automatically assign an owner to a Web-generated service request,
you can manually reassign the resources for the Web-generated service request if
necessary. To do so, you need to access the Forms-based service request window
and then query up the service request that was originally generated through the
Web and then manually reassign the resources by first removing the original owner
and then click Assign Request. This launches the Assignment Manager window.
Therefore, it is easier for an agent to know which resources are currently web
available and are ready to accept the service request immediately. If this resource is
not web available, then no symbol appears before the resource name. The purpose
of seeing whether or not a resource is web available is to allow a manager to view
and immediately reassign a service request online to another agent who is currently
web available to accept this task online.
Resource web availability is another resource selection criteria added to Assignment
Manager to help an agent to select the appropriate resources for service request
assignments. After assigning resources through Assignment Manager, the selected
resources still need to check their work assignment information through the
Universal Work Queue (UWQ).

Note: The resource web availability works with Territory Assisted


assignment option only. The available time indicates the current
time, not that for a specific time frame.

Prerequisites
Territory Manager must be installed and set up correctly.
Resources who are web available or unavailable should be identified by selecting
Tools > Web Availability from the application menu in the Create Service Requests
window or the Search Service Requests window.

Viewing Resource Information in Assignment Manager 19-3


Viewing Support Site Name Information

Login
Log in to Oracle Forms.

Responsibility
Responsibilities used in Oracle Service and Support applications

Navigation
Navigate to the Assignment Manager window.

Steps
1. In the Selection Criteria section, choose the Territory Assisted assignment
option and click Search.
The Gantt chart populates with a list of resources and their schedule.
2. If a resource is web available, there are three asterisks "***" to the left of the
resource name.
3. Double-click on the resource who you are going to assign to a task created
within a service request, or a service request.
The selected resource name, resource type, start and end time information
populates automatically.
4. You can manually change the start and end time, and the date, before clicking
OK to save the assignment.
5. When you are finished, either close the form or exit the application.

Guidelines
The resource web availability feature is used in the Oracle Support applications for
a service request assignment with Territory Assisted assignment option only.
The manual assignment process through the Forms-based service request window
to launch the Assignment Manager is used only when there is a need for resource
reassignment.

19.4 Viewing Support Site Name Information


When a resource is selected in Assignment Manager, the support site name that the
selected resource belongs to appears automatically in the Support Site Name field at

19-4 Oracle CRM Application Foundation User Guide


Viewing a Resource’s Product Skills Rating

the bottom of the window. This information is useful to determine how close a
resource is geographically to the client.
Support site information is defined in the Service Tab of the Forms-based Resource
Manager and in the Employees Detail window in HTML Resource Manager.

Prerequisites
A resource’s support site information should be identified first in Resource
Manager.

Login
Log in to Oracle Forms.

Responsibility
Since Assignment Manager is not a stand-alone module, the responsibility will vary
depending on the calling application or module.
Responsibilities used in Oracle Service application

Navigation
Navigate to the Assignment Manager window.

Steps
1. In the Selection Criteria section, choose one of the assignment options and click
Search.
The Gantt chart populates with a list of resources and their schedule.
2. Find your resource and click on the resource name.
If the Support Site Name has been defined in Resource Manager, you will see
this information at the bottom of the Gantt chart.
3. When you are finished, either close the form or exit the application.

19.5 Viewing a Resource’s Product Skills Rating


When assigning a resource to a service request, it is useful to know if the resource is
a specialist in a particular area. Besides seeing a resource’s availability or
geographical location, a manager can also see who is the best qualified or certified
for a given task.

Viewing Resource Information in Assignment Manager 19-5


Viewing a Resource’s Product Skills Rating

An employee or his manager can use the HTML-based Resource Manager module
to view the skill set and the level of expertise that he possesses. This functionality is
primarily used by Teleservice for a service request assignment with Territory
Assisted assignment option only.
Employees can rate their skill levels against specific products which are defined in
Oracle Inventory. When a service request is created, Assignment Manager searches
for the qualified territories against a specific product name specified in that service
request. Resources who are assigned to qualified territories (so-called winning
territories) display in the Gantt chart with product skill rating information. The best
resource can then be selected for the service request assignment. Perform the
following steps to view a resources product skills rating.

Prerequisites
Territory Manager must be installed and set up correctly.
Resources have their skill rating information defined in the HTML Resource
Manager module.

Login
Log in to Oracle Forms.

Responsibility
Responsibilities used in Oracle Service application

Navigation
Navigate to the Assignment Manager window.

Steps
1. In the Selection Criteria section, choose Territory Assisted option and click
Search.
The Gantt chart populates with a list of resources and their skill rating
information.
2. Find your resource and click on the resource name. The level associated with
that employee appear to the right of the name.
The selected resource name, resource type, start and end time information
populates automatically.
3. Click OK to save the assignment.

19-6 Oracle CRM Application Foundation User Guide


Viewing a Resource’s Product Skills Rating

Viewing Resource Information in Assignment Manager 19-7


Viewing a Resource’s Product Skills Rating

19-8 Oracle CRM Application Foundation User Guide


Part V
Task Manager

This part of the Oracle CRM Application Foundation User Guide contains the
following chapters:
■ Introduction to Oracle Task Manager
■ Overview of Using the HTML Task Manager
■ Viewing Task Information
■ Managing Tasks
■ Managing Task Preferences
■ Managing Task Contacts
■ Working with Forms-based Tasks
■ Scheduling and Tracking Forms-based Tasks
20
Introduction to Oracle Task Manager

This chapter covers the following topics:


■ Overview of Oracle Task Manager
■ Forms-based Task Manager User Interface
■ Oracle Task Manager Integrations
■ Integration with Notes and Calendar
■ Process Flow for Oracle Task Manager
■ What’s New in This Release
■ Terms and Definitions

20.1 Overview of Oracle Task Manager


All Oracle CRM products use Task Manager to manage tasks. It provides an
effective mechanism for organizations to respond to customer needs in a timely
manner. Use Task Manager to create, assign, manage, sort, and prioritize a task,
which is the lowest unit of work.
Typically, you access Task Manager directly to create personal tasks or view tasks
assigned to you. It can be called from other Oracle modules to provide integrated
solutions or it can be run as a stand-alone product. For example, Oracle Telesales
uses Task Manager to assign tasks pertaining to individual consumers,
organizations, and organizational contacts.
Using Task Manager, you can create new tasks, update tasks, or assign tasks. You
can accept an assigned task, finish the task, and create a new task. If you refuse or
reassign a task, the task can generate a series of notifications for other users or
managers. You can define an escalation process for tasks not performed in a

Introduction to Oracle Task Manager 20-1


Overview of Oracle Task Manager

specified amount of time. The following topics provide additional information on


the Task Manager:
■ What is a Task?
■ Task Manager Roles
■ Task Manager Rules

20.1.1 What is a Task?


A task is defined as the lowest unit of work. It can be assigned to one or more
resources. Tasks are managed by the Task Manager and are often scheduled events
with defined dates of completion. For example, a support manager of a company
can create a task for an employee resource stating, “Please call back customer by
9:00 am.”
A task includes information relating to actions such as resources, appointments,
references, dates, contacts, recurrences, and events. You must assign a task to a
resource or an object. Continuing from the previous example, once the support
manager creates the task to call back the customer, he can:
■ Assign a specific resource to perform the task.
■ Reference source documentation such as a service request.
■ Define the task as repeating so the customer is called every month.

20.1.2 Task Manager Roles


Task Manager roles provide security for a task by ensuring only those directly
involved with the task can view it. The following table describes Task Manager
Roles.

20-2 Oracle CRM Application Foundation User Guide


Overview of Oracle Task Manager

Table 20–1 Rights of Roles


Roles Description Rights
Owner The person who is in charge of the The owner can reassign the task to
task. another resource. When the task is
reassigned, the owner can no longer
view it unless they are also an
assignee.
As an owner you can:
■ View your tasks
■ Update all fields in the task
except the following auto
populated fields: Escalation
level, Escalation owner Contact
information
■ Reassign your tasks
■ Soft delete your tasks
Assignee The person who is actually working The assignee can reassign the task to
on the task. other resource types.
As an assignee you can:
■ View your tasks
■ Update all fields in the task
except the following auto
populated fields: Escalation
level, Escalation owner Contact
information
■ Soft delete your tasks

20.1.3 Task Manager Rules


Task Manager has several rules it follows for security purposes:
■ An owners and an assignee has full access to view, update, and delete a task.
■ If resource A grants read, write, or full access to resource B, then, with the
exception of private tasks, the privileges for tasks are granted to resource B.
■ Only the owner or assignee can delete a private task they created.
■ A Resource can search for a task:
– That they are granted read, write, or full access to.

Introduction to Oracle Task Manager 20-3


Overview of Oracle Task Manager

– That is assigned or owned by their group or team.


– That they have a role of owner or assignee.
■ A Resource can view and update the task only if:
– They are the owner or the assignee of the task.
– They are a group or team member.
– They are the owner or assignee.
– They have been granted full access to the task by some other resource.

Note: For integration purposes, security can be modified


depending on the Oracle application integrated with Task Manager.
For example, Oracle Marketing Online (OMO) gives users the
ability to access certain marketing objects, if they are on a team for
that object. This being the case, the user is able to view and update
all tasks created for that object whether or not they are the owner or
assignee or have been granted explicit access.

■ A Resource can delete a task only if:


– They are a group or team member
– They are the owner or assignee.
– They have been granted full access to the task by some other resource.
The following table describes how task notifications are handled in Task Manager.

Table 20–2 Task Notification


Event Notify
Task Creation Owner and all assignees
Task Deletion Owner and all assignees
Reassign Owner Old and new owner
Reassign Assignee Owner, the old and new assignee
Status Update of Owner Owner and all assignees
Priority Update Owner and all assignees
Type Update Owner and all assignees

20-4 Oracle CRM Application Foundation User Guide


Forms-based Task Manager User Interface

Table 20–2 Task Notification


Event Notify
Status Update of Owner Old and new owner
Add Assignee Owner and new assignee
Delete Assignee Owner and assignee
Planned, Scheduled, or Actual Owner and all assignees
Start and End Dates Update

20.2 Forms-based Task Manager User Interface


The following tabs are available in Task Manager, once you’ve created a task and
clicked the More button:
■ Task Resources
■ Task Dependencies
■ Task References
■ Tasks Dates
■ Task Contacts
■ Task Recurrences
■ Other Task Information
■ Task Audits

Task Resources
Use the Resources tab to assign personnel information to a task. This window
defines resource requirements, assignments, and scheduling information. For
example, a resource can be an employee, a group, or a party.

Task Dependencies
Use the Dependencies tab to determine the order of tasks. When an action requires
the creation of several tasks, you can set a dependency for each task. This
functionality is currently not supported.

Task References
Use the References tab to link tasks to different documents or pertinent background
information.

Introduction to Oracle Task Manager 20-5


Forms-based Task Manager User Interface

Task Recurrences
Use the Recurrences tab to schedule tasks to automatically repeat. Examples of
intervals include daily, weekly, monthly, or yearly occurrences. To schedule a
recurring task, you must either specify a start date and the number of times you
want the task to repeat or the end date.

Task Dates
Use the Dates tab to identify more dates in addition to the planned, scheduled, and
actual dates types. Use this tab to track task progress by entering date information
after each task milestones. Examples include task creation, resource reservation, or
task completion.

Task Contacts
Use the Contacts tab to create and manage multiple customer contacts assigned to a
task. Contact information is obtained from customer information. In order to enter
this information, you must identify a customer in the main task window.

Other Task Information


Use the Others tab to identify additional task information. You can customize tasks
by setting task flags. The Currency and Cost fields identify the currency of a task
and if there is a cost associated with it. These fields are used by the Oracle
Marketing applications. The following table describes flags in the Others tab.

Table 20–3 Task Flag Descriptions


Flag Description
Billable The Billable flag signifies a task as a service that requires
billing.
Holiday The Holiday flag indicates whether or not the task can be
performed on a holiday.
Multibook The Multibook flag indicates whether or not the task can book
resources that are already assigned to other tasks.
Milestone The Milestone Flag indicates whether or not the task is a
milestone.
Restrict Close The Restrict Close flag indicates whether or not it is necessary
to close the task in order for the source object to be closed. For
example, if this task references a service request, the task
would have to be closed to close the service request.

20-6 Oracle CRM Application Foundation User Guide


Oracle Task Manager Integrations

Task Audits
Use the Audits tab to view changes made to your tasks. The task audit record
documents the date and history of the task change. Each update to a task results in
an entry to the task audit record. Each record provides a trail from the original task
creation to the current task status. Each row documents the status of each task
change every time the task is saved.

Task Templates
Use task templates to make task creation simple and quick. Once a template is
defined, you can specify resource requirements, create dependencies, and schedule
repeating tasks.

Task Template Groups


Use task template groups to pre-define multiple commonly used tasks for different
activities (document type), such as service requests, escalations, tasks, and sales
opportunities. When creating tasks from a task template, you can select the
appropriate template group to generate tasks simultaneously.
For example, A service department constantly receives requests to fix computer
problems. Accomplishing this assignment usually involves three required tasks
including customer appointment, computer repair, and progress update. John
Smith, a service director, requests the creation of a task template group used
specifically for a service request called PC Repair which covers all these three tasks
defined in a template format with task information specified, such as the task type,
priority, and status.

20.3 Oracle Task Manager Integrations


Task Manager uses the following to provide functionality:
■ Oracle Trading Community Architecture (TCA) to locate the customer contact
information when creating a task in relation to a customer.
■ Resource Manager to locate resources (task owner and assignee) for a task.
■ Assignment Manager to assist in locating a qualified resource (task owner and
assignee) for a task. Assignment Manager can use the Territory Assisted
assignment option to locate the right resource assigned to a specific territory.
■ The Notes Module to create a note for a task.
■ Oracle Workflow to send a workflow notification to an owner, assignee, group,
or team, about a new or updated task.

Introduction to Oracle Task Manager 20-7


Notes and Calendar Integration

■ Escalation Manager to escalate a task. Escalation Manager also uses Oracle


Workflow to send workflow notifications to appropriate resources when
escalating a task, defect, or service request.

Task Manager is widely used by various Oracle modules across CRM.


■ Escalation Manager uses Task Manager to create tasks associated with an
escalation document.
■ Universal Work Queue (UWQ) uses the Task Manager to display tasks.
■ The HTML and Forms-based Calendars both use Task Manager to display tasks
and appointments on different calendar views, such as daily, weekly, and
monthly views.
■ Assignment Manager uses the Forms-based Task Manager to determine task
duration.
■ Service applications use Task Manager to create tasks associated with service
requests.
■ Sales applications use Task Manager to create tasks associated with
opportunities and leads.
■ Marketing uses Task Manager to create tasks associated with marketing
campaigns.
■ Contract applications use Task Manager to create tasks associated with
contracts.

20.4 Notes and Calendar Integration


Use Task Manager to effectively manage your daily tasks. You can click the
hyperlink for a task or appointment, and access the details for that specific object.
The key fuctionality of the HTML Calendar, which is integrated with the HTML
Task Manager, includes:
■ Viewing Your Calendar
■ Managing Your Appointments
The HTML Task Manager is also integrated with the HTML Notes module. Use the
Notes module to provide additional information for a task. The key fuctionality of
the Notes module includes:
■ Searching for a Note

20-8 Oracle CRM Application Foundation User Guide


Process Flow for Oracle Task Manager

■ Creating a Note
■ Attaching a Document to a Note
■ Viewing all Notes
■ Viewing Note Details

20.5 Process Flow for Oracle Task Manager


The following table describes the order and process of using the HTML Task
Manager.

Table 20–4 Task Manager Process


Steps Description
View Your Tasks View your tasks.
View Task Details (Optional) View the details of a previously created task.
Create Saved Searches for Task (Optional) Create a personalized saved searches that you can
use to search for specific tasks.
Create Tasks Create a task.
Relate Tasks to Business Objects (Optional) Relate a task to a business object, such as a
marketing campaign.
Assign Tasks Assign a task to a resource.
Define Task Efforts (Optional) Manage your task efforts.
Create Repeating Tasks (Optional) Create a repeating task.
Manage Task Contacts (Optional) Manage and import task contacts.
View, Create, and Add Attachments (Optional) View, create, and add an attachment to a task.
Work with Notes (Optional) Add more details to your task using the Notes
module.
Work with Calendar (Optional) Manage your daily activities, appointments, and
tasks using the HTML calendar.
Mass Creating Tasks (Optional) Create a separate task for each of the selected
resources in a group or team.

Introduction to Oracle Task Manager 20-9


What’s New in This Release

20.6 What’s New in This Release


This release of CRM Application Foundation has the following new features in Task
Manager subsequent to the 11.5.7.4 release:

Tasks Can Be Reassigned


This feature allows a user with an appropriate responsibility to mass reassign tasks
for a user to another user or group when the original resource was end dated
(became inactive) or because of other business reasons, such as the change of the
resource’s role. Tasks can be reassigned to the resource of any categories that are
defined in Resource Manager.
After you reassign a task, workflow notifications will be sent to the old assignee,
new assignee, and the task owner. If it is an owner reassignment, the notifications
will be sent to the old owner and new owner.

Task Manager Uses Descriptive Flexfields to Track Additional


Information
In order to track additional information, important and unique to the customer for
your task, several descriptive flexfields are now added in the HTML Task Manager.
These flexfields may appear in the task creation, task details, task search, and task
summary pages if the attribute values for these flexfields are defined and segments
are rendered properly.

Task Name Appears as a Part of the Window Title


After saving a newly created task in the Forms-based Task Manager, the task name
(such as Business Meeting) is displayed as a part of the title shown in the Tasks
window and Task Details window. Therefore, the window name becomes Tasks -
Business Meeting or Task Details - Business Meeting once you save the task.

A New Search Criterion Appears in the Task Search Window


A new search criterion, the Show Only Open Tasks check box, is now added in the
Forms-based Find Tasks window. This allows users to view only the tasks with a
status of "Open" if the check box is selected.

Task Manager Has One New Profile Option


There is one new profile options used in Task Manager:
■ Task Manager: Mass Task Reassign Access

20-10 Oracle CRM Application Foundation User Guide


Terms and Definitions

For more information on these profile options, see Oracle CRM Application
Foundation Implementation Guide, Appendix A: Profile Options.

20.7 Terms and Definitions


The following table describe terms associated with Task Manager.

Table 20–5 Terms and Definitions


Term Description
Assignee An assignee is the person assigned to a task. An assignee can
accept, refuse, or reassign the task.
Contact A contact contains information about a person and how to
locate them such as their phone number and email address,
in regards to the task.
Creator The creator is the originator of the task and defaults to the
owner.
Full Access Full Access is the ability to view, edit, and delete a task. This
access type does not include the capability of granting access
to others.
HTML Calendar Use the HTML Calendar to effectively manage your daily
activities, appointments, notes, and tasks.
Notes Notes provide additional text locations where you can
specify more detail, if needed. A note can be added to a task.
OSO This is an acronym for Oracle Sales Online.
OMO This is an acronym for Oracle Marketing Online.
Owner An owner is the person responsible for the task. They are not
necessary the person who performs the task.
Party A party is an entity that can enter into a business
relationship.
Read-only Read-only access is the ability to view a task without making
modifications to it. You may not edit or delete any
information.
Reference A reference occurs when one task relates to another
document. For example, a task can be related to a service
request.
Repeating Task A repeating task automatically reoccurs in a specified time
increment such as daily, weekly, monthly, or yearly.

Introduction to Oracle Task Manager 20-11


Terms and Definitions

Table 20–5 Terms and Definitions


Term Description
Resource A resource is the basic element of the Resource Manager and
is defined as people, places and things.
Source Object The source object defines the origin of the task, for example,
Sales, Service, or Task Manager.
Tasks A task is the lowest unit of work. Tasks are assignments that
detail the actions required of resources or other objects.
Task Type A task type defines the nature of the task such as a callback
or a meeting, which helps organize your tasks.

20-12 Oracle CRM Application Foundation User Guide


21
Overview of Using the HTML Task Manager

This chapter covers the following topics:


■ Accessing the Oracle Task Manager Interface
■ Summary of Oracle Task Manager Tasks

21.1 Accessing the Oracle Task Manager Interface


There are several ways to access Task Manager. It can be run as a stand-alone
module where you access tasks directly to create personal tasks or it can be called
from other modules to provide integrated solutions. You can also access Task
Manager through the HTML Calendar module from a link on the main navigation
bar. The following CRM modules use the Task Manager to create and manage tasks:
■ Oracle Marketing Online (HTML)
■ Oracle Sales Online (HTML)
■ Oracle Service (Forms and HTML)
Each CRM module has an individual login. Perform the following steps to log in to
Task Manager.

Prerequisites
You must be an employee resource to use calendar.

Responsibility
End user

Overview of Using the HTML Task Manager 21-1


Summary of Oracle Task Manager Tasks

Navigation
Navigate to a CRM module integrated with Task Manager.
Steps
1. Enter your user ID.
2. Enter your password and click Go.
3. Click Tasks.
The Task Summary window opens with a list of your current tasks.

21.2 Summary of Oracle Task Manager Tasks


Use Oracle Task Manager to perform the following types of tasks:
■ Chapter 22, Viewing Task Information
■ Chapter 23, Managing Tasks
■ Chapter 24, Managing Task Preferences
■ Chapter 25, Managing Task Contacts
■ Chapter 26, Working with Forms-based Tasks
■ Chapter 27, Scheduling and Tracking Forms-based Tasks

21-2 Oracle CRM Application Foundation User Guide


22
Viewing Task Information

This chapter covers the following topics:


■ Viewing the Task Summary
■ Using the Quick Find Search
■ Customizing Your Task Summary Display Options
■ Selecting Sort Options
■ Personalizing Your Saved Searches
■ Viewing Task Details

22.1 Viewing the Task Summary


Use the Task Summary to:
■ View a list of your tasks
■ Update tasks
■ Create a new task
■ Create a quick task
■ Remove a task
■ Select to display another saved search
■ Display task details
The information in the Task Summary is the result of your default search query. If
the task is assigned to a group or team, you must search for that task separately.
Perform the following steps to view the Task Summary window.

Viewing Task Information 22-1


Viewing the Task Summary

Note:
■ Use the First, Previous, Next, and Last links to view all of your
existing tasks.
■ It is mandatory to display either the task name or the task
number fields. If you remove both of these columns, the task
name appears automatically.
■ You must be the owner or assignee of a task to have full access
to it. If you are not the owner or assignee, the task will appear
in read-only format.

Prerequisites
You must be the owner, assignee, or have been granted access to a task in order to
view it.

Responsibility
CRM Application Foundation User

Navigation
Navigate to the Task Summary window by clicking Tasks on the main navigation
bar.

Steps
1. In the Task Summary window, to view a previously saved search, select it from
the Saved Searches drop-down list and click Search.
2. Click Create Task to create a task or click Create Quick Task to create a simple
task.
3. Click the CSV icon to save your list of tasks in Microsoft Excel.
4. Click on any table heading, except for flexfields, to sort the corresponding
column.
5. Click any hyperlink or click the Task Details icon to view the details of the
record.
If you are not the owner or the assignee of the task, the task details window
appears in read-only format.

22-2 Oracle CRM Application Foundation User Guide


Using the Quick Find Search

See Also
Customizing your Task Summary Display Options

22.2 Using the Quick Find Search


Use the Quick Find search to find your appointments, tasks, notes, employees, and
groups. Perform the following steps to execute a search.

Note: You must run the Rebuilding Intermedia Index for Task
Names concurrent program periodically to see new and updated
tasks, and to be able to search by task name in the quick find. Please
see the Oracle CRM Application Foundation Implementation Guide,
Appendix C, for more information on concurrent programs.

Prerequisites
None

Responsibility
CRM Application Foundation User

Navigation
Navigate to any Task Manager window.

Steps
1. Using the Quick Find drop-down list, select search criteria:
■ Appointments
■ Task
■ Notes
■ Employees
■ Groups
2. Enter a keyword or letter (at least three characters) for the search and click Go.
The Search Results window opens.
3. Click any item to display the details.

Viewing Task Information 22-3


Customizing Your Task Summary Display Options

22.3 Customizing Your Task Summary Display Options


Use the Task Search window to define display options for the Task Summary
window. Perform the following steps to view the details of a specific task.

Prerequisites
A task must already exist.

Responsibility
CRM Application Foundation User

Navigation
Navigate to the Task Search window by clicking Personalize in the Task Summary.

Steps
1. Use the drop-down list to select the Saved Search you want to modify.
2. Scroll down to the Display Options region.
3. From the Available column, select which columns you want to appear in the
Task Summary window. To select multiple columns, hold down the [Ctrl] key
and select each column with your mouse.
4. When you are finished selecting the columns you want, click > to move them to
the displayed column or click >> to move all the undisplayed columns over to
the displayed column.

Guidelines
The following table describes columns available in the Display Options region of
the Task Search window.

Table 22–1 Task Search Display Options Region Description


Column Name Description
Actual End Date This is the actual end date of the task.
Actual Start Date This is the actual start date of the task.
Category This is the task category.
Created By This is the username of the person who created the
task.

22-4 Oracle CRM Application Foundation User Guide


Customizing Your Task Summary Display Options

Table 22–1 Task Search Display Options Region Description


Column Name Description
Creation Date This is the date the task was created.
Description This is the description of the task.
Flexfield 1 (Market) This column can be customized for your specific
business needs.
Flexfield 2 (Segment) This column can be customized for your specific
business needs.
Flexfield 3 This column can be customized for your specific
business needs.
Last Updated By This is the username of the person who last
updated the task.
Last Updated Date This is the date the task was last updated.
Owner This is the name of the owner of the task.
Parent Task This is the name of the parent task.
Planned End Date This is the planned end date of the task.
Planned Start Date This is the planned start date of the task.
Priority This is the task priority.
Private This indicates whether or not the task is private.
Recurring This indicates whether or not the task is recurring.
Scheduled End Date This is the scheduled end date of the task.
Scheduled Start Date This is the scheduled start date of the task.
Source This is the source of the task.
Source Name This is the source name.
Status This is the status of the task.
Task Name This is the task name. This field is mandatory if the
task number column is not shown.
Task Number This is the task number. This field is mandatory if
task name is not shown.
Time Zone This is the time zone where the task occurs.
Type This is the task type.

Viewing Task Information 22-5


Selecting Sort Options

22.4 Selecting Sort Options


Use the Task Search window to define how you want the rows of tasks to sort in the
Task Summary window. Perform the following steps to view the details of a specific
task.

Prerequisites
A task must already exist.

Responsibility
CRM Application Foundation User

Navigation
Navigate to the Task Search window by clicking Personalize in the Task Summary.

Steps
1. Use the drop-down list in the Sort Order region to select how you want your
rows of tasks to sort. Sort options include:
■ Number
■ Source
■ Status
■ Task Type
■ Category
■ Parent Task
■ Name
■ Description
■ Priority
■ Owner
2. Use the corresponding drop-down list to select whether or not you want the list
to sort in descending or ascending order.
3. Use the drop-down list to select the next type of sort (Then by).
4. Use the corresponding drop-down list to select whether or not you want the list
to sort in descending or ascending order.

22-6 Oracle CRM Application Foundation User Guide


Personalizing Your Saved Searches

5. Use the drop-down list to select the next type of sort (Then by).
6. Use the corresponding drop-down list to select whether or not you want the list
to sort in descending or ascending order.
7. Enter the number of rows that you want to display in the Task Summary
window.
8. Click Save.

See Also
■ Viewing the Task Summary
■ Personalizing Your Saved Searches

22.5 Personalizing Your Saved Searches


Use the Task Search window to create a personalized saved search. You can
personalize your search results in four ways:
■ Create search criteria and save it as a personalized search.
■ Select only the columns you want to display in the Task Summary window.
■ Sort records in ascending or descending order.
■ Specify how many rows of task records you want to display in the Task
Summary window.

Note: Before entering information for a new saved search, you


must click Clear in the Task Search window. Otherwise, the
information that appears in each field reflects the default Saved
Search that appears in the drop-down list.

Prerequisites
None

Responsibility
CRM Application Foundation User

Navigation
Navigate to the Task Search window by clicking Personalize in the Task Summary.

Viewing Task Information 22-7


Personalizing Your Saved Searches

Steps
1. Enter the following information:
a. Enter the Task Name.
b. Enter the Task Number.
c. From the Status multi-select list box, select the task status.
d. From the Types multi-select list box, select the task type.
e. From the Priority multi-select list box, select the task priority.
f. From the Category multi-select list box, select the task category.
g. Select the Include Private check box to include your private tasks in your
search.
h. Use the drop-down list to select the source.
i. Enter the name that corresponds to the source or click Go to access the
lookup window and search for the name.
2. Under the Created By region, use the drop-down list to select the resource type
that created the task.
3. Enter the (Resource) name or click Go to search for the resource name.
4. In the Assignments region, define the following information:
a. Select the My Tasks option button to search for tasks you own or that are
assigned to you.
b. Select the Task with Role option button to search for tasks assigned to
another owner or assignee.
c. Use the drop-down list to select the role. Options include: All, Assignee, or
Owner.
d. Use the drop-down list to select the resource type.
e. Enter the resource name or click Go to access the lookup tool and search for
the name.
f. If you want to enter additional search criteria, repeat steps b - e in the
provided fields.
5. In the Dates and Times region, define the following information:
a. Use the drop-down list to select the task date type. Options include
Planned, Scheduled, or Actual.

22-8 Oracle CRM Application Foundation User Guide


Personalizing Your Saved Searches

b. Click the Date Picker icon next to the From text field to select the date
range for the task.
c. Use the drop-down lists to select both the hour and minute the task began.
d. Click the Date Picker icon next to the To text field to select the date the task
ended.
e. Use the drop-down lists to select both the hour and minute the task ended.
6. In the Customer Details region, define the following information:
a. Use the drop-down list to select the customer type. Options includes:
Customer Name, Customer Number, or Account Number.
b. Enter the Customer Value or click Go to access the lookup tool to search for
the value.
7. Enter the following reference information:
a. Use the drop-down list to select the resource type.
b. Enter the resource name or click Go to access the lookup tool and search for
the resource name.
The description is automatically populated, if available.
8. In the Task Additional Information region, enter the flexfield information in the
Market (flexfield 1) and Segment (flexfield 2) fields.
9. See the following for additional information on the remaining tables of the Task
Search window:
a. To define display options, see Customizing Your Task Summary Display
Options.
b. To select sort options, See Selecting Sort Options.
10. Select any of the following check boxes to add additional information to your
saved search.
■ Select the Use as Summary Page Default check box to have the search
execute upon opening the Task Summary window.
■ Select the Use as Default Query for Combo View check box to have the
search execute upon opening the Combination window in Calendar.
11. Click Save to save the personalized search or click Save and Search to save the
search and search immediately for any tasks matching the criteria you specified.
The Task Summary window opens displaying your search results.

Viewing Task Information 22-9


Viewing Task Details

See Also
■ Viewing the Task Summary
■ Creating a Task

22.6 Viewing Task Details


Use the Task Details window to update or delete a task. Perform the following steps
to view the details of a specific task.

Note:
■ Click the source number link to view the source or the name
link to view the details of that record.
■ If a product integrated with Task Manager passes customer
data into the system, the information automatically populates
the customer area of the Task Details window based on the
source.

Prerequisites
A task must already exist.

Responsibility
CRM Application Foundation User

Navigation
Navigate to the Task Details window.

Steps
1. Click Task on the main navigation bar.
The Task Summary window opens.
2. Click the task name to view more information about the task.

See Also
■ Viewing the Task Summary
■ Creating a Task

22-10 Oracle CRM Application Foundation User Guide


23
Managing Tasks

This chapter covers the following topics:


■ Creating a Task
■ Defining Dates for a Task
■ Associating a Task with a Customer
■ Relating Appointments and Tasks to Source Objects
■ Assigning a Resource to a Task
■ Specifying the Task Effort
■ Creating a Repeating Task or Appointment
■ Mass Creating Tasks
■ Viewing Existing Attachments
■ Adding an Attachment
■ Viewing Your Task Bin
■ Editing Your Task Bin
■ Reassigning Tasks

23.1 Creating a Task


Use the Create Task window to define dates, assign resources, and relate customer
information to the task. If you select the Quick Create button, the window that
appears is a light version of the Create Task window. Perform the following steps to
create a task.

Managing Tasks 23-1


Creating a Task

Note:
■ If you plan on creating more than one task, click Create and
Create Another once you’ve added all the information to the
first task. This saves your task and returns you to the Create
Task window so you can create another task.
■ You must define task statuses in Forms.
■ If you select the Display On Calendar check box in the Assign
To region, then you must enter a start and end date in the Dates
region.

Prerequisites
None

Responsibility
CRM Application Foundation User

Navigation
Navigate to the Create Task window by clicking Create in the Task Summary.

Steps
1. Define the following information.
a. Select a task type from the drop-down list.
b. Enter a name for the task.
c. Enter a description for the task.
d. Select the priority level for the task from the drop-down list.
e. Select the task status from the drop-down list.
The resource’s job title, phone number, and email address are automatically
populated if the information is available.
f. Select the task category from the drop-down list.
g. Select the Private check box if this is a personal task and you do not want
other resources to view it.

23-2 Oracle CRM Application Foundation User Guide


Defining Dates for the Task

Any resource associated with the task, for example an assignee, has access
to it, even if the task is marked as private.
2. Enter a parent task for the task or click Go to access the lookup tool.
a. Enter at least three characters and click Search.
A list of tasks appear in the window.
b. Select the option button of the task to populate the Parent Task field and
click Select.
The task populates the text field.
3. Select the Notify check box if you want to notify an assignee of a newly created
task.
4. See the following for additional information on the remaining tables of the
Create Task window:
a. To define a date, see Defining Dates for a Task.
a. To define assignees, see Assigning a Resource to a Task.
b. To enter customer information, See Associating a Task with a Customer.
c. To relate an object to a task, see Relating Appointments and Tasks to Source
Objects.
5. Click either Create, to create a single task or click Create and Create Another to
return to the Create Task window in order to create another task.

See Also
■ Viewing the Task Summary
■ Viewing Task Details
■ Adding and Removing Task Categories

23.2 Defining Dates for the Task


Perform the following steps to define dates in the Create Task window.

Managing Tasks 23-3


Defining Dates for the Task

Note:
■ When you are defining planned, scheduled, or actual dates, the
default value is set to scheduled. You can manually override
this by selecting another option button and defining your
information in the corresponding text field.
■ If the Display on Calendar checkbox In the Assignments
window is selected, then you must define a start and end date.

Prerequisites
None

Responsibility
CRM Application Foundation User

Navigation
Navigate to the Create Task window by clicking Create in the Task Summary.

Steps
1. Under the Dates region in the Create Task window, use the drop-down list to
select the time zone where the appointment is scheduled. This overrides the
time zone set in your preferences.
a. Enter at least two characters in the search field and click Search.
A list of time zones appear in the window.
b. Select the option button of the time zone you want to define and click
Select.
The name populates the text field.
2. Select the option button that defines the task date types (Planned, Scheduled, or
Actual).
3. Click the Date Picker in the column that corresponds to the task date type
selected in step 2.
The Select a Date pop-up window opens.
4. Use the drop-down list to change the calendar month.

23-4 Oracle CRM Application Foundation User Guide


Associating a Task with a Customer

5. Select a start date for the task by clicking on the date and close the window to
populate the field.
6. Use the drop-down list to select a start time for the task.
7. Repeat steps 2-6 to define the end date for the task.
8. Use the drop-down list to select an end time for the task.

See Also
■ Personalizing Your Saved Searches
■ Creating a Task

23.3 Associating a Task with a Customer


Perform the following steps to associate a task with a customer in the Create Task
window.

Prerequisites
None

Responsibility
CRM Application Foundation User

Navigation
Navigate to the Create Task window by clicking Create in the Task Summary.

Steps
1. Under the Customer region in the Create Task window, select a customer type
from the drop-down list. Options include Organization, Person, or Relationship.
2. Enter the customer’s account number or click Go to search for the account
number.
a. Enter at least three characters and click Search.
A list of account numbers appear in the window.
b. Select the option button of the account number to populate the Name field.
3. Enter the name of the customer or click Go to access the customer lookup tool.
a. Enter at least three characters and click Search.

Managing Tasks 23-5


Relating Appointments and Tasks to Source Objects

A list of customers appear in the window.


b. Select the option button of the customer name to populate the Name field.
4. Enter the customer’s address or click Go to get a list of addresses for the
customer.
5. Select the address to populate the text field. This also populates the Address 2
text field with the city, state, and country and the customer number field.
6. Enter the customer’s account number or click Go to get a list of account
numbers for the customer, if available.
7. Select the account number to populate the text field.
8. Enter the customer’s phone number or click Go to get a list of phone numbers
for the customer, if available.
9. Select the phone number (if any) to populate the text field.

See Also
■ Personalizing Your Saved Searches
■ Creating a Task

23.4 Relating Appointments and Tasks to Source Objects


See the HTML Calendar documentation for information regarding relating tasks to
Source Objects.

See Also
■ Personalizing Your Saved Searches
■ Creating a Task

23.5 Assigning a Resource to a Task


Use the Assignments window to assign a task to a resource. When you specify an
assignment, the information appears in the Assign To region of the Task Summary
window. A task can only have one owner but can have more than one assignee.
Perform the following steps to assign a resource to a task.

23-6 Oracle CRM Application Foundation User Guide


Assigning a Resource to a Task

Note:
■ You can change the owner of a task but you cannot delete the
owner altogether.
■ Click the source number link to view the source or the name
link to view the details of the record.

Prerequisites
A task must already exist.

Responsibility
CRM Application Foundation User

Navigation
Navigate to the Assignments window from the Task Details window.

Steps
1. Select the Display on Calendar check box to display the task on your personal
calendar.
2. Use the drop-down list to select the Resource Type.
3. Enter the name of the resource that you want to assign to the task or click Go to
search for a resource.
The search window opens.
a. Enter at least two characters in the search field and click Search.
A list of resources appear in the window.
b. Select the option button of the resource name you want to add and click
Select.
The resource name populates the text field.
4. Use the drop-down list to select the status. You must set up status types in the
Forms-based Task Manager.
5. Enter the following resource information in the text fields provides:
■ Job title

Managing Tasks 23-7


Specifying the Task Effort

■ Email address
Phone number information automatically populates, if available.
6. Click Update.
The assignment information is saved.

Note: If the row contains a Remove check box, you can select the
check box and update the window to delete the record. If the row
contains a Remove icon, click it to clear the row.

Guidelines
In order to delete a selected resource, use the Remove check box. If you manually
delete a resource name in the Name field without changing the resource type, the
selected resource, regardless an owner or assignee, is still valid. This is because the
resource id is stored as a hidden parameter if you leave the resource type
unchanged. Make sure to change the resource type drop-down list if you trying to
delete a resource name in the Assignments window.

See Also
■ Personalizing Your Saved Searches
■ Creating a Task

23.6 Specifying the Task Effort


Use the Efforts window to specify either the planned, duration, or actual effort.
Each effort is defined as follows:
■ Planned: This is the effort required to complete a task. For example, a task
requires 10 hours work and is assigned to Mary and John. Each needs to
contribute five hours to complete the assignment. The planned effort to
complete this task is 10 hours.
■ Duration: This is the actual time it takes for the completion of the task. For
example, if Mary starts her work from 10:00 to 14:00, and John continues from
14:00 to 19:00, then the duration of this task is nine hours (10:00-19:00.) If John
starts at 10:00, instead of 14:00, and finishes at 15:00, then the duration is five
hours (10:00-15:00.)

23-8 Oracle CRM Application Foundation User Guide


Specifying the Task Effort

■ Actual: This is the actual effort for a task. For example, the actual effort for
Mary to complete her work is four hours (10:00-14:00) and for John is five hours
(10:00-15:00.)
Perform the following steps the define the Task Effort.

Note: Click the source number link to view the source or the name
link to view the details of the record.

Prerequisites
A task must already exist.

Responsibility
CRM Application Foundation User

Navigation
Navigate to the Efforts window, from the Task Details window.

Steps
1. Enter the duration unit required to complete the task in the Duration text field.
2. Select the unit of measure (UOM) for the duration. Options include: hours and
minutes.
3. Enter the percentage complete for the task.
4. Enter the planned effort unit.
5. Use the drop-down list to select the UOM for the planned effort.
6. Enter the actual effort.
7. Use the drop-down list to select the UOM for the actual effort.
8. Click Update to save the effort.

See Also
Creating a Task

Managing Tasks 23-9


Creating a Repeating Task or Appointment

23.7 Creating a Repeating Task or Appointment


Use the Repeating window to create a series of tasks for a regularly scheduled task
or appointment. The start date must be specified before you can create a repeating
task or appointment. Perform the following steps to create a repeating task or
appointment.

Note:
■ Click the source number link to view the source or the name
link to view the details of the record.
■ After a repeating task is created, any additional modification
impacts only the next occurrence of the task.

Prerequisites
A task must already exist.

Responsibility
CRM Application Foundation User

Navigation
Navigate to the Repeating window from the Task Details or Appointment Details
window.

Steps
1. In the Repeating window, the Start Date field is populated with the date the
task or appointment was originally created. You cannot edit this date.
2. Click the Date Picker to access the select a date window and select an End Date
for the repeating task or enter a number in the count text field to define the
number of times you want the task to repeat. You must use the date picker to
select a date. Manually entering dates causes an error to occur.
3. Select the option button for the frequency of the repeating task or appointment.
Options include none, daily, weekly, monthly, and yearly.
a. Select None and the task does not repeat.
b. Select Daily and enter the number of days you want the task to repeat.

23-10 Oracle CRM Application Foundation User Guide


Mass Creating Tasks

c. Select Weekly and enter the number of weeks and select the check box for
each day you want it to occur.
d. Select Monthly and enter the number of months and select the check box for
each day you want it to occur.
e. Select Yearly and enter the number of years and the day or the particular
day of the month you want the task to occur.
4. Click Update to save your repeating task or appointment or click Restore to
reset the original values in the window.
A confirmation window opens confirming the repeating task was created.

See Also
Creating a Task

23.8 Mass Creating Tasks


Use the Mass Create window to create a separate task for each selected resources.
When you use the Mass Create feature, a new task is created for each resource
whether or not it is a group or a team and that resource is automatically assigned as
the owner of the task. Perform the following steps to mass create tasks.

Note: Click the source number link to view the source or the name
link to view the details of the record.

Prerequisites
A task must already exist.

Responsibility
CRM Application Foundation User

Navigation
Navigate to the Mass Create window from the Task Details window.

Steps
1. In the Mass Create window, select the resource type (group or team) from the
drop-down list.

Managing Tasks 23-11


Viewing Existing Attachments

2. Enter the name of the resource or click Go to search for the resource.
a. Enter at least two characters in the search field and click Search.
A list of resources appear in the window.
b. Select the option button of the resource you want to add and click Select.
The information populates the text field.
3. Select the Keep Record check box to copy the task to a group or team member
even if one already exist for the owner.
4. Select the Copy Notes check box to create a copy of any note attached to the
task.
5. Click Create.
A task for each member of the group or team is assigned and each individual
becomes the owner of their task.

See Also
Creating Tasks

23.9 Viewing Existing Attachments


See the HTML Calendar documentation for information regarding Viewing Existing
Attachments.

23.10 Adding an Attachment


See the HTML Calendar documentation for information regarding Adding an
Attachment.

23.11 Viewing Your Task Bin


If you are using Task Manager integrated with another Oracle CRM module, use the
task bin as a quick look at your daily tasks, including the task name and end date. If
no end date is specified during task creation, "No Date" appears in the date field.
The task bin only shows tasks that the logged in user is the owner or assignee and
does not display appointments. Perform the following steps to view your task bin.

23-12 Oracle CRM Application Foundation User Guide


Editing Your Task Bin

Note:
■ When you switch to another calendar that you are subscribed
to, your calendar and task bins still reflect your personal
appointments and tasks.
■ For information regarding the Personalize link, please see the
Oracle CRM Technology Foundation Concepts and Procedures.

Prerequisites
None

Responsibility
Responsibilities to access Oracle Applications that are integrated with HTML Tasks

Navigation
Navigate to your Homepage.

Steps
1. Click Home on the main navigation bar.
Your Personal Homepage appears containing your task bin. This bin contains a
list of your current tasks.
2. Click on any task name to view the details of the record.
The Task Details window opens.

23.12 Editing Your Task Bin


In the task bin, tasks are sorted in the order of the calendar end date and priority.
The task bin can be customized to select tasks based on different task statuses and
priorities, as well as the update status. Perform the following steps to modify which
tasks you want to appear in your task bin.

Note: For information regarding the Personalize link, please see


the Oracle CRM Technology Foundation Concepts and Procedures.

Managing Tasks 23-13


Editing Your Task Bin

Prerequisites
None

Responsibility
Responsibilities to access Oracle Applications that are integrated with HTML Tasks

Navigation
Navigate to the Parameters window by clicking Edit in your Task bin.

Steps
1. In the Parameters window, use the Show Task Ending drop-down list to select
which tasks you want to appear in the task bin. Options include tasks ending:
■ Today
■ Through tomorrow
■ 2 days from now
■ 3 days from now
■ 4 days from now
■ 5 days from now
■ 6 days from now
■ 7 days from now
2. In the Priority multi-select box, select which task priorities you want to appear
in the task bin. You can select as many priorities as you want by holding down
the [Ctrl] key and selecting each priority with your mouse.
3. In the Status multi-select box, select which task statuses you want to appear in
the task bin. You can select as many statuses as you want by holding down the
[Ctrl] key and selecting each priority with your mouse.
4. Select whether or not you want to show updated tasks in your task bin.
5. Click Update once you’ve selected all your parameters.
Your Homepage appears showing additional tasks which correspond to the task
attributes you selected in the Parameters window.

23-14 Oracle CRM Application Foundation User Guide


Reassigning Tasks

23.13 Reassigning Tasks


Tasks can be mass reassigned to new owners or assignees by using the Task
Reassignment window. These new resources can be of any types that are defined in
Resource Manager. For example, you can reassign a task from an employee resource
to a supplier contact, party, partner, other, to be hired, resource group or team when
the original resource was end dated (became inactive) or due to other business
reasons. For example, due to the change of a person’s role, as a result, the person is
not suitable for the assigned task.
Please note that the Reassign button used to launch the Task Reassignment window
is located in the Resource Details window, instead of in the Tasks screen. This is
because the nature of task reassignment is to change resources for assigned tasks.
Therefore, to reassign a task, users need to have the Resource Self Service
Administrator responsibility to be able to access the HTML Resource Manager
administrator page. In addition, the profile option Task Manager: Mass Task Reassign
Access also needs to be set to Yes so that the Reassign button is shown in the resource
window.
Alternatively, users with the CRM Application Foundation User responsibility can
also access the reassign screen, but need to set the value of the profile option JTFRS:
Employee Resource Update Access to Any at the user level. This way, users can
reassign tasks even if the profile option Task Manager: Mass Task Reassign Access is
set to No.
After you log in to Resource Manager with the appropriate responsibility, the first
thing is to locate the resource that you want to change in the resource screen. This
means the original resource must only be an employee resource or a group resource
in this release. After locating the resource, then you can launch the Task
Reassignment window by clicking Reassign.
During task reassignment process, make sure to identify both of the following items
before you commit the change. Otherwise, a warning message appears on the top of
the page.
■ The tasks that you want the resource to be reassigned from the task list
■ Resource type (such as employee resource) and a new resource name for the
selected tasks
After you reassign tasks, a confirmation message should be displayed if the selected
tasks were reassigned successfully. In addition, workflow notifications should be
sent to the old assignee, new assignee, and the task owner if the reassignment is for
the task’s assignee. If it is an owner reassignment, the notifications should be sent to
the old owner and new owner.

Managing Tasks 23-15


Reassigning Tasks

It is important to note that task reassignment will not change the task status. In
other words, the status will still be the same as it was before reassignment.

Note: Only open tasks can be reassigned. Tasks shown on the Task
Reassignment window should not have a status of closed,
cancelled, reject or completed.

Perform the following steps to reassign tasks to another resource.

Prerequisites
Locate the resource whose tasks need to be reassigned in the Resource Details
window.
The profile option Task Manager: Mass Task Reassign Access should be set to Yes.
The Mass Task Reassignment window is Declarative Page Flows (DPF) enabled and
needs to be registered in business flows. How to register the screen in business
flows, see Oracle CRM System Administrator Console Concepts and Procedures for
details.

Responsibility
Resource Self Service Administrator responsibility
CRM Application Foundation User responsibility with the profile option JTFRS:
Employee Resource Update Access set to Any at the user level

Navigation
Navigate to the People tab > Employee subtab or Group subtab to locate the
resource whose tasks need to be reassigned.

Steps
1. Click the resource name in the Employee or Group subtab.
This opens the Resource Details window.
2. Click Reassign to open the Task Reassignment window.
3. Use the drop-down list to select the type of resource that you want to reassign
the tasks.
4. Enter at least two characters and click Go to search for the corresponding
resource.

23-16 Oracle CRM Application Foundation User Guide


Reassigning Tasks

5. Select the option button of the resource and click select.


6. Select the check box of the tasks you want to reassign or click Select All to select
all tasks and click Apply.
7. A confirmation message appears if all selected tasks are reassigned successfully.

Managing Tasks 23-17


Reassigning Tasks

23-18 Oracle CRM Application Foundation User Guide


24
Managing Task Preferences

This chapter covers the following topics:


■ Defining Your Preferences
■ Setting User Preferences
■ Viewing Notifications in Your Worklist

24.1 Defining Your Preferences


Task Manager shares some preference options with the HTML Calendar. Use the
following links to view information regarding Task Preferences.
■ Changing Your Personal Preferences
■ Adding and Removing Task Categories

24.2 Setting User Preferences


You can receive either email notifications or workflow notifications, but not both. If
you want to receive notifications in your worklist, you must set your Personal
Home Page Preferences.
Perform the following steps to set up user preferences to receive workflow
notifications.

Prerequisites
A task must already exist.

Responsibility
Preferences (Oracle Self-Service Web Applications)

Managing Task Preferences 24-1


Viewing Notifications in Your Worklist

Navigation
Navigate to your personal homepage.

Steps
1. Enter your User Name and password.
2. Click Preferences.
3. Click General Preferences.
4. Select Do Not Send Me Mail in the Send me Electronic Mail drop-down list and
click Apply.

24.3 Viewing Notifications in Your Worklist


When a task is created, you can be notified by a workflow notification if it is set up
properly. Detailed information about Oracle workflow, see Oracle Workflow Guide.

Prerequisites
A task must already exist.

Responsibility
Workflow User Web Applications

Navigation
Navigate to your personal homepage.

Steps
1. Select Worklist hyperlink from the Workflow User Web Applications column.
2. The Worklist window opens with workflow notifications displayed.
3. Click on the notification in the Subject column that you want to view.
4. View your selected notification in the Notification Details window.
5. Respond to the notification by selecting an appropriate button in the bottom of
the page.

24-2 Oracle CRM Application Foundation User Guide


25
Managing Task Contacts

This chapter covers the following topics:


■ Viewing Task Contact Information
■ Defining Task Contacts

25.1 Viewing Task Contact Information


Use the Task Contacts window to update, delete, and organize your task contacts.
Perform the following steps to view task contact information.

Note:
■ Click the source number link to view the source or the name
link to view the details of the record.
■ If the row contains a Remove check box, you can select the
check box and update the window to delete the record. If the
row contains a Remove icon, you can click it to clear the row.

Prerequisites
A contact must exist.

Responsibility
CRM Application Foundation User

Navigation
Navigate to the Contacts window from the Task Details window.

Managing Task Contacts 25-1


Defining Task Contacts

Steps
1. From the Task Details window, click Contacts in the side navigation bar.
2. The Task Contacts window opens displaying your contacts.

See Also
Defining Task Contacts

25.2 Defining Task Contacts


Perform the following steps to define a contact.

Prerequisites
There must be contacts to import.

Responsibility
CRM Application Foundation User

Navigation
Navigate to the Contacts window from the Task Details window.

Steps
1. Use the drop-down list to select the resource type. Options include Customer
and Employee.
2. Enter the resource name or click Go to search for the Resource.
a. Enter at least two character in the search field and click Search.
A list of resources appear in the window.
b. Select the option button of the resource and click Select to populate the text
field.
3. Click the phone icon and select the phone number of the selected resource to
populate the text field.
The email address automatically populates if the information is available.
4. Select the option button if the resource is the primary contact.
5. Click Update to save the information.
6. Click the Remove icon to clear the Resource from the list.

25-2 Oracle CRM Application Foundation User Guide


Defining Task Contacts

See Also
Viewing Task Contact Information

Managing Task Contacts 25-3


Defining Task Contacts

25-4 Oracle CRM Application Foundation User Guide


26
Working with Forms-based Tasks

This chapter covers the following topics:


■ Creating, Updating, and Finding Tasks
■ Setting Dependencies for Tasks
■ Linking Tasks to Source Documentation
■ Setting Task Flags
■ Documenting Multiple Contact Information
■ Launching the Task Workflow

26.1 Creating, Updating, and Finding Tasks


Use the Task window to create and update a task, or use the Find Task window to
search for a task. Perform the following steps to create, update, or find a task.

Note: If you want to change or limit the values shown in task


types, priorities, status's or references List of Values please see the
following information sections in the Oracle CRM Application
Foundation Implementation Guide.
■ Defining Task and Notes Reference Mapping
■ Defining a Status Transition and Assigning Rules
■ Defining Task Status
■ Defining Task Priority
■ Defining Task Types

Working with Forms-based Tasks 26-1


Creating, Updating, and Finding Tasks

Prerequisites
None

Responsibility
CRM Administrator

Navigation
Navigate to Task and Escalation Manager > Tasks > Tasks

Steps
1. To find a task using the Find Task window, enter any of the following search
criteria and click Find:
■ Number
■ Name
■ Description
■ Type
■ Status
■ Priority
■ Source Document
■ Source Value
■ Parent Task
2. You can provide additional information to search for a task in the following
regions:
■ Owner
■ Assignee
■ Customer
■ Dates
3. Select the Show Only Open Tasks check box if you only want to view tasks
with a status of "Open". If you do not select this check box, all task statuses will
appear in your search results unless otherwise specified in the Status field.
4. To create a Task, click New in the Find Tasks window.

26-2 Oracle CRM Application Foundation User Guide


Creating, Updating, and Finding Tasks

The Tasks window opens.


5. Use one of the following procedures to create a task:
a. Click Create Task from Template to create tasks from a template.
The Create Tasks from Template Group window opens. Select the template
information from the list of values (LOV) for the required fields, and click
Create Tasks.
b. Create tasks individually by entering the following basic task information.
Use the LOV to enter your information if applicable.
– Name: Enter task subject, title, or summary information for your task.
– Type: Use this field to classify the purposes of your task creation, such
as a Follow-up task, or an Appointment task.
– Status: Use this field to specify the progress of your task, such as Open,
Working, or Completed.
– Priority: Use this field to determine the urgency of your task, such as
High, Medium, or Low.

Note: The values of the task type, status, and priority fields can be
defaulted from the relevant profile options.

6. Save your task and click More.


The Task Details window opens.
7. Define Requirements by selecting from the LOV for each field. See Assigning
and Scheduling Resources for more information.
8. Enter the task dependencies by selecting from the LOV for each field. See
Setting Dependencies for Tasks for more information.
9. Enter the reference objects by selecting from the LOV for each field. See Linking
Tasks to Source Documentation for more information.
10. Enter the recurrence rules by selecting from the option buttons and the LOV for
each field. See Scheduling Recurring Tasks for more information.
11. Save your task.
The new task number appears in the task spreadtable.
12. If you want to update a task, then perform the following steps:

Working with Forms-based Tasks 26-3


Setting Dependencies for Tasks

a. Navigate to Task Manager.


b. In the Find Tasks window, enter search criteria and click Find.
The Tasks window opens.
c. Update the information in the window.
d. Save your changes.

Guidelines
Clicking Launch Workflow in the Tasks window automatically reserves the
specified resource and notifies the task owner of task creation.

See Also
Launching Task Workflow

26.2 Setting Dependencies for Tasks


Dependencies determine the order among tasks. Perform the following steps to set
task dependencies.

Note: The Application Object Library: Dependency Types for Task


Lookups window is currently not used in Task Manager.

Prerequisites
A task must already exist.

Responsibility
CRM Administrator

Navigation
Navigate to Task and Escalation Manager > Tasks > Tasks

Steps
1. Locate your task first, click More.
The Task Details window opens.

26-4 Oracle CRM Application Foundation User Guide


Linking Tasks to Source Documentation

2. In the Dependencies tab, select the dependent task number from the list of
values (LOV).
The corresponding task name populates the Task Name field.
3. Enter a numerical value in the Offset field.
The Offset value determines the time that separates the action of initial tasks
from subsequent tasks. Use this feature to organize tasks with time-sensitive
restrictions.
4. Select from the LOV in the UOM field and click OK.
5. Save your task.
A dependency now exists for the task.

See Also
■ Creating, Updating, and Finding Tasks
■ Assigning and Scheduling Resources
■ Linking Tasks to Source Documentation
■ Documenting Multiple Contact Information
■ Setting Task Flags
■ Tracking a Task Record

26.3 Linking Tasks to Source Documentation


You can link a task to a source document to reference pertinent background
information. Define source documentation as the original request document that
results in the creation of a task. Perform the following steps to link a task to a source
document.

Prerequisites
None

Responsibility
CRM Administrator

Navigation
Navigate to Task and Escalation Manager > Tasks > Tasks

Working with Forms-based Tasks 26-5


Setting Task Flags

Steps
1. Locate your task first, click More.
The Task Details window opens.
2. In the References tab, select from the list of values (LOV) in the Document Type
field.
3. Enter the identification number of the source document in the Number field.
The application name populates the Details field with a description of the
reference type.
4. Optionally, enter the resource type information and click OK.
The resource type and number populates the Source Doc Type and Source Doc
Number fields in the main task list.
5. Double-click the Source Value field to view the source document.
6. Save your task.
The source document is now associated with the corresponding task.

See Also
■ Creating, Updating, and Finding Tasks
■ Assigning and Scheduling Resources
■ Setting Dependencies for Tasks
■ Documenting Multiple Contact Information
■ Setting Task Flags
■ Tracking a Task Record

26.4 Setting Task Flags


Use the Others tab to set task flags to further customize a task. Perform the
following steps to set task flags.

Prerequisites
None

26-6 Oracle CRM Application Foundation User Guide


Documenting Multiple Contact Information

Responsibility
CRM Administrator

Navigation
Navigate to Task and Escalation Manager > Tasks > Tasks

Steps
1. Locate your task first, click More.
The Task Details window opens.
2. In the Others tab, select task flags.
3. Click OK and save your task.
The task owner receives the task flagged as a Milestone.

See Also
■ Creating, Updating, and Finding Tasks
■ Assigning and Scheduling Resources
■ Setting Dependencies for Tasks
■ Linking Tasks to Source Documentation
■ Documenting Multiple Contact Information
■ Tracking a Task Record

26.5 Documenting Multiple Contact Information


Use the Contacts tab to associate contact information to a task. Perform the
following steps to document multiple contact information.

Note: You must save the task to make contact information


available in the list of values (LOV).

Prerequisites
None

Working with Forms-based Tasks 26-7


Launching the Task Workflow

Responsibility
CRM Administrator

Navigation
Navigate to Task and Escalation Manager > Tasks > Tasks

Steps
1. Locate your task first, click More.
The Task Details window opens.
2. In the Contacts tab, enter information in the Contacts fields.
3. Enter the corresponding telephone information.
4. Select the Primary check box is the person is the primary contact for the task.
5. Save your task.

Guidelines
Entering multiple contacts and selecting one as the primary contact records the
correct communication channel for the selected task.

See Also
■ Creating, Updating, and Finding Tasks
■ Assigning and Scheduling Resources
■ Setting Dependencies for Tasks
■ Linking Tasks to Source Documentation
■ Documenting Multiple Contact Information
■ Tracking a Task Record

26.6 Launching the Task Workflow


Use the launch workflow button to notify an assignee of the creation of a task.
Perform the following steps to launch a workflow process.

Prerequisites
A task must exist.

26-8 Oracle CRM Application Foundation User Guide


Launching the Task Workflow

Responsibility
CRM Administrator

Navigation
Navigate to Task and Escalation Manager > Tasks > Tasks

Steps
1. Locate your task first, click More.
The Task Details window opens.
2. Select the Resources tab.
3. Select the assignment information from the list of values (LOV) and click OK.
4. In the Tasks window, click Launch Workflow.
5. Save your task.
Workflow triggers an email or worklist notification when a task is created or
updated.

See Also
Creating, Updating, and Finding Tasks

Working with Forms-based Tasks 26-9


Launching the Task Workflow

26-10 Oracle CRM Application Foundation User Guide


27
Scheduling and Tracking Forms-based
Tasks

This chapter covers the following topics:


■ Assigning and Scheduling Resources
■ Scheduling Recurring Tasks
■ Tracking Planned, Scheduled, and Actual Dates
■ Tracking a Task Record

27.1 Assigning and Scheduling Resources


Use the Resources tab to define a specific resource for a task. The task owner assigns
and schedules the required resources after selecting the best available options.
Perform the following steps to assign and schedule resources.

Note: You can copy information in the Task window by clicking


on the spreadtable and selecting the option of copying the cell, the
selected row, or all the rows. Once you copy the information, it can
be pasted into Microsoft Excel or Microsoft Word.

Prerequisites
None

Responsibility
End User

Scheduling and Tracking Forms-based Tasks 27-1


Assigning and Scheduling Resources

Navigation
Navigate to Task Manager.

Steps
1. With your task information displayed in the window, click More.
The Task Details window opens.
2. In the Requirements region of the Resources tab, select the resource type from
the list of values (LOV).
3. In the Assignments region, enter a numerical value in the Unit field.
The unit value determines the number of resources needed to complete the task.
4. Select the resource type and name from the LOV.
5. If you want to schedule a resource, select the Schedule check box.
Enter scheduled distance and duration values and select a unit of measure.
6. Select the Enabled check box to activate varied resources according to the task.
Use this option to select live resources when updating. For tracking purposes,
update the Actual schedule fields after task completion.
7. If you want to update actual schedule information and enter the actual values
in the required fields and click OK.
8. Save your task.

See Also
■ Creating, Updating, and Finding Tasks
■ Setting Dependencies for Tasks
■ Linking Tasks to Source Documentation
■ Documenting Multiple Contact Information
■ Scheduling Recurring Tasks
■ Setting Task Flags
■ Tracking a Task Record

27-2 Oracle CRM Application Foundation User Guide


Scheduling Recurring Tasks

27.2 Scheduling Recurring Tasks


You can schedule a task to automatically repeat on a daily, weekly, monthly, or
yearly basis. Perform the following steps to schedule recurring tasks.

Prerequisites
None

Responsibility
End User

Navigation
Navigate to Task Manager.

Steps
1. With your task information displayed in the window, click More.
The Task Details window opens.
2. In the Recurrences tab, select an occurrence. Options include daily, weekly,
monthly, and yearly.
3. Select from the list of values (LOV) in each required field and click OK.
4. Save your task.
The task now reoccurs automatically.

See Also
■ Creating, Updating, and Finding Tasks
■ Assigning and Scheduling Resources
■ Setting Dependencies for Tasks
■ Linking Tasks to Source Documentation
■ Setting Dependencies for Tasks
■ Linking Tasks to Source Documentation
■ Documenting Multiple Contact Information
■ Setting Task Flags
■ Tracking a Task Record

Scheduling and Tracking Forms-based Tasks 27-3


Tracking Planned, Scheduled, and Actual Dates

27.3 Tracking Planned, Scheduled, and Actual Dates


Track task progress by entering date information after three task milestones:
■ Task Creation
■ Resource Reservation
■ Task Completion
Use this procedure to track planned, scheduled, and actual task dates.

Prerequisites
None

Responsibility
End user

Navigation
Navigate to Task Manager.

Steps
1. In the Find Tasks window, find or create a task.
The Tasks window opens.
2. Enter information into the Planned fields in the Dates region.
The GMT field is populated with the correct Greenwich Mean Time Deviation
value.
3. After reserving resources for the task, enter information into the Scheduled
fields.
4. Upon task completion, enter final information into the Actual fields.
5. Save your task.

Guidelines
Updating the Actual Start and End Dates in the Resource tab populates the
corresponding Actual date fields in the Task window.

See Also
■ Creating, Updating, and Finding Tasks

27-4 Oracle CRM Application Foundation User Guide


Tracking a Task Record

■ Assigning and Scheduling Resources


■ Setting Dependencies for Tasks
■ Linking Tasks to Source Documentation
■ Setting Dependencies for Tasks
■ Linking Tasks to Source Documentation
■ Documenting Multiple Contact Information
■ Scheduling Recurring Tasks
■ Setting Task Flags
■ Tracking a Task Record

27.4 Tracking a Task Record


Use the Audit tab to view the history of a task. The task record provides a trail from
the original task status through the current status. Perform the following steps to
access the task audit record information.

Prerequisites
None

Responsibility
End user

Navigation
Navigate to Task Manager.

Steps
1. With your task information displayed in the window, click More.
The Task Details window opens.
2. In the Audit tab, view the task history.
Each row documents the status of the task. The last row contains the most
recent task record.
3. Scroll to the right to view both the old and new values.
4. Click OK when you are done viewing the audit record.

Scheduling and Tracking Forms-based Tasks 27-5


Tracking a Task Record

See Also
■ Tracking Planned, Scheduled, and Actual Dates
■ Creating, Updating, and Finding Tasks
■ Assigning and Scheduling Resources
■ Setting Dependencies for Tasks
■ Linking Tasks to Source Documentation
■ Setting Dependencies for Tasks
■ Linking Tasks to Source Documentation
■ Documenting Multiple Contact Information
■ Scheduling Recurring Tasks
■ Setting Task Flags

27-6 Oracle CRM Application Foundation User Guide


Part VI
HTML Calendar

This part of the Oracle CRM Application Foundation User Guide contains the
following chapters:
■ Introduction to the Oracle HTML Calendar
■ Overview of Using the Oracle HTML Calendar
■ Viewing Your Calendar
■ Managing Appointments
■ Customizing Your Calendar Preferences
■ Administering Group Calendars
28
Introduction to the Oracle HTML Calendar

This chapter covers the following topics:


■ Overview of Oracle HTML Calendar
■ Oracle Calendar Key Features
■ Integration with Notes and Tasks
■ Oracle Calendar Integrations
■ Process Flow for Oracle Calendar
■ What’s New in This Release
■ Terms and Definitions

28.1 Overview of Oracle HTML Calendar


The key functionality of the HTML Calendar includes viewing and updating your
tasks, subscribing yourself to a group calendar, viewing public calendars, creating
and managing appointments, and inviting individuals to those appointments.
The HTML Calendar is used by many CRM Applications such as Oracle Sales
Online (OSO), for generic calendar functionalities like appointments and tasks as
well as to show business entities like events and campaigns. The user can click the
hyperlink for the task, appointment, or event and access the details for that specific
object. The following topics provide additional information on Calendar:
■ Calendar Rules
■ Types of Calendars
■ Calendar Views
■ Who Uses Calendar?

Introduction to the Oracle HTML Calendar 28-1


Overview of Oracle HTML Calendar

The following table describes the main navigation bar links.

Table 28–1 Navigation Bar Link Descriptions


Link Description
Views Click this link to access the different views (daily, weekly,
monthly, yearly, or combination) of your personal calendar
and to check a resource’s availability.
Tasks Click this link to access the Task Summary window. Use this
window to view all your tasks and to access the Create Task
window.
Notes Click this link to access the Notes Summary window. Use this
window to create a note, search for a note, attach a document
to a note, view all notes, or view details of a particular note.

28.1.1 Calendar Rules


Calendar has several rules it follows for security purposes:
■ Every employee resource can use calendar.
■ The creator of a calendar is the owner.
■ The owner and assignee can view or edit task information.
■ The owner and assignee can view his or her own private tasks.
■ Only the owner of a calendar can grant access to that calendar.
■ You can only search and view tasks that you are the owner or assignee of are
granted access to.
■ If the task sits at the group level, all members of a group can view and edit it.

28.1.2 Types of Calendars


The following are the different types of calendars available for viewing in Calendar.
■ Personal Calendars
■ Public Calendars
■ Group Calendars

28-2 Oracle CRM Application Foundation User Guide


Overview of Oracle HTML Calendar

Personal Calendars
Every employee has a personal calendar that they use to create or view
appointments, invite resources to appointments, attach notes and tasks, and relate
appointments to business objects. There are several ways to view your calendar
including: daily, weekly, monthly, yearly, or in combination with your assigned
tasks. Other features of the personal calendar include checking a resource’s
availability, personalizing your calendar view, and updating and soft deleting
existing appointments.

Public Calendars
Use the public calendar view to display upcoming public events. Public calendars
can be accessed by all calendar users and are only available in the monthly view
format. You cannot update a public calendar unless you are the owner of that
calendar. You cannot create a private appointment on a public calendar.

Group Calendars
A group calendar is created specifically for tasks and appointments related to a
resource group. Unlike the public calendar, which can only be viewed on the
separate public calendar view, a group calendar is viewed within the user’s
personal calendar. A group calendar is not accessible unless you subscribe and
receive approval. You can request a new group calendar by submitting a request to
the Calendar System Administrator. Once the new group calendar is approved, you
become the Group Calendar Administrator responsible for subscription approvals
and rejections.

28.1.3 Calendar Views


When you log onto calendar, the daily view of your calendar appears in the
window. You can then view the entire day’s schedule of appointments in this
window. Un-timed appointments are:
■ Any task that is assigned to you that does not have a start time and end time.
■ Any appointment that is created without identifying its duration (not timed).
You can click on the hyperlink for the task (appointment) and be taken to the detail
for that specific object. The detail window for the object depends upon the source.
For example, if the source is task (object), then you are taken to the Task Details
window. If you click on an item in the un-timed area where the source is
appointment, then you are taken to the Appointment Detail window. The following
table describes all the ways you can view your personal calendar.

Introduction to the Oracle HTML Calendar 28-3


Overview of Oracle HTML Calendar

Calendar Views
View Description
Daily View Within the daily view, you can create a new appointment,
update or delete an existing appointment or choose to access a
different day on the calendar.
Weekly Within the weekly view you can create a new appointment,
update an existing appointment, or delete an existing
appointment. You can choose to access a different week to
view that week’s calendar of appointments.
Monthly Within the monthly view you can create a new appointment,
update an existing appointment, or delete an existing
appointment. You can also choose to access a different month
to view that month’s calendar of appointments.
Yearly The yearly view displays all of the months for the entire year.
Each month displays the days of the week starting with
Sunday and ending with Saturday. The current day is
highlighted within the yearly view.
Combination In the combination view, you can maintain daily activities
while avoiding scheduling conflicts by viewing the days
events along side a list of current tasks. The combination view
fields may vary depending on the columns you choose to
display in the Task Summary window.
Availability Within the availability view you can check the availability of
multiple resources at the same time. You can also create an
appointment by clicking on the time link, and invite all
resources who are visibly available. Resource availability is
based on appointments which appear on the resource’s
personal calendar.

28.1.4 Who Uses Calendar?


Roles are assigned to resource’s to determine privileges. For example, you may have
the ability to modify another resource’s calendar if you are granted full access by
the owner. The following table defines each Calendar role.

28-4 Oracle CRM Application Foundation User Guide


Oracle Calendar Key Features

Table 28–2 Calendar Roles


Role Description
Calendar System The Calendar System Administrator is responsible for creating
Administrator group or public calendars based on user requests. Creation of
calendars are accomplished by responding to a workflow
request. Once the calendar is approved, the creator becomes
the Administrator for that group calendar (Group Calendar
Administrator). Requests for group calendar’s are then
processed by that user.
Group Calendar The Group Calendar Administrator has all the same privileges
Administrator as a regular calendar user except that they are responsible for
approving and rejecting subscription requests for the group
calendars they own.
Attendee An attendee is a resource who has accepted an appointment
invitation.
Invitee An invitee is a resource who receives an invitation to an
appointment but has not responded.
Owner A calendar owner is defined as the resource who owns the
personal, group, or public calendar.
Subscriber A subscriber is an individual who requests access to a group
calendar. A subscriber of a group calendar can have read-only
or full access.
User A calendar user is an employee resource who uses calendar.

28.2 Oracle Calendar Key Features


The following are key features of Calendar:
■ Managing Appointments
■ Personalization and Preferences

28.2.1 Managing Appointments


You can create appointments for yourself or for other resources who grant you full
access privileges to their calendar. For example, Elizabeth Smith, a marketing
manager at Vision Corporation, decides to target small size companies through the
Vision web site. She wants to discuss campaign details with her team, so she uses
the HTML Calendar to create an appointment, and subsequently, invites her team to
the appointment. Her team members receive the invitation in their calendar.

Introduction to the Oracle HTML Calendar 28-5


Integration with Notes and Tasks

In addition to creating appointments for upcoming events, you can also create an
appointment for a business event that has already occurred in order to have a
tracking record. For example, you attended a meeting last week to follow-up on a
business event, even though this event was not originally scheduled in your
calendar. You create the appointment one week after the event to record the
meeting.

28.2.2 Personalization and Preferences


You can specify personal preferences for viewing your daily calendar. You can
change your password, grant access privileges so others can view your calendar,
request a group or public calendar, or switch to another calendar. You can also
personalize the appearance of your calendar. For example, you can define what
constitutes a week (Monday to Friday or, perhaps including weekends) as well as,
what hours to start and end the day within the daily and weekly views. When
Calendar is integrated with other Oracle products, Calendar preferences are
embedded within that applications profile or preferences.

28.3 Integration with Notes and Tasks


Note: If you have integrated both Calendar and Resource
Manager with another Oracle product, you see both the Calendar
tab and the People tab. These two modules share the CRM
Application Foundation User responsibility.

A note provides a record of descriptive information that is generated and referenced


by the user. Use Notes to add additional information to an appointment. The key
fuctionality of the Notes module includes:
■ Viewing all existing notes
■ Creating a note
■ Attaching a document, text, or a URL to a note
■ Searching for a note
Task Manager provides the capability for tasks to be created, assigned, prioritized,
and managed. It provides an effective mechanism for organizations to use to
respond to customers’ needs in a timely manner. The key fuctionality of the Task
Manager module includes:

28-6 Oracle CRM Application Foundation User Guide


Calendar Process Flow

■ Viewing Task Information


■ Searching for a Task
■ Creating a Task
■ Assigning individual resources to a task
■ Maintaining Task Contacts
Appointments and tasks are both considered tasks. Appointments that are created
in the Create Appointment window automatically show up on the user’s calendar
with a source of appointment.

28.4 Oracle HTML Calendar Integrations


The HTML Calendar module uses the following to provide functionality:
■ Oracle HTML Task Manager to schedule appointments (tasks), create repeating
appointments for meetings.
■ Oracle HTML Resource Manager to invite employee resources to an
appointment.
■ Oracle Accounts Receivables’s profile options to set the default client and server
time zones for a user
■ Oracle Workflow to send workflow notifications for processing new group
calendar requests and subscription requests to an existing group calendar.
■ HTML Tech Stack to display the HTML functionality

The HTML Calendar is widely used by various Oracle modules across CRM.
■ Sales Online uses the HTML Calendar module to schedule appointments for a
lead or an opportunity, as well as to view resource availability through different
calendar views.
■ Marketing Online uses the HTML Calendar module to schedule appointments
for marketing campaigns, as well as to view resource availability through
different calendar views.

28.5 Calendar Process Flow


The following table describes the order and process of using the HTML Calendar.

Introduction to the Oracle HTML Calendar 28-7


What’s New in This Release

Table 28–3 Calendar User Process


Steps Description Performed By
View your Personal Effectively manage your daily activities, End user
Calendar appointments, and tasks with your personal
calendar.
View a Public Calendar (Optional) View or create a public calendar. End user
View a Group Calendar (Optional) Subscribe, view, and create a group End user
calendar.
View Resource (Optional) View the accessibility of an employee End user
Availability resources.
Create Appointments (Optional) Create an appointment using Calendar. End user
Define Attendees for an (Optional) Invite employee resources to an End user
Appointment appointment.
Add Attachments to an (Optional) View, create, and add attachments to an End user
Appointment appointment.
Create Repeating (Optional) Create a recurring appointment to appear End user
Appointments on your calendar.
Process Calendar Use the workflow notification window to grant or Group Calendar
Requests deny a group or public calendar request through Administrator
Oracle Workflow.
Use Tasks (Optional) Create, edit, and view tasks using Task End user
Manager.
Use Notes (Optional) Use Notes to view, create, and attach notes End user
to an appointment.
Customize Calendar (Optional) Modify your calendar preferences. End user
Preferences

28.6 What’s New in This Release


This release of CRM Application Foundation has the following new features in
Calendar subsequent to the 11.5.7.4 release:

Use the Administrator Hyperlink to Update Calendar Administrators


Users who have the JTF_CALENDAR_ADMIN role assigned to them can access the
Administrator hyperlink from the side navigation menu after clicking the Profile
icon.

28-8 Oracle CRM Application Foundation User Guide


What’s New in This Release

Use this link to assign a different user as a Calendar Administrator. After each
update, the JTF_CALENDAR_ADMIN role is automatically assigned to the new
Calendar Administrator, and is revoked from the old Calendar Administrator. All
the new group calendar requests will be sent to the new Calendar Administrator
through workflow notifications.
See Oracle CRM Application Foundation Implementation Guide for more information.

Calendar Has New Group Calendar Search Filters For Calendar


Administrator
This feature allows the Calendar Administrator only, not any other users, to search
for either an entire list of existing group calendars, or the group calendars that the
administrator is currently subscribed to, through a pull-down menu in the Calendar
Group Subscription window.

Group Calendar Administrators Listed in a Table Can Be Updated


Users with administrator role, such as a Calendar Administrator or a Group
Calendar Administrator, can update the Group Calendar Administrators listed in a
table format for a given group calendar. An average user can also see a similar table
with a list of Group Calendar Administrators, but no change can be made. All the
information in the table is read only for an average user.

Repeating Appointment Windows Have New Enhancements


There are several enhancements made in the repeating appointment windows. This
includes the following new areas of functionality:
■ Support yearly repeating: While creating a repeating appointment, users can
now choose to have the appointment repeat yearly in addition to daily, weekly,
or monthly.
■ Update the repeating rule: After creating a repeating appointment, users can
update the repeating rule by changing the frequency of a repeating series.
■ Decide the change impacts: Similar to the delete a repeating appointment
feature used in the previous release, now after updating a repeating
appointment or inviting new attendees for the selected repeating appointment,
users need to make selections in the Update Appointments window about how
the changes are to be implemented (only this appointment, all appointments, or
all future appointments).

Introduction to the Oracle HTML Calendar 28-9


Terms and Definitions

■ Reject or accept all repeating appointments: Invitees of a repeating


appointment can either reject all or accept all of them, instead of responding to
each invitation individually.

28.7 Terms and Definitions


The following table describes terms and definitions associated with Calendar.

Table 28–4 Terms and Definitions


Term Description
Category Use a category as a way of organizing tasks and
appointments. For example, the task can be a phone call and
the category could be call back customer.
OSO This is an acronym for Oracle Sales Online.
OMO This is an acronym for Oracle Marketing Online.
Full Access With Full Access you can read and edit/delete the record.
This access type does not include the capability of granting
access to others.
Read-only With read-only access, you can only view a record. You
cannot edit or delete anything.
Source Object This is the originator of the task, note, or appointment; for
example, Sales, Service, Contracts, or Opportunity.
Calendar Use Calendar to create, manage, and organize your
appointments, tasks, and contacts.
Party A party is an entity that can enter into a business
relationship. Resources of type "Party" can be imported
as resources from Oracle Accounts Receivables. An
example of a party is a customer.
Tasks A task is the lowest unit of work. For example, a task consists
of sending an email, calling back a customer, or attending a
meeting.

28-10 Oracle CRM Application Foundation User Guide


29
Overview of Using the Oracle HTML
Calendar

This chapter covers the following topics:


■ Accessing the Oracle HTML Calendar Interface
■ Summary of Oracle HTML Calendar Tasks

29.1 Accessing the Oracle HTML Calendar Interface


Each CRM module integrated with calendar has an individual login. Perform the
following steps to log in to Calendar.

Note:
■ Click the Calendar tab to access the daily view of your
calendar.
■ If you have integrated both Calendar and Resource Manager
with another Oracle module, you see both the Calendar tab and
the People tab. These two modules share the CRM Application
Foundation User responsibility

Prerequisites
You must be an employee resource to use calendar.

Responsibility
CRM Application Foundation User

Overview of Using the Oracle HTML Calendar 29-1


Summary of Oracle HTML Calendar Tasks

Navigation
Navigate to the JSP login page.

Steps
1. Enter your user ID.
2. Enter your password and click Go.
3. Click the Calendar tab.
Your personal calendar opens to the current dates daily view.

29.2 Summary of Oracle HTML Calendar Tasks


Use Oracle HTML Calendar to perform the following types of tasks:
■ Chapter 30, Viewing Your Calendar
■ Chapter 31, Managing Appointments
■ Chapter 32, Customizing Your Calendar Preferences
■ Chapter 33, Administering Group Calendars

29-2 Oracle CRM Application Foundation User Guide


30
Viewing Your Calendar

This chapter covers the following topics:


■ Viewing Your Personal Calendar
■ Viewing Different Dates on the Calendar
■ Viewing Your Tasks and Calendar Simultaneously
■ Viewing the Availability of a Resource
■ Adding a New Resource to Your Availability View
■ Viewing a Public Calendar

30.1 Viewing Your Personal Calendar


Once you log in to calendar, the daily view of your calendar opens.

Note:
■ If you have integrated both Calendar and Resource Manager
with another Oracle product, you see both the Calendar tab
and the People tab. These two modules share the CRM
Application Foundation User responsibility.
■ Click any arrow on any view page to view the previous or next
day, week, month, or year.

Prerequisites
None

Viewing Your Calendar 30-1


Viewing Different Dates on the Calendar

Responsibility
CRM Application Foundation User

Navigation
Navigate to the daily view of your Calendar.

Steps
1. Click any of the following menu items to display your calendar in the
corresponding view:
■ Daily
■ Weekly
■ Monthly
■ Yearly
■ Combination
2. Click any appointment to view the details.
3. Click Today to view the current date for any calendar view.

See Also
■ Viewing Different Dates on the Calendar
■ Viewing the Availability of a Resource
■ Viewing a Public Calendar

30.2 Viewing Different Dates on the Calendar


Use Calendar to view different dates on the calendar. Perform the following steps to
change the current date in your personal calendar.

Prerequisites
None

Responsibility
CRM Application Foundation User

30-2 Oracle CRM Application Foundation User Guide


Viewing Your Tasks and Your Calendar Simultaneously

Navigation
Navigate to the daily view of your calendar.

Steps
1. Use the > and < buttons to navigate to different dates on the calendar.
2. Click on any day in the mini calendar to view that date.
3. Click Go To in any calendar view or click the Date on the calendar to display
the dates daily view.
If you click Go To, the Go to Date window opens. From this window you can:
4. Select the Day you want to view.
5. Select the Month you want to view.
6. Select the Year you want to view.
7. Select the option button of the view you want to display:
■ Daily
■ Daily Combination
■ Monthly
■ Weekly
8. Click Go to view the option you selected.

See Also
■ Viewing Your Personal Calendar
■ Viewing the Availability of a Resource
■ Viewing a Public Calendar

30.3 Viewing Your Tasks and Your Calendar Simultaneously


Use the combination view to create, update, or delete an existing appointment, just
as in the daily view. This window is a combination of the daily view of your
calendar and the Task Summary. Perform the following steps to access your
Combination view.

Viewing Your Calendar 30-3


Viewing the Availability of a Resource

Note:
■ If you are viewing another resources personal or group
calendar, you are not able to view it in the Combination view.
■ The number of rows that appear in the Task Summary of the
Combination View can be modified by selecting the
Preferences link in the side navigation bar when you select the
Profile link or by changing the number of rows in the Task
Search window.

Prerequisites
You must have a task to view.

Responsibility
CRM Application Foundation User

Navigation
Navigate to the Combination window by clicking Combination in any calendar
view.

Steps
1. In the Combination window, click any appointment to display the appointment
details window.
2. Click Go To to change the date on the calendar or use the arrow icons to
navigate to different dates.

See Also
Viewing the Task Summary

30.4 Viewing the Availability of a Resource


Use the availability view to check the availability of a resource that you want to
invite to an appointment. Perform the following steps to view the availability
window.

30-4 Oracle CRM Application Foundation User Guide


Adding a New Resource to Your Availability View

Prerequisites
The resource must be defined in the Resource Manager.

Responsibility
CRM Application Foundation User

Navigation
Navigate to the Availability window by clicking Availability in any calendar view.

Steps
1. Use the > and < buttons to navigate to different times in the graphical view of
the resource’s schedule.
2. (Optional) Click Create Appointment or click the time interval in the combined
graphical view to create an appointment.
3. Click Add Resource to view another resource’s availability.

See Also
■ Viewing Your Personal Calendar
■ Viewing Different Dates on the Calendar
■ Viewing a Public Calendar
■ Adding a New Resource to Your Availability View

30.5 Adding a New Resource to Your Availability View


Use the Availability window to add a resource’s schedule to your availability view.
Perform the following steps to add a new resource to your availability view.

Note: Resources added to your availability view are only present


while the user is logged in. Once you log out of your calendar, any
resources added to the availability view are deleted and you must
add them to the window again once you log back in.

Prerequisites
A resource must already exist.

Viewing Your Calendar 30-5


Viewing a Public Calendar

Responsibility
CRM Application Foundation User

Navigation
Navigate to the Availability window by clicking Availability in any calendar view.

Steps
1. In the Availability window, click Add Resource.
The Lookup window opens.
2. Click Go to search for a resource.
The Search and Select window opens.
a. Enter at least one character in the search field and click Search.
A list of resources appear in the window.
b. Select the option button of the resource name you want to add and click
Select.
The resource name populates the text field.
3. Click Add.
The Resource is added to the multi-line text field.
4. Click Apply to add the resource to the availability window or click Remove to
delete the resource from the multi-line text field.
The Availability window opens with the resource’s availability information.

See Also
■ Viewing Different Dates on the Calendar
■ Viewing the Availability of a Resource
■ Viewing a Public Calendar

30.6 Viewing a Public Calendar


A calendar user can view all existing public calendars. Public Calendars appear in
Monthly view only. Perform the following steps to access a Public Calendar.

30-6 Oracle CRM Application Foundation User Guide


Viewing a Public Calendar

Prerequisites
A resource must already exist.

Responsibility
CRM Application Foundation User

Navigation
Navigate to the Public Calendar window by clicking Public Calendar in any
calendar view.

Steps
1. Enter the name of the public calendar or click Go to search for a public calendar.
a. Enter at least one character in the search field and click Search.
A list of calendars appear in the window.
b. Select the option button of the Calendar you want to view and click Select.
The calendar name populates the text field.
2. Select the month you want to view from the drop-down list.
3. Select the date you want to view from the drop-down list and click View.
The calendar appears in the window.
4. Click Today to return to the current month of the public calendar you are
viewing.

See Also
■ Viewing Your Personal Calendar
■ Viewing Different Dates on the Calendar
■ Viewing the Availability of a Resource

Viewing Your Calendar 30-7


Viewing a Public Calendar

30-8 Oracle CRM Application Foundation User Guide


31
Managing Appointments

This chapter covers the following topics:


■ Using the Quick Find Search
■ Viewing and Updating Appointment Details
■ Creating an Appointment
■ Deleting an Appointment
■ Defining Attendees for an Appointment
■ Receiving an Invitation
■ Creating Repeating Task or Appointment
■ Viewing Existing Attachments
■ Adding an Attachment
■ Relating Appointments and Tasks to Source Objects
■ Working with Bins
■ Viewing Your Calendar and Appointment Bins

31.1 Using the Quick Find Search


Use the Quick Find search to find your appointments, tasks, notes, employees, and
groups. Perform the following steps to execute a search.

Managing Appointments 31-1


Viewing and Updating Appointment Details

Note: You must run the Rebuilding Intermedia Index for Task
Names concurrent program periodically to see new and updated
tasks, and to be able to search by task name in the quick find. Please
see the Oracle CRM Application Foundation Implementation Guide,
Appendix C, for more information on concurrent programs.

Prerequisites
None

Responsibility
CRM Application Foundation User

Navigation
Navigate to any Calendar window.

Steps
1. Using the Quick Find drop-down list, select search criteria:
■ Appointments
■ Task
■ Notes
■ Employees
■ Groups
2. Enter a keyword or letter (at least three characters) and click Go.
The Search Results window opens.
3. Click any item to display the details.

31.2 Viewing and Updating Appointment Details


Use the Appointment Details window to view details for any of your existing
appointments. The appointments menu can be access in the side navigation bar
once you create an appointment. Perform the following steps to view the details of
an appointment.

31-2 Oracle CRM Application Foundation User Guide


Viewing and Updating Appointment Details

Note: Click the source number link to view the source or the name
link to view the details of the record.

Prerequisites
None

Responsibility
CRM Application Foundation User

Navigation
Navigate to the Appointment Details window by clicking on an appointment in any
calendar view.

Steps
1. View and edit information in the window.
2. Click Update to modify the appointment or click Restore to reset the original
values in the window.
A confirmation window opens to confirm the information was updated.

Guidelines
The following table describes links, which appear in the side navigation bar of the
Appointment Details window.

Table 31–1 Appointment Details Side Navigation Bar


Link Description
Appointment (Main) Click this link to view the details of an appointment.
Attendees Click this link to define attendees for an appointment.
Reference Click this link to relate an appointment to a business object
such as a marketing campaign.
Repeating Click this link to create a recurring appointment.
Attachments Click this link to view, create, and add attachments to an
appointment.
Notes Click this link to add a note to an appointment.

Managing Appointments 31-3


Creating an Appointment

See Also
■ Creating an Appointment
■ Creating Repeating Task or Appointment
■ Adding an Attachment
■ Defining Attendees for an Appointment
■ Relating Appointments and Tasks to Source Objects

31.3 Creating an Appointment


Use the Create Appointment window to create an appointment for yourself or
another resource. Perform the following steps to create an appointment.

Note:
■ You cannot create a private appointment in association with a
public calendar.
■ All fields marked with an asterisk are required.

Prerequisites
None

Responsibility
CRM Application Foundation User

Navigation
Navigate to the Create Appointment window by clicking the Create button in any
calendar view.

Steps
1. Enter a name for the appointment.
2. The start date reflects the current date and is automatically populated. You can
change the date if necessary.
3. Click the Go button to select the time zone where the appointment is scheduled.
This overrides the client time zone set in your calendar profile.

31-4 Oracle CRM Application Foundation User Guide


Creating an Appointment

a. Enter at least two characters in the search field and click Search.
A list of time zones appear in the window.
b. Select the option button of the time zone you want to define and click
Select.
The name populates the text field.
4. Using the drop-down lists, define the following information for the
appointment:
■ Start Time: If you accessed this window by clicking the + icon in the daily
or weekly view, the default is the time you selected.
■ Duration: If you accessed this window by clicking the + icon in the daily or
weekly view, the default is one hour.
■ (Task) Type
■ (Task) Category
■ Priority (Status)
5. Select when you want to be reminded of an appointment. Options include:
■ Do Not Remind Me
■ 15 Minutes Before
■ 30 Minutes Before
■ 1 Hour Before
■ 2 Hours Before
■ 1 Day Before
■ 2 Days Before
■ 3 Days Before
■ 1 Week Before.
The default value is "Do Not Remind Me". If you choose to receive a reminder,
you will receive a workflow notification in your Personal Home Page Worklist.
However, You will not receive an email notification since you cannot receive
both email and a notification in your Personal Home Page.
Additionally, you need to run the workflow background process JTF Task
Reminders in order to receive notifications as task reminders.

Managing Appointments 31-5


Deleting an Appointment

6. Select the Private check box if this a private appointment.


7. Use the drop-down list to select when you want to be reminded of the
appointment.
8. Enter a description for the appointment.
9. Select the related business object.
a. Enter the name or click Go.
b. Enter at least two characters in the search field and click Go.
A list of related objects appear in the window.
c. Select the option button of the name you want to add and click Select.
The name populates the text field.
10. Click either Create or Create and Create Another to save the current
appointment, clear the window, and return to the Create Appointment window
to create another appointment.
A confirmation window opens to confirm the appointment was created
successfully.

See Also
■ Viewing and Updating Appointment Details
■ Creating Repeating Task or Appointment
■ Adding an Attachment
■ Defining Attendees for an Appointment
■ Relating Appointments and Tasks to Source Objects
■ Creating a Note

31.4 Deleting an Appointment


You can delete any of your existing appointments. Perform the following steps to
delete an appointment.

Prerequisites
An appointment must already exist.

31-6 Oracle CRM Application Foundation User Guide


Defining Attendees for an Appointment

Responsibility
CRM Application Foundation User

Navigation
Navigate to the Create Appointment window by clicking Appointments in any
calendar view.

Steps
1. In the Create Appointment window, click Delete to remove the appointment
from your calendar.
If you are trying to delete a repeating appointment, the Delete Appointment
window opens displaying three options:
■ Delete Only this Appointment
■ Delete All Appointments
■ Delete All Future Appointments
2. Select the option you want and click Delete.
A confirmation window opens to confirm the appointment was deleted.

See Also
Creating an Appointment

31.5 Defining Attendees for an Appointment


Use the Attendees window to send an invitation for an appointment to another
resource. Perform the following steps to invite an employee resource to an
appointment.

Note:
■ Click the source link to view the source or the name link to
view the details of the record.
■ It is recommended that you do not invite attendees to public
calendar appointments.

Managing Appointments 31-7


Defining Attendees for an Appointment

WARNING: Do not modify the assignee status of the invitee in


the Forms-based version of Task Manager. Not all Task Manager
assignee statuses are available in the HTML Calendar.

Prerequisites
■ An appointment must already exist.
■ In order for a resource to receive an email notification for an appointment
invitation, the invitee must set the Issue Notification in the Calendar Personal
Preferences window to Yes. This window is accessed through the Profile link.

Responsibility
CRM Application Foundation User

Navigation
Navigate to the Appointment Details window by clicking on an appointment in any
calendar view.

Steps
1. Click Attendees in the side navigation bar.
The Attendees window opens.
2. Enter the resource name of the employee you want to invite to the appointment
or click Go to access the lookup tool.
a. Enter at least one character in the search field and click Go.
A list of resources appear in the window.
b. Select the option button of the resource you want to attend the appointment
and click Select.
The resource name populates the text field.
3. Click Add.
The resource name is moved to the multi-select text box. You can continue to
add as many resources as necessary.
4. Select the resource and click Remove to delete the name from the multi-select
text box.

31-8 Oracle CRM Application Foundation User Guide


Receiving an Invitation

5. Select the resource and click Availability to view the individual’s availability
for the scheduled appointment time.
6. Click Send Invite.
The resource is added to the invitees list with information regarding their status
(invited, accepted, or rejected).
7. To create a note for the appointment, for any attendee to view, click the Notes
link on the side navigation bar and click Create Note.
8. Select the Remove check box next to the employees name and click Update to
delete them from the list.

See Also
■ Viewing and Updating Appointment Details
■ Creating an Appointment
■ Creating Repeating Task or Appointment
■ Receiving an Invitation
■ Adding an Attachment
■ Relating Appointments and Tasks to Source Objects
■ Creating a Note

31.6 Receiving an Invitation


When you receive an invitation to an appointment, it displays on your calendar
with the word INVITE. Once you accept the invitation, the status changes from
invitee to attendee and you are then able to attach a note to it. Perform the
following steps to view and respond to an invitation.

WARNING: If you delete an invitation, you are not able to


retrieve it.

Prerequisites
An invitation must exist.

Managing Appointments 31-9


Creating a Repeating Task or Appointment

Responsibility
CRM Application Foundation User

Navigation
Navigate to the Appointment Invitation window by clicking on any invite that
appears on your calendar.

Steps
1. Click Accept, to accept the invitation.
The word Invite disappears and a response is sent to the owner of the
appointment.
2. Click Reject, to decline the invitation.
The link disappears completely.
3. To view any notes attached to the appointment, click the Notes link in the side
navigation bar.

See Also
■ Creating an Appointment
■ Defining Attendees for an Appointment

31.7 Creating a Repeating Task or Appointment


Use the Repeating window to create a series of appointments for a regularly
scheduled appointment. Perform the following steps to create a repeating
appointment.
See the Task Manager documentation for information regarding Creating a
Repeating Task or Appointment.

See Also
■ Viewing and Updating Appointment Details
■ Creating an Appointment
■ Adding an Attachment
■ Defining Attendees for an Appointment
■ Relating Appointments and Tasks to Source Objects

31-10 Oracle CRM Application Foundation User Guide


Viewing Existing Attachments

31.8 Viewing Existing Attachments


Use Calendar, Task, or Notes to view an existing attachment. Perform the following
steps to view the attachments window.

Note:
■ Click the source link to view the source or the name link to
view the details of the record.
■ Use the First, Previous, Next, and Last links to view all of your
existing attachments.

Prerequisites
An attachment must exists in the system.

Responsibility
CRM Application Foundation User

Navigation
Navigate to the Attachments window by clicking Attachments in the Appointment,
Note, or Task Details window.
Steps
1. Click Attachments.
The Attachments window opens.
2. Click any attachment link to view it in the window.

Note: If the row contains a Remove check box, you can select the
check box and update the window to delete the record. If the row
contains a Remove icon, you can click it to clear the row.

See Also
Adding an Attachment

Managing Appointments 31-11


Adding an Attachment

31.9 Adding an Attachment


Use Calendar, Tasks, or Notes to add an existing attachment to an appointment, as
well as, create and add a new attachment, all from the same window. You can link
unstructured data such as images, word-processing documents, spreadsheets,
URLs, or text to application data. Perform the following steps to attach or create an
attachment for a specific appointment.

Note: Click the source link to view the source or the name link to
view the details of the record. Use the First, Previous, Next, and
Last links to view all existing attachments in the system.

Prerequisites
None

Responsibility
CRM Application Foundation User

Navigation
Navigate to the Attachments window by clicking the Add Attachments button in
the Appointment, Notes, or Task Details windows.
Steps
1. Click Attachments in the side navigation bar.
The Attachments window opens.
2. Click Add Attachment.
The Add Attachments window opens.
3. Enter a description for the attachment.
4. Select one of the following option buttons to define the type of attachment you
want to add. The default is a File attachment.
Text: Enter the attachment text in the text field (no more than 2000 characters).
File: Enter the file name or click Browse to search for the file.
a. From the Choose File window, navigate to the file you want to attach.
b. Click Open.

31-12 Oracle CRM Application Foundation User Guide


Relating Appointments and Tasks to Source Objects

c. The File name appears in the text field.


URL: Enter the URL address.
5. Click Create to add the attachment to the Appointment, or click Clear to reset
the original values in the window.

See Also
■ Viewing and Updating Appointment Details
■ Creating an Appointment
■ Creating Repeating Task or Appointment
■ Defining Attendees for an Appointment
■ Relating Appointments and Tasks to Source Objects

31.10 Relating Appointments and Tasks to Source Objects


Use the References window to relate an appointment or task to a business object.
For example, if an appointment or task relates to a specific business campaign, you
can relate it to that campaign so the information appears to anyone who views the
appointment or task. A note can be related to two different tasks, but the same note
cannot be related to the same task twice. Perform the following steps to relate an
appointment or task to another business object.

Note: Click the source number link to view the source or the name
link to view the details of the record.

Prerequisites
None

Responsibility
CRM Application Foundation User

Navigation
Navigate to the References window by clicking References in the Appointment
Details window.

Managing Appointments 31-13


Working with Bins

Steps
1. Select the Related Object from the drop-down list.
2. Enter the name of the business object (application) or enter at least two
characters in the search field or click Go to access the lookup tool.
A list of business objects appear in the window.
3. Select the business object you want to reference the business object and click
Select.
The field populates with the business object.
4. Click Update to add the information to the table.
5. Select the Remove check box next to the business object and click Update to
delete it from the list.
The information is added to the Type and Name columns and a confirmation
window opens to confirm the information was updated.

Note: If the row contains a Remove check box, you can select the
check box and update the window to delete the record. If the row
contains a Remove icon, you can click it to clear the row.

See Also
■ Viewing and Updating Appointment Details
■ Creating an Appointment
■ Creating Repeating Task or Appointment
■ Adding an Attachment
■ Defining Attendees for an Appointment

31.11 Working with Bins


Bins provide a quick look at the current days appointments and tasks. The calendar
bin shows the current calendar month, the task bin shows a modified task summary,
and the appointment bin shows the current day’s appointments, which appear in
the daily view of your calendar. Only tasks and appointments (including task and
group calendar items) to which the user has access, are shown in the task and
appointment bins. The following topics provide additional information on bins:

31-14 Oracle CRM Application Foundation User Guide


Viewing Your Calendar and Appointment Bins

■ Viewing Your Calendar and Appointment Bins


■ Viewing the Task Bin
■ Editing Your Task Bin

Note: For more information regarding the implementation and


customization of bins, please see the Oracle CRM Technology
Foundation Concepts and Procedures.

31.12 Viewing Your Calendar and Appointment Bins


If you are running Calendar integrated with another Oracle CRM module, use
calendar bins as a quick look at your daily calendar and appointments.
■ The calendar bin shows you the monthly view of your calendar while the
appointment bin shows you all the items that appear on the daily view of your
calendar including tasks and appointments.
■ The appointment bin has two columns. The time column shows the start time of
the appointment and the name shows the appointment name. If a start time is
not specified when the appointment is created, "All Day" appears in the time
column. When you create an appointment, it appears in your appointment bin
for the specified day. Perform the following steps to view your calendar and
appointment bins.

Note:
■ When you switch to another calendar that you are subscribed
or have access to, your calendar and task bins still reflect your
personal appointments and tasks.
■ For information regarding the Personalize link, please see the
Oracle CRM Technology Foundation Concepts and Procedures.

Prerequisites
None

Responsibility
CRM Application Foundation User

Managing Appointments 31-15


Viewing Your Calendar and Appointment Bins

Navigation
Navigate to your Homepage.

Steps
1. From the daily view of your calendar, click Home on the main navigation bar.
Your Personal Homepage appears containing your two calendar bins. The first
bin contains a list of your appointments for the current day including the time
and name.
2. In the calendar bin, click on any date, or the Today’s date link, to access the
daily view of your calendar.
3. In the calendar bin, you can also click on the current month or year to access the
monthly view of your calendar.
In the appointment bin, click any appointment name to display the
Appointment Details window or click on the current date to access the daily
view of your calendar.

31-16 Oracle CRM Application Foundation User Guide


32
Customizing Your Calendar Preferences

This chapter covers the following topics:


■ Changing Your Personal Preferences
■ Defining Privileges for Your Calendar
■ Working with Group Calendars
■ Subscribing to a Group Calendar
■ Requesting a New Group or Public Calendar
■ Switching to Another Calendar
■ Adding and Removing Task Categories
■ Defining Your Time Zone

32.1 Changing Your Personal Preferences


Use Calendar preferences to control the way you view your calendar. Perform the
following steps to modify your personal preferences.

Note:
■ Selecting No for email notifications overwrites sending an
email to an invitee and the invitation only appears on the
resource’s calendar.
■ For more information regarding the Preferences and Personal
Profile links accessed through the profile icon, please see the
Oracle CRM Technology Foundation Concepts and Procedures.

Customizing Your Calendar Preferences 32-1


Changing Your Personal Preferences

Prerequisites
None

Responsibility
CRM Application Foundation User

Navigation
Navigate to the Calendar Personal Preferences window by clicking the Profile link.

Steps
1. Select your personal preferences:
■ Select whether or not you want an email notification sent to the attendees
when you send an invitation to an appointment. The default is set to Yes.
■ Select if you want your clock to display in intervals of 12 or 24 hours.
2. Select calendar display preferences:
■ Select what order you want the weeks on your calendar for the Weekly
view to begin and end. For example, Sunday through Saturday or Monday
through Friday.
■ Select the way you want your appointment time increments to display. For
example, 15 minute or 30 minute increments.
■ Select the start time and end time you want to display on your calendar for
each day of the week.
3. Click Update when you are done modifying your preferences.

See Also
■ Subscribing to a Group Calendar
■ Requesting a New Group Calendar
■ Switching to Another Calendar
■ Adding and Removing Task Categories
■ Defining Privileges for Your Calendar
■ Defining Your Time Zone

32-2 Oracle CRM Application Foundation User Guide


Defining Privileges for Your Calendar

32.2 Defining Privileges for Your Calendar


Use Calendar privileges to grant another user view only or full access to your
personal calendar. Perform the following steps to set calendar privileges.

Note:
■ For more information regarding the Preferences and Personal
Profile links access through the profile icon, please see the
Oracle CRM Technology Foundation Concepts and Procedures.
■ If you have a private appointment, only you are able to view it.
Even if you grant privileges to a user to view your calendar, the
appointment remains private.

Prerequisites
None

Responsibility
CRM Application Foundation User

Navigation
Navigate to the Calendar Personal Preferences window by clicking the Profile link.

Steps
1. Click Privileges in the side navigation bar.
The Privileges window opens.
2. Enter the user name in the text field next to the access you wish to grant (view
only or full access) or click Go to search for a user.
The Lookup window opens.
a. Enter at least one character for the search criteria and click Go.
A list of resources appears in the window.
b. Select the option button of the resource you want to grant privileges to and
click Select.
The user name populates the text field.
3. Click Add to add the user name to the multi-line text field and click Update.

Customizing Your Calendar Preferences 32-3


Working with Group Calendars

See Also
■ Subscribing to a Group Calendar
■ Requesting a New Group Calendar
■ Switching to Another Calendar
■ Changing Your Personal Preferences
■ Adding and Removing Task Categories
■ Defining Your Time Zone

32.3 Working with Group Calendars


See the following sections to subscribe to or request a new group calendar.
■ Requesting a New Group Calendar
■ Subscribing to a Group Calendar
The Calendar Administrator, but not any other users, can also see an additional
drop-down menu shown in the Group Calendar Subscription window to view
group calendar subscription information.
■ Viewing Group Calendar Subscription Information

32.4 Requesting a New Group or Public Calendar


When you request a new group or public calendar, the request is sent to the
Calendar System Administrator for approval. Once approved, a workflow process
is started and the calendar is created automatically. If you are requesting a group
calendar, you receive a notification and become the owner of the group calendar,
which entitles you to administer future subscription requests to that calendar. Any
subsequent subscription requests are then sent directly to your worklist for your
approval. Perform the following steps to request creation of a new group calendar.

Note:
■ You cannot create a private appointment in association with a
public calendar.
■ For more information regarding the Preferences and Personal
Profile links accessed through the profile icon, please see the
Oracle CRM Technology Foundation Concepts and Procedures.

32-4 Oracle CRM Application Foundation User Guide


Requesting a New Group or Public Calendar

Prerequisites
None

Responsibility
CRM Application Foundation User

Navigation
Navigate to the Calendar Personal Preferences window by clicking the Profile link.

Steps
1. Click Group Calendar in the side navigation bar.
The Group Subscription window opens.
2. Click Request New Group.
The Request New Group window opens.
3. Enter a name for the group.
4. Enter a description for the group.
5. Select the Public check box if you are requesting a public calendar.
6. Click Send Request.
A workflow notification is sent to the Group Calendar Administrator who
determines whether or not the request is approved.

See Also
■ Subscribing to a Group Calendar
■ Switching to Another Calendar
■ Changing Your Personal Preferences
■ Adding and Removing Task Categories
■ Defining Privileges for Your Calendar
■ Defining Your Time Zone

Customizing Your Calendar Preferences 32-5


Subscribing to a Group Calendar

32.5 Subscribing to a Group Calendar


A calendar user can subscribe to a group calendar. If your subscription request is
approved by the group calendar owner, the group calendar appears in the Calendar
Group Subscription window the next time you accesses it. The group calendar then
appears in your personal calendar. Only the Group Calendar Administrator, or a
calendar user granted full access to the calendar, can modify it. Perform the
following steps to gain access to a group calendar.

Note: For more information regarding the Preferences and


Personal Profile links accessed through the profile icon, please see
the Oracle CRM Technology Foundation Concepts and Procedures.

Prerequisites
A group calendar must exist.

Responsibility
CRM Application Foundation User

Navigation
Navigate to the Calendar Personal Preferences window by clicking the Profile link.

Steps
1. Click Group Calendar in the side navigation bar.
The Group Subscription window opens displaying all group calendar you are
currently subscribed to.
2. Click Subscribe to Group.
The Subscribe to Group Calendar window opens.
3. Enter the name of the group calendar you want to subscribe to or click Go to
search for a group.
a. Enter at least one character in the search field and click Go.
A list of calendars appear in the window.
b. Select the option button of the calendar you want to add and click Select.
The Group Name and Group Description fields information populates the
corresponding fields.

32-6 Oracle CRM Application Foundation User Guide


Switching to Another Calendar

4. Using the drop-down list, select which color you want the group to display in
your calendar.
5. Enter the prefix for the group calendar items.
6. Click Subscribe.
The group calendar subscription confirmation window opens confirming that
your subscription has been submitted.
7. Click Back to return to the Group Calendar Subscription window.
The workflow notification is sent to the Calendar Group Administrator.

See Also
■ Requesting a New Group Calendar
■ Switching to Another Calendar
■ Updating Group Calendar Subscription Information
■ Changing Your Personal Preferences
■ Adding and Removing Task Categories
■ Defining Privileges for Your Calendar
■ Defining Your Time Zone

32.6 Switching to Another Calendar


Use the Switch to Another Calendar window to view a group calendar that you
own or to view another user’s personal calendar if you have been granted access
privileges.
For example, Paul Henry can select the Key Accounts group calendar after he
receives approval from Timothy Cleary, the owner of the Key Accounts group
calendar. If Paul is an assistant for Elizabeth Smith, a sales director, and has
view-only access privilege to Elizabeth’s personal calendar, then Paul can also see
Elizabeth’s name shown in the User or Group Name field’s drop-down list. He can
switch to Elizabeth’s personal calendar and view her schedule if needed, but cannot
make updates, or add new appointments.
Timothy, the owner of the Key Account group calendar, can select the Key Account
group calendar if he wants to create or update activities. Paul is not able to select
the Key Account group calendar because Paul is not the owner of that group
calendar.

Customizing Your Calendar Preferences 32-7


Switching to Another Calendar

It is important to note that when you switch a calendar, you can still see your tasks
and notes by navigating to the Tasks or Notes subtab. With in this context if you
come back to the Views subtab, you are still in the switch calendar mode. To switch
back to your personal calendar, you need to go to switch calendar and switch back.
Access to appointments is based on whether you are the owner of the appointment
or an attendee. For example, when you search a note whose source is an
appointment, you can drill down to the appointment only if you are the owner or
the attendee of that appointment. Otherwise, you cannot drill down to the
appointment.
Access to calendars and the ability to view the associated contents kick in only
when you switch calendar and not in any other context. Perform the following steps
to switch to another calendar view.

Note: For more information regarding the Preferences and


Personal Profile links accessed through the profile icon, please see
the Oracle CRM Technology Foundation Concepts and Procedures.

Prerequisites
You must own or have access to another calendar.

Responsibility
CRM Application Foundation User

Navigation
Navigate to the Calendar Personal Preferences window by clicking the Profile link
in the upper right corner of the UI.

Steps
1. Click Switch Calendar in the side navigation bar.
The Switch to Another Calendar window opens.
2. Select to view another calendar you own or have access to from the drop-down
list.
3. Click Switch Calendar.
The new calendar opens in the daily view.

32-8 Oracle CRM Application Foundation User Guide


Adding and Removing Task Categories

See Also
■ Subscribing to a Group Calendar
■ Requesting a New Group Calendar
■ Changing Your Personal Preferences
■ Adding and Removing Task Categories
■ Defining Privileges for Your Calendar
■ Defining Your Time Zone

32.7 Adding and Removing Task Categories


Use Calendar to create personalized task categories to classify your appointments
or tasks. Perform the following steps to create a new task category.

Note:
■ The default category "Unfiled" exists for all users and cannot be
deleted.
■ For more information regarding the Preferences and Personal
Profile links accessed through the profile icon, please see the
Oracle CRM Technology Foundation Concepts and Procedures.

Prerequisites
None

Responsibility
CRM Application Foundation User

Navigation
Navigate to the Calendar Personal Preferences window by clicking the Profile link.

Steps
1. Click Categories in the side navigation bar.
The Categories window opens.
2. Enter a name for the category into a blank field under the category column.

Customizing Your Calendar Preferences 32-9


Defining Your Time Zone

3. Select the Remove check box next to the category and click Update to delete it.
4. Click Update to save your changes or click Restore to revert back to the original
information.

See Also
■ Subscribing to a Group Calendar
■ Requesting a New Group Calendar
■ Switching to Another Calendar
■ Changing Your Personal Preferences
■ Defining Privileges for Your Calendar
■ Defining Your Time Zone

32.8 Defining Your Time Zone


Use the time zone window to determine what time zone your appointments take
place in when you are creating an appointment. Perform the following steps to
change your time zone information for Calendar and all integrated Oracle Products.

Note: For more information regarding the Preferences and


Personal Profile links accessed through the profile icon, please see
the Oracle CRM Technology Foundation Concepts and Procedures.

Prerequisites
None

Responsibility
CRM Application Foundation User

Navigation
Navigate to the Calendar Personal Preferences window by clicking the Profile link.

Steps
1. Click Time Zone in the side navigation bar.
The User Time Zone window opens.

32-10 Oracle CRM Application Foundation User Guide


Defining Your Time Zone

2. Click the Go button to select the time zone you want to specify as your default.
3. Enter at least two characters in the search field and click Search.
A list of time zones appear in the window.
4. Select the option button of the time zone you want to define and click Select.
The name populates the text field.
5. Click Update to save your changes.

See Also
■ Subscribing to a Group Calendar
■ Requesting a New Group Calendar
■ Switching to Another Calendar
■ Changing Your Personal Preferences
■ Defining Privileges for Your Calendar
■ Adding and Removing Task Categories

Customizing Your Calendar Preferences 32-11


Defining Your Time Zone

32-12 Oracle CRM Application Foundation User Guide


33
Administering Group Calendars

This chapter covers the following topics:


■ Viewing and Approving New Group Calendar Requests
■ Viewing and Approving Subscription Requests
■ Viewing Group Calendar Subscription Information
■ Updating Group Calendar Subscription Information

33.1 Viewing and Approving New Group Calendar Requests


Note: The following procedure must be done in Forms.

The Calendar Administrator can approve or reject a new group calendar request.
Whether or not the group calendar request is granted or rejected, the group
calendar requestor receives a notification. If the request is approved, the requestor
automatically becomes the owner of the group calendar, the Group Calendar
Administrator, and is then responsible for approving future subscription requests
for that group calendar. Perform the following steps to approve a group calendar
request.

Note: If you are running Calendar integrated with Oracle Sales


Online (OSO), you are able to view notifications from your worklist
in HTML.

Administering Group Calendars 33-1


Viewing and Approving Subscription Requests

Prerequisites
■ You must configure your Personal Home Page (PHP) and create a worklist to
receive notifications.
■ The user must be a Calendar Administrator. See Creating a Calendar
Administrator section of the CRM Application Foundation Implementation Guide
for details.

Responsibility
System Administrator
CRM Application Foundation User (or the JTF HTML Calendar User)
Workflow User Web Application
Preferences

Navigation
Navigate to your homepage worklist in Forms.
Steps
1. Click on any request link.
The Notification Details window opens.
2. Review the request.
3. In the lower portion of the window, select No in the response drop-down list if
you want to deny the request, or select Yes to accept it.
4. Click the corresponding button to approve or deny the request.

See Also
■ Viewing and Approving Subscription Requests
■ Viewing Group Calendar Subscription Information
■ Updating Group Calendar Subscription Information

33.2 Viewing and Approving Subscription Requests


Note: The following procedure must be done inForms.

33-2 Oracle CRM Application Foundation User Guide


Viewing and Approving Subscription Requests

When you receive an approval for a new group calendar, you become the owner of
that calendar and are responsible for responding to all future subscription requests.
Perform the following steps to respond to a request to subscribe to your group
calendar.

Prerequisites
You must configure your Personal Home Page (PHP) and create a worklist to
receive notifications.
The user must be a Group Calendar Administrator who has the administrator
access privileges

Responsibility
CRM Application Foundation User
JTF HTML Calendar User

Navigation
Navigate to your homepage worklist in Forms.
Steps
1. Click on any request link.
The Notification Details window opens.
2. Review the request.
3. In the lower portion of the window, select read-only access from the Response
drop-down list and click Approve, to grant the request, or click Reject, to deny
it.
4. Click the corresponding button to approve or deny the request.
You worklist reappears in the window.

See Also
■ Viewing and Approving New Group Calendar Requests
■ Viewing Group Calendar Subscription Information
■ Updating Group Calendar Subscription Information

Administering Group Calendars 33-3


Viewing Group Calendar Subscription Information

33.3 Viewing Group Calendar Subscription Information


In order to be able to review group calendar subscription information, the Calendar
Administrator, but not any other users, can see an additional drop-down menu,
besides the Request New Group and Subscribe to Group buttons, with the
following choices listed in the Calendar Group Subscription window:
■ Show Subscribed (Default)
■ Show All
The default for the drop-down menu is Show Subscribed. This lists the group
calendars that HTML Calendar Administrator is currently subscribed to. The
Calendar Group Subscription window appears with Group Calendar Name,
Description, Color, and Prefix information. If Show All is selected, then all group
calendar’s names and descriptions will be shown in the Calendar Group
Subscription window.

Prerequisites
You must be the Calendar Administrator. See Creating a Calendar Administrator for
more information on defining user roles.

Responsibility
System Administrator

Navigation
Navigate to the Calendar Personal Preferences window by clicking the Profile icon.

Steps
1. In the Calendar Personal Preferences window, click Group Calendar in the side
navigation bar.
The Calendar Group Subscription window opens with Show Subscribed
selected in the drop-down menu next to the Subscribe to Group button.
2. Review the group calendar information that HTML Calendar Administrator has
subscribed to in the Calendar Group Subscription window.
3. (Optionally) select Show All from the drop-down list to review all group
calendars.

33-4 Oracle CRM Application Foundation User Guide


Updating Group Calendar Subscription Information

See Also
■ Viewing and Approving New Group Calendar Requests
■ Viewing and Approving Subscription Requests
■ Updating Group Calendar Subscription Information

33.4 Updating Group Calendar Subscription Information


After approvals from the Calendar Administrator for a new group calendar request
or from the Group Calendar Administrator for a subscription request, any users can
update their subscribed group calendars shown in the Calendar Group Subscription
window.
However, the level of calendar updates is based on the user types. An average user
who is neither a Calendar Administrator nor a Group Calendar Administrator can
have basic group calendar subscription updates. A user who is a Calendar
Administrator or a Group Calendar Administrator can further update the list of
Group Calendar Administrators (owners) shown in a table format for a selected
group calendar besides the basic updates.

Basic Group Calendar Subscription Updates


After opening the subscribed group calendar, a user can modify the subscription
information by changing the color and prefix event title information for the selected
group calendar. Click Update to save the changes. The Color and Prefix Event Title
fields are used to differentiate which activities displayed in your personal calendar
belong to the subscribed group calendar. Additionally, click Unsubscribe to revoke
the selected group calendar subscription.
It is important to note that there is also a table listing all the Group Calendar
Administrators for the selected group calendar. However, an average user cannot
modify any of them. All the information in this table is read only.

Add or Remove Group Calendar Administrators


Besides the basic group calendar updates, a user who is a Calendar Administrator
or a Group Calendar Administrator can see an extra Remove check box shown in
the table next to the Name field if the administrator has been identified. A user with
administrator role can add more Group Calendar Administrators from the Name
LOV if necessary. Any changes made to the administrators will be confirmed by a
message indicating your update is successful.

Administering Group Calendars 33-5


Updating Group Calendar Subscription Information

Note: each group calendar must have at least one Group Calendar
Administrator.

Before removing existing administrators, you must make sure that each group
calendar must have at least one Group Calendar Administrator listed in the table.
Otherwise, an error message pops up, "You have to select a new group calendar
administrator before you remove all of the existing ones!" If a duplicate name
(administrator) is selected, then an error message also pops up, "The resource you
selected is already a group calendar administrator."
After you update the administrators, if a group calendar has more than one Group
Calendar Administrator, then a subscriber’s request will be sent to all of the Group
Calendar Administrators. However, the access privilege of the subscriber to the
group calendar is based on the level granted by the first approver. For example, if
one of them approves the request and grants the subscriber an access level, such as
Read, the system will ignore the approvals from other administrators. This means
that even if another administrator grants the subscriber Full Access later, the access
level for the subscriber is still Read.
Tips: Although you can have more than one Group Calendar Administrator for a
group calendar, for the backup purposes, it is suggested that grant only one
additional user the Administrator access. Users who have the administrator access
privileges become the Group Calendar Administrators. Do not have too many
Group Calendar Administrators for the same group calendar.
While responding to the group calendar subscription requests, the Group Calendar
Administrator can grant the Full Access to the user who needs to create or update
the group calendar’s appointments, or the Administrator access to the user who
acts as the Group Calendar Administrator. Otherwise, the administrator should
always grant the Read Only access to the rest of subscribers.

Prerequisites
Users with the administrator role (a Calendar Administrator or a Group Calendar
Administrator) can update administrators for a given group calendar.

Responsibility
CRM Application Foundation User
JTF HTML Calendar User

33-6 Oracle CRM Application Foundation User Guide


Updating Group Calendar Subscription Information

Navigation
Navigate to the Calendar Personal Preferences window by clicking the Profile icon.

Steps
1. In the Calendar Personal Preferences window, click Group Calendar in the side
navigation bar.
The Calendar Group Subscription window opens with a list of your subscribed
group calendars.
2. Click the group calendar name to open the Group Calendar Subscription
Update window.
3. To update the group calendar subscription information:
a. Change the color and prefix event title information for the selected group
calendar.
b. Click Update to save the changes.
4. To unsubscribe the selected group calendar, click Unsubscribe to revoke the
subscription.
5. To update the administrators if you are a Calendar Administrator or a Group
Calendar Administrator:
a. Select the Remove check box next to the administrator whom you want to
remove.
b. Use the Name LOV and click Go to retrieve the administrator whom you
want to add to the calendar.
c. Click the Update to save the changes.

See Also
■ Viewing and Approving New Group Calendar Requests
■ Viewing and Approving Subscription Requests
■ Viewing Group Calendar Subscription Information

Administering Group Calendars 33-7


Updating Group Calendar Subscription Information

33-8 Oracle CRM Application Foundation User Guide


Part VII
Forms-based Calendar

This part of the Oracle CRM Application Foundation User Guide contains the
following chapters:
■ Introduction to the Oracle Forms-based Calendar
■ Overview of using the Oracle Forms-based Calendar
■ Managing the Forms-based Calendar
34
Introduction to the Oracle Forms-based
Calendar

This chapter covers the following topics:


■ Overview of the Oracle Forms-based Calendar
■ Oracle Forms-based Calendar Integrations
■ Process Flow for the Oracle Forms-based Calendar

34.1 Overview of the Oracle Forms-based Calendar


Calendar is a scheduling tool used to define and view available and non-available
time for a resource or group of resources. You can create a calendar for yourself or
another resource, associate work shifts to a calendar, and assign a resource to a shift,
depending on availability. The following topics provide additional information on
calendar setup and the datebook:
■ Calendar Setup Window
■ Calendar Datebook

34.1.1 Calendar Setup window


Use the Calendar Setup window to create time periods in a Calendar Datebook for
yourself or another resource. Calendar setup uses shifts and patterns to define time
availability and accommodate the most complex situation for a resource. You can
define both your working hours and your unavailable hours such as holidays and
vacations.

Introduction to the Oracle Forms-based Calendar 34-1


Overview of the Oracle Forms-based Calendar

What is Available Time?


Available time is defined using shifts and patterns. It is the time a resource is
available for scheduled work.

What is a Shift?
A shift defines when a person is available to work. For example, a shift can be
created that defines the default working week Monday to Friday 8:30 to 17:00.

Note: The Forms-based version of Calendar includes the ability to


support a 24 hour shift, which makes it possible for graveyard
shifts to be covered with one shift instead of two. In previous
versions, two separate shifts had to be created to cover a shift
which spanned between two separate days, such as,
10:00pm-2:00am.

What is a Shift Pattern?


A set of shifts that are set as a pattern.

Example
■ Shift A, Field Support, starts at 8:00 and lasts 9 hours.
■ Shift B, Stand By, starts at 20:00 and lasts 12 hours.
■ On days 1 through 4, the resource can be assigned shift A, and then days 6 and
7 shift B, and day 5 can be free.

What Is Non-available TIme?


Non-available time is a defined block of time when a resource is not available to
accept a task.
Non-available time includes:
■ Personal appointment
■ Public holidays
■ Meetings
■ Vacations
■ Illness

34-2 Oracle CRM Application Foundation User Guide


Process Flow for the Oracle Forms-based Calendar

34.1.2 Calendar Datebook


Use the Calendar Datebook to view time availability for yourself, a resource, or a
group of resources. In the datebook, a resource’s schedule can be viewed in a daily,
weekly, or monthly format.
In your Datebook you can view:
■ Working hours
■ Assigned tasks
■ Personal appointments
■ Official holidays and vacation days
In addition, you can:
■ Create a ToDo list for the day, week, or month
■ Access the Tasks application to edit a task

34.2 Oracle Forms-based Calendar Integrations


The Forms-based Calendar uses the following Oracle modules to provide
functionality:
■ Task Manager (Forms) to create a personal Todo List (tasks) and different
calendar views.
■ Resource Manager to locate a specific resource for different calendar views.

The Forms-based Calendar is widely used by various Oracle modules across CRM.
■ TeleService and Field Service uses Calendar to access the Calendar Datebook to
view a specific resource’s availability and assign task information.
■ Assignment Manager uses Calendar to display resource work shift information
through the Gantt chart. Service applications can then use Assignment Manager
to locate appropriate resources for a service request or a task.

34.3 Process Flow for the Oracle Forms-based Calendar


The following table describes the order and process of using the Forms-based
Calendar.

Introduction to the Oracle Forms-based Calendar 34-3


Process Flow for the Oracle Forms-based Calendar

Table 34–1 Forms-based Calendar Process


Steps Description
Create Tasks and ToDos in a Calendar Access your personal calendar to create and edit tasks and
ToDos.
View a Datebook View a work shift, task, or time off for yourself, a resource, or
a group of resources.
Create a ToDo List Create a personal ToDo list for yourself in your personal
calendar.

34-4 Oracle CRM Application Foundation User Guide


35
Overview of Using the Oracle Forms-based
Calendar

This chapter covers the following topics:


■ Accessing the Oracle Forms-based Calendar Interface
■ Summary of Oracle Forms-based Calendar Tasks

35.1 Accessing the Oracle Forms-based Calendar Interface


Perform the following steps to log in to the Forms-based Calendar.

Prerequisites
You must be an employee type resource to use calendar.

Responsibility
Telesales Agent

Navigation
Navigate to the eBusiness Center.

Steps
Click the Datebook icon from the application icon menu to access the Calendar
Datebook.

35.2 Summary of Oracle Forms-based Calendar Tasks


Use the Oracle Forms-based Calendar to perform the following tasks:

Overview of Using the Oracle Forms-based Calendar 35-1


Summary of Oracle Forms-based Calendar Tasks

Chapter 37, Managing the Forms-based Calendar

35-2 Oracle CRM Application Foundation User Guide


36
Managing the Oracle Forms-based Calendar

This chapter covers the following topics:


■ Creating Tasks and ToDos in a Calendar
■ Viewing a Datebook
■ Creating a ToDo List

36.1 Creating Tasks and ToDos in a Calendar


Use the Calendar Datebook functionality in the Oracle Telesales application to view
scheduled activities and create todo lists. Perform the following steps to gain access
to your personal calendar and create and edit tasks and ToDos.

Prerequisites
You must have a personal calendar.

Responsibility
Telesales Agent

Navigation
Navigate to eBusiness Center.
Steps
1. Click the Calendar Datebook icon from the eBusiness Center.
2. Select any group in the Role and Group field of the Choose Role and Group
window and click OK if necessary.
3. (Optional) Select All Tasks option button and click New to create a task.

Managing the Oracle Forms-based Calendar 36-1


Viewing the Datebook

The Tasks window opens.


See Creating, Updating, and Finding Tasks for more information on creating
tasks.
4. (Optional) Select ToDo and click Private Tasks option button and click New to
create or edit a ToDo.
The Create/Edit Todo form opens. Fill in the appropriate information and click
OK.
See Creating a ToDo List for more information on creating a todo list.
5. Save your changes and close the Calendar.

36.2 Viewing the Datebook


Use the Datebook window to view a work shift, task, or time off for yourself or
another resource, or a group of resources. The Calendar Datebook is specific to the
Telesales application. Perform the following steps to view the datebook.

Prerequisites
None

Responsibility
Telesales Agent

Navigation
Navigate to eBusiness Center.
Steps
1. From the Calendar Name field, select the calendar name you want to view. For
example, a personal or work calendar.
2. From the drop-down list next to the Resource Employee field, select the
resource or group of resources available for the chosen calendar.
3. Select either the Day, Week, or Month tab depending on the time period you
want to view.

36-2 Oracle CRM Application Foundation User Guide


Creating a ToDo List

36.3 Creating a ToDo List


You can create a personal ToDo list for yourself. Perform the following steps to
create a ToDo list.

Prerequisites
None

Responsibility
Telesales Agent

Navigation
Navigate to eBusiness Center.
Steps
1. Select the Private Tasks option button.
2. Click New. The Create/Edit ToDo window appears.
3. Enter the name of your ToDo. This entry appears in the ToDo region.
4. Enter a description of the ToDo.
5. Enter the priority.
6. Enter the status.
7. Enter the effective dates and click OK.

Managing the Oracle Forms-based Calendar 36-3


Creating a ToDo List

36-4 Oracle CRM Application Foundation User Guide


Part VIII
Interaction History

This part of the Oracle CRM Application Foundation User Guide contains the
following chapters:
■ Introduction to Oracle Interaction History
■ Overview of Using Oracle Interaction History
■ Forms-based Interactions
■ Forms-based Interaction History Activities
■ HTML Interactions
■ HTML Interaction History Activities
37
Introduction to Oracle Interaction History

This chapter covers the following topics:


■ Overview of Oracle Interaction History
■ Oracle Interaction History Integrations
■ Process Flow for Oracle Interaction History
■ What’s New in This Release
■ Terms and Definitions
■ How does Interaction History Work?
■ Interaction History Features

37.1 Overview of Oracle Interaction History


Interaction History tracks all customer-agent interactions (also referred to as touch
points) and serves as a repository for the resulting interaction data. Applications
record touch points through the Interaction History framework itself, or through
other applications that use Interaction History. This information can be accessed by
using the Interaction History graphical user interface (GUI), or by using the GUI of
an application that is integrated with Interaction History.

The following sections describe the purpose and function of Interaction History.
■ What is Interaction Data
■ What is an Interaction?
■ What is an Activity?

Introduction to Oracle Interaction History 37-1


Overview of Oracle Interaction History

■ What are Media and Media Items?

37.1.1 What is Interaction Data?


Interaction data provides agents with a detailed history of their organization’s
relationship with its customers, and enhances their ability to serve them effectively.
Interaction data often identifies the customer, account number, agent, campaign,
date and time, activity type, the outcome and result of an interaction or activity,
activity duration, and notes. All Interaction History records are stored as historical
records in the database. Interaction History is primarily used by Sales and
Marketing.

Example
When a new note is created and associated with a service request, a new interaction
activity is recorded stating that the service request was updated. Interaction History
records the occurrence of the interaction and the time stamp when it occurred but
the details of the note are accessible from the Workbench tab or Tool menu of the
service request form.

37.1.2 What is an Interaction?


An interaction is a point of contact or touchpoint between a human or automated
agent and a party such as a customer, a customer system, or a potential customer.
An interaction is a timed entity with an outcome and a result that can be tracked.
When an interaction is closed, it becomes an historical record that subsequently
cannot be altered or modified. Multiple forms of communication or media items
between the party and the agent can be incuded in a single interaction.

Example
An interaction is a customer call into an agent requesting a quote on a printer. The
activities include the agent obtaining a quote and sending a fax. Therefore, there are
multiple activities for a single interaction.
The interaction activities are:
■ Calling the agent
■ The agent obtaining a quote
■ The agent sending a fax

37-2 Oracle CRM Application Foundation User Guide


Interaction History’s Dependencies and Integration

For the first activity, the media is the telephone, and the media item is the telephone
call. For the second activity, the media is the fax machine, and the media item is the
actual fax.

37.1.3 What Is an Activity?


An activity is a business action performed by an agent as part of a customer
interaction using one or more methods of communication called media items.
Activities are recorded in Interaction History and can be viewed by using the
Interaction History windows accessed from calling applications. Some examples of
activities include an agent transferring a call, an agent emailing a marketing
brochure, or a customer placing an order.

37.1.4 What Are Media and Media Items?


Media items are inbound and outbound communications that take place between a customer
and a human or automated agent, a system or a CRM application. One or more media items
can be associated with a single activity. Telephone conversations and email correspondence
between customers and agents are examples of media items.
Media are the individual communication channels through which media items are delivered.
Telephones, fax machines, automatic teller machines (ATMs), and email messages are
examples of media.

37.2 Interaction History’s Dependencies and Integration


The following Oracle CRM applications integrate with Interaction History:
■ An inbound call from a customer passes through the Private Branch Exchange
(PBX), a business phone system, and routes into a call center.
■ All inbound and outbound telephone calls are facilitated by the Oracle
Telephony Manager (OTM) system. OTM acts as the vehicle for executing
intelligent rules-based routing. This enables the right call to get to the right
agent each time.
■ The Universal Work Queue (UWQ) provides a unified view and access
framework allowing Interaction Center users to view information about work,
work load, select work, request media work items, and launch work into
appropriate underlying application, for example, TeleService.
■ When an agent is assigned to take an inbound call, she or he can log in to one of
the Service applications to create a task or service request based on the
customer needs.

Introduction to Oracle Interaction History 37-3


Process Flow for Oracle Interaction History

Interaction History is integrated with Scripting which enables users to communicate


with customers using a script. For example, a customer places a call into a call
center to complain about the lack of service that he received. The agent uses a script
(with call guides to agents) to communicate with this customer and a service
request is created. When the activity of service request is created and written to
Interaction History, the script transaction identifier is passed through a framework
and stored in association with the activity. The next time this customer calls, any
agent can check which script was used and have an exact understanding of what
transpired. For this release, no changes are made to Interaction History’s user
interfaces.
Customer related information can be queried from the shared repository, Oracle
Trading Community Architecture (TCA).
An appropriate resource (engineer) that resides in the Resource Manager could then
be assigned to this open task or service request. She or he can also attach a note to
this open task.
All the information (touch points) between an agent and a customer through an
inbound call can be stored in Interaction History. In addition, any document sent
out by Fulfillment can also be part of this interaction information.

Interaction History is integrated with the following Oracle CRM applications.


■ Oracle Multi-Channel Manager
■ Oracle iCenter
■ Oracle Advanced Outbound
■ Oracle Universal Work Queue
■ Oracle Customer Care
■ Oracle Support
■ Oracle Telesales

37.3 Process Flow for Oracle Interaction History


The following table describes the order and process of using Interaction History.

37-4 Oracle CRM Application Foundation User Guide


What’s New In This Release

Table 37–1 Interaction History Process


Steps Description Type Performed By
Search Interactions (Optional) Search customer-agent interactions by Forms, IH Administrator
identifying criteria used in the search. HTML
View Interactions (Optional) After searching for interactions, you can view Forms, IH Administrator
them. HTML
View Interaction (Optional) View the attached notes associated with the Forms, IH Administrator
Notes interaction. HTML
Search Activities (Optional) Search for activities related to the interaction Forms, IH Administrator
or customer. HTML
View Activities (Optional) View the activities associated to the Forms, IH Administrator
interaction. HTML
View Activity Notes (Optional) View the attached notes associated with the Forms, IH Administrator
selected activity. HTML
View Migrated (Optional) View attachments associated with an Forms, IH Administrator
Attachments interaction that were recorded by third parties in the HTML
Forms-based interface.

37.4 What’s New In This Release


This release of CRM Application Foundation has many new features subsequent to
the 11.5.7.4. release.

Interaction and Activity Search Filter Fields are Case Insensitive


The interaction and activity search filter fields are no longer case sensitive.

Interactions Have New Search Criteria


The Interaction History UI contains radio buttons that enable customers to search
for all interactions or to search interactions for a current customer. These buttons are
only applicable to applications that are integrated with Interaction History.

Actions Can Be Paired with Activity Types in the HTML Administrative


GUI
The side bar navigation of the Interaction History HTML Administrative GUI
contains an option for pairing actions with activity types. Clicking the
Action-Activity Type link launches the page required to perform this action.

Introduction to Oracle Interaction History 37-5


Terms and Definitions

37.5 Terms and Definitions


The following table describes Interaction History terms and definitions.

Table 37–2 Interaction History Terms and Definitions


Term Description
Activity An activity is a business action performed by an agent such as
sending a fax, updating a service request, or creating a note.
Component A component is a coherent package of software implementation that:
■ Is independently developed and delivered
■ Has explicit and well-specified interfaces for the services it
provides
■ Has clearly defined interfaces for services it expects from others
■ Composed with other components customizing some of their
properties, without modifying the components themselves
Framework A framework is a collection of collaborating classes. The interaction
framework dictates the architecture. It defines the overall structure,
its partitioning into classes and objects, the key responsibilities, how
the classes and objects collaborate, and the thread of control.
Interaction An interaction is a touch point that occurs between a customer, a
customer system, a resource, or a resource system. An example of a
touchpoint is a phone call between an agent and a customer.
Interactions include activities, media, and media items.
Interaction History IH provides CRM applications with a common framework for
(IH) capturing and accessing all "interaction" data associated with
customer contacts. IH acts as the central repository and provides a
consistent framework for tracking all automated or agent-based
customer interactions.
Media Media represents the communication channel through which an
activity takes place. Examples can include: the phone, the fax
machine, an ATM, or a cell phone.
Media Device A media device is a type of media controller that resides outside of
software. Not all media have media devices. An example of a media
device is a phone.

37-6 Oracle CRM Application Foundation User Guide


Terms and Definitions

Table 37–2 Interaction History Terms and Definitions


Term Description
Media Item Media items represent a communication occurrence that is handled
by a CRM Application or user. They are generated by a customer
directly, the agent, the system, or a CRM Application and can be
inbound or outbound. Media items are multiple types of
communication associated with an interaction. They are generated
by a customer, the system, or an application and can be inbound or
outbound.
Media Lifecycle A Media Lifecycle is a unit of time associated with the handling of a
media item. For example, a call that is in the ACD queue for 10
seconds, the IVR for 20 seconds, worked by agent "JSMITH" for 45
seconds and then by agent "JDOE" for 20 seconds has four segments
in its lifecycle.
Media Metadata Media Metadata is data that is associated with a particular type of
media. The information adds additional context to the media or
provides information on how to gain access to the media. Examples
of media metadata include IVR, ANI, DNIS for telephone calls, and
To, From, Subject, and Classification for emails.
Media Provider A media provider is the source or entry point of media into a call or
service center. It can be the creator of the media of the gateway by
which media enters the system. Often it will provide a staging area
for the media to reside in until it is ultimately delivered to the
consumer.
Examples of media providers are ACD queues, predictive servers,
and email servers.
Media Type A media type describes the broad classification that a media item
can be grouped into. Media that fall into a single media type
typically have the same media provider, queuing, and media
controller.
Examples of media types are email, inbound telephone calls,
outbound telephone calls, mail, ATM, and faxes.
Object An object is any identifiable individual or thing. It can be physical,
such as a telephone or PBX, or an abstract concept, such as a
marketing campaign.
Tasks A task is a discrete unit of work that is assigned to one or more
individuals. Tasks are managed by Task Manager. Tasks are often
scheduled events and have defined expirations.
Task Group A task template is a skeleton or surrogate task. A task group
Templates template is a grouping of different task templates defined during set
up.

Introduction to Oracle Interaction History 37-7


How does Interaction History Work?

Table 37–2 Interaction History Terms and Definitions


Term Description
Task Manager Task Manager manages tasks throughout other applications. Task
Manager provides a mechanism for tasks to be created, assigned,
managed, sorted, and prioritized to provide timely response to
customer issues.
Task Types A task can be of many types which are defined during a set up
process. A task type, such as a call back, defines the task. A task type
defines the load for the task, effective dates and resources needed for
the task.
Work Work is broadly defined as a collection of items presented to an
agent through the CRM E-business application to be processed.
Work items can be either a media item or a task.

37.6 How does Interaction History Work?


When a customer-agent interaction occurs, the interaction data is captured and
tracked within Interaction History.
The following is an example of the types of interaction and activity data that is
tracked:
■ Customer
■ Account Number
■ Agent
■ Campaign
■ Date and Time
■ Activity Type (Media and Activity)
■ Outcome or Result of the Interaction or Activity
■ Duration
■ Notes

37.7 Interaction History Features


Within Interaction History, you can view customer-agent interactions, activities and
notes. Interactions can be filtered by customer, agent, campaign, date range, and
account number. Activities can be filtered by customer, agent, activity type, media

37-8 Oracle CRM Application Foundation User Guide


Interaction History Features

type, and date range. Notes that exist for customer-agent interactions and activities
are available for viewing in Interaction History.

37.7.1 Viewing Migrated 3i Attachments


One of the functions of the Oracle 3i Interaction Manager, was the capability to bind
attachments to 3i interactions. Since the Interaction History module now handles
many of it functions, how do you view attachments from an older application? This
release allows you to view attachments that were created with the Oracle 3i
Interaction Manager. Contact Oracle Sales Online documentation for procedures on
how to migrate the documents in order to view them.
In the Forms-based version, interactions with attachments have a highlighted paper
clip icon. If there is no attachment associated with the interaction, the paper clip
icon is inactive. In the HTML version, attachments are indicated with a paperclip
icon in the attachment column in the Interactions Filtering Criteria tab.

Example
A customer site completes a migration from Oracle CRM 3i to 11i. Data is migrated
from 3i Interaction Manager records to 11i Interaction History records. An agent
using the 11i Customer Care Application invokes all interactions. A customer’s set
of interactions display in the window.

37.7.2 Importing Mass Data


Interaction History can mass import data from third parties. Interaction History has
the ability to accept multiple interactions, activities, or media items and upload
them into the Interaction History table. Staging tables are created where the calling
application can upload its data. The structures of the staging table are similar to the
Interaction History tables with two additional columns: SESSION_NO and STATE_
FL. Upon completion, the data is handled and viewed the same way that other
interactions from Interaction History are recorded. Once it has been imported, it can
be viewed through Forms or HTML.

Example
A company outsources a mass mailing campaign to a third party. When the
company receives the responses back, they can keep track of the touchpoints to use
in an analysis of their marketing campaign. The company can use the marketing
tool to look at all the interaction history.

Introduction to Oracle Interaction History 37-9


Interaction History Features

37.7.3 Viewing Open or Closed Activities


An Active Status column on both the HTML and Forms-based module appears in
the Interaction History window on the Interactions and Activities tabs. In Forms,
the column has a red "X" for closed interactions and a green check mark for
interactions that are still open. In HTML, the check box is checked if it has an active
status.

37.7.4 SMTP Email Identifier Available


Fulfillment uses Java Mail to create email messages. Each message has an identifier
which is called the SMTP ID. The SMTP ID can be retrieved and stored as part of an
interaction activity in the Interaction History module. The Fulfillment server will
fetch the SMTP ID for outgoing emails that are sent directly through the SMTP
connection. Interaction History exposes the SMTP ID in the table for calling
applications to use.

37.7.5 Integration With Scripting


Interaction History records customer touch points and the script transaction
identifier is associated with the activity resulting from the interaction. For example,
if the activity of service request is created and a script was used during the touch
point then the scripting identifier is written to Interaction History and associated
with the activity. By recording the script transaction identifier, you can determine
what script was used in the touch point and gain insights into what was actually
communicated to the customer.
Interaction History’s framework for adding and updating activities is enhanced to
allow the SCRIPT_TRANS_ID to be passed when an activity is created and updated.
A SCRIPT_TRANS_ID field is added to the Activities table to store the script
transaction identifier. It is not a required field.
An activity type of "Script" is also added so that a calling application creates an
activity type of script even if no other activities are performed relative to the script.
This ensures that a script transaction related to the touch point is still recorded. For
this release, no changes are made to Interaction History’s Agent user interfaces.

Example
A customer places a call into a call center to complain about the lack of service he
received. The agent (customer service representative) uses a script to communicate
with the customer and a service request is created. When the activity of service
request is created and written to Interaction History, the script transaction identifier

37-10 Oracle CRM Application Foundation User Guide


Interaction History Features

is passed through a framework and stored as associated to the activity. The next
time this customer calls, any agent can check which script was used and have an
exact understanding of what transpired.

Introduction to Oracle Interaction History 37-11


Interaction History Features

37-12 Oracle CRM Application Foundation User Guide


38
Overview of Using Oracle Interaction
History

This chapter covers the following topics:


■ Accessing the Oracle Interaction History Interface
■ Summary of Oracle Interaction History Tasks

38.1 Accessing the Oracle Interaction History Interface


Interaction History is accessed from the Oracle Marketing Online and Oracle
Sales Online applications. For instructions on navigating the Interaction History
agent windows, please see the documentation for those products.

38.2 Summary of Oracle Interaction History Tasks


Use Oracle Interaction History to perform the following:
■ Working with Forms-based Interactions
■ Working with Forms-based Activities
■ Working with HTML Interactions
■ Working with HTML Activities

Overview of Using Oracle Interaction History 38-1


Summary of Oracle Interaction History Tasks

38-2 Oracle CRM Application Foundation User Guide


39
Working with Forms-based Interactions

This chapter covers the following topics:


■ Searching Interactions
■ Viewing Interactions
■ Viewing Interaction Notes

39.1 Searching Interactions


You can search customer-agent interactions by first identifying the appropriate
search criteria and then filtering your search by customer, agent, campaign, date
range, or account number. You can also search interactions by choosing a
combination of values. For example, you may need to identify all campaigns that
pertain to a particular customer. Once identified, the filtered results appear in the
Interactions tab in the Interaction History window. The search function is not case
sensitive.
Perform the following steps to search customer-agent interactions.

Prerequisites
A customer-agent interaction must exist in Interaction History.

Responsibility
Any type of end-user or non-administrative responsibility.

Navigation
Navigate to the Interactions Filtering Criteria Tab

Working with Forms-based Interactions 39-1


Viewing Interactions

Steps
1. Enter the criteria for searching interactions in any of the following fields:
a. In the Customer field, enter the customer’s name.
b. In the Agent field, enter the agent’s name.
c. In the Campaign field, enter the campaign name.
d. In the Date from and to fields, click the LOV button in each field to display
the calendar. Click the date on the calendar from which to begin the search.
You may also specify the time.
e. Click OK.
The date will display in the Date from field and you will automatically
proceed to the Date to field.
2. Click the date on the calendar to end the date range. You can also specify the
time.
3. Click OK.
The date will display in the Date to field.
4. In the Account field, enter the customer’s account number.
5. Click the Search button.

Note: Interaction History contains radio buttons that enable users


to search interactions by current customer or by all interactions.
These buttons are enabled for applications that are integrated with
Interaction History, but not when Interaction History is operated in
standalone mode.

39.2 Viewing Interactions


After interactions are filtered to facilitate viewing, the data associated with the
interactions appears in the Interactions tab. Notes entered for an interaction in the
Oracle CRM application appear in the modal window of the Interactions tab.
Perform the following steps to view customer-agent interactions.

39-2 Oracle CRM Application Foundation User Guide


Viewing Interaction Notes

Prerequisites
A customer-agent interaction must exist in Interaction History.

Responsibility
Any type of end-user or non-administrative responsibility.

Navigation
Navigate to the Interactions Filtering Criteria Tab

Steps
1. From the Interactions tab, click the interaction you want to view or use the
scroll bar to scroll through the interactions.
■ The interaction data is grouped within columns and rows. Dragging your
mouse over the heading of a column displays the column description as a
tool tip. Expand or collapse columns in the Interactions tab as needed.
■ By default, the first interaction that matches the criteria for the search is
highlighted. A sort indicator appears in the column header for the column
for which the primary sort occurred. The currently hi lighted row displays a
record indicator.
■ Scroll across the Interactions tab to view the column information for the
interaction.
■ Notes entered for an interaction appear in the modal window of the
Interactions tab.
2. Close the Interaction History window when the task is completed.

39.3 Viewing Interaction Notes


Perform the following steps to view notes in Interaction History.

Prerequisites
A note must exist for the customer-agent interaction in an Oracle CRM application.

Responsibility
Any type of end-user or non-administrative responsibility.

Working with Forms-based Interactions 39-3


Viewing Interaction Notes

Navigation
Access the Notes window in the Interactions tab.

Steps
1. Select the note to view.
2. When you have finished viewing the interaction note, click another interaction
to view another note, or close the Interaction History window to exit from the
interaction view.

39-4 Oracle CRM Application Foundation User Guide


40
Working with Forms-based Activities

This chapter covers the following topics:


■ Searching Activities
■ Viewing Activities
■ Viewing Activity Notes
■ Drilling Down on Reference Documents

40.1 Searching Activities


You can search customer-agent interactions by activity and can filter your search by
customer, agent, activity type, media type, date range, or account number. You can
also search activities by choosing a combination of search parameters. For example,
you can search for activities by activity type, customer, and date range.
Once you identify the search parameters, the filtered results appear in the Activities
tab in the Interaction History window. The search function is case sensitive. Perform
the following steps to search activities within customer-agent interactions.

Prerequisites
An activity must exist for the customer-agent interaction in Interaction History and
the calling application.

Responsibility
End user

Working with Forms-based Activities 40-1


Viewing Activities

Navigation

Navigate to the Activities Filtering Criteria tab.

Steps
1. Enter the criteria for searching activities in any of the following fields:
a. In the Customer field, enter the customer’s name.
b. In the Agent field, enter the agent’s name.
c. In the Activity Type field, enter the type of activity.
d. In the Media Type field, enter the type of media.
e. In the Date from and to fields, click the of values button in each field to
display the calendar. Click the date on the calendar from which to begin the
search. You can also specify the time.
f. Click OK.
The date appears in the Date from field and you automatically proceed to
the Date to field.
2. Click the date on the calendar to end the date range. You can also specify the
time. Click OK.
The date appears in the Date to field.
3. Click the Search button.
The activities that exist for the search performed will display in the Activities
tab in the Interaction History window.

40.2 Viewing Activities


Activities performed for a customer-agent interaction in a calling application are
viewed from the Activities tab in Interaction History. Perform the following steps to
view activities for customer-agent interactions.

Prerequisites
A customer-agent interaction must exist in Interaction History.

Responsibility
Any type of end-user or non-administrative responsibility.

40-2 Oracle CRM Application Foundation User Guide


Viewing Activity Notes

Navigation

Navigate to the Activities Filtering Criteria tab.

Steps
1. From the Activities tab, click the activity to view or use the scroll bar to scroll
through the activities.
■ The activity data is grouped within columns and rows. Drag your mouse
over the heading of a column to display a description of the column as a
tool tip. Expand and collapse columns in the Activities tab as needed. By
default, the activity that matches the criteria for the search is highlighted. A
sort indicator will appear in the column header for the column for which
the primary sort occurred. A record indicator appears for the currently
highlighted row.
■ Scroll across the Activities tab to view the columns information for the
activity. Any notes that were entered for an activity in the Oracle CRM
application appears in the modal window of the Activities tab.
2. When finished viewing activities, click another activity or interaction to view.

40.3 Viewing Activity Notes


Notes that have been entered for an interaction activity appear in the modal
window in the Activities tab.
Perform the following steps to view activity notes.

Prerequisites
A note must exist for the interaction activity in an Oracle CRM application.

Responsibility
Any type of end-user or non-administrative responsibility.

Navigation
Access the Notes window in the Activities tab.

Steps
1. Select the note to view.

Working with Forms-based Activities 40-3


Drilling Down on Reference Documents

2. When finished viewing the activity note, click another activity to view another
note or close the Interaction History window to exit from the activity view.

40.4 Drilling Down on Reference Documents


Perform the following steps to drill down on reference documents.

Prerequisites
■ A customer-agent interaction must exist in Interaction History.
■ The calling application has registered object in JTF_OBJECT and a parameter is
passed.

Responsibility
End user

Navigation
Navigate to the Activities tab.

Steps
1. Navigate to the Activities tab and click the activity to view or use the scroll bar
to scroll through the activities.
2. If a reference document exists for the activity, click the paperclip icon on the
toolbar.
The Attachment window opens and displays the related document.

40-4 Oracle CRM Application Foundation User Guide


41
Working with HTML Interactions

This chapter covers the following topics:


■ Searching Interactions
■ Viewing Interactions
■ Viewing Interaction Notes

41.1 Searching Interactions


You can search customer-agent interactions by identifying the appropriate search
criteria and filtering your search by customer, agent, campaign, date range, or
account number. Search interactions by choosing a combination of values.
Perform the following steps to search customer-agent interactions.

Prerequisites
A customer-agent interaction must exist in Interaction History.

Responsibility
End user

Navigation
Navigate to the Interactions window and click the Advanced Search hyperlink. The
Interactions Filtering Criteria window opens.

Steps
1. Enter any of the following criteria:
a. In the Customer field, enter the customer’s name.

Working with HTML Interactions 41-1


Viewing Interactions

b. In the Agent field, enter the agent’s name.


c. In the Campaign field, enter the campaign name.
d. In the Account field, enter the account name.
e. For the Date fields, select the Date Picker and enter your dates.
2. Click Go or Apply.
a. If you click Go, the Selection window opens with a list of hyperlinks. You
can then make your selection, which the Interaction Filtering Criteria
window reappears with your selection.
b. If you click Apply, the Interaction Search Results window opens a list based
on your defined parameters.

41.2 Viewing Interactions


Once you filter the interactions for viewing, the data associated to the interactions
appears in the Interactions window. Perform the following steps to view
customer-agent interactions.

Prerequisites
A customer-agent interaction must exist in Interaction History.

Responsibility
Any type of end-user or non-administrative responsibility

Navigation
Navigate to the Interactions window.

Steps
1. You can view a list of all interactions with the relevant criteria.
2. Close the window when you are finished.

See Also
■ Searching Interactions
■ Viewing Interaction Notes

41-2 Oracle CRM Application Foundation User Guide


Viewing Notes in Interaction History

41.3 Viewing Notes in Interaction History


Perform the following steps to view a note in Interaction History.

Prerequisites
A note must exist for the customer-agent interaction in a calling application.

Responsibility
End user

Navigation
Navigate to the Interactions window. Scroll to the right to see the Note Interactions
column.

Steps
1. If there is a note attached, click the note icon to view it.
2. When you have finished viewing the interaction note, click another interaction
to view another note or close the Interaction History window to exit from the
interaction view.

See Also
■ Searching Interactions
■ Viewing Interactions
■ Working with Forms-based Activities

Working with HTML Interactions 41-3


Viewing Notes in Interaction History

41-4 Oracle CRM Application Foundation User Guide


42
Working with HTML Activities

This chapter covers the following topics:


■ Searching Activities
■ Viewing Activities
■ Changing Profile Option

42.1 Searching Activities


You can search customer-agent interactions by activity. You can filter your search by
customer, agent, activity type, media type, date range, or account number and you
can also search activities by choosing a combination of search parameters. For
example, you can search for activities by activity type, customer, and date range.
Once you identify the search parameters, the filtered results appear in the Activities
tab in the Interaction History window. The search function is case sensitive.
Perform the following steps to search activities within customer-agent interactions.

Prerequisites
An activity must exist for the customer-agent interaction in Interaction History and
the Oracle CRM application.

Responsibility
Any type of end-user or non-administrative responsibility

Navigation
Navigate to the Interactions window. Since Interaction History is called by other
applications, the path will vary.

Working with HTML Activities 42-1


Viewing Activities

Steps
1. Click the Advanced Search hyperlink.
The Activities Filtering Criteria window opens.
2. Enter the criteria for searching activities in any of the following fields:
a. In the Customer field, enter the customer’s name.
b. In the Agent field, enter the agent’s name.
c. In the Activity Type field, enter the type of activity.
d. In the Media Type field, enter the type of media.
e. In the Date from and to fields, click the of values button in each field to
display the calendar. Click the date on the date picker from which to begin
the search.
You can also use wildcards.
3. If you entered criteria in one field and select Go, then the appropriate Select
window will open with a list of choices. Click on your choice.
The Activity Filtering Criteria window reappears populated with your
selection.
4. Click Apply.
The Activity window opens with your selection having limited the list of
activities.
5. Close the window when you are finished.

42.2 Viewing Activities


Activities performed for a customer-agent interaction in an Oracle CRM application
are viewed from the Activities window. Activity columns can include:
■ Customer
■ Agent
■ End Date
■ Direction
■ Source
■ Campaign

42-2 Oracle CRM Application Foundation User Guide


Viewing Activities

■ Outcome
■ Result
■ Reason
■ Action
■ Activity Type
■ Type
■ Role
■ Whether or not it is currently active or not
■ Any attached notes

Prerequisites
A customer-agent interaction must exist in Interaction History.

Responsibility
Any type of end-user or non-administrative responsibility

Navigation
Navigate to the Activities window. Since Interaction History is called by other
applications, the path will vary.

Steps
1. You can view a list of all interactions with the relevant criteria.
2. To narrow your search, use the list of values (LOVs) in the Media Type, Source,
Activity Type, or use the date picker to narrow the date range. Click Apply.
The results of your selection appears again in the Activities window.
3. Close the window when you are finished.

See Also
■ Searching Activities
■ Changing Profile Options

Working with HTML Activities 42-3


Changing Profile Options

42.3 Changing Profile Options


Use the Interaction History preferences to make changes to your profile. Perform
the following steps to modify your personal preferences.

Prerequisites
None

Responsibility
End user

Navigation
Click Profile in the top right corner of the window.
The Personal Preferences window opens.

Steps
1. In the Personal Preferences window, you can change your password on this
page as well as make other selections:
■ Navigation Preferences
■ Display Preferences
■ Quick Menu
■ Change Password
■ Personal Information
■ Address Information
■ My Enrollments
2. Under Personalization you can select the following:
a. Use the Navigation Preferences to switch Responsibility or Set Default
Responsibility.
b. Use the Display Preferences to make changes to language, user currency,
date format, display style, or table display.
c. Use the Quick Menu to set up your Favorite Menus.
3. Under Account Settings you can select the following:
a. Select Change Password to change your password.

42-4 Oracle CRM Application Foundation User Guide


Changing Profile Options

b. Select Personal Information to update your name or email.


4. Select Address Information to make changes to your address.
5. Select My Enrollments to make changes to your enrollments.
6. Click Update when you are done changing your preferences.
Your changes are saved.

Working with HTML Activities 42-5


Changing Profile Options

42-6 Oracle CRM Application Foundation User Guide


Part IX
1-to-1 Fulfillment

This part of the Oracle CRM Application Foundation User Guide contains the
following chapters:
■ Introduction to Oracle 1-to-1 Fulfillment
43
Introduction to Oracle 1-to-1 Fulfillment

This chapter covers the following topics:


■ Overview of Oracle Oracle 1-to-1 Fulfillment
■ Oracle Oracle 1-to-1 Fulfillment Integrations
■ What’s New in This Release
■ Terms and Definitions
■ Process Flow for Oracle Oracle 1-to-1 Fulfillment

43.1 Overview of Oracle 1-to-1 Fulfillment


Note: Oracle 1-to-1 Fulfillment is a module that is called from
other CRM applications. Although Oracle 1-to-1 Fulfillment contains
a published programming framework, it was initially designed to
be used within CRM only.

The following topics describe the function and purpose of Oracle 1-to-1 Fulfillment:
■ What is a Fulfillment?
■ Who Handles Fulfillments?
■ What is a Fulfillment Server?
■ What is a Query?
■ What are Datasource Files?
■ What Are Some Elements of Fulfillments?

Introduction to Oracle 1-to-1 Fulfillment 43-1


Overview of Oracle 1-to-1 Fulfillment

■ Faxing a Fulfillment Request


■ Previewing and Printing a Fulfillment Request
■ Redirecting the Finish Button
■ Using the Fetch SMTP Identifier

43.1.1 What is a Fulfillment?


Oracle 1-to-1 Fulfillment if a framework for compiling and distributing fulfillment
information to customers in electronic format. A fulfillment is an automated
method of sending information such as generic collateral or personalized cover
letters to customers. It provides the ability to immediately satisfy a customer’s
requests for information, literature, and other correspondence. Call center agents
handle a variety of requests ranging from product and service inquiries, pricing
questions, billing inquiries, and general customer care issues. Many of these
requests will result in some dissemination of literature, collateral, forms of
application, letters, or correspondence to the customer. Oracle 1-to-1 Fulfillment
provides the ability for call center administrators, mobile field representatives,
marketing managers, customer care representatives, and other service agents to
respond to different customer needs quickly and easily using email. Oracle 1-to-1
Fulfillment is also used by marketing groups to send marketing information to
customers. Fulfillment requests can also be generated by e-Commerce applications
that send information to customers with Web clicks.

Key Features
Oracle 1-to-1 Fulfillment contains the following key features:
■ Provides automated delivery of information to customers using email
■ Supports multiple types of customized fulfillments used in CRM applications
such as documents, and collateral
■ Prioritizes requests
■ Updates customer information through Interaction History
■ Merges data into formatted outgoing emails to create consistent personalized
messages

43-2 Oracle CRM Application Foundation User Guide


Overview of Oracle 1-to-1 Fulfillment

WARNING: Windows relating to file server functionality or


capability are not supported at this time, and should not be used.
These capabilities are enhancements intended for future releases,
but are not available in the current release of Fulfillment.

43.1.2 Who Handles Fulfillments?


Fulfillments are handled by agents whose roles range from representatives of a
customer service or support organization to sales and marketing team members.
Although they may serve different departments, agents share the common
requirement of disseminating information to customers in electronic format. A
customer service agent could use Oracle 1-to-1 Fulfillment to send customers
information in response to product and service inquiries, pricing questions, billing
inquiries, and general customer care issues. Similarly, a sales or marketing agent
could use Oracle 1-to-1 Fulfillment to send out information to prospective
customers including product announcements, newsletters, lead generation and
qualification campaigns. They can also use Oracle 1-to-1 Fulfillment as a mechanism
for distributing information through mass marketing campaigns, such as email
blitzes. Oracle 1-to-1 Fulfillment enables agents to focus on each customer’s unique
fulfillment requirements instead of spending time managing the fulfillment output
itself.

43.1.3 What is a Fulfillment Server?


Fulfillment servers are used to monitor fulfillment requests. Servers are created
with a name and a description and can include a start time and shut down time.
The start time and shut down time defines when the server monitors the queue for
requests. The start time and shut down time are not required values if you want the
fulfillment server to send requests 24 hours a day, seven days a week. These servers
monitor assigned queues and send out fulfillments for CRM applications such as
eMail Center, Customer Service, Marketing, TeleSales, Sales Online, and iSurvey.
A fulfillment server administrator or similar user type has the ability to create a
new server, update an existing server, or restore server attributes for an existing
server.

Example
You create a marketing fulfillment server that monitors queues for marketing
requests. You also create and attach a marketing email server to the marketing
server and define a marketing group of people that use the email server. Once this

Introduction to Oracle 1-to-1 Fulfillment 43-3


Overview of Oracle 1-to-1 Fulfillment

has been completed, Oracle 1-to-1 Fulfillment sends marketing campaign


information to customers by email when marketing applications submit a
fulfillment request.

43.1.4 What is a Query?


A query is a SQL statement that collects specific types of data from the database
when fulfilling a request. From the query window, you can create, update, or restore
queries, and you can create the files (datasource files) where the query results are
stored.
Queries are used for generating and populating data in master documents
dynamically. Dynamic information comes from the query and the associated bind
variables and the master document. The bind variables contain the data that is
required to process a fulfillment query. The bind variables correspond to the items
required by the query. These are generally items listed in the WHERE clause of the
SQL query.
For example, the bind variable for the SQL statement:
Select person_last_name lname from jtf_contact_points where person_first_name =
:fname

The first step in creating a query involves identifying the sources needed for the
query. Once you obtain the sources, the bind variables, then you can use the bind
variables, the SQL statement, and merge functionality to create your merged
document. If you want to associate a query with a master document (for example, if
there are merged fields to be populated with a query) select the query needed from
the list of values in the master document selection tab and select upload. This will
simultaneously upload the master document and associate the relevant query to the
master document.
A single query can be associated with more than one master document if the merge
field names match database column names and if there is a one-to-one
correspondence between the number of merge fields and the number of columns
queried. The query must be created for a particular master document before it is
uploaded into fulfillment. Ensure that the query string queries all merge fields that
must be populated in the master document.

43.1.5 What are Datasource Files?


You can create datasource files which display the names of the columns or the
names of the column aliases from a query. Datasource files provide a simple method
of pulling result set tokens into a master document. When using applications such

43-4 Oracle CRM Application Foundation User Guide


Overview of Oracle 1-to-1 Fulfillment

as Microsoft Word 2000, you can import a datasource file and then build a master
document around the tokens before saving the document as an HTML file.

43.1.6 What Are Some Elements of Fulfillments?


The following are key elements used in Fulfillments.
■ Groups
■ Templates
■ Master Documents
■ Merged Data

Groups
A group is any number of people or agents. For example, you may want to create
two groups of marketing personnel, one for marketing current customers and the
other for marketing prospective customers.
Agent groups are associated with the fulfillment server, and output devices such as
email servers are associated with the groups. By associating a group to an email
server, you indicate which group will use a specific email server. You must create an
association for each agent group to each output device for which the group needs
access. A server is associated to a group and an email server. Within each group,
you have agents that are assigned to that group.

Note: You should not associate a group with multiple servers or


agents with multiple groups.

Templates
Oracle 1-to-1 Fulfillment templates are used to assemble multiple types of collateral
into a single grouping. A template is a grouping of several documents and should
not be confused with a master document. For example, a template might contain, a
master document cover letter and all collateral associated with a specific topic.

Master Documents
Master documents can contain dynamic information or in some cases can be static
documents. In each case, master documents are used as cover letters.
A master document is a dynamic document which is created once and re-used,
through merging, many times. In order to merge data, master documents need to be

Introduction to Oracle 1-to-1 Fulfillment 43-5


Overview of Oracle 1-to-1 Fulfillment

HTML documents. They can be created in an HTML editor or a word processing


application as long as you save as HTML.

Note: If you want to have a query associated with a master


document, then before creating a dynamic master document, you
must identify the SQL query needed for the document. You must
follow standards SQL formatting since the application does not
perform SQL validation and will fail at runtime if it is invalid.

Additionally, master documents can also be static information. Perhaps you want to
create a master document and not use the dynamic functionality. Using the dynamic
functionality is not a requirement but is slower to process than collateral since it
requires token replacement validation. Dynamic content in master documents are
defined by merged fields. These are enclosed within special characters, for example,
<< >>. The only way to include dynamic content in a master document is to employ
merge fields. Merge fields are tokens that are replace by data when fulfillment
requests are processed.

Note: You cannot upload collateral in Fulfillment. You can only


upload a master document. Collateral is created by Marketing and
uploaded through the Marketing Online application. Marketing
also refers to collateral as "deliverables".

A master document contains text that is used repeatedly, such as a form or a


contract. You create master documents in a word processing application. A master
document can have one of the following extensions:
■ .zip
■ .html
Master documents saved in the .zip format contain HTML files. The Master
document’s image files are either stored on a Web server and accessed from links in
the HTML files, or they are packaged with the HTML files in the .zip file. Packaging
image files with HTML files eliminates the need for linking the HTML documents
to images on a Web server, but it also significantly increases processing time.

43-6 Oracle CRM Application Foundation User Guide


Overview of Oracle 1-to-1 Fulfillment

Note: For large batch files that require speed, it is recommended


that the HTML files contain links to images stored on a server
outside the firewall. This enables you to update the images without
reloading them in the .zip files and without modifying your calling
application’s software.

After creating a master document with the HTML editor of your choice, upload it to
make it available for fulfillment requests. When you upload a master document, it is
stored in the Marketing Encyclopedia System (MES).

Merged Data
Merged data is a specific chunk of data that is pushed to a master document. This
data can be derived from calling applications or from a query result set.

43.1.7 Faxing a Fulfillment Request


Currently Oracle 1-to-1 Fulfillment only facilitates the dissemination of fulfillment
information by email or fax. Oracle 1-to-1 Fulfillment has an open Java interface
framework that enables integration with other custom fax solutions.

Fax Customization
To make the interface vendor independent integration is required between the
Oracle 1-to-1 Fulfillment interface and an independent fax solution provider’s
framework. The integration requires writing Java code that associates the Oracle
1-to-1 Fulfillment code with a third parties’s framework.
If the fulfillment server receives a fax request and a fax solution is not implemented,
the server logs an error in the Server’s error log and writes to the database that it
was unable to fulfill the request. The consumer product that is integrating to 1-1
Fulfillment, must contain built in fax functionality. When this product sends a
request to the fulfillment server, it must designate it as a fax and include fax
numbers. The fulfillment server must contact the calling application, and the calling
application must be able to designate its communication as fax or to send a fax.

Introduction to Oracle 1-to-1 Fulfillment 43-7


Overview of Oracle 1-to-1 Fulfillment

Note: Contact Oracle Support directly if you are interested in


adding faxing capabilities to your E-business suite.

43.1.8 Previewing and Printing a Fulfillment Request


Oracle 1-to-1 Fulfillment has preview options that enable users to view or save
fulfillment requests. When you print a previewed fulfillment request, the request is
subsequently saved as an HTML file.
When you preview a request, the standard process of creating a request is
performed and the request is written to a database with a Preview flag, but it is not
sent to the customer. You can go to the Preview window to see the request, but you
cannot edit it.
The request is retrieved and appears in your default browser. You can perform
certain functions using the browser’s tool menu, such as, print the request, or save
the request in a local location. If you preview fulfillment requests, you proactively
prevent mistakes associated with sending out requests that are unchecked.
Previewed requests can only be viewed by clicking History within the Status tab of
the Fulfillment Administrative Console.

Example
A telesales agent receives a request for information on a sales promotion. She
creates a preview request for the customer and goes to the preview window to view
the request with the customer data already merged in the document. After verifying
the data for accuracy, she clicks on the Send Request button to send out the request
or prints out a hard copy and mails it to the customer depending on the preferred
output method.

43.1.9 Redirecting the Finish Button


In the Fulfillment Agent tabs in the Oracle Sales Online application, you can select a
template and then select master documents, collateral, and attachments associated
with the template before confirming the fulfillment request. If you select the Finish
button on the Confirmation window, you will reopen the first window of the
wizard.
To enhance the flexibility of the wizard, Oracle 1-to-1 Fulfillment added a new
profile option called JTF_FM_DONE_DEST which allows you to redirect the Finish
button to a specific destination which is determined by the application that is using
the Oracle 1-to-1 Fulfillment module. This profile option resides within the calling

43-8 Oracle CRM Application Foundation User Guide


Oracle 1-to-1 Fulfillment Integrations

application’s setup profile. The valid values of the destination depend upon the
calling application to Fulfillment. If no profile is set, the Finish button will
automatically take you back to the beginning of the Fulfillment Wizard screen.
For documentation on how to set up the Finish button, refer to the implementation
information of the calling application.

43.1.10 Using the Fetch SMTP Identifier


This feature requires the calling application to provide set up folders and login
information. It must also make a direct connection to the email server and provide
account information.
Oracle 1-to-1 Fulfillment can create email messages. Each message has an identifier
which is called a SMTP ID. The SMTP ID can be retrieved and stored as part of an
interaction activity in the Interaction History module. The fulfillment server will
fetch the SMTP ID for outgoing emails that are sent directly through the SMTP
connection.

43.2 Oracle 1-to-1 Fulfillment Integrations


Oracle 1-to-1 Fulfillment is widely used by various Oracle modules across CRM.
■ E-mail Center uses Oracle 1-to-1 Fulfillment to create fulfillment requests that
deliver automated responses to inbound e-mail messages. Additionally, e-mail
Center delivers personalized fulfillments to customers.
■ TeleService (Customer Support) uses Oracle 1-to-1 Fulfillment to respond to
customer needs by sending fulfillments.
■ Sales Online, Marketing Online and Telesales use Oracle 1-to-1 Fulfillment to
send sales and marketing related collateral, fulfillments, and campaign material
to prospective customers.
■ Scripting uses Oracle 1-to-1 Fulfillment to dispatch customer surveys that
capture customer needs, facilitate market research and measure customer
satisfaction.
■ When sending a fulfillment request, CRM applications call the Oracle 1-to-1
Fulfillment framework stored in the Oracle Database.
■ The fulfillment server prioritizes requests, and then updates the customer
information through the Interaction History module. It also retrieves master
documents previously created and stored in the Marketing Encyclopedia

Introduction to Oracle 1-to-1 Fulfillment 43-9


What’s New in This Release

System (MES). This material is packaged together and stored in the fulfillment
server and is subsequently sent to customers by e-mail.

43.3 What’s New in This Release


This release of CRM Application Foundation has new features subsequent to the
11.5.6. release for 1-to-1 Fulfillment.

General Page for Servers Contains New Interaction History Fields


The General pages for servers (accessed by creating or editing a server) contains the
following new Interaction History fields:
■ Request Outcome
■ Request Success Result
■ Request Failure Result

43.4 Terms and Definitions


The following table describes fulfillment terms and definitions.

Table 43–1 Fulfillment Terms and Definitions


Term Description
Agent or User An agent or user is the person who initiates a fulfillment
request from within a CRM application. Agents or users
usually interact directly with customers, either on the phone
or in person. In Web-based self-service applications, a
customer or prospect may be the requesting agent.
Attachment An attachment is a document that has been generated by
another application and included as part of a fulfillment
request. Attachments enable information such as bank account
activity, service request status, credit information, or invoices
to be sent to a customer. Attachments are static documents
which are stored in the FND_LOBS table and are not
necessarily associated with marketing or MES.
Collateral Collateral is a static fulfillment document that does not contain
merged data. It is usually some sort of marketing brochure or
some other document. It is sent in an email as an attachment.
It is often called a deliverable in the Oracle Marketing
applications.
Customer A customer is an individual who receives a fulfillment request.

43-10 Oracle CRM Application Foundation User Guide


Terms and Definitions

Table 43–1 Fulfillment Terms and Definitions


Term Description
Detail Screen A Detail screen displays information about a specific open
request, campaign, or output device.
Engine See Fulfillment Server
Fulfillment Administrator A fulfillment administrator is a person at a management level
who is responsible for creating and managing fulfillment
functions.
Fulfillment The console is used to configure fulfillment servers, group,
Administrative Console templates, queries, and locate request statuses and histories.
Fulfillment Agent The agent’s windows is set of agent Java Server Pages (JSPs)
Windows that are provided to CRM applications for creating basic
fulfillment requests.
Fulfillment Request A fulfillment request is the entity that is created when a
request is passed to the fulfillment engine. If a request is
successful, then an email is generated containing the requested
information and sent to the designated recipient.
Fulfillment Server The fulfillment server is a Java-based multi-threaded server,
that processes requests, merges data into master documents,
dispatches final output, and logs completed request in the
History table, as well as, writes to Interaction History tables if
the Party ID is passed.
Fulfillment Server The fulfillment server has a set of internal monitors each with
Monitors a specific task to ensure proper functioning of the fulfillment
server, including: Process Monitor, Request Monitor,
Command Monitor, Remote Monitor, Database Monitor, and
Schedule Monitor.
Process Monitor Its function is to monitor the states of the internal Server
Processes that run the fulfillment requests. This monitor
makes sure that the correct number of Processes are allocated
for performing work on the internal request queue.
Request Monitor Its function is to monitor the Advance Queue (AQ) for
incoming fulfillment requests and places them, in a
self-limiting fashion, into an internal request queue where
they can be fed into the Processes.

Introduction to Oracle 1-to-1 Fulfillment 43-11


Terms and Definitions

Table 43–1 Fulfillment Terms and Definitions


Term Description
Command Monitor Its function is to monitor commands received from the
command prompt provided that the fulfillment server is
configured so that commands can be received. The latest
version of the fulfillment server has this feature automatically
turned on. It can be turned on and off by placing the flag
'-Dengine.CommandPromptEnabled=true/false' in the
fulfillment server start script
Remote Monitor Its function is to monitor commands received through the
fulfillment server’s command port. This port is set in the
fulfillment server start script with the flag
'-Dengine.CommandPort=#####'. Without this command port,
this monitor will not run.
Database Monitor Its function is to monitor database activity following a
database crash or disconnect from the database. This monitor
temporarily shuts down the fulfillment server into a sleep
mode until connection to the database can be re-established.
Schedule Monitor Its function is to monitor the configured activity schedule for
the fulfillment server. The fulfillment server can be configured
for active and inactive scheduling throughout a day. When it is
scheduled to be inactive, the fulfillment server enters a sleep
state until the beginning of the next activity period. This
monitor only runs if the fulfillment server has been configured
with a startup time and shutdown time in the Fulfillment
Administration Console.
Group A group is a set of agents or users usually related by a
workgroup, function or department. Each user must belong to
at least one group. These groups are associated with a
fulfillment server.
Integration Points Oracle 1-to-1 Fulfillment integrates with other application
products through a framework included with the core
fulfillment product.
Items Items can be master documents, collateral, or attachments.
Items are inserted in the body of an email. Items are selected
from the list of all possible documents and collateral material
available to the user from fulfillment templates.
Master Document A master document is a static or dynamic HTML, or zip file
that contains HTML documents and image files.

43-12 Oracle CRM Application Foundation User Guide


Process Flow Oracle 1-to-1 Fulfillment

Table 43–1 Fulfillment Terms and Definitions


Term Description
Merged Data Merged data is a the specific chunk of data that has been taken
from several sources and merged together. For example, if a
company wants to send a thank you email to everyone that
has inquired about their company, the resulting merged data is
the query retrieving all customers that have inquired about the
company.
Output The output is the delivery medium of a fulfillment request.
Currently, only email is supported.
Prospect A prospect is a person who is a candidate to purchase a
product or service.
Query A query is a SQL statement or list created by the administrator
(or an external other) that is used to merge specific data with a
master document. Queries can be used for batch lists, mass
mailings, or mail blitzes.
Summary Window Summary windows contain lists of things such as all open
fulfillment requests, all available campaigns, or all output
devices on a server.
Template A template is an email package containing electronic
brochures, newsletters, or other customer-oriented
information that an agent sends to customers in response to a
request for information. For example, an agent may use a
specific template that contains a thank you letter and a
brochure of the company.

43.5 Process Flow Oracle 1-to-1 Fulfillment


Oracle 1-to-1 Fulfillment process flows generally follow the steps in the
following table. These process flows may vary, however, depending on how
Oracle 1-to-1 Fulfillment is integrated with your application. The following
table describes the order and process of using Oracle 1-to-1 Fulfillment.

Introduction to Oracle 1-to-1 Fulfillment 43-13


Process Flow Oracle 1-to-1 Fulfillment

Table 43–2 Fulfillment User Process


Step Description Required Performed By
Preview and Print a You can preview and print a fulfillment Request No Fulfillment
Request before sending it out. Administrator,
End user
Update a Template You can change the name, status, or description of a No Fulfillment
template. Administrator,
End user
Check a Request Status You can check the status of a request. No Fulfillment
Administrator,
End user

43-14 Oracle CRM Application Foundation User Guide


Part X
Escalation Management

This part of the Oracle CRM Application Foundation User Guide contains the
following chapters:
■ Introduction to Oracle Escalation Management
■ Overview of Using Oracle Escalation Management
■ Overview of Reactive Escalations: Escalation Manager
■ Overview of Proactive Escalations: Business Rule Monitor
■ Using Escalation Manager
44
Introduction to Oracle Escalation
Management

This chapter covers the following topics:


■ Overview of Oracle Escalation Management
■ What’s New in This Release
■ Oracle Escalation Management Integrations
■ Process Flow for Oracle Escalation Manager
■ Terms and Definitions

44.1 Overview of Oracle Escalation Management


A company, using Escalation Management, can reprioritize, reassign, and monitor a
situation to a satisfactory completion. There are two types of escalations: reactive
and proactive. Each are discussed in the subsequent sections. Escalation Manager is
the "reactive" end of Escalation Management. The Business Rule Monitor (BRM) is
the "proactive" escalation process. The following can be escalated in either modules:
■ A task
■ A service request
■ A defect
The following sections describe an escalation.
■ What is an Escalation?
■ What is a Reactive Escalation?
■ What is a Proactive Escalation?

Introduction to Oracle Escalation Management 44-1


Overview of Oracle Escalation Management

■ What Are Some of the Features of an Escalation?

44.1.1 What is an Escalation?


An escalation is actually a process used to highlight or flag certain issues within an
organization, so that the appropriate personnel can respond to these situations and
monitor the resolutions. Escalations occur in support centers for a variety of
reasons. An escalation management system allows an organization to identify, track,
monitor, and manage situations that require increased awareness and swift action.
In a reactive escalation, a customer calls and reports a problem and you must react
to it and resolve the issue. In a proactive escalation, you notice a potential issue and
you resolve it before the customer contacts you. In other words, did you catch a
potential problem before a customer complained? The following sections describe
each type of escalation in greater detail.

44.1.2 What is a Reactive Escalation?


In a reactive escalation, a business must take the necessary action to resolve a
situation. Most businesses want to track issues such as: which customer
complained, when the complaint was logged into the system, who was assigned to
fix the problem, was the problem fixed or did it need to be manually assigned to
someone else, and is the problem finally resolved.

Example
Business World, a customer of Vision Corporation, complains that a hardware
problem reported one week ago is still not completely repaired. Vision Corporation
assigns different resources, that are more experienced, to handle this hardware
problem immediately. Manually assigning escalation resources is possible through
the Escalation Manager.

44.1.3 What is a Proactive Escalation?


A company that values great customer service may implement systems that
monitor situations alerting them before a crisis occurs. What criteria do they use for
monitoring these situations? Usually, this is based on established business rules of
the company. However, proactive escalation can also be set up as a follow-up action.

Example
Vision Corporation wants to enforce the rule that any open task must be closed
within five business days. If it has been four days since the task is opened, then the

44-2 Oracle CRM Application Foundation User Guide


What’s New in This Release

owner of this task must send an e-mail to the assignee as a reminder and also check
if any assistance is needed. The Business Rule Monitor (BRM) is used to raise
awareness. It provides a centralized place to define and monitor business rules on a
regular basis.
Vision Corporation has also set up a business rule that seven days after closing a
service request, it will send an e-mail to verify that the customer is satisfied and
thanks them for doing business with them.

Note: In summary, a proactive escalation is usually initiated by


the Business Rule Monitor (BRM) system based on business rules.
Therefore, it is considered an automated escalation. A reactive
escalation is primarily initiated by a person in response to
customer’s needs. Therefore, it is considered a manual escalation.

44.1.4 Escalation Features


The following are some features of Escalation Management:
■ Escalation situation tracking information
■ Service Request, task, and defect linking capability
■ Ownership assignment
■ Resolution plan definition with associated tasks and notes
■ Automatic notification of escalation progress to identified contacts
■ De-escalation and closure
Basic information is captured in an escalation document which includes the
requester, the required resolution date, and additional contacts that are involved.
An escalation is managed by creating an escalation document, assigning an
escalation owner, defining the actions needed to resolve the escalation, and
communicating the progress. Once a situation is de-escalated, the escalation closure
note is captured and a final communication is sent to the contacts involved.

44.2 What’s New in This Release


Group owners can now be enabled in this release of Escalation Manager.

Introduction to Oracle Escalation Management 44-3


Oracle Escalation Management Integrations

44.3 Oracle Escalation Management Integrations


Escalation Manager
■ Trading Community Architecture (TCA) information, such as business
contacts, is pulled into escalated documents.
■ Oracle Quality Online (OQO) is where defects are created and they can
manually be escalated through Escalation Manager.
■ Service Request is where service requests are created and they can manually be
escalated through Escalation Manager.
■ Oracle Workflow is used to send out workflow notifications to relevant
resources when an escalation document is created or updated.
■ Territory Manager is used to automatically retrieve qualified resources
identified in the escalation territories as the owner of an escalation document
when using Assignment Manager with territory assisted assignment option.
■ Task Manager (Forms-based) is used to attach additional tasks to an escalation
document. Tasks created in Forms can also be manually escalated through
Escalation Manager.
■ Assignment Manager is used to automatically assign a qualified resource
identified in the escalation territories as the owner of an escalation document.
■ Notes (Forms-based) is used to attach additional notes information to an
escalation document.

Business Rule Monitor (BRM)


■ Oracle Quality Online (OQO) is where defects are created and they can
automatically be escalated through BRM.
■ Service Request is where service requests are created and they can
automatically be escalated through BRM.
■ Oracle Workflow is used by the seeded workflow processes to send out
workflow notifications to relevant document owners.
■ Territory Manager is used to retrieve qualified resources identified in the
escalation territories if the identity of a person who receives notifications
defined in the Workflow Attributes window cannot be determined.
■ Task Manager is used by the seeded workflow processes to create an
automated escalation task. This is generally through the seeded Automated

44-4 Oracle CRM Application Foundation User Guide


Terms and Definitions

Escalation Template Group for Task Manager (Service Request or Defect


Management) defined in the Forms-based Task Manager. Tasks created in
Forms can also be automatically escalated when a business rule is violated.

44.4 Process Flow for Oracle Escalation Manager


The following table describes the order and process of using Escalation
Manager.

Table 44–1 Escalation Manager User Process


Step Description Required Performed By
Manage a Service A service request is a document that tracks Yes All Users
Request information regarding a customer’s product and
service problems.
Manage a Task A task is a document that tracks work to be done by a Yes All Users
Escalation support center.
Manage a Defect A defect is a document which tracks product Yes All Users
Escalation problems and resolutions. This is escalated through
Oracle Quality Online.
Add a Note to an Notes allow additional information to be attached Optional All Users
Escalation Document with the escalation document.
Add a Task to an Use an attached task to document any follow-up Optional All Users
Escalation Document activity or possible resolution for the escalation.
Changing an Escalation Manually changing an escalation status generates a Yes All Users
Status notification to the designated contacts.

44.5 Terms and Definitions


The following table describes Escalation Management terms and definitions.

Table 44–2 Escalation Management Terms and Definitions


Term Description
BRM module The Business Rule Monitor (BRM) provides a User Interface
(UI) and functionality that an organization can use to
proactively manage escalations. It consists of two components:
■ Business Rule Monitor
■ Business Rule Workbench

Introduction to Oracle Escalation Management 44-5


Terms and Definitions

Table 44–2 Escalation Management Terms and Definitions


Term Description
Business Rule Monitor The Business Rule Monitor is the engine that monitors
documents over a period of time against the user-defined
business rules.
Business Rule Workbench It is used to define a business rule.
Customer Relationship A customer relationship escalation is an escalation document
Escalation that escalates multiple support requests, defects, or tasks.
Defect A defect is a document that tracks product problems and
resolutions. A defect can be escalated without an associated
service request. It is escalated in the HTML-based application
Oracle Quality Online (OQO), formerly known as the Defect
Management System.
Escalation An escalation is the increase in the focus and process required
to successfully complete a task and its associated components
such as documents.
Owner An escalation owner is the employee or group resource
responsible for managing an escalated task or document.
Escalation Plan An escalation plan is a series of follow up tasks that are
attached to the escalation document.
Escalation Territory An escalation territory is a territory that provides the resources
responsible for managing an escalation.
Reference Document A reference document is a document that is linked to an
escalation document.
For example, a service request (number 9229) is escalated to
Jane Doe in escalation document (number 11749), This service
request (number 9229) is a reference document.
Reference Type A reference type specifies whether or not a reference
document is escalated or used to provide additional
information.
Service Request A service request is a document that tracks information about
a customer’s product and service problems.
Workflow Workflow defines what actions occur if a business rule is
violated. There are two workflows: Oracle Workflow and the
BRM workflow.
Workflow Attributes Workflow attributes set the variable parameters. They control
the behavior of the workflow.

44-6 Oracle CRM Application Foundation User Guide


Terms and Definitions

Table 44–2 Escalation Management Terms and Definitions


Term Description
Workflow Monitor Workflow Monitor is a Java-based tool used for administering
and viewing workflow process.

Introduction to Oracle Escalation Management 44-7


Terms and Definitions

44-8 Oracle CRM Application Foundation User Guide


45
Overview of Using Oracle Escalation
Management

This chapter covers the following topics:


■ Accessing the Oracle Escalation Manager Interface
■ Summary of Oracle Escalation Management Tasks

45.1 Accessing the Oracle Escalation Manager Interface


There are several ways to access Escalation Manager. Typically, you would access
Escalation Manager through a task or service request that you want to escalate. In
general, service requests, tasks, and defects can be escalated. Use Oracle Quality
Online (OQO), formerly known as Defect Enhancement Management System
(DEMS) to create and escalate a defect.
■ Log in using the CRM Administrator responsibility, for setting up tasks. Use the
Forms-based Task module to escalate a task.
■ You can access Escalation Manager through a task, defect, or service request
that you want to escalate.

Administrative Path
To access the administrative tasks indicated through the Forms-based CRM
Administrator responsibility, select Task and Escalation Manager > Setup.
Escalation administrative tasks are defined in the Form from Define Escalation
Reason to Define Reference Type.

Overview of Using Oracle Escalation Management 45-1


Summary of Oracle Escalation Management Tasks

General Usage Path


Search for a task (or defect or service request) then use the following navigation
path to invoke Escalation Manager:
■ From a stand-alone task in the Forms-based Task Manager: Tools > Manage
Escalation
■ From a service request: Tools > Request Escalation
■ From a service request: Tools > Task Escalation
■ From the CRM Administrator responsibility: Task and Escalation Manager
> Manage Escalations
■ From a defect HTML window, select the Escalation button for defect
escalation. See Oracle Quality Online documentation for details on how to
escalate a defect from the application.

45.2 Summary of Oracle Escalation Management Tasks


Use Oracle Escalation Management to perform the following types of tasks:
■ Chapter 49, Reactive Escalations: Escalation Manager
■ Chapter 50, Proactive Escalations: Business Rule Monitor
■ Using Escalation Manager

45-2 Oracle CRM Application Foundation User Guide


46
Overview of Reactive Escalations:
Escalation Manager

This chapter covers the following topics:


■ What is the Escalation Manager
■ Workflow Notifications
■ Escalation Territories

46.1 What is Escalation Manager?


You can manually escalate a business problem to the appropriate level where it can
be solved in Escalation Manager. It has a user interface (UI) where you can manage
situations that require awareness and possible actions. An escalation is managed
either by creating an escalation document, or by assigning an escalation owner, or
by defining the actions needed to resolve the escalation.

Example
Lorraine Abbott, a support agent for Vision Corporation, receives a call from Cindy
Miller, a primary contact for Business World, complaining that their hardware
problems are not completely fixed. Lorraine finds the service request, creates an
escalation document, and also reassigns herself as the owner for this document. In
addition, Lorraine can also utilize the following features in this escalation
document:
■ Escalation level: Specify the degree of urgency for this escalation.
■ All relevant documents: Link the relevant documents to this escalation, such as
link the service request in this document.

Overview of Reactive Escalations: Escalation Manager 46-1


Workflow Notifications

■ Relevant contacts: Identify the employee and customer contact information,


such as Lorraine Abbott and Cindy Miller.
■ Notes: A note can be created about Lorraine’s contact number if the assignee
needs to contact her while she is on vacation.
■ Tasks: A task can be created, such as a update meeting with her manager.

46.2 Workflow Notifications


Notifications are an integral part of the Escalation functionality. Oracle Workflow is
used to process and deliver the notifications regarding the escalation activity.
Notifications are sent for the following reasons:
■ Escalation creation
■ Escalation status changes
■ Escalation owner assignment changes
■ Escalation level changes
■ Escalation target date changes
Notifications are sent to people (employees or customers) that are identified on the
Contacts tab, and for which the Notify Check Box is selected.
Typical recipients include:
■ Owner of the object (Service Request, Task, or Defect) that is being escalated
■ Human Resource (HR) manager of the owner of the Escalation document
■ Owner of the Escalation document

46.3 Escalation Territories


An escalation territory provides the resources responsible for managing escalations.
Use Escalation territories to define the escalation path with appropriate resources
which the escalation owner identified for the territory in the event of exceptions. In
case of automatic assignment by using an escalation territory, the Assignment
Manager is used in conjunction with the Territory Manager. The escalation can be
automatically assigned to an owner if the escalated document (such as a service
request, tasks, or defect) has an escalation territory defined.
You can create alternate escalation territories to automatically reassign a service call
when certain conditions are not met.

46-2 Oracle CRM Application Foundation User Guide


Escalation Owners and Owner Types

a. A service team assigned to a repair does not take action within five business
days, so now that repair can be assigned automatically to another group.
b. A service engineer cannot successfully resolve a request within a certain
time frame, which is set up in the Business Rule Monitor (BRM), so now the
service request will be automatically escalated to another resource.
Ensure that you have a resource assigned to an Escalation territory. The Escalation
territory can be a catch all for all escalations.

46.4 Escalation Owners and Owner Types


Each escalation must be assigned an owner and this owner must be a specified
owner type.

46.4.1 Owners
An escalation owner is a person who manages an escalated task, or document. Once
a task or document is escalated, the responsibility for either one is transfered from
the original owner to the escalation owner. For example, a suppport service center
can assign a defect to an employee resource, John Smith. If John Smith fails to
correct the defect the support service center can escalate the defect and assign
another employee resource, Rhonda Abott as its escalation owner. When this occurs,
the original owner, John Smith is no longer responsible for the defect.

46.4.2 Owner Types


An escalation owner can be an employee resource or a group resource. When an
escalation is owned by a group, any member of that group can manage the
escalation.

See Also
View the following topics in Territory Manager for additional information:
■ Basic Territory Building Blocks
■ Creating Escalation Territories

Overview of Reactive Escalations: Escalation Manager 46-3


Escalation Owners and Owner Types

46-4 Oracle CRM Application Foundation User Guide


47
Overview of Proactive Escalations:
Business Rule Monitor

This chapter covers the following topics:


■ What is a Business Rule?
■ What is the Business Rule Monitor?
■ Workflow and Workflow Attributes
■ Resource Types
■ General Tips for Defining Rules

47.1 What is a Business Rule?


A business rule is a user-defined condition. When the condition is not met, the rule
triggers a workflow process. The process is enforced by the business rule owner.
A business rule can be as simple as "A service request cannot be left open for more
than two days." This rule can be defined according to an organization’s needs or an
agreement between its customers.

Example
Vision Corporation, a service organization, is eager to provide efficient customer
service, so the Service Department Director for Vision Corporation, defines a
business rule based on the company’s goal. This rule is that if a task with a high
priority is open for four hours, then the task owner should be notified to proactively
manage potential issues. Effective immediately, the director is the owner of this
business rule as he is responsible for any future updates and necessary
confirmation.

Overview of Proactive Escalations: Business Rule Monitor 47-1


What is the Business Rule Monitor?

Additional examples include:


■ A service request is assigned within half an hour. Otherwise, the owner of this
request receives a warning notification.
■ A task with a high priority is closed within two days. Otherwise, a manager
investigates why it cannot be done within that time frame.
■ An open defect is closed within three business days. Otherwise the assignee
should meet with her manager one day prior to the due date to discuss possible
solutions to this defect.

47.2 What is the Business Rule Monitor?


The Business Rule Monitor (BRM) provides a User Interface (UI) and functionality
that an organization uses to proactively manage escalations. It consists of two
components:
■ Business Rule Workbench: used to define a business rule.
■ Business Rule Monitor: the engine that monitors documents over time against
the user-defined business rules.
The BRM module integrates with Oracle Workflow to provide possible action taken
if the condition defined in the rules is not met.

Note: The functionality of BRM is not limited to only detect


potential problems. It can also be used as a reminder of positive
reinforcement, such as to remind employees of a company’s annual
events or an employee’s birthday.

47.3 Workflow and Workflow Attributes


When defining your rules, you must also specify the workflow information for
actions that can occur when the rule is violated. There are four seeded workflow
processes:
■ Notification Only
■ Create a Task Only
■ Notification and Create Task
■ Escalated Object

47-2 Oracle CRM Application Foundation User Guide


Workflow and Workflow Attributes

47.3.1 Notification Only


An Oracle Workflow notification is sent. The person who receives this notification
selects from the Value field in the Workflow Attributes window. Click the "..."
button to display this attributes window.

47.3.2 Create a Task Only


An automated escalation task is created. This is generated through the seeded
Automated Escalation Template Group for Task Manager (Service Request or Defect
Management.) The owner and assignee of this task select from the Value field in the
Workflow Attributes window.

47.3.3 Notification and Create Task


In addition to the sent workflow notifications, an automated escalation task is also
created. The owner and assignee of this task are specified in the Value field.

47.3.4 Escalated Object


An escalated document is created. The owner of this escalated document can be
specified in the Value field. The selection in the Value field can be a document
owner, the document owner’s Human Resource manager, an escalation territory
primary contact, or the business rule owner. If this value is not specified, it defaults
to the business owner.

Note: The selection in the Value field can be document owner,


document owner’s HR manager, escalation territory primary
contact, and business (rule) owner. If this value is not specified, it
defaults to the business owner.
If the unassigned option is selected in the Automated Escalation
Notification Task Assignee Role field in the Workflow Attributes
window, then the task that is created has no assignee, but it has an
owner specified because you cannot find the unassigned option
from the List of Values in the task owner role field.

47.3.5 Workflow Attributes


In addition to the Workflows which provide standard escalation activities, each of
the seeded Workflow processes has its own Workflow attributes, which can be

Overview of Proactive Escalations: Business Rule Monitor 47-3


Workflow and Workflow Attributes

accessed in the Business Rule Workbench window. The value chosen for each
attribute is saved as part of the Business Rule and allows you to control the
behavior of the escalation activity for that rule.
Workflow attributes in the Business Rule Monitor seeded workflows are specific to
the workflow process. The following table lists each seeded workflow process, the
attributes it has, the meaning of that attribute, and possible values. Attributes are
the same regardless of whether or not the Workflow is for a task, defect, or service
request.

Table 47–1 Workflow Attributes Defined


Workflow
Name Attribute Meaning Possible Values
Send Automated Escalation Send the notification to the ■ Business Owner
Notification Notification Role person who fulfills the role
■ Document Owner
indicated by the value
selected. ■ Document Owner’s HR
Manager
■ Escalation Territory Primary
Contact
Create Task Automated Escalation Assign the task to the person ■ Business Owner
Notification Task who fulfills the role indicated
■ Document Owner
Assignee Role by the value selected.
■ Document Owner’s HR
Manager
■ Escalation Territory Primary
Contact
■ Unassigned
Create Task Automated Escalation The task owned by the ■ Business Owner
Notification Task person who fulfills the role
■ Document Owner
Owner Role indicated by the value
selected. ■ Document Owner’s HR
Manager
■ Escalation Territory Primary
Contact
Create Task Automated Escalation The template that is used to Any Task Template
Task Template create the task.

47-4 Oracle CRM Application Foundation User Guide


Resource Types

Table 47–1 Workflow Attributes Defined


Workflow
Name Attribute Meaning Possible Values
Send Automated Escalation Send the notification to the ■ Business Owner
Notification and Notification Role person who fulfills the role
■ Document Owner
Create Task indicated by the value
selected. ■ Document Owner’s HR
Manager
■ Escalation Territory Primary
Contact
Send Automated Escalation Assign the task to the person ■ Business Owner
Notification and Notification Task who fulfills the role indicated
■ Document Owner
Create Task Assignee Role by the value selected.
■ Document Owner’s HR
Manager
■ Escalation Territory Primary
Contact
■ Unassigned
Send Automated Escalation The task owned by the ■ Business Owner
Notification and Notification Task person who fulfills the role
■ Document Owner
Create Task Owner Role indicated by the value
selected. ■ Document Owner’s HR
Manager
■ Escalation Territory Primary
Contact
Send Automated Escalation The template that is used to Any Task Template
Notification and Task Template create the task.
Create Task
Escalate Object Automated Escalation The escalation document ■ Business Owner
Document Owner owned by the person who
■ Document Owner
Role fulfills the role indicated by
the value selected. ■ Document Owner’s HR
Manager
■ Escalation Territory Primary
Contact

47.4 Resource Types


A document owner can be of any resource type other than an employee resource.
Some examples of other types of document owners are: parties or partners and
supplier contacts. Since the automated escalation can happen to the document

Overview of Proactive Escalations: Business Rule Monitor 47-5


Resource Types

owner of any resource type, the person who will receive the notifications is
determined as follows:

Document Owner
The Document Owner is selected as the value in the workflow attributes.
■ If the document owner type is an employee resource, then the document owner
will receive notifications.
■ If the document owner resource is of any other type, then the primary contact
with the employee resource type in the escalation territory is used. If there is no
resource that satisfies this criteria, then the primary contact with the employee
resource type in the catch-all territory is used. Again, if there is no resource that
satisfies this criteria, then the Business Rule Owner is used because the business
rule owner is guaranteed to be an employee resource.

Document Owner's HR Manager


The Document Owner's HR Manager is selected as the value.
■ If the document owner is an employee resource, then the notification is sent to
the HR manager of that resource. If there is no resource that satisfies this
criteria, then the primary contact with the employee resource type in the
escalation territory is used. Otherwise, the primary contact with the employee
resource type in the catch-all territory is used, and then the Business Rule
Owner is selected.
■ If the document owner resource is a group resource, then the notification is sent
to the first employee resource within the resource group who has a manager. If
there is no resource that satisfies this criteria, then the primary contact with the
employee resource in the escalation territory is used. Otherwise, the notification
is sent to the primary contact with the employee resource in the catch-all
territory, and then the Business Rule Owner.
■ If the document owner resource is of any other type other than employee or
group resources, then the same rule is used: the primary contact with the
employee resource type in the escalation territory, then the primary contact
with the employee resource type in the catch-all territory, and then the Business
Rule Owner.

Escalation Territory Primary Contact


The Escalation Territory Primary Contact is selected as the value.

47-6 Oracle CRM Application Foundation User Guide


General Tips for Defining Rules

■ The notification is sent to the primary contact with employee resource in the
escalation territory.
■ If there is no resource that satisfies this criteria, then the notification is sent to
the primary contact with employee resource in the catch-all territory. Otherwise,
the Business Rule Owner receives the notification.

47.5 General Tips for Defining Rules


The following suggestions are helpful when defining rules in the BRM:
■ The condition should not reflect an absolute state. Otherwise, the monitor will
keep detecting the same objects and acting upon them; you may have repeated
notifications sent.
■ Use reasonable check intervals. The check interval also determines the
notification interval. So, if you check a rule every two minutes, notifications are
sent every two minutes.
■ Take loop time into consideration. If the main scan cycle is set to run every ten
minutes, then there is no point in setting the check frequency to two minutes.
■ Even in a simple rule, SQL syntax applies. You can use SQL functions, but you
also have to use quotes around your character values. Also use IS NULL and IS
NOT NULL instead of =NULL and <>NULL.
■ Verify that the view does what you intended for it to do. The simplest way to
do this is to cut and paste the view definition from the Complex tab into a SQL+
session.
■ Check the performance of the view. Do a Select from your view. If it takes a
long time to return the values, then ask a SQL expert for assistance.

Guidelines
Refer to the chapter "Verify the Implementation" to see additional details on
troubleshooting the Business Rule Monitor.

Overview of Proactive Escalations: Business Rule Monitor 47-7


General Tips for Defining Rules

47-8 Oracle CRM Application Foundation User Guide


48
Using Escalation Manager

This chapter covers the following topics:


■ Creating Escalations
■ Creating a Document Whose Owner is a Group
■ Managing a Service Request Escalation
■ Managing a Task Escalation
■ Managing a Defect Escalation

48.1 CreatingEscalations
An escalation is initiated by a person using a service channel (telephone, web, or
e-mail). An escalation can also be initiated by the system based on pre-defined rules
that are established to monitor business situations.
To initiate an escalation, you must:
■ Accept a request for an escalation
■ Review the situation
■ Create an escalation document
■ Notify the involved parties (this is performed automatically)
An escalation request can be initiated on behalf of a customer, an employee, or other
involved party. Perform the following steps to create an Escalation document.

Prerequisites
A task, defect, or service request exists.

Using Escalation Manager 48-1


CreatingEscalations

Responsibility
CRM Administrator

Navigation
Navigate to the Escalations window.

Steps
1. If the Escalation Manager is launched directly from a service request, task, or
defect, then the customer information should be populated automatically.
Otherwise, manually enter it. If you open the Escalation Manager as a
stand-alone application, from the CRM Administrator responsibility, select Task
and Escalation Manager > Manage Escalations.

Note:
■ Status, reason, escalation level, and reference type information
is set up during the implementation process.
■ You must have the appropriate information entered into the
Reference Documents and Contacts tab before you can assign
an owner.

2. Enter the customer’s name and number.


3. Select the Reference Documents tab.
a. Enter all relevant information if it has not already been automatically
populated in the Type field.
b. Enter all relevant information if it has not already been automatically
populated in the Document and Details fields.
4. Select the Contacts tab.
a. Enter all contacts (customer or employee).
b. Specify if the contact is a requester or the escalation is for notification
purposes.
In addition to the owner of the escalation document, recipients can include the
Human Resource manager of the owner of the escalation document, the owner
of the escalated object, and the selected employee and customer contacts.
5. (Optional) Select the Audit tab to view all the changes once you are finished.

48-2 Oracle CRM Application Foundation User Guide


Creating a Document Whose Owner is a Group

6. Click Assign, in the Escalation Owner Information region, to assign ownership.


You can assign either automatically or manually.
■ Automatic Assignment
An owner can be automatically assigned by using the Assignment Manager
if the escalated source document is assigned to a resource defined in a
territory and this territory has an escalation territory attached to it.
■ Manual Assignment
If the document does not contain a territory, or if you want to override the
recommended escalation resource by the escalation territory, then either
select an owner from the List of Values or use the Assignment Manager to
assist in owner selection.

See Also
Managing Different Types of Escalations

48.2 Creating a Document Whose Owner is a Group


Not only an individual can be a document owner. Perform the following steps to
define an owner of an escalated document whose owner is a group.

Prerequisites
A group must exist. If it does not, then define one in Resource Manager.

Responsibility
CRM Administrator

Navigation
Navigate to the Find Tasks window.

Steps
1. Click New to create a new task.
2. Enter a name in the Name field.
3. In the Owner Type field, choose Group Resource from the List of Values
(LOVs).
4. In the Owner field, select a previously created owner.

Using Escalation Manager 48-3


Managing Different Types of Escalations

5. Save the Task.

48.3 Managing Different Types of Escalations


The following sections describe the process of managing different types of
escalations:
■ Managing a Service Request Escalation
■ Managing a Task Escalation
■ Managing a Defect Escalation

48.4 Managing a Service Request Escalation


A service request is a document that tracks information regarding a customer’s
product and service problems. Perform the following steps to manage a service
request escalation.

Prerequisite
A service request exists in the system.

Responsibility
CRM Administrator

Navigation
Navigate to the View Service Request window.

Steps
1. Query the existing service request.
2. Verify that the service request has never been escalated. In the Request
Information area of the header, verify that “Never Escalated” appears in the
Escalation Level field.
You may have to scroll down in the Request Information header region to see
the Escalation Level field.
3. From the Tools menu, choose Request Escalation.
The customer and account information fields are automatically populated,
along with the reference document information (service request).

48-4 Oracle CRM Application Foundation User Guide


Managing a Service Request Escalation

4. Select or enter the following information:


a. A Status
b. A Reason
c. Target date
d. The escalation level
5. Assign the escalation to yourself or another existing resource using one of the
two methods listed:
Manual Assignment
a. Select a resource from the LOV.
Automatic Assignment
a. Click Assign to choose an escalation owner from the Assignment Manager.
b. Select the Assisted Assignment option and select Territories.
c. Click Search.

Note: Only click Search in the Selection Criteria region. Leave the
other fields in the default settings.

The resources from the Escalation Territory of the escalated document


become visible. If there are no Escalation Territories setup, then the
resources from the Catch All territory are in view.
6. Select the resource name and click OK.
7. Enter an escalation summary.
8. Enter the name of the customer or employee contact (requester), and select the
Requester check box.
There can be more than one contact, but only one requester.
a. (Optional) Enter any additional contact points.
b. (Optional) Add more reference documents to the escalation in the Reference
Documents tab.
9. Save the escalation, and make a note of the escalation number.
a. (Optional) Click Notes to create a note about the escalation.

Using Escalation Manager 48-5


Managing a Task Escalation

b. (Optional) Click Tasks to create a follow up task for the escalation.


10. Close the Escalation window to return to the Service Request window.
Re-query the service request to view the updated escalation level.

48.5 Managing a Task Escalation


Perform the following steps to manage a stand-alone task escalation.

Prerequisite
A task exists in the system.

Responsibility
CRM Responsibility

Navigation
Navigate to the Task window.

Steps
1. Find the task to be escalated.
2. From the Tools menu, choose Manage Escalation.
3. Verify that the task has never been escalated.
If the task has already been escalated, then the escalation document will
automatically appear in the escalation window.
4. Enter the following information:
a. A Status
b. A Reason
c. Target date
d. The escalation level
5. Assign the escalation to yourself or another existing resource using one of the
two methods listed:
Manual Assignment
a. Select a resource from the LOV.

48-6 Oracle CRM Application Foundation User Guide


Managing a Defect Escalation

Automatic Assignment
a. Click Assign to choose an escalation owner from the Assignment Manager.
b. Select the Assisted Assignment option and select Territories.
c. Click Search.

Note: Only click Search in the Selection Criteria region. Leave the
other fields as defaulted.

The resources from the Escalation Territory(s) of the escalated document(s)


become visible. If there are no Escalation Territories set up, then the
resources from the Catch All territory display.
d. Select the resource name and click OK.
6. Enter an escalation summary in the Escalation Summary field.
7. Enter the name of the customer or employee contact (requester), and select the
Requester check box.
There can be more than one contact, but only one requester.
8. (Optional) Enter any additional contact points.
9. Save the escalation and query the escalated task to view the updated escalation
level.

48.6 Managing a Defect Escalation


A defect is a document which tracks product problems and resolutions. A defect
can be escalated without an associated service request. Any employee can escalate a
defect from the HTML-based Oracle Quality Online (OQO) application.
See the OQO documentation for the procedures on escalating a defect.

Using Escalation Manager 48-7


Managing a Defect Escalation

48-8 Oracle CRM Application Foundation User Guide


Part XI
User Management

This part of the Oracle CRM Application Foundation User Guide contains the
following chapters:
■ Introduction to Oracle User Management
■ Working with Oracle User Management
49
Introduction to Oracle User Management

This chapter covers the following topics:


■ Overview
■ What’s New In This Release
■ User Types
■ Enrollments
■ Templates
■ Approval Processes
■ Access Control
■ Self-service Registration
■ Terms and Definitions

49.1 Overview
Oracle User Management is a highly extensible framework that automates many of
the user registration and administration processes for an organization based on its
business requirements. Because these processes are self-service enabled, users can
complete many of their own registration tasks and different levels of administration
can be handled by predefined resources or partners of an organization who are
granted the appropriate roles and permissions. This reduces an organization’s
operating cost and its reliance on customer service agents who manually perform
these tasks. Oracle User Management functionality is based on key concepts that
include user types, enrollments, templates, approval processes, access control, and
self-service registration. Once an organization has implemented Oracle User

Introduction to Oracle User Management 49-1


What’s New in This Release

Management, it can automate the process for registering, approving, and


maintaining different types of users, and for providing them with access to the
appropriate applications. This chapter provides a conceptual explanation of Oracle
User Management in the following topics:

49.2 What’s New in This Release


This release of the System Administrator Console contains the following new
features and functions for Oracle User Management subsequent to the 11.5.6 release:

Primary User Type for Existing Organizations is Obsolete


The primary user type for existing organizations is disabled. Consequently, new
users cannot register for this user type. This version of Oracle User Management
contains a script and a concurrent program, MIGRATE_PRIMARY_USERS that
must be run to migrate users that registered for this user type to the business user
user type. The MIGRATE_PRIMARY_USERS concurrent program generates a log
identifying which users have been migrated and which ones have not yet been
migrated because of pending user type or enrollment requests. In this case, the
client must process these requests and run the concurrent program again to migrate
these users. Alternatively, the MIGRATE_PRIMARY_USERS concurrent program
can be scheduled to run on a regular basis in order to automatically migrate users
once their requests are processed.

Automatic Password Reset


New users or users whose passwords have been reset by an appropriate user such
as the system administrator automatically receive an email message stating that
they must reset their password.

Enhanced Password Validation


Oracle User Management contains an enhanced password validation system that
validates passwords according to the following criteria:
■ Password is an appropriate length
■ Password is not easy to guess
■ Password contains ASCII or alpha-numeric characters only

Password Expiration
User Management contains a password expiration feature which functions as
follows:

49-2 Oracle CRM Application Foundation User Guide


What’s New in This Release

■ When an administrator resets a user’s password, an email message is sent to the


user with the new password. This password automatically expires and must be
reset by the user.
■ When an administrator registers a new user an email message is sent to the user
with the new password. This password automatically expires and must be reset
by the user.

Delegation
User Management contains a powerful new feature which enables users with the
appropriate role to delegate enrollments to other users and to delegate the
delegation ability itself. The Request Summary page now includes a Delegation
column with a checkbox in each row. In addition to delegating enrollments, users
with the appropriate roles can select this checkbox to grant delegation capability to
new users. If they do not have the appropriate roles then the Delegation checkboxes
are shaded and cannot be selected.

New Enrollment Availability


Oracle User Management now contains four types of enrollment availability that
appear in the Availability column of the User Types, Enrollments page:
■ automatic
■ self-service
■ delegation only
■ self-service and delegation

Enhanced Request Summary Page


The Pending Requests page contains the following new features:
■ The Confirmation Number column displays a confirmation number that is
automatically generated during registration. This number is a useful identifier
for requestors who contact customer service departments to check the status of
their request.
■ The Current Approver column display the current approver for each request.
This column only appears for a System Administrator or a user with identical
permissions.
■ This page includes a Delegation column with a checkbox in each row. In
addition to delegating enrollments, users with the appropriate roles can select
this checkbox to grant delegation capability to new users. If they do not have

Introduction to Oracle User Management 49-3


What’s New in This Release

the appropriate roles then the Delegation checkboxes are shaded and cannot be
selected.

Email Notification
Users can receive automatic email notifications for the following:
■ Status for each enrollment
■ Registration confirmation
■ User account deactivation
■ Password reset

Enrollment Enhancements
This release of User Management contains the following enrollment enhancements:
■ It ships with a primary user enrollment and four business users that are
assigned by delegation only.
■ System administrators can now view automatic enrollments assigned to a user.

Default Responsibility Assignment


The default responsibility is now assigned on the basis of a user’s selected
enrollments. Previously, it was assigned by user type.

Profile Options
Oracle User Management contains the following new profile options:
■ JTA_UM_APPLICATION_URL
■ JTA_UM_REG_ORG_FAX_REQD
■ JTA_UM_REG_ORG_PHONE_REQD
■ JTA_UM_SUPPORT_CONTACT
■ JTA_UM_PASSWORD_GEN_WKF
■ JTA_UM_SENDER
■ SIGNON_PASSWORD_LENGTH

49-4 Oracle CRM Application Foundation User Guide


Enrollments

49.3 User Types


User types are categories of users based on an organization’s unique registration
requirements. They provide a flexible, and extensible method of defining,
categorizing, and implementing specific forms of user behavior. In addition, user
types facilitate user self-service registration by enabling merchants to associate
default roles, responsibilities, accounts, and registration templates with categories
of users and to determine the appropriate approval process. All users that belong to
a specific user type possess the same registration requirements and, if desired, are
provided the same default application access with one responsibility and a range of
security roles from none to several complex ones. They can sign up for and
configure a set of enrollments and are required to participate in the same approval
process. Oracle User Management contains three default user types: primary user,
business user, and individual user. Information about each user that registers for
one of these types is stored in the TCA, FND, and JTF schemas.

49.3.1 Primary User


The primary user is a business user and is also the primary contact for an
organization. An individual belonging to this user type functions as customer
administrator and is responsible for managing all users of the same user’s
organization. It is generally the first user to register an organization and does not
require approval.

49.3.2 Business User


The business user is a typical B2B user associated with an organization. The
business user is generally approved by one or more primary users of an
organization or someone in the merchant organization. Business users can be
granted Primary User privileges with the new Primary User enrollment.

49.3.3 Individual User


The individual user is a typical business-to-consumer (B2C) user that has no
relationship to an organization. Approval is generally not required for individual
users.

49.4 Enrollments
Enrollments are a set of add-on services that incrementally capture user data and
grant users additional access privileges. Users can obtain enrollments during

Introduction to Oracle User Management 49-5


Enrollments

registration or after the approval process is completed. Enrollments typically grant a


user access to an application, but can also enable the user to accept licensing terms,
to provide surveys, and to sign up for parking permits or any other service.
Enrollments can be tied to one or many user types, can be automatic, self-service,
delegation only, or delegation and self-service, and may require an approval
process. They correspond to a 0-1 responsibility and 0-many security roles and are
optionally displayed in a user interface such as a JSP page.

49.4.1 Self-service Enrollments


Self-service enrollments are enrollments that a user manually assigns to itself as part of the
registration process.

49.4.2 Automatic Enrollments


Automatic enrollments are automatically and transparently assigned to a user when the user
registers for a specific user type. For example, an organization may wish to automatically
assign primary users with access to specific accounts that are not available to other user
types.

49.4.3 Delegation Only


Delegation only enrollments are assigned to users by an individual with the
appropriate access privileges and never requires any approvers. This process only
takes place at the delegating individual’s discretion and users cannot sign up for
these enrollments. An individual with the appropriate access privileges can also
grant delegation privileges to other users. Users cannot use self-service registration
to sign up for enrollments that are delegation only enrollments.

49.4.3.1 Required Roles


The delegation only enrollment is only available if:
■ The administrator has granted the user all access roles associate with the
enrollment.
■ The delegation role is defined for the enrollment and the administrator has the
delegation role.

49.4.4 Delegation and Self-service


Delegation and self-service enrollments can be assigned to a user by either of two
methods. Users can sign up for these enrollments or an individual with the

49-6 Oracle CRM Application Foundation User Guide


Approval Processes

appropriate access privileges can assign them to users. If a user signs up for a
self-service enrollment or is delegated an enrollment by an individual with
insufficient access privileges, then the user must complete the approval process. If
the enrollment is a delegation and self-service enrollment the it is always available
in the UI as a choice for the administrator.

49.4.4.1 Required Roles


If the administrator has all of the required roles for an enrollment, then the
administrator can grant users the enrollment without launching an approval
process. If the administrator does not have all of the required roles for an
enrollment, then the administrator can grant users the enrollment, however an
approval process is launched and must be completed before it is granted to the user.

49.5 Templates
Templates are JSP pages that enable Oracle User Management to capture and retain
information during the registration process. Each JSP page is associate with a Java
class called a template handler, which captures the required information and writes
it to the database. Each template is associated with one or more user types and
enrollments.

49.6 Approval Processes


An approval process is a predefined series of steps required to approve user
registration or service enrollment requests. They are associated with one-to-many
user types and can be associated with one-to-many enrollments. Approval
processes use Oracle Workflow for routing requests to the correct approvers and use
email to send workflow notifications to the approvers. In addition, approval
processes support time-outs and reminders. A request times out if it is left in an
approvers queue for a specified amount of time.

Note: See Approving Pending User Requests for details regarding


request time-out results.

Introduction to Oracle User Management 49-7


Approval Processes

Users are sent email notifications once their requests have been approved or
rejected. They will not be granted security roles or responsibilities until they have
been approved.

49.6.1 Approval
An approval is an optional feature that enables approvers to reject or approve new
user accounts. The System Administrator Console Users tab enables users to view,
create, modify, delete, enable, and disable approvals, including those for specific
organizations.

49.6.2 Approval Definition


An approval definition is the association of a user type or an enrollment with a
workflow process, a default list of approvers, and optionally with an organization
that overrides the list of approvers. It uses workflow to track and route an approval
request to the approvers and to deliver an email notice to the approvers when
required. If the approval definition has multiple approvers, then the email
notification is sent to each successively to approve the request. The user is only
granted the required access or enrollment after each approver has approved the
request. Rejection is required from only one approver to deny the user the requested
access or enrollment. If the order of the approvers changes, all pending requests are
transferred back to the top of the new approver list. If the user type or enrollment is
changed to use another approval definition, all pending request workflow processes
terminate and a new workflow process is created and launched. If a user type or
enrollment is modified and no longer requires an approval, then all pending
requests are automatically approved.

49.6.3 Approval Flow


The approval flow is a predefined flow of steps required to approve user
registration or service enrollment requests.

49.6.4 Approver Lists


An approver list is a group of one or more approvers associated with an approval
definition. Each approval definition has a default approver list and can have
separate approver lists defined for each organization that takes priority over the
default list.

49-8 Oracle CRM Application Foundation User Guide


Approval Processes

49.6.5 Approvers
Approvers are designated individuals who can modify user information and who
can create and assign user accounts. Approvers with the CRM Primary User
responsibility or access to the CRM System Administration Console can approve or
reject user type and enrollment requests. Primary users can approve any request for
their organization if approval group capability has been implemented in the system.
Oracle User Management recognizes the following levels of approvers:
■ System Administrators
■ Primary Users
■ Request Owners

49.6.5.1 System Administrators


System administrators, also referred to as merchant administrators, can accept or
reject any requests in the system and can define a global or default list of approvers
for each user type and enrollment. They can also supersede any decision made by
other approvers in an organization. To approve requests, system administrators
must be assigned the JTF_REG_APPROVAL permission.

49.6.5.2 Primary Users


Primary users can approve requests that are explicitly assigned to them, and can
approve any requests for their organization if approval group capability has been
implemented in the system. Primary users must be assigned the
JTF_PRIMARY_USER_SUMMARY permission to approve pending requests and
must be assigned the JTF_PRIMARY_USER responsibility to access the approval
page.

49.6.5.3 Request Owner


Request owners, also known as approvers are generated by the approver list and
the most current state of workflow defined for given approval. Request owners
have the JTF_APPROVER permission and can only approve requests assigned to
them.

49.6.6 Approval Groups


User Management enables a designated group of users to approve account requests.
All members of this group can view and process the request and only one member

Introduction to Oracle User Management 49-9


Access Control

of the group must approve the request. Once this occurs, the request, if applicable,
is assigned to the next approver in the approval hierarchy.

49.7 Access Control


Oracle User Management provides a flexible and granular level of access control
through its system of permissions, roles, and responsibilities.

49.7.1 Responsibilities
Responsibilities are groupings of application menus that determine the user
interface accessible to a particular user. During the registration process, users are
granted access to one or more responsibilities depending on the services in which
they enroll and the merchant policy. Typically, individual users are given access to
only one responsibility. Oracle User Management contains the following
responsibilities:

49.7.1.1 CRM HTML Administration


The CRM HTML Administration responsibility provides access to the HTML
System Administration console. Oracle User Management functionality, can be
accessed by clicking the Users tab.

49.7.1.2 CRM User Management


The CRM User Management responsibility provides access to the Registration and
Setup navigation links in the System Administration Console.

49.7.1.3 CRM Primary User


The CRM Primary User page provides access to the Home tab and Users tab in
standalone mode. This responsibility does not provide access to any other tabs in
the System Administrator Console.

49.7.2 Permissions
Permissions are specific types of access privileges that can be assigned to a user. A
user can perform specific tasks if the user is assigned the required permissions.
Oracle User Management contains the following permissions:

49-10 Oracle CRM Application Foundation User Guide


Access Control

49.7.2.1 JTA_UM_SETUP
The JTA_UM_SETUP permission provides access to all Oracle User Management
setup screens and should only be granted to administrators in the organization who
are responsible for implementing the system.

49.7.2.2 JTA_UM_DELEGATION_ACCESS
The JTA_UM_DELEGATION_ACCESS permission displays the Delegation column
with checkboxes in the Enrollment selection page. This permission is automatically
assigned when a user is granted delegation privileges for the first time for an
enrollment.

49.7.2.3 JTF_APPROVER
The JTF_APPROVER permission enables users to view and to approve requests that
are assigned to them and to be approvers in the Approval Definition screen.

49.7.2.4 JTF_PRIMARY_USER_SUMMARY
The JTF_PRIMARY_USER_SUMMARY permission provides users with access to
the User Maintenance and Pending Approvals page s, and enables them to query all
users in their organization. Users who are assigned this permission can perform the
following in the User Maintenance page:

■ Disable user accounts thereby preventing users from logging in.


■ Reset passwords.
■ Change Account Assignments.
■ View Enrollments.
■ Revoke enrollments.
■ Assign new enrollments.
Users who are assigned this permission can perform the following in the Pending
Approvals page:
■ View and approve all requests assigned to them.
■ View and approve all requests for their organization if the approval group
function has been implemented in the system.

Introduction to Oracle User Management 49-11


Access Control

49.7.2.5 JTF_REG_APPROVAL
The JTF_REG_APPROVAL permission provides system administrator capability for
specific functions that include the ability to view and respond to all requests in the
system independently of the person to whom they are assigned.

49.7.2.6 JTF_SECURITY_ASSIGN_ROLE
The JTF_SECURITY_ASSIGN_ROLE permission provides system administrator
capability for specific functions that include the ability to query any users and to
change their details, to assign accounts, to manage enrollments, and pending
approvals from the Pending Approvals link in the main navigation bar, to reset
passwords, and to disable user access.

49.7.3 Roles
Roles are groupings of permissions, which are page level or function level granular
privileges used to maintain application security. A single user can be granted
several roles, each of which separately determines access rights to the user interface
details, the ability to perform certain transactions and the ability to access certain
data sets. During the registration process, users are granted the appropriate set of
roles that map to their job function. Although Oracle User Management contains the
following predefined roles, users with the appropriate access privileges can also
create and customize their own roles.

49.7.3.1 JTA_UM_DELEGATION_ACCESS
The JTA_UM_DELEGATION_ACCESS role is assigned the
JTA_UM_DELEGATION_ACCESS permission and provides users with all of the
access privileges associated with this permission.

49.7.3.2 JTA_UM_SETUP_ADMIN
The JTA_UM_SETUP_ADMIN role is assigned the JTA_UM_SETUP permission and
provides users with all of the access privileges associated with this permission.

49.7.3.3 JTF_APPROVER
The JTF_APPROVER role is assigned the JTF_APPROVER permission and provides
users with all access privileges associated with this permission.

49-12 Oracle CRM Application Foundation User Guide


Terms and Definitions

49.7.3.4 JTF_PRIMARY_USER
The JTF_PRIMARY_USER role is assigned the JTF_PRIMARY_USER_SUMMARY
permission and provides users with all access privileges associated with this
permission.

49.7.3.5 JTF_SYSTEM_ADMIN_ROLE
The JTF_SYSTEM_ADMIN role is the global system administration role and
contains all permissions required to access and operate the System Administration
Console including JTF_SECURITY_ASSIGN_ROLE and JTA_UM_SETUP.

49.8 Self-Service Registration


Self-service registration is a user interface and set of background processes that
enable users to perform their own registration tasks instead of doing so through an
administrator. This feature reduces an organization’s operating costs and removes
registration restrictions that are based on the availability of an administrator.

49.8.1 Registration
Registration is the process that provides users with access to some or all of an
application’s functionality.

49.8.2 Registration Self-service Administration UI


The Registration Self-service Administration UI is a user interface that enables
system administrators, and designated primary users, to maintain users, parties,
and accounts for an external organization or an internal group.

49.8.3 Registration Self-service User UI


The Registration Self-service user UI is a user interface that enables self-registration
for primary, individual, or business users.

49.9 Terms and Definitions


This section contains additional terms and definitions that are essential to
understanding Oracle User Management.

Introduction to Oracle User Management 49-13


Terms and Definitions

49.9.1 Customers
Customers are individuals who are external to the implementing organization and
who use but do not implement the Oracle e-Business Suite.

49.9.2 Java Server Pages (JSPs)


JSPs are an extension to the Java servlet technology that was developed by Sun as an
alternative to Microsoft's ASPs (Active Server Pages). JSPs have dynamic scripting capability
that works in tandem with HTML code, separating the page logic from the static elements —
the actual design and display of the page. Many of the Oracle User Management
configuration and management tasks are performed using a HTML interface composed of
JSPs.

49.9.3 Merchants
Merchants implement the Oracle e-Business Suite and should not be confused with
“customers” who use the Oracle e-Business Suite.

49.9.4 Users
Users are individuals who require partial or complete access to one or more
applications in the Oracle e-Business suite.

49.9.5 Workflow
Oracle Workflow automates and continuously improves business processes, routing
information of any type according to business rules you can change. The rules,
which we call a workflow process definition, include the activities that occur in the
process and the relationship between those activities. An activity in a process
definition can be an automated function defined by:
■ a PL/SQL stored procedure or an external function
■ a notification to a user or role that may request a response
■ a business event
■ a subflow that itself is made up of many activities.

49-14 Oracle CRM Application Foundation User Guide


50
Working with Oracle User Management

This chapter covers the following topics:


■ Introduction
■ Prerequisites
– Creating the User Management Administrative User
– Logging into User Management
■ Pending Approvals
– Approving Pending User Requests
– Viewing Your Notifications
– Approving Requests from the Notification Window
■ User Maintenance
– Viewing All Users
– Searching for a User
– Creating a New User
– Editing a User’s Details
– Deleting a User
– Defining a User’s Roles
– Defining a User’s Account
– Defining a User’s Enrollment
■ Setting up Approval
– Creating a New Approval

Working with Oracle User Management 50-1


Introduction

– Removing an Approval
– Searching for an Approval
– Editing an Approval’s Details
– Enabling and Disabling Approval
– Searching for an Organization
– Viewing Approval Preferences
– Updating Approval Preferences
■ Setting up Enrollments
– Creating an Enrollment
– Removing an Enrollment
– Enabling and Disabling Enrollments
– Editing an Enrollment’s Details
■ Setting up User Types
– Creating a User Type
– Removing a User Type
– Activating and Deactivating User Types
– Searching for a User Type
– Editing a User Type’s Details
■ Setting up Templates
– Creating a Template
– Removing a Template
– Enabling and Disabling Templates
– Editing a Template’s Details
– Searching for a Template

50.1 Introduction
The Users tab in the System Administration Console provides functionality for
registering users and for setting up the User Management framework. The

50-2 Oracle CRM Application Foundation User Guide


Creating the User Management Administrative User

Registration menu in the main navigation bar enables administrators to manage


approvals, and to setup, modify, or delete users. The Setup menu in the main
navigation bar enables administrators to create and manage approvals, enrollments,
user types, and templates.

Note: Before performing the functions discussed in this section,


please consult the Introduction to Oracle User Management
Chapter for a conceptual overview of User Management.

50.2 Creating the User Management Administrative User


To access the System Administrator Console and perform certain User Management
administrative functions, a user must be a system administrator or an
administrative user with the appropriate responsibilities and roles. This section
provides instructions for creating a User Management administrative user and
assigning it the appropriate responsibilities and roles. The steps for creating the
User Management administrative user take place in the Forms and HTML
interfaces.

Prerequisites
None

Responsibility
System Administrator

Navigation
Log in to the Forms and HTML interfaces as required.

Steps in Forms
1. Log in to the Forms interface with System Administrator responsibility and
choose Security>User>Define.
2. Enter a user name and password in the Users window.
3. Add the following responsibilities, save your work, and exit the Forms
interface:

Working with Oracle User Management 50-3


Logging into User Management

■ CRM HTML Administration


■ CRM User Management
■ CRM Primary User
4. Log on to the System Administrator Console as a System Administrator.
5. Click the Users table and then click User on the side navigation bar.
6. Enter the user name in the search field and Select Go.
7. Select the user name and then select Roles
8. Assign the JTA_UM_SETUP_ADMIN role to the user, select Update, and exit
the System Administrator Console.

Steps in HTML
1. Login in to the HTML interface wit System Administrator responsibility, select
the User>Registration>User Maintenance.
2. Search for the user you want to configure in the Users page and click the
resulting link for the user.
3. Select Roles in the User Details page and assign the appropriate roles to the
user. When you have assigned all of the required roles, click Update.

Note: Responsibilities determine which pages a user can access


and roles determine which functions the user can perform in those
pages. If you do not assign appropriate roles to the user, then it will
not be able to perform the required function even with the
appropriate access to the page.

50.3 Logging into User Management


The following modules use User Management to register users:
■ Oracle iStore
■ Oracle iSupport
■ Oracle Partners Online
Perform the following steps to log into the System Administrator Console.

50-4 Oracle CRM Application Foundation User Guide


Approving Pending User Requests

Note: All fields marked with an asterisk are required.

Prerequisites
■ You must have a valid username and password.
■ You must have the appropriate responsibility such as the CRM HTML
Administration responsibility.

Steps
1. Navigate to the Login window.
2. Enter your username.
3. Enter your password and click Go.

50.4 Approving Pending User Requests


Pending user account requests must be approved by an approver, a system
administrator or the primary user for an organization.
The following sequence of events occurs if notifications are set to time out after a
specified amount of time in the JTF_UM_APPROVAL_TIMEOUT profile option:
■ If the time-out period passes without an approval or rejection, a reminder is
sent to the same approver.
■ If the approver still does not respond, the request is sent to the next approver
specified in the Approval Setup window.
■ If the last approver does not respond, or there are no more approvers on the list,
then the notification is sent to the user specified in the
JTF_UM_APPROVAL_OWNER profile option.
Perform the following steps to accept or reject user approval requests, edit user
information, and assign accounts to the user.

Note: Any pending user requests submitted before User


Management was applied do not appear in the Pending Request
window. Instead, you must click on the link in the window to
respond to these requests.

Working with Oracle User Management 50-5


Viewing Your Notifications

Prerequisites
You must be an approver, system administrator, or primary user of a company with
the appropriate permissions, to approve a request.

Navigation
Navigate to Users>Registration>Pending Approvals

Steps
1. (Optional) Select the Delegation check box next to the user to provide the user
with delegation ability. The Delegation column is only visible to uses with the
appropriate role.
2. (Optional) Review the user’s details before accepting or rejecting Click the
username in the Username column to review the request before accepting or
rejecting it.
3. Select the check box next to the user and click Accept or Reject to answer the
request from this window
A notification is sent to the user when the last approver from the approval
definition approves it.

50.5 Viewing Your Notifications


A merchant administrator, system administrator, or a primary user for an
organization can approve or reject a users request. Whether the request is granted
or rejected, the user receives a notification. Perform the following steps to view your
user requests.

Prerequisites
You must set up your Personal Home Page (PHP) and have the workflow and self
service responsibilities to receive notifications.
Steps
1. Log in as the System Administrator.
2. Set up your Personal Homepage (PHP) to show workflow notifications.
3. Select the Main Menu tab.
4. Click Workflow.
5. Click View Notifications.

50-6 Oracle CRM Application Foundation User Guide


Approving Requests from the Notification Window

Your notifications appear in the Worklist window.

See Also
■ Approving Requests from the Notification Window

50.6 Approving Requests from the Notification Window


Note: When an approver receives a registration request in their
Notifications, they have the option to reassign it. However, it is the
approvers responsibility to confirm that the person to whome you
are reassigning the request has the correct approver responsibilities
and permissions. The list provided includes application users that
may or may not have the appropriate responsibilities to approve
user requests.

For user types, the system administrator receives a URL in their notifications. The
approver follows the URL to approve or reject the request. Perform the following
steps to approve or reject a user requests.

Prerequisites
You must set up your Personal Home Page (PHP) and have the workflow and self
service responsibilities to receive notifications.
Steps
1. Log in as the System Administrator.
2. Set up your Personal Homepage (PHP) to show workflow notifications.
3. Select the Main Menu tab.
4. Click Workflow.
5. Click View Notifications.
Your notifications appear in the Worklist window.
6. Click the link to respond to the request.
The Notification Details window opens.
7. Review the users details and click Approve to accept the request or click Reject
to deny the request.

Working with Oracle User Management 50-7


Viewing All Users

8. To reassign the request:


a. Click Reassign.
b. Enter the Approvers name or click the Up arrow icon to search for an
approver.
You are responsible for verifying
c. Select the Delegate Authority for responding to this notification option
button to send the request to an approver w to Transfer Ownership of this
notification
d. Enter any comments you want the new approver to view.
e. Click OK.
The request is Reassigned.

See Also
■ Viewing Your Notifications

50.7 Viewing All Users


Perform the following steps to view all users in the system.

Note: If you are the primary user for your organization, you will
only be able to view users for your company.

Prerequisites
You must be the merchant administrator, system administrator, or the primary user
of a company with the appropriate permissions, to view all users.

Steps
1. Log in to the CRM System Administrator Console as a system administrator.
2. Select the Users tab.
3. Click Registration on the main navigation bar, if it is not already selected.
4. Click User Maintenance on the side navigation bar.
The Users window opens.
5. Enter a minimum of three characters into to the search field.

50-8 Oracle CRM Application Foundation User Guide


Searching for a User

The "%" and "_" (underscore) symbols are wildcards.


6. Click Go.
All users that match your search criteria are listed.

See Also
■ Searching for a User
■ Creating a User
■ Editing a User’s Details
■ Deleting a User
■ Defining a User’s Roles
■ Defining a User’s Account
■ Defining a User’s Enrollment

50.8 Searching for a User


Perform the following steps to search for a user.

Note: If you are the primary user for your organization, you are
only able to query users for your company.

Prerequisites
You must be the system administrator or the primary user of a company with the
appropriate permissions to search for a user.

Steps
1. Log in to the CRM System Administrator Console as a system administrator.
2. Select the Users tab.
3. Click Registration on the main navigation bar, if it is not already selected.
4. Click User Maintenance on the side navigation bar.
The Users window opens.
5. Select Last Name, First Name, or Username from the Enter Search Criterion
drop-down list.

Working with Oracle User Management 50-9


Creating a New User

6. Enter a minimum of three characters into to the search field.


The "%" and "_" (underscore) symbols are wildcards.
7. Click Go.
A list of search results appears in the window.

Note: To search for all users in the system, enter three spaces
followed by "%". This search may take a long time.

See Also
■ Viewing All Users
■ Creating a User
■ Editing a User’s Details
■ Deleting a User
■ Defining a User’s Roles
■ Defining a User’s Account
■ Defining a User’s

50.9 Creating a New User


Certain types of users may only be created by a system administrator. For example,
a system administrator creates primary users or other system administrators.
Oracle ships out-of-the-box the following user types:
■ Users who represent a company or organization that is a Partner of Oracle
(Partner).
■ Users who represent an organization that is already registered, and want to
register themselves as a user.
■ Users who represent themselves only (for individuals).
■ Users who want to register their organization.
Perform the following steps to create a new user.

50-10 Oracle CRM Application Foundation User Guide


Creating a New User

Note: Do not create user names starting or ending with any


special characters, such as %, _, or *.

Prerequisites
You must be the system administrator or the primary user of a company with the
appropriate permissions to create a new user.

Steps
1. Log in to the CRM System Administrator Console as a system administrator.
2. Select the Users tab.
3. Click Registration on the main navigation bar, if it is not already selected.
4. Click User Maintenance on the side navigation bar.
The Users window opens.
5. Click Create.
The User Registration window opens.
6. Select the type of user that you want to create.
7. Enter information about the organization (if you are creating a user type
associated with an organization), and click Next.
This information includes the name, location of the organization, and relevant
telephone numbers.
8. Enter the user's information into the fields provided and click Next.
This information includes name and contact information, as well as a password.
9. Select available enrollments as appropriate.
10. Enter supporting information, depending on the enrollment(s) that you
selected, and click Next.
The User Registration Summary page opens and displays a confirmation
number.
11. Click Continue to return to the main User Maintenance page.

See Also
■ Viewing All Users

Working with Oracle User Management 50-11


Editing a User's Details

■ Searching for a User


■ Editing a User’s Details
■ Deleting a User
■ Defining a User’s Roles
■ Defining a User’s Account
■ Defining a User’s Enrollment

50.10 Editing a User's Details


Perform the following steps to edit a user's information.

Prerequisites
You must be the system administrator or the primary user of a company with the
appropriate permissions to edit a user’s details.

Steps
1. Log in to the CRM System Administrator Console as a system administrator.
2. Select the Users tab.
3. Click Registration on the main navigation bar, if it is not already selected.
4. Click User Maintenance on the side navigation bar.
The Users window opens.
5. If you do not need to search for the user, then skip to step 7.
6. If you need to search for the user, then:
a. Select Last Name, First Name, or Username from the Enter Search Criterion
drop-down list.
b. Enter a minimum of three characters into to the search field.
The "%" and "_" (underscore) symbols are wildcards.
c. Click Go.
A list of search results appear in the window.
7. Click the username.
The User Details page opens.

50-12 Oracle CRM Application Foundation User Guide


Deleting a User

8. Edit fields as desired.


Fields marked with an asterisk are mandatory.
9. (Optional) Click Roles to view or update the roles associated with this user.
See Defining a User’s Roles for details.
10. (Optional) Click Enrollments to view or update the enrollments associated with
this user.
See Defining a User’s Enrollment for details.
11. (Optional) Click Default Responsibility to view or update the default
responsibility associated with this user.
12. (Optional) Click Accounts to view or update the accounts associated with this
user.
See Defining a User’s Account for details.
13. click Update when you have completed your modifications.

See Also
■ Viewing All Users
■ Searching for a User
■ Creating a User
■ Deleting a User

50.11 Deleting a User


Perform the following steps to delete a user.

Prerequisites
You must be the system administrator or the primary user of a company with the
appropriate permissions to delete a user.

Steps
1. Log in to the CRM System Administrator Console as a system administrator.
2. Select the Users tab.
3. Click Registration on the main navigation bar, if it is not already selected.

Working with Oracle User Management 50-13


Deleting a User

4. Click User Maintenance on the side navigation bar.


The Users window opens.
5. If you do not need to search for the user, then skip to step 7.
6. If you need to search for the user, then:
a. Select Last Name, First Name, or Username from the Enter Search Criterion
drop-down list.
b. Enter a minimum of three characters into to the search field.
The "%" and "_" (underscore) symbols are wildcards.
c. Click Go.
A list of search results appear in the window.
7. Select the check box which corresponds to the user you want to delete.
8. Click Delete User.
The Delete User window opens.
9. Deselect any user names that you do not wish to delete at this point.
10. Click Delete.
The selected user is deleted from the system. If successful, a confirmation
message is generated. The system also attempts to send an notification to the
email address associated with that user.

See Also
■ Viewing All Users
■ Searching for a User
■ Creating a User
■ Editing a User’s Details
■ Defining a User’s Roles
■ Defining a User’s Account
■ Defining a User’s Enrollment

50-14 Oracle CRM Application Foundation User Guide


Defining a User’s Roles

50.12 Defining a User’s Roles


Perform the following steps to define a user's role information.

Note: If you are the primary user of an organization, you are not
able to define their role from this window.

Prerequisites
You must be the merchant administrator or a system administrator, of a company
with the JTF_SECURITY_ASSIGN_ROLE permission to define a user’s roles.

Steps
1. Log in to the CRM System Administrator Console as a system administrator.
2. Select the Users tab.
3. Click Registration on the main navigation bar, if it is not already selected.
4. Click User Maintenance on the side navigation bar.
The Users window opens.
5. Find the user who’s role you want to define.
6. Click the username.
The User Details window opens.
7. Click Roles to edit the user’s role information.
The User- Role Mapping window opens.
8. Select the name of a role in one list and click > or < to move it to the other list.
You can hold down the [CTRL] key and use your mouse to select multiple roles.
The administrator can only assign roles that they are assigned themselves.
9. Repeat step 8 as desired.
10. (Optional) Click >> to move all Available Roles to the Assigned Roles list, or
click << to move all Assigned Roles to the Available Roles list.
11. Click Update to modify the information or click Restore to reset the original
values in the window.

Working with Oracle User Management 50-15


Defining a User’s Account

See Also
■ Viewing All Users
■ Searching for a User
■ Creating a User
■ Editing a User’s Details
■ Deleting a User
■ Defining a User’s Account
■ Defining a User’s Enrollment

50.13 Defining a User’s Account


Perform the following steps to define a user's account information.

Note: If the user is not defined as a user type in the user


management framework, then you can not define the account from
this window.

Prerequisites
You must be the system administrator or the primary user of a company with the
appropriate permissions to define a user’s account.

Steps
1. Log in to the CRM System Administrator Console as a system administrator.
2. Select the Users tab.
3. Click Registration on the main navigation bar, if it is not already selected.
4. Click User Maintenance on the side navigation bar.
The Users window opens.
5. Find the user who’s account you want to define.
6. Click the username.
The User Details window opens.
7. Click Accounts to view or modify the account(s) associated with this user.

50-16 Oracle CRM Application Foundation User Guide


Defining a User’s Enrollment

The Accounts window opens.


8. Perform one of the following actions:
■ Select the check box next to an account that you want to assign to the user.
■ Enter a new account name in the account description field and click Create.
The new account is added to the table.
■ Deselect next to an account that you no longer want to assign to the user.
9. Select the account and click Update.

See Also
■ Viewing All Users
■ Searching for a User
■ Creating a User
■ Editing a User’s Details
■ Deleting a User
■ Defining a User’s Roles
■ Defining a User’s Enrollment

50.14 Defining a User’s Enrollment


Perform the following steps to define a user’s enrollment.

Note: If the user is not defined as a user type in the user


management framework you are not able to define their
enrollments from this window.

Note: If you are viewing your own enrollments, you have access
to available enrollments, that you can register for, depending on
your roles and responsibilities.

Working with Oracle User Management 50-17


Defining a User’s Enrollment

Prerequisites
You must be the system administrator or the primary user of a company with the
appropriate permissions to define a user’s enrollment.

Steps
1. Log in to the CRM System Administrator Console as a system administrator.
2. Select the Users tab.
3. Click User Maintenance on the side navigation bar.
The Users window opens.
4. Find the user who’s role you want to define.
5. Click the username.
The User Details window opens.
6. To edit the user's enrollments, click Enrollments.
The User Enrollment Details window opens.
7. Select the checkbox next to the enrollments you wish to provide and click
Apply. An individual user can sign up for enrollments. The administrator can
also add, revoke, and review a user’s pending enrollments.

8. To cancel enrollment, remove the selection for the enrollments you wish to
remove and click Apply.
9. (Optional) To grant the user delegation capability select the checkbox in the
Delegation column for the enrollment that you want the user to be able to
delegate and click Apply.

Note: The Delegation column only appears if you have the


appropriate role to grant delegations with enrollments.

See Also
■ Viewing All Users
■ Searching for a User
■ Creating a User
■ Editing a User’s Details

50-18 Oracle CRM Application Foundation User Guide


Creating a New Approval

■ Deleting a User
■ Defining a User’s Roles
■ Defining a User’s Account

50.15 Creating a New Approval


An approval is an optional component of the user registration process. Perform the
following steps to create a new approval process.

Prerequisites
You must be the system administrator with the appropriate permissions to create a
new approval.

WARNING: The Use Pending Request Page check box should


only be unchecked if your organization does not plan to use User
Management’s pending approval window and intends to respond
to all approvals through emails and the workflow notification
window.

Steps
1. Log in to the CRM System Administrator Console as a system administrator.
2. Select the Users tab.
3. Click Setup on the main navigation bar.
4. Click Approval Setup.
The Available Approvals window opens.
5. Click Create New Approval.
The Create Approval window opens.
6. Enter the approval information.
a. Enter an Approval Key.
b. Enter a name for the approval.
c. (Optional) Enter a description for the approval.

Working with Oracle User Management 50-19


Creating a New Approval

d. Select a Workflow Item Type from the drop-down list. This list contains all
workflows in the system, however, only those workflows coded to our
standards will work with User Management.
e. Select an Application from the drop-down list.
f. (Optional) Select the Use Pending Request Page check box if you want the
approval to display during the registration process from the "Register Here"
link.
g. Click Next.
The Approver Selection Order window opens.
7. Enter the Approver Selection information.
a. Enter a number to define the order that each approver gets the request.
b. Enter the name of the first approver into the Approver1 field or click Go to
search for an approvers name.
A look up window opens.
c. Enter your search criteria and click Go.
The Search Results appear in the window.
d. Select the option button for the user that you want to be the approver.
e. Click Add User.
The user’s name appears in the text field.
f. (Optional) Enter the name of additional approvers into the other Approver
fields (repeat steps a-e).
g. (Optional) Click Cancel to clear the fields.
h. (Optional) Click add 5 more rows to add five empty approver fields.
8. Click Submit to save.

See Also
■ Removing an Approval
■ Searching for an Approval
■ Editing an Approval’s Details
■ Enabling and Disabling Approvals

50-20 Oracle CRM Application Foundation User Guide


Removing an Approval

■ Searching for an Oraganization


■ Viewing Approval Preferences
■ Updating Approval Preferences

50.16 Removing an Approval


Prerequisites
You must be the system administrator with the appropriate permissions to remove
an approval.

Steps
1. Log in to the CRM System Administrator Console as a system administrator.
2. Select the Users tab.
3. Click Setup on the main navigation bar.
4. Click Approval Setup in the side navigation bar.
The Available Approvals window opens.
5. Select the check box in the Remove column that corresponds to the Approval
that you plan to delete.
6. Click Update to delete the Approval or click Restore to reset the original values
in the window.
A confirmation window opens.
7. Click Confirm and Update Now to delete the Approval or click Cancel to
cancel the deletion.

See Also
■ Creating a New Approval
■ Searching for an Approval
■ Editing an Approval’s Details
■ Enabling and Disabling Approvals
■ Searching for an Organization
■ Viewing Approval Preferences

Working with Oracle User Management 50-21


Searching for an approval

■ Updating Approval Preferences

50.17 Searching for an approval


An approval is an optional component of the user registration process. Perform the
following steps to search for an approval.

Prerequisites
You must be the system administrator with the appropriate permissions to search
for an approval.

Steps
1. Log in to the CRM System Administrator Console as a system administrator.
2. Select the Users tab.
3. Click Setup on the main navigation bar.
4. Click Approval Setup.
The Available Approvals window opens.
5. If you want to search by approval name, then:
a. Select Approval Name from the drop-down list in the Search Approval
area.
b. Enter your search phrase into the text input field.
c. Click Go.
d. View your search results.
6. If you want to search by approval key, then:
a. Select Approval Key from the drop-down list in the Search Approval area.
b. Enter your search phrase into the text input field.
c. Click Go.
d. View your search results.

See Also
■ Creating a New Approval
■ Removing an Approval

50-22 Oracle CRM Application Foundation User Guide


Editing an Approval Details

■ Searching for an Approval


■ Editing an Approval’s Details
■ Enabling and Disabling Approvals
■ Searching for an Organization
■ Viewing Approval Preferences
■ Updating Approval Preferences

50.18 Editing an Approval Details


An approval is an optional component of the user registration process. Perform the
following steps to edit an approval's details.

Prerequisites
You must be the system administrator or the primary user with the appropriate
permissions to edit an approval’s details.

Steps
1. Log in to the CRM System Administrator Console as a system administrator.
2. Select the Users tab.
3. Click Setup on the main navigation bar.
4. Click Approval Setup.
The Available Approvals window opens.
5. Click the name of the approval in the Approval Name column.
The Update Approval window opens.
6. Edit the fields as desired and click Next.
7. Edit the information in the Update Approval window and click Next.
8. Edit the information in the approver selection order window and click Submit.
The information is updated.

See Also
■ Creating a New Approval

Working with Oracle User Management 50-23


Enabling and Disabling Approval

■ Removing an Approval
■ Searching for an Approval
■ Editing an Approval’s Details
■ Enabling and Disabling Approvals
■ Searching for an Organization
■ Viewing Approval Preferences
■ Updating Approval Preferences

50.19 Enabling and Disabling Approval


Approvals can be enabled or disabled at any time. Perform the following steps to
enable or disable an approval.

Prerequisites
You must be the system administrator of a company with the appropriate
permissions to change to status of an approval.

Steps
1. Log in to the CRM System Administrator Console as a system administrator.
2. Select the Users tab.
3. Click Setup on the main navigation bar.
4. Click Approval Setup.
The Available Approvals window opens.
5. If you want to enable an approval, select Enabled from the drop-down list in
the corresponding Status column.
6. If you want to disable an approval, select Disabled from the drop-down list in
the corresponding Status column.
7. Click Update to modify the status of the approval or click Restore to reset the
original values in the window.
A confirmation window opens.
8. Click Confirm and Update All to modify the status.

50-24 Oracle CRM Application Foundation User Guide


Searching for an Organization

See Also
■ Creating a New Approval
■ Removing an Approval
■ Searching for an Approval
■ Editing an Approval’s Details
■ Enabling and Disabling Approvals
■ Viewing Approval Preferences
■ Updating Approval Preferences

50.20 Searching for an Organization


Perform the following steps to search for an organization.

Prerequisites
You must be the system administrator with the appropriate permissions to search
for an organization.

Steps
1. Log in to the CRM System Administrator Console as a system administrator.
2. Select the Users tab.
3. Click Setup on the main navigation bar.
4. Click Approval Setup.
The Available Approvals window opens.
5. Click Organization in the side navigation bar.
The Organization window opens.
6. Select Organization Name, Company Number, or DUNS Number from the
Enter Search Criterion drop-down list.
7. Enter a minimum of three characters into to the search field.
The "%" and "_" (underscore) symbols are wildcards.
8. Click Go.
A list of search results appears in the window.

Working with Oracle User Management 50-25


Viewing Approval Preferences

9. Click the column heading to sort the row.

See Also
■ Creating a New Approval
■ Removing an Approval
■ Searching for an Approval
■ Editing an Approval’s Details
■ Enabling and Disabling Approvals
■ Viewing Approval Preferences
■ Updating Approval Preferences

50.21 Viewing Approval Preferences


Use the approval preferences window to define an approval list for a specific
organization. Perform the following steps to enable or disable an approval.

Prerequisites
You must be the system administrator with the appropriate permissions to view
approval preferences.

Steps
1. Log in to the CRM System Administrator Console as a system administrator.
2. Select the Users tab.
3. Click Setup on the main navigation bar.
4. Click Approval Setup.
The Available Approvals window opens.
5. Click Organization in the side navigation bar.
The Organization window opens.
6. Search for an organization.
a. Select Organization Name, Company Number, or DUNS Number from the
Enter Search Criterion drop-down list.
b. Enter a minimum of three characters into to the search field.

50-26 Oracle CRM Application Foundation User Guide


Updating Approval Preferences

The "%" and "_" (underscore) symbols are wildcards.


c. Click Go.
A list of search results appears in the window.
7. Click the Organization Name.
The Approval Preferences window opens with a list of approval definitions for
the specified organization.

See Also
■ Creating a New Approval
■ Removing an Approval
■ Searching for an Approval
■ Editing an Approval’s Details
■ Enabling and Disabling Approvals
■ Searching for an Organization
■ Updating Approval Preferences

50.22 Updating Approval Preferences


Perform the following steps to update the organization’s approval list.

Prerequisites
You must be the system administrator or the primary user with the appropriate
permissions to update approval preferences for an organization.

Steps
1. Log in to the CRM System Administrator Console as a system administrator.
2. Select the Users tab.
3. Click Setup on the main navigation bar.
4. Click Approval Setup.
The Available Approvals window opens.
5. Click Organization in the side navigation bar.

Working with Oracle User Management 50-27


Updating Approval Preferences

The Organization window opens.


6. Search for an organization.
a. Select Organization Name, Company Number, or DUNS Number from the
Enter Search Criterion drop-down list.
b. Enter a minimum of three characters into to the search field.
The "%" and "_" (underscore) symbols are wildcards.
c. Click Go.
A list of search results appear in the window.
7. Click the Organization Name.
The Approval Preferences window opens.
8. Click the approval list that you want to update.
The Approver Selection Order window for the organization opens.
9. Enter the Approver Selection information.
a. Enter a number to define the order that each approver gets the request.
b. Enter the name of the first approver into the Approver1 field or click Go to
search for an approvers name.
c. Enter your search criteria and click Go.
The Search Results appear in the window.
d. Select the option button for the user that you want to be the approver.
e. Click Add User.
The user’s name appears in the text field.
f. (Optional) Enter the name of additional approvers into the other Approver
fields (repeat steps a-e).
g. (Optional) Click Cancel to clear the fields.
h. (Optional) Click add 5 more rows to add five empty approver fields.
10. Click Submit to save.

See Also
■ Creating a New Approval

50-28 Oracle CRM Application Foundation User Guide


Creating an Enrollment

■ Removing an Approval
■ Searching for an Approval
■ Editing an Approval’s Details
■ Enabling and Disabling Approvals
■ Searching for an Oraganization
■ Viewing Approval Preferences

50.23 Creating an Enrollment


An enrollment is an optional step in the user registration process. From the Create
Enrollment window, you can define enrollments and approvals for enrollments.
Each enrollment may or may not have a role associated with it. Perform the
following steps to create an enrollment.

Prerequisites
You must be the system administrator or the primary user with the appropriate
permissions to create an enrollment.

Steps
1. Log in to the CRM System Administrator Console as a system administrator.
2. Select the Users tab.
3. Click Setup on the main navigation bar.
4. Click Enrollments in the side navigation bar.
The Available Enrollments window opens.
5. Click Create New Enrollment.
The Create Enrollment window opens.
6. Define the following information:
a. Enter an Enrollment Key.
b. Enter a name for the new enrollment.
c. (Optional) Enter a description for the new enrollment. This description can
include HTML tags for style. There is a 2000 character limit in the field that
includes all HTML tags.

Working with Oracle User Management 50-29


Removing an Enrollment

7. Select roles and responsibilities.


a. Select a responsibility from the Responsibility drop-down list. If no
responsibility is required, choose No Responsibility is Required.
b. Select the name of a role in the Available list and click > to move it to the
Assigned list. You can hold down the [CTRL] key and use your mouse to
select multiple roles.
c. Repeat the previous step to add more roles to the list.
d. To move all Available Roles to the Assigned Roles list, then click >> or to
move all Assigned Roles to the Available Roles list, then click <<.
e. Select an application from the drop-down list.
f. Select an approval from the drop-down list. If no approvals are required for
the user to subscribe to the service, choose No Approval Required.
g. Select an enrollment template from the drop-down list.
8. (Optional) Click Reset to clear the fields.
9. Click Create to save your changes.
A confirmation appears stating the enrollment was created successfully.

See Also
■ Defining a User’s Enrollment
■ Removing an Enrollment
■ Enabling and Disabling Enrollments
■ Editing an Enrollment’s Details

50.24 Removing an Enrollment


Perform the following steps to delete an enrollment.

Prerequisites
You must be the system administrator with the appropriate permissions to delete an
enrollment.

Steps
1. Log in to the CRM System Administrator Console as a system administrator.

50-30 Oracle CRM Application Foundation User Guide


Enabling and Disabling Enrollments

2. Select the Users tab.


3. Click Setup on the main navigation bar.
4. Click Enrollments in the side navigation bar.
The Available Enrollments window opens.
5. Select the check box in the Remove column that corresponds to the enrollment
that you plan to delete.
6. Click Update to remove the enrollment or click Restore to reset the original
values in the window.
A confirmation window opens.
7. If you are sure you want to delete the enrollment, click Confirm and Update
Now.

See Also
■ Defining a User’s Enrollment
■ Enabling and Disabling Enrollments
■ Editing an Enrollment’s Details
■ Creating and Disabling Enrollments

50.25 Enabling and Disabling Enrollments


An enrollment is an optional step in the user registration process. Perform the
following steps to enable or disable an enrollment.

Prerequisites
You must be the system administrator with the appropriate permissions to modify
the status of an enrollment.

Steps
1. Log in to the CRM System Administrator Console as a system administrator.
2. Select the Users tab.
3. Click Setup on the main navigation bar.
4. Click Enrollments in the side navigation bar.

Working with Oracle User Management 50-31


Editing an Enrollment's Details

The Available Enrollments window opens.


5. If you want to enable an enrollment, select Enabled from the drop-down list in
the corresponding Status column.
6. If you want to disable an enrollment, select Disabled from the drop-down list
in the corresponding Status column.
7. Click Update to modify the information or click Restore to reset the original
values in the window.
A confirmation window opens.
8. Click Confirmed and Update Now.
The enrollment status is modified.

See Also
■ Defining a User’s Enrollment
■ Removing an Enrollment
■ Creating and Disabling Enrollments
■ Editing an Enrollment’s Details

50.26 Editing an Enrollment's Details


An enrollment is an optional step in the user registration process. Perform the
following steps to edit an enrollment's details.

Prerequisites
You must be the system administrator with the appropriate permissions to edit an
enrollment’s details.

Steps
1. Log in to the CRM System Administrator Console as a system administrator.
2. Select the Users tab.
3. Click Setup on the main navigation bar.
4. Click Enrollments in the side navigation bar.
The Available Enrollments window opens.
5. Click the name of the enrollment.

50-32 Oracle CRM Application Foundation User Guide


Creating a User Type

The Update Enrollment window opens.


6. Edit the fields as desired and click Next.
7. Select the Assign the changed role to existing users of this Enrollment check
box if you want previously registered users to be granted the specified role.
8. Assign new roles as needed.
9. Select the Assign the changed responsibility to existing users of this
Enrollment check box if you want previously registered users to be granted the
specified responsibility.
10. (Optional) Click Reset to reset the fields to their original settings or click
Update to save your changes.
A confirmation window opens.

See Also
■ Defining a User’s Enrollment
■ Enabling and Disabling Enrollments
■ Removing an Enrollment’s Details
■ Creating and Disabling Enrollments

50.27 Creating a User Type


A user type is a category of users based on common responsibilities and roles.
Oracle ships the following predefined user types out-of-the-box:
■ primary user
■ business user
■ individual user
Each user type is assigned predefined enrollments that include different roles,
responsibilities and availability. Legacy users that uptake the new user management
framework, no longer have access to the default roles and responsibilities windows.
The user type definition replaces these windows. Roles and responsibilities defined
at the user level are the default.
Creating a new user type is a multi-step process. The following table lists the three
pages needed to create a user type.

Working with Oracle User Management 50-33


Creating a User Type

Necessary User Type Information


Page Information Description
Details ■ Description ■ Optional description of user type
■ Enable Self-Service Registration ■ Checkbox
■ Registration Template ■

■ Application ■

■ Approval by ■

You also can change the User Type


name here.
Credentials ■ Default Responsibility ■

■ Default Roles ■

■ Role delegation ■ Checkbox


Enrollments ■ Enrollment name ■

■ Activate (Yes or No) ■

■ Availability ■

■ Order the active enrollments ■

Perform the following steps to create a new user type.

Prerequisites
You must be the system administrator with the appropriate permissions to create a
new user type.

Note: If you deselect the Enable Self-service Registration check


box when you create a new user type, the user type does not appear
in the self-service registration window when you click the "Register
Here" link unless the user has the JTF_SECURITY_ASSIGN_ROLE
permission.
At runtime, the system validates that the user has this permission,
if not, it confirms if the check box is selected and only shows the
user types that are available for self-service.

50-34 Oracle CRM Application Foundation User Guide


Creating a User Type

Navigation
Log in to the CRM System Administrator Console as a system administrator,
navigate to Users>Setup>User Types, and click Create New User Type.

Steps
1. Enter the details for the user type:
a. Enter a user type name.
b. Enter a user type key.
c. (Optional) Enter a description into the Description field. This description
can include HTML tags for style. There is a 2000 character limit in the field
that includes all HTML tags.
d. (Optional) Select Enable Self-service Registration to display the new user
type during the registration process from the "Register Here" link.
e. Enter the order in which you want the user type to be displayed.
f. Select the default registration template and default application from the
drop-down lists.
g. Select the approval by information from the drop-down list and click Next.
2. Enter the credentials for the user type:
a. Select a default responsibility from the drop-down menu. This determines
the default login page for the user.
b. Assign a default role to the user. This determines the default level of
functional ability for the user.
3. Enter the enrollments for the user and click Next:
a. Choose Yes or No from the Activate drop-down list next to the enrollment
name.
b. Determine the enrollment’s availability by choosing either Automatic,
Delegation & Self Service, Delegation Only, or Self Service from the
drop-down menu. These values are explained in the Enrollments section of
this document.
c. Enter the order in which you with the enrollment to appear in the Order
field.

Working with Oracle User Management 50-35


Removing a User Type

See Also
■ Removing a User Type
■ Activating and Deactivating User Types
■ Searching for a User Type
■ Editing a User Type’s Details

50.28 Removing a User Type


A user type is a category of users based on common responsibilities and roles. A
user type can be removed as long as it is not enabled (in use). Perform the following
steps to remove a user type.

Prerequisites
You must be the system administrator with the appropriate permissions to remove a
user type.

Steps
1. Log in to the CRM System Administrator Console as a system administrator.
2. Select the Users tab.
3. Click Setup on the main navigation bar.
4. Click User Types in the side navigation bar.
The Available User Types window opens.
5. Select the check box in the Remove column that corresponds to the user type
that you want to delete.
6. Click Update to delete the User Type or click Restore to reset the original values
in the window.
A confirmation window opens.
7. Click Confirm to delete the User Type or click Cancel to cancel the deletion.

See Also
■ Creating a User Type
■ Activating and Deactivating User Types
■ Searching for a User Type

50-36 Oracle CRM Application Foundation User Guide


Searching for a User Type

■ Editing a User Type’s Details

50.29 Activating and Deactivating User Types


A user type is a category of users based on common responsibilities and roles.
Perform the following steps to activate or deactivate a user type.

Prerequisites
You must be the system administrator with the appropriate permissions to modify
the status of a user type.

Steps
1. Log in to the CRM System Administrator Console as a system administrator.
2. Select the Users tab.
3. Click Setup on the main navigation bar.
4. Click User Types in the side navigation bar.
The Available User Types window opens.
5. If you want to activate an enrollment, select Active from the drop-down list in
the corresponding Status column.
6. If you want to deactivate an enrollment, select Inactive from the drop-down list
in the corresponding Status column.
7. Click Update to modify the status of the user type or click Restore to reset the
original values in the window.

See Also
■ Creating a User Type
■ Removing a User Type
■ Searching for a User Type
■ Editing a User Type’s Details

50.30 Searching for a User Type


A user type is a category of users based on common responsibilities and roles.
Perform the following steps to search for a user type.

Working with Oracle User Management 50-37


Editing a User Type's Details

Prerequisites
You must be the system administrator with the appropriate permissions to search
for a new user type.

Steps
1. Log in to the CRM System Administrator Console as a system administrator.
2. Select the Users tab.
3. Click Setup on the main navigation bar.
4. Click User Types in the side navigation bar.
The Available User Types window opens.
5. If you want to search by the User Type Name, then:
a. Enter your search phrase into the text input field.
b. Click Go.
The results appear in the window.
6. If you want to search by the User Type Key, then:
a. Enter your search phrase into the text input field.
b. Click Go.
The results appear in the window.

See Also
■ Creating a User Type
■ Removing a User Type
■ Activating and Deactivating User Types
■ Editing a User Type’s Details

50.31 Editing a User Type's Details


A user type is a category of users based on common responsibilities and roles.
Perform the following steps to edit a user type's details.

50-38 Oracle CRM Application Foundation User Guide


Editing a User Type's Details

Prerequisites
You must be the system administrator with the appropriate permissions to modify
the user type’s details.

Steps
1. Log in to the CRM System Administrator Console as a system administrator.
2. Select the Users tab.
3. Click Setup on the main navigation bar.
4. Click User Types in the side navigation bar.
The Available User Types window opens.
5. Click the name of the user type in the User Type Name column.
The User Type Details window opens.
6. Edit the fields as desired.
7. (Optional) Click Clear to reset the fields to their original settings.
8. Click Next to save and go on to the next form.
The Roles and Responsibilities window opens.
9. Edit the information as needed.
a. Use the drop-down list to select a user type responsibility.
b. (Optional) Select the Assign the changed responsibility to existing users
of this user type check box if you want other users registered under this
user type to be granted the responsibility specified.
c. To assign roles, select the name of a role in one list and then click > or < to
move it to the other list. Repeat this step for as many roles you want to
assign.
d. If you want to move all Available Roles to the Assigned Roles list, then click
>>.
e. If you want to move all Assigned Roles to the Available Roles list, then click
<<.
f. (Optional) Select the Assign the changed role to existing users of this user
type check box if you want other users registered under this user type to be
granted the role specified.

Working with Oracle User Management 50-39


Creating a Template

10. Click Next to save and go on to the next form or click Restore to revert back to
the original values in the window.
The Enrollments window opens.
11. Edit the information as needed.

a. If you want to enroll the user type in an enrollment, select Yes from the
drop-down list in the Enroll column.
b. If you do not want to enroll the user type in an enrollment, select No from
the drop-down list in the Enroll column.
c. Select Automatic or Self-service from the drop-down lists to define the
type.
d. Enter a number into the fields in the Order column to set enrollment order.
e. If you want to edit an enrollment's details, then click the name of the
enrollment.
12. Click Next to save and go on to the next form or click Restore to revert back to
the original values in the window.
The User Types window opens with the newly updated user type information.

See Also
■ Creating a User Type
■ Removing a User Type
■ Activating and Deactivating User Types
■ Searching for a User Type

50.32 Creating a Template


A template is an application-specific set of JSPs that you can use to customize the
user registration process. There are two template categories, user types and
enrollments. Perform the following steps to create a template.

Prerequisites
You must be the system administrator with the appropriate permissions to create a
new template.

50-40 Oracle CRM Application Foundation User Guide


Creating a Template

Steps
1. Log in to the CRM System Administrator Console as a system administrator.
2. Select the Users tab.
3. Click Setup on the main navigation bar.
4. Click Templates on the side navigation bar.
The Available Templates window opens.
5. Click Create New Template.
The Create Template window opens.
6. Enter the following required information.
a. Enter the template key.
b. Enter a name for the template.
c. (Optional) Enter a description for the template.
d. Select a template type from the drop-down list. Options include user type
template or enrollment template.
e. Enter the name of the template handler. The template handler is a java class
implemented by the application to handle the registration data at runtime.
f. Enter the name of JSP page that is the first window of the template flow
into the Page Name field. The extension of the window must be ".jsp".
g. Select an application from the drop-down list.
7. (Optional) Click Reset to clear the fields.
8. Click Create to save your information.

See Also
■ Removing a Template
■ Enabling and Disabling Templates
■ Editing a Template’s Details
■ Searching for a Template

Working with Oracle User Management 50-41


Removing a Template

50.33 Removing a Template


A template is an application-specific set of JSPs that you can use to customize the
user registration process. Perform the following steps to delete a template.

Prerequisites
You must be the system administrator with the appropriate permissions to remove a
template.

Steps
1. Log in to the CRM System Administrator Console as a system administrator.
2. Select the Users tab.
3. Click Setup on the main navigation bar.
4. Click Templates on the side navigation bar.
The Available Templates window opens.
5. Select the check box in the Remove column that corresponds to the template
that you want to delete.
6. Click Update to delete the template or click Restore to reset the original values
in the window.
A confirmation window opens.
7. Click Confirm Update to delete the template or click Cancel to return to the
Available Templates window.

See Also
■ Creating a Template
■ Enabling and Disabling Templates
■ Editing a Template’s Details
■ Searching for a Template

50.34 Enabling and Disabling Templates


A template is an application-specific set of JSPs that you can use to customize the
user registration process. A template can be assigned to many enrollments and user
types. Perform the following steps to enable or disable a template.

50-42 Oracle CRM Application Foundation User Guide


Editing a Template's Details

Prerequisites
You must be the system administrator with the appropriate permissions to modify
the status of a template.

Steps
1. Log in to the CRM System Administrator Console as a system administrator.
2. Select the Users tab.
3. Click Setup on the main navigation bar.
4. Click Templates on the side navigation bar.
The Available Templates window opens.
5. If you want to enable a template, select Enabled from the drop-down list in the
corresponding Status column.
6. If you want to disable a template, select Disabled from the drop-down list in
the corresponding Status column.
7. Click Update to modify the template’s status or click Restore to reset the
original values in the window.
A confirmation window opens.
8. Click Confirm Update to modify the template’s status or click Cancel to return
to the Available Templates window.

See Also
■ Creating a Template
■ Removing a Template
■ Editing a Template’s Details
■ Searching for a Template

50.35 Editing a Template's Details


A template is an application-specific set of JSPs that you can use to customize the
user registration process. Perform the following steps to edit a template's details.

Working with Oracle User Management 50-43


Searching for a Template

Prerequisites
You must be the system administrator with the appropriate permissions to modify a
template’s details.

Steps
1. Log in to the CRM System Administrator Console as a system administrator.
2. Select the Users tab.
3. Click Setup on the main navigation bar.
4. Click Templates on the side navigation bar.
The Available Templates window opens.
5. Click the name of the template in the Template Name column.
The User Management: Update Template window opens.
6. Edit the fields as desired.
7. (Optional) Click Clear to reset the fields to their original settings.
8. Click Update to save your changes.

See Also
■ Creating a Template
■ Removing a Template
■ Enabling and Disabling Templates
■ Searching for a Template

50.36 Searching for a Template


A template is an application-specific set of JSPs that you can use to customize the
user registration process. Perform the following steps to search for a template.

Prerequisites
You must be the system administrator with the appropriate permissions to search
for a template.

Steps
1. Log in to the CRM System Administrator Console as a system administrator.

50-44 Oracle CRM Application Foundation User Guide


Searching for a Template

2. Select the Users tab.


3. Click Setup on the main navigation bar.
4. Click Templates on the side navigation bar.
The Available Templates window opens.
5. Select how you want to search for the template. Options include Template
Name or Template Key from the drop-down list.
6. Enter your search criteria into the text field.
7. Click Go.
Your search results appear in the window.

See Also
■ Creating a Template
■ Removing a Template
■ Enabling and Disabling Template
■ Editing a Template’s Details

Working with Oracle User Management 50-45


Searching for a Template

50-46 Oracle CRM Application Foundation User Guide


Part XII
Appendices

This part of the Oracle CRM Application Foundation User Guide contains the
following chapters:
■ Oracle Resource Manager User Interface Reference
■ Oracle Notes User Interface Reference
■ Oracle Territory Manager User Interface Reference
■ Oracle Task Manager User Interface Reference
■ Oracle HTML Calendar User Interface Reference
■ Oracle Interaction History User Interface Reference
■ Oracle Escalation Management User Interface Reference
A
Oracle Resource Manager User Interface
Reference

This appendix contains user interface object descriptions of the HTML version of
Resource Manager.

A.1 Employees
The following table describes field descriptions in the Employee window with the
CRM Application Foundation User responsibility.

Table A–1 Employee Window Description


UI Object Name Type Description
Preferred Name Hyperlink Click this link to access the details for
the resource selected.
Employee Number Text Field This read-only text field displays the
employee number for the resource.
Job Title Hyperlink Click this link to access the
organization window.
Work Phone Text Field This read-only text field displays the
phone number for the resource.
Email Hyperlink Click this link to send an email
message to the resource.
Manager Text Field This read-only text field displays the
manager name for the resource.
Quick Find Drop-down Use the drop-down list to select
search criteria for an employee
resource.

Oracle Resource Manager User Interface Reference A-1


Advanced Search

Table A–1 Employee Window Description


UI Object Name Type Description
Quick Find Value Text Field Enter the search value for the search
or enter% in the text field to search
all employee resources. There must
be a minimum of three characters
entered for the search.
Go Button Click this button to execute the
search based upon the criteria chosen
in the Quick Find field. The Results
appear in the Resource Summary
window.
Advanced Search Hyperlink Click this link to access the
Advanced Search window.

A.2 Advanced Search


The following table describes field descriptions in the Advanced Search for
Employees window.

Table A–2 Advanced Search Window Description


UI Object Name Type Description
First Name Text Field Enter a partial or complete first name
for the search in the text field. This
field is case insensitive.
Last Name Text Field Enter a partial or complete last name
for the search in the text field. This
field is case insensitive.
User Name Text Field Enter a complete or partial user
name for the search in the text field.
This field is case insensitive.
Email Text Field Enter a complete or partial email
address for the search in the text
field. This field is case sensitive.
Employee Number Text Field Enter an employee number for the
search in the text field.
Job Title Text Field Enter a partial or complete title for
the search in the text field. This field
is case insensitive.

A-2 Oracle CRM Application Foundation User Guide


Resource Detail

Table A–2 Advanced Search Window Description


UI Object Name Type Description
Work Phone Text Field Enter the partial or complete phone
number for the search in the text
field.
Manager Name Text Field Enter a partial or complete name for
the search in the text field. This field
is case insensitive.
Search Button Click this button to execute the
search and access the search results
in the Resource Detail window.
Clear Button Click this button to refresh the
window and revert back to the
original values.

A.3 Resource Detail


The following table describes field descriptions in the Resource Detail window.

Table A–3 Resource Details Window Description


UI Object Name Type Description
Resource Details Text Field This read-only text field displays the
name of the selected resource.
Update Button Click this button to update personal
information.
Restore Button Click this button to refresh the
window and revert back to the
original values.

Oracle Resource Manager User Interface Reference A-3


Resource Detail

Table A–3 Resource Details Window Description


UI Object Name Type Description
Preferred Name Text Field Enter or update the preferred name.
Depending upon the administration
set up, you can update the resource
name in one of four ways:
■ No update/read-only
■ Update with an FYI notification
only
■ Update with an approval
workflow
■ Update with no notification or
workflow required
Job Title Text Field This read-only text field displays the
resource title, which comes from HR.
Email Text Field Enter the email address. No
validation is performed on the email
address.
Work phone Text Field Enter the work phone number in any
format.
Mobile Text Field This field is for cell phone numbers.
Pager Text Field This field is for pager numbers.
User Name Text Field This read-only text field displays the
user name for the resource.
Salesperson Number Text Field This read-only text field displays the
salesperson number for the resource.
Sales Credit Type Text Field This read-only text field displays the
sales credit type for the resource.
Start Date Text Field This read-only text field displays the
start date for the resource.
End Date Text Field This read-only text field displays the
end date for the resource.
Employee Number Text Field This read-only text field displays the
employee number.
Resource Number Text Field This read-only text field displays the
Resource Number.

A-4 Oracle CRM Application Foundation User Guide


Resource Detail Administrator

Table A–3 Resource Details Window Description


UI Object Name Type Description
Work Address List of Values Use the list of values to select
another work address location.
Office Text Field Enter your office number.
Mailstop Text Field Enter your mailstop number.
Location Text Field Enter your office location.
Manager Hyperlink Click this link to view the resource
manager’s details.

A.4 Resource Detail Administrator


The following table describes field descriptions in the Resource Detail
Administrator window.

Table A–4 Resource Detail Administrator Window Description


UI Object Name Type Description
Resource Details Text Field This read-only text field displays the
name of the resource.
Update Button Click this button to save changes
made to the resources personal
information.
Restore Button Click this button to refresh the
window and revert back to the
original values.
Preferred Name Text Field Enter or update the preferred name.
(Required) Depending upon the Administration
set up, you can update the resource
name in one of four ways:
■ No update or read-only
■ Update with an FYI notification
only
■ Update with an approval
workflow
■ Update with no notification or
workflow required

Oracle Resource Manager User Interface Reference A-5


Resource Detail Administrator

Table A–4 Resource Detail Administrator Window Description


UI Object Name Type Description
Job Title Text Field Enter or edit the title for the resource
selected.
Email Text Field Enter or edit the email address. No
validation is performed on the email
address.
Work Phone Text Field Enter or edit the work phone number
in any format they choose.
Mobile Text Field This field is for cell phone numbers.
Pager Text Field This field is for pager numbers.
User Name Text Field Enter or edit the user name.
Validation occurs on the
update/save to ensure that no
duplicate user names are created.
Salesperson Number Text Field Enter or edit the salesperson number
(Required) for the selected resource. Validation
occurs on the update and save action
to ensure that no duplicate
salesperson numbers are created.
Sales Credit Type Text Field Enter or edit the sales credit type for
(Required) the selected resource.
Start Date Text Field This text field displays the start date
for the resource.
End Date Text Field This text field displays the end date
for the resource selected.
Source Number Text Field This read-only text field displays the
employee number.
Resource Number Text Field This read-only text field displays the
number.
Work Address List of Values Use the list of values to select
another work address location.
Office Text Field Enter the office number.
Mailstop Text Field Enter the mailstop number.
Location Text Field Enter the office location.
Manager Hyperlink Click the manager’s name to display
his or her details.

A-6 Oracle CRM Application Foundation User Guide


Resource Detail Administrator

Table A–4 Resource Detail Administrator Window Description


UI Object Name Type Description
Role Type Text Field Enter or edit the role type for the
roles that have been assigned to the
resource selected. Validation occurs
so that the same role can’t be played
by more than one resource at the
same time.
Roles Text Field Enter or edit the roles that have been
(Required) assigned to the selected resource.
Start Date Text Field Enter the start date for the group role
(Required) membership. If you add a new role,
the start date defaults to the current
date.
Date Picker Icon Click the icon to access the date
picker and select the start date.
End Date Text Field Enter the end date for the role
membership.If you are adding a new
role, then the end date defaults to an
open end date.
Date Picker Icon Click the icon to access the date
picker and select the start date.
Group Text Field Enter a new group membership for
(Required) the employee, or end date the
current group role membership.
Role Type Text Field Enter or edit the role type for the
roles that have been assigned to the
resource selected for the group.
Role Text Field Enter or edit the roles that have been
assigned to the selected resource for
the group.
Start Date Text Field Enter the start date for the group role
membership.The start date
represents the start date for the
group role membership. If you are
adding a new group membership the
start date defaults to the current
date.

Oracle Resource Manager User Interface Reference A-7


Resource Detail Read-only

Table A–4 Resource Detail Administrator Window Description


UI Object Name Type Description
Date Picker Icon Enter the start date for the group role
membership. If you add a new role,
the start date defaults to the current
date.
End Date Text Field Enter the end date for the group role
membership which represents the
end date for the group role
membership. If you are adding a
new group membership, then the
end date defaults to an open end
date.
Date Picker Icon Enter the start date for the group role
membership. If you add a new role,
the end date defaults to the current
date.

A.5 Resource Detail Read-only


The following table describes field descriptions in the Resource Detail Read-only
window.

Table A–5 Resource Detail Read-only Window Description


UI Object Name Type Description
Resource: Resource Name Text Field This read-only text field displays the
name of the resource.
Close Button Click this button to close the
window.
Preferred Name Hyperlink Click this link to view the resource
details.
Title Text Field This read-only text field displays the
title for the resource.
Email Hyperlink Click this link to send an email to the
address provided.
Work Phone Text Field This read-only text field displays the
work phone number.
Category Text Field This read-only text field displays the
resource category.

A-8 Oracle CRM Application Foundation User Guide


Resource Detail Read-only

Table A–5 Resource Detail Read-only Window Description


UI Object Name Type Description
User Name Text Field This read-only text field displays the
user name for the resource.
Salesrep Number Text Field This read-only text field displays the
salesperson number for the resource.
Sales Credit Type Text Field This read-only text field displays the
sales credit type for the resource.
Start Date Text Field This read-only text field displays the
start date for the resource.
End Date Text Field This read-only text field displays the
end date for the resource.
Employee Number Text Field This read-only text field displays the
employee number.
Resource Number Text Field This read-only text field displays the
resource number.
Work Address List of Values This read-only text field displays the
employee’s work location.
Office Text Field This read-only text field displays the
office number.
Mailstop Text Field This read-only text field displays the
mailstop number.
Location Text Field This read-only text field displays the
office location.
Manager Hyperlink Click this link to view the manager’s
information in a read-only format.
Role Type Text Field This read-only text field displays the
role type for the roles that have been
assigned to the resource.
Role Text Field This read-only text field displays the
roles that have been assigned to the
resource.
Start Date Text Field This read-only text field displays the
start date for the role.
End Date Text Field This read-only text field displays the
end date for the role.

Oracle Resource Manager User Interface Reference A-9


Resource Detail Confirmation

Table A–5 Resource Detail Read-only Window Description


UI Object Name Type Description
Group Name Text Field This read-only text field displays the
group name.
Role Type Text Field This read-only text field displays the
role type associated with the group.
Role Text Field This read-only text field displays the
roles associated with the group.
Start Date Text Field This read-only text field displays the
date when the resource became a
member of the particular group.
End Date Text Field This read-only text field displays the
end date for the role played in the
particular group.
Show History Button Click this button to display the
complete history of the group
memberships for the resource in
read-only format.

A.6 Resource Detail Confirmation


The following table describes field descriptions in the Resource Detail Confirmation
window.

Table A–6 Resource Detail Confirmation Window Description


UI Object Name Type Description
Resource Detail for Text Field This read-only text field displays the
<name> Updated name of the resource whose
Successfully information was just updated and
serves as a confirmation that the
update was successful (pending
approvals/notifications, if required).
Close Button Click this button to close the
confirmation window and return to
the Resource Detail window.

A-10 Oracle CRM Application Foundation User Guide


Create An Employee Resource

A.7 Create An Employee Resource


The following table describes field descriptions in the Create An Employee
Resource window.

Table A–7 Create An Employee Resource Window Description


UI Object Name Type Description
Create Button Click this button to save the resource
information. Once you click the
button, a confirmation window
displays detailing the new resource
and employee number.
Last Name Text Field Enter the employee’s last name.
(Required)
First Name Text Field Enter the employee’s first name.
Middle Name Text Field Enter the employee’s middle name.
User Name Text Field Enter a user name for the employee.
(Required) Validation occurs upon update to
ensure that no duplicate user names
are created.
Work Phone Text Field Enter the employee’s work phone
number.
Title Drop-down Use the drop-down list to select a
personal title for the employee.
Option include: Mr., Mrs., Ms., and
Dr.
Job Title List of Values Select a job title from the list of
values.
Go Button Click this button to search for a job
title.
Email Text Field Enter the employee’s email address.
No validation occurs on the email
address.
Start Date Text Field Enter the start date for the employee.
(Required)

Oracle Resource Manager User Interface Reference A-11


Define Resource Fields for Update

Table A–7 Create An Employee Resource Window Description


UI Object Name Type Description
Date Picker Icon Click the icon to access the date
picker and select the start date. The
date automatically populates into the
start date field for the group
membership.
End Date Text Field Enter the end date for the employee.
Date Picker Icon Click the icon to access the date
picker and select the end date. The
date automatically populates into the
end date field for the group
membership.
Gender Option Button Select the gender for the employee.
Options include: male, female, and
unknown. The default is male.
Salesperson Number Text Field Enter the salesrep number for the
(Required) employee. Validation occurs upon
update to ensure that no duplicate
salesrep numbers are created.
Sales Credit Type Drop-down Use the drop-down list to select the
(Required) sales credit type for the employee.
Work Address Drop-down Use the drop-down list to select
work address location.
Mailstop Text Field Enter the employee’s mailstop
number.
Office Text Field Enter the employee’s office number.
Location Text Field Enter the employee’s office location.
Manager Text Field Enter the employee’s manager name.
Go Button Click this button to look up the
manager’s name. Once selected, the
manager’s name populates the field.

A.8 Define Resource Fields for Update


The following table describes field descriptions in the Define Resource Fields for
Update window.

A-12 Oracle CRM Application Foundation User Guide


Define Resource Fields for Update

Table A–8 Define Resource Fields for Update Window Description


UI Object Name Type Description
Preferred Name Option Button Select the option button to determine
the update status for this field. This
allows resources to enter and
maintain their full name information.
Work Address Option Button Select the option button to determine
the update status for this field.
Resources can enter and maintain
their work address information.
Work Phone Number Option Button Select the option button to determine
the update status for this field.
Resources can enter and maintain
their work phone information.
Mobile Text Enter the cell number in this field.
Pager Text Enter the pager number in this field.
Email Text Enter the email address in this field.
Mailstop Text Enter the mailstop number in this
text field.
Office Text Enter the office name in this text
field.
Location Text Enter the work location in this text
field.
Time Zone Option Button Use the option button menu to select
the correct time zone.
Support Site Option Button Use the option button menu to select
the support site location.
Primary Language Option Button Use the option button menu to select
the primary language.
Secondary Language Option Button Use the option button menu to select
the secondary language.
Rate Text Enter the resources rate in this field.
Update Button Click the button to save changes
made to your preferences.
Restore Button Click this button to refresh the
window and revert back to the
original values.

Oracle Resource Manager User Interface Reference A-13


Group Summary Window

A.9 Group Summary Window


The following table describes field descriptions in the Group Summary window.

Table A–9 Group Summary Window Description


UI Object Name Type Description
Create Button Click this button to access the Create
Group window and create a new
group.
Group Name Hyperlink Click this link to view the groups
details.
Description Text Field This read only text field is the
description of the group.
Start date Text Field This read only text field displays the
start date of the group.
End Date Text Field This read-only text field displays the
end date of the group.
Parent Hyperlink Click this link to view the group’s
parent information.
Child Hyperlink Click this link to view the group’s
child information.

A.10 Create Group


The following table describes field descriptions in the Create Group window.

Table A–10 Create Group Window Description


UI Object Name Type Description
Name Text Field Enter the name of the group in the
(Required) text field.
Description Text Field Enter the description of the group in
the text field.
Start Date Text Field Enter the start date of the group in
(Required) the text field.
Date Picker Icon Click this icon to select a start date.
End Date Text Field Enter the end date of the group in
the text field.

A-14 Oracle CRM Application Foundation User Guide


Group Detail

Table A–10 Create Group Window Description


UI Object Name Type Description
Date Picker Icon Calcite this icon to select an end date.
Parent Text Field Enter the parent of the group in the
text field.
Email Text Field Enter the email address of the group
in the text field.
Usage Drop-down Use the drop-down list to select a
usage for the group.
Category Drop-down Use the drop-down to select a
category for the group.
Resource Name Text Field Enter the resource name associated
with the group in the text field.
Go Button Click this button to select a resource
name.
Role Type Drop-down Use the drop-down list to select a
role type.
Roles Text Field Enter the role of the group in the text
field.
Go Button Click this button to select a role.
Start Date Text Field Enter the start date of the group in
the text field.
Date Picker Icon Click this icon to select an start date.
End Date Text Field Enter the end date of the group in
the text field.
Date Picker Icon Click this icon to select an end date.
Create Button Click this button to create the group.

A.11 Group Detail


The following table describes field descriptions in the Group Detail window.

Oracle Resource Manager User Interface Reference A-15


Group Detail

Table A–11 Group Detail Window Description


UI Object Name Type Description
Group Name Text Field This read-only text field displays the
(Required) group name.
Name Text Field This editable field displays the group
(Required) name.
Description Text Field This editable field displays the group
description.
Start date Text Field This editable field displays the start
(Required) date of the group.
Date Picker Icon Click this icon to select the start date.
End Date Text Field This editable field displays the end
date of the group.
Date Picker Icon Click this icon to select the end date.
Parent Text Field This editable field displays the
parent of the group.
Email Text Field This editable field displays the email
address of the group.
Usage Drop-down Use the drop-down list to select the
(Required) usage for the group.
Remove Check Box Select this check box to remove the
group member role.
Category Drop-down Use the drop-down to select the
(Required) category for the group.
Resource Name Text Field This editable field displays the
(Required) resource name.
Go Button Click this button to select the
resource.
Role Type Drop-down Use the drop-down to select the role
type.
Roles Text Field This editable field displays the role
of the group.
Go Button Click this button to select a role for
the resource.

A-16 Oracle CRM Application Foundation User Guide


Group Hierarchy

Table A–11 Group Detail Window Description


UI Object Name Type Description
Start Date Text Field This editable field displays the start
date.
Date Picker Icon Click this icon to select the start date.
End Date Text Field This editable field displays the end
date.
Date Picker Icon Click this icon to select the end date.
Update Button Click this button to update the
information in the window.
Restore Button Click this button to revert to your
last saved changes.
Show History Button Click this button to show your
history.

A.12 Group Hierarchy


The following table describes field descriptions in the Group Detail window.

Table A–12 Group Hierarchy Window Description


UI Object Name Type Description
Group Text Field This read-only text field displays the
group name.
Update Button Click this button to update the
information in the window.
Restore Button Click this button to revert to your
last saved changes.
Name Hypertext Click this link to view the group
details.
Description Text Field This read-only text field displays the
description of the group.
Start date Text Field This read-only text field displays the
start date of the group.
End Date Text Field This read-only text field displays the
end date of the group.

Oracle Resource Manager User Interface Reference A-17


Group Hierarchy

Table A–12 Group Hierarchy Window Description


UI Object Name Type Description
Parent Hyperlink Click this link to view the parent
group details.
Email Hyperlink Click this link to send an email
message to the group.
Remove Check Box Select this check box to remove the
parent relationship from the group.
Group Name Hyperlink Click this link to view the parent
group details.
Go Button Click this button to select a parent
group.
Description Text Field This read-only text field displays the
description for the parent group.
Start Date Text Field This text field displays the start date
of the parent group.
Date Picker Icon Click this icon to select the start date.
End Date Text Field This text field displays the end date
of the parent group.
Date Picker Icon Click this icon to select the end date.
Remove Check Box Select this check box to remove child
relationships from the group.
Group Name Hyperlink Click this link to view the child
group details.
Go Button Click this button to select a group.
Description Text Field This read-only text field displays the
description of the child group.
Start Date Text Field This text field displays the start date
of the child group.
Date Picker Icon Click this icon to select the start date.
End Date Text Field This text field displays the end date
of the child group.
Date Picker Icon Click this icon to select the end date.
Update Button Click this button to update the
information in the window.

A-18 Oracle CRM Application Foundation User Guide


Advanced Group Search

Table A–12 Group Hierarchy Window Description


UI Object Name Type Description
Restore Button Click this button to revert to your
last saved changes.
Show History Button Click this button to show your
history.

A.13 Advanced Group Search


The following table describes field descriptions in the Advanced Search for
Employees window.

Table A–13 Advanced Search Window Description


UI Object Name Type Description
Group Name Text Field Enter a partial or complete group
name for the search in the text field.
This field is case insensitive.
Group Email Text Field Enter a partial or complete email
address for the search in the text
field.
Group Number Text Field Enter a complete or partial group
number for the search in the text
field. This field is case insensitive.
Description Text Field Enter a complete or partial
description of the group for the
search in the text field. This field is
case sensitive.
Group Usage Drop-down Use the drop-down to select the
group usage.
Active From Date Text Field Enter the date the group was active.
Date Picker Icon Click this icon to select a date.
To Date Text Field Enter the end date of the group.
Date Picker Icon Click this icon to select an end date.
Search Button Click this button to execute the
search and access the search results
in the Resource Detail window.

Oracle Resource Manager User Interface Reference A-19


Skills

Table A–13 Advanced Search Window Description


UI Object Name Type Description
Clear Button Click this button to refresh the
window and revert back to the
original values.

A.14 Skills
The following table describes field descriptions in the Skills window.

Table A–14 Skills Window Description


UI Object Name Type Description
Resource name Text Field This read-only text field displays the
name of the resource.
Add New Skill Button Click this button to access the Rate
Skill window where you can define
your skills.
Name Text Field This read-only text field displays the
name of the skill.
Level Text Field This read-only text field displays the
level associated with the skill for the
selected resource.

A.15 Rate Skills


The following table describes field descriptions in the Rate Skills window.

Table A–15 Rate Skills Window Description


UI Object Name Type Description
Resource name Text Field This read-only text field displays the
name of the resource.
Create Button Click this button to create the skill
rating
Cancel Button Click this button to return to the
Skills window.
Category Text Field Enter the category for the Skill
rating.

A-20 Oracle CRM Application Foundation User Guide


Define Skill Levels

Table A–15 Rate Skills Window Description


UI Object Name Type Description
Go Button Click this button to select the
category.
Type Drop-down Use the drop-down to select a type
for the skill rating.
Name Text Field Enter the name of the skill rating.
Go Button Click this button to select the name.
Component Text Field Only viewable when you select
Product from the Type drop-down,
Level Drop-down Use the drop-down to select a level
for the skill rating.

A.16 Define Skill Levels


The following table describes field descriptions in the Define Skill Levels window
that is accessible to the Administrative responsibility.

Table A–16 Define Skill Level Window Description


UI Object Name Type Description
Update Button Click this button to update the
information in the window.
Restore Button Click this button to revert to your
last saved changes.
Level name Column Name This column displays the skill level
name.
Numeric Value Column Name This column displays the numeric
value of the skill.
0 Text Field This text field displays the Not
Applicable skill level’s numeric
value.
Update Button Click this button to update the
information in the window.
Restore Button Click this button to revert to your
last saved changes.

Oracle Resource Manager User Interface Reference A-21


Define Skill Levels

A-22 Oracle CRM Application Foundation User Guide


B
Oracle Notes User Interface Reference

This appendix contains user interface object descriptions of the HTML version of
Notes.

B.1 Notes Summary Window


The following table describes the fields in the Notes Summary window in HTML.

Table B–1 Notes Summary Window


UI Object Name Type Description
Search Button Click this button to search all notes and sort the
results.
Create Button Click this button to create a new note.
All Notes Button Click this button to view all notes related to the
calling application. For example, when Notes is
accessed from Tasks, all of the notes associated with
that particular task are displayed.
Date Text Field This read-only text field displays the date that the
note was created.
Source Text Field This read-only text field displays the source of the
note.
Source Name Text Field This read-only text field displays the source name.
Created By Text Field This read-only text field displays the full name of the
user who created the note, their username, and their
employee ID. Values are captured from the user’s
login ID.
Type Text Field This read-only text field displays the note type.

Oracle Notes User Interface Reference B-1


Notes Search Window in HTML

Table B–1 Notes Summary Window


UI Object Name Type Description
Status Text Field This read-only text field displays the note status.
Note Hyperlink Click this link to display the first 20 characters of the
text in the note field.
Text Icon Click this icon to pop-up a large note window. The
icon is not visible when there is no large note
attached.
Attachment Icon Click this icon to view attachments associated with
the note. If there is an attachment provided with the
note, the paperclip icon will have a small paper icon
associated with it. If there is no attachment, only the
paperclip icon will appear.

See Also
■ Using the Notes Summary Window
■ Viewing All Notes
■ Viewing Note Details

B.2 Notes Search Window in HTML


The Notes Search window opens when you click the Search button on the Notes
Summary window. You can search all notes based on multiple criteria, as well as
sort the search results. After entering the appropriate criteria into the fields and
clicking Search, the results are displayed on the Notes Summary window. The
following table describes the fields in the Notes Search window.

Table B–2 Notes Search Window


UI Object Name Type Description
Search Button Click this button to search for a note.
Clear Button Click this button to clear your search criteria.
Key Word Text Field Enter a partial or full word to search on in the text
field. If this field is populated, the Date Range search
criteria will automatically be limited to 30 days.
Source Drop-down Use this drop-down to select the source of the note. If
you are viewing all notes, you are not able to search
on the source.

B-2 Oracle CRM Application Foundation User Guide


Notes Search Window in HTML

Table B–2 Notes Search Window


UI Object Name Type Description
Name Text Field Enter the name of the note in this text field. You must
select a source to select a corresponding record name.
Depending on what you enter, the created by field
may automatically populate.
Go Button Click this button to access the lookup window to
search for a note.
Relate To Drop-down Use the drop-down list to select the relate to
information to search on. If you are viewing all notes,
you are not able to search on relate to.You must select
a relate to object to select a corresponding record
name. Depending on what you enter, the created by
field may automatically populate.
Name Text Field Enter the source object name to search for in the text
field. This text field is only enabled if a valid source
or relate to object is selected from the drop-down.
Go Button Click this button to access the lookup window to
search for the source object.
Note Type Drop-down Use the drop-down list to search from a list of notes
types.
Created By Text Field Enter the name of the notes creator in the text field.
Go Button Click this button to access the look up window where
you can search for the creator’s name.
Date Range Option Button Select the option button to search for a particular date
range.
Date Range Drop-down Use the drop-down to select either none, for no date
range or today, to query notes for the current day.
Last_Days Text Field Enter the number of days that you want the notes to
display.
From Date Option Button Select the option button to search the date range that
note was created.
From Date Text Field Enter the date range when the note was created.
Date Picker Icon Click this icon to select the date from the date picker.
To Date Text Field Enter the date range when the note was created.
Date Picker Icon Click this icon to select the date from the date picker.

Oracle Notes User Interface Reference B-3


Create Note Window

Table B–2 Notes Search Window


UI Object Name Type Description
Sort Rows By Drop-down Use the drop-down list to select the sort options.
Options include Date, Note Type, Status, or Source.
Order Drop-down Use the drop-down to select whether you want to sort
records in ascending or descending order.
Then By Drop-down Use the drop-down list to select the sort options.
Options include Date, Note Type, Status, or Source.
Order Drop-down Use the drop-down to select whether you want to sort
records in ascending or descending order.
Finally By Drop-down Use the drop-down list to select the sort options.
Options include Date, Note Type, Status, or Source.
Order Drop-down Use the drop-down to select whether you want to sort
records in ascending or descending order.
Number of Rows Drop-down Use the drop-down to select the number of rows that
Displayed should appear on the Notes Summary window.

See Also
■ Using the Quick Find Search
■ Searching for a Note

B.3 Create Note Window


When accessing Notes from other applications, such as, Tasks or Calendar, the
source name and source number are passed to Notes. The information is displayed
below the page title for your reference. A single note can be related to multiple
contexts. A context defines what a note is about.
By default, the source is entered as a context with source type as the source name
and source ID as the context type ID. You can access the following windows from
the Create Note window:
■ Notes Summary window
■ A large note
The following table describes the fields in the Create Note window.

B-4 Oracle CRM Application Foundation User Guide


Create Note Window

Table B–3 Create Note Window


UI Object Name Type Description
Create Button Click this button to access the Note Details window
where you can create the note.
Clear Button Click this button to refresh the window.
Create and Button Click this button to create many notes.
Create Another
Type Drop-down Use this drop-down to select the note types. A note
type can be tied to a source type and those note types
are visible only to that mapped source.
Status Drop-down Use the drop-down to assign a status to the note. The
default is Public. Status include:
Private: only the creator of the note can read and
write to the note
Public: others can read and write to the note
Publish: can publish on the internet for the customer
to read and write to the note
Note Text Field Enter up to 2000 characters for the note. You receive
an error message if more than 2000 characters are
entered in this text field.
More Button Click this button to access the large note window and
enter a large note up to four GB.
Type Drop-down Use the drop-down list to select from a list the source
object type.
Name Text Field Enter the resource name in the text field.
Go Button Click this button to access the lookup window to
search for the resource name.
Description Text Field Enter the description for the related to information in
the text field. Depending on the type you selected,
the field may automatically populate.

See Also
■ Creating a Note
■ Adding an Attachment
■ Viewing Existing Attachments

Oracle Notes User Interface Reference B-5


All Notes Window

■ Using the Relate To Function


■ Using the Notes Summary Window
■ Viewing Note Details

B.4 All Notes Window


Use the All Notes window to view all notes associated with a source object in a
non-table format. It is accessed from the Notes Summary window. The following
table describes the fields in the All Notes window.

Table B–4 All Notes Window


UI Object Name Type Description
Date Text Field This read-only text field displays the date the note
was created.
Time Text Field This read-only text field displays the time the note
was created.
Creator Text Field This read-only text field displays the username of the
creator of the note.
Source Text Field This read-only text field displays the source of the
note.
Type Text Field This read-only text field displays the note type.
Note Icon Icon Click this icon to see the Note Details window.

See Also
■ Creating a Note
■ Using the Notes Summary Window
■ Viewing All Notes
■ Viewing Note Details

B.5 Note Details Window


You can access the following from the Note Details window:
■ Add Attachment
■ Relate To

B-6 Oracle CRM Application Foundation User Guide


Note Details Window

The following table describes the action or function of each link or button in the
Note Details window.

Table B–5 Note Details Window


UI Object Name Type Description
Update Button Click this button to update the note details.
Restore Button Click this button to refresh the window and revert
back to the original values.
Relate To Button Click this button to add related information to the
note.
Attachment Button Click this button to view any attachments added to
the note or to create an attachment for the note.
Type Drop-down Use the drop-down to classify the note by selecting
from a predefined list of note types. A note type can
be tied to a source type and those note types are
visible only to that mapped source.
Status Drop-down Use the drop-down to assign a status to a note. The
default is Public status.
Private: only the creator of the note can read the note.
Public: others can read the note.
Publish: you can publish on the internet for the
customer to read the note.
Note Text Field Enter up to 2000 characters in this text field.
More Button Click this button to add a large note up to 4 GB. The
note is saved when you click the Create Button.
Created By Text Field This read-only text field displays the full name,
username, and employee ID of the person who
created the note.
Created Date Text Field This read-only text field displays the date the note
was created.
Updated By Text Field This read-only text field displays the full name,
username, and employee ID of the person who
updated the note.
Updated Date Text Field This read-only text field displays the date the note
was updated.

Oracle Notes User Interface Reference B-7


Attachment Summary Window

See Also
■ Creating a Note
■ Adding an Attachment
■ Viewing Existing Attachments
■ Using the Relate To Function
■ Using the Notes Summary Window
■ Viewing Note Details

B.6 Attachment Summary Window


The following table describes the fields in the Attachment Summary window.

Table B–6 Attachment Summary Window


UI Object Name Type Description
Update Button Click this button to update the attachment.
Restore Button Click this button to refresh the window and revert
back to the original values.
Add Attachment Button Click this button to access the Add Attachment
window to create or add an attachment to an
appointment.
Remove Check box Select this check box to remove a username from the
multi-select box. If an icon is displayed, click it to
clear the row before you update the record.
Date Added Text Field This field displays the date that the attachment was
created.
Description Text Field Click this link to access the Note Details window and
view the first 20 characters of the attachment and drill
down to the attachment details.
File Size Text Field This read-only text field displays the file size of the
attachment.
Data Type Text Field This read-only text field displays the data type for the
attachment. Options include: Add Existing File, Text,
File or URL.
Added By Text Field This field displays the user’s name and resource ID of
the creator of the attachment.

B-8 Oracle CRM Application Foundation User Guide


Add Attachment Window

Table B–6 Attachment Summary Window


UI Object Name Type Description
Attachment Hyperlink Click this link to view the attachment whether it is (a
file, a URL, or text).

See Also
■ Creating a Note
■ Adding an Attachment
■ Viewing Existing Attachments
■ Using the Notes Summary Window
■ Viewing Note Details

B.7 Add Attachment Window


You can attach multiple attachments to the calling application. The following table
describes the fields in the Add Attachment window.

Table B–7 Add Attachment Window


UI Object Name Type Description
Source Text Field This read-only text field displays the source of the
note.
Source Name Text Field This read-only text field displays the source name.
Create Button Click this button to create a new attachment to the
note.
Clear Button Click this button to refresh the window without
saving your changes.
Description Text Field Enter a text message to be attached.
Text Option Button Select the text option button to indicate that the
attachment is in a free-formed text format.
Text Text Field Enter your attachment text in the text field.
File Option Button Select the file option button to indicate that the
attachment is a file.
File Text Field Enter the file location.

Oracle Notes User Interface Reference B-9


Relate To Window

Table B–7 Add Attachment Window


UI Object Name Type Description
URL Text Field Enter the URL you want to attach in the text field.
Browse Button Click this button to navigate to the file location.

See Also
■ Creating a Note
■ Adding an Attachment
■ Viewing Existing Attachments
■ Using the Notes Summary Window
■ Viewing Note Details

B.8 Relate To Window


The following table describes the fields in the Relate To window.

Table B–8 Relate To Window


UI Object Name Type Description
Source Text Field This read-only text field displays the source of the
note.
Source Name Text Field This read-only text field displays the source name.
Update Button Click this button to save your information.
Restore Button Click this button to refresh the window and revert
back to the original values.
Remove Check box Select this check box to remove a related object from
the note. You must click the update button to remove
the information.
Type Drop-down Use the drop-down list to select from a list the source
object type.
Name Text Field Enter the resource name in the text field.
Go Button Click this button to access the lookup window to
search for the resource name.

B-10 Oracle CRM Application Foundation User Guide


Relate To Window

Table B–8 Relate To Window


UI Object Name Type Description
Description Text Field Enter the description for the related to information in
the text field. Depending on the type you selected, the
field may automatically populate.

See Also
■ Creating a Note
■ Using the Relate To Function
■ Using the Notes Summary Window
■ Viewing Note Details

Oracle Notes User Interface Reference B-11


Relate To Window

B-12 Oracle CRM Application Foundation User Guide


C
Oracle Territory Manager User Interface
Reference

This appendix contains user interface object descriptions of Territory Manager.

C.1 The Overview Tab


The following table describes the fields on the Overview tab in the Territory Details
Window.

Table C–1 Overview Tab


Field Description
Usage Describes the usage of this territory. For example, this territory is
used for Oracle Service. The usage limits the selection of
transaction types.
Escalation Leave this field blank if an escalation territory is not required.
Transaction Types The transaction type is based on the territory usage. For example,
Service Request and Task are the transaction types for Oracle
Service. Account, Lead and Opportunity are used by Oracle Sales
and Telesales.
The selection of transaction qualifiers is based on the transaction
type. For example, task type, status and priority are transaction
qualifiers of Task transaction type for the usage of Service
application.
To enable existing transaction qualifiers, select Setup Qualifiers
from the Administration pull-down menu.

Oracle Territory Manager User Interface Reference C-1


The Overview Tab

Table C–1 Overview Tab


Field Description
Type Select the territory type if you want to create multiple territories
with similar characteristics.
Once the territory type is selected, the names of the Transaction
Types fields and the transaction qualifiers on the Transaction
Qualifiers tab populate automatically because the territory type is a
group of transaction qualifiers, and the transaction qualifiers are
based on the transaction type. You only need to assign the value of
each transaction qualifier to the territory you are going to create on
the Transaction Qualifiers tab.
You cannot select the territory type if the transaction types are
selected first because the transaction types override the territory
type. The (territory) Type field is blocked out.
Number of Winners Specify the number of winners only at the top level of a territory
hierarchy, such as the top level territory directly under Oracle
Service. This field is protected if it is not the top level territory and
an error message appears.
Rank Specify the territory ranking information. The lowest rank of
competing territories wins at the same level in the hierarchy.
End Date Use this field to obsolete a territory. This field is not mandatory.
Template This field displays the template name if you create a territory using
a template.
Freeze Once this field is checked, the territory cannot be updated any
more. You cannot uncheck this field after it is checked. Once this
is checked, the territory can only be deleted.
Copy Territory Used to duplicate an existing territory. To duplicate an existing
territory including the entire hierarchy, click the Copy Territory
button. A Copy Territory window opens and you can check the
Copy Hierarchy check box.

Opportunity, Lead, Task, and Service Request are considered a super set of the
Account qualifiers. Therefore, the account related transaction qualifiers, such as
Postal Code and State, are available even if the account transaction type is not
selected for the territory usage of Oracle Sales or Telesales.

C-2 Oracle CRM Application Foundation User Guide


The Transaction Qualifiers Tab

WARNING: Be cautious while using the Freeze check box. It is


suggested that you leave this freeze box unchecked at all times
unless it is necessary. You cannot undo a Freeze.

C.2 The Transaction Qualifiers Tab


The following table describes the functionalites of the fields on the Transaction
Qualifiers tab in the Territory Details Window:

Table C–2 Transaction Qualifiers Tab


Field Description
Name The available transaction qualifiers are based on the transaction
types and usage defined in the Overview tab. Enter the qualifiers
manually if you create a territory without a territory type.
If you cannot find the transaction qualifiers or no values are
returned from the list of values (LOV), then enable them from the
Setup Qualifiers window.
Use the wildcard blind query “%%%” to bring up the LOV in the
Value From and Value To fields if you want to list the entire LOV
for the selected qualifier. Otherwise, enter at least three letters,
such as “Bus”, to launch the LOV for “Business.”
Allow Overlap The default value for this field is checked. If you do not want to
allow overlap for a qualifier, uncheck the Allow Overlap check
box. Allowing overlap enables you to assign overlapping territory
values to the same qualifier.
By enabling overlap, you can enter both ranges as values for the
qualifier. With overlap not allowed, you cannot use any of the
values within both ranges for a territory at the same level in the
hierarchy.
If checked the Territory Manager prevents you from entering the
second range of values for the qualifier. However, you can use the
values as the qualifier for the next level down or up.
Next Value Set This button is used only in territory template and if the qualifier is
in dynamic mode.
Mass Create Specify the template name in the Overview tab and use this button
Territories for large numbers of territory creation.
Show Inherited If this territory is part of a hierarchy of territories, click this button
Qualifiers to see which qualifiers this territory logically has inherited from its
parent territories.

Oracle Territory Manager User Interface Reference C-3


The Resource Qualifiers Tab

WARNING: You must enter transaction qualifiers and values in a


territory so that it can be considered when a transaction is
assigned. If you do not specify transaction qualifiers in a
territory, then the resources attached to the territory will not be
assigned to any transactions.

C.3 The Resource Qualifiers Tab


Unlike the transaction qualifiers, the availability of the resource qualifiers is not
limited to the usage and transaction types you choose for a territory.
Enter the resource qualifiers you are going to use if you need assistance in assigning
resources to a territory. For example, use “Job Title = Manager” to help you identify
resources with manager title. There is no need to use this tab if you know exactly
which resources are going to be used for a territory.
The following table describes the functionalites of the fields on the Resource
Qualifiers tab in the Territory Details Window.

Table C–3 Resource Qualifiers Tab


Field Description
Name Enter the Name of the qualifier or use the list of values (LOV) to
populate the field.
Type Automatically populates based on the name of the resource
qualifier.
Next Value Set This button is used only in territory template and if the qualifier is
dynamic mode.
Operator Use this field to connect a qualifier name and its values to make a
qualifier meaningful.
Value From This field is based on the Name entered. There is also an LOV list
to choose from.
Value To Field is dependent on the Operator chosen.
Mass Create Use this button to create a large numbers of territories at the same
Templates time. Specify the template name in the Overview tab before
clicking this button.

C-4 Oracle CRM Application Foundation User Guide


The Resources Tab

C.4 The Resources Tab


Only territories that have resources attached can be winning territories. Therefore,
when a resource is added to a territory for the first time, you must run the
"Generate Territory Package" concurrent program.
Resources assigned to territories can be any CRM resource defined in the Resource
Manager, for example, employees, salespeople, groups, teams, parties, partners, and
supplier contacts. If you know exactly which resources are going to be assigned to a
territory, then it’s not necessary to use the Resource Qualifiers tab to limit the
resources.
The following table describes the functionalites of the fields on the Resources tab in
the Territory Details Window.

Table C–4 Resources Tab


Field Description
Name Enter the Name of the Resource or use the list of values (LOV) to
populate the field.
Type Automatically populates based on the name of the resource
qualifier.
Group Specifies which groups the resource belongs to.
(Located on the
horizontal scroll bar.)
Role Specifies which roles the resource is assigned to.
(Located on the
horizontal scroll bar.)
Access Type Specifies the transaction type for each individual resource assigned
to a territory. If this field is blank, then the resource assigned to a
territory can access every transaction type listed in the Overview
tab.
For example, if the selected access type for John Doe is Service
Request, then John can only be assigned to a job related to service
request. He cannot be assigned to a task or a task through service
request.
Auto Assign Select the Auto Assign Resources button to view all qualifying
Resources resources that match the Resource Qualifiers.

Oracle Territory Manager User Interface Reference C-5


The Subterritories Tab

Table C–4 Resources Tab


Field Description
Full Access This field is only used by Sales and Telesales. If selected, the
(Located on the resource has the full access to the transaction type specified
horizontal scroll bar.) in the Access Type field.
For example, if the access type is Lead, the resource can only be
assigned to Lead and Account. The person cannot be assigned to
an Opportunity.
Primary Contact Select this box for the primary contact if you have more than one
(Located on the resource identified.
horizontal scroll bar.)
Start Date and End Specify the resource available dates.
Date
(Located on the
horizontal scroll bar.)

If you cannot find any people in the Qualifying Resources window, then go back to
the Resource Qualifiers tab and either enter a different set of resource qualifier
values or select resources manually on the Resources tab.

Note: Auto Assign Resources is functional only if the resource


qualifiers and their values are entered in the Resource Qualifiers
tab.

C.5 The Subterritories Tab


Use the Subterritories tab when your territory hierarchy includes territories
following the current territory. This tab helps you create subterritories, also called
child territories.
The parent territory field populates automatically after clicking the New
Subterritory. For example, you create a subterritory by clicking this button from the
Bay Area - South territory, then Bay Area - South becomes the parent territory of
this new subterritory.
The following table describes the functionalites of the fields on the Subterritories tab
in the Territory Details Window:

C-6 Oracle CRM Application Foundation User Guide


Territory Lookup Tool Field Descriptions

Table C–5 Subterritories Tab


Field Description
Start Date Enter the start date.
End Date Enter the end date.
Rank Enter the rank.
New Subterritory Select this button to create a child territory with all the attributes of
the parent. It repeats the territory creation procedure for the new
subterritory.

C.6 Territory Lookup Tool Field Descriptions


The following table describes field types in the Lookup Tool window of Territory
Manager.

Table C–6 Territory Lookup - Lookup Tab Window Descriptions


UI Object Name Type Description
Organization Text Button Enter a partial or complete organization
name for the search in the text field. This
field is case insensitive. You can also use a
wildcard. It searches on the Customer Name
Range transaction qualifer.
Country Drop-down Use the drop-down list to search for
resources assigned to the qualifying territory
based on the country. This is a required
field.
Postal Code Text Field Enter the postal code for the search. This is a
required field.
Lookup Button Click this button to execute a search for
resources assigned to the qualifying
territory.
Clear Button Click this button to clear all search criteria
so you can search for new resources
assigned to a territory.

The following table describes field types in the Lookup Tool window of Territory
Manager.

Oracle Territory Manager User Interface Reference C-7


Territory Lookup Tool Field Descriptions

Table C–7 Territory Lookup - Lookup by Organization Tab Window Descriptions


UI Object Name Type Description
Organization Text Button Enter a partial or complete organization
name for the search in the text field. This
field is case insensitive. You can also use a
wildcard. It searches on the Customer Name
transaction qualifier.
State/Province Drop-down Use the drop-down list to search for the
resources assigned to the qualifying territory
based on the state or province.
Country Drop-down Use the drop-down list to search for
resources assigned to the qualifying territory
based on the country. This is a required
field.
Postal Code Text Field Enter the postal code for the search. This is a
required field.
Go Button Click this button to execute a search for
resources assigned to the qualifying
territory.
Clear Button Click this button to clear all search criteria
so you can search for new resources
assigned to a territory.

The following table describes field types in the Advanced Lookup Tool window of
Territory Manager. The visible fields are dependent on enabled qualifiers.

Table C–8 Territory Lookup - Advanced Lookup Window Descriptions


Field Label Field Type Description
Organization Text Button Enter a partial or complete organization
name for the search in the text field. This
field is case insensitive. You can also use a
wildcard. It searches on the Customer Name
Range transaction qualifier.
Country Drop-down Use the drop-down list to search for
resources assigned to the qualifying territory
based on the country. This is a required
field.

C-8 Oracle CRM Application Foundation User Guide


Territory Lookup Tool Field Descriptions

Table C–8 Territory Lookup - Advanced Lookup Window Descriptions


Field Label Field Type Description
State Drop-down Use the drop-down list to search for the
resources assigned to the qualifying territory
based on the state.
Province Drop-down Use the drop-down list to search for the
resources assigned to the qualifying territory
based on the province.
Postal Code Text Field Enter the postal code for the search.
Area Code Text Field Enter the area code for the search.
Customer Category Drop-down Use the drop-down list to search for the
resources assigned to the qualifying territory
based on the customer category.
Company Annual Text Field Enter the dollar amount of the company’s
Revenue annual revenue.
SIC Code Text Field Standard Industry Code
Number of Employees Text Field Enter the number of employees currently are
employed.
City Text Field Enter the city code.
Lookup Button Click this button to execute a search for
resources assigned to the qualifying
territory.
Clear Button Click this button to clear all search criteria
so you can search for new resources
assigned to a territory.

The following table describes field types in the Select an Organization window of
Territory Manager.

Table C–9 Select an Organization Window Descriptions


UI Object Name Type Description
Organization Text Field Enter a partial or complete organization
name for the search in the text field. This
field is case insensitive. You can use a wild
card.

Oracle Territory Manager User Interface Reference C-9


Territory Lookup Search Results

Table C–9 Select an Organization Window Descriptions


UI Object Name Type Description
Go Button Click this button to find an organization
entered in the organization text field. The
results appear in the Select an Organization
Window.
Organization Text Field This read only text field displays the
organizations that matched the search value
from the Territory Lookup Window.
Address Hyperlink Click on the address to access the Territory
Search Results Window which displays the
resources assigned to the qualifying territory
based on the organization and address
(including country, state or province and
postal code).
First Hyperlink Click on First to access the first page of
records with the list of organizations that
matched the search value from the Territory
Lookup Window. The numbers of rows
displayed can be customized in Profiles.
Previous Hyperlink Click on Previous to access the previous
page of records that was viewed.
Counter Text Field This read only text field displays the record
number, the number of records displayed in
the page and the total number of records
found from the organization query.
Next Hyperlink Click on Next to access the next page of
records.
Last Hyperlink Click on Last to access the last page of
records found from the organization query.
Cancel Button Click this button to cancel the query results
and return to Territory Lookup Window.

C.7 Territory Lookup Search Results


The following table describes field types in the Territory Lookup Search Results
window of Territory Manager.

C-10 Oracle CRM Application Foundation User Guide


Territory Lookup Search Results

Table C–10 Territory Lookup Search Results Window Descriptions


UI Object Name Type Description
Organization Text Field This read only text field displays the
organization value that the territory search
was based on.
Modify Search Button Click this button to modify the search and
return to Territory Lookup Window.
Salesperson Text Field This read only text field displays the
resource name assigned to the qualifying
territory.
Job Title Text Field This read only text field displays the job title
of the resource assigned to the qualifying
territory.
Phone Number Text Field This read only text field displays the phone
number of the resource assigned to the
qualifying territory.
Email Hyperlink Click on the email to access the email
template with the resource’s email address
populated for communication purposes.
Manager Name Text Field This read only text field displays the
Manager name of the resource assigned to
the qualifying territory.
Manager Phone Number Text Field This read only text field displays the
Manager’s phone number of the resource
assigned to the qualifying territory.

Oracle Territory Manager User Interface Reference C-11


Territory Lookup Search Results

C-12 Oracle CRM Application Foundation User Guide


D
Oracle Task Manager User Interface
Reference

This appendix contains user interface object descriptions of the HTML version of
Task Manager.

D.1 Create Task


Use the Create Task window to create a task, define dates for the task, assign
resources to the task, and relate a customer to the task. The following table
describes field types in the Create Task window.

Table D–1 Create Task Window Description


UI Object Name Type Description
Create Button Click this button to display the Task Detail window.
All values entered in the Create Task window
automatically populates the corresponding fields in
the Task Detail window.
Clear Button Click this button to clear all fields and enter new
values.
Create and Button Click this button to display the Create Task window
Create Another and create the current task and be prompted to create
another.
Type Drop-down Use this drop-down list to select a task type.
Name Text Field Enter task subject, title, or summary
information for your task in this text field to
identify the tasks.

Oracle Task Manager User Interface Reference D-1


Create Task

Table D–1 Create Task Window Description


UI Object Name Type Description
Description Text Field Enter detailed information for the task in this text
field.
Priority Drop-down Use this drop-down list to select a priority level.
Status Drop-down Use this drop-down list to assign task status at the
task header level.
Category Drop-down Use this drop-down list to select a task category.
Private Check Box Select this check box to define the task as private.
Notify Check Box Select this check box to start a workflow process of
notification sent to individuals, associated with the
task.
Parent Task Text Field Enter a parent task for the task in this text field.
Go Button Click this button to access the lookup window to
search for a parent task.
Task Time Zone Drop-down Use the drop-down list to select time zone
information.
Use for Option Button Select this option button to specify which date
Calendar (planned, schedule, or actual) information displays
the task on the calendar.
Start Date Text Field Enter the planned, scheduled, and actual start date
for the task in this text field.
Date Picker Icon Use the date picker icon to select the start date.
Start Time Drop-down Use the drop-down list to select the start hour for the
task in the text field.
Start Time Drop-down Use the drop-down list to select the minute interval
(Minute) for the task in the text field.
End Date Text Field Enter the planned, scheduled, and actual end date for
the task in the text field.
Date Picker Icon Use the date picker icon to select the end date.
End Time Drop-down Use the drop-down list to select the end hour for the
(Hour) task.
End Time Drop-down Use the drop-down list to select the minute interval
(Minute) for the task in the text field.

D-2 Oracle CRM Application Foundation User Guide


Create Task

Table D–1 Create Task Window Description


UI Object Name Type Description
Display on Check Box Select this check box to specify that you want to see
Calendar task on your personal calendar.
Roles Text Field This read-only text field specifies the role of the
owner or assignee.
Resource Type Drop-down Use the drop-down list to specify the resource type of
the assignee. Options include: Employee, Group, or
Team.
Name Text Field Enter the resource name in the text field.
Go Button Click this button to access the resource lookup tool to
search for a resource name.
Status Drop-down Use the drop-down list to select the assignee status.
Job Title Text Field Enter the job title of the resource in this text field.
Phone Text Field Enter the phone number of the resource in this text
field.
Email Text Field Enter the email address of the resource in this text
field.
Customer Type Drop-down Use the drop-down list to select the customer type.
Options include: Person, Organization, and
Relationship.
Customer Name Text Field Enter the customer’s name in the text field.
Go Button Click this button to access the customer lookup
window to search for the customer’s name.
Account Text Field Enter the customer account number in the text field.
Number
Go Button Click this button to access the customer Account
lookup window.
Customer Text Field Enter the customer number in the text field.
Number
Go Button Click this button to access the customer number
lookup window and search for the customer number.
Address 1 Text Field Enter the customer’s address in the text field.
Go Button Click this button to access the customer lookup
window and search for the customer’s address.

Oracle Task Manager User Interface Reference D-3


Create Task

Table D–1 Create Task Window Description


UI Object Name Type Description
Phone Number Text Field Enter the primary phone number for the customer.
Go Button Click this button to access the customer lookup tool
and search for the customer’s phone number.
Address 2 Text Field This read-only text field text field automatically
populates with the second line of the customer’s
address, once you select a customer.
Email Text Field This read-only text field text field automatically
populates with the customer’s email address once
you select a customer.
Reference Type Drop-down Use the drop-down list to relate a task to a source
object type.
Name Text Field Enter the source object name to be associated with
the task.
Go Button Click this button to access the look up tool and search
for a source object name.
Description Text Field This read-only text field text field automatically
populates with a description of the selected source
object.

See Also
■ Creating a Task
■ Associating a Task with a Customer
■ Relating Appointments and Tasks to Source Objects
■ Defining Dates for a Task
■ Assigning a Resource to a Task
■ Specifying the Task Effort
■ Creating a Repeating Task or Appointment
■ Mass Creating Tasks
■ Viewing Existing Attachments
■ Adding an Attachment

D-4 Oracle CRM Application Foundation User Guide


Create Quick Task

D.2 Create Quick Task


The Create Quick Task window is a light version of the Create Task window. You
can use this window to quickly create a simple task. The following table describes
field types in the Create Quick Task window.

Table D–2 Create Quick Task Window Description


UI Object Name Type Description
Create Button Click this button to display the Task Detail window.
All values entered in the Create Task window
automatically populates the corresponding fields in
the Task Detail window.
Clear Button Click this button to clear all fields and enter new
values.
Create and Button Click this button to display the Create Task window
Create Another and create the current task and be prompted to create
another.
Type Drop-down Use this drop-down list to select a task type.
Name Text Field Enter task subject, title, or summary
information for your task in this text field to
identify the tasks.
Description Text Field Enter detailed information for the task in this text
field.
Category Drop-down Use this drop-down list to select a task category.
Date Text Field Enter the planned, scheduled, and actual start date
for the task in this text field.
Date Picker Icon Use the date picker icon to select the start date.
Start Time Drop-down Use the drop-down list to select the start hour and
minutes for the task in the text field.
End Time Drop-down Use the drop-down list to select the end hour and
minutes for the task.
Display on Check Box Select this check box to specify that you want to see
Calendar task on your personal calendar.
Roles Text Field This read-only text field specifies the role of the
owner or assignee.

Oracle Task Manager User Interface Reference D-5


Task Summary

Table D–2 Create Quick Task Window Description


UI Object Name Type Description
Resource Type Drop-down Use the drop-down list to specify the resource type of
the assignee. Options include: Employee, Group, or
Team.
Name Text Field Enter the resource name in the text field.
Go Button Click this button to access the resource lookup tool to
search for a resource name.
Status Drop-down Use the drop-down list to select the assignee status.
Reference Type Drop-down Use the drop-down list to relate a task to a source
object type.
Description Text Field This read-only text field text field automatically
populates with a description of the selected source
object.
Go Button Click this button to access the look up tool and search
for a source object name.

See Also
■ Creating a Task
■ Associating a Task with a Customer
■ Relating Appointments and Tasks to Source Objects
■ Defining Dates for a Task
■ Assigning a Resource to a Task
■ Specifying the Task Effort
■ Creating a Repeating Task or Appointment
■ Mass Creating Tasks
■ Viewing Existing Attachments
■ Adding an Attachment

D.3 Task Summary


Use the Task Summary to view all your tasks, remove unwanted tasks, drill into the
task detail window by clicking on the task name hyperlink, or create a new task by

D-6 Oracle CRM Application Foundation User Guide


Task Summary

clicking on the Create button. You can also select from a list of saved searches to
re-query the summary window based upon search criteria. The information that
appears on the summary window is the result of your default search query.

Note: Fields may differ depending on the columns you choose to


view and the order in which you choose to display them in the Task
Search window.

The following table describes field types in the Task Summary window.

Table D–3 Task Summary Window Description


UI Object Name Type Description
Saved Searches Drop-down Use the drop-down list to select from previously
saved searches and re-execute the search.
Search Button Click this button to automatically re-execute the
search and display it in the same window.
Personalize Button Click this button to access the Task Search window
where you can enter search requirements, and then
save those requirements as a new search.
Update Button Click this button to save changes to tasks that you
make in the search summary window.
Restore Button Click this button to undo any changes to the editable
items in the task area.
CSV Download Icon Click this icon to download the information to a
spreadsheet format.
Create Button Click this button to access the Create Task window
and create a new task.
Quick Create Button Click this button to access the Create Quick Task
window and create a simple task quickly.
Remove Check Box Select the check box to delete unwanted tasks.
Name Text Field Enter task subject, title, or summary
information for your task in this text field to
identify the tasks.
Number Hyperlink Click this link to display the Task Details window.
Task Details Icon Click this button to access the Task Details window.

Oracle Task Manager User Interface Reference D-7


Task Summary

Table D–3 Task Summary Window Description


UI Object Name Type Description
Private Text Field This read-only text field displays a check mark if the
task is private.
Source Text Field This read-only text field displays the source of the
task.
Description Text Field Enter a description for the task in the text field.
Source Name Text Field This read-only text field displays the task name in
the Task Details window.
Category Drop-down Use the drop-down list to select the task category.
Parent Task Text Field This read-only text field displays the parent task.
Owner Type Drop-down Use the drop-down list to select the owner type.
Owner Name Drop-down Use the drop-down list to select the owner name.
Priority Drop-down Use the drop-down list to select the task priority.
Recurring Text Field This read-only text field displays an icon if the task
is recurring.
Time Zone Drop-down Use the drop-down list to select your Time Zone.
Planned Start Text Field Enter the planned start date for the task.
Date Range
Date Picker Icon Use the date picker icon to search for a task based on
the planned start date range.
Planned End Text Field Enter the planned end date for the task.
Date Range
Date Picker Icon Use the date picker icon to search for a task based on
the planned end date range.
Task Type Drop-down Use the drop-down list to select the task type.
Status Drop-down Use the drop-down list to select the task status.

See Also
■ Viewing the Task Summary
■ Using the Quick Find Search
■ Customizing Your Task Summary Display Options
■ Selecting Sort Options

D-8 Oracle CRM Application Foundation User Guide


Task Search

■ Personalizing Your Saved Searches


■ Viewing Task Details

D.4 Task Search


Use the Task Search window to create saved searches. You can personalize the
search results by populating the Displayed Columns from the Available Columns in
the Displayed Options section of the personalized search window. The result can
also be sorted by three criteria either by ascending or descending order. Your
personalized search can be saved for future use. In addition, it can be selected as a
Task Summary window default. The following table describes field types in the
Task Details window.

Table D–4 Task Search Window Description


UI Object Name Type Description
Saved Searches Drop-down Use the drop-down list to select from previously
saved searches. The selected saved search name will
be executed when you click the Search button.
Search Button Click this button to execute a search for a task.
Restore Button Click this button to undo any changes to the editable
items in the Task Search window.
Clear Button Click this button to clear all search criteria so you
can search on a new item.
Name Text Field Enter task subject, title, or summary
information for your task in this text field to
identify the tasks.
Number Text Field Enter the task number for the search.
Status Multi-select List Use the multi-select list box to select the status.
Box
Types Multi-select List Use the drop-down list to select the task type which
Box reflects the source of the task.
Priority Multi-select List Use the multi-select list box to select a predefined
Box priority value.
Category Multi-select List Use the drop-down list to select the task category.
Box
Include Private Check Box Select this check box to include your private tasks in
the search.

Oracle Task Manager User Interface Reference D-9


Task Search

Table D–4 Task Search Window Description


UI Object Name Type Description
Source Drop-down Use the drop-down list to select the source of the
task.
Name Text Field Enter the name that corresponds with the source.
Go Button Click this button to access the lookup window to
search for the name that corresponds with the
source.
Type Drop-down Use the drop-down list to select the resource type
that created the task.
Name Text Field Use the drop-down list to select a resource name
Go Button Click this button to access the lookup window to
search for a resource name.
My Tasks Option Button Select this option button to assign the task to
yourself.
Task with Role Option Button Select this option button to assign the task to another
resource.
Role Drop-down Use the drop-down to select the role. Options
include: Owner, Assignee, and All.
For Drop-down Use the drop-down to select the resource type.
Resource Name Text Field Enter the resource’s name in the text field.
Go Button Click this button to access the lookup tool to search
for the resource.
Role Drop-down Use the drop-down to select the role. Options
include: Owner, Assignee, and All.
For Drop-down Use the drop-down list to select the resource type.
Resource name Text Field Enter the resource’s name in the text field.
Go Button Click this button to access the lookup tool to search
for the resource.
Date Drop-down Select the type of task you want to search for.
Options include Created Start Date, Created End
Date, Planned Start Date Range, Planned End Date
Range, Schedule Start Date Range, Schedule End
Date Range, Actual Start Date Range, Actual End
Date Range,

D-10 Oracle CRM Application Foundation User Guide


Task Search

Table D–4 Task Search Window Description


UI Object Name Type Description
From Text Field This text field displays the from date of the task once
you select it from the Date Picker.
Date Picker Icon Use the date picker icon to search for a task based on
the created end date range.
Hour Drop-down Use the drop-down list to select the start time hour
for the task.
Minute Drop-down Use the drop-down list to select the start time
minute interval for the task.
To Text Field This text field displays the to date of the task once
you select it from the Date Picker.
Date Picker Icon Use the date picker icon to search for a task based on
the planned end date range.
Hour Drop-down Use the drop-down list to select the end time hour
for the task.
Minute Drop-down Use the drop-down list to select the end time minute
for the task.
Type Drop-down Use the drop-down list to search for a task based on
the customer type. Options include: account number,
customer number, and customer name.
Value Text Field Enter the customer name or number which
corresponds to the type you specified.
Reference Type Drop-down Use the drop-down list to relate the task to an object
based on the source of the task.
Name Text Field Enter the resource name in the text field.
Go Button Click this button to access the lookup tool to search
for the resource name.
Description Text Field This read-only text field automatically populates
when you select the resource name.
Available Multi-select List This gives you the ability to view all available
Columns Box columns to choose from You can click the display
name and forward arrow to move it to the display
column.

Oracle Task Manager User Interface Reference D-11


Task Search

Table D–4 Task Search Window Description


UI Object Name Type Description
Displayed Multi-select List This gives you the ability to view all columns that
Columns Box will be displayed in the Task Summary window. The
items in this column appear on the search results
window.
> Button Click this button to move the selected item in the
available column to the displayed column.
>> Button Click this button to move all items in the available
column to the displayed column.
<< Button Click this button to move all items in the displayed
column to the displayed column.
< Button Click this button to move the selected item in the
displayed column to the available column.
Up Arrow Icon Use this button to move in displayed item up in the
row.
Down Arrow Icon Use this button to move in displayed item down in
the row.
Sort Rows By Drop-down Use the drop-down list to select the first sort to be
ascending or descending.
Then By Drop-down Use the drop-down list to select the second sort to be
ascending or descending.
Then By Drop-down Use the drop-down list to select the third sort to be
ascending or descending.
Number of Text Field Enter the number of rows to appear in the Task
Rows Summary window. The value must be between 1-99.
Search Name Text Field Enter a name for the personalized query in the text
field.
Save Button Click this button to save your new search.
Save and Search Button Click this button to save your new search and run
the search.
Use as Summary Check Box Select the check box to have the search execute upon
Page Default opening the Task Summary window.
Use as Default Check Box Select the check box to have the search execute upon
Query for opening the Combination window in Calendar.
Combo View

D-12 Oracle CRM Application Foundation User Guide


Task Details

See Also
■ Viewing the Task Summary
■ Using the Quick Find Search
■ Customizing Your Task Summary Display Options
■ Selecting Sort Options
■ Personalizing Your Saved Searches

D.5 Task Details


From the Main Task Details window you can:
■ Assign resources to a group or team
■ Define repeating tasks
■ View and defining contacts
■ Add attachments
■ Add notes to the task detail
■ Mass creating tasks
Any applicable values entered on the Create Task window, such as, task type or task
name, are carried over to the Task Details window. The following table describes
field types in the Task Details window.

Table D–5 Task Details Window Description


UI Object Name Type Description
Source Hyperlink Click this link to display the source of the task.
Name Hyperlink Click this link to display the task details.
Update Button Click this button to update the task details.
Restore Button Click this button to refresh the window and revert
back to the original values.
Type Drop-down Use the drop-down list to select the Task type.
Name Text Field Enter a task name (title) in the text field.
Description Text Field Enter detailed information about the task in the text
field.

Oracle Task Manager User Interface Reference D-13


Task Details

Table D–5 Task Details Window Description


UI Object Name Type Description
Priority Drop-down Use this drop-down list to select a priority level.
Status Drop-down Use this drop-down list to assign task status.
Category Drop-down Use this drop-down list to select a task category.
Private Check Box Select this check box to define the task as private.
Notify Check Box Select the check box to start a workflow notification
if the task is modified.
Parent Task Text Field Enter a parent task for the task in this text field.
Go Button Click this button to access the lookup window to
search for a parent task.
Escalation Level Text Field This read-only text field displays escalation level
information added to a task through the forms based
module. This information automatically populates
the text field when the task selected.
Escalation Text Fields This read-only text field displays escalation owner
Owner information added to a task through the forms based
module. This information automatically populates
the text field when the task selected.
Task Time Zone Drop-down Use the drop-down list to select the time zone
information.
Use for Calendar Option Button Select this option button to specify which date
(planned, scheduled, or actual) information will be
used to display the task on the calendar.
Start Date Text Field Enter the planned, scheduled, or actual start date for
the task in this text field.
Date Picker Icon Click this icon to select the planned, scheduled, or
actual start date for the task.
Start Time Drop-down Use the drop-down list to select the start hour for the
(Hour) task in the text field.
Start Time Drop-down Use the drop-down list to select the start time, in
(Minute) minutes for the task in the text field.
End Date Text Field Enter the planned, scheduled, or actual end date for
the task in the text field.
Date Picker Icon Click this icon to select the planned, scheduled, or
actual end date for the task.

D-14 Oracle CRM Application Foundation User Guide


Task Details

Table D–5 Task Details Window Description


UI Object Name Type Description
End Time Drop-down Use the drop-down list to select the end hour for the
(Hour) task.
End Time Drop-down Use the drop-down list to select the end time, in
(Minute) minutes for the task in the text field.
Display on Check Box Select this check box to specify that you want to see
Calendar task on your personal calendar.
Customer Type Drop-down Use the drop-down list to select the customer type.
Options include: Person, Organization, and
Relationship.
Customer Name Text Field Enter the customer’s name in the text field.
Go Button Click this button to access the customer lookup
window and search for the customer’s name.
Account Text Field Enter the customer account number in the text field.
Number
Go Button Click this button to access the customer lookup
window and search for the account number.
Customer Text Field Enter the customer number in the text field.
Number
Go Button Click this button to access the customer lookup
window.
Address 1 Text Field Enter the customer’s address in the text field.
Go Button Click this button to look up the customer’s address.
Phone Number Text Field Enter or search for the contact point, such as a home
phone, cellular phone, or secretary phone, to be used
for this customer.
Go Button Click this button to access the customer lookup
window to search for the customer phone number.
Address 2 Text Field This read-only text field automatically populates
once the address is selected.
Email Text Field This read-only text field automatically populates
once the customer is selected.
Created By Text Field This read-only text field displays the full name,
username, and employee ID of the person who
created the task.

Oracle Task Manager User Interface Reference D-15


Reference

Table D–5 Task Details Window Description


UI Object Name Type Description
Created Date Text Field This read-only text field displays the date the task
was created.
Updated By Text Field This read-only text field displays the full name,
username, and employee ID of the person who
updated the task.
Updated Date Text Field This read-only text field displays the date the task
was updated.

See Also
■ Viewing Task Details
■ Creating a Task
■ Associating a Task with a Customer
■ Relating Appointments and Tasks to Source Objects
■ Defining Dates for a Task
■ Assigning a Resource to a Task
■ Specifying the Task Effort
■ Creating a Repeating Task or Appointment
■ Mass Creating Tasks
■ Viewing Existing Attachments
■ Adding an Attachment

D.6 Reference
Use the Reference window to relate a task to a business object, such as a marketing
campaign. The Reference table is automatically expandable to accommodate
multiple resources. The following table describes field types in the Reference
window.

D-16 Oracle CRM Application Foundation User Guide


Reference

Table D–6 Reference Window Descriptions


UI Object Name Type Description
Source Hyperlink Click this link to display the source
of the task.
Name Hyperlink Click this link to display the task
details.
Update Button Click this button to update the
Reference table. Any items that have
been selected to be removed should
disappear.
Restore Button Click this button to refresh the
window and revert back to the
original values.
Remove Icon Select the check box next to the
Reference objects to remove them
from the table.
Type Text Field This read-only text field displays the
related object.
Name Text Field This read-only text field displays the
name of the related object.
Go Button Click this button to access the
Lookup window to look up a
customer. Upon selecting a name
from the Lookup window, you access
the task Reference window with the
selected name entered as a Reference
object.
Description Text Field This read-only text field displays a
text description of the related object.

See Also
■ Viewing Task Details
■ Relating Appointments and Tasks to Source Objects
■ Defining Dates for a Task
■ Assigning a Resource to a Task
■ Specifying the Task Effort

Oracle Task Manager User Interface Reference D-17


Assignments

■ Creating a Repeating Task or Appointment


■ Mass Creating Tasks
■ Viewing Existing Attachments
■ Adding an Attachment
■ Defining Your Preferences

D.7 Assignments
A task can be assigned to one or many resource of types employee, groups, or team.
Not all assignees have to play an active roll for the task. For example, an assignee
with a role of owner may only supervise the task. All assignees can choose to have
the task display on their personal calendar. There can be only one owner to a task at
a time. The following table describes field types in the Assignments window.

Table D–7 Assignments Window Description


UI Object Name Type Description
Source Hyperlink Click this link to display the source of the task.
Name Hyperlink Click this link to display the task details.
Update Button Click this button to update the Assignments window
after changes are made.
Restore Button Click this button to refresh the window and revert
back to the original values.
Remove Icon Click the icon to clear the row.
Roles Text Field This read-only text field displays the role of the type
(owner or assignee).
Display on Check Box Select this check box to specify that you want to see
Calendar the task on your personal calendar.
Resource Type Drop-down Use the drop-down list to specify the resource type of
the assignee.
Name Drop-down Enter the resource name in the text field.
Go Button Click this button to access the lookup tool to search
for a resource.
Status Drop-down Use the drop-down list to select the assignee status.

D-18 Oracle CRM Application Foundation User Guide


Efforts

Table D–7 Assignments Window Description


UI Object Name Type Description
Job Title Text Field This read-only text field displays the job title of the
resource.
Phone Text Field This read-only text field displays the phone number
of the resource.
Email Text Field This read-only text field displays the email address of
the resource.

See Also
■ Viewing Task Details
■ Creating a Task
■ Associating a Task with a Customer
■ Relating Appointments and Tasks to Source Objects
■ Defining Dates for a Task
■ Assigning a Resource to a Task
■ Specifying the Task Effort
■ Creating a Repeating Task or Appointment
■ Mass Creating Tasks
■ Viewing Existing Attachments
■ Adding an Attachment
■ Defining Your Preferences

D.8 Efforts
Use the Efforts window to specify the level of planned and actual efforts for a task.
The values entered are for information only and do not trigger a workflow. The
following table describes field types in the Efforts window.

Table D–8 Efforts Window Description


UI Object Name Type Description
Source Hyperlink Click this link to display the source of the task.

Oracle Task Manager User Interface Reference D-19


Repeating

Table D–8 Efforts Window Description


UI Object Name Type Description
Name Hyperlink Click this link to display the task details.
Effort Duration Text Field Enter the numeric effort of the task.
UOM Drop-down Use the drop-down list to select the unit of measure
for the effort. Options include: Minutes, Hours.
% Complete Text Field Enter the percent complete for the task in the text
field.
Planned Effort Text Field Enter the planned effort for the task in the text field.
Actual Effort Text Field Enter the actual effort for the task in the text field.

See Also
■ Viewing Task Details
■ Creating a Task
■ Associating a Task with a Customer
■ Relating Appointments and Tasks to Source Objects
■ Defining Dates for a Task
■ Assigning a Resource to a Task
■ Specifying the Task Effort
■ Creating a Repeating Task or Appointment
■ Mass Creating Tasks
■ Viewing Existing Attachments
■ Adding an Attachment
■ Defining Your Preferences

D.9 Repeating
Use the Repeating window to schedule tasks to occur automatically. Examples of
intervals include daily, weekly, or monthly occurrences. Depending on your
business needs, you may want to create a series of tasks for a specified date in one
window. These tasks can be selected to repeat in any combination. To schedule
repeating tasks, you must either specify a start date and the number of tasks to

D-20 Oracle CRM Application Foundation User Guide


Repeating

create or the end date. The dates of the tasks are populated as the start and end
dates. Use the count field to specify how many times the task should repeat. The
following table describes field types in the Repeating window.

Table D–9 Repeating Window Description


UI Object Name Type Description
Source Hyperlink Click this link to display the source of the task.
Name Hyperlink Click this link to display the task details.
Restore Button Click this button to refresh the window and revert
back to the original values.
Start Date Text Field This read-only text field displays the start date for
the repeating task.
End Date Text Field Enter the end date for the repeating task.
Count Text Field Enter the number of days you want the task to
repeat. The default count is set at 10. You can select
either an end date or a count but not both.
Date Picker Icon Click the icon to access the micro-monthly calendar
to select a start date for the repeating task.
Date Picker Icon Click the icon to access the micro-monthly calendar
to select an end date for the repeating task.
None Option Button Select the None option button to indicate that you do
not have a repeating task.
Daily Option Button Select the Daily option button to specify that you
want the task to repeat on a daily basis. Once
selected, you can select the daily frequency options
for the number of days and the end date.
Every_Day Text Field Enter the number of days for the task to repeat. The
default is set at 1.
Weekly Option Button Select the Weekly option button to repeat the task on
a weekly basis. You can select the frequency options
for the weekly frequency, the days to include, and
the date to end.
Every_Week Text Field Enter the number for the frequency to repeat, for
example, every two weeks or every week. The
default is set at 1.

Oracle Task Manager User Interface Reference D-21


Repeating

Table D–9 Repeating Window Description


UI Object Name Type Description
Days Multi-select List Select the specific days to include for weekly
Box repeating. The default is the current day it the check
box cannot be deselect. However, you can select
additional days.
Monthly Option Button Select the Monthly option button to repeat the task
on a monthly basis. You can select the frequency
options for the monthly frequency, the days to
include, and the date to end.
Every_Month Text Field Enter the frequency to repeat of monthly repeating,
for example, once a month. The default is 1 month.
On Text Field Enter the date for the repeating monthly
appointment. The default is the current date if the
Month option button is selected.
On The Drop-down Use the drop-down list to specify which days to
include for monthly repeating.
Days Multi-select List Select the specific days to include for monthly
Box repeating. The default is the current day it the check
box cannot be deselect. However, you can select
additional days.

See Also
■ Viewing Task Details
■ Creating a Task
■ Associating a Task with a Customer
■ Relating Appointments and Tasks to Source Objects
■ Defining Dates for a Task
■ Assigning a Resource to a Task
■ Specifying the Task Effort
■ Creating a Repeating Task or Appointment
■ Mass Creating Tasks
■ Viewing Existing Attachments
■ Adding an Attachment

D-22 Oracle CRM Application Foundation User Guide


Task Contacts

■ Defining Your Preferences

D.10 Task Contacts


Use the Task Contacts window to manage contact information. No contacts can be
created within Tasks, however, you can import a task contact. The following table
describes field types in the Contacts window.

Table D–10 Task Contacts Window Description


UI Object Name Type Description
Source Hyperlink Click this link to display the source of the task.
Name Hyperlink Click this link to display the task details.
Update Button Click this button to save changes to tasks that you
make in the search summary window.
Restore Button Click this button to undo any changes to the editable
items in the task area.
Remove Icon Click the icon to clear the row.
Remove Check Box Select the check box to remove unwanted contact
from task.
Type Text Field This read-only text field displays the type of contact
selected. Options include: Customer and Employee.
Name Text Field Enter the contact’s name in the format of Title, Last
name, and First name.
Go Button Click this button to go to the contact lookup window
where you can select the contact name and contact
points.
Phonebook Edit Text Field Enter the contact’s phone number.
Go Button Click this button to go to the Phonebook lookup
window. Once selected, the new number populates
the field.
Email Hyperlink Click the link edit the contact’s email address
information.
Go Button Click this button to access the Email Address lookup
window. Once selected, the email populates the
field.

Oracle Task Manager User Interface Reference D-23


Attachments

Table D–10 Task Contacts Window Description


UI Object Name Type Description
Primary Option Button Select the option button to indicate the primary
contact.

See Also
■ Viewing Task Details
■ Creating a Task
■ Associating a Task with a Customer
■ Relating Appointments and Tasks to Source Objects
■ Defining Dates for a Task
■ Assigning a Resource to a Task
■ Specifying the Task Effort
■ Creating a Repeating Task or Appointment
■ Mass Creating Tasks
■ Viewing Existing Attachments
■ Adding an Attachment
■ Viewing Task Contact Information
■ Defining Task Contacts

D.11 Attachments
Use the Attachment feature to link unstructured data such as images,
word-processing documents, spreadsheets, or text to their application data. For
example, you can link images to items or video to operation instructions. Task
Manager supports the ability to add one or more attachments to a task. The
attachment can be in the form of a text message, a file, or a URL. The following table
describes field types in the Attachment’s window.

Table D–11 Attachment Window Descriptions


UI Object Name Type Description
Source Hyperlink Click this link to display the source
of the task.

D-24 Oracle CRM Application Foundation User Guide


Attachments

Table D–11 Attachment Window Descriptions


UI Object Name Type Description
Name Hyperlink Click this link to display the task
details.
Update Button Click this button to update the
window.
Restore Button Click this button to refresh the
window and revert back to the
original values.
Add Attachment Button Click this button to access the Add
Attachment window to add an
attachment to the task.
Remove Check box Select this check box to remove a
username from the Multi-select List
Box.
Date Added Text Field This field displays the date that the
attachment was created.
Description Text Field Click this link to access the Note
Details window and view the first 20
characters of the attachment and drill
down to the attachment details.
File Size Text Field This read-only text field displays the
file size of the attachment.
Data Type Text Field This read-only text field displays the
data type for the attachment. Options
include: Add Existing File, Text, File
or URL.
Added By Text Field This field displays the user’s name
and resource ID of the creator of the
attachment.
Attachment Hyperlink Click this link to view the attachment
whether it is a file, a URL, or text.

See Also
■ Viewing Task Details
■ Creating a Task
■ Associating a Task with a Customer

Oracle Task Manager User Interface Reference D-25


Add Attachments

■ Relating Appointments and Tasks to Source Objects


■ Defining Dates for a Task
■ Assigning a Resource to a Task
■ Specifying the Task Effort
■ Creating a Repeating Task or Appointment
■ Mass Creating Tasks
■ Viewing Existing Attachments
■ Adding an Attachment

D.12 Add Attachments


The following table describes field types in the Add Attachment window.

Table D–12 Add Attachment Window Descriptions


UI Object Name Type Description
Source Hyperlink Click this link to display the source
of the task.
Name Hyperlink Click this link to display the task
details.
Create Button Click this button to create a new
attachment.
Clear Button Click this button to refresh the
window without saving your
changes.
Description Text Field Enter a text message to be attached.
Text Option Button Select the text option button to
indicate that the attachment is in a
free-formed text format.
Text Text Field Enter your attachment text in the text
field.
File Option Button Select the file option button to
indicate that the attachment is a file.
File Text Field Enter the file location.

D-26 Oracle CRM Application Foundation User Guide


Mass Create

Table D–12 Add Attachment Window Descriptions


UI Object Name Type Description
URL Text Field Enter the URL you want to attach in
the text field.
Browse Button Click this button to navigate to the
file location.

See Also
■ Viewing Task Details
■ Creating a Task
■ Associating a Task with a Customer
■ Relating Appointments and Tasks to Source Objects
■ Defining Dates for a Task
■ Assigning a Resource to a Task
■ Specifying the Task Effort
■ Creating a Repeating Task or Appointment
■ Mass Creating Tasks
■ Viewing Existing Attachments
■ Adding an Attachment

D.13 Mass Create


Use the Mass Create window to create a separate task for each of the selected
resources. When you use the Mass Create feature, a new task is created for each
resource in a group or team and that resource is automatically assigned as the
owner of the task. Also, once the task is created, the creator of the mass created task
may not perform any updates to the new task. The following table describes field
types in the Mass Create window.

Table D–13 Mass Create Window Description


UI Object Name Type Description
Source Hyperlink Click this link to display the source of the task.
Name Hyperlink Click this link to display the task details.

Oracle Task Manager User Interface Reference D-27


Mass Create

Table D–13 Mass Create Window Description


UI Object Name Type Description
Create Button Click this button to mass create a task for every
member of a group or team. Each team member will
be the owner of their individual task.
Type Drop-down Use the drop-down list to select the resource type.
Name Text Field Enter the name of the resource group or team in the
text field.
Go Button Click this button to access the lookup tool and search
for the name of the group or team.
Keep a Record Check Box Select this check box to keep a record of the task you
of this Task are mass creating, otherwise, the task will not
remain.
Copy Notes Check Box Select this check box to keep a copy of any notes
attached to the task.

See Also
■ Creating a Task
■ Associating a Task with a Customer
■ Relating Appointments and Tasks to Source Objects
■ Defining Dates for a Task
■ Assigning a Resource to a Task
■ Specifying the Task Effort
■ Creating a Repeating Task or Appointment
■ Mass Creating Tasks
■ Viewing Existing Attachments
■ Adding an Attachment

D-28 Oracle CRM Application Foundation User Guide


E
Oracle HTML Calendar User Interface
Reference

This appendix contains user interface object descriptions of the HTML version of
Calendar.

E.1 Daily View


Upon opening Calendar, you are directed toward the daily view. You can then view
the entire day’s schedule of appointments. Within the daily view, you can create a
new appointment, update or delete an existing appointment or choose to access a
different day on the calendar. The following table describes field types in the daily
view of Calendar.

Table E–1 Daily View Window Descriptions


UI Object Name Type Description
Backward Icon Button Click this button to view the
previous day in the same daily view
format.
Current Day Text Field This read-only text field displays the
view of the day that is currently
shown in the daily view.
Forward Icon Button Click this button to view the next
day in the same daily view format.

Oracle HTML Calendar User Interface Reference E-1


Weekly View

Table E–1 Daily View Window Descriptions


UI Object Name Type Description
Time Hyperlink Click the time to access the Create
Appointment window with the start
time for the appointment defaulted
to the time selected on the daily
view. In grid format, the times are
shown vertically on the left side of
the window.
Date Picker Date Picker Select a date on the micro-monthly
calendar to have that date default in
the start date of the daily view.
Go To Button Click this button to access the Go To
window where you can select a date
to view in the daily view format.
Today Button Click this button to view the current
day in any view format.
+ Icon Use this icon to access the Create
Appointment window and select the
time and day and create an
appointment. The icon is shown for
every time interval shown in the
daily view.
Create Button Click this button to access the Create
Appointment window. The default
date for the appointment is the
current date. There is no time
defaulted.
Appointment Hyperlink Hyperlink Click this link for a particular
appointment to access the detail
view for that appointment.
Untimed Event Hyperlink Click this link for the task,
appointment, or event to access
the details for that specific object.

E.2 Weekly View


Within the weekly view you can create a new appointment, update an existing
appointment, or delete an existing appointment. You can choose to access a
different week to view that week’s calendar of appointments. The following table
describes field types in the weekly view of Calendar.

E-2 Oracle CRM Application Foundation User Guide


Weekly View

Table E–2 Weekly View Window Descriptions


UI Object Name Type Description
Backward Icon Button Click this button to view the
previous week in the same weekly
view format.
Current Week Text Field This read-only text field displays the
view of the week that is currently
shown in the weekly view.
Forward Icon Button Click this button to view the next
week in the same weekly view
format.
Time Hyperlink Click the time to access the Create
Appointment window with the start
time for the appointment defaulted
to the time selected on the weekly
view. In grid format, the times are
shown vertically on the left side of
the window.
Go To Button Click this button to access the Go To
window where you can select a date
to view in any view format.
Today Button Click this button to view the current
day in the weekly view format.
Date Text Field This read-only text field displays the
dates horizontally on the upper
portion of the weekly view.
+ Icon Use this icon to access the Create
Appointment window and select the
time and day and create an
appointment. The icon is shown for
every day in the week and for every
time interval shown in the weekly
view.
Create Button Click this button to access the Create
Appointment window. The default
date for the appointment is the
current date.
Appointment Hyperlink Click this link for a particular
appointment to access the detail
view for that appointment.

Oracle HTML Calendar User Interface Reference E-3


Monthly View

Table E–2 Weekly View Window Descriptions


UI Object Name Type Description
Untimed Event Hyperlink Click this link to view at the top of
the calendar to view the untimed
appointment details.

E.3 Monthly View


Within the monthly view you can create a new appointment, update an existing
appointment, or delete an existing appointment. You can also choose to access a
different month to view that month’s calendar of appointments. The following table
describes field types in the monthly view of Calendar.

Table E–3 Monthly View Window Descriptions


UI Object Name Type Description
Backward Icon Button Click this button to view the
previous month in the same monthly
view format.
Current Month Text Field This read-only text field displays the
view of the month that is currently
shown in the monthly view.
Forward Icon Button Click this button to view the next
month in the same monthly view
format.
Day of the Week Text Field The days of the week (as defined in
the user preferences) are shown on
the top of the monthly grid.
Go To Button Click this button to access the Go To
window where you can select a date
to view in any view format.
Today Button Click this button to view the current
day in the monthly view format.
Create Button Click this button to access the Create
Appointment window. The default
date for the appointment is the
current date.
Appointment Hyperlink Click this link for a particular
appointment to access the detail
view for that appointment.

E-4 Oracle CRM Application Foundation User Guide


Yearly View

Table E–3 Monthly View Window Descriptions


UI Object Name Type Description
Untimed Event Hyperlink Click this link to view at the top of
the calendar to view the untimed
appointment details.

E.4 Yearly View


The yearly view displays all of the months for the entire year. Each month displays
the days of the week starting with Sunday and ending with Saturday. The current
day is highlighted within the yearly view. The following table describes field types
in the yearly view of Calendar.

Table E–4 Yearly View Window Descriptions


UI Object Name Type Description
Backward Icon Button Click this button to view the
previous year in the same yearly
view format.
Current Year Text Field This read-only text field displays the
view of the year that is currently
shown in the yearly view.
Forward Icon Button Click this button to view the next
year in the same yearly view format.
Month Hyperlink Click this link to access the monthly
view for the month selected. The
month of the year is shown on top of
the monthly date picker.
Go To Button Click this button to access the Go To
window where you can select a date
to view in any view format.
Today Button Click this button to view the current
day in the yearly view format.
Date Hyperlink Click the date link to access the daily
view window.
Create Button Click this button to access the Create
Appointment window. The default
date for the appointment is the
current date.

Oracle HTML Calendar User Interface Reference E-5


Combination View

E.5 Combination View


You can maintain daily activities while avoiding schedule conflicts by seeing an
overview of the days events along side a list of current tasks. In the combination
view you can create and update appointments, and view your task summary.

Note: The combination view fields may vary depending on the


columns you choose to display in the Task Summary window.

The following table describes field types in the combination view of Calendar.

Table E–5 Combination View Window Descriptions


UI Object Name Type Description
Backward Icon Button Click this button to view the
previous day in the same
combination view format.
Current Day Text Field This read-only text field displays the
view of the day that is currently
shown in the combination view.
Forward Icon Button Click this button to view the next
day in the same combination view
format.
Time Text Field This read-only text field displays the
times shown on the left side of the
window. In grid format, the times are
shown vertically on the left side of
the window.
Go To Button Click this button to access the Go To
window where you can select a date
to view in any view format.
Today Button Click this button to view the current
day in the combination view format.
Create Button Click this button to access the Create
Appointment window. The default
date for the appointment is the
current date.
Add Button Click this button to access the Create
Appointment window in task view.

E-6 Oracle CRM Application Foundation User Guide


Combination View

Table E–5 Combination View Window Descriptions


UI Object Name Type Description
+ Icon Use this icon to access the Create
Appointment window and select the
time and day and create an
appointment. The icon is shown for
every day in the week and for every
time interval shown in the weekly
view.
Category Drop-down Use the drop-down list to filter the
list of tasks by the category.
Status Drop-down Use the drop-down to filter the list of
tasks by the available statuses. This
enforces the state transition business
rules already in place.
Go Button Click this button to execute the
refresh of the window based upon
the category selection.
Remove Check Box Select the check box of the tasks to be
deleted.
Task Name Hyperlink Click the Task name link to access the
Task Detail window and edit the
task.
Priority Text Field This displays the priority next to
every task in task view.
Note Icon Click the icon to access the Notes
section of the Task Detail window to
see if there are any notes attached to
the task. If no icon appears, there are
no notes attached to the task.
Restore Button Click this button to refresh the
window and revert back to the
original values.
Save Button Click this button to remove all of the
tasks with the remove check box
selected.
Untimed Event Hyperlink Click this link to view at the top of
the calendar to view the untimed
appointment details.

Oracle HTML Calendar User Interface Reference E-7


Availability View

Table E–5 Combination View Window Descriptions


UI Object Name Type Description
Due Date Text Field This read-only text field displays the
due date for the task.

E.6 Availability View


Within the availability view you can check the availability of a resource. Resource
availability is based on appointments assigned directly to the resources which
displays on the resource’s calendar. The following table describes field types in the
availability view of the Calendar.

Table E–6 Availability View Window Descriptions


UI Object Name Type Description
Backward Icon Button Click this button to view the
previous day in the same
combination view format.
Current Day Text Field This read-only text field displays the
view of the day that is currently
shown in the combination view.
Forward Icon Button Click this button to view the next
day in the same combination view
format.
Today Button Click this button to view the current
day in the combination view format.
Go To Button Click this button to access the Go To
window where you can select a date
to view in any view format.
Create Appointment Button Click this button to access the Create
Appointment window. The default
date for the appointment is the
current date.
Add Resource Button Click this button to access the select
users window.
Backward Icon Button Click this button to move backward
to the previous time increment in the
same available view format.

E-8 Oracle CRM Application Foundation User Guide


Group Calendar Summary

Table E–6 Availability View Window Descriptions


UI Object Name Type Description
Time Text Field This read-only text field displays the
times shown on the left side of the
window. In grid format, the times are
shown vertically on the left side of
the window.
Forward Icon Button Click this button to move forward to
the previous time increment in the
same available view format.
Available Text Grid View This field displays the time that is
available for each user. The available
time is shown in the blue color
format.
Unavailable Text Grid View This field displays the time that is
unavailable for each user. The
available time is shown in the red
color format.
Time Hyperlink Click this link to access the create
appointment window where you can
create an appointment for the
selected date/time from the
availability view.
Username Text Field This read-only text field displays the
usernames which appear in the text
grid.

E.7 Group Calendar Summary


The following table describes field types in the Group Calendar Summary window
of Calendar.

Table E–7 Group Calendar Summary Window Descriptions


UI Object Name Type Description
Request New Group Button Click this button to request a new
group calendar.
Subscribe To Group Button Click this button to access the
Subscribe Group window, to search
for a group and subscribe to it.

Oracle HTML Calendar User Interface Reference E-9


Group Calendar Description

Table E–7 Group Calendar Summary Window Descriptions


UI Object Name Type Description
Group Name Text Field This read-only text field displays the
group name.
Group Description Text Field This read-only text field displays the
description of the group.
Color Text Field This read-only text field displays
color for the subscribed calendar
group.
Prefix Text Field This read-only text field displays the
prefix for the group calendar items.
Next Button Click this button to view the next
page of the report results.
Previous Button Click this button to view the
previous page of the report results.

E.8 Group Calendar Description


The following table describes field types in the Group Calendar Subscription
window of Calendar.

Table E–8 Group Calendar Subscription Window Descriptions


UI Object Name Type Description
Subscribe Button Click this button to subscribe to a
group.
Unsubscribe Button Click this button to unsubscribe to a
group.
Group Name Text Field This read-only text field displays the
group name.
Group Description Text Field This read-only text field displays the
description of the group.
Display Color Drop-down Use the drop-down list to select what
color you want your calendar to
display.
Prefix Event Title Text Field Enter the prefix for the group
calendar items.

E-10 Oracle CRM Application Foundation User Guide


Calendar Personal Preferences

E.9 Request New Group


The following table describes field types in the Request New Group window of
Calendar.

Table E–9 Request New Group Window Descriptions


UI Object Name Type Description
Public Check Box Select the check box to indicate if the
new group is a public calendar.
Send Request Button Click this button to submit a new
group calendar request.
Group Name Text Field Enter a name for the group.
Group Description Text Field Enter a description for the group.

E.10 Switch to Another Calendar


The following table describes field types in the Switch to Another Calendar window
of Calendar.

Table E–10 Switch to Another Calendar Window Descriptions


UI Object Name Type Description
Switch Calendar Button Click this button to switch to another
calendar. The user is taken to the
daily view or the default view for the
new calendar.
Calendar Drop-down Use the drop-down list to switch
your calendar in your daily view.
The list of values contain only those
calendars that the user owns. The
default calendar is the user’s
personal calendar.

E.11 Calendar Personal Preferences


The following table describes field types in the Calendar Personal Preferences
window of Calendar.

Oracle HTML Calendar User Interface Reference E-11


Privileges

Table E–11 Calendar Personal Preferences Window Descriptions


UI Object Name Type Description
Update Button Click this button to update your
changes.
Send Notifications Drop-down Use the drop-down list if you want
to issue email invitations.
Clock/(12/24 Hour) Drop-down Use the drop-down list to define the
clock format. Options include: 12
hour or 24 hour (military time) clock.
Week Begins On Drop-down Use the drop-down list to define the
particular day for the week to begin.
Week Ends On Drop-down Use the drop-down list to define the
particular day for the week to end.
Appointment Increment Drop-down Use the drop-down list to select how
you want your calendar to display
appointments in particular
increments.
Start Hour Drop-down Use the drop-down list to select the
start hour for the day.
End Hour Drop-down Use the drop-down list to select the
the end hour for the day.
Weekday Drop-down Use the drop-down list to define the
day for the work hours.

E.12 Privileges
The following table describes field types in the Privileges window of Calendar.

Table E–12 Privileges Window Descriptions


UI Object Name Type Description
Update Button Click this button to update the
appointment to include the newly
attached attendees.
Restore Button Click this button to refresh the
window and revert back to the
original values.

E-12 Oracle CRM Application Foundation User Guide


Categories

Table E–12 Privileges Window Descriptions


UI Object Name Type Description
View Only Access Text Field Enter the user ID for the person who
is to have view only access.
Go Button Click this button to look up users in
the Lookup window.
Add Button Click this button to add a user to the
list.
Remove Button Click this button to remove a user
from the list.
List Box List Box This list box displays users that
currently have view only ability.
Full Access Text Field Enter the user ID for the person who
is to have Full Access.
Go Button Click this button to access the
Lookup window to search for users.
Add Button Click this button to add a user to the
list in the Full Access field list box.
Remove Button Click this button to remove a user
from the Full Access list field list box.
List Box List Box The list box displays all users that
currently have full access ability. You
can select any user to remove them
from the list.

E.13 Categories
The following table describes field types in the Categories window of Calendar.

Table E–13 Categories Window Description


UI Object Name Type Description
Update Button Click this button to update the
appointment to include the newly
attached attendees.
Restore Button Click this button to refresh the
window and revert back to the
original values.

Oracle HTML Calendar User Interface Reference E-13


User Time Zone

Table E–13 Categories Window Description


UI Object Name Type Description
Remove Check Box Select this check box to mark
categories for deletion.
Category Text Field Enter a category to be added to the
list.

E.14 User Time Zone


The following table describes field types in the User Time Zone window of
Calendar.

Table E–14 User Time zone Window Description


UI Object Name Type Description
Update Button Click this button to update the time
zone information.
Time Zone Drop-down Use the drop-down to select the
default time zone.

E.15 Appointment Details


The following table describes field types in the Appointment Details window of
Calendar.

Table E–15 Appointment Detail Window Description


UI Object Name Type Description
Source Text Field This field displays the source of the
appointment.
Appointment Name Text Field This field displays the appointment
name.
Name Text Field Enter a name for the appointment.
Start Date Text Field Enter the start date for the
appointment.
Time Zone Drop-down Use the drop-down list to select the
time zone for the meeting. This
defaults to the user’s preferences.

E-14 Oracle CRM Application Foundation User Guide


Appointment Details

Table E–15 Appointment Detail Window Description


UI Object Name Type Description
Start Time Drop-down Use the drop-down list to select the
start hour time for the appointment.
If you select a time from the daily
view, then that time is automatically
entered in the start time upon the
user opening the Create
Appointment window.
Duration Drop-down Use the drop-down list to select the
duration for the appointment.
Type Drop-down Use the drop-down to select the task
type for the appointment. Task types
are defined during the set up.
Private Check Box Select the check box to create a
private appointment for yourself that
no other individual can view.
Category Drop-down Use the drop-down list to select a
predefined category for the
appointment. You can also create
their own categories which appears
in the drop-down.
Priority Drop-down Use the drop-down list to select a
priority for the appointment.
Options include: High, Medium,
Low, and None.
Description Text Field Enter a description for the
appointment.
Update Button Click this button to update the
reference table. Any items that have
been selected to be removed should
disappear.
Restore Button Click this button to refresh the
window and revert back to the
original values.
Delete Button Click this button to delete the
appointment information.
Created By Text Field This read-only text field displays the
full name, username, and employee
ID of the person who created the
appointment.

Oracle HTML Calendar User Interface Reference E-15


Create Appointment

Table E–15 Appointment Detail Window Description


UI Object Name Type Description
Created Date Text Field This read-only text field displays the
date the appointment was created.
Updated By Text Field This read-only text field displays the
full name, username, and employee
ID of the person who updated the
appointment.
Updated Date Text Field This read-only text field displays the
date the appointment was updated.

E.16 Create Appointment


The following table describes field types in the Create Appointment window of
Calendar.

Table E–16 Create Appointment Window Description


UI Object Name Type Description
Name Text Field Enter a name for the appointment.
Start Date Text Field Enter the date for the appointment.
Time Zone Drop-down Use the drop-down list to select the
time zone for the meeting. This
defaults to the user’s preferences.
Start Time Drop-down Use the drop-down list to select the
start time for the appointment. If the
user has selected a time from the
daily view, then that time populates
the start time upon the user opening
the window.
Duration Drop-down Use the drop-down list to select the
duration of the appointment. This
defaults to 1 hour if not start time is
specified.
Type Drop-down Use the drop-down to select the task
type for the appointment. Task types
are defined during the set up.
Private Check Box Select the check box to create a
private appointment for yourself that
no other individual can view.

E-16 Oracle CRM Application Foundation User Guide


Create Appointment

Table E–16 Create Appointment Window Description


UI Object Name Type Description
Remind Me Drop-down Use the drop-down list to select
when you want to be reminded of an
appointment. Options include: Do
Not Remind Me, 15 Minutes Before,
30 Minutes Before, 1 Hour Before, 2
Hours Before, 1 Day Before, 2 Days
Before, 3 Days Before, 1 Week Before.
Category Drop-down Use the drop-down list to select a
predefined category for the
appointment. The user can also
create their own categories in the
calendar preferences.
Priority Drop-down Use the drop-down list to select a
priority for the appointment.
Options include: High, Medium,
Low, and None.
Description Text Field Enter a note for the appointment
description.
Reference Type Drop-down Use the drop-down list to select an
object to reference an appointment
being created such as a person,
organization, or opportunity.
Related Object Name Text Field Enter a name for the related object.
Go Button Click this button to access the
customer Lookup window to look up
a customer.
Related Object Text Field This read-only text field displays a
Description description of the related object.
Clear Button Click this button to refresh the
window without saving your
changes.
Create Button Click this button to save the
appointment information.
Create and Create Button Click this button to create an
Another appointment while remaining in the
Create Appointment window. The
first appointment is saved, the
window is cleared, and you are
ready to enter another appointment.

Oracle HTML Calendar User Interface Reference E-17


Attendees

E.17 Attendees
The following table describes field types in the Attendees window of Calendar.

Table E–17 Attendees Window Description


UI Object Name Type Description
Source Hyperlink Click this link to display the source
of the appointment.
Appointment Name Hyperlink Click this link to display the
appointment details.
Attendee Text Field This read-only text field displays the
attendee’s username.
Go Button Click this button to access the
Lookup window to find a customer.
Click the name to populate the field.
Add Button Click this button to add the selected
attendee to the multi-select box.
Remove Button Click this button to remove a
username from the multi-select box.
Availability Button Click this button to check the
availability of the attendee in a
graphical view.
Invite Button Click this button to send the
usernames in the multi-select box, an
invitation. The window is refreshed
and the usernames now appear in
the attendees table with a status of
invited, and the current date.
Attendee Multi-select Box Multi-select Box This field displays the intended list
of invitees.
Update Button Click this button to update the
appointment to include the newly
added attendees.
Remove Check Box Select the check box to remove an
attendee from the list when you click
Update.
Username Text Field This read-only text field displays the
invitee’s username.

E-18 Oracle CRM Application Foundation User Guide


Appointment Invitation

Table E–17 Attendees Window Description


UI Object Name Type Description
Resource Name Text Field This read-only text field displays the
resource name.
Status Text Field This read-only text field displays the
status for the selected invitee.
Updated Text Field This read-only text field displays the
date when the attendee status was
updated.
Restore Button Click this button to refresh the
window and revert back to the
original values.

E.18 Appointment Invitation


The following table describes field types in the Appointment Invitation window of
Calendar.

Table E–18 Appointment Invitation Window Description


UI Object Name Type Description
Accept Button Click this button to accept the
invitation to the appointment.
Reject Button Click this button to reject the
invitation to the appointment.
Appointment Name Text Field This read-only text field displays the
name of the appointment.
Start Date Text Field This read-only text field displays the
date of the appointment.
Time Zone Text Field This read-only text field displays
what time zone the appointment is
scheduled to take place.
Start Time Text Field This read-only text field displays the
time the appointment is scheduled to
begin.
Duration Text Field This read-only text field displays
who long the appointment is
scheduled for.

Oracle HTML Calendar User Interface Reference E-19


Reference

Table E–18 Appointment Invitation Window Description


UI Object Name Type Description
Type Text Field This read-only text field displays the
task type.
Owner Text Field This read-only text field displays the
name of the owner of the
appointment.
Category Text Field This read-only text field displays the
task category.
Priority Text Field This read-only text field displays the
priority of the appointment.
Description Text Field This read-only text field displays the
appointment description.
Created By Text Field This read-only text field displays the
full name, username, and employee
ID of the person who created the
appointment.
Created Date Text Field This read-only text field displays the
date the appointment was created.
Updated By Text Field This read-only text field displays the
full name, username, and employee
ID of the person who updated the
appointment.
Updated Date Text Field This read-only text field displays the
date the appointment was updated.

E.19 Reference
The following table describes field types in the Appointment Detail Reference
window of Calendar.

Table E–19 Reference Window Description


UI Object Name Type Description
Source Hyperlink Click this link to display the source
of the appointment.
Appointment Name Hyperlink Click this link to display the
appointment details.

E-20 Oracle CRM Application Foundation User Guide


Repeating

Table E–19 Reference Window Description


UI Object Name Type Description
Type Drop-down Use the drop-down list to select the
reference object.
Name Text Field Enter a resource name.
Go Button Click the Go button to access the
Lookup window to look up a
customer. Upon selecting a name
from the Lookup window, the user is
taken back to the appointment
Reference window with the selected
name entered as a Reference object.
Update Button Click this button to update the
Reference table. Any items that have
been selected to be removed should
disappear.
Restore Button Click this button to refresh the
window and revert back to the
original values.
Remove Check Box Select the check box next to the
Reference objects to remove them
from the table. If an icon is
displayed, click it to clear the row
before you update the record.
Type Text Field This read-only text field displays the
object type.
Name Text Field This read-only text field displays the
name of the related object.
Description Text Field This read-only text field displays a
text description of the related object.

E.20 Repeating
The following table describes field types in the Repeating window of Calendar.

Table E–20 Repeating Window Description


UI Object Name Type Description
Source Hyperlink Click this link to display the source
of the appointment.

Oracle HTML Calendar User Interface Reference E-21


Repeating

Table E–20 Repeating Window Description


UI Object Name Type Description
Appointment Name Hyperlink Click this link to display the
appointment details.
Update Button Click this button to update the
Reference table. Any items that have
been selected to be removed should
disappear.
Restore Button Click this button to refresh the
window and revert back to the
original values.
Start Date Text Field This read-only text field displays the
start date of the appointment.
End Date Text Field Enter the end date for the repeating
appointment. You choose either an
end date or a count, but not both.
Count Text Field Enter the number of days you want
the appointment to repeat.You
choose either an end date or a count,
but not both. The default count is 10.
Date Picker Icon Click the icon to access the
micro-monthly calendar to select a
start date for the repeating
appointment.
None Option Button Select the none option button to
indicate that you do not have a
repeating appointment.
Daily Option Button Select the daily option button to
specify that you want the
appointment to repeat on a daily
basis. Once selected, you can select
the daily frequency options for the
number of days and the end date.
Every Day Text Field Enter the number of days for the
appointment to repeat.
Weekly Option Button Select the weekly option button to
repeat the appointment on a weekly
basis. You can select the frequency
options for the weekly frequency, the
days to include, and the date to end.

E-22 Oracle CRM Application Foundation User Guide


Attachments

Table E–20 Repeating Window Description


UI Object Name Type Description
Every Week Text Field Enter the number for the frequency
to repeat (every two weeks or every
week). The default is 1.
Days Multi-select Box Select the specific days to include for
weekly repeating. The default is the
current day it the check box cannot
be deselect. However, you can select
additional days.
Monthly Option Button Select the monthly option button to
repeat the appointment on a monthly
basis. You can select the frequency
options for the monthly frequency,
the days to include, and the date to
end. The default is 1.
Every Month Text Field Enter the frequency to repeat of
monthly repeating. For example,
once a month.
On Text Field Enter the date for the repeating
monthly appointment. The default is
none.
On The Multi-select Box Select the specific days to include for
monthly repeating.

E.21 Attachments
The following table describes field types in the Attachment’s window of Calendar.

Table E–21 Attachment Window Description


UI Object Name Type Description
Source Hyperlink Click this link to display the source
of the appointment.
Appointment Name Hyperlink Click this link to display the
appointment details.
Update Button Click this button to update the
appointment to include the newly
attached attendees.

Oracle HTML Calendar User Interface Reference E-23


Add Attachments

Table E–21 Attachment Window Description


UI Object Name Type Description
Restore Button Click this button to refresh the
window and revert back to the
original values.
Add Attachment Button Click this button to access the Add
Attachment window to create or add
an attachment to an appointment.
Remove Check box Select this check box to remove a
username from the multi-select box.
If an icon is displayed, click it to
clear the row before you update the
record.
Date Added Text Field This field displays the date that the
attachment was created.
Description Text Field Click this link to access the Note
Details window and view the first 20
characters of the attachment and drill
down to the attachment details.
File Size Text Field This read-only text field displays the
file size of the attachment.
Data Type Text Field This read-only text field displays the
data type for the attachment. Options
include: Add Existing File, Text, File
or URL.
Added By Text Field This field displays the user’s name
and resource ID of the creator of the
attachment.
Attachment Hyperlink Click this link to view the attachment
whether it is (a file, a URL, or text).

E.22 Add Attachments


The following table describes field types in the Add Attachment window of
Calendar.

E-24 Oracle CRM Application Foundation User Guide


Add Attachments

Table E–22 Add Attachment Window Description


UI Object Name Type Description
Source Hyperlink Click this link to display the source
of the appointment.
Appointment Name Hyperlink Click this link to display the
appointment details.
Create Button Click this button to create a new
attachment.
Clear Button Click this button to refresh the
window without saving your
changes.
Description Text Field Enter a text message to be attached.
Text Option Button Select the text option button to
indicate that the attachment is in a
free-formed text format.
Text Text Field Enter your attachment text in the text
field.
File Option Button Select the file option button to
indicate that the attachment is a file.
File Text Field Enter the file location.
URL Text Field Enter the URL you want to attach in
the text field.
Browse Button Click this button to navigate to the
file location.

Oracle HTML Calendar User Interface Reference E-25


Add Attachments

E-26 Oracle CRM Application Foundation User Guide


F
Oracle Interaction History User Interface
Reference

This appendix contains user interface object descriptions of the HTML version of
Interaction History.

F.1 The Outcomes Window


The following table describes user interface objects in the Interaction History
Outcomes window.

Table F–1 Interaction History Outcome Window Descriptions


UI Object Name Type Description
Update Button Check any boxes you want to change in the
Select column, then click this button to
update the outcome records.
Delete Button Check any boxes you want to change in the
Select column, then click this button to
remove the item once you click Delete.
Restore Button Click this button to refresh the window and
revert back to the original values.
Create Button Click this button to create new outcomes.
Code Text Field Enter the code name of the outcome.
Short Description Text Field Enter the full name of the outcome.
Long Description Text Field Enter a detailed description of the outcome.
Recycling Code Text Field Enter the outcome code as either positive or
negative. Numeric values are assigned.

Oracle Interaction History User Interface Reference F-1


The Results window

Table F–1 Interaction History Outcome Window Descriptions


UI Object Name Type Description
Positive Outcome Check Box Select the check box for the outcome as
either a positive or negative outcome. When
checked, the outcome code is considered
positive. It defaults to unchecked.
Generate Private Callback Check Box Select the check box for the outcome to
indicate who can call back the customer.
When checked, the original agent who
interacted with the customer should
callback. Defaults to unchecked.
Generate Public Callback Check Box Select the check box for the outcome to
indicate who can call back the customer.
When checked, any agents can call back the
customer. Defaults to unchecked.
Results Required Check Box Select the check box for the outcome code
must have a result associated with it. When
checked, that particular outcome code
requires a result code. Defaults to
unchecked.

F.2 The Results window


The following table describes user interface objects in the Interaction History
Results window.

Table F–2 Interaction History Results Window Descriptions


UI Object Name Type Description
Update Button Check any boxes you want to change in the
Select column, then click this button to
update the result records.
Delete Button Check any boxes you want to change in the
Select column, then click this button to
remove the item once you click Delete.
Restore Button Click this button to refresh the window and
revert back to the original values.
Create Button Click this button to create new results.
Code Text Field Enter the code name of the result.

F-2 Oracle CRM Application Foundation User Guide


The Reasons Window

Table F–2 Interaction History Results Window Descriptions


UI Object Name Type Description
Short Description Text Field Enter the full name of the result. The value
is displayed in the agent’s window.
Long Description Text Field Enter a detailed description of the result up
to 1000 characters.
Positive Outcome Check Box Select the check box for the outcome as
either a positive or negative outcome. When
checked, the outcome code is considered
positive. It defaults to unchecked.
Reason Required Check Box Select the check box to specify that the result
code must have a reason associated with it.
When checked, that particular result code
requires a reason. Defaults to unchecked.

F.3 The Reasons Window


The following table describes user interface objects in the Interaction History
Reason window.

Table F–3 Interaction History Reason Window Descriptions


UI Object Name Type Description
Update Button Check any boxes you want to change in the
Select column, then click this button to
update the reason records.
Delete Button Check any boxes you want to change in the
Select column, then click this button to
remove the item once you click Delete.
Restore Button Click this button to refresh the window and
revert back to the original values.
Create Button Click this button to create new reasons.
Code Text Field Enter the code name of the reason.
Short Description Text Field Enter the full name of the reason. The value
is displayed in the agent’s window.
Long Description Text Field Enter a detailed description of the reason up
to 1000 characters.

Oracle Interaction History User Interface Reference F-3


The Outcome-Result Window

The following table describes user interface objects in the Interaction History
Outcomes-Result window.

F.4 The Outcome-Result Window


Table F–4 Interaction History Outcome-Result Window Descriptions
UI Object Name Type Description
Delete Button Check any boxes you want to change in the
Select column, then click this button to
remove the item once you click Delete.
Restore Button Click this button to refresh the window and
revert back to the original values.
Create Button Click this button to create new
outcomes-results.
Outcome Drop-down This read-only text field displays all
available outcomes.
Result Drop-down This read-only text field displays all the
results associated to the outcome are
displayed. The results are automatically
populated and are not editable.

The following table describes user interface objects in the Interaction History
Result-Reason window.

F.5 The Result-Reason Window


Table F–5 Interaction History Result-Reason Window Descriptions
UI Object Name Type Description
Delete Button Check any boxes you want to change in the
Select column, then click this button to
remove the item once you click Delete.
Restore Button Click this button to refresh the window and
revert back to the original values.
Create Button Click this button to create new
result-reasons.

F-4 Oracle CRM Application Foundation User Guide


The Action Window

Table F–5 Interaction History Result-Reason Window Descriptions


UI Object Name Type Description
Result Text Field This read-only text field displays all the
results.
Reason Text Field This read-only text field automatically
populates the reasons associated with the
result.

F.6 The Action Item Window


The following table describes user interface objects in the Interaction History Action
Item window.

Table F–6 Interaction History Action Item Window Descriptions


UI Object Name Type Description
Update Button Check any boxes you want to change in the
Select column, then click this button to
update the Activity Type record.
Delete Button Check any boxes you want to change in the
Select column, then click this button to
remove the item once you click Delete.
Restore Button Click this button to refresh the window and
revert back to the original values.
Create Button Click this button to create new codes and
short descriptions.
Select Check box Select the check box for the Codes and Short
Descriptions needed to complete the action.
Code Text Field Enter the action code in the text field.
Short Description Text Field Enter the action name in the text field.

F.7 The Action Window


The following table describes user interface objects in the Interaction History Action
window.

Oracle Interaction History User Interface Reference F-5


The Wrap Up Window

Table F–7 Interaction History Action Window Descriptions


UI Object Name Type Description
Update Button Check any boxes you want to change in the
Select column, then click this button to
update the action records.
Delete Button Check any boxes you want to change in the
Select column, then click this button to
remove the item once you click Delete.
Restore Button Click this button to refresh the window and
revert back to the original values.
Create Button Click this button to create new actions.
Code Text Field Enter the action code in the text field.
Short Description Text Field Enter the action name in the text field.

F.8 The Wrap Up Window


The following table describes user interface objects in the Interaction History Wrap
Up window.

Table F–8 Interaction History Wrap Up Window Descriptions


UI Object Name Type Description
Update Button Check any boxes you want to change in the
Select column, then click this button to
update the wrap up records.
Delete Button Check any boxes you want to change in the
Select column, then click this button to
remove the item once you click Delete.
Restore Button Click this button to refresh the window and
revert back to the original values.
Create Button Click this button to create new wrap ups.
Type Text Field Enter the wrap-up types.
Campaign Text Field Enter the campaign name for the wrap-up
type.
Outcome Drop Down Use the drop-down list to select the
outcomes.
Result Drop Down Use the drop-down list to select the results.

F-6 Oracle CRM Application Foundation User Guide


The Wrap Up Window

Table F–8 Interaction History Wrap Up Window Descriptions


UI Object Name Type Description
Reason Drop Down Use the drop-down list to select the reasons.

Oracle Interaction History User Interface Reference F-7


The Wrap Up Window

F-8 Oracle CRM Application Foundation User Guide


G
Oracle Escalation Management User
Interface Reference

This appendix contains user interface object descriptions of the Escalation Manager
and Business Rule Monitor windows.

G.1 Explanation of Escalation Manager Components


The following table describes the user interface objects in the Escalation window.

Table G–1 Escalation Window


UI Object Name Type Description
Customer List of values Use the LOV to select the customer name.
(LOV)
Account LOV Use the LOV to select the customer account.
Location LOV Use the LOV to select the customer location.
Number Field A number is unique and assigned to the
escalation.
Status LOV A status describes the state of the escalation:
Closed
Open
Working
Reason LOV A reason describes why an escalation occurred.
Date Opened Field The current date is the default of when the
escalation was opened.

Oracle Escalation Management User Interface Reference G-1


Explanation of Escalation Manager Components

Table G–1 Escalation Window


UI Object Name Type Description
Date Closed Field Use the LOV to select a date when closing the
escalation.
Target Date Field Use the LOV to select a date when the escalation
should be resolved.
Level LOV Level describes the severity of the escalation.
Some seeded values include:
De-Escalated
Level 1
Level 2
Never Escalated
Escalation Territory Field. The field automatically populates only when an
owner is assigned to the document through the
Assignment Manager and if the escalated source
document is assigned to a resource defined in a
territory.
Owner LOV Use the LOV to select the owner.
Assign Button Select the button to open Assignment Manager.
Escalation Text Field Use the text field to summarize the situation.
Summary
Reference Tab Use this tab to reference the type, document,
Documents number and details of other relevant documents
if it is not populated automatically.
Contacts Tab Use this tab to enter contact information
(employee or customer) and how the contacts
are to be alerted. This tab is also used to identify
the requester.
Audit Tab Use this tab to view all the changes that have
been made to an escalation document. Each
update to it is recorded here after every save.
Notes Button Click this button to open the Notes module. You
must first save your work.
Task Button Click this button to open the Task Manager. You
must first save your work.
Save Button Click this button to save your work.
Cancel Button Click this button to cancel the escalation.

G-2 Oracle CRM Application Foundation User Guide


Business Rule Monitor window

G.2 Explanation of Business Rule Monitor Components


The following table describes user interface objects in the Business Rule Workbench
Window.

Table G–2 Business Rule Workbench Window


UI Object Name Type Description
Name Field Define the name of a rule.
Object Drop down list An object is what the rule relates to such as, Task,
of values (LOV) Service Request, or Defect.
Description Field Describe the business rule you want to enforce.
Owner LOV Select a business rule owner.
Effective Fields Enter range of dates when the business rule is
operational. Leave this field empty until the time
you are ready to enable the business rule.
Check Rule Every Field Enter a period of time which the rule will be
checked.
Tolerate Condition Field Enter a period of time which you can tolerate the
For condition before acting upon it.
Workflow LOV Select workflow process for the business rule.
... Button The Workflow Attribute button allows for the
selection of resource (owner.)
Simple Tab Enter SQL code using "prompts" or use the
Complex tab.
Complex Tab Use this tab to enter SQL code directly instead of
using the Simple tab.
Show SQL Button This button displays the SQL code in the Complex
tab.
Validate Button This button validates if the SQL code is
syntactically correct.
Generate Button This button generates the business rule.

G.3 Business Rule Monitor window


The following table describes the user interface objects in the Business Rule Monitor
Window.

Oracle Escalation Management User Interface Reference G-3


Business Rule Monitor window

Table G–3 Business Rule Monitor Window


UI Object Name Type Description
Interval Field Set the polling interval.
UOM Field Enter a unit of measure, for example, minutes.
Item Key Field The item key is a unique identifier of the main BRM
process which checks all the business rules.
Status Field The status displays the current state of the BRM
process, such as, active, stopping, or complete.
Refresh Status Button Clicking this button refreshes to the current status of
the rule.
Workflow Button Click this button to start the workflow monitor tool.
Monitor
Stop Button Click this button to stop the main BRM process.
Cancel Button Click this button to exit the window.
Save Button Click this button to save the interval and UOM
entered.

G-4 Oracle CRM Application Foundation User Guide


Glossary

A B C D E F G H I J M N O P Q R S T U W

1-to-1 Fulfillment
Fulfillment is a tool used to automate the way you send information to customers. It
provides the ability to immediately satisfy a customer’s requests electronically for
information, literature, and other correspondence.

activity
An activity is the event that takes place related to a media item and an interaction in
Interaction History. It can be a transfer as in the situation of transferring a phone
call or an email. It can also be a business action performed by an agent such as
sending a fax, updating a service request, or creating a note.

approval
An optional feature in User Management, whereby approvers can reject or approve
new user accounts. In the User tab, the System Administrator Console provides
windows so you can view, create, modify, delete, enable, and disable approvals,
including those for specific organizations.

approval flow
The approval flow is a predefined flow of steps required to approve user
registration or service enrollment requests in User Management.

Glossary-1
assignee
An assignee is the designated person who is assigned to fulfill a specific task or
assignment. If an assigned task cannot be completed by the assignee, then the
owner of this task can reassign a new resource (assignee) to this task.
The assignee, can also be the owner of the task.

Assignment Manager
The Assignment Manager is a tool that helps you assign resources to a task or a
document.

assisted assignment option


The assisted assignment option is used to assign a resource to a task or a document
based on predefined criteria in the Assignment Manager.

attachment
An attachment is any document associated with one or more application modules.
You can view attachments as you review and maintain a module. For example:
operating instructions, purchase order, notes, item drawings, presentations, or an
employee photo can be an attachment.

audit
An audit displays a history of changes that have been made to information in a
CRM application.

automatic assignment
Automatic assignment refers to the matching of territories to resources resulting in a
"Winning Territory" in Territory Management.

bins
Bins are small reports, which display high-level summary information in a tabular
format on your homepage.

business rule
A business rule is a user-defined condition. When a rule is violated, a relevant
workflow process can be triggered.

Glossary-2
Business Rule Monitor (BRM)
The Business Rule Monitor is the engine that monitors documents over time against
user-defined business rules.

business rule owner


A business rule owner is an employee resource who enforces the business rules.

business rule workbench


The Business Rule workbench is used to define a business rule in BRM.

business user
A business user is a typical Business to Business (B2B) user, associated with an
organization. Generally, the Primary user(s) of the same organization approves
these users.

Calendar (HTML)
The HTML Calendar is a tool to effectively manage your daily activities,
appointments, and tasks.

Calendar (Forms)
The Forms-based Calendar is a scheduling tool used to define and view available
and non-available time for a resource or group of resources.

calendar datebook
The calendar datebook displays time availability for yourself, a resource, or a group
of resources in the Forms-based Calendar.

catch all territory


A Catch All territory is a placeholder used at the top of a territory hierarchy when
no other is defined in Territory Management.

collateral
Collateral is a static 1-to-1 Fulfillment document that doesn’t contain merged data.
It is usually some sort of marketing brochure or some other document. It is sent in
an email as an attachment. It is often called a deliverable in the marketing
applications.

Glossary-3
concurrent manager
The concurrent manager is a process manager that coordinates the processes
generated by users’ requests to run various data-intensive programs. An Oracle
applications product group can have several concurrent managers.

contact
A contact contains information about a person and how to locate them such as their
phone number and email address.

control tower
The Control Tower is a window in Field Service where you can view resource
availability or assign resources to a task.

customer
Customers are typically primary users, Business to Business (B2B) users, business to
Customer (B2C), and (individual) users.

customer relationship escalation


A customer relationship escalation is an escalation document that escalates multiple
support requests, defects, or tasks.

customization
Customizations are enhancements to an Oracle Applications system made to fit the
needs of a specific user community.

database monitor
The database monitor checks the database activity following a database crash or
disconnect from the database in Fulfillment. This monitor temporarily shuts down
the Fulfillment server into a sleep mode until connection to the database can be
re-established.

defect
A defect is a document that tracks product problems and resolutions in Escalation
Management. A defect can be escalated without an associated service request. It is
escalated through Oracle Quality Online (OQO), formerly known as the Defect
Management System.

Glossary-4
dependency
A dependency is where one task must complete before another. This functionality is
only available in the Forms-based Task Manager.

detail screen
A Detail screen displays information about a specific open request, campaign, or
output device in 1-to-1 Fulfillment.

dynamic group
A dynamic group is a group which is created based on your criteria by using SQL
statements in the Resource Manager.

dynamic mode
Dynamic modes are qualifiers are used to control the number of territories after
creating a mass number of territories in Territory Management. The values of both
transaction and resource dynamic qualifiers are exclusively mixed together while
assigning them to the new territories.

effective dates
Effective dates are the dates used by CRM modules to specify when something is
going to begin.

employee
An employee is a resource type that represents a person who is hired to work for a
company. Employee resources can be imported as resources from the Oracle Human
Resources Management System (HRMS).

enrollment
Enrollment is a set of add-on services that you can receive during or after
registration in User Management. One enrollment corresponds to zero or one
responsibility, zero or one template, zero or one approval and zero or more roles.
Enrollments are application specific and can be tied to user types.

escalation
To escalate something, such as a process, means to increase in extent or intensity.

Glossary-5
Escalation Management
Escalation Management is a tool used to reprioritize, reassign, and monitor a
situation, such as a service request or task, to a satisfactory completion.

escalation owner
An escalation owner is a person who oversees the escalation task, or document in
Escalation Management. Once a task or document is escalated, the responsibility of
the original owner of the escalated task is transferred to the escalation owner. For
example, a defect is escalated to Rhonda Abbott and Rhonda becomes the escalation
owner of this defect. John Smith, the original owner of the escalated defect, is no
longer responsible for the defect.

escalation plan
An escalation plan is a series of follow up tasks that are attached to the escalation
document.

escalation territories
Escalation territories provide you with the ability to define the escalation path in the
event of exceptions. This is necessary for all administrative purposes and
accountability purposes. Territory based escalation definition provides you with the
multi-level escalation path for each territory. When defining a territory, the user has
the option of designating the escalation territory. An escalation territory must be
defined with the escalation flag checked before it will be present in the Escalation
list of values (LOV).

exception
An exception is defined the time that a resource is not available in the Forms-based
Calendar. Examples of exceptions include holidays, vacations, sick days, or
weekends.

explicit enrollment
Explicit enrollments are enrollments that you manually register for during the
registration process from the "Register Here" link in User Management.

forms
Forms are a logical collection of fields, regions, and graphical components that
appears on a single screen. Oracle applications forms resemble paper forms used to
run a business. You enter data by typing information into the form.

Glossary-6
forms server
A Forms server is a type of application server that hosts the Forms server engine. It
mediates between the desktop client and the database, providing input screens for
the Forms-based products on the desktop client and creating or changing database
records based on user actions.

framework
A framework is a collection of collaborating classes. The interaction framework
dictates the architecture. It defines the overall structure, its partitioning into classes
and objects, the key responsibilities, how the classes and objects collaborate, and the
thread of control.

fulfillment administrative console


Fulfillment administrative console is used to configure fulfillment servers, group,
templates, queries, and locate request statuses and histories.

fulfillment administrator
A Fulfillment Administrator is the person at a management level who is responsible
for creating and managing 1-to-1 Fulfillment functions.

fulfillment agent
An agent or user is the person who initiates a fulfillment request from within a
CRM application. Agents usually interact directly with customers, either on the
phone or face-to-face. In Web-based self-service applications, a customer or prospect
may be the requesting agent.

fulfillment agent windows


The fulfillment agent’s windows is set of agent Java Server Pages (JSPs) that are
provided to CRM applications for creating basic fulfillment requests.

fulfillment request
A fulfillment request is the entity that is created when a request is passed to the
fulfillment engine. If a request is successful, then an email is generated containing
the requested information and sent to the designated recipient.

fulfillment server
The fulfillment server (or engine), a Java-based multi-threaded server, processes the
requests, merges data into master documents, dispatches final output, and logs

Glossary-7
completed requests in the fulfillment history table. The server also writes to the
Interaction History tables if the party ID is passed.

fulfillment server monitors


The fulfillment server has a set of internal monitors each with a specific task to
ensure proper functioning of the fulfillment server, including: process monitor,
request monitor, command monitor, remote monitor, database monitor, and
schedule monitor.

full access
Full access provides you with the ability to read and edit, and delete a record. This
access type does not include the capability of granting access to others.

Gantt Chart
The Gantt chart provides a graphical overview of the scheduled tasks for resources.

group
A group is a set of agents or users usually related by a workgroup, function, or
department. It can consist of individual resources and groups. The idea of a group is
used in the Resource Manager, to organize based on similar functionality or roles of
its members. Groups are also associated with fulfillment servers and e-mail servers
in which agents within a group can send out fulfillment requests to customers.

group calendar
A group calendar is a calendar used only by its subscribers in the HTML Calendar.
For example, a group calendar called Key Account can be used by any subscriber
after the subscription is approved.

GUI
An interface used with personal computers and workstations that allows the user to
access fields and regions of the screen with a pointing device, typically a mouse.
The acronym is pronounced "goo-ee."

HTML (hypertext markup language)


HTML is a simple language used to format documents, predominantly for viewing
with a web browser. Portions of text or images, called hypertext, can be associated
with other documents.

Glossary-8
HTTP (Hypertext transfer protocol)
The TCP/IP-based network protocol used to transmit requests and documents
between an HTTP server and a web browser.

HTTP listener
An HTTP listener is a program on an HTTP server that accepts and processes
incoming HTTP requests from web browsers.

implicit enrollment
These are enrollments for which a user is automatically registered for during the
registration process using the "Register Here" link In User Management. The user is
not asked to register for these enrollments. Instead, they are automatically attached
to the user upon registration.

individual user
An individual user is an individual with no relationship to an organization in User
Management. Generally, no approval is required for this type of user.

intelligent assignment option


The intelligent assignment option is used only in the Field Service Dispatch Center
to assign the resource with the lowest cost.

interaction
An interaction is a touch point that occurs between a customer, a customer system,
a resource, or a resource system. An example of a touch point is a phone call
between an agent and a customer. Interactions include activities, media, and media
items.

Interaction History (IH)


IH provides CRM applications with a common framework for capturing and
accessing all "interaction" data associated with customer contacts. IH acts as the
central repository and provides a consistent framework for tracking all automated
or agent-based customer interactions.

items
Items can be master documents, collateral, or attachments in Fulfillment. Items are
inserted in the body of an email. Items are selected from the list of all possible
documents and collateral material available to the user from Fulfillment templates.

Glossary-9
JAR (java archive) file
JAR files are a collection of Java classes compressed into files for faster download to
a desktop client.

java class
Java classes are components of a Java program that define objects and operations
performed on objects. A Java class also identifies an operating system file that
contains a program or part of a program written in Java.

JInitiator
Oracle JInitiator enables end users to run Oracle Developer Server applications
directly within Netscape Navigator or Microsoft Internet Explorer on the Windows
95, 98, or 2000 and Windows NT4.0 platforms. Implemented as a plug-in (Netscape
Navigator) or ActiveX component (Microsoft Internet Explorer), Oracle JInitiator
allows you to specify the use of Oracle’s Java Virtual Machine (JVM) on web clients
instead of having to use the browser's default JVM.

JSP
Java server pages are an extension to the Java servlet technology that was
developed by Sun as an alternative to Microsoft's ASPs (Active Server Pages). JSPs
have dynamic scripting capability that works in tandem with HTML code,
separating the page logic from the static elements — the actual design and display
of the page.

list of values (LOV)


A list of value is a predefined list of choices that the user has to chose from.

master document
A master document is a static or dynamic HTML, PDF, or zip file in 1-to-1
Fulfillment.

media
In Interaction History, media represents the communication channel through which
an activity takes place. Examples can include: the phone, the fax machine, an ATM,
or a cell phone.

Glossary-10
media device
A media device is a type of media controller that resides outside of software. Not all
media have media devices in Interaction History. An example of a media device is a
phone.

media item
Media items represent a communication occurrence that is handled by a CRM
application or user. They are generated by a customer directly, the agent, the
system, or a CRM application and can be inbound or outbound. Media items are
multiple types of communication associated with an interaction. They are generated
by a customer, the system, or an application and can be inbound or outbound.

media item life cycle


A Media item life cycle is a unit of time associated with the handling of a media
item in Interaction History. For example, a call that is in the ACD queue for 10
seconds, the Interactive Voice Response (IVR) for 20 seconds, worked by agent
JSMITH for 45 seconds and then by agent JDOE for 20 seconds has four segments in
its life cycle.

media metadata
Media metadata is data that is associated with a particular type of media. The
information adds additional context to the media or provides information on how
to gain access to the media. Examples of media metadata include IVR, ANI, DNIS
for telephone calls, and To, From, Subject, and Classification for emails.

media provider
A media provider is the source or entry point of media into a call or service center.
It can be the creator of the media of the gateway by which media enters the system.
Often it will provide a staging area for the media to reside in until it is ultimately
delivered to the consumer. Examples of media providers are ACD queues,
predictive servers, and email servers.

media type
A media type describes the broad classification that a media item can be grouped
into in Interaction History. Media that fall into a single media type typically have
the same media provider, queuing, and media controller. Examples of media types
are email, inbound telephone calls, outbound telephone calls, mail, ATM, and faxes.

Glossary-11
merchant administrator (system administrator)
The Merchant or System Administrator is the main administrator of a company
who approves requests for primary, business, and individual users in the User
Management process. This System Administrator, who has the JTF_REG_
APPROVAL permission, sees all the pending requests to be approved and is able to
approve them.

merchants
Merchants refer to implementors of the Oracle E-Business Suite. This term is used to
clear up any confusion with the term “customers”, which refers to customers of a
business using Oracle products as opposed to those implementing the product.

merged data
Merged data is a the specific chunk of data that has been taken from several sources
and merged together in Fulfillment. For example, if a company wants to send a
thank you email to everyone that has inquired about their company, the resulting
merged data is the query retrieving all customers that have inquired about the
company.

Notes
Notes is a tool that provides additional text locations where you can specify more
detail, if needed. A note can be added to a task.

note source
A note source is the originating module of the note. For example, if the notes are
entered from a service request application, then the source of the note is Service
Request.

note status
Note status determines note accessibility. For example, you can define a private note
with status of Personal so that only you can see the note.There are three statuses
available for notes that you can set:
■ Private: Only the creator can view it.
■ Public: The creator and others can read or write to it.
■ Publish: Publishable over the Internet. Everyone can view it. This status is
currently not used.

Glossary-12
note text
A large type note, such as a customer’s letter or directions.

note type
Note types provide a further categorization to the notes based on a user’s
individual needs. Also, a note type can be tied to a source type and such note types
are visible only to that mapped source. Therefore, you must choose between the
entire note types that have been defined for your source and those which do not
have any source type attached to them.

number of winners
The number of winners field is used to specify the maximum number of potential
winning territories in Territory Management.

object
An object is any identifiable individual or thing. It can be physical, such as a
telephone or PBX, or an abstract concept, such as a market campaign in Interaction
History.

OMO
OMO is an acronym for Oracle Marketing Online.

OSO
OSO is an acronym for Oracle Sales Online.

other/TBH
Other/THB is the only resource that is created and not imported in the form-based
version of Resource Manager. Use this resource to create a salesperson that is going
to be hired (TBH) but is not yet an employee.

output
The output is the delivery medium of a fulfillment request. Currently, only email is
supported.

owner
An owner is a resource person who oversees a task or a document. Use the Task
Manager: Default Task Owner profile option to set the default to a specific owner.

Glossary-13
For example, tasks can be owned by a specific employee such as Ms. Marsha Able.
This way she can oversee the work completed per task.

partner
A partner is one of two or more persons who contribute capital to establish or
maintain a commercial venture and who usually share in the risks and profits.

party
A party is a person, group, or organization and is owned by TCA. Party relates to
an employee, customer, or organization that can be related to a task.

permissions
A permission is the HTML equivalent to a responsibility.

platform
Within a resource category, there could be numerous platforms in skills
management. A resource can be rated individually for each of those platforms.
Platforms can be rated with the following: foundation, intermediate, skilled,
advanced, expert, or N/A.

PL/SQL
PL/SQL is a procedural extension of SQL that provides programming constructs
such as blocks, conditionals, and functions.

port
In TCP/IP and UDP networks, a port is an endpoint to a logical connection. The
port number identifies what type of port it is. For example, port 80 is used for HTTP
traffic.

primary user
A primary user is a designated person of an external organization, like a business
partner, who is responsible for some administrative functions on behalf of the
external organization in User Management. In the case of registration the primary
user is responsible for managing the registration and maintenance of users,
accounts, and enrollments. Primary users of different parties may have access to
different responsibilities and they may be granted different access rights.

Glossary-14
privileges
Privileges define how a user can operate a system resource on a network or a file
server. Privileges also define a right to execute a particular type of SQL statement or
to access another user's object. For example, the right to create a table or session.

problem code
Within a category in skills management, there could be numerous problem codes. A
resource can be rated individually for each of those problem codes. Problem codes
can be rated with the following: foundation, intermediate, skilled, advanced, expert,
or N/A.

process monitor
The process monitor observes the states of the internal server processes that process
the fulfillment Requests. This monitor makes sure that the correct number of
processes are allocated for performing work on the internal request queue.

product
Within a category in skills management, it is possible to have numerous products. A
resource can be rated individually for each of those products. A product can be
sub-divided into components. Products can be rated with the following: foundation,
intermediate, skilled, advanced, expert, or N/A.

profile option
A profile option is a set of changeable attributes that affect the way Oracle
applications appear and how they function.You set profile options whenever you
want the application to react in different ways for different users, depending on
specific user attributes. They can be set at the user, application, site, or responsibility
level.

prospect
A prospect is a person who is a candidate to purchase a product or service in 1-to-1
Fulfillment.

proxy server
A server that sits between a client application, such as a Web browser, and a real
server. It intercepts all requests to the real server to see if it can fulfill the requests
itself. If not, it forwards the request to the real server.

Glossary-15
public calendar
A public calendar can be used by everyone. Examples of public calendars can be
corporate holiday calendar and local holiday calendars for branch offices.

qualifiers
Qualifiers are used to define territories in Territory Management.

query
A query is a SQL statement or list created by the Administrator (or an external
other) that is used to merge specific data with a master document in Fulfillment.
Queries can be used for batch lists, mass mailings, or mail blitzes.

rank
Rank is used to specify the priority of a territory among territory random selection.
In Territory Management. It is used with number of winners.

read-only
Read-only access provides you with read-only capability. You cannot edit or delete
any information.

recurrence
Recurrence is where a task is repeatedly assigned to a user in a pre-specified time
increment such as daily, weekly, monthly, or yearly.

reference document
A reference document is a document that is linked to an escalation document. For
example, a service request (number 9229) is escalated to John Smith in an escalation
document (number 11749), then this service request (number 9229) is a reference
document.

reference
Reference is where one task relates to another document. For example, a task can be
related to a service request.

reference type
A reference type specifies whether or not a reference document is escalated or used
to provide additional information in Escalation Management.

Glossary-16
registration
Registration is the process by which any user gains some access to the application’s
functionality.

registration self-service administration UI


The registration self-service administration UI is used by System Administrators,
and at times primary users, to maintain external organization or internal group,
users, parties, and accounts in User Management.

registration self-service user UI


The registration self-service user UI is used by the primary, individual, or business
users to register themselves in User Management.

registration templates
Applications require varying pieces of information to register different types of
users in User Management. Registration templates refer to JSP files that are used to
capture the registration information that is special to a particular user type or
enrollment.

remote monitor
Its function is to monitor commands received through the fulfillment server’s
command port. This port is set in the fulfillment server start script with the flag
'-Dengine.CommandPort=#####'. Without this command port, this monitor will not
run.

repeating task
A repeating task is repeated in specified time increment such as daily, weekly,
monthly, or yearly.

request monitor
The request monitor checks the Advance Queue (AQ) for incoming fulfillment
requests and places them into an internal request queue where they can be fed into
the processes.

request owner
The request owner is the current approver based on the approver list and current
state of workflow defined for a given approval in User Management. The request
owner is only able to approve the requests which they currently own. This user

Glossary-17
should have “JTF_APPROVER” permission. The request owner is tied to the JTF_
UM_APPROVAL_OWNER profile option.

resource
A resource is the basic element of the Resource Manager and is defined as people,
places and things.

resource category
There are five types of resources defined in Resource Manager: party, employee,
partner, supplier contact, other/to be hired (TBH).

resource component
Within a product in skills management, there are numerous components. A resource
can be rated individually for each of those components. Components can be rated
with the following: foundation, intermediate, skilled, advanced, expert, or N/A.

Resource Manager
The Resource Manager is a tool used to define, access, and maintain all CRM and
ERP Resources.

resource qualifiers
Resource qualifiers are the criteria used specifically in selecting resources in
Territory Management.

resource skill category


A resource skill category is the highest level that a resource can be rated in relation
to skills management. If a resource is rated at the category level, and not rated at
any one of the product, platform, or product code levels, it does not imply the
resource is also rated at those levels. Categories can be rated with the following:
foundation, intermediate, skilled, advanced, expert, or N/A.

responsibilities
Responsibilities are groupings of application menus that determine the user
interface accessible to a particular user.

role
Roles are groupings of permissions, which are page level and function level
granular privileges used to maintain application security.

Glossary-18
role attribute
A role attribute is associated with a role. It defines the responsibility for each role in
a group or team in the Resource Manager. For example, a Telesales Agent role
represents the Member role attribute in a group, and a Sales Manager role
represents the Manager role attribute in a group.

role type
A role type is a collection of roles associated with a particular CRM module.

salesperson
A salesperson is a generic term used for any person involved in the sale or support
of products and services.

schedule monitor
The schedule monitor observes the configured activity schedule for the fulfillment
server. The fulfillment server can be configured for active and inactive scheduling
throughout a day. When it is scheduled to be inactive, the fulfillment Server enters a
sleep state until the beginning of the next activity period. This monitor only runs if
the fulfillment server has been configured with a startup time and shutdown time
in the fulfillment administration console.

self-service registration
Rather than asking an Administrator to register users manually, users can register
themselves through a self-service UI in User Management. Self-service registration
includes the UI and the background processes used to complete the registration
process. This involves assigning users the correct data and UI access privileges.

service request
A service request is a document that tracks information about a customer’s product
and service problems.

servlet
A servlet is a Java program executed on an HTTP server, rather than downloaded to
a desktop client.

shift
Shifts define a resource's availability to work in the Forms-based Calendar.

Glossary-19
shift pattern
Shift pattern is a set of shifts, such as First Shift Monday through Friday 08:00 a.m -
05:00 p.m. in the Forms-based Calendar.

skills management
Skills management provides the ability to add a new skill rating to a resource in the
Resource Manager. The resource can update and maintain their skill rating, attach a
numeric value to each skill level, and change the actual name of each skill level.

source
A source is the originator of the note. For example, if the notes are entered from a
service request application, then the source of the note is Service Request. Sources
are pre-defined.

source object
The source object is the originator of the task, note, or appointment; for example,
Sales, Service, or Contract.

Spreadtable
A spreadtable is the user interface component that contains row, columns, and
column headers set in a grid that can be embedded into an Oracle form.

SQL (structured query language)


SQL is an internationally standard language used to access data in a relational
database. The acronym is pronounced “sequel.”

SQL*Plus
SQL*Plus is an Oracle tool used to submit SQL statements to an Oracle database
server for execution. It has its own command language.

SQL script
A SQL script is a file containing SQL statements that you run with a tool such as
SQL*Plus to query or update Oracle data.

static mode
Static modes are qualifiers that are used to transfer the qualifier’s values to every
new territory no matter if it is a transaction or a resource qualifier after territory

Glossary-20
mass creation in Territory Management. Therefore, you can treat the values of the
static qualifiers as the required values for every new territory.

summary window
Summary windows contain lists of things such as all open fulfillment requests, all
available campaigns, or all output devices on a server.

supplier contact
A supplier contact is the contact information for a person or agency that sells raw
material or goods in the Resource Manager. Supplier resources can be imported as
resources from the purchasing (PO) application.

system administrator
The System Administrator is the person who manages administrative tasks in
Oracle Applications, such as registering new users and defining system printers,
using the System Administrator responsibility.

task
A task is a discrete unit of work that is assigned to one or more individuals. Tasks
are managed by the Task Manager. Tasks are often scheduled events and have
defined expirations.

task assignee
An assignee is the person that is assigned to a task, which can include the owner.
An assignee can accept, refuse, or reassign the task.

task category
A task category as a way of organizing tasks. For example, the task can be a phone
call and the category could be call back customer.

task creator
The creator is the originator of the task and defaults to the owner. However, the
owner can be modified.

task template
A task template is a skeleton or surrogate task.

Glossary-21
task group template
A task group template is a grouping of different task templates defined during
setup.

Task Manager
Task Manager is a tool used to manage tasks throughout other applications. Task
Manager provides a mechanism for tasks to be created, assigned, managed, sorted,
and prioritized to provide timely response to customer issues.

task owner
An owner is the person (resource) that creates and is responsible for the task.

task type
A task type defines the nature of the task such as a callback or a meeting.

TCP/IP (transmission control protocol / internet protocol)


A widely-used industry-standard networking protocol used for communication
among computers.

team
A team is a collection of cross-functional resources. It is organized for the purpose
of accomplishing a project in the Resource Manager. Team members are chosen for
their availability, qualifications, and location. This functionality can be defined in
the Forms version of Resource Manager only.

template
A template is an email package containing electronic brochures, newsletters, or
other customer-oriented information that an agent sends to customers in response
to a request for information in 1-to-1 Fulfillment. For example, an agent may use a
specific template that contains a thank you letter and a brochure of the company.

template handler
Template handlers refers to how the data flow built by other applications occur
among registration and how they are associated with enrollments and user types in
User Management.

Glossary-22
territory
A territory is an organizational domain with boundaries defined by attributes of
customers, products, services, and resources in Territory Management.

territory administrator
This person administers the specific and periodic duties of Territory Management.

territory assignment engine (TAE)


After territories are defined, each module can call a standard API to get a set of
qualifying employees for a transaction. The API in turn calls the TAE to determine
the qualified territories that are returned to the API, which then determines the
qualifying resources.

Territory Manager (TM)


Territory Manager is a tool that helps manages territories.

territory templates
A territory template is used to create many similar territories simultaneously. They
can be based upon territory types in Territory Management.

territory type
Territory types are used to group transaction qualifiers when creating territories. In
usage, territory types are based on the specific business need in Territory
Management. Consequently, territory types can be defined to organize the business.
Types are also able to be based on usage, such as, Marketing, Sales, and Service. A
territory type can be based also upon customer and product. Another example can
include customer type and location.

Thin Client Framework (TCF)


The Thin Client Framework server is a middle tier process that enables certain Java
components of the Oracle Applications user interface to communicate with the
middle tier and database tier.

tier
A set of machines that perform similar tasks. Client/server is a two-tier
architecture, with machines on the client tier connecting to machines on the server
tier. Internet Computing Architecture consists of three tiers. In Release 11i, machines

Glossary-23
on the desktop client tier communicate with machines on the application tier, which
in turn, communicate with each other and with machines on the database tier.

to do list
A to do list is a personal listing of things to do.

top-level territory
A top-level territory is a territory that has the "Catch All" as a parent in Territory
Management.

touch point
Touch point is an act or state of being in communication in Interaction History.

transaction qualifiers
Transaction qualifiers are the criteria used to determine the winning territory in
Territory Management.

unassisted assignment option


The unassisted assignment option is used to manually assign a resource to a
document or task of your choice without taking predefined criteria into account in
the Assignment Manager.

universal primary user approver


Create a universal primary user approver if you want to have multiple primary
users in User Management.

user
A user is any person who needs access to any application, including various types
of customers, partners, suppliers, and employees.

user ID
The User ID is a combination of a username and its password.

User Management
User Management is a tool used to registering a user and thereafter maintaining the
user in the system by granting or revoking privileges, accounts, customer profile

Glossary-24
information, and party relationships based on a set of business requirements
set-forth by the organization where the process is deployed.

username
A name that grants access to a secure environment or program, such as an Oracle
database or Oracle applications. A username is customarily associated with a
collection of privileges and data available to a particular user (responsibilities in
Oracle Applications). Every username is associated with a password.

user profile
User profiles, which are associated with responsibilities, are a set of user interfaces
that give users access to their personal data and preferences.

user type
A user type is a category of users that caters to the specific needs of an application’s
business requirements in User Management. User types allow flexible and
extensible ways for defining, categorizing and implementing behavior of users. A
user type is associated to only one template, one responsibility, zero or one approval
and zero or more roles.

web availability
Web availability is defined as a resource who has the immediate ability to attend to
a service request that is assigned online in the Resource Manager.

window to promise assignment option


The Window to Promise assignment option is used only in the Field Service
Dispatch Center to assign a resource to a specific time slot.

winning territory
A winning territory is selected from a group of territories that qualify based on
territory transaction qualifiers, number of winners, and rank information in the
Territory Manager.

work
Work is broadly defined as a collection of items presented to an agent through the
CRM E-Business application to be processed. Work items can be either a media item
or a task.

Glossary-25
workflow
Oracle Workflow automates and continuously improves business processes, routing
information of any type according to business rules you can change. Oracle
Workflow manages business processes according to rules that you define. The rules,
which we call a workflow process definition, include the activities that occur in the
process and the relationship between those activities. An activity in a process
definition can be an automated function defined by:
■ a PL/SQL stored procedure or an external function
■ a notification to a user or role that they may request a response
■ a business event
■ a subflow that itself is made up of many activities.

workflow attributes
Workflow attributes control the behavior of the workflow.

workflow monitor
The workflow monitor is a Java based tool used for administering and viewing
workflow process.

Glossary-26

You might also like