You are on page 1of 24

Using Oracle Page Composer to Link to an

External Page from Inventory Management


An Oracle Topical Essay
ORACLE TOPICAL ESSAY | MARCH 2021

Copyright © 2021, Oracle and/or its affiliates


Table of Contents

Oracle Page Composer Overview 2

Sandboxes Explained 2

Creating a Sandbox 3

Activating a Sandbox 5

Viewing Sandbox Details 5

Leaving a Sandbox and Returning to the Mainline Metadata 6

Publishing a Sandbox 7

Deleting a Sandbox 7

Worked Example: Deep Link from Manage Item Quantities Using an Inventory Lot 8

Working in Page Composer 9

Editing User Interface in Page Composer 10

Configuring Hyperlink Properties in Page Composer 14

Worked Example: Deep Link from Manage Item Quantities Using a Serial Number 18

Configuring Serial Number Hyperlink Properties in Page Composer 19

Additional Resources 23
Oracle Page Composer Overview
Oracle Page Composer is used to customize page content, layout, and more. Using other tools,
you can create new pages and customize UI text, themes, infolets, and so on. This topical essay
details how Oracle Page Composer can be used to link to an external page from Inventory
Management pages. Specifically, this topical essay details how you can create a hyperlink from
the Manage Item Quantities page to another page within Oracle Inventory Management.

Key Features of Oracle Page Composer:

» Use tools such as User Interface Text Customization to customize user interface text
» Use the Appearance page to change the look and feel of the application
» Open an infolet page in Page Composer to customize it
» Use the Page Integration page to create and manage pages for hosting third party applications

Before customizing pages, do the following tasks:

» Understand that the page customizable. To do so, check if either the Customize Pages or the
Customize <Page Name> Pages menu item is available under the Administrator menu. If no,
then that means the page can’t be customized
» Confirm that your privileges are sufficient for customizing the page
» Activate a sandbox

Sandboxes Explained
Maintain sandboxes using the Sandbox Manager. In the global region, expand the Settings and
Actions menu which is available next to your user name. Then select Edit Pages, under the
Administration subheading.
Use the Sandbox Manager to:
» Create sandboxes
» Activate sandboxes
» Exit a sandbox and return to the mainline metadata
» Review a list of available or published sandboxes
» Publish sandboxes
» Delete sandboxes

2
Copyright © 2021, Oracle and/or its affiliates
Figure 1 Sandbox Process Flow

Creating a Sandbox

To create a new sandbox, navigate to Sandbox Manager. Create a new sandbox by clicking the
navigator and selecting Configuration and then Sandboxes. When creating multiple sandboxes,
create one for testing only which you will never publish. Also, create a single integration sandbox
that you do intend to eventually publish.
» Private sandbox – Testing and prototyping only. Never publish. Delete when finished, or
after its related integration sandbox has been published.
» Integration sandbox – Testing and validations with the intent to publish. Ensure only one
administrator user works in this sandbox at a time.

3
Copyright © 2021, Oracle and/or its affiliates
Figure 2 Configuration > Sandboxes

In the Sandboxes page, click the button ‘Create Sandbox’.

Enter a Sandbox Name and Sandbox Description. Additionally, select ‘Page Composer’ from the
Tool listing. Select ‘Yes’ for Publishable.

Figure 3 Create Sandbox

4
Copyright © 2021, Oracle and/or its affiliates
Activating a Sandbox

Once you have entered the sandbox name and description and selected the tool ‘Page
Composer’, click the button ‘Create and Enter’. Only one sandbox can be active at a time. When a
sandbox is active for your session, the sandbox name will be displayed in the global area.
After activating a sandbox, you should always log out and login again. This helps you to avoid
conflicts by ensuring that the cache is cleared.
Note: If you log out and login again, your sandbox remains active. A sandbox remains active until
you exit the sandbox, publish the sandbox, delete the sandbox, or set another sandbox as active.

Figure 4 Manage Sandboxes – Newly Created Sandbox

Viewing Sandbox Details

