Lab B.1: Hello World

Goals

• Set up a development environment
• Create a JSP page
• Visit the page in the platform

Prerequisites

• Read the Application Architecture overview.

Overview of JSP Pages

A Java Server Page (JSP) is an HTML file that contains Java code. If no Java code happens to be present, then the "JSP" page contains nothing but HTML. (In the platform, they are called simply Pages, since they can be either HTML pages or JSP pages.)

The Many Uses of JSP Pages

Objects contain your data, but work with your data and interact with the platform using JSP Pages. In fact, the platform itself is mostly a giant collection of JSP Pages that you use to interact with the underlying database.

Once you know how to create JSP Pages, you will be able to do extensive front-end customization for your users:

By visiting the page URL

Every page has a URL of the form: https://{domain}/networking/pages/xyz.jsp

You link to that URL from anywhere. As long as the user is logged in, they can see the page.

(If they are not already logged in, the platform prompts them for their login credentials.)

As a Dashboard Widget

A JSP Page can be used as a Widget in a Dashboard (also known as the Home Page). There, it can display any data, graphics, or summary information needed to give your users up-to-the minute information.

As a Sidebar

A JSP Page can also be added to the Sidebar. Here, a custom Page was created that has graphic buttons for common operations in an Order Processing application:

File:OrderProcessing sidebar.png

As a Web Tab

In the normal course of events, the platform Workspace shows the high-level objects the user will interact with. Clicking on one opens a Web Tab that displays the object.

You can also use a JSP Page as a Web Tab. When you do, it appears as an entry in the Workspace. And when the user clicks on it, the Page opens as a platform tab.

In a Site

For a Custom Form

As a Custom Lookup

JSP Basics

The are only a few patterns you need to know to do some serious work with JSP pages:

• <% … code … %> -- execute some code
• <%= variable %> -- insert data into the HTML stream

Conditional display of HTML	Loops for repeated HTML
<% if (…) { %>   ... HTML ... <% } %>	<% for (item:List) { %>   ... HTML ... <% } %>

Exercise

Set up a development environment

1. In the navigation pane, click Setup.
2. If you don't see an entry called Develop, then:
   • Set up Developer Privileges
   • Log in again

Create a JSP Page

1. Click Designer > Pages > [New Page]

Note: If this is the first development activity to occur, you may see an error message like the following at the top of the screen: To create a new class, page, or execute Java code in Data Policies, namespace needs to be set in Company Information. Click here ... The link takes you to the Developer Configuration page, where you can specify your organization's namespace--typically, the company name or an abbreviation of it that corresponds to the company URL. (The lab exercises use "demo".)

2. Enter the page name: HelloWorld.jsp
   Note: It is necessary to add the .jsp extension when specifying the page name.
3. Add content for the page:

   <h1 align="center">Hello World!</h1>
   

4. Click [Save]

Visit the page to confirm that it exists

• In your web browser, visit https://{platform}/networking/pages/HelloWorld.jsp, substituting your platform URL for "{platform}".

The page you created appears.

Next

Lab B.2: Simple Interaction