Browser version scriptSkip Headers

Oracle® Fusion Applications CRM Extensibility Guide
11g Release 7 (11.1.7)
Part Number E20388-06
Go to Documentation Home
Home
Go to contents  page
Contents
Book<br />List
Book
List
Go to Feedback page
Contact
Us

Go to previous page
Previous
Go to previous page
Next
PDF

11 Oracle Fusion Customer Center Extensibility

This chapter contains the following:

Oracle Fusion Customer Center Extensibility : Overview

Customizing Oracle Fusion Customer Center Pages : Explained

Customizing Customer Center and Work Area Using Page Composer : Explained

Customizing Oracle Fusion Customer Center Using Page Composer : Worked Example

Extending Simplified Pages for Customers : Explained

Oracle Fusion Customer Center Extensibility : Overview

Read this chapter to learn about how to extend objects and pages that belong to Oracle Fusion Customer Center. In this chapter, you will learn about:

Customizing Oracle Fusion Customer Center Pages : Explained

You can customize a variety of pages and regions in Oracle Fusion Customer Center using the Oracle Fusion CRM Application Composer. Application Composer lets you create custom fields and objects, which you then add for display in the run time Customer Center application. To access Application Composer, select Application Composer from the Navigator menu, under the Tools category.

Customizing Oracle Fusion Customer Center Pages Using Application Composer

In general, every top-level CRM object has a work area, which includes an overview page, a creation page, and a details page. When you make changes to the object, those changes can be reflected in the object's associated work area. Customer Center, however, is unique in that its user interface pages do not include the traditional work area combination of overview page, creation page, and details page. Instead, Customer Center has a series of tree nodes that, when selected, display user interface pages, and even a single page can be associated with multiple business objects.

This table lists Customer Center pages, and the related objects that you can access in Application Composer to customize those pages.


Customer Center Page

Customer Center Region

Application

Underlying Business Object

Consumer Profile

Addresses region

Common

Trading Community Address

Consumer Profile

Consumer Basic Information region

Common

Trading Community Person Profile

Consumer Profile

Consumer Details region

Common

Trading Community Person Profile

Consumer Profile

Sales Account region

Customer Center

Sales Account

Contact Profile

Address region

Common

Trading Community Address

Contact Profile

Basic Information region

Common

Trading Community Org Contact

Contact Profile

Contact Details region

Common

Trading Community Org Contact

Contact Profile

Contacts region (also known as the Contacts List)

Common

Trading Community Org Contact

Create Consumer page and also the Quick Create Consumer page

New fields are added at the bottom of the page

Customer Center

Sales Account

Create Consumer page and also the Quick Create Consumer page

No specific region

Common

Trading Community Person Profile

Create Contact page and also the Quick Create Contact page

No specific region

Common

Trading Community Org Contact

Create Customer page and also the Quick Create Customer page

Contact Information region

Common

Trading Community Org Contact

Create Customer page and also the Quick Create Customer page

Customer Information region

Common

Trading Community Org Profile

Create Customer page and also the Quick Create Customer page

New fields are added at the bottom of the page.

Customer Center

Sales Account

Customer Profile

Addresses region

Common

Trading Community Address

Customer Profile

Basic Information region

Common

Trading Community Org Profile

Customer Profile

Customer Details region

Common

Trading Community Org Profile

Customer Profile

Sales Account region

Customer Center

Sales Account

Edit Customer page

Team Members region

Customer Center

Sales Account Resource (child object to the Sales Account)

Overview > Summary tab

Sales Accounts region (also known as the Sales Account List)

Customer Center

Sales Account

Real-Time Search: Customers page

Search region, by way of Advanced Search > Add Fields

Customer Center

Sales Account

Note

To make only minor user interface changes to Customer Center pages without creating objects or fields, use Page Composer instead of Application Composer.

Oracle Fusion Common CRM Objects

The Oracle Fusion Common CRM objects that are associated with Customer Center pages are:

This table indicates which Common objects populate which Customer Center pages and regions, as well as Application Composer configuration pages where you can make user interface changes on those pages and regions.


Business Object

Configuration Page in Application Composer

Related Customer Center Page

Related Customer Center Region

Trading Community Org Profile

Edit Customer Quick Creation Form

Create Customer page and also the Quick Create Customer page

