+

Search Tips   |   Advanced Search

Add a JSP element to an item

We add a JSP element to a site area or content item when we want a section of JSP to be used for a specific site area or content item.

We can only add an element to a content item if the manage elements button has been enabled in the authoring template used by the content item.

  1. Open or create a site area or content item.

  2. Click Manage Elements .

  3. Select JSP as the element type.

  4. Enter a name. Do not use double-byte and non-ASCII characters.

  5. Enter a display title to use as the title of the element displayed indexes and forms.

  6. If we have created a text provider plug-in for a multi-locale site, we can also select the text provider and enter a key to look up a string from the selected text provider. The text provider displays a different display title for each language it has been configured for. The text entered in the Display Title field is only used if an appropriate display title is not available from the selected text provider, or if the text provider is not available.

  7. Click OK. The JSP element is added to the form.

  8. Go to the JSP element created:

    1. Enter the path to the JSP file. The path must begin with a forward slash. For example:

        /wps/customapplication;/jsp/jspFilename.jsp

      JSP files are stored within a web application that runs on the portal. To reference a JSP file in another web application, use the following path: contextPath;jspPath. For example: /wps/customapplication;/jsp/jspFilename.jsp.

      A dynamic context path value can be defined by adding a token to the context path that corresponds to a key and value pair to the WCM configuration service environment provider. When this key is used as the token in the jsp value field, it is replaced dynamically at render time. For example: [my.custom.key];myfile where my.custom.key is a constant within the WCM configuration service.

    2. Enter an error message to display when an incorrect JSP path is entered. A Java exception stack trace is displayed if there is syntax error.

  9. Save the item form.


Parent Use a JSP element