Skip Headers
Oracle® Application Server Portal User's Guide
10g Release 2 (10.1.4)
B13809-04
  Go To Documentation Library
Home
Go To Product List
Solution Area
Go To Table Of Contents
Contents
Go To Index
Index

Previous
Previous
Next
Next
 

6 Preparing to Add Content

This chapter shows you all the different things you can do to the content in your page group to make it easier for your users to locate and work with the content. It contains the following main sections:

Intended Audience

The content of this chapter are intended for users with at least the Manage All privilege on a page group (that is, page group administrators). If a particular task requires different privileges, the required privileges will be listed before the steps of that task.

6.1 Things You Can Do with Content

Portals are all about bringing together the information that users need to do their jobs more effectively. Since managing business documents and other content is an important part of most jobs, and since the portal is the focal point for user collaboration and the logical location to publish and access business content, it only makes sense that content management features should be part of the OracleAS Portal framework.

6.2 Working with Attributes, Item Types, and Page Types

OracleAS Portal provides an assortment of base attributes, page types, and item types that you can expose to the user community. Each page and item type includes attributes that are used to store information about the page or item. If the base page and item types do not quite meet your requirements, you can create your own page and item types. This means that you can control what information is stored by specifying which attributes to include in page or item types. Furthermore, if the base attributes do not cover the kind of information you want to store about your pages or items, you can create your own attributes and add those to your page and item types. You can also control exactly which page and item types are made available to the users of your page groups.


Note:

One way to control the display of attributes in item regions is through the use of HTML content layout substitution tags. For more information, see Section 13.3.2, "Using HTML to Define the Layout and Appearance of Region Content".

OracleAS Portal also includes a selection of built-in extensible item types. If you do not want to create your own item types, you can edit these built-in item types to meet your requirements.

This section contains the following sub-sections:


Note:

Any user with at least the Manage Classifications privilege on a page group can create and manage attributes and types. To edit the built-in page and item types, you must have at least the Manage Classifications privilege on the Shared Objects page group.

6.2.1 Working with Attributes

There are two types of attributes:

Content Attributes

Content attributes are associated with item types and page types, and store information about an item or page, such as the associated category, description, or perspectives. These attributes are included in the add and edit pages where users can provide information about the item or page they are adding or editing. Page group administrators can create their own item types and page types and specify exactly what information they want users to supply by choosing which attributes to include. In addition, page group administrators can create their own attributes for containing extra information.

For a list of the content attributes provided by default, see Section A.2.1, "Base Content Attributes".

Display Attributes

Display attributes are associated with regions, and display information about an item or portlet, such as the author, display name, and creation date. Page designers can choose which attributes to display in a region. Some content attributes can also be used as display attributes. See Section 11.2.9, "Changing the Attributes Displayed in a Region".

For a list of the display attributes provided by default, see Section A.2.2, "Base Display Attributes".

6.2.1.1 Creating an Attribute

To create an attribute:

  1. In the Navigator, click the link for the page group in which you want to create the attribute.

    To get to the Navigator click the Navigator link on any page. By default you can find a Navigator link on the Portal Builder page.

  2. Click the Attributes link.


    Tip:

    If you create an attribute in a particular page group, that attribute is available only in that page group. If you want the attribute to be available in multiple page groups, either create it in the Shared Objects page group, or (if the attribute already exists) promote it to the Shared Objects page group. See Section 4.6, "Sharing Objects Across Page Groups".

  3. Next to Create New, click the Attribute link.

  4. In the Display Name field, enter a descriptive name for the attribute. The display name is displayed as a label for the attribute whenever the attribute is used.

    Use up to 256 characters of any kind, including spaces. Although the attribute display name has no enforced uniqueness requirement, consider keeping it unique across your page groups. If you do not, users see duplicate names on attribute pick-lists, and are unable to determine which attribute belongs to which page group. For example, attributes display on a pick-list when a user creates a custom item type or selects custom search criteria.

  5. From the Datatype list, choose the type of data that the attribute will store.

    • Boolean stores a value of 1 (for TRUE) or 0 (for FALSE).

    • Date stores a date in the format DD-MON-YYYY HH12:MI PM, for example, 20-SEP-2004 10:57 AM.

    • File stores a file, such as a Microsoft Excel spreadsheet or an HTML document.

    • Number stores a numeric value, for example, 8479.

    • PL/SQL stores PL/SQL code, for example, htp.print('Hello World');

    • Text stores a text string.

    • URL stores the URL of a Web site or Web page, for example, http://www.oracle.com.

  6. Click Create.

  7. Click Close.

6.2.1.2 Editing an Attribute

You can specify how an attribute is displayed when users add or edit an item or page of a type that includes the attribute. For example, you can change the label for the attribute by editing the attribute's display name.

To edit an attribute:

  1. Use the Navigator to browse to the attribute that you want to edit.

    To get to the Navigator click the Navigator link on any page. By default you can find a Navigator link on the Portal Builder page.


    Tip:

    If the attribute is shared, it will be in the Shared Objects page group. See Section 4.6, "Sharing Objects Across Page Groups"

  2. In the row for the attribute, click the Edit link.

    This opens the Edit Attribute page. The options available on this page vary a little from those options available when you first create the attribute. Notably, the page includes a Name attribute.

  3. In the Name field, edit the name of the attribute. The name is used internally only.

    The default value in the Name field is taken from the Display Name provided when the attribute was created. Spaces and special characters are discarded.

    For example, if the Display Name is R & D Team Lead, the Name is RDTeamLead.

    The Name is not case sensitive. It must be unique within its page group and the Shared Objects page group. Use up to 256 alphanumeric characters (A to Z, a to z, 0 to 9) and the underscore character (_); spaces and other special characters are not allowed.

  4. In the Display Name field, edit the descriptive name of the attribute. The Display Name identifies the attribute to other users. It is used in the Portal Navigator and as the label for the attribute value wherever the attribute is used.

    Use up to 256 characters of any kind, including spaces. Any change you make here does not affect the value in the Name field. Changes to the attribute Display Name are not reflected immediately on cached pages. To make the change display immediately, you must clear the page group's cache. Go to the Access tab of the page group that owns the attribute, and click the Clear Cache link.

    Although the attribute display name has no enforced uniqueness requirement, we recommend that you try to keep it unique across your page groups. If you do not, users will see duplicate names on attribute pick-lists, and will be unable to determine which attribute belongs to which page group. For example, attributes display on a pick-list when a user creates a custom item type or selects custom search criteria.

  5. Select Enable Translations if you want users to be able to translate the values stored in the attribute into different languages.

    If you clear this check box, the values stored in the attribute will be the same in all languages.

  6. For Date, Number, and URL attributes:

    In the List Of Values field, enter the name of a list of values from which users can choose a value for the attribute. If you are not sure of the name of the list of values, click the List icon and select from the list provided.


    Note:

    The list of values must already exist. Multi-valued attributes are not supported for lists of values. That is, users are able to choose only one value from an attribute list of values. This means that attribute values can be displayed in combo boxes and pop-ups, but not as check boxes, drop-down lists, or radio buttons.

  7. For PL/SQL attributes:

    In the PL/SQL Execute Options radio group, select which privileges to use when executing the PL/SQL stored in the attribute:

    • Public executes the PL/SQL with the privileges of the OracleAS Portal PUBLIC schema.

    • Creator executes the PL/SQL with the privileges of the schema associated with the user who created the item or page that includes the PL/SQL attribute.

    • Schema executes the PL/SQL with the privileges of a specific schema. If you select this radio button, enter the name of the schema in the field provided. If you are not sure of the name of the schema, click the Browse Database Schemas icon and select from the list provided.

  8. For Text attributes:

    1. In the Length field, enter the number of characters the attribute can store. Values can be provided only when the Display Option is Single-line Field or Multi-line Field.

    2. In the Display Option radio group, select how to display the attribute when users add or edit an item or page of a type that includes the attribute:

      • Single-line Field displays the attribute as a field that contains a single line of text.

      • Multi-line Field displays the attribute as a field that contains multiple lines of text.

      • List Of Values displays the attribute as a list from which users can choose a value.

        If you select this radio button, enter the name of the list of values in the field provided. If you are not sure of the name of the list of values, click the List icon and select from the list provided.


        Note:

        The list of values must already exist. Multi-valued attributes are not supported for lists of values. That is, users are able to choose only one value from an attribute list of values. This means that attribute values can be displayed in combo boxes and pop-ups, but not as check boxes, drop-down lists, or radio buttons.

  9. Click OK.

6.2.1.3 Deleting an Attribute

When you delete an attribute, you also remove the attribute and its values from any items and pages that include it.

Take care when deleting an attribute from the Shared Objects page group. Attributes in the Shared Objects page group may be used across page groups. Deleting an attribute from Shared Objects removes it from all page groups that use it.

To delete an attribute:

  1. Use the Navigator to browse to the attribute that you want to delete.

  2. In the row for the attribute, click the Delete link.

  3. In the confirmation page, click Yes.

6.2.2 Working With Item Types

Item types define the contents of an item and the information that is stored about an item. The information stored about an item is determined by the attributes of the item type.

By default, OracleAS Portal includes several base item types to cover the most common content that contributors will want to add. OracleAS Portal also includes several built-in custom item types so that content contributors can get started adding content right out of the box. For a complete list of base and built-in item types, see Section A.4, "Base Item Types".

However, you may find that you want to store more information about your items than the built-in item types allow. If this is the case, you can extend the built-in item types to meet your requirements. You can add different attributes to the built-in item types to store exactly the information that you want. You can also add calls to PL/SQL and HTTP procedures and even pass attributes to the parameters of those procedures. For example, if the Review item type includes a Search attribute to store a search string, you could add a procedure call to a search engine and pass the search string to that search engine. When users run the search engine, the search results for the search string are displayed.

If you prefer, you can create your own item types. You can base an item type on one of the base item types. Basing your item type on a base item type means that your item type will inherit certain attributes. You can then extend your item type to include other attributes and procedure calls. You can also choose to base your item type on none of the base item types (choose <None> from the Base Item Type list), which gives you complete control over the attributes included in the item type.

6.2.2.1 Creating an Item Type

