Oracle JHeadstart Developer's Guide - Downloads - Oracle

6.14. Hyperlink to Navigate Context-Sensitive to Another Page (Deep Linking)
JHeadstart allows you generate hyperlinks (or buttons) that navigate context-sensitive to
another page. With context-sensitive we mean that the data displayed in the target page,
depends on the data displayed in the source page. This feature is called deep linking and
can be implemented using custom generator templates.
Attention: This section assumes you understand the concept of JHeadstart
Generator Templates and you know how to use custom templates as explained in
section 4.7
In this example, we will use the JHeadstart deep linking support in combination with a
custom template to generate the JobId in the Employees group table as a hyperlink that
navigates to the Job Edit page, querying the proper Job row.
First we must enable deep linking for the Job Edit Page, which is the target of the deep
link.
6.14.1.1. Enabling Deep Linking for a Group
To allow creation of deep links to the form page of a certain group (in this example the
Jobs group), perform the following steps:
1. In the Application Definition Editor, switch to Expert mode (see section Expert
mode). This will ensure that the Deep Linking property category becomes visible
at group level (between Table Layout and Generation Settings).
2. Go to the Jobs group and set the Deep Linking Type to Query By Key Value.
3. Set the Deep Linking Key Expression to #{param.jobId}
4. Generate the application, to make a navigation rule DeepLinkJobs available (it is
needed in the following steps).
These deep linking settings ensure that when a JSF navigation outcome called
'DeepLinkJobs' is used (this condition is specified in the Enable Deep Linking
Expression), it will go to the Jobs page, and query the Jobs data collection using the key
specified in the request parameter 'jobId' (the Deep Linking Key Expression).
Attention: For the Type of Deep Linking you can also choose "Set Current
Row Using Key Value". The difference is that instead of requerying the
database and returning just the desired row, the current row indicator in the
View Objects's row set will be pointed to the desired row.
The next step is to manually change the Job field in the Employees page to a hyperlink,
before moving that customization to a generator template.
JHeadstart Developer’s Guide Generating User Interface Widgets 6- 45