A Web library (or multiple Web libraries) must be created to store URL references to WebFOCUS components. To create the Web library, first go to the machine where the PeopleSoft Application Server is installed and open PeopleSoft Application Designer.

To create a Web library for WebFOCUS components:

1. Create a new field definition by selecting File, and then New from the menu.

   

2. Select Field from the selection list, then click OK.

   The following window opens.

   

3. Define the field as:

   Property	Value
   Field Type	Character
   Field Format	1
   Label ID	IB_WEBFOCUS
   Long Name	WebFOCUS OPS iScripts
   Short Name	WebFOCUS OPS

4. Using the menu bar select File, Save, and enter IB_WEBFOCUS for the new field definition name.

   

5. Create a new record definition by selecting File, and then New from the menu.
6. Insert the IB_WEBFOCUS field into the new record by selecting Insert, and then Field. Then search for the field, highlight, and select Insert.
7. Select the Record Type tab and change the record type to Derived/Work.

   

8. Save the new record definition by choosing File, and then Save from the menu. Web library records must be named with the WEBLIB prefix, therefore, use WEBLIB_WEBFOCUS and the new Web library name.
9. Open the FieldFormula event on the IB_WEBFOCUS field by selecting View, and then PeopleCode Display.

   You can also click the PeopleCode Display icon on the toolbar and double-click the FFo event column.

   

10. Enter the iScript PeopleCode to define access to the WebFOCUS components. For more information, see WebFOCUS Pagelets iScript Code.
11. Save the new Record definition by choosing File, and then Save from the menu.

The following table provides the required syntax. When copying the PeopleCode, only the server name for the WebFOCUS Business Intelligence Dashboard server needs to be modified for your environment. For more information on each Pagelet, see Using WebFOCUS Portal Components.

Function IScript_WebFOCUSReport1()
&userID = %UserId;
&address = 
"http://servername:port/ibi_apps/components/woas/governor/
WOAS_view.jsp?SID="|%UserId|"&view=report"|"&gn=number"; 
%Response.Write(CreateJavaObject
("ibi.portals.URLContentRetriever").retrieveGadgetFromBIDServer
(&address));

End-Function;

Function IScript_WebFOCUSDeferred()
&userID = %UserId;
&address = 
"http://servername:port/ibi_apps/components/woas/governor/
WOAS_view.jsp?SID="|%UserId|"&view=deferstatus";
%Response.Write(CreateJavaObject
("ibi.portals.URLContentRetriever").retrieveGadgetFromBIDServer
(&address));

End-Function;

Function IScript_WebFOCUSDomains()
&userID = %UserId;
&address =
"http://servername:port/ibi_apps/components/woas/governor/
WOAS_view.jsp?SID="|%UserId|"&view=domain";
%Response.Write(CreateJavaObject
("ibi.portals.URLContentRetriever").retrieveGadgetFromBIDServer
(&address));

End-Function;

Function IScript_WebFOCUSQLinks()
&userID = %UserId;
&address = 
"http://servername:port/ibi_apps/components/woas/governor/
WOAS_view.jsp?SID="|%UserId|"&view=quicklinks";
%Response.Write(CreateJavaObject
("ibi.portals.URLContentRetriever").retrieveGadgetFromBIDServer
(&address));

End-Function;

Function IScript_WebFOCUSFavorites()
&userID = %UserId;
&address = 
"http://servername:port/ibi_apps/components/woas/governor/
WOAS_view.jsp?SID="|%UserId|"&view=favorites";
%Response.Write(CreateJavaObject
("ibi.portals.URLContentRetriever").retrieveGadgetFromBIDServer
(&address));

End-Function;

Once iScript has been made available through the Application Designer, permissions must be set for the Web Library so that PeopleSoft users have access to it.

The following instructions use a standard permission list delivered with PeopleSoft 8.4 Applications, ALLPAGES. PeopleSoft security administrators may elect to create a new permission list specific to WebFOCUS, or use alternative pre-existing ones.

1. Log on to PeopleSoft with a user ID that has access to update permission lists. For example:

   http://machinename:port/ps/signon.html

   where:

   machinename

   Is the host name of the PeopleSoft Application Server.

   port

   Is the port number where the PeopleSoft Application Server listens.