To create an item type:

  1. In the Navigator, click the link for the page group in which you want to create the item type.

    To get to the Navigator click the Navigator link on any page. By default you can find a Navigator link on the Portal Builder page.


    Tip:

    If you create an item type in a particular page group, that item type is available only in that page group. If you want the item type to be available in multiple page groups, either create it in the Shared Objects page group, or (if the item type already exists) promote it to the Shared Objects page group. See Section 4.6, "Sharing Objects Across Page Groups".

  2. Click the Item Types link.

  3. Next to Create New, click the Item Type link.

  4. In the Display Name field, enter a descriptive name for the item type. The display name is used in the Portal Navigator and the Add Item Item Type list, so shorter display names are better.

    Use up to 256 characters of any kind, including spaces.

  5. From the Base Item Type list, choose the base item type from which you want your item type to inherit attributes. You can choose from None, Base File, Base Image Map, Base Image, Base PL/SQL, Base Page Link, Base Text, and Base URL.

  6. Click Create.

  7. Click Close.

6.2.2.2 Editing an Item Type

When you first create an item type, it includes exactly the same attributes as the base item type on which you based it. If you chose <None> as the base item type, your new item type includes only the Display Name attribute. To truly customize the item type, you need to edit it to add more attributes, and possibly procedure calls.


Note:

You cannot edit the base item types. However you can extend the built-in item types.

6.2.2.2.1 Editing the Basic Properties of an Item Type

To edit the basic properties of an item type:

  1. Use the Navigator to browse to the item type that you want to edit.

    To get to the Navigator click the Navigator link on any page. By default you can find a Navigator link on the Portal Builder page.


    Note:

    If the item type is shared (or is one of the built-in item types), it will be in the Shared Objects page group. See Section 4.6, "Sharing Objects Across Page Groups"

  2. In the row for the item type, click the Edit link.

    This opens the Edit Item Type page. The options available on this page vary a little from those options available when you first create the item type. Notably, the page includes a Name attribute.

  3. In the Name field, edit the name of the item type. The name is used internally only.

    The default value in the Name field is created from the Display Name provided for the item type when it was created. The Name is truncated to 30 characters and all spaces and special characters are discarded. For example, if the Display Name is Science & Math Images, the Name is ScienceMathImages.

    The Name is not case sensitive. It must be unique within its page group and the Shared Objects page group. Use up to 30 alphanumeric characters (A to Z, a to z, 0 to 9) and the underscore character (_); spaces and other special characters are not allowed.

  4. In the Display Name field, edit the descriptive name of the item type. The Display Name identifies the item type to other users. It is used in the Portal Navigator and Add Item Item Type list, so shorter display names are better.

    Use up to 256 characters of any kind, including spaces. Changes to the item type Display Name are not reflected immediately on cached pages. To make the change display immediately, you must clear the page group's cache. Go to the Access tab of the page group that owns the item type, and click the Clear Cache link.

    Any change you make here does not affect the value in the Name field.

  5. In the Description field, enter information about the item type that may be useful to others, such as its arguments, functionality, or usage. The description is displayed only when editing the item type.

  6. In the Icon field, enter the path and file name of an image to associate with the item type. Click Browse to locate the image if you are not sure of its path or file name. When you click Apply or OK, the file is uploaded to the Oracle Application Server Metadata Repository.


    Note:

    This icon is not currently used within OracleAS Portal. The icon may be used in future releases.

  7. You can create your own help to display when users click the context sensitive help icon while adding an item of this type. To associate your custom help with the item type, enter the URL of the help in the Help URL For Add Item Wizard field

  8. You can also create your own help to display when users click the context sensitive help icon while editing an item of this type. To associated your custom help with the item type, enter the URL of the help in the Help URL For Edit Item Wizard field.

  9. Click OK.

6.2.2.2.2 Adding Attributes to an Item Type

To add attributes to an item type:

  1. Use the Navigator to browse to the item type that you want to edit.

    To get to the Navigator click the Navigator link on any page. By default you can find a Navigator link on the Portal Builder page.


    Tip:

    If the item type is shared (or is one of the built-in item types), it will be in the Shared Objects page group. See Section 4.6, "Sharing Objects Across Page Groups"

  2. In the row for the item type, click the Edit link.

  3. Click the Attributes tab.

  4. In the Available Attributes list, select the attributes that you want to add to the item type.

  5. Click the Move icon to move the selected attributes to the Selected Attributes list.

    The order of attributes in the Selected Attributes list determines the order in which the attributes are displayed when users add or edit an item of this type. Use the icons to the right of the list to change the order.

  6. Click Apply to add the attributes to the item type.

  7. When you have added the attributes, you can change their display properties if necessary:

    1. In the Default Value field, enter the value to use by default for the attribute. If content contributors do not specify a value for the attribute, the default value is used. If you provide a default value, contributors will not be able to set the attribute to a null value, they can only replace the default value with another non-null value. You can leave this field blank if you prefer.

      Multi-valued attributes are not supported for lists of values. That is, users are able to choose only one value from an attribute list of values. This means that attribute values can be displayed in combo boxes and pop-ups, but not as check boxes, drop-down lists, or radio buttons.

      If you are suppling a default value for the base item link item type, you must enter the target item's globally unique identifier (GUID), which you can determine through the item's property sheet. The GUID is the alpha-numeric value at the end of the item's Item Link, for example F43069B7A66E553AE030B98B6C883291. Using the GUID is also a way to provide a default value for an item that belongs to another page group--a normally prohibited action. Using any other type of item identifier for the default value, such as the item's internal name, results in an error when users try to add the custom item to a page.

      You can use PL/SQL expressions and function calls to determine the default value for an attribute. You must precede the expression or function call with a # character. The function being called must already exist in the database and must be prefixed with its owning schema.

      For example:

      - To set the default value of the Author attribute to the current user, you would set the default value of the attribute to #USER#.

      - To set the default value of the Publish Date attribute to the first day of the month, you would set the default value of the attribute to #TO_CHAR(LAST_DAY(SYSDATE)+1, 'DD-MON-YYYY HH12:MI PM').

      - To set the default value of a custom Project ID attribute to the current project to which the current user is assigned, you would first need a function that returns the ID of the project. The function might be something like the following (assuming that a user is assigned to only one project on any specified date):

      create function GET_CURRENT_PROJECT return VARCHAR2 as  project_id VARCHAR2 (30);begin  select pa.id   into project_id  from project_asignments pa  where SYSDATE between pa.start and pa.end --selects current assignment   and pa.assignee = WWCTX_API.GET_USER; --gets name of current user  return project_id;end;
      

      If the GET_CURRENT_PROJECT function was created in the PROJECTS schema, you would set the default value of the Project ID attribute to #PROJECTS.GET_CURRENT_PROJECT.


      Note:

      You cannot pass attribute values as parameters to a function when it is called from an attribute default value. You can however pass PL/SQL expressions as parameters. You can use expressions and function calls only for the default values of attributes, not for the actual values of attributes. If you are using an expression to determine the default value of a date attribute, you must make sure that the date value is converted to the DD-MON-YYYY HH12:MI PM date format as shown in the second example described earlier.

    2. Select the Required check box if you want it to be mandatory for content contributors to provide a value for the attribute. The Required icon will be displayed next to the attribute when contributors add or edit an item of this type.

      If you do not select this check box, content contributors do not need to provide a value for the attribute.

    3. Clear the Add Wizard check box if you do not want to display the attribute on the Add Item Wizard.

      For example, to make it easier for content contributors to add an item of this type, you might want to limit the number of attributes displayed on the Add Item Wizard. Contributors can provide values for the extra attributes when they edit the item.

    4. Clear the Edit Wizard check box if you do not want to display the attribute on the Edit Item pages.

      For example, if you want to supply a default value for an attribute, and do not want content contributors to be able to change that value, clear both the Add Wizard and Edit Wizard check boxes so that the attribute does not display in the wizards.

      You could create an item type called Performance Review and add the Expiration Period attribute to it. You set a default value for the attribute, 01-JAN-2003, so that every Performance Review item added by users expires on this date. Since users do not need to know about or edit this date, you clear the Add Wizard and Edit Wizard check boxes for the attribute. When users add and edit their performance review items, they will not see the Expiration Period attribute even though it is stored for each item.

  8. Click OK.

To remove attributes from the item type, select the attributes in the Selected Attributes list, and click the Remove icon.


Tip:

If you intend any of the attributes that you add to include important information that you want users to see immediately, you should instruct page designers to display those attributes in the regions on their pages. See Section 11.2.9, "Changing the Attributes Displayed in a Region"

6.2.2.2.3 Adding a Procedure Call to an Item Type

For an example of how you might use a procedure call in an item type, see:


Note:

The total length of the procedure call (including any parameters) must not exceed 2000 bytes. If the item procedure has too many parameters or parameter values with a large number of characters, some of the parameters or parameter values will be excluded to ensure that the limit is not reached.

To add a procedure call to an item type:

  1. Use the Navigator to browse to the item type that you want to edit.

    To get to the Navigator click the Navigator link on any page. By default you can find a Navigator link on the Portal Builder page.


    Tip:

    If the item type is shared (or is one of the built-in item types), it will be in the Shared Objects page group. See Section 4.6, "Sharing Objects Across Page Groups"

  2. In the row for the item type, click the Edit link.

  3. Click the Procedures tab.

  4. From the Type list, choose whether the call is to an HTTP or PL/SQL procedure.

  5. In the Procedure Call field, enter one of the following:

    • The URL of the HTTP procedure, including the protocol used to access it, for example:

      http://www.mycompany.com/search/index.html
      
      
    • The name of the PL/SQL procedure. The procedure must already exist in the database and must be prefixed with its owning schema, for example:

      SCOTT.MY_PROC
      
      

      The PUBLIC user must be granted execute privileges on the procedure.

  6. In the Link Text field, enter the text to display as a hypertext link that users can click to execute the procedure call.

    This link is displayed only if the region containing the item displays the Associated Function attribute and you do not select Display Procedure Results With Item, or you have not specified an icon. For information about adding the Associated Function attribute to a region, see Including an Item Type's Procedure Call on a Page.

  7. In the Icon field, enter the path and file name of an image to associate with this procedure call. If you specify an icon, it is used instead of the Link Text, however you must still enter a value in the Link Text field to serve as the image's rollover text.

    Click Browse to locate the image if you are not sure of its path or file name.

  8. Select Display Procedure Results With Item to display the results of the procedure call directly in the page instead of displaying a link for users to click. This makes the results immediately visible to users, rather than requiring them to click a link to execute the procedure call themselves.

  9. If the procedure you are calling has parameters, you can pass values to those parameters using the item type's attributes.

    1. In the Attribute list, choose the attribute whose values you want to pass to a parameter in the procedure.

    2. In the Pass As field, enter the parameter name if it is different from the attribute name.

  10. Click Apply to add the procedure call to the item type.

  11. Click OK.