Customer Information region

Trading Community Org Profile

Edit Read Only Form

Customer Profile

Basic Information region

Trading Community Org Profile

Edit Details Form

Customer Profile

Customer Details region

Trading Community Person Profile

Edit Contact/Consumer Quick Creation Form

Create Consumer page and also the Quick Create Consumer page

No specific region

Trading Community Person Profile

Edit Read Only Form

Consumer Profile

Consumer Basic Information region

Trading Community Person Profile

Edit Details Form

Consumer Profile

Consumer Details region

Trading Community Address

Edit Detail Form

Customer Profile

Addresses region

Trading Community Address

Edit Detail Form

Contact Profile

Addresses region

Trading Community Address

Edit Detail Form

Consumer Profile

Addresses region

Trading Community Org Contact

Edit Creation Form

Create Customer page and also the Quick Create Customer page

Contact Information region

Trading Community Org Contact

Edit Creation Form

Create Contact page and also the Quick Create Contact page

No specific region

Trading Community Org Contact

Edit Read Only Form

Contact Profile

Basic Information region

Trading Community Org Contact

Edit Contact Details Form

Contact Profile

Contact Details region

Trading Community Org Contact

Edit Summary Table

Contact Profile

Contacts region (also known as the Contacts List)

Oracle Fusion Customer Center Objects

The Oracle Fusion Customer Center objects that are associated with Customer Center pages are:

This table indicates which Customer Center objects populate which Customer Center pages and regions, as well as Application Composer configuration pages where you can make user interface changes on those pages and regions.


Business Object

Configuration Page in Application Composer

Related Customer Center Page

Related Customer Center Region

Sales Account

Edit Creation Form

Create Customer page and also the Quick Create Customer page

New fields are added at the bottom of the page.

Sales Account

Edit Creation Form

Create Consumer page and also the Quick Create Consumer page

New fields are added at the bottom of the page.

Sales Account

Edit Details Form

Customer Profile

Sales Account region

Sales Account

Edit Details Form

Consumer Profile

Sales Account region

Sales Account

Edit Summary Table

Overview, then Summary tab

Sales Accounts region (also known as the Sales Account List)

Sales Account

Not applicable. Custom fields are automatically available from the list of additional fields.

Real-Time Search: Customers page

Search region, by way of Advanced Search, then Add Fields

Sales Account

Edit Regional Panes

Customer Work Area

Panes in the regional area

Sales Account Resource (child object to the Sales Account)

Edit Summary Table

Edit Customer: Sales Account Team page

Team Members region

Using the Pages Overview Page

To add custom fields to the Customer Center pages listed in the tables above, use Application Composer's various configuration pages. You access the configuration pages in Application Composer from each object's Pages Overview page. Before you access the configuration pages, you must have already created your custom fields using Application Composer.

To access the Pages Overview page:

  1. Select either the Common or Customer Center application on the main Overview page.

  2. In the object tree, select the object you want to customize.

  3. Select the Pages node.

  4. On the Pages Overview page, select the configuration page hyperlink related to the Customer Center page that you want to customize.

Adding Custom Reports Using Page Composer

The customizations that you can make in Customer Center also include the creation of reports. This type of customization does not involve the creation of fields or objects within Application Composer. Instead, create a report using BI Answers, save the report to the Resource Catalog, and then use Page Composer to add the report to two pages: the Customer Snapshot and the Customer Overview, Analysis tab.

Note

The reports that you add to the Customer Snapshot are within the context of a single customer, because you view a single customer when viewing the Snapshot. The reports that you add to the Analysis tab on the Customer Overview provide context across multiple customers, because you are viewing multiple customers on the Analysis tab.

Customizing Customer Center and Work Area Using Page Composer : Explained

To customize the Customers work area and Oracle Fusion Customer Center pages, use the following steps:

.

  1. Navigate to the Customers work area.

  2. Click the Administration global menu.

  3. Select Customize Workarea Pages.

Note

To access Page Composer in Customer Center pages, you must have the Sales Administrator job role.

In the Customers work area and pages, you can perform customizations for the enabled components in the following modes:

Customization Tasks in Design Mode

In the Customers work area and pages, in Design mode for enabled components on the Site and Job Role layers, you can perform the following customization tasks:

Customization Tasks in Direct Selection mode

In Direct Selection mode for enabled components, you can perform the following customization tasks:

Adding Custom Reports

The customizations that you can make in Customer Center also include the creation of reports. Create a report using BI Answers, save the report to the Resource Catalog, and then use Page Composer to add the report to two pages: the Customer Snapshot and the Customer Overview, Analysis tab.

Note

The reports that you add to the Customer Snapshot are within the context of a single customer, because you view a single customer when viewing the Snapshot. The reports that you add to the Analysis tab on the Customer Overview provide context across multiple customers, because you are viewing multiple customers on the Analysis tab.

Customizing Oracle Fusion Customer Center Using Page Composer : Worked Example

This example demonstrates a set of use cases for customizing Oracle Fusion Customer Center.

This example covers the following scenarios:

Making a Form Field Read-only for a Specific Role

In the Customer Profile page, Customer Details region, make the customer Name field read-only for users with the Sales Representative job role.

  1. Sign in with the Sales Administrator job role.
  2. Navigate to the Customers work area.
  3. Drill down to the Edit Customer <Customer Name> Profile page for any customer.

    Important

    Before making changes using Page Composer, confirm that you are working in the correct sandbox. If not, create a sandbox before making your changes.

  4. In the Customize Customers Pages dialog box, select the Job Role layer.
  5. Choose Sales Representative from the list.
  6. Click OK.

    Page Composer opens in design mode.

  7. Click Select.

    The Direct Selection mode opens.

  8. Mouse-over the Name field in the Customer Details region.

    The field is outlined automatically with a light blue border.

  9. Click the Name field.

    The Edit property panel opens.

  10. Click Edit Component.

    The Component Properties: Name dialog box opens.

  11. Select Read-Only.
  12. Click OK and validate your changes:
  13. Verify your changes:
  14. Click Close.
    1. Sign out of Oracle Applications.

    2. Sign in to Oracle Applications as a sales representative.

    3. Navigate to the Customers page and confirm your changes.

  15. When you are ready to commit your customizations to the back end, publish your sandbox according to your organization's established practices.

Hiding a Table Column for All Users Using Design Mode

Hide the Sales Account Owner column in the Sales Account Search Results table in the Customers Summary page.

  1. Sign in with the Sales Administrator job role.
  2. Navigate to the Customers work area.

    The Overview, Summary Page and the Sales Account Search region opens.

    Important

    Before making changes using Page Composer, confirm that you are working in the correct sandbox. If not, create a sandbox before making your changes.

  3. Click Administration.
  4. In the Customize Customers Pages dialog box, select the Site layer and click OK.

    The page opens in Page Composer design mode.

  5. To uncheck and hide this column for all users, click the table View menu and select Columns Sales Account Owner.

    The Sales Account Owner column no longer appears in the Sales Account Search Results table.

    Note

    Individual users can optionally use the View menu to display this column for themselves through personalization.

  6. Validate your changes:
    1. Click Closeto sign out of the Page Composer.

    2. Sign out of Oracle Applications.

    3. Sign in to Oracle Applications with any job role.

    4. Navigate to the Customers Summary page.

    5. Confirm you changes.

    The Sales Account Owner column no longer appears in the Sales Account Search Results table.

  7. When you are ready to commit your customizations to the back end, publish your sandbox according to your organization's established practices.
  8. Follow the same process to display a column that is hidden by default.

Removing a Table Column from the View Menu for All Users Using Direct Selection Mode

Remove the Registry ID column from the Sales Account Search Results table.

  1. Sign in with the Sales Administrator job role.
  2. Navigate to the Customers work area.

    The Overview, Summary Page and the Sales Account Search region appear.

    Important

    Before making changes using Page Composer, confirm that you are working in the correct sandbox. If not, create a sandbox before making your changes.

  3. Click Administration.
  4. In the Customize Customers Pages dialog box, select the Site layer.
  5. Click OK.

    The page opens in the Page Composer Design mode.

  6. Click Selectto enter the Direct Selection mode.
  7. Mouse-over the Registry ID column header in the Sales Account Search Results table and click the column header.

    The column header is outlined automatically with a dark blue border and a window opens.

  8. Click Edit Parent Component.

    The table column parent component properties dialog box opens with options to hide and reorder the table columns.

  9. Click to uncheck the Registry ID.

    The item is removed from the table View menu and from the table.

    The following figure shows the Component Properties page.

    This figure shows the Component Properties page.

    The Registry ID column no longer appears in the Sales Account Search Results table or in the View menu.

    The following figure shows the Table View Menu without the Registry column.

    This figure shows the Table View Menu without the Registry
