Portlet Unavailable: WSM-00101 Exception

Managing the Oracle WebCenter Pagelet Producer 24-3

24.2.1 Registering the Pagelet Producer for WebCenter Applications Using Fusion Middleware Control

To register the Pagelet Producer: 1. Log in to Fusion Middleware Control and navigate to the home page for your WebCenter application. For more information, see: ■ Section 6.3, Navigating to the Home Page for WebCenter Portal Applications . ■ Section 6.2, Navigating to the Home Page for WebCenter Spaces 2. Do one of the following: ■ For WebCenter Portal applications - From the Application Deployment menu, choose WebCenter, then Register Producer. ■ For WebCenter Spaces - From the WebCenter menu, choose Register Producer . 3. Enter connection details for the Pagelet Producer Table 24–1 .

4. Click OK.

The new producer appears in the connection table.

24.2.2 Registering the Pagelet Producer for WebCenter Applications Using WLST

Use the registerPageletProducer command to register a Pagelet Producer for your WebCenter application. For command syntax and examples, see the section registerPageletProducer in the Oracle Fusion Middleware WebLogic Scripting Tool Command Reference. Table 24–1 Pagelet Producer Connection Parameters Field Description Connection Name Enter a unique name to identify this pagelet producer within the WebCenter application. The name must be unique across all WebCenter connection types. Producer Type Select Pagelet Producer. Server URL Enter the URL of the WebCenter Pagelet Producer. The URL must include a fully-qualified domain name. Use the following syntax: protocol:host_name:port_number For example: http:myhost.com:7778 If pagelets contain secure data, the registered URL must use the https protocol. For example: https:myhost.com:7779 Note: In WebCenter Spaces, if the Pagelet Producer URL is protected by OAM, the URL to the pagelet catalog must be excluded mapped directly without access control, or the catalog will appear to be empty when using REST. The pagelet catalog URL is http:proxy_host:proxy_portapiv2ensemblepa gelets 24-4 Oracle Fusion Middleware Administrators Guide for Oracle WebCenter You can also use WLST to list or edit the current connection details. For information on how to run WLST commands, see Section 1.13.3.1, Running Oracle WebLogic Scripting Tool WLST Commands.

24.3 Configuring the Pagelet Producer Service

This section describes how to set up the Pagelet Producer for use as a service by Oracle WebCenter using the Oracle Configuration Wizard. For information about developing and deploying pagelets, see the section Creating Pagelets with the Oracle WebCenter Pagelet Producer in the Oracle Fusion Middleware Developers Guide for Oracle WebCenter. To set up Oracle WebCenter Pagelet Producer as a WebCenter service:

1. Launch the Configuration Wizard Oracle Fusion Middleware Oracle

WebLogic Server Tools Configuration Wizard. 2. Select Create a new WebLogic Domain. Click Next. 3. Select Base this domain on an existing template and select the Pagelet Producer domain template . Confirm that the template location is correct and click Next. 4. Complete the domain configuration wizard. For details on specific settings, see the online help.

24.4 Creating Pagelet Producer Resources and Pagelets

The Pagelet Producer Console is a browser-based administration tool used to create and manage the various objects in your Pagelet Producer deployment. From the Console you can register web applications and pagelets, manage proxy and transformation settings, and more. To launch the Pagelet Producer Console, open a browser window and navigate to http:host_name:port_numberpageletadmin and log on with the administrator name and password you entered when you created the domain using the Configuration wizard in Section 24.3, Configuring the Pagelet Producer Service in step 2. The pagelet producer console can also be launched in accessible mode at: http:host_name:port_numberpageletadminaccessible. From the Pagelet Producer Console, you can create resources and pagelets. To create a new resource, select the Resources option from the dropdown list, choose any existing resource in the navigation pane, and then click the Create icon in the toolbar. This button is only enabled when you have selected an object type that can be created. An entry called new will be added to the list of resources, and it will include the necessary configuration pages, detailed in the sections that follow. To save your changes at any time, click the Save icon in the toolbar. ■ Section 24.4.1, General ■ Section 24.4.2, CSP Note: When importing and exporting data using WLST, the resources.xml and settings.xml files must reside in a directory called ensemble and no other files may be present in that directory. The argument passed to the importexport commands should be the parent directory of the ensemble directory. Managing the Oracle WebCenter Pagelet Producer 24-5 ■ Section 24.4.3, Policy ■ Section 24.4.4, Autologin ■ Section 24.4.5, Headers ■ Section 24.4.6, Pagelets ■ Section 24.4.7, Injectors ■ Section 24.4.8, Parsers

24.4.1 General

On the General page, enter basic information about the resource. 1. Enter a Name for the resource. Enter an optional Description. 2. In the Source URL field, type the URL to the internal web application to be proxied. For example, http:internalServerfoo.

3. By default, the Pagelet Producer attempts to connect to the resource for 30 seconds

before returning an error message. To change this value, enter a new Source Timeout period in seconds.

4. In the Destination URL field, type the URL to be used to access the resource. This

URL must be on the server that hosts the Pagelet Producer. In the Pagelet Producer URL space, you must specify a relative path at which the content must appear.

5. The Pagelet Producer enables URL Rewriting by default. When URL rewriting is

enabled, the Pagelet Producer rewrites URLs in the proxied application that begin with the source URL prefix so that they point to the destination URL prefix. There are two cases in which you should disable URL rewriting: ■ The internal URL prefix and external URL prefix are identical. In this case, the users DNS must resolve the URL to the Pagelet Producer proxy server, and the Pagelet Producer proxy servers DNS must resolve the URL to the internal resource. Because DNS only resolves IP and not port, both servers must listen to the same port. This method is strongly recommended. ■ All links in the application are relative URLs. In this case, the internal URL prefix path and the external URL prefix path must be identical. For example, if the internal URL prefix is http:internal_serverbar the external URL prefix path must be bar or http:proxy_serverbar. To disable transformation, deselect URL Rewriting. 6. To enable Dynamic HTML, choose DHTML Rewriting. This option supports URLs that are not in the original HTML returned from the server, but are added by DHTML. In most cases, this option should be enabled. Note: If you are configuring an ADF Web Application as a resource, the Source URL cannot be any more specific than http:hostname:portnumbercontext-root.