| Oracle® Fusion Middleware Federated Portals Guide for Oracle WebLogic Portal 10g Release 3 (10.3.4) Part Number E14235-05 |
|
|
View PDF |
| Oracle® Fusion Middleware Federated Portals Guide for Oracle WebLogic Portal 10g Release 3 (10.3.4) Part Number E14235-05 |
|
|
View PDF |
The WebLogic Portal Administration Console lets you locate producers and add their remote resources to the Portal Resources Library. Remote resources can include books, pages, and portlets. When a remote resource is added to the Library, it becomes available to you to incorporate into a portal desktop.
Tip:
This chapter assumes that you are familiar with the Portal Resources Library and how to use it to assemble WebLogic Portal desktops. For detailed information on the Library and on assembling portals using the Administration Console, see the Oracle Fusion Middleware Portal Development Guide for Oracle WebLogic Portal This chapter also assumes you are familiar with basic federated portal concepts and terms, such as producer, consumer, and WSDL. For detailed information on federated portals, see Chapter 2, "What are Federated Portals?" and Chapter 3, "Federated Portal Architecture."
This chapter explains how to locate producers and incorporate their remote resources into the Portal Resources Library. The chapter includes these sections:
You can use the WebLogic Portal Administration Console to locate remote producers, discover the resources they offer, and add them to the Portal Resources Library. After a remote resource, such as a book, page, or portlet, is added to the Library, you can add the resource to a desktop just as you would a local book, page, or portlet.
The primary advantage of remote books and pages is that they act as containers for other remote resources. For example, a producer can offer a remote book that contains several remoteable pages, each of which contain multiple remoteable portlets. When you consume that book, the remoteable pages and portlets it contains are consumed as well, with no additional steps.
Tip:
The term remoteable refers to a book, page, or portlet that is deployed in a producer application and that is offered as remote. Producer application developers decide whether or not books, pages, and portlets they create are offered as remote. For detailed information on creating remoteable pages and books in a producer application, see Chapter 6, "Offering Books, Pages, and Portlets to Consumers."
After you consume a remote book or page, an administrator can edit it using the Administration Console. For example, an administrator can add other portlets, books, or pages to the remote book or page. Remember that such changes are not reflected back to the producer; therefore, after a remote book or page is modified on the consumer, it can become inconsistent with the original book, page, or portlet in the producer application.
To add remote books, pages, and portlets to the Library:
Locate and add the producer in which the remote resources are deployed.
If necessary, register the producer.
Add remote books, pages, and portlets to your Portal Resources Library.
After the remote resources are in the Library, you add them to your portal desktop as you would any other book, page, or portlet.
To consume remote resources, such as portlets, books, and pages that are deployed in a producer, you need to first add the producer to your Portal Resources Library. After you add a WSRP-compliant producer to the Portal Resources Library, you can make that producer's remoteable resources available for consumption by your portal.
During registration, the producer stores information about the consumer and returns a handle to the consumer. Registration is an optional feature described in the WSRP specification. A WebLogic Portal complex producer implements this option and, therefore, requires consumers to register before discovering and interacting with portlets offered by the producer. See Section 3.4.2.2, "Complex Producers" for more information.
Tip:
In the WebLogic Portal Administration Console, producer registrations are scoped to individual consumer web applications. Because there can be multiple consumer web applications in an enterprise application, it is possible that a given producer will need to be registered multiple times within an enterprise application (that is, registered for each consumer web application in which it is used).
To locate and register a producer using the Administration Console:
Expand the Library node in the Portal Resources tree and select Remote Producers, as shown in Figure 18-1.
In the Browse Remote Producers window, select Add Producer, as shown in Figure 18-2. The Add Producer wizard appears.
In the Add Producer wizard, select a producer. To do this, specify a producer directly by entering its WSDL URL, and click Search. For example:
http://myhost:7001/producerWebProject/producer?wsdl
Select the producer you wish to add from the Producer(s) Found list, as shown in Figure 18-3.
If you want to view a list of portlets hosted by the producer, select the View producer's portlets before adding producer checkbox, as shown in Figure 18-4.
Figure 18-4 View Producer's Portlets Checkbox
Click Next.
If the View Producer Portlets dialog appears, click Next. This dialog, shown in Figure 18-5, appears only if you selected the View producer's portlets before adding producer checkbox. This dialog simply lists the portlets hosted by the selected producer to help you decide if you want to add the producer or not.
In the Enter Producer Properties dialog (Figure 18-6), enter or select:
A name for the producer – (Required) This name is used by the consumer to identify the producer.
Vendor and description information – (Optional) Use these fields to enter optional metadata.
Store Registration Properties – (Optional) If you select this option, the registration properties that you enter in the Add Producer dialog are stored on the consumer. It is recommended that you select this option. For detailed information on this option, see Section 14.19, "Storing Registration Properties".
Click Add Producer to go to the Register dialog.
In the Register dialog, enter the registration information, if any is required. In the example shown in Figure 18-6, a property set called "Favorite vegetables" was defined on the producer. The dialog requires the user to enter value(s) from that property set. The value(s) entered here are validated on the producer and are used to determine which resources this consumer is entitled to retrieve. For detailed information on consumer entitlement, see Chapter 11, "Consumer Entitlement."
Figure 18-7 Enter Registration Properties (Sample)
Click Add Producer. The Summary dialog appears, as shown in Figure 18-8.
Click Finish.
Checkpoint: Now that you have located and added a producer, you can view and select portlets, books, and pages to add to the consumer from that producer, as explained in the following sections.
If you have added a producer that contains a remoteable portlet, you can add that portlet to your Portal Resources Library. After the remote portlet is added to the Library, you can incorporate the portlet into a page in your portal desktop.
There are two ways to incorporate remote portlets into a portal using the Administration Console:
Add a remote page that contains one or more remote portlets. For details adding remote pages, see Section 18.4, "Adding a Remote Page to the Portal Library".
Add a remote portlet directly. This method is described in this section.
To add a remote portlet to your Portal Resources Library directly:
Open the WebLogic Portal Administration Console.
If you haven't done so, locate and add the producer that contains the remote portlet(s) that you want to add to your portal. The procedure for adding a producer is explained in Section 18.2, "Adding a Producer".
In the Portal Resources tree, open the Library > Remote Producers folder, and select the producer that contains the remote portlet that you want to use, as shown in Figure 18-9.
In the producer window click the Selected Portlets tab, as shown in Figure 18-10.
In the Browse Selected Portlets panel, click Add Portlets, as shown in Figure 18-11.
Tip:
If the producer offers a large number of portlets, use the Search feature to narrow the selections. For instance, you can search for all portlets that begin with "a," and only those portlets will show up in the Browse Selected Portlets table.
In the Add Portlets dialog, select the remote portlet(s) that you want to add to the Library, and click Add to move the selected portlets to the Portlets To Add column, as shown in Figure 18-12.
After moving the portlet to the Portlets To Add column, click Save. The portlets you added appears in the Library under the Portlets folder, as shown in Figure 18-13.
Figure 18-13 Remote Portlets Added to the Library
The added portlets also appear in the Browse Selected Portlets table in the producer's Selected Portlets tab, as shown in Figure 18-14.
Figure 18-14 Table Displays Added Portlets
Tip:
When you add a remote portlet to the Library, it is placed in the Portlets folder. This is the same folder where local portlets appear. WebLogic Portal treats the remote portlet exactly as if it were a local portlet.
Checkpoint: You can now add the portlet to a page in your desktop. For details on adding Library resources to a desktop, see the Oracle Fusion Middleware Portal Development Guide for Oracle WebLogic Portal.
If you have added a producer that contains a remoteable page, you can add that page to your Portal Resources Library. After the remote page is added to the Library, you can incorporate it into your portal desktop as if it were a local page.
This section explains how to add a remote page to your Portal Resources Library.
Tip:
To be remoteable, the page's Offer As Remote property must have been set to true when it was created and the page must include some content. A remote page can contain any combination of remote books and portlets. Books and portlets contained within a remote page must be offered as remote. By default, books, pages, and portlets are offered as remote. For more information on creating remoteable books and pages in a producer application, see Chapter 18, "Adding Remote Resources to the Library."
Open the WebLogic Portal Administration Console.
If you haven't done so, locate and add the producer that contains the remote page(s) that you want to add to your portal. The procedure for adding a producer is explained in Section 18.2, "Adding a Producer".
In the Portal Resources tree, open the Library > Remote Producers folder, and select the producer that contains the remote page that you want to use, as shown in Figure 18-15.
In the producer window, click the Selected Pages tab, as shown in Figure 18-16.
In the Browse Pages section, click Add Page, as shown in Figure 18-17.
In the Add Page dialog, select the remote page that you want to add to the Library, and click Add Page. In Figure 18-18, the remote page is called Page 1.
Checkpoint: The remote page is added to the Library, as shown in Figure 18-24. You can now add the page to a desktop. For details on adding Library resources to a desktop, see the Oracle Fusion Middleware Portal Development Guide for Oracle WebLogic Portal.
Figure 18-19 Remote Page Added to Library
If you have added a producer that contains a remoteable book, you can add that book to your Portal Resources Library. After the remote book is added to the Library, you can incorporate it into your portal desktop as if it were a local book.
Tip:
To be remoteable, the book's Offer As Remote property must have been set to true when it was created, and the book must include some content. A remote book can contain any combination of remote pages and portlets. Pages and portlets contained within a remote page must be offered as remote. By default, books, pages, and portlets are offered as remote. For more information on creating remoteable books and pages in a producer application, see Chapter 18, "Adding Remote Resources to the Library."
This section explains how to add a remote book to your Portal Resources Library.
Open the WebLogic Portal Administration Console.
If you haven't done so, locate and add the producer that contains the remote book(s) that you want to add to your portal. The procedure for adding a producer is explained in Section 18.2, "Adding a Producer".
In the Portal Resources tree, open the Library > Remote Producers folder, and select the producer that contains the remote book that you want to use, as shown in Figure 18-20.
In the producer window, click the Selected Books tab, as shown in Figure 18-21.
In the Browse Books section, click Add Book, as shown in Figure 18-22.
In the Add Book dialog, select the remote book that you want to add to the Library, and click Add Book. In Figure 18-23, the remote book is called My Remote Book.
Checkpoint: The remote book is added to the Library, as shown in Figure 18-24. You can now add the book to a desktop. For details on adding Library resources to a desktop, see the Oracle Fusion Middleware Portal Development Guide for Oracle WebLogic Portal.
Figure 18-24 Remote Book Added to Library
|
 Copyright © 2010, 2011, Oracle and/or its affiliates. All rights reserved. Legal Notices |
|