To remove a procedure call from the item type, click the Delete Procedure icon next to the procedure call in the Existing Procedure Calls section.

To edit an existing procedure call, for example, to add more parameter/attribute mappings, click the Edit Procedure icon next to the procedure call in the Existing Procedure Calls section. Remember to click Apply to save your changes.

Example 6-1 Adding an HTTP Procedure Call to an Item Type

Imagine that your portal provides movie reviews to subscribers. To customize the hundreds of movie reviews you plan to upload, you create a Movie Review item type to use for each review. Knowing that users will want to find additional information about each movie, you decide to include a link to a search engine within the review.

To include this link, you choose HTTP as the procedure type, and add the following to the Procedure Call field (Figure 6-1):

http://www.google.com/search

You include the Link Text Click here for more..., and you specify an icon to associate with the procedure. You choose not to display the procedure results with the item because you want users to click the icon to access the search.

For the search engine to return information about the appropriate movie, you need to pass it the movie title. Say your Movie Review item type includes an attribute called Movie Title. To pass the value in this attribute to the search engine, you select it in the Attribute list (you could also use the Display Name attribute if it is used to store the title of the movie).

Finally, you need to make sure that the attribute value is sent to the correct search engine parameter. In the case of Google, the search parameter name is q, so you enter this name in the Pass As field (Figure 6-2).

This information is appended to the Procedure Call as follows:

http://www.google.com/search?q=<MovieTitle>

Each movie review will now include a link to a customized search based on the movie title (Figure 6-3).

When users click the specified icon, the customized search content (based on the movie title) displays (Figure 6-4). The movie title, which is the search criteria, displays at the top of the search results page.

Figure 6-1 Adding an HTTP Procedure Call to an Item Type

Description of Figure 6-1  follows
Description of "Figure 6-1 Adding an HTTP Procedure Call to an Item Type"

Figure 6-2 Passing Attribute Values to HTTP Procedure Parameters

Description of Figure 6-2  follows
Description of "Figure 6-2 Passing Attribute Values to HTTP Procedure Parameters"

Figure 6-3 Example Movie Review Item

Description of Figure 6-3  follows
Description of "Figure 6-3 Example Movie Review Item"

Figure 6-4 Example Movie Review Procedure Call Results

Description of Figure 6-4  follows
Description of "Figure 6-4 Example Movie Review Procedure Call Results"

Example 6-2 Adding a PL/SQL Procedure Call to an Item Type

Imagine that you have written the following procedure that displays the creator and create date of an object in an HTML table:

--
-- procedure display_attributes
-- created Monday 17-JUN-2002 10:35
--
create or replace
procedure display_attributes (
  p_creator in varchar2,
  p_create_date in varchar2)
as
begin
  htp.p('<table><tr><td><b>Creator:</b></td>'
  || '<td>' || p_creator || '</td></tr>'
  || '<tr><td><b>Create Date:</b></td>'
  || '<td>' || p_create_date || '</td></tr>'
  || '</table>');
exception
when others then
  htp.p(sqlerrm);
end;

You can add a call to this procedure to an item type (My Item Type) so that this information is displayed for items of that type.

First you choose PL/SQL as the Procedure Type, and then add the following to the Procedure Call field (Figure 6-5):

<schema>.DISPLAY_ATTRIBUTES

You include the link text Display Attributes, and you specify an icon to associate with the procedure.

For the procedure to return the appropriate attribute values, you need to pass it the attribute names. Your procedure includes two parameters: p_creator and p_create_date. You need to pass these two parameters information from the Creator and Create Date attributes (Figure 6-6).

Each item of type My Item Type will now include a link to run the procedure (Figure 6-7).

When users click the specified icon, the additional attributes are displayed as an HTML table (Figure 6-8).

Figure 6-5 Adding a PL/SQL Procedure Call to an Item Type

Description of Figure 6-5  follows
Description of "Figure 6-5 Adding a PL/SQL Procedure Call to an Item Type"

Figure 6-6 Passing Attribute Values to PL/SQL Procedure Parameters

Description of Figure 6-6  follows
Description of "Figure 6-6 Passing Attribute Values to PL/SQL Procedure Parameters"

Figure 6-7 Example My Item Type Item

Description of Figure 6-7  follows
Description of "Figure 6-7 Example My Item Type Item"

Figure 6-8 Example My Item Procedure Call Results

Description of Figure 6-8  follows
Description of "Figure 6-8 Example My Item Procedure Call Results"

6.2.2.2.4 Including an Item Type's Procedure Call on a Page

If an item type includes a procedure call, the link to execute the procedure call will be displayed with an item of that type only if the Associated Functions attribute is displayed in the region that contains the item.

To include an item type's procedure call on a page:

  1. Go to the page to which you want to add the link.

    For information on locating a page, see Section 9.1, "Locating Pages in OracleAS Portal".

  2. Switch to Edit mode.

  3. In the region to which you want to add the link, click the Edit Region icon.

  4. Click the Attributes/Style tab.

  5. In the Available Attributes list, select Associated Function.

  6. Click the Move arrow.

  7. Click Apply.

  8. Click Close.

6.2.2.3 Making an Item Type Available to a Page Group

When you create an item type, it is not immediately available for use by content contributors. This is because you will probably want to edit the item type first to add attributes and procedure calls. When you are happy with the item type, and are ready for content contributors to start adding items of that type, you must make the item type available in the page group.

To make an item type available to a page group:

  1. From the Page Groups portlet's Work In drop-down list, choose the page group to be edited.

    By default, the Page Groups portlet is located on the Build tab of the Builder page.

  2. Click the Configure tab.

  3. In the Types and Classification section, click the Edit link.


    Note:

    You can also reach the Configure Types and Classification page by clicking the configure the list of available item types link on the first page of the Add Item Wizard.

  4. From the Hidden Item Types list, select the item type that you want to make available.

    The Hidden and Visible Item Type lists include all the item types owned by this page group and the Shared Objects page group.

  5. Click the Move icon to move the selected item type into the Visible Item Types list.

    The order of item types in the Visible Item Types list determines the order when items in a region are grouped by item type. For information about how to group items by item type, see Section 11.2.10, "Grouping Items in a Region".

  6. Click OK to return to the Configure tab.

  7. Click Close.

You can also exclude an item type from a page group, meaning that content contributors cannot add items of that type to pages in the page group. For example, if you have created your own item types, you might want to exclude some of the built-in item types from the page group. To do this, select the item type in the Visible Item Type list and click the Remove icon.

6.2.2.4 Deleting an Item Type

When you delete an item type, all items of that type are also deleted. You cannot undo this action.

Take care when deleting an item type from the Shared Objects page group. Item types in the Shared Objects page group may be used across page groups. Deleting an item type from Shared Objects removes it from all page groups that use it.


Note:

If you delete an item type that is one of the selected Default WebDAV Types (on the Items tab of page properties), the option that used that type (either Default Regular Files, Default Zip Files, or Default Image Files) is reset to Inherit from Parent Page - [File/Zip File/File].

To delete an item type:

  1. Use the Navigator to browse to the item type that you want to delete.

    To get to the Navigator click the Navigator link on any page. By default you can find a Navigator link on the Portal Builder page.


    Tip:

    If the item type is shared, it will be in the Shared Objects page group. See Section 4.6, "Sharing Objects Across Page Groups"

  2. In the row for the item type, click the Delete link.

  3. In the confirmation page, click Yes.

6.2.3 Working with Page Types

Page types define the contents of a page and the information that is stored about a page. The information stored about a page is determined by the attributes of the page type.

By default, OracleAS Portal includes several base page types so that page managers can get started creating pages right out of the box. Base page types include:

  • Standard—These contain and manage items, portlets, tabs, and sub-page links.

  • URL—These provide a route to another Web page, identified by its URL. When a user clicks the page link, the Web page referenced by the link is displayed.

  • PL/SQL—These consist of PL/SQL code that executes when the pages are rendered.

  • JavaServer Pages (JSPs)—These are an extension to servlet functionality that provides a simple programmatic interface to Web pages. JSPs are HTML pages with special tags and embedded Java code that is executed on the Web or application server. JSPs provide dynamic functionality to HTML pages. They are compiled into servlets when first requested, and they run in the servlet container.

For a complete list of base page types, see Section A.3, "Base Page Types".

You may find that you want to store more information about your pages than the base page types allow. If this is the case, you can create your own page types. You base your page type on one of the base page types. The page type automatically inherits all of the base page type's attributes. But, after you create your page type, you can edit it to add other attributes that are specific to your requirements. These attributes can be other default OracleAS Portal attributes, or attributes that you have created yourself.

In addition to adding attributes to page types, you can also add calls to PL/SQL or HTTP procedures. You can pass attributes as parameters to those procedures if required.

6.2.3.1 Creating a Page Type

To create a page type:

  1. In the Navigator, click the link for the page group in which you want to create the page type.

    To get to the Navigator click the Navigator link on any page. By default you can find a Navigator link on the Portal Builder page.


    Tip:

    If you create a page type in a particular page group, that page type is available only in that page group. If you want the page type to be available in multiple page groups, either create it in the Shared Objects page group, or (if the page type already exists) promote it to the Shared Objects page group. See Section 4.6, "Sharing Objects Across Page Groups"

  2. Click the Page Types link.

  3. Next to Create New, click the Page Type link.

  4. In the Display Name field, enter a descriptive name for the page type. The Display Name identifies the page type to other users. It is used in the Portal Navigator and Create Page Page Type list, so shorter display names are better.

    Use up to 256 characters of any kind, including spaces.

  5. From the Base Page Type list, choose the base page type from which you want your page type to inherit attributes. You can choose from Standard, PL/SQL, or URL.

  6. Click Create.

  7. Click Close.

6.2.3.2 Editing a Page Type

When you first create a page type, it is exactly the same as the base page type from which you chose to inherit attributes. To truly customize the page type, you need to edit it to add more attributes, and possibly procedure calls.


Note:

You cannot edit the base page types.

6.2.3.2.1 Editing the Basic Properties of a Page Type