After you're in a sandbox, you can view details about it using the Sandbox Details window.
To view the Sandbox Details window, click the name of the active sandbox at the top of the
window, then click Sandbox Detail.
Caution: In the Sandbox Details window, it is possible to select individual files within the sandbox
and delete them. You should not do this, because it can cause problems with your sandbox.

5
Copyright © 2021, Oracle and/or its affiliates
Figure 5 Sandbox Details

Leaving a Sandbox and Returning to the Mainline Metadata

To exit from the current sandbox session, hover over the sandbox name in the global area and
then click Leave Sandbox.
The sandbox session is closed and you are returned to the application in the mainline metadata.
After leaving a sandbox session, you should always log out from Oracle Public Cloud Services and
login again. This helps you to avoid conflicts by ensuring that the cache is cleared.

Figure 6 Leave Sandbox

6
Copyright © 2021, Oracle and/or its affiliates
Publishing a Sandbox

Completed customizations created within a test-only sandbox and then replicated to an integration
sandbox must be published to be available to other users in the application in the mainline
metadata. Always publish customizations from the integration sandbox only.
Before each patch or upgrade, you should publish or delete your sandboxes. Outdated sandboxes
might not be publishable due to potential conflicts. If your work is incomplete, you should start
fresh with a new sandbox.
Note: There is no standard mechanism to roll back changes that have already been published to
the mainline metadata.
To publish a sandbox, select the sandbox and then click the Publish button.
After you publish a sandbox, the sandbox session is closed and the sandbox is no longer active.
Be sure to delete your test-only sandboxes, and then create new sandboxes (including a new
integration sandbox) for your application customization work.

Figure 7 Publish Sandbox

Deleting a Sandbox

Once you have tested your customizations, you then move those customizations to the integration
sandbox. After you publish your integration sandbox, you must delete all test-only sandboxes, and
then create and work in entirely brand new sandboxes, including a new integration sandbox. You
can delete only non-published sandboxes that are not active.

7
Copyright © 2021, Oracle and/or its affiliates
Figure 8 Delete Sandbox

Worked Example: Deep Link from Manage Item Quantities Using an Inventory Lot

In this worked example, the Supply Chain Application Administrator wants to create a Hyperlink
form the Mange Item Quantities page to the Mange Lots page. The intent of this flow is to view
additional attributes for the selected lot. Also, in the event a certain lot attribute needs to be
updated, the user can perform the update in the Manage Lots page.
In this worked example, you are reviewing lots for a given item within the Manage Item Quantities
page. Once you have identified a specific lot, you next want to review additional details for the
selected lot. A Hyperlink will be displayed above the Lot node in the tree table as shown below.

8
Copyright © 2021, Oracle and/or its affiliates
Figure 9 Hyperlink Example

Clicking the Hyperlink from the Manage Item Quantities page will take you directly to the Manage
Lots page in the context of the Inventory Organization, Item, and Lot. From the Manage Lots
page, you can view specific details specific to the Lot or edit selected Lot attributes.

Figure 10 Manage Lots Example

Working in Page Composer

The first step in the process is to navigate to the Manage Item Quantities page and search for your
Lot controlled item. Ensure that you have activated the sandbox. Also, confirm that the sandbox
name is displayed in the upper left hand corner of the page.
Enter Page Composer to make your modifications to the Manage Item Quantities page.
Click Page Composer to open the page

9
Copyright © 2021, Oracle and/or its affiliates
Figure 11 Open Page Composer

Editing User Interface in Page Composer

Click the Structure tab to begin editing the user interface. You can view the page source in the
lower portion of the screen. Click the ‘Item’ column to refresh the page source in lower portion of
the page.
Note: Scroll to the bottom of the page to view the page source. You can also expand the page
source region to better view the page source details. In the event you enter information incorrectly,
you can reset the task flow by clicking ‘Reset Task Flow’ to reset the original task flow properties.

Click ‘group’ in the page source region to add content.

10
Copyright © 2021, Oracle and/or its affiliates
Figure 12 Entering Page Composer

Once you have selected ‘group’, click the Add (Plus) icon to open the Add Content dialog window.
add content. Select row Components and click the Open link which will display the web page
building blocks such as text, HTML, and images.

