Create Guided Journeys for Redwood Pages in the Setup and Maintenance Work Area
A guided journey helps users complete tasks by facilitating a business process. Administrators can create a guided journey to embed tutorials, company policies, and best practices at the page or section level of an application page. For example, a guided journey could be created to help an employee place a sales order.
NOTE: In this update, guided journeys aren't yet supported on all Redwood pages.
In update 24C, you could use the Checklist Templates task in My Client Groups to create guided journeys for selected SCM Redwood pages. In update 24D, you can now set up guided journeys in the Setup and Maintenance work area, which consolidates your access to setup tasks in one work area. The steps to create a guided journey have also changed.
Let’s take a closer look at the use-case scenario of an employee placing a sales order. For example, you could create a guided journey that provides a checklist of tasks for the employee to do before creating or revising a sales order. The text is yours to enter, tailored to the needs of your particular use case and company. In the following example, you have a checklist to complete in the right pane. You could also link to an external website or video for additional guidance.
Guided Journey Example of Administrator-Specified Help Text (Right Pane)
In the following example, you can see guided journey tasks at the page and section level. The page-level guided journey tasks are displayed as a train stop below the Create Sales Order guided journey header, with two dots that correspond to two tasks in the journey. The section-level guided journey tasks are below the first row of fields at the left side of the page.
Guided Journey Tasks Examples at the Page and Section Levels
Create a Guided Journey and Associate a Page
At a high level, creating a guided journey is a two-step process:
- Create a guided journey.
- Associate the guided journey with the page or section level of an application page using Oracle Visual Builder Studio (VB Studio) in Express mode.
Create a Guided Journey
- In the Setup and Maintenance work area, go to the Guided Journeys task:
- Offering: Select any SCM offering (Manufacturing and Supply Chain Materials Management, Order Management, Inventory Management, Product Management, or Supply Chain Planning)
- Functional Area: Application Extensions
- Task: Guided Journeys
NOTE: Show all tasks or search for the Guided Journeys task.
- Click Create.
- Select a creation method, and note the value in the Code field for later use:
- If you select Use existing, you can choose an existing guided journey from the drop-down list.
- If you select New, enter a name. Note that the name you entered autopopulates the Code field when you click in it.
You can change the code if desired, but it must be unique among your journeys. You will use this code later to associate a guided journey with a page using VB Studio in Express mode.
- Click Create Draft.
- (Optional) Click Add to upload a background image.
- In the Tasks section, click Add to add tasks to your guided journey. Complete the fields in the New Task dialog box and click Save.
- Each task must have a Task Name and task Code. You can use the task code later to associate a task with a page using VB Studio in Express mode. Note the task code if you plan to use it later.
- (Optional) Change the status of the task to Active or Inactive.
- (Optional) Sequence the task.
- Click Preview to test your guided journey.
- Click Activate. The guided journey is ready to use.
Associate a Page
To determine whether you can extend a specific page using VB Studio, go to the page and open the Settings and Actions menu. Look for the Edit Page in Visual Builder Studio task.
Settings and Actions Menu
You can't use VB Studio to edit the page if you don’t see the Edit Page in Visual Builder Studio task.
When you open a page in VB Studio, you can extend it only using Express mode. Advanced mode isn’t supported. Express mode is displayed in the VB Studio header region.
Header Region in VB Studio Showing Express Mode
To associate a guided journey with a page in VB Studio Express mode:
- Navigate to the page you want to associate with the guided journey.
- Select the Edit Page in Visual Builder Studio task in the Settings and Actions menu.
- Navigate to the Page Properties section (formerly the Constants tab). Wait for the page to load completely before proceeding to the next step.
- Locate the journey code property you want to modify, and enter the page- or section-level code from the guided journey into the property field in VB Studio.
Mapping of VB Studio Property Name to Guided Journey Field Name
Property Name in VB Studio |
Field Name in the |
Description |
---|---|---|
NamePageJourneyCode |
(journey) Code |
Page-level journey code field, where Name is the camel-case name of the page. Enter a journey code in this field to display guided journeys at the page level. |
NamePageTaskCodes |
(task) Code |
Page-level task codes, where Name is the camel-case name of the page. Enter a task code in this field to display tasks at the page level. Separate multiple task codes with a comma. |
NameSectionJourneyCode |
(journey) Code |
Section-level journey code field, where Name is the camel-case name of the section. Enter a journey code in this field to display guided journeys at the section level. |
NameSectionTaskCodes |
(task) Code |
Section-level task codes, where Name is the camel-case name of the section. Enter a task code in this field to display tasks at the section level. Separate multiple task codes with a comma. |
The following screenshot shows journey code fields at the page and section level.
Journey Code Fields in VB Studio
- Click Preview to see your guided journey before publishing it.
- Click Publish when you are finished with your changes.
See the Guided Journeys Configuration Using Page Properties section of the Extending Redwood Applications for HCM and SCM Using Visual Builder Studio guide for a worked example.
Steps to Enable
Leverage the Visual Builder Studio to expose your applications. To learn more about extending your application using Visual Builder, visit Oracle Help Center > your apps service area of interest > Books > Configuration and Extension.
Before you can start working with VB Studio, a systems administrator must complete some initial setup. For instructions, see Set Up VB Studio to Extend Oracle Cloud Applications.
Use the Manage Administrator Profile Values task in the Setup and Maintenance work area to ensure the ORA_PER_JOURNEYS_ENABLED and ORA_PER_GUIDED_JOURNEYS_ENABLED profile options are set to Y at the site level. These profile options enable journeys.
Tips And Considerations
You can:
- Create guided journeys at the page or section level.
- Associate guided journeys in VB Studio Express mode only. VB Studio in Advanced mode isn’t supported for journeys.
- Create only guided journeys for Oracle Fusion Cloud SCM and Oracle Fusion Cloud Procurement. Other types of journeys, such as contextual and survey, aren’t supported.
- Use the Manage Administrator Profile Values task in the Setup and Maintenance work area to see a list of the available profile options.
- Use the Checklist Lookups task in the Setup and Maintenance work area to see a list of the available lookups.
Key Resources
- Check the following resources to understand the prerequisites and steps to create instances and workspaces:
- Set Up VB Studio to Extend Oracle Cloud Applications - Learn how to create a VB Studio instance.
- Get Started with Oracle Visual Builder Studio—Learn how to create a workspace in VB Studio and the prerequisites for enabling guided journeys.
- Extending Redwood Applications for HCM and SCM Using Visual Builder Studio – Learn how to extend your pages with guided journeys using VB Studio in Express mode.
- Implementing and Using Journeys – Learn how to create and use journeys. Although this guide was written for Oracle Fusion Cloud HCM, the concepts apply to Oracle Fusion Cloud SCM.
Access Requirements
Users who are assigned a configured job role that contains these privileges can access this feature:
- Manage Journey (ORA_PER_MANAGE_JOURNEY_TEMPLATE)
- Administrator Sandbox (FND_ADMINISTER_SANDBOX_PRIV)
These privileges were available prior to this update.