Skip Headers
Oracle® Instant Portal Getting Started
10g Release 2 (10.1.2)
Part No. B15879-01
  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
 

1 Getting Started with Oracle Instant Portal

This document acquaints you with the basic concepts and terminology you'll need to use Oracle Instant Portal effectively. For detailed instructions on how to accomplish specific tasks within Oracle Instant Portal, see the product's online help.


Note:

This book assumes that the Oracle Application Server 10g Release 2 (10.1.2) Standard Edition One installation process has been completed. See Oracle Application Server Installing and Getting Started with Standard Edition One for installation instructions if you need them.

1.1 What Is Oracle Instant Portal?

Oracle Instant Portal is a key component of Oracle Application Server 10g Release 2 (10.1.2) Standard Edition One. Whereas Oracle Application Server Enterprise Edition offers a comprehensive platform to build, integrate, deploy, and manage large-scale applications, Oracle Application Server 10g Release 2 (10.1.2) Standard Edition One optimizes these benefits for smaller organizations, such as small-to-medium enterprises, individual departments of larger corporations, or mid-market ISVs. Oracle Instant Portal provides instant out-of-the-box portals for secure publishing and content sharing, ideal for enterprises with a need for smaller-scale intranets or an internal communications hub. With Oracle Instant Portal, you can have a functioning portal in less than an hour. Consider these benefits:

Perhaps the best way to begin to understand Oracle Instant Portal and what it can do for you is to take a look at what you get once the installation process is finished.

1.1.1 What Do You Get Out Of the Box?

Your first Oracle Instant Portal is created for you automatically, as part of the Oracle Application Server 10g Release 2 (10.1.2) Standard Edition One installation process. When you complete that process, you're taken to the home page of your first portal, which by default looks like this:

Figure 1-1 Default Home Page

Default Home Page
Description of the illustration default.gif

As you can see, right out of the box you're presented with a fully functioning, albeit simple portal, ready for you to start adding content. Let's take a quick tour of the home page and talk about some of the changes you may wish to make there.


Note:

By default, the password for this portal is whatever was entered for the ORCLADMIN user during installation. You can use the Change Profile link to change the password.

Familiarizing Yourself with the Home Page

Like all home pages, the Oracle Instant Portal home page is intended to be a central access point for items of interest to all users of the portal. To make things easier, the body of the page is divided into four distinct areas in which those items can appear:

  • News: Items pertaining to events occuring in your industry, for example, or at a corporate level.

  • Announcements: Items that remind or inform people of upcoming events within your company or department.

  • New Content: Items that were added anywhere within the portal over the last seven days. The New Content area is automatically populated; you don't have to do a thing.

  • Favorite Content: Content unique to each user. As users move through the portal, they can flag content they want to see on their home page by clicking a simple icon that appears beside each item.

Now let's see a home page that has undergone a bit of customization at a fictitious company, TangFish Software:

Figure 1-2 Customized Home Page

Customized Home Page
Description of the illustration IP_5.gif

The Oracle Instant Portal administrator at TangFish Software has customized this page to reflect the company's identity in several ways:

  1. The name of the company appears in the banner.

  2. The company's official logo also appears in the banner.

  3. Along the left side of the page, the administrator added links to email addresses for TangFish's Support and Feedback groups, so that users can access them quickly.

  4. A link to the company's corporate Web site was added at the bottom of the page.

These are all things the administrator did explicitly. If you're the Oracle Instant Portal administrator, you'll probably want to make similar kinds of customizations to your own home page. Before you begin doing so, however, take a moment to read the next section and arm yourself with an understanding of the basic principles of how Oracle Instant Portal works.

Understanding Oracle Instant Portal

Let's take a look at another page from TangFish Software's portal to help illustrate some basic Oracle Instant Portal concepts:

Figure 1-3 Basic Oracle Instant Portal Concepts