11
Copyright © 2021, Oracle and/or its affiliates
Figure 13 Add Content

Next, select ‘Hyperlink’ and click the ‘Add’ icon.

12
Copyright © 2021, Oracle and/or its affiliates
Figure 14 Add Hyperlink

Once you add the Hyperlink, the hierarchy in the page source will be displayed as follows:
<>group
<>showDetailFrame
<>Hyperlink
You will now select the Hyperlink node and click the Edit icon to show the component properties
for the Hyperlink.

13
Copyright © 2021, Oracle and/or its affiliates
Figure 15 Edit Hyperlink

Configuring Hyperlink Properties in Page Composer

In the Component Properties dialog window enter the attribute values as noted in the table below.
In the event you enter information incorrectly, you can reset the task flow by clicking ‘Reset Task
Flow’ to reset the original task flow properties.

You can click the drop-down icon next to an attribute and choose Expression Builder in order to
use EL Expressions.

14
Copyright © 2021, Oracle and/or its affiliates
Attribute Value Comments

Destination https://<pod- Follow the Deep Link URL


name>/fscmUI/faces/deeplink?objType=INV_M Pattern as noted in the
ANAGE_LOTS&action=NONE&objKey=LotNu Value Column.
mber=#{bindings.LotNumber.inputValue};ItemN
umber=#{bindings.ItemName.inputValue};Orga You can manage lots with
nizationId=#{node.OrganizationId} expressions for the lot
number, item number, and
organization id

Disabled #{bindings.LotNumber.inputValue == null}

Partial Triggers ::::q1 ::::ATT1:_ATTp:tt1 Triggers the link with


respect to the query and
value in the table.

Target Frame _blank Launches the Hyperlink in a


new browser tab.

Text #{InvMaterialAvailabilityGenBundle['AltTxt.Lot1'
]} #{bindings.LotNumber.inputValue} :
#{ResourcesGenBundle['Header.Details']}
Visible #{node.NodeType == 'Lot'} Using
expression #{node.NodeTy
pe == 'Lot'} to display the
link only for the lot node.

Figure 16 Hyperlink Component Attribute Values

Once you have finalized your attribute values, you can enter them into the Component Properties:
Hyperlink dialog window as shown below.
Click Apply > OK to save your entries.

15
Copyright © 2021, Oracle and/or its affiliates
Figure 17 Component Properties: Hyperlink

Once you have complete your work, click the Close button to return the Manage Item Quantities
page.
Test your page composer entries by search for a lot controlled item in the Mange Item Quantities
page. The hyperlink for the lot will be enabled upon selection of the lot node as shown below.

16
Copyright © 2021, Oracle and/or its affiliates
Figure 18 Manage Item Quantities Lot Hyperlink Example

Confirm that clicking on the Lot Hyperlink opens the Mange Lots page in the context of the
Inventory Organization, Item, and Lot.

Figure 19 Manage Lots Page

This completes the Worked Example: Deep Link from Manage Item Quantities Using an Inventory
Lot.

17
Copyright © 2021, Oracle and/or its affiliates
Worked Example: Deep Link from Manage Item Quantities Using a Serial Number

In this worked example, the Supply Chain Application Administrator wants to create a Hyperlink
from the Mange Item Quantities page to the Mange Serial Numbers page. The intent of this flow is
to view additional attributes for the selected serial number. Also, in the event a certain serial
number attributes need to be updated, the user can perform the update in the Manage Serial
Numbers page.
In this worked example, you are reviewing serial numbers for a given item within the Manage Item
Quantities page. Once you have identified a specific serial number, you next want to review
additional details for the serial number. A Hyperlink will be displayed to the left of the serial number
in the table detail as shown below.

Figure 20 Serial Number Hyperlink

Clicking the Hyperlink from the Manage Item Quantities page will take you directly to the Manage
Serial Numbers page in the context of the Inventory Organization and Serial Number. From the
Manage Serial Numbers page, you can view specific details for the serial number. Additionally,
you can update serial number attributes if required.

