Oracle Portal Building Portals
Release 3.0.8

Part Number A87570-01

Library

Service

Contents

Index

Go to previous page Go to next page

2
Planning Your Web Content

This chapter explains the planning steps you should take before you start using Oracle Portal. In particular, it covers a set of techniques you can use to define the overall structure of your Web content. Defining this structure greatly simplifies the process of actually creating content areas and pages.

Note: A section that addresses the planning considerations for applications will be added in a future release.

This chapter contains the following sections:

2.1 Planning Pages

This section briefly discusses some of the issues you should consider during each phase of the planning process. Of course, planning and creating pages successfully is largely a matter of experience: the more you create pages and use them, or receive feedback from others who use them, the better you'll be able to determine what works and what doesn't.

You'll find this section particularly helpful if you've never created Oracle Portal pages before.

2.1.1 Step 1: Determine Your Audience

The first thing you need to think about is who will use the page(s) you are about to create. Are you creating a single page that only you will see, or are you responsible for creating separate home pages for several different groups or individuals? If you're creating your own page, of course, you have considerably more freedom, as you can experiment with Oracle Portal to see what you like and don't like. If you're creating several different pages, however, you should spend some time thinking about what kind of information each user or group requires.

Ask yourself the following:

Hint: Take a sheet of paper, write the name of each group or user across the top, and list the required information/applications for each.

2.1.2 Step 2: Get The Data

After you've listed the information required by each user or group, your next step is to determine how to make that information available as portlets so you can plug them into the appropriate pages.

Note: A lot of what you can do here depends upon how familiar you are with the content areas and applications established for your enterprise. You may need to enlist the aid of the individual or a group member for whom you are creating the page to find out the names of content areas, content area objects, applications, and/or components.

If the data or application you need does not exist, but should, you'll probably have to contact the appropriate person to either add the necessary content to a content area or create the required application or component.

2.1.3 Step 3: Develop a Look and Feel

Once you've obtained the data you need, it's time to start thinking about the look and feel of your page. The appearance of your page is primarily controlled by the page style, although the page banner has a big impact as well. When you're creating your page style, you should scroll through the list of Available Style Elements and make a conscious decision about each.

You may want to work with a graphic designer when doing so, and when considering these issues:

2.1.4 Step 4: Organize the Page

Organizing the page means determining how to arrange the portlets you want to include so that they are both visually appealing and useful. You may want to sketch out some alternatives on a piece of paper before you start working in the product itself.

To organize your page, you'll need to know the following:

2.1.5 Step 5: Consider Security

The last step in the planning phase is to think about who will need access to this page, and to what extent.

2.2 Planning Content Areas

In a classic Web site, the smallest component is a page. On the page are an assortment of links, images, and text. In Oracle Portal content areas, the smallest component is an item, displayed within a container called a folder. Folders are very much like folders in a file system, with multiple items existing within a folder. The term page in Oracle Portal is reserved for an entity on which information is displayed in the form of portlets, which may or may not include data from your content area. For more information on planning pages, see Section 2.1, "Planning Pages".

Each Oracle Portal item has a set of attributes. These attributes include information such as title, description, and author. Each item must also be assigned to a category: for example, General or Presentation. Users can display category pages to access all of the items in the specified category quickly. Perspectives provide another dimension of classification. Each item may be assigned to many different perspectives. Users may also display perspective pages to quickly access all of the items in the specified perspective.

For convenience, the same sample content area, based on an entertainment concept, is used throughout this chapter. The content area's folder, category, and perspective structure is described below.

Table 2-1 Entertainment Content Area Folder Structure
Folder  Subfolders 

Dance 

Ballet, Ballroom, Jazz, Modern, Swing, Tribal 

Music 

Alternative, Blues, Country, Folk, Jazz, Pop, Rock, Rhythm & Blues 

Movies 

Action/Adventure, Comedy, Drama, Horror, Mystery, Romance 

Theater 

Comedy, Drama 

Visual Art 

Two Dimensional, Three Dimensional 

Table 2-2 Entertainment Content Area Categories and Perspectives

Categories 

Artist/Performer
Exhibit, General
Historical Reference
Performance
Poster
Recording
Reproduction
Review
Venue
Web Site/Index 

