Skip Headers
Oracle® Fusion Middleware Administrator's Guide for Oracle Entitlements Server
11g Release 1 (11.1.1)

Part Number E14096-05
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Index
Index
Go to Master Index
Master Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
PDF · Mobi · ePub

10 Customizing the User Interface

This chapter explains several customizations you can make to Oracle Authorization Policy Manager, the Oracle Entitlements Server Administration Console. It contains the following sections:

10.1 Customizing Authorization Policy Manager

All customizations described in this chapter require modifying data in the following files:

$ORACLE_HOME$/apm/modules/oracle.security.apm_11.1.1/oracle.security.apm.ear
$ORACLE_HOME$/apm/modules/oracle.security.apm_
   11.1.1/oracle.security.apm.core.view.war

Customizations applied to a version of Authorization Policy Manager must be specified anew every time a new version of the tool is installed.

Tip:

Before you begin, it is recommended that you backup the Authorization Policy Manager EAR and WAR files listed above.

To customize Authorization Policy Manager, proceed as follows:

  1. Unzip the tool's EAR and WAR files, and the view WAR file, as illustrated by the following commands:

    $ unzip -d $tempDir/ear $ORACLE_HOME$/apm/modules/oracle.security.apm_
       11.1.1/oracle.security.apm.ear
    $ unzip -d $tempDir/war $tempDir/ear/oracle.security.apm.war
    $ unzip -d $tempDir/viewWar $ORACLE_HOME$/apm/modules/
       oracle.security.apm_11.1.1/oracle.security.apm.core.view.war
    
  2. Modify one or more unzipped files, as explained in the remaining sections of this chapter.

  3. Zip anew the tool's EAR and WAR files, and the view WAR file, as illustrated by the following commands:

    $ zip $tempDir/ear/oracle.security.apm.war $tempDir/war/*
    $ zip $ORACLE_HOME$/apm/modules/oracle.security.apm_
       11.1.1/oracle.security.apm.ear $tempDir/ear/*
    $ zip $ORACLE_HOME$/apm/modules/oracle.security.apm_
       11.1.1/oracle.security.apm.core.view.war $temp/viewWar/*
    
  4. Redeploy Authorization Policy Manager.

10.2 Customizing Headers, Footers, and Logo

To customize headers, footers, and logo, proceed as follows:

  1. Unzip the view WAR file. For details, see Customizing Authorization Policy Manager.

  2. Open for edit the file AuthPolicyMgr.jspx and apply any of the following modifications, as appropriate.

  3. To specify a new branding title, modify the branding facet as illustrated in the following snippet:

    <f:facet name="branding">
     <af:outputText value="My Custom Application Title" noWrap="true" id="ot1"/>
    </f:facet>
    
  4. To specify a new footer, modify the appAbout and appCopyright facets as illustrated in the following snippet:

    <f:facet name="appAbout">
    <af:outputText value="My Custom Footer at Right" noWrap="true" id="ot2"/>
    </f:facet>
    <f:facet name="appCopyright">
    <af:outputText value="My Custom Footer at Left"  noWrap="true" id="ot3"/>
    </f:facet>
    
  5. To specify a new logo image, proceed as follows:

    1. Insert your resource in the metaContainer facet as illustrated in the following snippet (leave all other content inside the facet as is):

      <f:facet name="metaContainer">
      .... 
      <af:resource type="css">
      .MyCustomBrandingLogo {
      background-image:url(/apm/images/world_36x20.png);
       background-position:center;
       background-repeat:no-repeat; display:block;
      height:2.5em; width:119px;
                 }
       </af:resource>
      ...
      </f:facet>
      
    2. Specify that style class name as the input attribute to the pageTemplate tag, as illustrated in the following snippet (leave all other content inside the tag as is):

      <af:pageTemplate viewId="/templates/IdmShell.jspx"
       value="#{bindings.pageTemplateBinding}" id="pt1">
      ...
      <f:attribute name="brandingLogoCls" value="MyCustomBrandingLogo"/>
      ...
      

10.3 Customizing Color Schemes

Assuming that you have a new skin available to customize the color scheme, proceed as follows:

  1. Unzip the tool's EAR and WAR files. For details, see Customizing Authorization Policy Manager.

  2. Open for edit the file Trinidad-config.xml, typically located in the folder WAR/WEB-INF.

  3. In that file, specify the value of the new skin in the skin-family tag, as illustrated in the following snippet:

    <trinidad-config xmlns="http://myfaces.apache.org/trinidad/config">
    ...
    <skin-family>MyCustomSkin</skin-family>
    ...
    </trinidad-config>
    

10.4 Customizing the Login Page

To customize the login page and login error page, proceed as follows:

  1. Unzip the tool's EAR file. For details, seeCustomizing Authorization Policy Manager.

  2. Open for edit the file web.xml, typically located in the folder EAR/WEB-INF.

  3. In that file, specify the appropriate values for the form-login-page and form-error-page, under the element form-login-config, as illustrated in the following snippet:

    <login-config>
    <form-login-config>
    <form-login-page>/MyCustomLoginPage.html</form-login-page>
    <form-error-page> MyCustomLoginErrorPage.html </form-error-page>
    </form-login-config>
    </login-config>