Basic Oracle Instant Portal Concepts
Description of the illustration IP_4.gif

  1. For TangFish Software, the default tabs along the top (Company, Finance, Marketing, and so forth) are perfectly suited to their goals, as they wish to create a company-wide intranet that includes these organizations. (The administrator did re-order the tabs slightly, however.) This may be the case for your group as well, or you might want to rename the tabs and/or create new ones to better reflect your organization. A travel agency, say, might find that tabs named Hotels, Restaurants, Air Fares, and Rental Cars are more closely aligned with the kind of work they do.

  2. When you click a tab, a page called a top-level page is displayed. In this example, the content of the Sales top-level page is displayed on the right side of the page, which is called the content area. Although the Sales page is populated with content in this example, by default all top-level pages are empty, waiting for you and your users to load them with content.

  3. Notice the navigation area on the left, which appears on every page (except the home page). The navigation area contains:

    1. The search box, which enables you to search the entire portal for a given string, or limit your search to a single top-level page.

    2. A list of the child pages for the current page. For the Sales top-level page, these pages are called Sales Reports, Presentations, Customers, and so on. Child pages are pages you create below a top-level page to organize the content associated with the larger theme, just as folders and sub-folders are used to organize content on your Windows desktop.

      You can see how all of the Sales page's child pages clearly support the Sales organization. In fact, every top-level page comes with its own set of pre-created pages, designed to help you organize your work within that theme. And because each child page can have its own child pages (the Customers page has three), you can easily create a hierarchy to neatly organize all of your content. The Sales hierarchy, for example, looks like this:

    Figure 1-4 The Sales Hierarchy

    The sales Hierarchy
    Description of the illustration IP_2b.gif

Now that you understand the concept of top-level and child pages, let's return to the home page for a moment. Recall that the content that appears there is simply a collection of content from other places. The News and Announcements areas of the home page are actually populated by two child pages of the Company page, as illustrated here:

Figure 1-5 Child Pages of the Company Page

Child Pages of the Company Page
Description of the illustration IP_1d.gif

By default, the Company page comes with two child pages, News and Announcements. Whatever you place on those pages also appears in the News and Announcements areas on the home page.


Note:

If you don't like the names of the News and Announcements pages, you can easily change them to names that more closely reflect the kinds of content you want to display on your home page. As soon as you change the name of the page, the name of the corresponding area on the home page changes as well.

1.2 What Can You Do with Oracle Instant Portal?

As you begin working with Oracle Instant Portal, you'll immediately see how quickly you can customize the portal to reflect your organization. As time goes on, you'll find that it's simple to administer the portal, and extremely easy for your users to come up to speed with it and to start contributing and sharing content. Let's take a look at some of these tasks.

1.2.1 Contributing Content

Here again is the sample page from the TangFish Software portal:

Figure 1-6 Sample Page from TangFish Software Portal

Sample Page
Description of the illustration sampcnt1.gif

Each block of text delineated by horizontal lines is an item within the portal. In this example, there are two items: "Welcome to the Sales Department" and "Sales Forecast Expected Soon". Items are the means through which you add content to your portal. You can add items to the portal by clicking the Edit Mode icon, which is located at the top of every Oracle Instant Portal page. You will see the Edit Mode icon, shown subsequently, only if you have the privileges to add content to the page:

Edit mode handle bar
Description of the illustration handle.gif

(More about privileges later.) Once you are in edit mode, you'll see the New Item button, located in the content area:

Figure 1-7 New Item Button in the Content Area

New Item button in the Content Area
Description of the illustration additem.gif

When you click the New Item button, a list of item types is displayed:

Figure 1-8 List of Item Types

List of Item Types
Description of the illustration additm1.gif

The type of item you select depends upon the kind of content you want to add, as described in the following table:

Table 1-1 Items in Oracle Instant Portal

If you have this kind of content... Add this type of item
Longer text Expandable Rich Text item. Apart from a title and summary, the actual text of the item is not displayed until the user reveals it by clicking an icon. For this reason, Expandable Rich Text items are ideal for conserving real estate on the page.
Shorter text, such as a news item Rich Text item. A title, a summary, and the text in its entirety is displayed directly on the page.
Content that already exists in a separate file, such as a .doc or html file File item. A title, a summary, and an icon that looks like a file are displayed on the page. When the user clicks the icon, the file you named opens in a secondary browser window.

The file is uploaded to the portal repository, a central clearing house for content stored in portals.

A picture or graphic image Image item. The image appears on the page itself, along with an optional title and description.

The image is uploaded to the portal repository.

Another location, either internal or external to your Oracle Instant Portal URL item. A title, description, and an icon that looks like a globe appears on the page. When the user clicks the globe, the destination you named opens in a secondary window.

The TangFish home page, for example, has a URL item that takes users to the TangFish corporate Web site.

An email, pre-seeded with an address Email item. A title and an icon that looks like an envelope appears on the page. When the user clicks the icon, an email editor displays a blank email, already addressed to the person or organization you named.

Once you select the type of item you want to add, all you have to do is follow the prompts to supply the necessary information. For example, when you add a File item, you are prompted for the file you want to upload. Once you confirm the file name, the file is uploaded to the portal repository. Then you can add the title and summary text to the page so that others can understand what you just uploaded.

The first time you add a Rich Text or Expandable Rich Text item, you'll be impressed by how Oracle Instant Portal's in-place editing capabilities drastically simplify the task. As soon as you add an item, it appears on the page in context, ready for you to begin editing:

Figure 1-9 In-Place Editing Capability

In-Place editing Capability
Description of the illustration edit.gif

Now you can start entering the title, the summary, and the text of the item, exactly as it will appear to your users. And while you're writing your text, you have access to a full range of text editing controls, including bulleted lists, numbered lists, tables, cut and paste, indents and outdents, and so on. You can even work directly with HTML code, or switch back and forth between modes as you need to. You can also enrich your text by including images, hyperlinks, and tables. In this example, a table is being added, which can be populated and/or modified using standard table editing tools:

Figure 1-10 Sample Table Addition in Internet Explorer

Sample Table Addition in Internet Explorer
Description of the illustration richtxt.gif

To give you the flexibility you need, Oracle Instant Portal enables you to cut and copy items, move items to different pages, delete items—all the tools you need to develop content-rich portals and allow you to manage and share that content with others. And if something isn't quite right with what you've done, you can use the Revert key to restore the portal to the way it was before you started editing.


Note:

If you have WebDAV enabled, you can add your Oracle Instant Portal as a Web folder and interact with it right from your desktop.

1.2.2 Creating New Pages

It's just as easy to add top-level pages and child pages in Oracle Instant Portal as it is to add items. One of the aspects of Oracle Instant Portal that makes it so simple to use is that navigation and creation are inextricably linked. You don't have to create an entity and then introduce that entity later into an existing structure. Everything is done in context. For example, you can create child pages right in the navigation area, then use simple controls to reposition, edit, or delete that page:

Figure 1-11 Creating Child Pages in the Navigation Area

Child Pages in the Navigation Area
Description of the illustration addch.gif

Similarly, Oracle Instant Portal administrators can add, delete, or edit top-level pages right in context:

Figure 1-12 Top-Level Pages

Top-Level Pages
Description of the illustration addtl.gif

1.2.3 Administering Oracle Instant Portal

Managing an Oracle Instant Portal is far less complicated and takes significantly less time than managing a full-scale enterprise portal. With just a few simple steps, you can brand your portal with your corporate identity, select a color scheme for your portal, and set up accounts for all your users.


Tip:

If you're the Oracle Instant Portal administrator, look for the topic called "Setting Up Oracle Instant Portal: A checklist" in the online help for a complete list of the customization options available to you.

1.2.3.1 Customizing the Look and Feel

There are three main ways in which to brand your portal, two of which occur in the portal's banner. The banner is the top region of the page, which is identical for every page within the portal. Here is an example of a typical banner:

Figure 1-13 Banner in a Page in a Portal

Banner in a Page in a Portal
Description of the illustration banner.gif

The Welcome link at the top of the banner contains the name of the logged in user (in this example, MARCO), along with links to log out of the portal and to change aspects of the user's profile. You can also add your own corporate logo to the right of the banner, and provide a name for the portal on the left.

Selecting a style for your portal is equally easy. By clicking the style icon, you can display ten different styles, each centered around a different color scheme. As you run your cursor down the list, you can instantly see how your portal appears in each color. When you select the one you want, the entire portal is rendered in that color scheme for every user.

Figure 1-14 Style Icon on a Portal Page

Style Icon on a Portal Page
Description of the illustration styles.gif

1.2.3.2 Controlling Access to Your Portal

Creating users and managing the roles they are to play within the portal can be an arduous task. In Oracle Instant Portal, however, a simple security model protects your content without placing an undue burden on you, the administrator.

A single user can have a different level of security for each top-level page within the portal: View, Contribute, or Manage.

  • View privileges allow the user to view content on the page.

  • Contribute privileges allow the user to add items to the page.

  • Manage privileges give the user full permissions over the page, including the ability to add child pages.

The privileges you set for a top-level page cascade down to the child pages as well.

Users are created and their permissions are managed through a single, easy-to-use dialog:

Figure 1-15 Dialog to Create Users and Their Permissions

Dialog to Manage Users
Description of the illustration mngusr.gif

The left pane lists all registered users, while the pane on the right lists all the pages in the portal. When you select a user on the left, the pane on the right reflects that user's privilege level for each page in the portal. Granting or revoking privileges is as simple as checking or unchecking a box.

You can also control access to a page from the page itself, by clicking the Manage Page Privileges icon (circled below):

Figure 1-16 Manage Page Privileges Icon

Manage Page Privileges Icon
Description of the illustration secure.gif

The Manage Page Privileges window looks similar to the Manage User Rights window, but the privileges you can set there are restricted to the page from which it was launched.

When a user is granted Manage privileges on any portal's home page, that user is considered an Oracle Instant Portal administrator and has full privileges over that particular portal. Additionally, the Oracle Instant Portal administrator can:

  • Create new users.

  • Delete any user in the Manage User Rights dialog, even those he or she did not create. (For this reason, it's wise to restrict the number of users who have Manage privileges on a home page.)

  • Create new Oracle Instant Portals.

Users that were created through OracleAS Portal can also have access to Oracle Instant Portals, as long as you first add the users to the OIP_AVAILABLE_USERS group. Then you can use the Manage User Rights dialog to grant appropriate privilege levels to the users.

1.2.3.2.1 What Users Are Created by Default?

During the Oracle Application Server Standard Edition One installation process, the following user/groups are created:

  • User called PORTAL, who is an Oracle Instant Portal administrator for all Oracle Instant Portals.

  • User called ORCLADMIN, who is an Oracle Instant Portal administrator for all Oracle Instant Portals.

  • Group called OIP_USER_ADMINS (List of users who can create new Oracle Instant Portals and perform user administration. Both PORTAL and ORCLADMIN are members of this group.)

  • Group called OIP_AVAILABLE_USERS (List of users who can access Oracle Instant Portals, which appears in the Manage User Rights dialog. Neither PORTAL nor ORCLADMIN are in this group; thus, they do not appear on the Manage User Rights dialog. This protects these important user IDs from accidental deletion.)

1.2.3.3 Creating New Portals

You may find that you need more than one instance of Oracle Instant Portal to fulfill your needs. You may want Sales, Marketing, and Development to have their own portals, for example, or perhaps you want to set up separate portals to exchange information with your suppliers or customers. Generating new instances of Oracle Instant Portal is easy. Simply click the Portal Builder link in the Edit Mode toolbar:

Figure 1-17 Portal Builder Link in the Edit Mode Toolbar

Portal Builder Link
Description of the illustration build.gif

This link takes you into OracleAS Portal, through which you can access the Oracle Instant Portal portlet:

Figure 1-18 Link that Accesses the Oracle Instant Portal Portlet

Link to the Oracle Instant Portal Portlet
Description of the illustration oip.gif

With this portlet you can create new portals, navigate between your portals, or delete portals you no longer need—assuming you have the appropriate privileges. You can also write an XML file to dictate the structure of your portal, rather than accepting the default company theme of Marketing, Sales, Finance, and so on.

1.3 What's Next?

Now that you're familiar with the basics of Oracle Instant Portal, you're ready to begin using it! Assuming that you're the Oracle Instant Portal administrator, check out the online help to find out exactly how to customize your instance of Oracle Instant Portal as described in this document.

You'll find that most tasks within Oracle Instant Portal are completed through steps that are quick, easy, and largely intuitive. That means that most of your users will be independent almost immediately, and few will have to spend valuable time experimenting or consulting the documentation to see how to complete a given task.