You can configure Oracle User Productivity Kit (UPK) modules and topics as component and page-level-related content services. This appendix provides a brief overview of Oracle UPK and related content and describes how to:
Create related content services that access UPK topics.
Assign UPK-based services to pages and components.
Access UPK-based related content.
Note. In this appendix, the word topic is used to represent both topics and modules unless specified otherwise.
Oracle UPK Developer and content is an end-user training solution that provides a single-source development and customizing tool to enable rapid content creation and customization. UPK also can provide system process documentation, web-based training materials, role-based performance support, and product documentation.
PeopleSoft Related Content Framework is a set of PeopleTools definitions and processes that enable developers and subject matter experts to link application pages with contextually relevant content. The primary goal of related content services is to provide immediate access to relevant, contextual information for any PeopleSoft transaction without requiring any additional user effort. PeopleSoft Related Content Framework acts as an enterprise mashup, tying together all types of content such as Oracle Business Intelligence Enterprise Edition (OBIEE) analytics, queries, discussion threads, documentation, and relevant non-PeopleSoft data into a single tool—PeopleSoft application pages.
You can use the related content framework to set up access to UPK modules and topics so that any UPK content is available at the page or component levels under the Related Content menu as shown here:
This table lists the necessary prerequisites for integrating UPK and related content and provides references to information about these prerequisites:
Prerequisite |
Reference |
Perform all related content configurations. |
See Prerequisites. |
Create, deploy, and configure UPK player package to your web server. |
See Oracle's PeopleSoft Enterprise Help Menu Integration See Oracle's User Productivity Kit In-Application Support Guide |
This section discusses how to:
Modify the UPK player package link.
Create the UPK-based service definition
Note. Your UPK content should already be installed on the web server and available to your users.
To create related content services for UPK modules, you must obtain the link to the UPK player package from your UPK administrator.
To modify the UPK player package link:
Contact your UPK system administrator to obtain the player package link (URL). It should look similar to this:
http://upkservername/upk/content_subject/toc.html
Change the file name toc.html to kp.html so that the URL looks similar to this:
http://upkservername/upk/content_subject/kp.html
The kp.html file lists your UPK modules and topics. Pointing directly to the kp.html file, which is located in the player package folder, enables you to manually link to a specific mode for a topic
Paste the link into your browser and access the file.
Find the topic. Right-click the Concept or Do It link associated with the topic. If you are creating task-oriented related content, right-click the Do It link; otherwise, click the Concept link.
From the pop-up menu, select Copy Shortcut.
Alternately, select Properties and then copy the URL that you see on the dialog box.
For conceptual information, the URL should look similar to this:
http://upkserver/upk/peopletools/tpc/0350d9a9-6013-4cc9-9022-016f815029ba/Parts/index.html
For task-oriented information, the URL should look similar to this:
http://upkserver/upk/peopletools/dhtml_kp.html?Guid=69f0376e-70fc-417c-a43c-ecd6afb72b29&Mode=D&Back
Note. If you see Mode=D, the link accesses
the topic in the Do It mode.
If you see Mode=K, the link accesses the topic
in the Know It mode.
If you see Mode=T, the link accesses the topic
in the Try It mode.
If you see Mode=S, the link accesses the topic
in the See It mode.
If you see index.html, the link accesses
the topic or module in the Concept mode.
If you are creating multiple service definitions, you might consider creating a spreadsheet that looks something like this table::
Topic |
URL |
Process Scheduler - Concept |
http://upkserver/upk/peopletools/tpc/0350d9a9-6013-4cc9-9022-016f815029ba/Parts/index.html |
Viewing Process Details - Do It |
http://upkserver/upk/peopletools/dhtml_kp.html?Guid=69f0376e-70fc-417c-a43c-ecd6afb72b29&Mode=D&Back |
For each task-oriented URL, remove the &Back at the end of the address.
Save your spreadsheet.
To create the UPK-based service definition:
Create a new related-content service definition.
Choose a naming convention that makes UPK service definitions easily identifiable, for example UPK_<service_definition_name>
Enter the service name and description.
Select Non-PeopleSoft URL as the URL type.
In the External URL field, enter the URL to your kp.html file.
It should look similar to this: http://myupksite.com/upk/mycontent/dhtml_kp.html?Guid=5cd5ba9f-c3a8-441f-923b-a8aca7e95b6e&Mode=D
Click the Test Related Content Service link.
The Test Related Content Service page opens.
On the Test Related Content Service page, click the Test Related Content Service link.
Click the Return button to go back to the Define Related Content Service page.
For conceptual information, select the New Window check box to give the administrator the ability to enable the new window functionality for the user.
In the Select security options group box, select the Public Access check box.
Click the Save button.
Note. UPK-based service definitions do not require additional parameters.
This completed service definition shows an external URL that accesses UPK content in Do It mode:
Note. You can use the Copy Service Definition button to clone this definition and save time creating new UPK-based service definitions.
See Also
Defining Non-PeopleSoft Related Content Services
To assign UPK-based services to pages and components:
Note. This section assumes that you are assigning the service to a content reference that currently has no service assignments.
Access the Manage Related Content Configuration page. (Select PeopleTools, Portal, Related Content Service, Manage Related Content Service.)
Click the Assign Related Content to Application Pages link.
Navigate the tree and select the content reference.
Select either the page or the component level.
Select Service as the service type.
Click the Service ID prompt and select the appropriate service.
Enter the service label. Select a label that is based on the context of the service. In addition, use direct language; for example, Show me how to submit a process is appropriate for a service on the Process Scheduler page.
Select the service target where you want the content to appear. Select one of these options:
Related Content for conceptual information.
New Window for all other UPK types.
Important! You must enable the UPK player to open in a new window. If you select other options, unexpected results might occur.
Click the Configure link.
The Related Content Service - Configure page appears.
In the Select Menu Type group box, select Related Content Menu.
Click the OK button.
Click the Save button.
Select the Configure Menus tab.
Configure the arrangement of links in the Related Content menu.
Configure the arrangement of services in the Related Content frame.
Click the Save button.
The Assign Related Content page appears.
Click the content reference link to test your configuration.
The completed service assignment presented here shows the component and page-level services and the menu configuration options:
Component-level UPK conceptual service assignment:
Page-level task-oriented service assignments:
Menu configuration options that order the services in the Related Content menu:
The following procedure shows how to access UPK-based related content.
Any page that displays the Related Content menu in the upper right area of the page provides the user with access to related content.
Select the Related Content menu.
Conceptual information links should appear in the Related Content Frame section of the contextual menu.
Task-oriented links should appear in the Open in New Window section of the contextual menu.
Click a link in the Open in New Window section. The UPK player should launch in a new window (or a new tab) and the UPK topic will open in its own window.
Click a link in the Related Content Frame section. The topic should open the lower frame and display the conceptual information.