Perspectives 

17th Century
18th Century
19th Century
20th Century
1950s
1960s
1970s
1980s
1990s
Live
Outdoors
Adult Content
Family Friendly
Age 0-6
Age 6-12
Teens
Ticket Information
Image Content
Audio Content
Video Content
Full Color
Black and White 

Notice that one of the categories is called General. This category is created by Oracle Portal and, because it is the default, cannot be deleted. You must always have at least one category in your content area. Notice also that the 20th Century and Family Friendly perspectives have several child perspectives each. Both categories and perspectives may have child categories and perspectives

2.2.1 Gathering Information

The key to planning your content area is understanding the kind of information that will be stored in it and how users will most often use the information. To make this process easier, we recommend that you use the worksheets provided in this chapter to help you gather the necessary facts to design a successful content area.

Step 1 Get Organized

To prepare for the information gathering phase of designing your Oracle Portal content area, make copies of the following worksheets.

Figure 2-1 Item Worksheet

Item Description:

Who should be allowed to add this content?

Who should be allowed to view this content?

Who should control who can add/view this content?

Possible Classifications:

Mark the core content for this item:

File______ Text Item______ URL______ Folder Link______

PL/SQL Call______ App. Component______ Image Map______ Other:________

Standard Attributes for Items:

Name, Title, Description, Category, Perspectives (multiple), Author, Expiration Date, Image, Rollover Image, Keywords

Additional Attributes (may be displayed with item and used for searching):

Figure 2-2 User Community Worksheet

Owners  Content Providers  Viewers  Folders  Sample Items 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Step 2 Fill out the Item Worksheet

Complete a copy of the item worksheet for an item that you believe belongs in your content area. Try to come up with as many different example items as you can--don't bother to create multiple examples of the same kind of item. At this point, you should not worry about folders, categories, and perspectives. You will consider them in a later step.

Here is a sample of a completed item worksheet for the Entertainment content area:

Item Description: 
Movie review of new release, 13th Warrior. Would include image and a text 
review.

Who should be allowed to add  this content? 
Member of the movie team

Who should be allowed to view this content? 
Everyone

Who should control who can add/view this content? 
The head of the movie department

Possible Classifications: 
movie, review, adult content, movie rating, kind of movie: action/adventure

Mark the core content for this item:
File______  Text Item ___X__  URL______ Folder Link______ 

PL/SQL Call______  	App. Component______  	Image Map______ 	Other:___________

Standard Attributes for Items:
Name, Title, Description, Category, Perspectives (multiple), Author, Expiration 
Date, Image, Rollover Image, Keywords

Additional Attributes (may be displayed with item and used for searching):
Review date, movie release date, date available on video

When you find yourself unable to come up with any more items that need different 
classifications or attributes, you're ready for the next step.
Step 3 Fill out the User Community Worksheet

Use the user community worksheet to organize the information on the item worksheets.

It is quite likely that you will have multiple values in each of the cells of the user community worksheet. For example, you could have two or three different groups of content providers and five or six different groups of viewers for any one folder owner. In the sample item worksheet, the content provider was the movie team, the owner was the movie department head, and the viewers were everyone. It is possible that the movie team could be further divided in a manner to match the sub-folders in the Movies folder, or that these sub-folders would simply represent a more detailed level of classification that is best implemented via folders.

Step 4 Plan your folder structure

You are now ready to start planning your folder structure. The key choice you must make is what to implement as a folder, a category, and a perspective. The best way to tell the difference between a folder and a category is that folders are used by only part of your user community, while the categories make sense for most (if not all) of the user community. Folders and categories should both be specific in nature. It should be easy to tell to which folder branch and category each item belongs. Perspectives are those classifications that are harder to separate. Review the perspectives for the sample Entertainment content area in Table 2-2, "Entertainment Content Area Categories and Perspectives" again. A movie review for a movie might be in the Family Friendly, Full Color, and 1980s perspectives, but will only make sense in one category, the Review category.

Keeping all of the above information in mind, review your user community worksheet again. When a single entry in the Owners column corresponds to multiple entries in the Content Providers column, it typically signifies a branch in your folder hierarchy. Review your item worksheets again, paying particular attention to the possible classifications. Note any classifications that you feel correspond to the owners and content providers you have listed on the user community worksheet. If a classification corresponds to an owner or content provider, it is probably a good candidate to become a folder or subfolder.

