3 Preparing Your Development Environment

This chapter discusses tasks you may need to perform to set up your development environment.

Tip:

If you are just getting started, we recommend that you look at Section 1.1, "WebCenter Portal Developer's FAQ" first.

This chapter includes the following sections:

• Section 3.1, "Installing Oracle JDeveloper"

• Section 3.2, "Installing WebCenter Portal's Extension for Oracle JDeveloper"

• Section 3.3, "Setting the User Home Directory Environment Variable"

• Section 3.4, "Working with the Integrated WebLogic Server"

• Section 3.5, "Installing Database Schemas"

• Section 3.6, "Installing the Oracle WebCenter Adapter for SharePoint"

3.1 Installing Oracle JDeveloper

Oracle JDeveloper provides an integrated development environment for developing WebCenter Portal: Framework applications. For information on obtaining and installing Oracle JDeveloper, see the Oracle JDeveloper page on OTN at:

http://www.oracle.com/technetwork/developer-tools/jdev/overview/index.html

3.2 Installing WebCenter Portal's Extension for Oracle JDeveloper

Before you can begin to develop Framework applications, you need to install the WebCenter Portal's extension for Oracle JDeveloper. The WebCenter Portal extension is a JDeveloper add-in that provides the complete set of WebCenter capabilities and features to the JDeveloper Studio Edition.

To install the WebCenter Portal extension:

1. Start Oracle JDeveloper.

2. If the Select Default Roles dialog displays, select Default Role to enable all technologies, and click OK.

3. If a dialog opens asking if you want to migrate settings from an earlier version, click No.

4. From the Help menu, select Check for Updates.

5. Click Next in the Welcome page of the Check for Updates wizard.

6. On the Source page, under Search Update Centers, search for the WebCenter Portal extension, select it, then click Finish.

7. When prompted, restart JDeveloper.

JDeveloper is now configured to create WebCenter Portal: Framework and Portlet Producer applications.

For more information on obtaining and installing Oracle WebCenter Portal: Framework, see the Oracle WebCenter Portal page on OTN at:

http://webcenter.oracle.com

3.3 Setting the User Home Directory Environment Variable

Oracle strongly recommends that you set an environment variable for the user home directory that is referenced by JDeveloper. By setting this variable, you can avoid receiving long pathname errors that are known to occur in some circumstances.

For detailed instructions on setting this variable on Windows, Linux, UNIX, and Mac OS X operating systems, see "Setting the User Home Directory" in the Oracle Fusion Middleware Installation Guide for Oracle JDeveloper.

3.4 Working with the Integrated WebLogic Server

Installation of Oracle WebCenter Portal: Framework reconfigures the Integrated WebLogic Server (WLS) domain in JDeveloper to include additional libraries and several prebuilt portlets. This section discusses the Integrated WLS, including how to start and stop it, and describes some of the preconfigured portlet producers and prebuilt portlets it provides. It contains the following subsections:

• Section 3.4.1, "How to Start and Stop Integrated WLS"

• Section 3.4.2, "What You May Need to Know About Integrated WLS"

• Section 3.4.3, "The WebCenter Preconfigured Server Readme File"

• Section 3.4.4, "What You May Need to Know About Preconfigured Portlet Producers"

3.4.1 How to Start and Stop Integrated WLS

Options for starting Integrated WLS are available in the Run menu in Oracle JDeveloper.

• To start Integrated WLS in debug mode, select Debug Server Instance from the Run menu.

  Running the service in debug mode helps in debugging the service.

• To start Integrated WLS in the regular mode, select Start Server Instance from the Run menu.

There are a couple of ways to determine if Integrated WLS is running and to stop it.

• The Terminate menu shows you a list of running server(s) and the deployed application(s), if any. (Figure 3-1). To stop a server (or to undeploy an application) select it from this menu.

  Figure 3-1 The Terminate Menu Shows What Is Running

  
  Description of "Figure 3-1 The Terminate Menu Shows What Is Running"
  
  

