Introduction

This 45-minute hands-on tutorial shows you how to design and customize navigation flows in Oracle Sales Planning. The sections build on each other and should be completed sequentially.

Background

When you log on to an environment, the home page displays clusters and cards that group the activities that you can perform in the environment.

home page Application Cluster

Cards provide access to key tasks, tutorials, and related information. When you click a card, a page containing available shortcuts or tasks opens. Availability of shortcuts and tasks on a page depends on the role you have in the environment. You can customize which cards and clusters to display by setting up Navigation Flows.

Navigation Flows

Prerequisites

Cloud EPM Hands-on Tutorials may require you to import a snapshot into your Cloud EPM Enterprise Service instance. Before you can import a tutorial snapshot, you must request another Cloud EPM Enterprise Service instance or remove your current application and business process. The tutorial snapshot will not import over your existing application or business process, nor will it automatically replace or restore the application or business process you are currently working with.

Before starting this tutorial, you must:

  • Have Service Administrator access to a Cloud EPM Enterprise Service instance. The instance should not have a business process created.
  • If you haven't already, register for a free Oracle Cloud Customer Connect account so you can access the required files.
    • Download the latest Sales Planning Sample Application snapshot from this idea page.
    • Upload and import the latest Sales Planning Sample Application snapshot into your Planning instance.

    Note:

    If you run into migration errors importing the snapshot, re-run the migration excluding the HSS-Shared Services component, as well as the Security and User Preferences artifacts in the Core component. For more information on uploading and importing snapshots, refer to the Administering Migration for Oracle Enterprise Performance Management Cloud documentation.
  • Create a Sales Planning user in the identity domain associated with your instance. Assign the User predefined role to enable the user access to the instance. Do not log on as this user.

Setting up Application and User Preferences

In this section, you review the substitution variables that are set up. You also set user preferences so that you can work with forms and dashboards.

Enabling non-administrator use of the application

  1. Login as the Service Administrator.
  2. From the home page, click Application, then Settings.
    Navigating to Application Settings
  3. In Application Settings, for Enable Use of the Application, select All users.
    Enable the use of the application for all users
  4. Click Save (Save).
  5. In the Information message, click OK.
    Information message
  6. Click Home icon (Home).

Setting Values for User Variables

  1. From the home page, click Tools, then User Preferences.
    User Preferences
  2. On the left, under Preferences, click User Variables.
  3. For each variable, click its icon member selector (Select Member) to select a member as the variable's value:
    Dimension User Variable Member
    Accounts Accounts Segments All Accounts
    Currency Currency USD
    Period Period Granularity YearTotal
    Product Product Family All Product
    Currency Reporting Currency USD
    Scenario Scenario Plan
    Territory Territory NA Key Accounts - Anthony Furini
    Years Years FY24
    Accounts Account Segments All Accounts
    Scenario Forecasting Scenario Forecast
    Version Forecasting Version Working Bottom Up
    Measures Drivers Product Measures
    Product Product Family All Product
    Territory Territory NA Products - West - Mateo Lopez
    Currency Currency USD
    BaselinePromotions Current Promotion Base
    Scenario Key Account Scenario Plan
    Version Key Account Version Working Bottom Up
    Territory Overlay Territory All Overlay Territory
    Territory Sales Rep Territory Central - Products - Div I -Peter Branch
    Territory Territory NA Products - Central - Alex Smith
    Accounts Accounts All Accounts
    Product Product All Product

    Tip:

    If you selected to show aliases in Member Selector, the value listed in the Member column may vary. For example, for some dimensions, the prefix (OEP_ and OGS_) are not shown. For some territory members, instead of the numeric member name, the full alias name is displayed.
  4. Verify your selections, and click Save.
    Save
  5. In the Information message, click OK.
    Preferences Saved

Navigation Flows are comprised of clusters, cards, and tabs that allow a user to complete planning tasks.

With Navigation Flow Designer, you can create navigation flows that control how roles, or groups, interact with Sales Planning. You can:

  • Customize labels for cards or tabs
  • Select icons that are used for cards or tabs
  • Hide and unhide cards and tabs
  • Display order of cards and tabs
  • Add new or existing cards
  • Add new horizontal or vertical tabs
  • Remove navigation flows, cards, and tabs
  • Group cards into clusters
  • Add existing clusters

Sales Planning Navigation Flows

Sales Planning comes with a predefined navigation flow, called Default. The default navigation flow includes three clusters, one for each business process: Quota Planning, Advanced Sales Forecasting, and Key Account Planning.

home page

Cards and their contents depend on the features you enabled.