To edit the basic properties of a page type:

  1. Use the Navigator to browse to the page type that you want to edit.

    To get to the Navigator click the Navigator link on any page. By default you can find a Navigator link on the Portal Builder page.


    Tip:

    If the page type is shared, it will be in the Shared Objects page group. See Section 4.6, "Sharing Objects Across Page Groups"

  2. In the row for the page type, click the Edit link.

    This opens the Edit Page Type page, displaying the Main tab. The attributes available on the Main tab vary a little from the attributes available when you first create the page type. Notably, the Main tab includes a Name attribute.

  3. In the Name field, edit the name of the page type. The name is used internally only.

    The default value in the Name field is created from the Display Name provided for the page type when it was created. The Name is truncated to 30 characters and all spaces and special characters are discarded. For example, if the Display Name is Research & Development, the Name is ResearchDevelopment.

    The Name is not case sensitive. It must be unique within its page group and the Shared Objects page group. Use up to 30 alphanumeric characters (A to Z, a to z, 0 to 9) and the underscore character (_); spaces and other special characters are not allowed.

  4. In the Display Name field, edit the descriptive name of the page type. The Display Name identifies the page type to other users. It is used in the Portal Navigator and Create Page Page Type list, so shorter display names are better.

    Use up to 256 characters of any kind, including spaces. Changes to the page type Display Name are not reflected immediately on cached pages. To make the change display immediately, you must clear the page group's cache. Go to the Access tab of the page group that owns the page type, and click the Clear Cache link.

    Any change you make here does not affect the value in the Name field.

  5. In the Description field, enter information about the page type that may be useful to others, such as its arguments, functionality, or usage. The description is displayed only when editing the page type.

  6. In the Icon field, enter the path and file name of an image to associate with the page type. Click Browse to locate the image if you are not sure of its path or file name. When you click Apply or OK, the file is uploaded to the Oracle Application Server Metadata Repository.


    Note:

    This icon is not currently used within OracleAS Portal. The icon may be used in future releases.

  7. Click OK.

6.2.3.2.2 Adding Attributes to a Page Type

To add attributes to a page type:

  1. Use the Navigator to browse to the page type that you want to edit.

    To get to the Navigator click the Navigator link on any page. By default you can find a Navigator link on the Portal Builder page.


    Tip:

    If the page type is shared, it will be in the Shared Objects page group. See Section 4.6, "Sharing Objects Across Page Groups"

  2. In the row for the page type, click the Edit link.

  3. Click the Attributes tab.

  4. In the Available Attributes list, select the attributes that you want to add to the page type.

  5. Click the Move icon to move the selected attributes to the Selected Attributes list.

    The order of attributes in the Selected Attributes list determines the order in which the attributes are displayed when users create or edit a page of this type. Use the icons to the right of the list to change the order.

  6. Click Apply to add the attributes to the page type.

  7. When you have added the attributes, you can change their display properties if necessary:

    1. In the Default Value field, enter the value to use by default for the attribute. If page managers do not specify a value for the attribute, the default value is used. You can leave this field blank if you prefer.

      Multi-valued attributes are not supported for lists of values. That is, users are able to choose only one value from an attribute list of values. This means that attribute values can be displayed in combo boxes and pop-ups, but not as check boxes, drop-down lists, or radio buttons.

    2. Select the Required check box if you want it to be mandatory for page managers to provide a value for the attribute. The attribute will be displayed on the first page of the Create Page Wizard, and the Main tab of the Edit Page page.

      If you do not select this check box, page managers do not need to provide a value for the attribute and the attribute will be displayed on the Optional tab of the Edit Page page.

  8. Click OK.

To remove attributes from the page type, select the attributes in the Selected Attributes list, and click the Remove icon.

6.2.3.2.3 Add a Procedure Call to a Page Type

For an example of how you might use a procedure call in a page or item type, see Example 6-1, "Adding an HTTP Procedure Call to an Item Type" or Example 6-2, "Adding a PL/SQL Procedure Call to an Item Type".

To add a procedure call to a page type:

  1. Use the Navigator to browse to the page type that you want to edit.

    To get to the Navigator click the Navigator link on any page. By default you can find a Navigator link on the Portal Builder page.


    Tip:

    If the page type is shared, it will be in the Shared Objects page group. See Section 4.6, "Sharing Objects Across Page Groups"

  2. In the row for the page type, click the Edit link.

  3. Click the Procedures tab.

  4. From the Type list, choose whether the call is to an HTTP or PL/SQL procedure.

  5. In the Procedure Call field, enter one of the following:

    • The URL of the HTTP procedure, including the protocol used to access it, for example:

      http://www.oracle.com/search/index.html
      
      
    • The name of the PL/SQL procedure. The procedure must already exist in the database and must be prefixed with its owning schema, for example:

      SCOTT.MY_PROC
      
      

      The PUBLIC user must be granted execute privileges on the procedure.

  6. In the Link Text field, enter the text to display as a hypertext link that users can click to execute the procedure call.

    This link is displayed only if the page includes a Page Function item and you do not select Display Procedure Results With Page, or you have not specified an icon. For information about adding a Page Function item to a page, see Including a Page Type's Procedure Call on a Page.

  7. In the Icon field, enter the path and file name of an image to associate with this procedure call. If you specify an icon, it is used instead of the Link Text, however you must still enter a value in the Link Text field to serve as the image's rollover text.

    Click Browse to locate the image if you are not sure of its path or file name.

  8. Select Display Procedure Results With Page to display the results of the procedure call directly in the page instead of displaying a link for users to click. This makes the results immediately visible to users, rather than requiring them to click a link to execute the procedure call themselves.

  9. If the procedure you are calling has parameters, you can pass values to those parameters using the page type's attributes.

    1. In the Attribute list, choose the attribute whose values you want to pass to a parameter in the procedure.

    2. In the Pass As field, enter the parameter name if it is different from the attribute name.

  10. Click Apply to add the procedure call to the page type.

  11. Click OK.

To remove a procedure call from the page type, click the Delete Procedure icon next to the procedure call in the Existing Procedure Calls section.

To edit an existing procedure call, for example, to add more parameter/attribute mappings, click the Edit Procedure icon next to the procedure call in the Existing Procedure Calls section. Remember to click Apply to save your changes.

6.2.3.2.4 Including a Page Type's Procedure Call on a Page

If a page type includes a procedure call, the link to execute the procedure call will be displayed in a page of that type only if a Page Function item is added to the page.

To include a page type's procedure call on a page:

  1. Go to the page where you want to add the Page Function item.

    For information on locating a page, see Section 9.1, "Locating Pages in OracleAS Portal".

  2. Switch to Edit mode.

  3. In the region where you want to add the Page Function item, click the Add Item icon.

    If you do not see the Add Item icon, the region may be a portlet region, in which case, you cannot add items to this region.

  4. From the Built-In Navigation Item Types list, choose Page Function.

    If there are no page functions associated with the current page, this item type is not displayed. If you know there are page functions, but this item type does not appear in the list, contact your page group administrator. Your administrator selects which item types to display here.

    If you do not see Page Function in the list, the page may not have any page functions associated with it or the Page Function item type may not have been included in the page group. For information about how to include this item type, see Section 6.2.2.3, "Making an Item Type Available to a Page Group".

  5. Click Next.

  6. From the Page Function list, choose the page function that you want to include in the page.

  7. Click Finish.

6.2.3.3 Making a Page Type Available to a Page Group

When you create a page type, it is not immediately available for use by page creators. This is because you will probably want to edit the page type first to add attributes and procedure calls. When you are happy with the page type, and are ready for page creators to start creating pages of that type, you must make the page type available in the page group.

To make a page type available to a page group:

  1. From the Page Groups portlet's Work In drop-down list, choose the page group to be edited.

    By default, the Page Groups portlet is located on the Build tab of the Builder page.

  2. Click the Configure tab.

  3. In the Page Defaults section, click the Edit link.


    Note:

    You can also reach the Configure Types and Classification page by clicking the Configure link on the first page of the Create Page Wizard.

  4. From the Hidden Page Types list, select the page type that you want to make available.

    The Hidden and Visible Page Type lists include all the base page types, and the page types owned by this page group and the Shared Objects page group.

  5. Click the Move icon to move the selected page type into the Visible Page Types list.

    The order of page types in the Visible Page Types list determines the order in which the page types are displayed in the Page Type list when creating a page.

  6. Click OK to return to the Configure tab.

  7. Click Close.

You can also exclude a page type from a page group, meaning that page creators cannot create pages of that type in the page group. For example, if you have created your own page types, you might want to exclude some of the base page types from the page group. To do this, select the page type in the Visible Page Type list and click the Remove icon.

6.2.3.4 Deleting a Page Type

When you delete a page type, all pages of that type and all the items in those pages are also deleted. You cannot undo this action.

Take care when deleting a page type from the Shared Objects page group. Page types in the Shared Objects page group may be used across page groups. Deleting a page type from Shared Objects removes it from all page groups that use it.


Note:

You cannot delete the base page types.

To delete a page type:

  1. Use the Navigator to browse to the page type that you want to delete.

    To get to the Navigator click the Navigator link on any page. By default you can find a Navigator link on the Portal Builder page.


    Tip:

    If the page type is shared, it will be in the Shared Objects page group. See Section 4.6, "Sharing Objects Across Page Groups"

  2. In the row for the page type, click the Delete link.

  3. In the confirmation page, click Yes.

6.3 Setting Up Content Classification

It is important to classify your content in OracleAS Portal as this improves its findability. By setting up an appropriate filing system and using it in a consistent way, you will help other users to find your content and allow them to determine whether it is of interest.

This section describes:

Once suitable categories and perspectives are set up for your portal, you and other users can start to classify OracleAS Portal content. See, Section 8.4, "Classifying a Page"and Section 15.4.2, "Classifying the Content of an Item".

6.3.1 Working with Categories

Categories answer the question "What is this item or page?" and are used to classify content. Sales Report, Action Item, Corporate Graphic, and Location Maps are all examples of typical categories. The purpose of categories is to enable users to quickly display a listing of a particular type of content. For example, if you want users to be able to quickly access all of the company's sales reports, you could create a category called Sales Report. When a user adds an item or page to the page group, they can assign it to the Sales Report category. To find all of the available sales reports, other users can search on the Sales Report category to see a listing of pages and items that belong to that category.

For information about assigning items and pages to a category, see Section 15.4.2, "Classifying the Content of an Item" and Section 8.4.1, "Assigning a Category to a Page". For information about searching on categories, see Section 2.2.1.2, "Performing an Advanced Search".

Since categories have the potential to be quite large, you can also create a hierarchy of categories. For example, in the Sales Report category, you might want to have separate, subordinate categories for the Eastern Division, the Central Division, and the Western Division.


Note:

Any user with at least the Manage Classifications privilege on a page group can create and manage categories.

Category Pages and Category Templates

When you create a category, a page is also created. This page lists all the items and pages that belong to the category. For example, if the items in a region are grouped by category, the name of the category is displayed as a link in the Group By banner. When users click this link, the category's page is displayed, listing all the items and pages that belong to the category.