column.

    The Registry column is no longer available at run time. Users without access to Page Composer cannot restore the removed column to the View menu.

  10. Verify your changes:
    1. Click Closeto sign out of Page Composer.

    2. Sign out of Oracle Applications.

    3. Sign in to Oracle Applications with any job role.

    4. Navigate to the Customers Summary page.

    5. Confirm that the Registry ID column no longer appears in the View menu.

  11. When you are ready to commit your customizations to the back end, publish your sandbox according to your organization's established practices.

Changing the Column Label for All Users in Direct Selection Mode

Change the label text for the Sell-to Address column in the Sales Account Search Results table in the Customers Summary page.

  1. Sign in with the Sales Administrator job role.
  2. Navigate to the Customers work area.

    The Overview, Summary Page and the Sales Account Search region appear.

    Important

    Before making changes using Page Composer, confirm that you are working in the correct sandbox. If not, create a sandbox before making your changes.

  3. Click the Administration global menu.
  4. In the Customize Customers Pages dialog box, select the Site layer.
  5. Click OK.

    The page opens in the Page Composer Design mode.

  6. Click Select to toggle Page Composer to Direct Selection mode.
  7. Mouse-over the Sell-to Address column header in the Sales Account Search Results table and click the column header.

    The column header is automatically outlined with a blue border.

    The following figure shows the Sell-to Address link.

    This figure shows the Sell-to Address Link.

  8. Click Edit Component.

    The following figure shows the Edit Component link.

    This figure shows the Edit Component link.

  9. In the Component Properties dialog list, you can edit the column label with the Header Text field. The column label comes from a message bundle by default. The bundle name is listed below the Header Text field. To change the label, you can use the following option: Select Text Resource. You can use this option to search for or create a new resource bundle entry. This is the production approach so that the text can be translated.
  10. Click the downward arrow to the right of the Header Text field.
  11. Click Override.

    The following figure shows the Override Menu item in the Change Property tab.

    This figure shows the Override Menu item in the Change
Property tab.

    The blue dot to the right of the text field indicates that a value has been changed.

  12. To enter the new label value, click the downward arrow to the right of the Header Text field again.
  13. Click Expression Builder.
  14. Enter the new value Address into the entry field on the Expression Builder Edit dialog box.
  15. Click OK in the caption expression window.
  16. Click OK in the Column Properties window.

    The table should now appear with the updated Address column label.

  17. Verify your changes:
    1. Click Close to sign out of Page Composer.

    2. Sign out of Oracle Applications.

    3. Sign in to Oracle Applications with any job role.

    4. Navigate to the Customers Summary page.

    5. Confirm that the column is now labeled "Address".

  18. When you are ready to commit your customizations to the back end, publish your sandbox according to your organization's established practices.

    Tip

    You can use the Reset option to restore the Header Text to the delivered message bundle string.

Changing the Column Width for All Users in Direct Selection Mode

In the Sales Account Search Results table, Customers Summary page, change the width of the Named Sales Account column to 120.

  1. Sign in with the Sales Administrator job role.
  2. Navigate to the Customers work area.

    The Overview, Summary Page and the Sales Account Search region appear.

    Important

    Before making changes using Page Composer, confirm that you are working in the correct sandbox. If not, create a sandbox before making your changes.

  3. Click Administration.
  4. In the Customize Customers Pages dialog box, select the Site layer.
  5. Click OK.

    The page opens in the Page Composer Design mode.

  6. Click Select to toggle Page Composer to Direct Selection mode.
  7. Mouse-over the Named Sales Account column header in the Sales Account Search Results table and click the column header.

    The column header is outlined automatically with a blue border.

  8. Click Edit Component.
  9. In the Component Properties dialog list, change the Width field to 120.

    The following figure shows the Change Property tab in the Component Properties page.

    This figure shows the Change Property tab in the Component