In the Entertainment content area example, our sample item listed both Reviews and Movies as possible classifications. Looking at our user community, we see that while all the information managed by the head of the movie department has to do with movies, only some of it is classified as reviews. By looking at the rest of our Entertainment content area structure, you can see how the Review category would be listed as a possible classification for many sample items and in many different parts of the content area, while a movie classification would only be used in the movie folder and its subfolders. Therefore, it makes sense to make Review a category and Movies a folder.

2.2.2 Information Analysis

Once you have gathered information about the kinds of items that will make up your content area and the users who will build and view the content, it is time to carefully consider the specific attributes of your content area.

Step 1 Consider Security

The first step in creating a content area is to think about which members of your user community need privileges to modify the content and appearance of the content area. You have already started this process by gathering content area organizational information in the user community worksheet.

The basic building block of a content area is the folder. Folders in Oracle Portal are very similar to folders in a file system, but they also form the basis for content area pages. For example, when you click on a link to a folder, a page listing the contents of the folder is displayed. Like file system folders, Oracle Portal folders are hierarchical. Each folder has its own security and visual style properties, which may or may not be inherited from their parent folder. As discussed in Section 2.2.1, "Gathering Information", the user community worksheet can give you a good start in designing the folder structure of your content area.

Since most security is applied at the folder level, your folder structure will usually mirror the organization of the people who will maintain and access your content area. While you can implement item-level security with Oracle Portal, it typically requires less work to administer security at the folder level than at the item level--that is, to give users privileges on folders rather than individual items.

In our Entertainment content area, the folder structure has been designed for a group of content providers who are specialists in a particular area of entertainment. For instance, the owner of the Dance folder has complete control over the subfolders of the Dance folder. The owner of the Music folder, therefore, should not be able to add information to the Dance folder because Dance is not his or her specialty.

Imagine for a moment that the folder structure was organized differently. Imagine that the folders and categories were reversed, and all of the categories were folders and vice versa. The Dance specialist and the Music specialist would both need to have some control over the Review folder. As a result, access privileges would probably have to be maintained for each item. If the Review folder contained hundreds of reviews, this would quickly become a cumbersome administrative task. It is far better, then, to have folders that correspond to the different groups of content providers. In the case of our Entertainment example, this reversed folder-category structure would make sense only if the content providers were divided by the kind of information they knew about (reviews, venues), rather than the type of entertainment (movies, dance).

The most important thing to remember about folder organization is that folders are the most efficient means for assigning access privileges. Regardless of the folder structure, the viewer of the Entertainment content area can easily access a page of music, dance, and theater reviews.

Step 2 Consider Your Content

Oracle Portal content areas are especially good for classifying the items and other content that you add to them. The two main mechanisms for classifying your items are categories and perspectives. The key difference between these two mechanisms is that an item must belong to only one category, but can belong to zero or more perspectives.

Categories are best thought of as answering the question, "What is this item?" Since each item must belong to one and only one category, categories should be very basic classifications. Refer back to your item worksheets and consider the kinds of information that your content providers will be adding to your content area. Since content providers must assign every item to one category, the best categories are very distinctive and make it easy for your content providers to know which one to choose. If you find that your categories overlap, you should rethink the structure.

You can also create categories in a hierarchy. That is, you can create a parent category and group similar categories under it as subcategories. This hierarchical organization can be useful when you have a large number of categories and perspectives--but be careful not to create too many of them to avoid confusion. If you have more than ten categories, users may be overwhelmed by the options and choose the first category that roughly fits rather than the most apt category. In the Entertainment content area, you can see how the Review category is a very distinct classification that is useful across many of the folders. The harder it is for your content provider to choose a category for their content, the more likely it is that they will incorrectly classify their content, thus making it difficult to find.

Perspectives are best thought of as answering the questions, "Who will be interested in this item?" or "What is the role of the person to whom this item is the most important?" Perspectives can highlight special attributes of an item. In the Entertainment content area, we used the Outdoors perspective to identify items that describe something outdoors. A user scanning the contents of one of the Music folders will be able to see right away which items are about outdoor performances or outdoor venues.

Review your item worksheets again. Then, fill out the category and perspective worksheets below to sort through the remaining classifications for items that are not folders. It may be helpful to circle the folder for each item as it is listed in the possible classification portion of your worksheet. Your best categories are often those classifications that first seemed like they would be folders but were not used for the folder structure. Remember: both categories and perspectives are most powerful when they are usable across many different folders in the content area.

Figure 2-3 Candidate Category Structure: Content Area Name: ________________________

Category Name  Category Description  Child Categories  Example Items 

 

 

 

 

 

 

 

 

 

 

 

 

Figure 2-4 Candidate Perspective Structure: Content Area Name: ________________________

Perspective Name  Description  Child Perspectives  Example Items 

 

 

 

 

 

 

 

 

 

 

 

 

Step 3 Consider the User's Point of View

As you design your content area, it is important to keep in mind how it will be used. Users who are looking for the information in your content area have no idea that the content is organized in folders, categories, and perspectives. They simply click on the name of a category (that is, a category link), and it instantly takes them to a list of items assigned to the selected category (excluding any items to which they do not have viewing privileges). Likewise, clicking on the name or image of a perspective (that is, a perspective link) takes the user to a list of items in the content area assigned to that perspective.

Think about where you want to place your category and perspective links. A category link may be displayed:

Perspective links can appear in the same places as category links. In addition, you can optionally expose a perspective link next to each item assigned to the perspective by selecting the Display Icon With Items property in the Perspective Manager.

Step 4 Consider Navigation Aids

Folders, categories, and perspectives enable you to organize and cross reference your items in such a way that it is easy for your end users to find information in the content area.

Examine the top two levels of your folder structure. These are the folders that will be initially displayed on the default main content area page. Verify that the folder names are distinct from one another. Your top level branches in the folder structure should not have names that are easily confused with one another.

Filling out the Folder Tree worksheet below will give you an idea of what your top two levels of folders will look like to a user.Foot 1 Watch out for folders that are too similar. If the folders are not distinct, users will struggle to distinguish between them, making it difficult to know where to put and look for information.

Figure 2-5 Folder Tree Worksheet

 

 

___________________________________________ 

___________________________________________ 


___________________ ___________________ 


___________________ ___________________ 


___________________ ___________________ 


___________________ ___________________ 


___________________ ___________________ 


___________________ ___________________ 


___________________________________________ 


___________________________________________ 


___________________ ___________________ 


___________________ ___________________ 


___________________ ___________________ 


___________________ ___________________ 


___________________ ___________________ 


___________________ ___________________ 


___________________________________________ 


___________________________________________ 


___________________ ___________________ 


___________________ ___________________ 


___________________ ___________________ 


___________________ ___________________ 


___________________ ___________________ 


___________________ ___________________ 


___________________________________________ 


___________________________________________ 


___________________ ___________________ 


___________________ ___________________ 


___________________ ___________________ 


___________________ ___________________ 


___________________ ___________________ 


___________________ ___________________ 

After you have built your content area, examine the content area page as a whole (e.g., the navigation bar and folder listing). Sometimes users are looking for something very specific and at other times they are browsing to determine what information is available. Some users like to jump directly to an item, while others prefer to navigate to items sequentially. Your content area page should serve all of these scenarios. It is common to include a search box on the navigation bar for those users who would rather search than browse folders. Users who want to browse can make use of the folder structure, categories, and perspectives.

You should also consider issues such as whether you want the navigation bar to be a persistent part of the content area's interface. Oracle Portal enables you to use the same navigation bar throughout the content area, use different navigation bars depending on the context, or remove the navigation bar altogether. If you choose to have navigation bars, consider where to place them on the page (e.g., left, right, top, or bottom) and what to include in them. Navigation bars can contain a wide variety of elements (e.g., basic search, hyperlinks, and pull down lists). If you choose not to have a navigation bar, then you should include other mechanisms for simplifying navigation within the content area.

Step 5 Consider item types

When users add to your content area, they must identify the type of item (e.g., file or URL). Oracle Portal content areas come with an assortment of default item types. You can add to these default types as necessary. The default item types are:

Once users identify the item type, they are given a list of attributes to define for that item. This table helps you understand the attributes for each of the default item types:

Table 2-3 Attributes by Default Item Type (Required)
Attribute  File  Folder Link  image  Java App  PL/SQL  Text  URL  App. Comp.  Zip File 

Application Component 

 

 

 

 

 

 

 

 

Application Type 

 

 

 

 

 

 

 

 

Category 

Description 

Table 2-4 Attributes by Default Item Type (Optional)
Attribute  File  Folder Link  Image  Java App  PL/SQL  Text  URL  App. Comp.  Zip File 

Author 

Basic Search Keywords 

Display Options 

 

 

 

 

Enable Item Check-Out 

Hide Item 

Image 

Req. 

Image Alignment 

 

Perspectives 

Schema 

 

 

 

 

 

 

 

 

You cannot alter or add to the attributes defined for the base item types. If you wish to append additional attributes to a default item type, you can create a custom item type. Custom item types based on a default item type inherit the default's attributes, plus any custom attributes you create. In this way, you can use custom item types to collect additional structured information about items via their attributes.

You can also create custom item types from scratch, without basing them on a default type. In this case, the item type begins with only the most basic attributes, such as Display Name, Category, and Perspectives. You must add any other desired attributes to the item type yourself.

Review your item worksheets again, focusing on what you entered in the Additional Attributes column. If you don't have any additional attributes, then the default attributes will provide all the information necessary to track your items. If you listed additional attributes, use the item type worksheet below to figure out how many additional item types you need for your content area. Keep in mind that you can reuse attributes that you create across item types. For example, if you add a Due Date attribute and use it in two different item types, a search for items with a specific due date will examine the Due Date attribute for items in both item types.

List all of the additional attributes in the column below Attribute Name. List a data type for each additional attribute (such as number, date, character, file, URL, etc.). In the cell beneath each Item Type Name label, enter a name for your new collection of attributes. In the cell beneath each Based On label, enter the name of a default item type to indicate the item type to which you want to add your attributes. Mark with Xs those attributes used in each item type.

Figure 2-6 Item Type Worksheet

  Item Type Name  Item Type Name  Item Type Name  Item Type Name  Item Type Name 

 

 

 

 

 

 

Attributes 

Based On: 

Based On: 

Based On: 

Based On: 

Based On: 

Name 

Data Type 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

When you want to associate additional attributes with the folder instead of the item, you can create a custom folder type.

2.2.3 Troubleshooting Your Content Area Structure

Even the most diligent planners cannot always foresee every contingency. Hence, you will undoubtedly run into issues after you have created your content area that will cause you to revisit its organization. These sections describe some common problems that arise after you have implemented your content area.

2.2.3.1 All of My Content Areas Have the Same Categories

Oracle Portal provides a Shared Objects content area where you can store categories, perspectives, styles, navigation bars, attributes, and item and folder types that apply to all of your content areas. If you find that you are constantly recreating the same things for every content area, you should consider building them in the Shared Objects content area so that you can build them once and reuse them in multiple content areas. Shared Objects can increase the integration and consistency between content areas.

2.2.3.2 Item Level Security is Required Everywhere

You may be required to use item level security for your content area, but this is often a sign that you could have set up your content area differently. The main thing to keep in mind is that folders should be the main level at which security is applied. Look at your categories. Would your site work better if your categories were folders and your folders were categories?

2.2.3.3 I Do Not See Links to My Perspectives

You may need to change your settings to ensure that you have links to your perspectives.

2.2.3.4 My Categories Do Not Appear in the Content Area Map

Consider creating a folder based upon a saved search. You can add a folder to your hierarchy and define it as a search for all items belonging to a specific category. If you name that folder the same as your category, it will seem to users that there is a folder on the content area map holding all of the items in that particular category.

One advantage of this type of folder is that it is completely dynamic. As new content is assigned to the category, the search picks up the new items without any intervention from you. This method works just as well for any type of search that you want to save and make available to your users.


1 Keep in mind that not every use will have privileges to see every folder. Given that, you may want to make copies of the folder tree worksheet for different groups of users.


Go to previous page Go to next page
Oracle
Copyright © 2001 Oracle Corporation.

All Rights Reserved.

Library

Service

Contents

Index