The first time you create a category in a page group, a Portal Template (called the Category Pages Template) is also created and all category pages in the page group are based on this template. This means that if you want to change the way category pages look, you just need to edit the category pages template (rather than each individual category page). Categories are always based on the template in their owning page group. So if you move a category to the Shared Objects page group, the category page may look different if its original template and the template in the Shared Objects group are not exactly the same.

You will find the Category Pages Template in the Portal Navigator, under the Portal Templates node of the page group that owns the category. Click the Edit link next to the template to revise its look and feel.

The category template only controls the appearance of category pages. It does not influence how category information is displayed on the Items and Pages tabs of a category page. You can control the appearance and layout of this information, by settings options for the two Custom Search portlets that are used to return the category information.

To do this, open the category page in Edit mode, first click the Items tab and then the Edit Defaults icon, next to the search results. Editing these settings influence how information on the Items tab is displayed. To do the same for the Pages tab, click the Pages tab to bring it forward and then the Edit Defaults icon for the portlet. See also Section 17.3.4.3, "Customizing Search Results".


Note:

  • Although you can base other pages on this template, we recommend that you use it only for pages that are used for listing all objects classified under a particular category.

  • You must not delete category pages or templates. If you do so inadvertently your category becomes unusable. To resolve issues that relate to deleted/missing category pages or templates, see Appendix C - Using the Category and Perspective Scripts in Oracle Application Server Portal Configuration Guide.


This section contains the following sub-sections:

6.3.1.1 Creating a Category

To create a category:

  1. In the Navigator, click the link for the page group in which you want to create the category.

    To get to the Navigator click the Navigator link on any page. By default you can find a Navigator link on the Portal Builder page.


    Tip:

    If you create a category in a particular page group, that category is available only in that page group. If you want the category to be available in multiple page groups, either create it in the Shared Objects page group, or (if the category already exists) promote it to the Shared Objects page group. See Section 4.6, "Sharing Objects Across Page Groups"

  2. Click the Categories link.

  3. Next to Create New, click the Category link. Or, if you want to create the category under an existing category, click the Create Sub-Category link next to the category under which you want to create the new category.

  4. In the Display Name field, enter a descriptive name for the category.

    The Display Name identifies the category to other users. It is the name that displays on pick lists and in regions where the category attribute is exposed. Use up to 240 characters of any kind, including spaces.

  5. Click Create.

  6. Click Close.

When you create a category it is not immediately available for page managers and content contributors to apply to the pages and content in that page group. See Section 6.3.1.3, "Making a Category Available to a Page Group".

6.3.1.2 Editing a Category

When you create a category, not all of the available properties are available. You can edit a category after creating it to specify the rest of the available properties.

6.3.1.2.1 Editing the Basic Properties of a Category

To edit the basic properties of a category:

  1. Use the Navigator to browse to the category that you want to edit.

    To get to the Navigator click the Navigator link on any page. By default you can find a Navigator link on the Portal Builder page.


    Tip:

    If the category is shared, it will be in the Shared Objects page group. See Section 4.6, "Sharing Objects Across Page Groups"

  2. In the row for the category, click the Properties link.

  3. In the Name field, edit the name of the category.

    This opens the Edit Category page, displaying the Main tab. The attributes available on the Main tab vary a little from the attributes available when you first create the category. Notably, the Main tab includes a Name attribute.

    The Name attribute differs from the Display Name attribute both in the way OracleAS Portal uses it and in the rules that govern which characters can be used in its formation. OracleAS Portal uses the Name in path-based URLs to directly access the category. Path-based URLs take the following format:

    http://<host>:<port>/portal/page/<dad>[/lang-<language>]/<pagegroupname>/<categoryname>
    
    

    The default value in the Name field is taken from the Display Name provided when the category was created. The value is truncated to 60 characters and any special characters or spaces are discarded. Discarded characters include:

    & # % \ / : * ? < > | , "

    For example, if the Display Name is Research & Development, the Name is ResearchDevelopment.

    The Name is case sensitive. It must be unique within its page group and the Shared Objects page group. Use up to 60 alphanumeric characters (A to Z, a to z, 0 to 9) and the underscore character (_); spaces and other special characters are not allowed.

  4. In the Display Name field, edit the descriptive name of the category.

    The Display Name identifies the category to other users. It is the name that displays on pick lists and in regions where the category attribute is exposed.

    Use up to 240 characters of any kind, including spaces. Changes to the category Display Name are not reflected immediately on cached pages. To make the change display immediately, you must clear the page group's cache. Go to the Access tab of the page group that owns the category, and click the Clear Cache link.

  5. In the Description field, enter information about the category that may be useful to other users. The description is displayed only when editing the category.

  6. Click OK.

6.3.1.2.2 Specifying Category Images

To specify category images:

  1. Use the Navigator to browse to the category that you want to edit.

    To get to the Navigator click the Navigator link on any page. By default you can find a Navigator link on the Portal Builder page.


    Note:

    If the category is shared, it will be in the Shared Objects page group. See Section 4.6, "Sharing Objects Across Page Groups"

  2. In the row for the category, click the Properties link.

  3. Click the Image tab.

  4. In the Title Image Name field, enter the path and file name of an image to use when the category is displayed in a list of objects item.

  5. In the Rollover Image Name field, enter the path and file name of an image to use as a rollover image when the category is displayed in a list of objects item. The rollover image is displayed when users place their cursors over the title image.

  6. In the Banner Image Name field, enter the path and file name of an image to display in the category page.

  7. In the Icon Name field, enter the path and file name of an image to use when categories are displayed next to items in a region.

  8. Click OK.

6.3.1.3 Making a Category Available to a Page Group

When you create a category in a page group it is not immediately available for page managers and content contributors to apply to the pages and content in that page group. To make the category available, you must make it visible within the page group. You can also make shared categories available in your page group. And, if you want, you can hide categories so that page managers and contributors cannot use them.

To make a category available in a page group:

  1. From the Page Groups portlet's Work In drop-down list, choose the page group to be edited.

    By default, the Page Groups portlet is located on the Build tab of the Builder page.

  2. Click the Configure tab.

  3. In the Types and Classification section, click the Edit link.

  4. In the Hidden Categories list, select the category that you want to make available.

    The Hidden and Visible Categories lists include all the categories owned by this page group and the Shared Objects page group.

  5. Click the Move icon to move the selected category into the Visible Categories list.

    The order of categories in the Visible Categories list determines the order used when items in a region are grouped by category.

    If you want to make a sub-category visible, its parent category must also be included in the Visible Categories list.

  6. Click OK to return to the Configure tab.

  7. Click Close.

To exclude a category from a page group, select the category in the Visible Categories list and click the Remove icon. Any items that have already been assigned to that category will still be visible when users view the page, however content contributors cannot assign the category to new items.

If you hide a shared category, it is hidden only in the current page group (not in all page groups).

Even if you exclude all categories from a page group, if an item or page type includes the category attribute, the category list will still be displayed when adding or editing items or pages. The General category will be displayed in the list even though it is not included in the page group.

6.3.1.4 Moving a Category to the Shared Objects Page Group

You can move a category to the Shared Objects page group to make it visible across all page groups. If you do this, note that categories are based on the template in their owning page group, so the category page may look different if its original template and the template in the Shared Objects group are not exactly the same.


Note:

Objects can be moved to the Shared Objects page group—whose default language is English—from a non-English page group only if the object already has an English translation. This applies to all promotable objects: item types, page types categories, perspectives, attributes, and styles.

To move a category to the Shared Objects page group:

  1. Use the Navigator to browse to the category that you want to move.

    To get to the Navigator click the Navigator link on any page. By default you can find a Navigator link on the Portal Builder page.

  2. In the row for the category, click Move to Shared.

  3. In the confirmation page, click Yes.

You cannot move a category to the Shared Objects page group if there is a template or page with the same name at the root level of the Shared Objects page group. Consider keeping category names unique to avoid this possibility.

6.3.1.5 Deleting a Category

When you delete a category, any item or page that is assigned to that category is reassigned to the General category. If the category includes sub-categories, those sub-categories will also be deleted.

Take care when deleting a category from the Shared Objects page group. Categories in the Shared Objects page group may be used across page groups. Deleting a category from Shared Objects removes it from all page groups that use it.

Deleting a Single Category

To delete a single category:

  1. Use the Navigator to browse to the category that you want to delete.

    To get to the Navigator click the Navigator link on any page. By default you can find a Navigator link on the Portal Builder page.


    Tip:

    If the category is shared, it will be in the Shared Objects page group. See Section 4.6, "Sharing Objects Across Page Groups"

  2. In the row for the category, click the Delete link.

  3. In the confirmation page, click Yes.

Deleting Multiple Categories

To delete multiple categories:

  1. In the Navigator, click the link for the page group that owns the categories that you want to delete.

    To get to the Navigator click the Navigator link on any page. By default you can find a Navigator link on the Portal Builder page.


    Tip:

    If the categories are shared, they will be in the Shared Objects page group. See Section 4.6, "Sharing Objects Across Page Groups"

  2. Click the Categories link.

  3. Click the actions link.

  4. Select the check boxes next to the categories that you want to delete.

    To delete all the categories in the page group, select the check box in the header row.

  5. Click Delete.

  6. In the confirmation page, click OK.

6.3.2 Working with Perspectives

Perspectives are used to further classify content by a cross-category grouping. Perspectives often answer the question "Who will be interested in this item?" A human resources page group might have perspectives such as All Employees, Design Analysts, Quality Assurance Engineers, and Sales Representatives. A travel agency page group might have perspectives such as Inexpensive Vacations, Moderately Priced Vacations, and Luxury Vacations. The purpose of perspectives is to enable users to quickly display a listing of content that is pertinent to them. For example, if you want some users to be able to quickly access all of the content that relates to being a sales representative (such as sales reports, contact management applications, and calendaring services), you could create a perspective called Sales Representatives. When a user adds an item to the page group, they can assign it to this and other perspectives. To find all of the available content, other users can then search on this perspective to see a listing of the items that are part of it.

For information about assigning items to perspectives, see Section 15.4.2, "Classifying the Content of an Item". For information about searching on categories, see Section 2.2.1.2, "Performing an Advanced Search".

Unlike categories, users can choose more than one perspective for an item. For example, a sales report might belong to both the Sales Representatives and Marketing Managers perspectives.

Since perspectives have the potential to be quite large, you can also create a hierarchy of perspectives. For example, in the Sales Representatives perspective, you might want to have separate subordinate perspectives for sales representatives in the eastern division, the central division, and the western division.


