This chapter provides an overview of the business object (BO) search and quick create definition process and discusses how to define BO searches and quick create pages.
This section lists common elements and discusses:
BO search runtime process.
Quick create runtime process.
BO search and quick create setup process.
Search fields are common objects that are used in BO search and quick create definitions. A field definition specifies the location of the field in the database, how the system searches for the field, the label of the field on the user interface, and how the field is updated by quick create. Fields are used in the following BO search and quick create elements:
|
|
A quick create template associates the fields that are entered with the business object roles that are updated when a user creates a business object using quick create. The criteria definition specifies the search criteria page on which quick create definitions that this template is associated with appear. |
|
A quick create definition is composed of one or more templates that appear to the user when the quick create definition is invoked. You can use the same quick create template in more than one definition. |
|
A search role definition associates field definitions to one or more role type. When user search for a field, only business objects that have a role that is associated with the field are returned in the search results. Search roles are used in search definitions. |
|
A search definition is a collection of search roles and quick create definitions. Search definitions specify the roles and fields that are searched for data that a user enters. If you specify a quick create definition on the search definition, then the quick create definition is enabled on the search results page. You use search definitions in search criteria. |
|
Search criteria specify the search definitions that are invoked when the user enters data in certain fields on a component. You can specify a default search definition and up to four alternate definitions. You then select fields and associate each field with one or more search definitions. If you do not select a search definition for the field, then the default search definition is used. You associate criteria definitions with adapter sections. |
|
The adapter specifies the BO search definitions and quick create definitions that are enabled for a particular component or transaction. The adapter also defines the fields that appear in basic search mode, the search criteria to invoke for these fields, and the subpages of the component upon which these fields appear. Adapter sections are embedded into CRM applications. |
PeopleSoft Enterprise Customer Relationship Management (PeopleSoft Enterprise CRM) provides the capability for users to search for business objects that they need to reference on transactions or components. When users don't know the exact name of the business object to reference, they can initiate a BO search to find the business object based on any information that they might know. The system determines the information that it requires to locate the BO and presents a search page for the user to enter known information.
The customer identification framework also uses BO search technology without the user having to explicitly initiate a search.
When a user searches for an object that does not already exist in the system, some PeopleSoft Enterprise CRM transactions provide quick create functionality that enables the user to create that object with a minimum set of data. For example, when a contact calls for service on behalf of a company, the customer service representative (CSR) verifies the contact's information by doing a BO search for the contact. If the contact is not found in the database, the CSR can create a contact immediately and associate it to the company.
BO search and quick create functions are tightly integrated with each other, and they use much of the same system data.
See Also
Understanding the Business Object Search and Quick Create Process
Identifying Customers for Transactions
This is the BO search and quick create setup process:
Define search fields.
Define quick create templates.
Enter a quick create definition.
Define search roles.
Enter a search definition.
Define search criteria.
Define the BO search and quick create adapter.
Note. Setting up BO search and quick create definitions requires a good understanding of roles and relationships in the system.
See Also
Business Object Relationship Modelling
PeopleSoft Enterprise CRM delivers a robust set of predefined system data that meets most business requirements. Search the delivered definitions before attempting to modify or add new business object search or quick create definitions. To search the delivered definitions, access the setup component for that definition and run a search without entering search criteria. A list of all defined items appears.
Important! PeopleSoft does not support changes that you make to the search definitions delivered with PeopleSoft Enterprise CRM. Implementation of any new search definitions that you create requires a coding effort, which is also not supported by PeopleSoft.
See Also
Working with Predefined Business Object Search and Quick Create Data
This section discusses how to:
Define fields.
Define roles for a field.
Define quick create templates.
Define relationships for a template.
Set up quick create definitions.
Associate search fields with a role type.
Define BO searches.
Define search criteria fields.
Specify basic search criteria fields.
Define fields for transaction subpages.
Page Name |
Definition Name |
Navigation |
Usage |
RBQ_FLDDFN |
Set Up CRM, Common Definitions, Customer, BO Search, Field, Field |
Define a field that is used in BO Search and quick create definitions. |
|
RBQ_FLDDFN_RL |
Set Up CRM, Common Definitions, Customer, BO Search, Field, Role |
View the roles that use the field definition. Each role that uses the field definition can override certain information that is defined for the field. |
|
RBQ_FLDDFN_REC |
Set Up CRM, Common Definitions, Customer, BO Search, Field, Search Record |
Specify characteristics of the record that is searched. |
|
RBQ_QCTMPL |
Set Up CRM, Common Definitions, Customer, BO Search, Quick Create Template, Template |
Define a quick create template. This defines the business object roles that appear on the Quick Create page when quick create is initiated from a specific component. |
|
RBQ_QCTMPL_REL |
Set Up CRM, Common Definitions, Customer, BO Search, Quick Create Template, Relationships |
Define the relationships between the roles defined on the quick create template. |
|
RBQ_QCDFN |
Set Up CRM, Common Definitions, Customer, BO Search, Quick Create, Quick Create |
Set up a quick create definition and associate one or more quick create templates to it. |
|
RBQ_SRCHRL |
Set Up CRM, Common Definitions, Customer, BO Search, Search Role, Search Role |
Associate search fields with a role type. |
|
RBQ_SRCHDFN |
Set Up CRM, Common Definitions, Customer, BO Search, Search, Search |
Define a BO search with one or more search roles, search fields, and related BOs. |
|
RBQ_CRITDFN |
Set Up CRM, Common Definitions, Customer, BO Search, Criteria, Criteria |
Specify the advanced search criteria fields and advanced search definition. |
|
RBQ_ADPTR |
Set Up CRM, Common Definitions, Customer, BO Search, Adapter, Adapter |
Specify the basic search criteria fields. |
|
RBQ_ADPTR_SECT |
Set Up CRM, Common Definitions, Customer, BO Search, Adapter, Sections |
Define the records and fields that appear on transaction subpages. |
|
RBQ_ADPTR_LBL |
Set Up CRM, Common Definitions, Customer, BO Search, Adapter, Labels |
Define labels. |
Access the Field page (Set Up CRM, Common Definitions, Customer, BO Search, Field, Field).
The purpose of a field definition is to ensure that the same value in propagated across different BO search and Quick Create definitions. Iif the field is constrained by role type, the value is propagated across only the definitions for this role type. For example, the value that is entered on a transaction is propagated to the search criteria then to the Quick Create template. Field definitions are referenced either directly or indirectly in all BO Search and Quick Create definitions.
A field definition specifies:
The location of the field in the database.
How the system searches for the field.
The label of the field on the user interface.
How Quick Create updates the field.
General Options
The system uses the values you enter in this region to format the BO search and Quick Create pages for the field, to process values that are entered for the field, and to compare entries against the database for duplicates.
Display Options
The entries in this page region control how the field appears on pages at runtime.
Display Field |
Enter the name of the field that is used to display the values at runtime. |
Lookup Record |
Enter the record from which the system retrieves the values to populate a drop-down list. |
Lookup Field |
Enter the field from which the system retrieves the values to populate a drop-down list. |
Use Translate Values |
Select to have the system use a translate table to obtain the field value that appears at runtime. |
Display as Checkbox |
Indicate that this field appears as a check box for display and entry. The Y and N values in the field are translated at runtime into the appropriate check box property (selected or not selected). |
Search Operators
Select the default search operator and the search operators that are visible to the user when this field is searched.
Select the quick create field name(s) to which the field maps. If the field is entered as search criteria, and the search is unsuccessful, then system pre-populates the quick create field with the value that was entered as a search field.
Access the Role page (Set Up CRM, Common Definitions, Customer, BO Search, Field, Role).
Use this page to indicate different role options for search fields. If the field is used by different role types, you can specify a different label to appear next to the field for each different role type. You can also specify a different property that is set for each role. The specifications you make on this page override the ones that you made on the Field page.
Role Type |
Select a role type that is valid for this field. The system uses the role type to identify objects for which the field can be used as search criteria. |
Property Name |
Select a property name for this role. Quick create updates the property with the value that users enter in the corresponding field when they create a new business object using quick create functionality. |
Access the Search Record page (Set Up CRM, Common Definitions, Customer, BO Search, Field, Search Record).
This page enables you to define how searches for role-specific fields are performed.
Role Type |
Enter the role type to which the search options apply. If no role type is entered, the options on this line apply to all role types. |
Search Record |
Enter the name of the database record where BO Search looks for the field to display. |
Search By Role |
Select search only views that contain both the BO_ID (business object identifier) and ROLE_TYPE_ID (role type identifier) fields. |
Search By Rel (Search By Relationship) |
Select to search only views that contain both a BO_ID_1 and BO_ID_2 field. |
Bypass Status |
Select to search all values of the contact information. If this check box is not selected, only the current values for all fields in the contact record are searched. |
Access the Template page (Set Up CRM, Common Definitions, Customer, BO Search, Quick Create Template, Template).
Quick Create templates associates the fields that are entered on Quick Create pages with the role and relationship types that are updated in the database when the user creates a new business object.
Market |
Select the market for which this template is enabled. |
Select the role type for which you want to enable this quick create template. |
|
Label |
Enter the label that appears for this role type on the quick create page. |
Select the criteria definition that is invoked when searching for existing business objects from the Quick Create page. In the example page shot, when the user quick creates a Company with Contact, the The Company search definition is invoked to ensure that the company being created does not already exist. |
|
Select to include contact information for entry on the Quick Create page. |
|
Select have the purchasing options appear on the Quick Create page. |
|
Mapping Reference |
Enter the name that is used by the adapter to refer to the field in the component buffer. |
Apply Controlling BO |
Select to have the system search for existing values of the role type only within logically related values for the parent business object. For example, if a company has multiple contacts, the system searches for contacts of the company only, regardless of whether other contacts with the search criteria exist. |
Select one or more field definitions to include on the quick create template.
See Also
Maintaining Contact Information for Business Objects
Defining Purchasing Options for Companies, Consumers, and Sites
Access the Relationships page (Set Up CRM, Common Definitions, Customer, BO Search, Quick Create Template, Relationships).
Note. Defining template relationships is optional. Define relationships between roles only if you include more than one role on a template.
Role and Relationship Selection
This page region enables you to specify the relationships that are built between the roles that are defined on a quick create template.
Select the relationship type between the two selected roles. |
Access the Quick Create page (Set Up CRM, Common Definitions, Customer, BO Search, Quick Create, Quick Create).
Select one or more templates to associate with the definition. |
Primary |
Select to indicate that the template is the primary, or controlling, template used by the quick create definitions. Primary templates appear first on the runtime Quick Create page. |
Access the Search Role page (Set Up CRM, Common Definitions, Customer, BO Search, Search Role, Search Role).
A search role definition associates field definitions to one or more role types. When the user searches for a field, only business objects with a role that is associated with the search role definition are returned in the search results. Each search role definition is associated with a SQL engine and generates a single driver SQL statement and multiple list field SQL statements.
Search role definitions also specify how the search is conducted: security options, relationships to search, how the results are filtered, and the quick create template that is used to create new objects for the role.
General Options
Enter information that describes the role and how it appears.
Used in Search Definitions
A list of all search definitions that use the role appears here.
Add fields that the role can search.
Related BO |
Select if the field is a field of a related BO. For example, for the Contact search role, you can check the Company Name field as a related BO because the field belongs to the company record and not the contact record. |
Search |
Select to use this field as a search criterion. |
Result |
Select for this field to appear in the search results. |
Additional Search Role Options
Access the Field Selection - Additional page.
Use this page to override search views defined on the Field Definition - Role page.
Access the Search page (Set Up CRM, Common Definitions, Customer, BO Search, Search, Search).
Select to group the search results by role. For example, the Company, Site, and Alternate Capacity roles are grouped in the Organization group and the Consumer, Contact of Company, Contact of Consumer, Worker roles are grouped in the Individual group. Note. The appearance of this page changes when you select this check box. Two additional page regions, Search Definition Group and Field Selection appear. |
Control Type |
Indicate if the role group is Controlling, Independent, or Dependent. Results appear with the controlling role first, followed by all dependent group records that are associated with the controlling group. For example, this enables users to display organizations first, then all the individuals that are associated with the organization. You can only have oneControlling group. |
Result Display Type |
Indicate whether the results appear in one column or two column format. |
Select Multiple |
Select to enable the user to choose multiple records from the result set. |
Quick Create |
Select the quick create definition to associate with the role. |
Role Definition
Select one or more roles for the search definition, define their appearance in results, and associate them with quick create definitions.
Role Definition |
Select one or more search roles to associate with the search definition. |
This page region appears when you select Enable Role Groups. If you associate more than one role definition to a search, then you must enter field definitions. This is necessary because two or more roles can use the same field definition. You must indicate to which role the field pertains.
Field Definition |
Select the name of the field definition. |
Role Type |
Select the role type to associate with the field definition. When the system displays results of the BO search, if role groups are enabled, the field appears only in the role group for the role type with which it is associated. |
Related BO |
Select to indicate that the field in defined on a related BO, not the primary BO that is the target of the search definition. |
Access the Criteria page (Set Up CRM, Common Definitions, Customer, BO Search, Criteria, Criteria).
This page captures information about the search definitions to invoke when the user enters certain fields.
Description |
Enter the name for the group of criteria that you specify. This name is used to link the criteria to an adapter section. |
Search Definition |
Enter the default search definition. The definition is used by default when the user searches for a field |
Search Definition 1, Search Definition 2, Search Definition 3, Search Definition 4 and Search Definition 5 |
Enter alternate search definitions. These search definitions appear at runtime. The user can search by the default definition or select an alternate. |
Enable Search Filter |
Select to have only the search fields that are associated with the selected search definition appear at runtime. |
Show Search Operators |
Select to have the search operators appear on the BO Search page at runtime. |
Use this page region to select fields for a search criteria definition, specify the roles for which the field appears, and select the search definitions for which the field is enabled.
Role Type ID |
Select the role to which the field applies, in the case where a field is shared by different roles. For example, if the Name field is shared between the Company and Site roles. To have it appear once as Company Name and once as Site Name, you need to select the Name field twice and associate one to the Company role and one to the Site role. |
Enable Search 1, Enable Search 2, Enable Search 3, Enable Search 4 and Enable Search 5 |
Select to enable the corresponding search definition for the field. For example, if you enable Search 1 and Search 3 for a field, then these search definitions appear in a drop down list at runtime. The user can select a search definition or search by the default definition. |
Note. If you select a field for multiple roles, at runtime the field appears once in the search criteria for each role selected. You can specify different field labels for each role to differentiate between multiple occurrences.
Access the Adapter page (Set Up CRM, Common Definitions, Customer, BO Search, Adapter, Adapter).
Component Name |
Specify the component to which this adapter definition pertains. |
Market |
Select the market to which this adapter definition pertains. |
Mapping Reference |
Enter a reference that is used to switch adapters if more than one adapter is needed for a component. This might occur if the same field is used by more than one role. |
Create Option |
The Create Option is used to hold an authorization code that determines which users can use quick create. |
Application Class ID |
Select the application class where subpages defined by the adapter are defined. |
Toolbar ID |
Select the name of the component toolbar where the names of the business objects that are retrieved by BO Search appear. A component toolbar is used to display common information across all pages in the component. |
Config Search Applicable (configurable search applicable) |
Select to enable configurable search pages for the component to invoke this search definition. |
Trace SQL Statement |
Select to have the system write the SQL statements that are executed by the search at runtime to a trace log. |
Extension Selection
Extension Event |
Select a method from the list that appears. This list contains the methods of the selected application class. You can use these to write custom code. |
Section Record Name |
Enter the section to which this extension applies. The list of available sections is taken from the sections that you defined on the Sections page. |
Access the Sections page (Set Up CRM, Common Definitions, Customer, BO Search, Adapter, Sections).
Note. Before you configure the transaction adapter for fields, make sure that you have an extensive understanding of system data and transactions.
Section Record |
The name of the record that is used as the subpage on the transaction. |
Criteria |
Select the criteria definition that is used by this section. |
Section Type |
Select from One Column, Two Column, Hidden, or Custom. If you need to identify a customer in a grid, then specify Custom. Custom sections are used in configurable search pages; other section types are used for customer identification on component and transaction pages. |
Page Name |
Select the page name that can contain this adapter section. This provides the flexibility to define sections with differing section options, for example, security, in the same adapter. |
Enable Search Button |
Select to have a Search button appear on the sub page at runtime. |
Field |
Enter the name of the field to appear on the transaction. |
BO Assigned |
Select to indicate that this field is associated to a primary BO on this section. |
Section Control |
Select to have the field label as defined for this section take precedence over label definitions for the same field as defined for any other section or role. This ensures consistency of the user interface. |
Criteria |
Select to use a value that is identified for the field as a criteria for additional searches. For example, when a company is identified at runtime, a prompt button with a search for contact appears. When the user clicks the prompt, the system invokes the search definition thatis entered in this field. |
Mapping Reference |
Enter the logical name of the field on the transaction’s component buffer. |
The entries in this page region control how the section appears to the user at runtime. Different fields appear depending on the Section Type you select.
Search by Role |
Select to have the search results displayed by role. |
Required Flag |
Select to require that the user enter search criteria in the section's fields. This field appears only if you select aSection Type of Custom. |
The following fields appear only if the Section Type is not Custom.
Display Option |
Select the functional option that controls security on this field. This is used in conjunction with display templates. |
Initialized Display |
Select how the field appears when the user first accesses the component. The options in this list control if the field is enterable and if the user can look up field values. For example, the Company Name field on the Case component is enterable but not required. |
Identified Display |
Select how the field appears when a value is found for the field. For example, if the company name is found, the name appears as a link to the Company component. |
Initialized Label |
Enter the text for the field label when the user first accesses the component. For example, Enter a Company Name. |
Identified Label |
Enter the text of the field label that appears when the user first accesses the component. For example, Company Name. |
Security Options
The fields in this page region are used to define security for Partner Relationship Management. To complete the security setup, you must have a relationship established between the two business objects.
Primary Object |
Enter the object that is used as a prompt table for the section. For example, to validate field entries on Partner objects, select the Partner value. |
Related Object |
Enter the object that is related to the primary object. For example, when building a partner-customer relationship, the related object is Customer. |
Related Section |
Enter the adapter section name that is used to identify the value in the Related Object field. |
Search Option |
Select the option that determines whether to restrict all or selected users from viewing search results or secured search result. If you leave this field blank, then all users will be able to view only the related search results, for example, only the partners that are associated with a selected customer. If this field is populated, then users whose code matches the search option will be able to view all results (not restricted). |
Role Definition Selection
Select the role and relationship to be secured for the section and check the Apply Security check box. If no security is required then leave the check box empty. If both Customer and Partner fields require restricted views, then the check box must be selected on both sections.
This page region works in conjunction with the Security Options region, in this way:
The primary and related search objects define the relationship between the two adapter sections and the search options define the authorization code that determines which users are restricted. The Apply Security check box determines to which roles and relationships of the two objects security is applied.
Access the Labels page (Set Up CRM, Common Definitions, Customer, BO Search, Adapter, Labels).
Use this page to specify the labels that appear on BO search and quick create pages that are initiated from a transaction subpage. This ensures consistency between labels for fields on customer identification subpages, advanced BO Search pages, and Quick Create pages.
Role Type |
Select the role type to which this label applies. If not selected, the label override applies to all roles. |