The Pages Launcher Portlet displays links to the Dashboard and other favorite Spaces. This portlet is created in the Pages Objects folder when you import the Pages migration package (as described in the Installation Guide for AquaLogic Pages).
Note:
Only Spaces you have designated as favorites appear in the portlet.
To provide access to Pages, add this portlet to a community page, tell users to add the portlet to their My Pages, or make the portlet mandatory for some groups so that it automatically shows up on the users’ My Pages. You must have at least Select access to a portlet to add it to a My Page or community page.
Note:
For information on changing access privileges, making a portlet mandatory, or adding a portlet to a My Page or community page, refer to the portal online help.
Displaying a Spaces Menu in Portal Navigation
You can add a menu (just like the My Communities menu) to display available Spaces in the portal navigation.
Note:
Only Spaces to which the user has access appear in the menus.
You must perform the following steps to display the Spaces menu:
Add the Spaces navigation tag to a custom header. There is a sample header code file installed with Pages: install_dir\pages\1.5\header_with_pagestags.html (for example, C:\bea\alui\pages\1.5\samples\header_with_pagestags.html). For information on creating your own custom header using the Pages navigation tags, see the AquaLogic User Interaction Development DocumentationAdaptive Tags: Pages.
Create a remote portlet web service that points to the custom header you created. For instructions on creating a remote portlet web service, see the Administrator Guide for AquaLogic Interaction and the portal online help.
Create a portlet based on the remote portlet web service. For instructions on creating a portlet, see the Administrator Guide for AquaLogic Interaction and the portal online help.
Create an experience definition that uses the custom header portlet. For instructions on creating an experience definition, see the Administrator Guide for AquaLogic Interaction and the portal online help.
Create an experience rule that displays the experience definition. For instructions on creating an experience rule, see the Administrator Guide for AquaLogic Interaction and the portal online help.
Note:
If there are any other experience rules defined, you might need to move the experience rule you just created up in the list so that the rule will apply. For information on how experience rules are applied, see the portal online help.
Verify that the Spaces menu is displaying properly. Log off and log back in as a user that should see the Spaces menu.
Troubleshooting the Spaces Menu
If the Spaces menu is not showing up, perform the following steps:
Start AquaLogic Interaction Logging Spy and confirm that logging is enabled.
Log out of the portal.
Clear the AquaLogic Interaction Logging Spy log.
Log back in to the portal.
Note:
If you just refresh the page without logging out and logging back in, the page will use cached data, and any errors that occur when the navigation tags execute the request to the Pages server will not display in AquaLogic Interaction Logging Spy.
Look in the log under Portal application for any errors from the PagesIntegration component.
If there are no errors from the PagesIntegration component, check the settings described in Verifying Navigation Settings. (You will probably see two other tag errors regarding not being able to find data tags, this is due to the Pages tags not functioning properly.)
If there are errors from the PagesIntegration component, refer to Typical Errors.
Verifying Navigation Settings
If your Spaces menu is not displaying in the portal navigation and AquaLogic Interaction Logging Spy does not display any PagesIntegration component errors:
Verify that you are really logged in as a user that views the Tag Navigation Experience Definition. You should see a blue banner. If you see a white banner with the AquaLogic liquid image, you are logged in as a user that views the Pluggable Navigation. Review the Experience Definition Rules to ensure that the Tag Navigation Experience Definition is being used for the user you used to log in.
Verify that the Pages navigation tag was added to your custom header. Open your custom header file and search for pt:pages.livespacesdata.
If you do find this entry, continue with the next step.
If you do not find this entry, the Pages navigation tag was not added to your custom header. See the AquaLogic User Interaction Development DocumentationAdaptive Tags: Pages.
Verify that the experience definition you are viewing uses header.html. Add some random text to the top of header.html, save the file, and reload the portal page.
If you see the random text at the top of the page, remove the random text from header.html, save the file, and continue with the next step.
If you do not see the random text, the experience definition you are viewing is not using header.html as its header portlet. Verify that there is not a higher priority experience definition that is being used for the user. If there is a higher priority experience definition, move the rule that uses the Tag Navigation Experience Definition higher up in the rules list. If there is not a higher priority experience definition, continue with the next step.
Verify that the Pages navigation tag is being transformed. View the source for the portal page, and search for pt:pages.livespacesdata.
If you do not find this entry, the Pages navigation tag is being transformed. Skip to step l.
If you do find this entry, the Pages navigation tag was not properly deployed to the portal. Verify that the Pages Portal Extensions component was installed on the portal. If it was installed, continue with the next step. If it was not installed on the portal, refer to the Installation Guide for AquaLogic Pages for instructions.
Verify that the custom tag libraries are properly deployed.
On a Java portal, look for taglibPages.jar in install_dir/ptportal/6.5/lib/java and look for the WEB-INF/lib folder reference in install_dir/ptportal/6.5/webapp/portal.war. Use WinZip or WinRAR to view the contents of the .war file. If you run the portal on BEA WebLogic, you also need to open portal.ear and verify the content of portal.war inside the .ear file. With portal on WebLogic server, ensure that you updated the portal deployment after installing the Portal extensions.
On a .NET portal, look for taglibPages.dll in install_dir/ptportal/6.5/bin/assemblies and install_dir/ ptportal/6.5/webapp/portal/web/bin.
Verify that the Pages tag library is defined as a custom tag library. Open install_dir/settings/portal/CustomTags.xml. Verify that it contains the following entry:
<libfile name="taglibPages"/>
Typical Errors
Typical errors include:
Portlet exceptions: These are usually due to the Pages server being unavailable. Verify that the BEA AL Pages service is running.
IDK exceptions: These are usually due to the BEA ALI API service not running or not being configured correctly in the portal. Verify that the BEA ALI API service is running. To verify that it is configured correctly in the portal:
Log in to portal as an administrator.
Click Administration.
In the Select Utilities menu, click Portal Settings.
In the Portal Settings Editor, on the left, under Edit Utility Settings, click Portal URL Manager.
Copy the Soap Server URL value and paste it into a web browser. The page that appears should be titled QueryInterfaceAPI. If this is not the case, correct the URL in the Portal Settings Editor.
OpenKernel exceptions: These are usually due to the adaptive tags not being able to find a setting in install_dir/settings/configuration.xml. Verify that the Configuration Manager was installed properly and that the configuration.xml file exists.
ObjectManager exceptions: These are usually due to problems with the Pages objects that were imported into the portal from the migration package. To correct the problems:
Log in to the portal as an administrator.
Click Administration.
Open the Pages Objects folder. If it does not exist, refer to the Installation Guide for AquaLogic Pages for instructions on importing the migration package.
Expand the web services, and open the Pages Spaces Web Service.
In the Web Service Editor, on the left, under Edit Standard Setting, click Properties and Names, and write down the UUID.
Open install_dir/settings/configuration.xml in a text editor.
Search for SpacesListWebServiceUUID and verify that the value matches the Pages Space Web Service UUID you wrote down. If it does not match, correct the value in the file and save the file.
Page Component Portlets
You can create a portlet from an existing page component, allowing you to display content from a page component in a portal page.
Notes:
Only users who have permission to see the page component will be able to see the content in the portlet. Users must have at least the Guest role on the associated Space.
Rich text components and image components will not display correctly.
If the page component is deleted, the portlet will display an error.
Click Administration.
Open the administrative folder in which you want to create the portlet.
Click Create Object Portlet.
In the Choose Template or Web Service dialog box, select Pages Components Selector and click OK.
Next to Configure this Portlet, click Edit.
In the Portlet Wizard:
Select the Space which includes the page component you want to use.
Note:
You can only choose from Spaces you have permission to see.
Select the page component you want to use.
Click Finish.
In the Portlet Editor, click Finish.
In the Save Object dialog box, type a name for the portlet and click Save.
In the Object Saved dialog box, click Close.
You can now add the portlet to a portal page.
Blog Portlets
You can add a blog portlet to a portal page. A blog is an online journal or chronological publication of comments and information. Blogs are generally updated frequently and can be an efficient communication tool for small groups or to disseminate knowledge to a group.
To add a blog portlet, select the Blog portlet as you would any other portlet. For information on adding a portlet to a page, see the portal online help.
Wiki Portlets
You can add a wiki portlet to a portal page. A wiki enables you to add and edit content in-place.
To add a wiki portlet, select the Wiki portlet or the Wiki w/ Comments portlet as you would any other portlet. For information on adding a portlet to a page, see the portal online help.
Navigation in Pages
By default, Pages uses the same navigation as the portal, though Pages displays only a portion of that navigation. Pages displays only the horizontal drop-down menus (not the links at the top of the page or the banner). If you use a left vertical navigation scheme or custom navigation with a header portlet that does not display horizontal navigation, you must customize the navigation for Pages. If you want Pages to display different navigation than the portal, you also need to customize the navigation.
To use a different standard navigation scheme for Pages:
Create an experience definition that uses a supported navigation scheme. In the Experience Definition Editor, on the Edit Navigation Options page, select the navigation scheme to use for Pages. The following standard navigation schemes are supported in Pages: Horizontal Combo Box Drop-Down Navigation, Mandatory Links Only, No Navigation, and Horizontal Drop-Down Navigation.
Create an experience rule for Pages that uses the experience definition you created. Add a URL condition with the following value: *Pages_host:Pages_port/pages* (for example, *pages.company.com:11990/pages*).
To customize the navigation for Pages using a header portlet:
Create a header portlet that displays horizontal navigation. For information on creating a custom header portlet, see the AquaLogic User Interaction Development Documentation Adaptive Tags: Implementing Custom Navigation.
Note:
Left vertical navigation schemes are not supported in Pages. The top bar and banner sections of header portlets are not displayed in Pages.
Create an experience definition that uses the header portlet you created. In the Experience Definition Editor, on the Choose Header, Footer & Style page, select the header portlet you created. On the Edit Navigation Options page, select Portlet-Ready Navigation.
Create an experience rule for Pages that uses the experience definition you created. Add a URL condition with the following value: *Pages_host:Pages_port/pages* (for example, *pages.company.com:11990/pages*).
For information on creating experience definitions or experience rules, see the Administrator Guide for AquaLogic Interaction or the portal online help.
Note:
Experience definition rules applied to a community do not apply to Pages, even if the user navigates to Pages from that community.
Crawling Pages Content
You can crawl content from Pages as you would any other content source. You can import the following content from Pages:
Comments: Comments are indexed, but not imported as separate documents. If you search for a comment your results will include pages that include the comment. If you click a result, you see the page in the Pages application.
Rich Text Components: The html-escaped content of all rich text components in a page is crawled. As with comments, the content is indexed rather than crawled as a separate document.
Attachments: Attachments are imported as separate documents and indexed. Office and PDF documents are indexed by the appropriate portal accessor. Clicking an attachment in the Knowledge Directory takes you to the page view of the attachment in the Pages application.
Tables and Record Lists: Each record in a table or record list is imported as a separate document and indexed. Although content from non-local data sources is imported, this content may be out of date quickly based on the data source’s expiration time. Clicking a record in the Knowledge Directory takes you to the page view of the record in the Pages application. Each field value in the record is crawled in as they display in the record list; that is, users will be crawled in as the user's display name and not the UUID, and dates will be returned as the corresponding date and not a long number.
Field values can be searched via advanced search if the title of the field is the same as the name entered in the Global Document Property Map. The content crawled from rich text fields is html-escaped.
To crawl Pages content:
Create a content source based on the Pages Crawler Web Service and using the Pages Crawler credentials that are set in Configuration Manager.
Create a crawler based on the content source you just created, selecting the Space you want to crawl for content.
Note:
The Spaces listed are those that are accessible by the default administrator set in Configuration Manager. If you change these credentials you must restart the BEA AL Pages service for Pages to read the new credentials.
If you want to import security with each document, you must make sure that the appropriate groups are mapped in the Global ACL Sync Map.
Portlet.