18
Copyright © 2021, Oracle and/or its affiliates
Figure 21 Manage Serial Numbers

Configuring Serial Number Hyperlink Properties in Page Composer

Note: Please follow the steps in the previous worked example to add the Hyperlink for the serial
number.
Once you add the Hyperlink, the hierarchy in the page source will be displayed as follows:
<>column
<>showDetailFrame
<>Hyperlink
You will now select the Hyperlink node and click the Edit icon to show component properties for
the Hyperlink.
In the Component Properties dialog window enter the attribute values as noted in the table below.
In the event you enter information incorrectly, you can reset the task flow by clicking ‘Reset Task
Flow’ to reset the original task flow properties.

You can click the drop-down icon next to an attribute and choose Expression Builder in order to
use EL Expressions.

19
Copyright © 2021, Oracle and/or its affiliates
Figure 22 Edit Hyperlink

In the Component Properties dialog window enter the attribute values as noted in the table below.
In the event you enter information incorrectly, you can reset the task flow by clicking ‘Reset Task
Flow’ to reset the original task flow properties.

You can click the drop-down icon next to an attribute and choose Expression Builder in order to
use EL Expressions.

Attribute Value Comments

Destination https://<pod- Follow the Deep Link URL


name>/fscmUI/faces/deeplink?objType=INV Pattern as noted in the
_MANAGE_SERIALS&action=NONE&objKey= Value Column.
SerialNumber=#{row.bindings.SerialNumber.i You can manage serial
nputValue};OrganizationCode=#{bindings.Or numbers with expressions
ganizationCode1.inputValue} for the serial number and
organization id

Disabled #{row.bindings.SerialNumber.inputValue ==
null}

Target Frame _blank Launches the Hyperlink in a


new browser tab.
20
Copyright © 2021, Oracle and/or its affiliates
Text #{row.bindings.SerialNumber.inputValue}

Figure 23 Hyperlink Component Attribute Values

Once you have finalized your attribute values, you can enter them into the Component Properties:
Hyperlink dialog window as shown below.
Click Apply > OK to save your entries.

Figure 24 Component Properties: Hyperlink

Once you have completed your work, click the Close button to return the Manage Item Quantities
page.
Test your page composer entries by searching for a serial number controlled item in the Mange
Item Quantities page. The hyperlink for the serial number will be enabled in the detail region under
the Serial Number Details tab as shown below.

21
Copyright © 2021, Oracle and/or its affiliates
Figure 25 Serial Number Deep Link

Confirm that clicking on the Serial Number Hyperlink opens the Mange Serial Numbers page in
the context of the Inventory Organization and Serial Number.

Figure 26 Manage Serial Numbers

This completes the Worked Example: Deep Link from Manage Item Quantities Using a Serial
Number.

22
Copyright © 2021, Oracle and/or its affiliates
Additional Resources
Below are several additional resources.
» Configuring and Extending Applications
» Page Composer Blog

Oracle Corporation, World Headquarters Worldwide Inquiries


2300 Oracle Way Phone: +1.650.506.7000
Austin, TX 78741, USA Fax: +1.650.506.7200

CONNECT WITH US

blogs.oracle.com/oracle
Copyright © 2016, Oracle and/or its affiliates. All rights reserved. This document is provided for information purposes only, and the
contents hereof are subject to change without notice. This document is not warranted to be error-free, nor subject to any other
facebook.com/oracle warranties or conditions, whether expressed orally or implied in law, including implied warranties and conditions of merchantability or
fitness for a particular purpose. We specifically disclaim any liability with respect to this document, and no contractual obligations are
formed either directly or indirectly by this document. This document may not be reproduced or transmitted in any form or by any means,
twitter.com/oracle electronic or mechanical, for any purpose, without our prior written permission.

oracle.com Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.

Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and
are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are
trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open Group. 0116

Using Oracle Page Composer to Link to an External Page from Oracle Inventory Management
March 2021
Author: Matthew Jones and Prudhvi Deep Mutyala

23
Copyright © 2021, Oracle and/or its affiliates

You might also like