Note:

Any user with at least the Manage Classifications privilege on a page group can create and manage perspectives.

Perspective Pages and Perspective Templates

When you create a perspective, a page is also created. This page lists all the items and pages that belong to the perspective. For example, regions can be set up to display perspectives. When users click a perspective, that perspective's page is displayed, listing all the items and pages that belong to the perspective.

The first time you create a perspective in a page group, a Portal template is also created (called the Perspective Pages Template) and all perspective pages in the page group are based on this template. This means that if you want to change the way perspective pages look, you just need to edit the perspective pages template (rather than each individual perspective page). Perspectives are always based on the template in their owning page group. So if you move a perspective to the Shared Objects page group, the perspective page may look different if its original template and the template in the Shared Objects group are not exactly the same.

You will find the Perspective Pages Template in the Portal Navigator, under the Portal Templates node of the page group that owns the perspective. Click the Edit link next to the template to revise its look and feel.

The perspective template only controls the appearance of perspective pages. It does not influence how perspective information is displayed on the Items and Pages tabs of a perspective page. You can control the appearance and layout of this information, by settings options for the two Custom Search portlets that are used to return the perspective information.

To do this, open the perspective page in Edit mode, first click the Items tab and then the Edit Defaults icon, next to the search results. Editing these settings influence how information on the Items tab is displayed. To do the same for the Pages tab, click the Pages tab to bring it forward and then the Edit Defaults icon for the portlet.


Note:

  • Although you can base other pages on this template, we recommend that you use it only for pages that are used for listing all objects classified under a particular perspective.

  • You must not delete perspective pages or templates. If you do so inadvertently your perspective becomes unusable. To resolve issues that relate to deleted/missing perspective pages or templates, see Appendix C - Using the Category and Perspective Scripts in Oracle Application Server Portal Configuration Guide.


This section contains the following sub-sections:

6.3.2.1 Creating a Perspective

To create a perspective:

  1. In the Navigator, click the link for the page group in which you want to create the perspective.

    To get to the Navigator click the Navigator link on any page. By default you can find a Navigator link on the Portal Builder page.


    Tip:

    If you create a perspective in a particular page group, that perspective is available only in that page group. If you want the perspective to be available in multiple page groups, either create it in the Shared Objects page group, or (if the perspective already exists) promote it to the Shared Objects page group. See Section 4.6, "Sharing Objects Across Page Groups"

  2. Click the Perspectives link.

  3. Next to Create New, click the Perspective link. Or, if you want to create the perspective under an existing perspective, click the Create Sub-Perspective link next to the perspective under which you want to create the new perspective.

  4. In the Display Name field, enter a descriptive name for the perspective.

    The Display Name identifies the perspective to other users. It is the name that displays on pick lists and in regions where the perspective attribute is exposed. Use up to 240 characters of any kind, including spaces.

  5. Click Create.

  6. Click Close.

When you create a perspective it is not immediately available for page managers and content contributors to apply to the pages and content in that page group. See Section 6.3.2.3, "Making a Perspective Available to a Page Group".

6.3.2.2 Editing a Perspective

When you create a perspective, not all of the available properties are available. You can edit a perspective after creating it to specify the rest of the available properties.

6.3.2.2.1 Edit the Basic Properties of a Perspective

To edit the basic properties of a perspective:

  1. Use the Navigator to browse to the perspective that you want to edit.

    To get to the Navigator click the Navigator link on any page. By default you can find a Navigator link on the Portal Builder page.


    Tip:

    If the perspective is shared, it will be in the Shared Objects page group. See Section 4.6, "Sharing Objects Across Page Groups"

  2. In the row for the perspective, click the Properties link.

  3. In the Name field, edit the name of the perspective.

    This opens the Edit Perspective page, displaying the Main tab. The attributes available on the Main tab vary a little from the attributes available when you first create the perspective. Notably, the Main tab includes a Name attribute.

    The Name attribute differs from the Display Name attribute both in the way OracleAS Portal uses it and in the rules that govern which characters can be used in its formation. OracleAS Portal uses the Name in path-based URLs to directly access the perspective. Path-based URLs take the following format:

    Ihttp://<host>:<port>/portal/page/<dad>[/lang-<language>]/<pagegroupname>/<perspectivename>
    
    

    The default value in the Name field is taken from the Display Name provided when the perspective was created. The value is truncated to 60 characters and any special characters or spaces are discarded. Discarded characters include:

    & # % \ / : * ? < > | , "

    For example, if the Display Name is Research & Development, the Name is ResearchDevelopment.

    The Name is case sensitive. It must be unique within its page group and the Shared Objects page group. Use up to 60 alphanumeric characters (A to Z, a to z, 0 to 9) and the underscore character (_); spaces and other special characters are not allowed.

  4. In the Display Name field, edit the descriptive name of the perspective.

    The Display Name identifies the perspective to other users. It is the name that displays on pick lists and in regions where the perspective attribute is exposed.

    Use up to 240 characters of any kind, including spaces. Changes to the perspective Display Name are not reflected immediately on cached pages. To make the change display immediately, you must clear the page group's cache. Go to the Access tab of the page group that owns the category, and click the Clear Cache link.

  5. In the Description field, enter information about the perspective that may be useful to other users. The description is displayed only when editing the category.

  6. Select the Display Icon With Items check box if you want to display an image rather than the display name when the perspective is displayed next to items in a region (Figure 6-9):

    If you select this check box you should also specify an Icon image for the perspective. If you do not specify an Icon image, the display name is displayed even if this check box is selected.

  7. Click OK.

Figure 6-9 Items Displayed with Perspective Icons

Description of Figure 6-9  follows
Description of "Figure 6-9 Items Displayed with Perspective Icons"

6.3.2.2.2 Specifying Perspective Images

To specify perspective images:

  1. Use the Navigator to browse to the perspective that you want to edit.

    To get to the Navigator click the Navigator link on any page. By default you can find a Navigator link on the Portal Builder page.


    Tip:

    If the perspective is shared, it will be in the Shared Objects page group. See Section 4.6, "Sharing Objects Across Page Groups"

  2. In the row for the perspective, click the Properties link.

  3. Click the Image tab.

  4. In the Title Image Name field, enter the path and file name of an image to use when the perspective is displayed in a list of objects item.

  5. In the Rollover Image Name field, enter the path and file name of an image to use as a rollover image when the perspective is displayed in a list of objects item. The rollover image is displayed when users place their cursors over the title image.

  6. In the Banner Image Name field, enter the path and file name of an image to display in the perspective page.

  7. In the Icon Name field, enter the path and file name of an image to use when perspectives are displayed next to items in a region.

  8. Click OK.

6.3.2.3 Making a Perspective Available to a Page Group

When you create a perspective in a page group it is not immediately available for content contributors to apply to the items in that page group. To make the perspective available, you must make it visible within the page group. You can also make shared perspectives available in your page group. And, if you want, you can hide perspectives so that contributors cannot use them.

To make a perspective available to a page group:

  1. From the Page Groups portlet's Work In drop-down list, choose the page group to be edited.

    By default, the Page Groups portlet is located on the Build tab of the Builder page.

  2. Click the Configure tab.

  3. In the Types and Classification section, click the Edit link.

  4. In the Hidden Perspectives list, select the perspective that you want to make available.

    The Hidden and Visible Perspectives lists include all the perspectives owned by this page group and the Shared Objects page group.

  5. Click the Move icon to move the selected perspective into the Visible Perspectives list.

    The order of perspectives in the Visible Perspectives list determines the order in which the perspectives are listed when adding or editing a page or item.

    If you want to make a sub perspective visible, its parent perspective must also be included in the Visible Perspectives list.

  6. Click OK to return to the Configure tab.

  7. Click Close.

To exclude a perspective from a page group, select the perspective in the Visible Perspectives list and click the Remove icon.

If you hide a shared perspective, it is hidden only in the current page group (not in all page groups).

6.3.2.4 Moving a Perspective to the Shared Objects Page Group

You can move a perspective to the Shared Objects page group to make it visible across all page groups. If you do this, note that perspectives are based on the template in their owning page group, so the perspective page may look different if its original template and the template in the Shared Objects group are not exactly the same.


Note:

Objects can be moved to the Shared Objects page group—whose default language is English—from a non-English page group only if the object already has an English translation. This applies to all promotable objects: item types, page types, categories, perspectives, attributes, and styles.

To move a perspective to the Shared Objects page group:

  1. Use the Navigator to browse to the perspective that you want to move.

    To get to the Navigator click the Navigator link on any page. By default you can find a Navigator link on the Portal Builder page.

  2. In the row for the perspective, click Move to Shared.

  3. In the confirmation page, click Yes.

You cannot move a perspective to the Shared Objects page group if there is a template or page with the same name at the root level of the Shared Objects page group. Consider keeping perspective names unique to avoid this possibility.

6.3.2.5 Deleting a Perspective

When you delete a perspective, if the perspective includes sub-perspectives, those sub-perspectives will also be deleted.

Take care when deleting a perspective from the Shared Objects page group. Perspectives in the Shared Objects page group may be used across page groups. Deleting a perspective from Shared Objects removes it from all page groups that use it.

Deleting a Single Perspective:

To delete a single perspective:

  1. Use the Navigator to browse to the perspective that you want to delete.

    To get to the Navigator click the Navigator link on any page. By default you can find a Navigator link on the Portal Builder page.


    Tip:

    If the perspective is shared, it will be in the Shared Objects page group. See Section 4.6, "Sharing Objects Across Page Groups"

  2. In the row for the perspective, click the Delete link.

  3. In the confirmation page, click Yes.

Deleting Multiple Perspectives

To delete multiple perspectives:

  1. In the Navigator, click the link for the page group that owns the perspectives that you want to delete.

    To get to the Navigator click the Navigator link on any page. By default you can find a Navigator link on the Portal Builder page.


    Tip:

    If the perspectives are shared, they will be in the Shared Objects page group. See Section 4.6, "Sharing Objects Across Page Groups"

  2. Click the Perspectives link.

  3. Click the actions link.

  4. Select the check boxes next to the perspectives that you want to delete.

    To delete all the perspectives in the page group, select the check box in the header row.

  5. Click Delete.

  6. In the confirmation page, click OK.

6.4 Setting Up Approvals

OracleAS Portal enables you to manage and control the publishing of content on your portal through the use of approvals. OracleAS Portal provides a special privilege for approvals, Manage Items With Approval. Each item added or modified by a user with this privilege must be approved before it is published to the portal. This enables you to delegate the creation of portal content without relinquishing control over what is actually displayed to your users, or compromising the quality of the content.

For example, you may want each of your company's product whitepapers to be reviewed by your legal department before they are published. Using approvals, you can easily establish an approval process that includes the legal department as one of the required approvers. This ensures that each author of a whitepaper cannot publish their documents to the portal until they have been checked by the legal department.

Approval processes can also reduce or even eliminate the costs of a paper-driven office in which hard copy documents requiring approvals, such as expense reports and travel requests, create bottlenecks for your workers. When you define approval processes, you allow the appropriate people in your organization to receive notification of pending items requiring approval, to review the items, and to approve or reject the items, all from your company's portal.

You can also upload draft items to the portal. With the draft feature enabled, content developers can upload content to the portal without exposing it until they're ready to submit it for approval. Approvals must be enabled for the draft feature to be implemented. You will find the option to enable drafts on the page group properties Approval tab. Drafts do not require approval, so content developers can upload drafts to the portal and continue to work on them without having to wait for approval. Drafts are not displayed when the page is viewed. When the draft is finalized and the contributor submits it for approval, it is routed through the approval process (if one is defined). See Section 2.7.1.1.3, "Submitting a Draft Item for Approval". Keep in mind that, once enabled, this option cannot be disabled until all draft items are submitted for approval.

It is possible for approvals to be enabled without there being any defined approval process. Consequently, it is possible to enable drafts for everyone without ultimately requiring that their finalized content be approved. Keep in mind, however, if you have users with the Manage Items with Approval page group privilege, and no approval process is defined, this privilege is equivalent to the Manage Content (items) page group privilege. In other words, such users will be able to add content that has not been through an approval process.

This section contains the following sub-sections:

6.4.1 Enabling Approvals and Notifications for a Page Group

You can enable approval processes at page group and page level. This means you can establish one approval process for the entire page group, or approval processes that are unique to individual pages.

This section describes how to enable approvals for a page group. By default, pages inherit the approval process defined for the page group to which they belong but you can allow page manager to override this if you wish. See Enabling Page Managers to Specify Their Own Approval Processes.


Note:

If you enable Approvals and Notifications, make sure that none of the pages in the page group are cached at the system level. See also Section 22.1, "Page Caching".

  1. From the Page Groups portlet's Work In drop-down list, choose the page group to be edited.

    By default, the Page Groups portlet is located on the Build tab of the Builder page.

  2. Click the Configure tab.

  3. In the Approvals and Notifications section, click the Edit link.

  4. Select the Enable Approvals and Notifications check box.

    This enables approvals for the page group. The page group administrator can now set up an approval routing process for the page group. See Setting Up the Approval Process for a Page Group.

  5. Click OK to return to the Configure tab.

  6. Click Close.

6.4.2 Setting Up the Approval Process for a Page Group

An approval process is a series of one or more approval routing steps. Each routing step includes one or more users, or groups (approvers), or both, who must approve an item before it is published. Routing to the approvers can be in serial (one at a time) or in parallel (all at once). Each step can be defined to require a response by any one approver or by all approvers.

The approval process begins when a user with the Manage Items With Approval privilege adds or modifies an item on a page. The item is automatically checked out of the portal (so that it cannot be modified), and routed through the approval process. Each approver is notified through the Notification portlet that an item requires his or her approval. Once the required number of responses is received during a step, the process continues to the next step. The approval process ends when the final step is reached and the document is approved by the last required approver. The approval process also ends when any approver rejects the item.

The approval process can be modified so that users can add draft versions of an item without immediate approval. Draft items are only visible to the item owner, who can submit the item for approval, once it is finalized. See Section 2.7.1.1.3, "Submitting a Draft Item for Approval".

The approval process can also be extended to all users contributing content to the page group, instead of just those with the Manage Items With Approval privilege.

You can create one approval process for the entire page group, or you can enable page designers to establish approval processes that are unique to individual pages (or even to ignore the approval process for a particular page). The steps for setting up an approval process for a page group are described in the next section. For information about how to set up an approval process for a page, see Section 21.1, "Setting Up an Approval Process for a Page".

6.4.2.1 Setting Up an Approval Process for a Page Group

To set up an approval process for a page group:

  1. From the Page Groups portlet's Work In drop-down list, choose the page group to be edited.

    By default, the Page Group portlet is located on the Build tab of the Builder page.

  2. Click the Approval tab.

    The Approval tab is available only if approvals and notifications have been enabled for the page group. See Section 6.4, "Setting Up Approvals".

  3. In the Approvers field in the Approval Routing List section, select one or more approvers (users or groups) for the first step of the approval routing list. Click the Browse Users icon to add a user, or the Browse Groups icon to add a group. If you type in user and group names manually, check spellings carefully to avoid invalid entries.

    Each step of the approval process can include both users and groups. Use a semicolon (;) as the separator between multiple users and groups.

    Do not use the same approver in more than one step. Any additional times the approver is listed, he or she will be skipped.

    When you include a group in the approval routing list, any one member of the group can approve or reject an item, even if the step specifies that all of the recipients must respond. If you require responses from all members of a group, list each member individually.

    We recommend that approvers have at least the View privilege on the page that includes the item to be approved (so that they can view the page).

    OracleAS Portal includes the following special approvers:

    • #PAGE_GROUP_MANAGER#: Any user or group with the Manage All privilege on the page group, or the Manage All global privilege on all page groups.

    • #PAGE_MANAGER#: Any user or group with the Manage privilege on the page.

    • #CONTENT_MANAGER#: Any user or group with Manage Content or Manage privilege on the page, or the higher-level Manage privilege, on the page.

      By default, when you enable approvals and notifications for the page group, a single step approval process is defined at the page group level with #CONTENT_MANAGER# as the default approver.

    When you enter these special approvers, use uppercase text only.

  4. In the Routing Method for Approvers radio group, choose a routing method for the approval routing list:

    • One at a time, all must approve (Serial, All) —This sends the approval to approvers in the step one at time in the sequence specified. All of the approvers must respond to the approval.

    • All at the same time, all must approve (Parallel, All)—This sends the approval to approvers in the step all at the same time. All of the approvers must respond to the approval.

    • All at the same time, only one must approve (Parallel, Any)—This sends the approval to approvers in the step all at the same time. Only one of the approvers must respond to the approval.

  5. Click Add Step to continue adding steps to the approval routing list.

    For each step, select approvers and a routing method. Each step you add is listed in the Approval Process section. You can edit existing steps by clicking the list of users and groups, or the Edit icon. When you edit a step, the step details are displayed in the Approval Routing List section and the Add Step button changes to Update Step.

    Because Oracle Internet Directory can include multiple directory containers that can use the same group names, the distinguished name (DN) is displayed next to any group that does not belong to the local OracleAS Portal instance.

  6. Select Enable Item Drafts to enable users with the Manage Items With Approval privilege to add draft versions of items to pages in the page group, without having to submit them for approval.

    Draft items are visible only to the item owner in the Pending Items Preview and List editing views. Once the draft is finalized, the user can submit the item for approval from the Actions page. Once enabled, this option cannot be disabled until all draft items in this page group are submitted for approval.

    If you do not want to allow content contributors to upload draft items without approval, do not select this option.

  7. Select All Users Require Approval if every content contributor requires approval.

    By default, this options is not selected which means that only users with the Manage Items With Approval privilege require approval.

  8. Click OK when the approval routing list is complete.

If there is an active approval process pending for an item, the approval routing steps for the item cannot be reordered. Also, you cannot edit active steps (that is, any step which is currently active within an approval process). However, you can still delete and edit any steps which are not currently active.

6.4.2.2 Enabling Page Managers to Specify Their Own Approval Processes

To enable page managers to specify their own approval processes:

  1. From the Page Groups portlet's Work In drop-down list, choose the page group to be edited.

    By default, the Page Groups portlet is located on the Build tab of the Builder page.

  2. Click the Configure tab.

  3. In the Approvals and Notifications section, click the Edit link.

  4. Select the Override the Page Group Approval Process check box.

  5. Click OK to return to the Configure tab.

  6. Click Close.

Enabling this option also allows page managers to ignore the approval process completely by defining an empty approval process at the page level. This means that users with the Manage Items With Approval privilege on the page will be able to add items to the page without requiring approval.

For information about how to set up an approval process for a page, see Section 21.1, "Setting Up an Approval Process for a Page".

6.4.3 Monitoring Pending Approvals

The Pending Approvals Monitor portlet enables you to list pending approvals in the page groups that you administer. You can list the pending approvals by approver, date, page group, or submitter.

Figure 6-10 The Pending Approvals Monitor Portlet

Description of Figure 6-10  follows
Description of "Figure 6-10 The Pending Approvals Monitor Portlet"

The Pending Approvals Monitor portlet only lists pending approvals for other users. If you would like to view your own pending approvals, use the My Notifications portlet. For information about the My Notifications portlet or approving or rejecting items that require your approval, see Section 2.7.2, "Approving or Rejecting Content".

To monitor pending approvals:

  1. Go to the page that contains your Pending Approvals Monitor portlet.

  2. In the first list, choose how you want to view the pending approvals that you want to monitor. You can view pending approvals by approver, date, page group, or submitter.

  3. In the second list and third lists, choose the operator and value to use to filter the list of pending approvals.

    Wildcard searches using % or * are not supported. To view pending approvals by approver, page group, or submitter, enter a valid name. Otherwise, enter a valid date.

  4. Click Go.

You can also personalize or edit the defaults of the portlet to automatically list pending approvals.

Examples of the Pending Approvals Monitor Portlet

Figure 6-11 List Pending Approvals Waiting to Be Approved by SCOTT

Description of Figure 6-11  follows
Description of "Figure 6-11 List Pending Approvals Waiting to Be Approved by SCOTT"

Figure 6-12 List Pending Approvals Submitted After 11-NOV-2004

Description of Figure 6-12  follows
Description of "Figure 6-12 List Pending Approvals Submitted After 11-NOV-2004"

Figure 6-13 List Pending Approvals for Items That Were Submitted by Any User Other Than SCOTT

Description of Figure 6-13  follows
Description of "Figure 6-13 List Pending Approvals for Items That Were Submitted by Any User Other Than SCOTT"

6.4.4 Setting Up Expiry Notifications for a Page Group

Expiry notifications notify one or more recipients (users or groups) when an item in the page group is about to expire.

6.4.4.1 Setting Up Expiry Notifications

