Skip Headers
Oracle® Fusion Middleware Developer's Guide for Oracle WebCenter Portal (Oracle Fusion Applications Edition)
11g Release 1 (11.1.1.6.3)

Part Number E25595-02
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Index
Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
PDF · Mobi · ePub

6 Advanced Configuration Options

This chapter discusses techniques for manually configuring and extending a WebCenter Portal: Framework application. This chapter includes the following sections:

6.1 Manually Configuring a Framework Application With Technology Scopes

This section discusses how to manually configure a WebCenter Portal: Framework application by adding or removing technology scopes.

6.1.1 What are Technology Scopes?

Framework applications are comprised of a collection of project technologies and features or technology scopes. Each scope has associated libraries that provide specific features to the application. You can manually add or remove technology scopes to manually configure your application. For example, you may wish to remove some components from your Framework application that you know you will never use.

6.1.2 Adding and Removing Technology Scopes

You can add or remove technology scopes (and their associated libraries) in the following ways.

First, you can modify the defaults when you create a new application. Figure 6-1 shows the list of available and selected technology scopes presented in the Create WebCenter Portal – Framework Application wizard. The scopes in the Selected column indicate the default set of technology scopes that comprise a framework application. For more information on this wizard, see Section 5.2, "Creating a Framework Application."

Figure 6-1 Create WebCenter Portal: Framework Application Wizard Step 2 of 5

Description of Figure 6-1 follows
Description of "Figure 6-1 Create WebCenter Portal: Framework Application Wizard Step 2 of 5"

You can also adjust technology scopes in the Project Properties dialog. Select Project Properties from the Application menu. Then, select Technology Scope from the tree. The dialog lets you move project technologies in and out of the project, as shown in Figure 6-2.

Tip:

Click on a scope in the dialog to display a short description at the bottom of the dialog.

Figure 6-2 The Technology Scope Dialog

Description of Figure 6-2 follows
Description of "Figure 6-2 The Technology Scope Dialog"

When you create a Framework application using the Create WebCenter Portal – Framework Application wizard, you have one other opportunity to determine the default configuration of the application that is created, and its technology scopes. The final screen of the wizard includes a checkbox labeled Configure the application with standard Portal features, shown in Figure 6-3.

Figure 6-3 Create WebCenter Portal: Framework Application Wizard Step 4 of 5

Description of Figure 6-3 follows
Description of "Figure 6-3 Create WebCenter Portal: Framework Application Wizard Step 4 of 5"

Checked by default, this option tells the wizard to add the Oracle WebCenter Portal: Framework features, like navigations, page hierarchies, delegated administration, and so on, to the application. If you uncheck this box, your application will not include these features. Essentially, you will create an application that is functionally equivalent to a WebCenter PS2 (WebCenter 11g Release 1 11.1.1.2.0) application.

6.1.3 What Are the Default Technology Scopes for a Framework Application?

Table 6-1 lists the default technology scopes and libraries that are included with applications created with the WebCenter Portal – Framework Application template. The Oracle WebCenter Portal: Framework technology scope is the only scope that is portal-application specific. This scope provides navigations, page hierarchies, delegated administration, and the rest of the portal features described in Chapter 9, "Understanding Framework Applications."

Note:

The Oracle WebCenter Portal: Framework technology scope is added by default to an application created with the Framework application template. The Framework application creation wizard gives you a chance to omit this technology scope if you unselect the Configure the application with standard Portal features checkbox in the Framework application creation wizard (Figure 6-3). In this case, you will create an application that is functionally equivalent to a WebCenter PS2 (WebCenter 11g Release 1 11.1.1.2.0) application.

Table 6-1 Default Technology Scopes and Associated Libraries

Default Technology Scopes Associated Libraries

ADF Faces

ADF Page Flow

Documents Service

Events Service

HTML

Instant Messaging and Presence (IMP) Service

Java

JSF

JSP and Servlets

Links Service

Oracle WebCenter Portal's Composer

WebCenter Portal – Framework

Portlet Bridge Service

Portlet View

Smart Tag

Tags Service

WebCenter Portal's Customizable Components

WebCenter Portal: Services

XML

JSF Core

JSF HTML

ADF Faces Runtime 11

ADF Common Runtime

ADF Web Runtime

MDS Runtime

MDS Runtime Dependencies

Commons Beanutils 1.6.1

Commons Logging 1.0.3

Commons Collections 2.1

ADF Page Flow Runtime

ADF Controller Runtime

JSP Runtime


6.1.4 Which Technology Scopes Are WebCenter Portal: Framework Application-Specific?

When the Configure the application with standard Portal features checkbox is selected in the Framework application creation wizard (Figure 6-3), the Oracle WebCenter Portal: Framework technology scope is added to the application in addition to the rest of the application technology scopes. If you were to unselect this checkbox, the Oracle WebCenter Portal: Framework technology scope would not be added.

6.1.5 Can I Create a WebCenter Portal: Framework Application by Adding the Oracle WebCenter Portal: Framework Technology Scope Later?

This case is not supported. If you want to create a Framework application, you must start with the WebCenter Portal: Framework Application template. For details, see Section 5, "Creating Framework and Portlet Producer Applications."

One possible solution is to create a new Framework application, then turn your existing Framework application into an ADF Library. Then, include the ADF Library in the WebCenter Portal: Framework Application.

6.1.6 Migrating a WebCenter PS2 or Earlier Application to a WebCenter Portal: Framework Application

The recommended best practice for migration is to create a new (PS3) Framework application using the WebCenter Portal: Framework Application template and then manually migrate the content, configurations, and logic from your old PS2 application to the new framework application. If it is not possible to follow this recommended practice, then follow the procedures described in Appendix H, "Manually Migrating a Framework Application."

Tip:

Another possible solution is to create a new Framework application, and then turn your existing Framework application into an ADF Library. Then, include the ADF Library in the Framework application.

6.2 Extending Non-WebCenter Portal: Framework Applications to Include WebCenter Capabilities

If your business requirement is to create a non-Framework application, say a Fusion web application, but you want to also include WebCenter capabilities in that application, you can do so by adding the required technology scopes and libraries. For example, you could add features like web services, task flows, and search to the application.

Note:

You cannot create a Framework application simply by adding the Oracle WebCenter Portal: Framework technology scope to a non-portal application. This use case is not supported, as explained in Section 6.1.5, "Can I Create a WebCenter Portal: Framework Application by Adding the Oracle WebCenter Portal: Framework Technology Scope Later?."

The technology scopes limit user interface options to those appropriate to the type of application project you are building. The libraries provide the components and elements useful in constructing application content. You can extend an existing application to integrate content from various repositories, create portlets, or consume portlets and WebCenter Portal services. You can extend ADF applications from the current release or from a 10.1.x.x release.

While extending your application, you may decide to create projects that are optimized for specific WebCenter capabilities. This section steps you through the process of manually creating projects like those provided with the WebCenter templates and adding the required technology scopes and libraries to projects.

To enable WebCenter capabilities in an application:

  1. Open your application.

    Click Yes if you are prompted to migrate your application settings.

    Note:

    If you migrated a 10.1.3.x Framework application, then the application continues to have the Model, ViewController, and Portlets projects.

  2. Optionally, create new projects for defining the application data model, consuming content, or creating portlets:

    1. In the Application Navigator, right-click the application and select New Project from the context menu.

    2. In the New Gallery, expand General, select Projects, then Generic Project, and click OK.

    3. In the Create Generic Project wizard, in the Project Name field, enter a name for the project.

      For example View.

    4. In the Directory field, specify the directory path for storing the project or accept the default path.

    5. Click Finish to create the new project.

  3. Right-click a project and select Project Properties.

  4. In the left side of the dialog, select Technology Scope.

  5. In the Project Technologies part of the dialog, add the required technologies and libraries depending on which WebCenter-related capabilities you want to enable in the selected project. See Table 6-1 for a complete list.

  6. Save your work.

6.3 Creating a Project by Importing a WAR File

Follow this procedure if you have an existing WAR file you want to import into your application environment through JDeveloper. Once the project is imported, you can configure it with WebCenter Portal features manually, as described in Section 6.1, "Manually Configuring a Framework Application With Technology Scopes."

Note:

Connection information is stored in the application-level EAR file and is not automatically imported with a project-level WAR file. Therefore, when you import a project-level WAR file, you must reconfigure any connections upon which the application relies.

To import a WAR file into JDeveloper:

  1. Right-click your application in the Application Navigator, and choose New Project from the context menu.

  2. In the New Gallery, expand General, select Projects, then Project from War File, and click OK.

  3. Follow the wizard instructions to complete creating the project.

  4. Right-click the newly created project in the Application Navigator, and select Project Properties from the context menu.

  5. Add the required technology scopes and libraries depending on which WebCenter-related capabilities you want to enable in the selected project. For more information, see Section 6.1, "Manually Configuring a Framework Application With Technology Scopes."

  6. Click OK to close the Project Properties dialog.