customizing oracle identity governance : creating a home ... › webfolder › technetwork ›...

Copyright © Oracle, 2013.. All rights reserved.

Customizing Oracle Identity Governance : Creating a Home Page Portlet

of 19

Customizing Oracle Identity Governance: Creating a Home Page Portlet



of 19

Customizing Oracle Identity Governance: Creating a Home Page Portlet

Overview

A Home Page Portlet is a panel that can be added to the Home Page in the Self Service Console. Oracle Identity Governance comes with several portlets, and additional portlets can be developed to meet specific business requirements.

In this example, we develop a "System News" portlet that displays a message relevant to users logging into Oracle Identity Governance.

Creating a Home Page portlet requires:

creating a bounded task flow using ADF

deploying the ADF library containing the taskflow to Oracle Identity Governance

adding the portlet to the home page

Pre-requisites Before starting this tutorial, you should have completed the tutorial titled "Customizing Oracle Identity Governance: Configuring JDeveloper".

As a result you would have created an ADF ViewController project in JDeveloper

The name of the project used in this example is "System News".

https://apex.oracle.com/pls/apex/f?p=44785:24:6328409857573::NO:24:P24_CONTENT_ID%2CP24_PREV_PAGE:8595%2C16




of 19

Step 1: Create the bounded task flow using ADF

1. Create a bounded task flow in the project. To do this:

a. Right click on Page Flows, and select New.

b. In the left pane of the New Gallery dialog, select the Web Tier > JSF node. In the right pane, select ADF Task Flow and click OK.



of 19

A Create Task Flow dialog is displayed.

c. Use the table below to populate the fields, and click OK.

Field Name Field Value Comment

File Name system-news-tf.xml

Create as Bounded Task Flow

[SELECTED]

Task Flow ID system-news-tf This field is automatically populated to be the File Name, less the .xml suffix.

Use the image below as a guide.



of 19

A new blank design pane is displayed. This is where the bounded task flow will be developed.

2. Drag the View component from the Component Palette to the design pane.

This adds a View1 view component to the design pane.

3. Double-click the View1 component.



of 19

4. Ensure that Quick Start Layout is selected, and click Browse.

5. Select the "One Column Header (Stretched)" layout, and click OK.



of 19

6. Expand the Page Implentation section and verify that "Automatically Expose UI Components in a New Managed Bean" is selected. Click OK.



of 19

The JSF page is displayed in a new tab in the design pane.

7. Drag the Panel Group Layout component into the center of the JSF page.



of 19

8. Ensure that the af:panelGroupLayout node is selected in the "view1.jsff - Structure" pane.

9. In the "Panel Group Layout - Property Inspector" pane, select "scroll" for the Layout drop-down.



of 19

10. Drag the "Output Text (Active)" component from the Component Palette to the "Panel Group Layout - scroll" region in the design pane.

11. In the "activeOutputText1 - Property Inspector" pane, change the value of the Value field to :

System News for Example Corp. This contains information about

changes to the Example Corp Identity Management System.

Press Enter to make the change active. Use the image below as a guide.



of 19

The text in the design pane is updated.

12. Drag the Output Text component from the Component Palette to the "top" region of the design pane.

13. In the "Output Text - Property Inspector" pane, update the properties for the output text component using the following table:

Field Name Field Value

Value System News

Size large

Horizontal Align center

Use the image below as a guide.



of 19

The text in the design pane is updated.

14. Click Save All to save all items in the project.



of 19

You have created a bounded task flow in ADF. Next, you build and deploy the ADF library containing the task flow to Oracle Identity Governance.



of 19

Step 2: Build and deploy the ADF library

The steps in this section reference the tutorial titled "Customizing Oracle Identity Governance: Configuring JDeveloper”

1. Following the steps in the tutorial, build the ADF library file.

2. Before repackaging the oracle.iam.ui.custom.dev-starter-pack.war file, edit

the oracle/adf/rc/metadata/custom-catalog.xml file. Add a new XML stanza in

between the top-level <content> tags:

<folder name="Sample Folder" id="sampleFolder">

<contents>

<resource id="systemNews" name="System News"

description="System News"

repository="application.classpath"

path="adflibSystemNews1.jar/ADF_TaskFlow/WEB-

INF+system-news-tf.xml#system-news-tf"/>

</contents>

</folder>

This stanza tells Oracle Identity Manager that the new taskflow is available for selection as a Home Page Portlet.

3. Package the oracle.iam.ui.custom.dev-starter-pack.war file and deploy it to

Oracle Identity Governance.

4. Using the Oracle Entitlements Server console, edit the authorization policies to add permissions for this new task flow.

a. If you have not previously created a resource type, create a resource type called "ADF Taskflows" to hold the new System News Portlet resource.

b. Create the Resource using the Name value:

/WEB-INF/system-news-tf.xml#system-news-tf

c. When updating the "Policy for authenticated role" policy, add a resource target for the System News Portlet.





of 19

d. Grant the "view" permission to the resource.



of 19

Don't forget to click Apply!

You have built and deployed the ADF library to Oracle Identity Governance. Next, you verify that you can add the portlet to the Home Page in the Oracle Identity Governance Self Service console.



of 19

Step 3: Adding the portlet to the Home Page

1. Open a web browser and sign in to the Identity Self Service console.

2. Click the Home link.

3. Click Personalize.

4. Click Add Content.



of 19

5. Click Sample Folder

6. Click Add, to add the System News portlet to the Home Page.

7. Click Close to close the Add Content dialog.



of 19

8. Click Close to exit the Personalization page.

The updated Home Page is displayed.

You have added the System News portlet to the Home Page.

customizing oracle identity governance : creating a home ... › webfolder › technetwork ›...

Documents