To set up expiry notifications for a page group:

  1. From the Page Groups portlet's Work In drop-down list, choose the page group to be edited.

    By default, the Page Group portlet is located on the Build tab of the Builder page.

  2. Click the Approval tab.

    The Approval tab is available only if approvals and notifications have been enabled for the page group. See Section 6.4, "Setting Up Approvals".

  3. In the Recipients field in the Expiry Notifications section, select one or more recipients (users or groups) to notify when an item in the page group is about to expire. Click the Browse Users icon to notify a user, or the Browse Groups icon to notify a group.

    Use a semicolon (;) as the separator between multiple users and groups. This field can include both users and groups.

    OracleAS Portal includes the following special recipients:

    • #PAGE_GROUP_MANAGER#: Any user or group with the Manage All privilege on the page group, or the Manage All global privilege on all page groups.

    • #PAGE_MANAGER#: Any user or group with the Manage privilege on the page.

    • #CONTENT_MANAGER#: Any user or group with Manage Content or Manage privilege, or the higher-level Manage privilege, on the page.

      By default, when you enable approvals and notifications for the page group, a single step approval process is defined at the page group level with #CONTENT_MANAGER# as the default approver.

    • #ITEM_OWNER#: The owner of the item.

    When you enter these special approvers, use uppercase text only.

    Because Oracle Internet Directory can include multiple directory containers that can use the same group names, the distinguished name (DN) is displayed next to any group that does not belong to the local OracleAS Portal instance.

  4. In the Notification Time for Recipients field, enter how long (in hours) before the item is due to expire to notify the recipients. The default is 48 hours.

  5. Click OK.

If a user or group is deleted from the portal, any pending items requiring that user or group's approval will need to be approved or rejected by the page owner or page group administrator. In the approval step, a deleted user is listed as 'User no longer exists.'

6.4.4.2 Displaying Expiry Notifications on a Page

To display expiry notifications on a page:

  1. Go to the page where you want to display expiry notifications.

    For information on locating a page, see Section 9.1, "Locating Pages in OracleAS Portal".

  2. Switch to Edit mode.

  3. In the region where you want to display expiry notifications, click the Add Portlets icon.

    If you do not see the Add Portlets icon, the region may be an item region, in which case, you cannot add portlets to this region.

  4. Click the link for the My Notifications portlet.

    By default, the My Notifications portlet is located under the Portal Content Tools page of the Portlet Repository. If you cannot find the My Notifications portlet under this page, use the Search field.

  5. Click OK.

  6. Next to the portlet, click the Actions icon.

  7. Click Edit Defaults.

  8. In the Display Name field, enter a different title for the portlet if required. For example, if the portlet will be used only to display expiry notifications, you might change the display name to Items About to Expire.

  9. In the Display Limit radio group, select whether to display all notifications or limit the portlet to display only a specified number of notifications.

  10. Make sure the Show Expiry Notifications check box is selected.

    The portlet can also display approval and subscription notifications.

  11. Select the Display Notification Type Icon in Portlet check box if you want to display an icon to illustrate whether the notification is an approval, expiry, or subscription notification. This is useful if you intend to use the portlet to display other types of notifications.

  12. Select the Display Notification Status in Portlet check box if you want to display the status of the notification in the portlet. This informs users whether the item is about to expire or has already expired.

  13. In the Page Group Option radio group, select whether to display expiry notifications for all page group or a specified selection of page groups.

    This option is more useful for individual users who can personalize the portlet to filter the list to include only those expiry notifications that they are actually interested in

  14. In the User Group Option radio group, select whether to display expiry notifications for all user groups or a specified selection of user groups.

    This option is more useful for individual users who can personalize the portlet to filter the list to include only those expiry notifications that they are actually interested in.

    Use a semicolon (;) as the separator between multiple groups.

    Because Oracle Internet Directory can include multiple containers that can use the same group names, the distinguished name (DN) is displayed next to any group that does not belong to the local Portal instance.

  15. Click OK.

6.5 Managing Item Behavior at the Page Group Level

This section contains the following sub-sections:

Intended Audience

The contents of this section are intended for users with at least the Manage All privilege on a page group (that is, page group administrators).

6.5.1 Changing the Page Group Quota

You can limit the amount of space provided in your page group to store uploaded documents.

To change the page group quota:

  1. From the Page Groups portlet's Work In drop-down list, choose the page group to be edited.

    By default, the Page Groups portlet is located on the Build tab of the Portal Builder page.

  2. In the Total document storage quota radio group, select Limit to to limit the amount of space provided to store uploaded documents.

  3. In the field, enter the maximum amount of space (in megabytes) to provide for uploaded documents in the page group.

    When this limit is reached, users will no longer be able to upload documents to the page group.

    Select No limit if you do not want to impose a limit for uploaded documents.

  4. Click OK.

6.5.2 Setting the Item Versioning Level for a Page Group

OracleAS Portal lets you select the level of item versioning you want to use for items in a page group. Item versioning determines what happens to the old version of an item when a new version is added.

Page managers can override the item versioning level for the page. However, they can only provide a higher level of item versioning than the page group, not a lower level. For example, if you set item versioning for a page group to Simple, then page managers can set the item versioning for pages within the page group to Audit, but not to None. See Section 8.1, "Enabling Item Versioning for Page Groups, Pages, and Templates".

To set the item versioning level for a page group:

  1. From the Page Groups portlet's Work In drop-down list, choose the page group to be edited.

    By default, the Page Groups portlet is located on the Build tab of the Portal Builder page.

  2. Click the Items tab.

  3. In the Item Versioning radio group, select:

    • None to completely replace the item's previous version when editing an item. If you choose this option, none of the item's previous versions are retained in the database.

    • Simple to offer the content contributor a choice of completely replacing the item's previous version or creating a new version when editing an item. If the contributor chooses the latter option, all the item's previous versions are retained in the portal's repository.

    • Audit to always create a new version when editing an item. If you choose this option, all the item's previous versions are retained in the portal's repository.

  4. Click OK.

6.5.3 Managing Unpublished Items

You can display unpublished items in Edit mode of the pages of a page group. Unpublished items are items that have a future publish date, have expired, or have been deleted.

Only users with at least the Manage Content privilege on the page (or the Manage Item privilege on the item if item level security is enabled) can see unpublished items in Edit mode. Users with the Manage Content privilege on a page can edit, move, or restore unpublished items in that page.

6.5.3.1 Displaying Unpublished Items

To display unpublished items:

  1. From the Page Groups portlet's Work In drop-down list, choose the page group to be edited.

    By default, the Page Groups portlet is located on the Build tab of the Portal Builder page.

  2. Click the Items tab.

  3. Select Display Unpublished Items In Edit Mode.

  4. Click OK.

6.5.3.2 Retaining Deleted Items

To be able to continue to display deleted items, you must first choose to retain them in the Oracle Application Server Metadata Repository.


Note:

This setting does not apply to draft items. If a draft item is deleted it is irrevocably deleted from the portal. The only way to restore the item is to add it to the page once again.

To retain deleted items in the Oracle Application Server Metadata Repository:

  1. From the Page Groups portlet's Work In drop-down list, choose the page group to be edited.

    By default, the Page Groups portlet is located on the Build tab of the Portal Builder page.

  2. Click the Items tab.

  3. Select Retain Deleted Items.

  4. Click OK.

6.5.3.3 Permanently Removing Expired and Deleted Items

Periodically, you may want to perform a system purge to permanently remove expired and deleted items from the Oracle Application Server Metadata Repository.

To permanently remove expired and deleted items:

  1. From the Page Groups portlet's Work In drop-down list, choose the page group to be edited.

    By default, the Page Groups portlet is located on the Build tab of the Portal Builder page.

  2. Click the Items tab.

  3. Select Purge Deleted Items to remove deleted items during the system purge.

  4. Select Purge Expired Items to remove expired items during the system purge.

  5. Click Purge.

  6. When the page refreshes, the purge is complete, and you can click OK.

A system purge may take a few minutes if there are a lot of expired or deleted items.

6.5.4 Displaying the New and Updated Icons

If a region includes the New Item Indicator, when a user adds a new item or portlet to that region, the New icon is displayed next to it to inform other users that it is new and may contain information they haven't yet seen.

If a region includes the Updated Item Indicator, when a user edits an existing item or portlet in that region, the Updated icon is displayed next to it, to inform other users that it has been updated and may contain new information.

You can control how long an item or portlet is considered new or recently updated by changing the display period of these icons.

Changing the New and Updated Icon Display Period

To change the New and Updated icon display period:

  1. From the Page Groups portlet's Work In drop-down list, choose the page group to be edited.

    By default, the Page Groups portlet is located on the Build tab of the Portal Builder page.

  2. Click the Items tab.

  3. In the Icon Display Period field, enter the number of days to display the New and Updated icons.

    If you set the icon display period to 0, the icons will not be displayed at all.

    The display period applies to both the New and Updated icons. You cannot set a different display period for the individual icons.

  4. Click OK.


Note:

When you change the icon display period, if a page has been cached, the new setting may not be immediately apparent. To make sure that the icons are displayed immediately, clear the cache for the page group. To do this click the Access tab, then click the Clear Cache link.

Adding the New or Updated Item Indicator to a Region

To add the New or Updated Item Indicator to a region:

  1. From the Page Groups portlet's Work In drop-down list, choose the page group to be edited.

  2. Select the page to which you want to add the New or Updated Item Indicator, then click Edit.

  3. In the region to which you want to add the indicator, click the Edit Region icon.

  4. Click the Attributes/Style tab.

  5. In the Available Attributes list, select:

    • New Item Indicator if you want to display the New icon in the region.

    • Updated Item Indicator if you want to display the Updated icon in the region.

  6. Click the Move icon.

  7. Click Apply.

  8. Click Close.

6.5.5 Disabling the Rich Text Editor

By default, when users add or edit a text item, the area of the page where they enter the text includes a WYSIWYG editor. You can disable this feature so that users are provided with a simple text area instead.

To disable the rich text editor:

  1. From the Page Groups portlet's Work In drop-down list, choose the page group to be edited.

    By default, the Page Groups portlet is located on the Build tab of the Portal Builder page.

  2. Click the Items tab.

  3. Clear Enable Rich Text Editor.

  4. Click OK.

6.6 Troubleshooting Content Management

I cannot see draft, pending, rejected, or deleted rejected items.

Draft, pending, rejected, and deleted rejected items do not display as expected on pages that are cached at the system level. To avoid access problems, do not cache pages (or templates) at the system level when Approvals and Notifications are enabled. See Section 22.1, "Page Caching".