Creating Info*Engine JSP Pages
Each Info*Engine JSP page should contain the following items:
• The standard JSP page directive, which defines the general page characteristics.
• The standard JSP taglib directive, which identifies a tag library containing Info*Engine custom tags.
You must put this directive before any lines that use the custom tags in the library.
• Info*Engine custom tags, which provide access to a set of custom actions that encapsulate recurring functionality.
The custom tags provide the syntax for executing webjects and provide the structure around which you can build a JSP.
To be well-formed and valid, the Info*Engine JSP pages must follow basic JSP rules:
• For Info*Engine custom tags and JSP tags, you must use lowercase. For example, you must specify the webject tag as “webject” and not “WEBJECT” or “Webject” or even “webJecT”.
• You can use comments to document what is happening in your page or to cause the compiler to skip a section of the page. If a webject is surrounded by a comment, it is not executed. Comments can be located anywhere in a task except within tags, declarations, or other comments.
Comments begin with <!-- and end with -->.
• Empty elements must be properly constructed. The trailing /> characters (the forward slash followed by the right angle bracket) in the JSP syntax indicates that the element is empty and no matching end tag should be sought. For example, the param custom tags make use of the empty element construction.
• Additional general rules for using scriptlets, expressions, declarations, directives, and Info*Engine custom tag elements can be found in the
Info*Engine Custom Tag Reference.
The example DisplayTable.jsp page includes the following standard JSP directives:
• IEError.jsp as the standard page directive. It contains a reference to the example error page:
<%@page language="java" session="false"
errorPage="IEError.jsp"%>
• The ie prefix as the required prefix. The prefix identifies the tag as belonging to the core tag library, which provides the general custom tags that can be used in a JSP page:
<%@ taglib uri="http://www.ptc.com/infoengine/taglib/core"
prefix="ie" %>
The previous DisplayTable.jsp page also includes the webject and param custom tags:
• The webject tags identify the Create-Group and Display-Table webjects.
• The param tags supply webject parameters and parameter values.
For the Create-Group webject, the parameters define the name of the output group and the attributes and values of elements in the group.
An Info*Engine JSP page can also contain any supported HTML and JSP tag. This guide does not describe the HTML and JSP tags that you can use. To review the supported tags, you can access the following sites: