Customizing the error page

Customize the text on the error page in IBM® Connections.

About this task

You can change the text that is displayed on the IBM® Connections error page to more closely reflect what users should do when they run into a problem. For example, you might want to replace the phrase "Contact your administrator" with details about who to contact, including an email address or other contact information.

Procedure

  1. Optional: Turn on the customization debugging capability. For more information, see Enabling live user interface customization editing mode.
  2. Copy the error.jsp file from the WAR file of one of the applications. You can access the file from the following directory:
    WAS_HOME/profiles/profile_name/installedApps/cell_name/application_name.ear/application_name.war/nav/templates
    Where:
    • WAS_HOME is the directory where IBM® WebSphere® Application Server is installed.
    • profile_name is the profile where you installed IBM® Connections.
    • cell_name is the cell where you installed the application.
    • application_name.ear is the name of the application EAR file. To customize interface styles that are common to all applications, use the Common.ear file.
    • application_name.war is the name of the application WAR file.
      Tip: For a list of the web application source directories that are packaged with IBM® Connections, see Application WAR files and OSGi bundles.
    • version is the version number of the IBM® Connections release plus the date and build number of the JAR file.

    The error.jsp file is the same for each application. You only need to make a copy of one instance of the file.

  3. Paste the file into the appropriate subdirectory in the customization directory, which is most likely the common directory. See Determining where to save your customizations for more details.
    For example, to use the same error page in all the applications, copy the file into the following directory:
    customizationDir/common/nav/templates
    If you want to create an application-specific error page, copy the file into the following directory:
    customizationDir/application_name/nav/templates
  4. Open the copied error.jsp file in an editor and make your changes.
    For example, you might want to change the generic text in the message that says "Contact your administrator" to provide a more meaningful message for your organization, such as "Add a ticket in the Acme IT Support Database <link>" or “Copy the following error information and email it to lcadmin@mycompany.com." To do so, look for the following block of HTML:
    <p id="lconnErrorDetails" style="display:none;" class="lconnErrorDetails">
      <label for="lconnErrorText">
       <fmt:message key="error.details.info" />
      </label>
      <textarea id="lconnErrorText" readonly="readonly" class="lotusText" wrap="off">
      </textarea>
    </p>
    Replace the <fmt:message> element with the text that you want to have displayed in the message box. For example:
    <p id="lconnErrorDetails" style="display:none;" class="lconnErrorDetails">
      <label for="lconnErrorText">
       Copy the following error information and email it to 
        <a href="mailto:lcadmin@mycompany.com">lcadmin@mycompany.com</a>.
      </label>
      <textarea id="lconnErrorText" readonly="readonly" class="lotusText" wrap="off">
      </textarea>
    </p>
  5. Save and close the error.jsp file.
  6. To test your changes, refresh the web browser, and then perform an action that will generate an error message.
  7. Optional: If you enabled custom debugging, turn off the debugging capability when you are ready to publish your changes. For more information, see Enabling live user interface customization editing mode.
  8. See Post-customization step for information about how to apply your changes permanently.