Properties page.

  10. Click OK on the caption expression window.
  11. Click OK on the Column Properties window.

    The table should now display with a wider Named Sales Account column.

  12. Verify your changes:
    1. Click Closeto sign out of Page Composer.

    2. Sign out of Oracle Applications.

    3. Sign in to Oracle Applications with any job role.

    4. Navigate to the Customers Summary page.

    5. Confirm the width of the Named Sales Account column.

  13. When you are ready to commit your customizations to the back end, publish your sandbox according to your organization's established practices.

Customizing Customer Center Tree Nodes

Make the Customer Snapshot page the default node in Customer Center for users with the Sales Representative job role.

  1. Sign in with the Sales Administrator job role.
  2. Navigate to the Customers work area.

    The Overview, Summary page appears.

    Important

    Before making changes using Page Composer, confirm that you are working in the correct sandbox. If not, create a sandbox before making your changes.

  3. Search for any customer record in the Sales Account Search region.
  4. In the search results table, drill into the customer record.

    The Edit Customer <Customer Name> Profile page appears by default.

    In the following figure the Profile node is selected and highlighted in the Customer Center Tree.

    In this figure the Profile node is selected and highlighted
in the Customer Center Tree.

  5. Click Administration.
  6. In the Customize Customers Pages dialog box, select Editfor the Job Role layer.
  7. Select Value, Sales Manager.
  8. Click OK.

    The page opens in the Page Composer Design mode.

  9. In the Customer Center pane, select Actions - Manage Customer Tree.

    The following figure shows the Edit Customer page with the Manage Customer Tree item selected in the Customer Center pane.

    This figure shows the Edit Customer page with the Manage
Customer Tree item selected in the Customer Center pane.

    The Manage Customer Tree dialog box appears.

  10. To change the default display to the Snapshot page, click the Snapshot row in the Tree Nodes table to set it as the default.
  11. Click Save.

    Tip

    In the Manage Customer Tree dialog box, you can show or hide the nodes. In the View menu, you can expand and collapse the top level nodes.

    The following figure shows the Manage Customer Tree Dialog box.

    This figure shows the Manage Customer Tree Dialog box.

  12. Alternatively, you can set the node to appear by default in two additional ways:

    The following figure shows the Set as Default menu item in the Actions menu.

    This figure shows the Set as Default menu item in the
Actions menu.

  13. Click the Set as Default icon.
  14. Click Save and Close.
  15. Verify your changes:
    1. Click Closeto sign out of Page Composer.

    2. Sign out of Oracle Applications.

    3. Sign in to Oracle Applications with the Sales Manager role.

    4. Navigate to the Edit Customer <Customer Name>Profile page.

    5. Drill down into the customer record and confirm that the Snapshot page appears by default.

  16. When you are ready to commit your customizations to the back end, publish your sandbox according to your organization's established practices.

Extending Simplified Pages for Customers : Explained

Using Oracle Fusion CRM Application Composer, you can change many items that appear on the simplified set of pages that are available for customers.

The pages that are available for extensibility using Application Composer are listed below, and are described in this topic.

Note

To extend the simplified set of pages that are available for customers, use the Trading Community Person Profile and Trading Community Organization Profile objects in Application Composer, available with the Common application. You will also use the Sales Account object, which is available with the Customer Center application.

Note that these pages are not extensible:

Customers Overview Table

You can extend the following items in the Customers overview table:

This image shows the screenshot of the Customers
overview page

Note that you cannot make changes to these components on the page:

Create Customer Page

You can extend the following items on the Create Customer page:

This is a screenshot of the Create Customer page

Note that you cannot add custom buttons and actions to this page.

Edit Customer Page (Profile Page)

These regions on the Edit Customer page (Profile page) are extensible:

You can extend the following items on the Edit Customer page (Profile page):

This is a screenshot of the Edit Customer page

Note that you cannot make changes to these components on the page:

Create Consumer Page

You can extend the following items on the Create Consumer page:

This is a screenshot of the Create Consumer page

Note that you cannot add custom buttons and actions to this page.

Edit Consumer Page (Profile Page)

These regions on the Edit Consumer page (Profile page) are extensible:

You can extend the following items on the Edit Consumer page (Profile page):

Note that you cannot make changes to these components on the page:

You cannot create new subtabs.