Oracle UPK - Using Web Pages in Topics

If you recall our long-running exercise on maintaining your SAP user profile, you will remember that we ask the user to enter their last name and their first name. These terms may be confusing in some countries—especially in countries where the "family name" actually comes before the "given name"—so we want to provide some extra explanation of some common name formats in different countries, and how these translate into first name and last name. We'll provide this information in a Web Page, and then link to this Web Page at the relevant place(s) within our Topic.

First, we need to create the Web Page. How to do this is explained in the section Creating independent Web Pages, above. For our exercise, our created Web Page is as follows:

There are two ways in which you can link to a Web Page from a Topic. These are explained separately, below.

Linking via a hyperlink

With a hyperlink, the Web Page is linked from a word or phrase within the Bubble Text of a Frame. (Note that it is only possible to do this for Custom Text because you can't select the Template Text to hyperlink from.) To create a hyperlink to a Web
Page from within a Frame in a Topic, carry out the steps described below:

1. Open up the Topic in the Topic Editor.

2. Navigate to the Frame from which you want to provide the hyperlink. In our exercise, we will link from the Explanation Frame describing the Last name field (this is Frame 5B).

3. In the Bubble Properties pane, select the text that you want to form the hyperlink (that is, the text that the user will click on to display the Web Page).

4. Click on the Bubble text link button ( ) in the Bubble Properties pane. The Bubble Text Link Properties dialog box is displayed.

5. Click on the Create link button ( ) to create a link to an existing Web Page (you could also click on the Create new web page button ( ) to create a new Web Page if you have not yet created it). The Insert Hyperlink dialog box is displayed, as shown in the next screenshot:

6. Make sure that the Document in Library option is selected in the Link to: bar.

7. In the Look in: field, navigate to the folder containing the Web Page (the Assets folder, in our example).

8. In the file list, click on the Web Page to which you want to create a hyperlink.

9. Click on the Open button.

10. Back in the Bubble Text Link Properties dialog box, click on OK.

This hyperlink will now appear as follows, in the Player:

Note that there is no ToolTip for this hyperlink. There was no opportunity to enter one in the steps above, so UPK doesn't know what to use.

Version Difference
In OnDemand 8.7 the Infoblock name was used as the ToolTip, but this is not the case from OnDemand 9.x onwards.