• Select Terminate from the Run menu, and select the server to stop it.

• Access the Integrated WLS console from a browser:

  http://localhost:7101/console
  

Note:

Sometimes WebLogic Server is not accessible (for example, if a user tries to restart WebLogic Server too quickly, before it has successfully shut down). In this case, you may have to manually shut down or stop the Java process.

3.4.2 What You May Need to Know About Integrated WLS

Integrated WebLogic Server (Integrated WLS) is a preconfigured WebLogic Server that provides a complete Java 2 Enterprise Edition (Java EE) 1.4-compliant environment. It is written entirely in Java and executes on the Java Virtual Machine (JVM) of the standard Java Development Kit (JDK). You can run WebLogic Server on the standard JDK provided with your operating system or the one provided with Oracle JDeveloper.

You can use Integrated WLS as a platform for pretesting Framework application deployments on your local computer by establishing an application server connection to it from Oracle JDeveloper. When you run the application in Integrated WLS, it is actually deployed as if you were deploying it to a WebLogic Server instance in an application server. For more information about Integrated WLS, see Section 69.3, "Deploying a Framework Application to a WebLogic Managed Server."

Note:

You can specify the Java Virtual Machine (JVM) settings for a Framework application running on the Integrated WLS in the setDomainEnv.sh script located here:

JDEV_SYSTEM_DIRECTORY/DefaultDomain/bin/

The default memory values are:

-Xmx512m -XX:PermSize=128m -XX:MaxPermSize=512m

When creating or referring to the JDEV_SYSTEM_DIRECTORY, keep in mind that, on a Windows platform, a WebCenter domain name cannot contain spaces, and the domain cannot be created in a folder that has a space in its path. Also, pages in Framework application are not rendered if there is a space in the path to the system directory in Oracle JDeveloper. Therefore, ensure that DOMAIN_HOME and JDEV_SYSTEM_DIRECTORY paths do not contain spaces.

3.4.3 The WebCenter Preconfigured Server Readme File

The WebCenter Preconfigured Server Read Me file contains valuable information about how to use Integrated WLS. Additionally, it contains links to the preconfigured portlet producers. You can access the Preconfigured Server Read Me file by selecting WebCenter Preconfigured Server Readme from the Oracle JDeveloper Help menu.

3.4.4 What You May Need to Know About Preconfigured Portlet Producers

The WebCenter preconfigured server provides a variety of ready-to-use portlets that you can add to your application pages. Simply register the producers contained in the default server with your Framework application, and then select the producers' portlets from Oracle JDeveloper's Application Resources panel.

This section provides a brief description of the preconfigured producers and some of the portlets they provide. It contains the following subsections:

• Section 3.4.4.1, "OmniPortlet and Web Clipping"

• Section 3.4.4.2, "The WSRP Sample Portlet Producers and Portlets"

• Section 3.4.4.3, "The PDK-Java Sample Portlet Producer and Portlets"

For information about registering portlet producers and adding portlets to pages, see Chapter 62, "Consuming Portlets."

3.4.4.1 OmniPortlet and Web Clipping

The Integrated WLS contains PortalTools, which provides access to the design time at runtime OmniPortlet and Web Clipping portlet. Design time at runtime means that users define portlet content after the portlet is placed on an application page and the page is run.

To access the OmniPortlet and Web Clipping portlet producers:

1. Start the Integrated WLS (see Section 3.4.1).

2. From the Help menu, select WebCenter Preconfigured Server Readme.

3. In the Readme file, go to the heading Preconfigured Portlet Producers, and click the PortalTools Welcome Page link under PortalTools Portlet Producers.

   This opens the PortalTools Welcome page.

4. On the PortalTools Welcome page, copy the URL of the Web Clipping Producer link, the OmniPortlet Producer link or the Sample Portlet Producer link, and use it as the producer URL in the Oracle PDK-Java Portlet Producer Registration Wizard.

   Note:

   For information about registering a portlet producer, see Chapter 62, "Consuming Portlets."

Once you have registered a producer, its portlets become available on Oracle JDeveloper's Application Resources panel. In the Application Resources panel, under the Connections node, select a producer name to list its portlets, then drag a portlet onto a Framework application page. (For information about adding portlets to pages, see Section 62.6, "Adding Portlets to a Page.")

The PortalTools Welcome page contains the following producer URLs:

• The Web Clipping producer provides the Web Clipping portlet, which is a browser-based declarative tool that enables dynamic reuse of content from another web source. When the source changes, the content in the Web Clipping portlet also changes. With the Web Clipping portlet, you use a web browser to navigate to the web page that contains the desired content. Using Web Clipping Studio, which is accessed through the portlet, drill down through a visual rendering of the target page to choose the desired content. For detailed information about the Web Clipping portlet, see Chapter 64, "Creating Content-Based Portlets with Web Clipping."

  Note:

  The Web Clipping portlet is deprecated in Release 11g (11.1.1.7.0). Consider using a clipper pagelet using Oracle WebCenter Portal's Pagelet Producer. For more information, see the "Managing Oracle WebCenter Portal's Pagelet Producer" chapter in the Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter Portal.

• The OmniPortlet producer provides OmniPortlet, which is a declarative portlet-building tool that enables you to build portlets against a variety of data sources, including XML files, character-separated value files (for example, spreadsheets), web services, databases, web pages, and SAP data sources. OmniPortlet users can also choose a prebuilt layout for the data. Prebuilt layouts include tabular, news, bullet, form, chart, or HTML. For information about OmniPortlet, see Chapter 63, "Creating Portlets with OmniPortlet."

• The Sample Portlet Producer is useful for illustrating the potential of an OmniPortlet. The sample producer is for demonstration and should not be used to create real-use portlet instances.

3.4.4.2 The WSRP Sample Portlet Producers and Portlets

The Integrated WLS includes sample WSRP portlet producers and portlets you can use with your application.

Note:

You can find the source code for the sample portlets is in the following EAR file:

JDEV_HOME/jdeveloper/webcenter/modules/oracle.portlet.server_11.1.1/wsrp-samples.ear

where JDEV_HOME is the location where JDeveloper is installed on your machine.

To access WSRP sample portlet producers:

1. Start Integrated WLS (see Section 3.4.1).

2. From the Help menu, select WebCenter Preconfigured Server Readme.

3. In the Readme file, go to the heading Preconfigured Portlet Producers, and click the link for the WSRP Tools Portlet Producer or Sample Portlet Producer under WSRP Portlet Producers.

   Both links open different WSRP Producer Test Pages—one that has Parameter Form and Parameter Display portlets, the other for different WSRP producer versions of sample portlets.

4. Copy the Web Services Description Language (WSDL) URL for a WSRP producer—either WSRP v1 WSDL or WSRP v2 WSDL.

   Use the copied link as the producer URL in the WSRP Producer Registration Wizard.

   Note:

   For information about registering a portlet producer, see Chapter 62, "Consuming Portlets."

Depending on where the portlet producer connection was registered, its portlets appear either under Application Resources or in the Resource Palette. From here, you can drag and drop a variety of sample portlets onto your Framework application pages.

3.4.4.3 The PDK-Java Sample Portlet Producer and Portlets

The Integrated WLS includes sample PDK-Java portlet producers and portlets you can use with your application. Use the PDK-Java sample portlets to familiarize yourself with the types of functionality that are available through PDK-Java portlets.

To access PDK-Java sample portlet producers:

1. Start Integrated WLS (see Section 3.4.1).

2. From the Help menu, select WebCenter Preconfigured Server Readme.

3. In the Readme file, go to the heading Preconfigured Portlet Producers, and copy the link location for the PDK-Java Sample Producer or PDK-Java Struts Sample Producer link under PDK-Java Portlet producers.

   Use the copied link as the producer URL in the Oracle PDK-Java Portlet Producer Registration Wizard.

   Note:

   For information about registering a portlet producer, see Chapter 62, "Consuming Portlets.".

Depending on where the portlet producer connection was registered, its portlets appear either under Application Resources or in the Resource Palette. From here, you can drag and drop a variety of sample portlets onto your Framework application pages.

3.5 Installing Database Schemas

To use certain Oracle WebCenter Portal components, you must install schemas into a supported database. This section discusses the schema installation for Oracle, SQL Server, and DB2 databases.

For information on which databases that WebCenter supports, see the document "Oracle Fusion Middleware Supported System Configurations" on OTN.

Table 3-1 lists the schemas that are used with WebCenter and the methods by which you can install them. The Repository Creation Utility (RCU) is the recommended approach for all the schemas. However, for WebCenter Portal's schema, you have the option of installing with a SQL script, as explained below.

Table 3-1 Database Schema Summary

Schema	Description	Installation Method
WebCenter	To use the Tag, Links, Lists, Polls, and People Connections services, you must have WebCenter Portal's schema installed in your database.	RCU (preferred) SQL script (On Oracle databases only. See below for details.)
Portlets	For storing customizations in portlet producers.	RCU only
Activities	For Activity Graph and Analytics products.	RCU only
Discussions/WebCenter Portal Discussions Crawler	Used as the back end for the Discussions and Announcements services.	RCU only

3.5.1 Installing Schemas With RCU

Oracle recommends that you use RCU to install all WebCenter database schemas. For detailed information, see "Creating Schemas" in the Oracle Fusion Middleware Repository Creation Utility User's Guide.

3.5.2 Installing WebCenter Portal's Schema with a SQL Script

To use the Tag, Links, and People Connections services, you must have the WebCenter Portal schema installed in your database. You can do this by using the built-in SQL Worksheet utility that you used in the previous step.

To install the WebCenter Portal schema:

1. From the Tools menu, select SQL Worksheet.

2. In the Select Connection dialog, click the pencil icon to edit the connection.

3. Modify the connection to use an administrator username and password, such as SYS (using the SYSDBA role) then click OK.

4. Click OK to close the Select Connection dialog.

5. From the Tools menu, choose SQL Worksheet.

6. Enter the following SQL statement in the SQL Worksheet panel:

   @@JDEV_HOME/jdeveloper/jdev/extensions/oracle.webcenter.install/sql/oracle/wc_schema.sql
   

   where JDEV_HOME is the location where JDeveloper is installed on your machine.

7. Click the Execute Statement icon, or press F9, to run the script.

8. At the prompt, enter webcenter as the name for the schema and a password for the schema, such as welcome1. The name of the schema must be webcenter.

9. If prompted for the Default Tablespace and Temporary Tablespaces, re-enter the default values users and temp, then accept them.

3.6 Installing the Oracle WebCenter Adapter for SharePoint

Before you configure the Oracle WebCenter Portal adapter for SharePoint as described in Section 26.2.3, "How to Create a Content Repository Connection Based on the Oracle WebCenter Adapter for SharePoint," you must install it in JDeveloper.

The adapter files are located in the Oracle WebCenter Portal Companion DVD in the ofm_wc_generic_jcr_sharepoint_adapter_11.1.1.4.0.zip file. When you extract this ZIP file to a temporary location, you will find the adapter files in the TEMP_LOCATION/WebCenter/services/content/adapters directory.

To install the adapter:

1. Start Oracle JDeveloper, if it is not already running.

2. From the Help menu, select Check for Updates.

3. Click Next in the Welcome page of the Check for Updates wizard.

4. On the Source page, select Install From Local File, then select oracle.webcenter.content.jcr.sharepoint.ear from the TEMP_LOCATION/WebCenter/services/content/adapters directory. This is the temporary directory in which you extracted the contents of the ofm_wc_generic_jcr_sharepoint_adapter_11.1.1.4.0.zip file from Oracle WebCenter Portal Companion DVD.

5. Click Finish. When prompted, restart JDeveloper.