About the Quota Planning Cluster

  1. From the home page, click Quota Planning.

    The cards in the Quota Planning cluster are displayed.

    Quota Planning navigation flow
  2. Click Set Targets.

    When you click a card within a cluster, the cards within that cluster are displayed on the top of the page. Vertical tabs and horizontal tabs allow you to switch between tasks.

    Set Targets
  3. From the cards on the top of the page, click Top Down Planning.

    The vertical and horizontal tabs displayed are specific to Top Down Planning.

    Top Down Planning
  4. Switch tasks using horizontal tabs. Click Adjust by Product.

    In Adjust by Product, the My Target by Product and My Teams's Target by Product forms and chart are displayed.

    Adjust by Product
  5. Click through the horizontal tabs and review the page contents. Then, return to the first horizontal tab, Top down and Adjust.
  6. Switch tasks using vertical tabs. Click Home icon (Padding).
    Click Padding

    Padding displays a dashboard of multiple forms and a chart within one horizontal tab.

    Padding page
  7. Click Home icon (Home).

About the Advanced Sales Forecasting Cluster

  1. From the home page, click Advanced Sales Forecasting.

    Advanced Sales Forecasting includes one card: Generic.

    ASF navigation flow
  2. Click Generic.

    The Generic card is displayed on the top of the page. When first opened, the Overview dashboard displays.

    ASF Generic
  3. In Generic, navigate between horizontal tabs. Click Forecast Summary.
  4. Review the contents of Forecast Summary.
    Forecast Summary
  5. Click through the horizontal tabs and review the page contents.
  6. Click Home icon (Home).

About the Key Account Planning Cluster

  1. From the home page, click Key Account Planning.

    The cards in the Key Account Planning cluster are displayed.

    KAP navigation flow
  2. Click Baseline.

    The Baseline card is displayed on the top of the page. When first opened, the Overview - Revenue dashboard displays.

    ASF Generic
  3. In Baseline, navigate between horizontal tabs. Click Prediction - Revenue.
  4. Review the contents of Prediction - Revenue.
    Prediction - Revenue
  5. Click through the horizontal tabs and review the page contents.
  6. Click Home icon (Home).
  1. From the home page, click Tools, then Navigation Flows.
    Navigation Flows

    The Navigation Flow page lists each navigation flow by name and whether it is active or not. If assigned, the list also indicates the role or group that has access to the navigation flow.

    Navigation Flow page
  2. Click Quota Sales Rep.

    Tip:

    You can edit navigation flows in Navigation Flow Designer if they are inactive.
    Click Quota Sales Rep

    Quota Sales Rep is opened in Navigation Flow Designer.

  3. Review its components:
    Navigation Flow Designer
    No. Component Description
    1 Name and description Enter or modify the name of the navigation flow. Descriptions are optional.
    2 Navigation and Infolets vertical tabs Switch between the Navigation and Infolets vertical tabs.
    3 Name Name or label of a card or cluster.
    4 Type Identifies if the object is a card or cluster
    5 Visible Indicates whether a card in the navigation flow is visible on the home page
    6 Order Use the arrows to reposition the cards and clusters in the listing. The cards and clusters are listed in the order in which they are displayed on the home page.
    7 Remove Removes a card or cluster from the navigation flow.
    8 Add Add new card or cluster, or an existing card or cluster to the navigation flow.
    9 Assign to Assign the navigation flow to a group of users or to a role.
    • Click Save and Close (Save and Close) to save your changes and close Navigation Flow Designer.
    • Click Cancel (Cancel) to close Navigation Flow Designer without saving your changes.

    Notice that the description for the Quota Sales Rep navigation flow displays Default Navigation Flow because it was copied from the Default navigation flow. You can modify descriptions, as needed.

Assigning Permissions

There are three (3) levels of permissions for navigation flows:

  • Global permission is granted to all users.
  • Role-based or group-based permission is granted to users in a specific role or group.
  • Artifact-based permission is granted to users with access permissions to artifacts included in the navigation flow.
  • For example, for a form displayed in the navigation flow, only users with permission to the form can view or write to that form.

  1. In Assign to, type Sales.

    Available roles and groups that include the keyword you typed are listed.

    Available Roles and Groups

    Tip:

    Alternatively, you can use Search (Search) to find a group or role in the Assign Navigation Flow dialog.

  2. From the list, select Sales Rep.
    Assigning Sales Rep
  3. Click Save and Close (Save and Close).

    Notice that Sales Rep is now listed in the Role/Group column for the Quota Sales Rep navigation flow.

    Quota Sales Rep lists Sales Rep under Role/Group
  4. Next, edit the other navigation flows and assign groups based on the following example:
    Navigation flow roles

    Do not assign a role or group to the Default navigation flow.

Activating and Deactivating Navigation Flows

If you assigned permissions to navigation flows, you can enable them simultaneously. When a user logs into Sales Planning, they can switch between navigation flows that they have access to.

Tip:

Before you can edit a navigation flow, make sure that it is not Active. There must be at least one active navigational flow in the application.
  1. For Quota Sales Mgr, click Inactive to switch its active state.
  2. For Quota Sales Ops, click Inactive.
  3. For Quota Sales Rep, click Inactive.
  4. For Quota Sales VP, click Inactive.
  5. Note:

    You can activate only one navigation flow per Role/Group.
  6. Verify that you have set the following navigation flows as active:
    Activating navigation flows
  7. Click Home icon (Home).

Switching Navigation Flows

You switch navigation flows by selecting an option in Navigation flows Navigation Flows:

Navigation Flows

Or in Navigator:

Navigator

  1. On the upper right, click Navigation flows (Navigation Flows).
  2. Select Quota Sales VP.
    Select Sales VP navigation flow
  3. The navigation flow is updated based on your selection.

    Quota Sales VP navigation flow
  4. If the navigation flow doesn't update right away, you can reload the navigation flow. On the upper right, click your username, then click Reload Navigation Flow.
    Reload navigation flow
  5. On the home page, click Quota.

    The Quota Sales VP navigation flow's Quota card opens to an overview dashboard in the Top down vertical tab. The artifacts included in the navigation flow includes tasks that are specific to Quota Sales VP users.

    dashboard
  6. Click Home icon (Home).
  7. Click Navigator (Navigator).
  8. Click Navigation flow list to display the navigation flow dropdown list options.
  9. Select Quota Sales Rep.
    Quota Sales Ops
  10. On the upper right, click your username, then click Reload Navigation Flow.
  11. On the home page, click Quota.

    The Quota card opens to tasks specific to the selected navigation flow.

    Quota Commits dashboard
  12. Click Home icon (Home).

Managing Navigation Flows

Creating Navigation Flows

You create a navigation flow by duplicating an existing one. For new Sales Planning applications, you create a navigation flow by duplicating the Default navigation flow.

In this section, you create a navigation flow by duplicating the Quota Sales Rep navigation flow.

  1. From the home page, click Tools, then Navigation Flows.
    Navigation Flows
  2. In Navigation Flow, select the Quota Sales Rep row.
    Quota Sales Rep row
  3. On the upper right, click (Actions) and select Create Copy.
    Actions, Create Copy
  4. In Create Navigation Flow, enter Quota NA Sales Reps as the name and click OK.
    Create Navigation Flow

    Quota NA Sales Reps is now listed in Navigation Flow.

    Navigation Flow

Editing Navigation Flows

  1. For Quota NA Sales Reps, verify that it is Inactive.
  2. Click Quota NA Sales Reps.
    Navigation Flow

    The navigation flow is displayed.

    Navigation Flow is displayed
  3. On the upper left, modify the following:
    • Name: SPC All Sales Reps.
    • Description: SPC navigation flow for all Sales Reps
    Name and description

Adding a New Sales Planning Cluster

  1. Click Actions (Actions) and select Add Cluster.
    Adding clusters
  2. In Manage Cluster, enter Sales Planning as the name.
  3. Verify that Visible is set to Yes.

    Tip:

    To hide a cluster, set Visible to No.
  4. For Icon, click Icon (Choose Icon).
  5. In Choose Icon, select Selecting an icon.
  6. Verify selections
  7. In Manage Cluster, verify your selections and click Save and Close (Save and Close).

    After saving, the Sales Planning cluster is added to the bottom of the navigation flow.

    The Sales Planning cluster is added to the bottom of the navigation flow

Adding Cards to the Sales Planning Cluster

  1. Make sure that the Sales Planning row is selected.
    Sales Planning cluster
  2. Click Actions (Actions), then select Add Card.
    Add Card
  3. In Manage Card:
    • Enter Quota Planning as the name.
    • Verify that Visible is set to Yes.
    • Verify that Sales Planning is selected as the Cluster.
    • For icon, selectQuota card icon.
    Manage Card
  4. In Content, for Page Type, select Tabular Page.
    Tabular page
  5. For Orientation, verify or select Vertical.
  6. Click Add New Tab.
    Add new tab
  7. In Manage Tab:
    • Enter Set Targets as the name.
    • Verify that Visible is set to Yes.
    • For icon, select Set Targets icon.
    Set Targets
  8. For Page Type, select Tabular Page.
  9. Click Add Existing Sub Tab.
    Add sub tab
  10. In Library, for Navigation Flow, verify that Default is selected.
  11. Expand Quota Planning, and then Set Targets.
  12. Select the following:
    • Overview
    • Set Growth
    • Predictive Planning
    Selecting tabs
  13. Click OK.
  14. In Manage Tab, verify your selections and click Save and Close (Save and Close).
  15. Review Set Target tab
  16. In Manage Card, click Add New Tab.
    Add new tab
  17. In Manage Tab:
    • Enter Quotas and Commissions as the name.
    • Verify that Visible is set to Yes.
    • For icon, select Quota and Commissions icon.
    Quotas and Commissions
  18. In Content, for Page Type, select Tabular Page.
  19. Click Add Existing Sub Tab.
  20. In Library, for Navigation Flow, select Quota Sales Rep.
  21. Expand Quota, then select the following:
    • Quota Commits
    • Adjust by Product
    Selecting quota commit tabs
  22. Click OK.
  23. In Manage Tab, verify your selections and click Save and Close (Save and Close).
    Review Commissions Tab
  24. In Manage Card, click Save and Close (Save and Close).
  25. Review Cluster

    The Quota Planning card is added under the Sales Planning cluster.

    Quota Planning

Reordering Clusters and Cards

  1. In Navigation, expand Advanced Sales Forecasting.
  2. For Generic, click Move To (Move To).
    Expand ASF
  3. In Move to Cluster, click Sales Planning.
    Move to Cluster
  4. If not already expanded, expand Sales Planning.
  5. Verify that the Generic card was moved to the Sales Planning cluster.
    Sales Planning cluster
  6. Click Generic.
  7. In Manage Card, change the Name to Advanced Sales Forecasts.
    Changing the card name
  8. Click Save and Close (Save and Close).

    The Generic card's name was updated to Advanced Sales Forecasts.

    Cards under Sales Planning
  9. Select the Sales Planning row and click Move up (Move up).
    Move up the Sales Planning Cluster

    The Sales Planning cluster is moved above the IPM cluster.

    Move up
  10. Click Move up (Move up) until the Sales Planning cluster reaches the top of the list.
    Sales Planning cluster moved up

Hiding and Unhiding Clusters and Cards

  1. In Navigation, select Quota and deselect the Visible checkbox.

    The Visible column indicates if a Card/Cluster will be visible in the navigation flow.

    Quota card visibility
  2. Deselect the Visible checkbox to hide the following clusters and cards:
    • Quota Planning
    • Advanced Sales Forecasting
    • Key Account Planning
    • Tasks
    • Academy
    • Approvals
    • Rules
    Quota card visibility

Removing Clusters and Cards

You click Remove (Remove) to remove a card or cluster from the navigation flow.

  1. For Quota, click Remove (Remove).
    Remove
  2. In the Warning message, click Yes.
    Remove Warning

    The Quota card was removed from the list.

    Quota was removed from the list
  3. Click Save and Close (Save and Close) to save the changes to the navigation flow.

Deleting Navigation Flows

You can delete a navigation flow by selecting the Delete option from the Actions (Actions) menu.

Actions, Delete

Verifying the SPC All Sales Reps Navigation Flow

Activating SPC All Sales Reps

In Navigation flow, for SPC All Sales Reps, click Inactive.

Activating navigation flows

Once the SPC All Sale Reps navigation flow set to active, the Quota Sales Rep navigation flow is automatically set to inactive, as only one navigation flow can be active per Role/Group.

Activating navigation flows

Provisioning Users to the Sales Rep Group

In this section, you grant permissions to the user noted in the Prerequisites section of this tutorial.

  1. Click Navigator (Navigator), then under Tools, click Access Control.
    Navigating to Access Control
  2. Click Manage Users.
    Go to Manage Users
  3. In Manage Users, search for the user to provision, click Actions (Actions), then select Edit.
    Edit user

    Edit User is displayed.

  4. In Member Of, for Available Groups, click Search (Search.)
    Edit user
  5. From the list of available groups, select Sales Rep. and click Move to (Move To).
    Select Sales Rep

    Sales Rep is added to Assigned Groups.

    Assigned Groups
  6. Click Save (Save).
  7. In the Edit User message, click OK.
    Edit user message
  8. Log out and log back on as the user you just provisioned.

After logging on with the user you added to the Sales Rep group, the navigation flow on the home page displays the SPC All Sales Reps navigation flow.

home page
  1. Click Sales Planning.

    The cards under the Sales Planning cluster are displayed.

    Sales Planning cluster

    Note:

    Notice that the Generic card's label did not change to Advanced Sales Forecasts.

    If the label of a card or cluster is defined in the Artifact Labels page on the Tools cluster, that definition will take precedence and will display during runtime. To change a label permanently, redefine it in the Artifact Labels page.

  2. Click Quota Planning.
    • The Set Targets vertical tab is opened with the Overview Review and Quota dashboard displayed.
    • Below Set Targets is the Quotas and Commissions vertical tab.
    • On the top, the Quota Planning and Generic cards in the Sales Planning cluster are accessible.
    Quota Planning
  3. Click through the tabs in the Quota Planning and Generic cards to review the contents of the navigation flow.