Oracle9iAS Portal Developer Kit
How to Build an ASP Portlet Using the PDK

PDK Release 2 (9.0.2 and later)

Once you have successfully installed and deployed the PDK, you may want to begin building ASP portlets of your own. The PDK enables you to create URL-based portlets that display content from ASP pages.

This article describes how to build a basic ASP portlet.

### ASSUMPTIONS

1. You have already gone over how to build a URL-based portlet by following the article, How to Build a URL-Based Portlet.

2. You have installed Microsoft Internet Information server (IIS) and can use IIS to display ASP pages through URLs.

### BUILDING AN ASP PAGE

Before building an ASP portlet, you must first build your own ASP page. You can follow these steps to get started.

1. Write a simple ASP that displays a welcome greeting, along with the time. You may write your own or use the sample provided.

   > <%@ Language=VBScript %> <html> <head> <title>SAMPLE ASP</title> </head> <body> <center><B><U><font size="5" font color= black> <%FirstVar = "Welcome to the PDK Integration ASP Portlet!"%> <%=FirstVar%></U></B></FONT> </center><br> <CENTER><blink><b><%IF Hour(time)>18 OR Hour(time)<4 THEN%> Good Night Everyone. <%ELSE%> Good Morning Everyone. <%END IF%></blink></b></CENTER> <% FirstVar = "Hello world!" %><Br> <CENTER><b>The time is: <%=time%></b></CENTER><BR><BR> </body> </html>

2. Save this file as myfirstaspportlet.asp.

3. Copy the file to your ASP directory for Internet Information Server. Make sure it is possible to display the ASP in the browser. For example: http://<yourservername:port>/aspdirectory/myfirstaspportlet.asp

### BUILDING THE ASP PORTLET

At this point, you are ready to build your ASP portlet. The steps required to build the ASP portlet are the same steps as those described in the article, How to Build a URL-Based Portlet. Proceed by following all of the steps in that article, using http://<yourservername:port>/aspdirectory/myfirstaspportlet.asp for the value of the pageUrl tag in the provider.xml file. You should then be able to deploy and register your ASP portlet in the exact same manner as the Google.com portlet described in the How to Build a URL-Based Portlet article.

### NEXT STEPS

The following articles show you how to enhance the user interface of a URL-based portlet:

- How to Build a URL-Based Portlet that Uses HTML Filtering
- How to Build a URL-Based Portlet with Inline Rendering of Portlet Links

The following articles show you how to enhance the security of a URL-based portlet:

- How to Build a URL-Based Portlet with Single Sign-On to an External Application
- How to Build a URL-Based Portlet with Single Sign-On to an Application Using Basic Authentication

Revision History:

- February 2002

- June 2002