Registering an Oracle PDK-Java Producer Using Fusion Middleware Control

23-14 Oracle Fusion Middleware Administrators Guide for Oracle WebCenter 3. From the list of services on the WebCenter Service Configuration page, select Portlet Producers .

4. In the Manage Portlet Producer Connections section, select the producer you

want to modify, and click Edit. 5. In the Edit Portlet Producer Connection section, modify connection details, as required. For more information, see: ■ Table 23–1, WSRP Producer Connection Parameters ■ Table 23–4, Oracle PDK-Java Producer Connection Parameters

6. Click OK.

23.6.2 Editing Producer Registration Details Using WLST

Use the following WLST commands to edit portlet producer connections: ■ WSRP producers - setWSRPProducer ■ PDK-Java producers - setPDKJavaProducer For command syntax and examples, see the Oracle Fusion Middleware WebLogic Scripting Tool Command Reference. For information on how to run WLST commands, see Section 1.13.3.1, Running Oracle WebLogic Scripting Tool WLST Commands.

23.6.3 Migrating WSRP Producer Metadata to a New WSDL URL

If you want to move a WSRP producer to a new WSDL URL, you can use the exportPortletClientMetadata, setWSRPProducer, and importPortletClientMetadata WLST commands to migrate the existing producer metadata to the new location. To migrate WSRP producer metadata to a new URL endpoint: 1. Export the producer metadata, using the WLST command exportPortletClientMetadata. For command syntax and examples, see exportPortletClientMetadata in the Oracle Fusion Middleware WebLogic Scripting Tool Command Reference. 2. Change the producers WSDL URL, using the WLST command setWSRPProducer. For command syntax and examples, see setWSRPProducer in the Oracle Fusion Middleware WebLogic Scripting Tool Command Reference. 3. Import the producer metadata, using the WLST command importPortletClientMetadata. For command syntax and examples, see importPortletClientMetadata in the Oracle Fusion Middleware WebLogic Scripting Tool Command Reference.

23.7 Deregistering Producers

You can deregister producers at any time but, before doing so, consider any impact to the WebCenter application as portlets associated with a deregistered producer no longer work. Check the Portlets Producer Invocation metric to see how frequently the producer is being used. For more information, see Section 36.2, Viewing Performance Information. When you deregister a producer, registration data is removed from both the WebCenter application and the remote producer: Managing Portlet Producers 23-15 ■ WebCenter application - The producer connection is deleted and producer metadata is also deleted. ■ Remote producer - Portlet instances are deleted not the portlets themselves. Portlet instances are not removed from WebCenter application pages. In place of the portlet, WebCenter users see a Portlet unavailable message. This section includes the following subsections: ■ Section 23.7.1, Deregistering Producers Using Fusion Middleware Control ■ Section 23.7.2, Deregister Producers Using WLST ■ Section 23.7.3, Deregistering Producers in WebCenter Spaces ■ Section 23.7.4, Deregistering Producers in WebCenter Portal Applications

23.7.1 Deregistering Producers Using Fusion Middleware Control

To deregister a portlet producer:

1. Log in to Fusion Middleware Control and navigate to the home page for your

WebCenter Portal application or WebCenter Spaces: ■ 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 Service Configuration. ■ For WebCenter Spaces - From the WebCenter menu, choose Settings Service Configuration .

3. From the list of services on the WebCenter Service Configuration page, select

Portlet Producers .

4. Select the name of the producer you want to remove, and click Delete.

The connection details are removed. Portlets associated with this producer are no longer accessible within the WebCenter application.

23.7.2 Deregister Producers Using WLST

Use the following WLST commands to deregister portlet producer connections: ■ WSRP producers - deregisterWSRPProducer ■ PDK-Java producers - deregisterPDKJavaProducer Use the following WLST commands to deregister the out-of-the-box or sample producers provided with Oracle WebCenter: ■ Out-of-the-box producers - deregisterOOTBProducers ■ Sample producers - deregisterSampleProducers Note: Consider deleting the external application associated with this portlet producer if the applications sole purpose was to support this producer. See Section 25.5, Deleting External Application Connections. 23-16 Oracle Fusion Middleware Administrators Guide for Oracle WebCenter For command syntax and examples, see the Oracle Fusion Middleware WebLogic Scripting Tool Command Reference. For information on how to run WLST commands, see Section 1.13.3.1, Running Oracle WebLogic Scripting Tool WLST Commands.

23.7.3 Deregistering Producers in WebCenter Spaces

For information about deregistering portlet producers in WebCenter Spaces, see the section Deregistering Portlet Producers in the Oracle Fusion Middleware Users Guide for Oracle WebCenter.

23.7.4 Deregistering Producers in WebCenter Portal Applications

For information about deregistering portlet producers in WebCenter Portal applications, see the section How to Delete a Portlet Producer in the Oracle Fusion Middleware Developers Guide for Oracle WebCenter.

23.8 Deploying Portlet Producer Applications

To deploy a portlet producer to an Oracle WebLogic Managed Server instance, you can use Fusion Middleware Control, Oracle WebLogic Server Administration Console, or WLST. For information on deploying a portlet producer at design-time, through Oracle JDeveloper, see the chapter Testing and Deploying Your Portlets in the Oracle Fusion Middleware Developers Guide for Oracle WebCenter. This section includes the following subsections: ■ Section 23.8.1, Understanding Portlet Producer Application Deployment ■ Section 23.8.2, Converting a JSR 286 Portlet Producer EAR File into a WSRP EAR File ■ Section 23.8.3, Deploying Portlet Producer Applications Using Oracle JDeveloper ■ Section 23.8.4, Deploying Portlet Producer Applications Using Fusion Middleware Control ■ Section 23.8.5, Deploying Portlet Producer Applications Using Oracle WebLogic Server Administration Console ■ Section 23.8.6, Deploying Portlet Applications Using WLST For more information about deploying applications, see the chapter Deploying Application in Oracle Fusion Middleware Administrators Guide.

23.8.1 Understanding Portlet Producer Application Deployment

You can deploy your portlet producer application to any Oracle WebLogic Managed Server instance that is configured to support WebCenter portlet producers. To deploy an application to a managed server, you can use Oracle Enterprise Manager Fusion Middleware Control, Oracle WebLogic Administration Console, or WLST. For more information about these administration tools, see Section 1.13, Oracle WebCenter Administration Tools.

23.8.2 Converting a JSR 286 Portlet Producer EAR File into a WSRP EAR File

To deploy JSR 286 portlets to the WSRP Oracle Portlet Container, the portlet application EAR files must be converted into a WSRP application, which contains the necessary WSDL documents. To convert the JSR 286 portlet producer EAR file into a