2. Navigate to PeopleTools, Security, Permissions & Roles, and then Permission Lists. Select the ALLPAGES permission list for updating.
3. Select the Web Libraries tab.

   

4. Select one of the plus sign buttons in the list to insert a new Web library. A new row appears, allowing the input of the new Web library name.
5. Enter the Web library name WEBLIB_WEBFOCUS, which was created earlier.
6. Click on the Edit link for the new Web library. This opens a page to allow the administrator to select permissions for the available Web library functions.

   

7. Grant full access to all the iScript functions created earlier, and click OK.
8. Click Save.

Creating a new folder assists in managing the structure and application security for the portal. If you do not want to create a new folder, then an existing folder, such as PeopleSoft Applications, can be used as the location of the registered WebFOCUS pagelets. This section describes the procedure for creating a new WebFOCUS Reporting folder.

1. Log on to PeopleSoft with a user ID that has access to administer the portal pagelet structure. For example:

   http://machinename:port/ps/signon.html

   where:

   machinename

   Is the host name of the PeopleSoft Application Server.

   port

   Is the port number where the PeopleSoft Application Server listens.

2. Navigate to PeopleTools, Portal, and then Structure & Content.
3. Click on the Pagelets link to view the pagelet structure.

   

4. Select the Add Folder link to add a new WebFOCUS folder.
5. Enter the required information. An example is shown below.

   

6. Click Save.
7. Select the Folder Security tab.
8. Select Public as access type. Security administrators should review access rights for this new folder.
9. Click Save.

1. Log on to PeopleSoft with a user ID that has access to administer the portal pagelet content references.
2. Navigate to PeopleTools, Portal, and then Structure & Content.
3. Navigate to the Pagelets link, then the WebFOCUS pagelet folder. This is where the new content is registered.
4. Click Add Content Reference.
5. Enter the details for the new pagelet to be registered in the Content Reference Administration page. An example is shown below.

   Parameter	Value
   Name	IB_WEBFOCUS_DOMAIN
   Label	WebFOCUS Domain
   Usage Type	Pagelet
   Node Name	Always Use Local
   URL Type	PeopleSoft Script
   Record (Table) Name	WEBLIB_WEBFOCUS
   Field Name	IB_WEBFOCUS
   PeopleCode Event Name	FieldFormula
   PeopleCode Function Name	IScript_WebFOCUSDomain

6. Click Save.
7. Select the Security tab.
8. Select Public as access type. Security administrators should review access rights for this new folder.
9. Click Save.

The previous procedure describes how to register the Domain pagelet. The following table lists information for all the pagelets based upon the settings used in other sections of this document. Settings not listed remain consistent across all content references.

A reporting tab is not necessary for providing access to WebFOCUS pagelets. However, it does provide a way to separate transactional activities from certain types of reporting. For example, an HR Analyst may want a full page to use OLAP reporting functionality.

In most cases, WebFOCUS pagelets are spread across the My Page and additional tabbed pages. This layout allows WebFOCUS functionality to be deployed alongside transactional and non-transactional pagelets that have a similar business purpose for convenience to the user.

1. Log on to PeopleSoft with a user ID that has access to administer the portal homepage structure. For example:

   http://machinename:port/ps/signon.html

   where:

   machinename

   Is the host name of the PeopleSoft Application Server.

   port

   Is the port number where the PeopleSoft Application Server listens.

2. Navigate to PeopleTools, Portal, and then Structure & Content.
3. Navigate to Portal Objects, Homepage, and then Tabs.
4. Select the Add Content Reference link to define the new homepage.

   The following image shows the Content Ref Administration page of the General tab.

   

5. Enter the necessary information for defining a new tab in the content page. The table details some example parameters and values.

   Content Parameter	Value
   Name	WF_PAGE1
   Label	WebFOCUS
   Long Description	WebFOCUS Example Tab
   Object Owner ID	PeopleTools
   Usage Type	Homepage Tab

6. Click the Security tab to enable access to the new tab.
7. Select Public as access type. Security administrators should determine the appropriate level of access.
8. Select the Tab Content tab to add the WebFOCUS Pagelet content that is available to PeopleSoft users.
9. Locate the pagelet block that contains WebFOCUS pagelets. Select the Include All check box to enable all content to appear on the new tab.

   

   Note: In the example, the Report1 pagelet is set to Optional-Default. Set pagelet options based on site requirements.

10. Click Save.