Customizing Oracle E-Business Suite Login Page in R12.2.5 or higher
In one of previous posts, I had shown how to change the Corporate Branding in an Oracle E-Business Suite instance. In this post, let us see how we can customize Oracle E-Business Suite Login Page. Up until R12.2.4, the login page was an Oracle Application Framework page. Hence administrators were able to personalize the login page, provided the profile option “FND: Personalization Region Link Enabled” was enabled. However, R12.2.5 onwards, the login page has changed to a Lightweight Login Page. The Lightweight Login page consists of 4 basic components:
- AppsLocalLogin.jsp
- login.css
- login.js
- LoginService
The login page style and behaviour can be customized by creating the files “custom-login.css” and “custom-login.js” files and placing these files under the OA_HTML directory in the application tier. Please note that it is recommended not to modify the files AppsLocalLogin.jsp, login.css, or login.js, as the customizations will get overwritten by patch applications.
Here, we will see a few basic examples to customize the Login page.
1. Changing Login Page Background
Login to putty using ‘oracle’ user and initialize to the ‘Run’ file system.
[oracle@apps ~]$ . /u01/install/APPS/EBSapps.env run
Note down the path for OA_MEDIA.
[oracle@apps ~]$ echo $OA_MEDIA /u01/install/APPS/fs1/EBSapps/comn/java/classes/oracle/apps/media
Transfer the image in this path, in my case which is login.png.
[oracle@apps ~]$ cd $OA_MEDIA [oracle@apps media]$ ls -lrt login.png -rw-r--r-- 1 oracle oinstall 533676 Mar 4 15:34 login.png
Next, note down the path for OA_HTML directory.
[oracle@apps ~]$ echo $OA_HTML /u01/install/APPS/fs1/FMW_Home/Oracle_EBS-app1/applications/oacore/html
Create a css file called ‘custom-login.css’ and add the following. Note that you should not amend the login.css or login.js file in the OA_HTML directory.
body {
height: 100%;
background-repeat: no-repeat;
background-attachment: fixed;
background-position: center;
background-image: url("/OA_HTML/media/login.png");
background-size: cover;
}
Transfer the custom-login.css file to the OA_MEDIA directory.
[oracle@apps ~]$ cd $OA_HTML [oracle@apps html]$ ls -lrt custom-login.css -rw-r--r-- 1 oracle oinstall 329 Mar 4 15:55 custom-login.css
Clear the browser cache and voila!!!
Note that you can customize the login page as per your need. Say for example, you do not need a background image and just want to change the background colour. In that case, just change the costom-login.css page accordingly.
2. Changing Login Page Prompts/Text attributes
In this section, we will see how we can change the login prompts/text attributes. For example, we want to change the default prompt from “User Name” to “Account Name”.
This can be done very easily by customizing the seeded messages. To change the text attribute, perform the steps below:
- Login to Oracle E-Business Suite with any user having “Application Developer” Responsibility.
- Open “Messages” using the navigation given below:
Navigation: Application Developer > Application > Messages
- Change the “Current Message Text” from “User Name” to “Account Name” and Save.
- Bounce OACore using the commands below. Enter weblogic password when prompted.
[oracle@apps html]$ admanagedsrvctl.sh stop oacore_server1 [oracle@apps html]$ admanagedsrvctl.sh start oacore_server1
- Clear Browser Cache and the changes would be visible.
The following text prompts are available to be changed.
| Sl. No | Message | Default Value |
|---|---|---|
| 1 | FND_SSO_USER_NAME | User Name |
| 2 | FND_SSO_PASSWORD | Password |
| 3 | FND_SSO_FORGOT_PASSWORD | Login Assistance |
| 4 | FND_SSO_REGISTER_HERE | Register Here |
| 5 | FND_SSO_NOTSAME_USER | Not &USER? Log Out |
| 6 | FND_SSO_LOGIN | Log In |
| 7 | FND_SSO_CANCEL | Cancel |
| 8 | FND_SSO_ACCESSIBILITY | Accessibility |
| 9 | FND_SSO_LANGUAGE | Language |
| 10 | FND_COPYRIGHT | Copyright (c) 1998, 2017, Oracle and/or its affiliates. All rights reserved |
Following screenshot shows the different components as per the table above:
3. Suppress Text attributes from Login page:
If you have requirements to hide some regions from the Login page, you can do so by changing the profile option “Local Login Hide Items”.
Each element in the login page is identified by its DOM object ID or the message the elements display. The following table shows the elements and their corresponding identifiers.
| Element | Identifier |
|---|---|
| Register Here | RegisterHereURL |
| Copyright | CopyrightBox |
| Forgot Password | ForgotPasswordURL |
| Accessibility | AccessibilityBox |
| Language | LanguagePickerBox |
You can also find the values by inspecting the elements in your web browser.
The value of the profile option should be a comma-separated value of the identifiers that you want to hide from the Login Page. Each element should be preceded by a ‘#’ or pound sign.
For example, if I want to hide the elements “Login Assistance”, “Register Here”, “Accesibility” and “Language”, then the value of the profile option should be:
#ForgotPasswordURL, #RegisterHereURL, #AccessibilityBox, #LanguagePickerBox
Clear the Cache from Functional Administrator and bring up the login page. The elements will be hidden.
4. Adding a Custom Disclaimer
If you want to add a Disclaimer in the page, then you can create a custom-login.js page and source it in the OA_HTML directory.
For example, I want to display a disclaimer showing the instance name and the cloned date for an EBS instance. To do that, I will create a file called custom-login.js file in OA_HTML directory and add the following:
document.afterLoad=function()
{
var e = document.getElementById('CopyrightBox');
e.innerHTML="<p style='font-size: 1.5em; color: red' ><b>Instance: EBSDB, Cloned from Prod on 07-MAR-2022</b></p> ";
}
Delete the browser cache and reload the login page for the changes to take effect.
Above are a few examples of how you can customize the login page for Oracle E-Business Suite in R12.25 and above. Hope this helps.
References
RishOraDev's Oracle Blogs 