Administrator Guide

     Previous  Next    Open TOC in new window  Open Index in new window  View as PDF - New Window  Get Adobe Reader - New Window
Content starts here

Introduction to Publisher

This chapter provides an overview of Publisher and discusses:

You should understand the concepts discussed in this chapter before you start using Publisher. Each concept is described in more detail in later chapters.

 


About Publisher

As the Web publishing system for AquaLogic User Interaction, Publisher provides the foundation services required to deploy content-driven applications, like a customer support knowledge base or sales support center, where business people can create and manage Web content without HTML skills. Publisher works cohesively with other AquaLogic Interaction components to enable business users to enjoy a simple Web publishing experience and administrators to take advantage of fully integrated administration, search, security and user profile management.

Integrated with portal user management, document management, and search, Publisher is especially well-suited for customers who have many content contributors and want to standardize on a set of published content portlets for handling all common types of portal content, including articles, customer profiles, employee reports, news stories, and so forth.

 


Publisher Features

This section discusses:

Overview of Content Creation and Publishing

Publisher enables users to create, store, and publish content through portlets, the portal Knowledge Directory, and external Web sites.

Although there are many ways of creating and publishing content using Publisher, a typical content contributor submitting an article to a community page in the portal might use the following procedure:

  1. Access the Community Knowledge Base portlet on the community page.
  2. Open the "How to Article" folder in the portlet and click the Create button to open the Content Item Editor.
  3. In the Content Item Editor, enter property values in a series of edit boxes: Name, Title, Summary, More Information.
  4. Preview the article as it will look when published to the portal.
  5. Save the article. It now appears in the Community Knowledge Base portlet folder in the Publisher Explorer, where administrators and other authorized Publisher users can view it in the context of the Publisher folder hierarchy, and where users can perform almost any Publisher function on the article, depending on their security role.
  6. Submit the article to workflow.
    1. In the first workflow step, an editor gives the article an edit and approves it for forwarding to the next workflow step.
    2. In the next workflow step, the community manager approves it and publishes it to the Web server and the portal Knowledge Directory.
  7. The article now appears in the How to Article folder of the Community Knowledge Base portlet on the community page, available for any user with access to the portlet to view—and for users with the proper Publisher security role to check out, edit, and republish. It also appears in the portal Knowledge Directory and is indexed in the portal search index.

Publisher Features and Editors

In following this submission and publication process, the contributor is using, directly or indirectly, most of the features provided by Publisher:

Table 2-1 Publisher Features
Feature
Description
Published content portlets
Published content portlets, such as the Community Knowledge Base portlet in the example, present content through the portal and can enable users to submit and edit content.
Published content portlet templates
Published content portlet templates enable a user without HTML skills, like a community manager, to create published content portlets using the Configure Portlet Wizard.
Publisher provides six sample portlet templates that you can use as-is or configure to meet your organization's needs using the Configure Portlet Template Wizard. You can also create your own portlet templates from scratch using this wizard.
Content items
Content items are the base objects that you manage through Publisher; a content item can be a set of values that you enter through Content Item Editor or an uploaded document or image file.
Content Item Editor is the interface for creating and editing content items. Content Item Editor displays a set of fields to enter data into, much like filling out a form. You can use Content Item Editor to preview a content item as it will appear when published to the portal or Web, submit a content item to workflow, view and open previous versions of a content item (if you have permission), and publish it.
Data entry templates
Content items that you create using the Content Item Editor are built on data entry templates, which define the properties available for creating a content item. When you create or edit a content item from a data entry template, these properties appear in the Content Item Editor as editable fields. You create and edit data entry templates using the Data Entry Template Editor.
Presentation templates
Data entry templates are always associated with a presentation template; when you publish a content item to the Web server or preview it on the preview site, the presentation template determines its appearance and format. You can create and edit presentation templates using the Presentation Template Editor. It takes some HTML skill to create and edit presentation templates.
Publisher Explorer
Publisher Explorer is the central interface for viewing and managing all Publisher objects, including content items, data entry templates, and presentation templates. Publisher Explorer enables administrators to set up and manage a folder structure to organize content items and published content portlets, and to assign security roles to users and groups by folder. Typically, the folders in Publisher Explorer reflect the organization and ownership of portal communities, such that community managers and content owners are enabled to create and publish information within their scope of responsibility.
Publisher Explorer allows as wide a spectrum of users as you like to view and search it. Depending on your Publisher role, you can use Publisher Explorer to perform almost any Publisher function, including creating and editing content items, data entry templates, and presentation templates, as well as publishing content items.
Workflow
Workflow enables your organization to manage the review, approval, and publishing of content through structured and repeatable processes. Administrators define workflows using the Workflow Editor. A workflow consists of an ordered list of workflow activities, each of them assigned to a user or group of users. Once a content contributor submits a content item to workflow, it is passed onto an assignee for review and approval, and moves along from activity to activity (whether forward after approval or backward after rejection), with each assignee notified automatically, until the final assignee approves and publishes the item. In addition to automatic notification, Publisher provides portlets that enable tracking of personal workflow assignments and content items in workflow by folder.
Publishing and expiration
Publishing places the formatted, Web-ready file in a file location that can be accessed by the Portal or other Web server. Users with the appropriate permissions can publish a content item immediately (if it is in a publishable workflow activity or not subject to workflow), schedule a content item for future publication on a one-time or recurring basis, or set a published content item to expire, either immediately or at a future time.
File content items
File content items are content items that you create by uploading images or documents to Publisher. You can include file content items as links or as properties of other content items. You can manage and publish file content items without having to use the Content Item Editor.
Using WebDAV (Web-based Distributed Authoring and Versioning) to map a Microsoft Windows network folder to the Publisher folder hierarchy, you can use Microsoft Windows Explorer to:
  • View file content items and the Publisher folder hierarchy.
  • Upload and download file content items between Publisher and your local filesystem.
  • Open file content items for editing on your desktop.
You can also use the WebEdit feature for Microsoft Office files that you have uploaded into a content item. WebEdit lets you open and edit the file in its native editor without leaving the Content Item Editor and without having to perform uploads and downloads.
Diagnostics
The Diagnostics pages enable administrators to run and view the results of diagnostic tests on Publisher and the Workflow Service, as well as to view key system properties.
See the BEA AquaLogic User Interaction Knowledge Base for articles that describe this feature.
Object Migration
The Migration Wizard enables administrators to migrate Publisher objects between production, staging, and development sites.

Publisher Intrinsic Portlets

In addition to the features and editors listed above, Publisher provides the following intrinsic portlets that give users access to Publisher functionality from portal pages:

Table 2-2 Intrinsic Portlets
Portlet
Description
Publisher Administration
Enables you to access Publisher Explorer. Administrators or users with the appropriate portal activity rights can also use it to access Workflow Administration and the Diagnostics page.
Content Submission
Generally used on community pages, this portlet enables you to quickly and easily submit content items to Publisher based on data entry templates chosen by the community manager.
Most Recently Used Content
Provides access to the content items you have viewed most recently in the Content Item Editor. It displays the item name, the data entry template, the associated portlet, the user to which the item is assigned, any current workflow activity, and whether or not the item is currently checked out.
Publisher Work List Portlet
Provides access to all of the workflow activities that are currently assigned to you. It displays the name of the item in workflow, workflow activity, the due date, and other information. It enables you to approve or reject an item; and claim, transfer, or delegate an assignment. It also enables you to view the current status of all items that you have submitted to workflow, that you have delegated to others, and that you have completed a workflow activity for.
Content Items in Workflow
Enables you to view all items in workflow in a selected Publisher folder or folders, including workflow activity, assignee, and due date.

For more information on the Publisher intrinsic portlets, see the online help.

 


Publisher Folder Hierarchy

Publisher Explorer provides a folder structure that enables you to access and manage Publisher objects. Publisher security, workflow, and publishing targets (the file locations on the Web server to which content items are published) are all set by folder. The folder hierarchy therefore determines or mirrors the following:

In addition, Publisher organizes the objects that make up a published content portlet in a specified portlet folder.

For more information, see Setting up and Securing the Publisher Folder Structure.

 


Publisher Users and Roles

Publisher security is role-based, and the roles follow the spectrum of typical Publisher responsibilities, from the administrator, who has complete access, to the casual reader, who can view content. Because roles are assigned by Publisher folder, users (except the user in the Administrator role) may play different roles for different folders. For example, for the Marketing Community folder in Publisher, the Marketing portal community manager might have the Folder Administrator role, which provides broad administrative powers, but for the Employee Relations Community folder, she might have only the Submitter role, which allows users to submit content but provides little content management authority. This section discusses how to map Publisher roles to typical Publisher responsibilities.

Publisher Roles

Access to content and features in Publisher is controlled through the assignment of the following roles to users and groups at the Publisher folder level:

Table 2-3 Publisher Roles
Role
Description
Reader
Enables you to view content and—if you have been assigned an item in workflow—approve or reject the item, or transfer your workflow assignment to another user.
Submitter
Enables you to create, preview, edit and submit articles to workflow, as well as approve or reject an item you have been assigned in workflow.
Contributor
Provides the same permissions as Submitter, but also allows you to view content item notes, workflow, version history, publishing information, and publishing schedule.
Editor
Provides the same permissions as Contributor, but also allows you to publish items to Publisher and to the portal Knowledge Directory.
Producer
Provides the same permissions as Editor, but also allows you to create and edit folders, data entry templates, selection lists, and presentation templates; preview and publish content items both individually and by folder; edit content items assigned to others; and configure folders to publish and preview.
Folder Administrator
Provides the same permissions as Producer, but also allows you to undo other users' check-outs, manage published content portlets, and set or change workflow assignments and Publisher security on folders.
Administrator
Portal Administrators are automatically granted the Publisher Administrator role and have access to every folder and every feature in Publisher. Administrators can create, edit, copy, and delete top-level folders, delegate administrative rights at the folder level, and access Workflow Administration to set up system-wide workflow definitions.
Portal administrators can assign the following activity rights to give administrative authority to other users and groups:
  • The Administer Publisher activity right gives users and groups the Administrator role.
  • The Configure Workflow activity right gives access to all workflow administrative functions. This access is also included in the Administer Publisher activity right.

Publisher Users

Publisher is designed to meet the needs of the following typical users. The table maps these users to appropriate Publisher roles:

Table 2-4 Publisher Users and Roles
User
Description
Roles
Reader
Uses portlets and published content for business activities.
Reader; Submitter if user occasionally submits content through portlets.
Content contributor
Subject-matter expert; uses portlets to view and submit new content; edits content; uploads images and documents; participates in workflow processes.
Submitter; Contributor if user must be able to edit. Role is usually folder-specific.
Content editor
Subject-matter expert with content management or approval duties—as technical reviewer, editor, or standard-keeper. Performs the same duties as a content contributor, but with an emphasis on editing content, approving items in workflow, and publishing.
Editor. Role is usually folder-specific—especially for portlet folders or folders associated with a community or type of content.
Content manager
Power user or portal community manager; defines portlet and publishing business requirements; creates content and portlets; customizes portlets created from portlet templates for the community; oversees content publishing and expiration; invokes workflow processes for management of content approval and publishing.
Folder Administrator. Role is usually folder-specific.
Technical portlet creator
Web application developer or Web designer; creates and edits data entry templates, presentation templates, and portlet templates to meet business requirements, which are usually determined by a content manager; imports content items from external sources.
Producer; Folder Administrator if user must be able to detach portlets from portlet folders, assign security, or undo other users' checkout. Role often applies to many folders, especially portlet templates.
Administrator
Portal manager or information management specialist; installs, upgrades, and maintains Publisher configuration and content organizational structure, including security settings and workflow standards.
Administrator

For more information, see Setting Up Security.

 


Publisher Architecture

As a component of AquaLogic User Interaction, Publisher integrates with the AquaLogic Interaction portal and search products.

Figure 2-1 Publisher Architecture

Publisher Architecture

The Publisher architecture consists of the following major components:

AquaLogic Interaction

AquaLogic Interaction allows users to access published content through portlets in My Pages and community pages, as well as through the Knowledge Directory. It also enables users to search all published content. In addition, it allows some administrative actions, such as editing portlets and portlet templates, viewing portlet preferences, and managing communities.

Portal Database

The portal database stores the data used by AquaLogic Interaction. This includes information about user profiles, portal security, Web services, and all portal objects, including portlets and portlet templates. The portal database does not store the content available through the portal. Content is copied by Publisher from the Publisher database (content items) and the Document Repository Service (file content items) during publishing.

Publisher Database

The Publisher database stores the data used by Publisher. This includes content items, data entry templates, presentation templates, Publisher folders, and role assignments. File content items uploaded to Publisher, however, are stored in the Document Repository Service.

Workflow Database

The Workflow database stores workflow definitions, activities, workflow instances, and workflow users.

Published Content Remote Server

The published content remote server is the location from which the portal server fulfills Web requests for published content available through the portal.

Image Service

The Image Service serves images and other static content used by the portal system. You can connect multiple Administrative Portals and AquaLogic Interaction portals to the same Image Service, or each Administrative Portal or AquaLogic Interaction portal can connect to its own Image Service. You can also combine these approaches.

If you host the Image Service on a computer different from the portal and Publisher, users' browsers do not need to send security information for every image request, greatly increasing the efficiency of your portal system.

Search Service

The Search Service hosts the search engine and search collection, which contains text and metadata indexes for objects in the portal (for example, documents, communities, and portlets). If your portal indexes many documents, the search index can grow to be quite large. At times, this collection of files can be equal in size to the sum of the ASCII-representations of all of the documents indexed by your portal. Though this is not generally the case, the computer hosting the search index does need sufficient disk space to handle this. As more documents are brought into your portal, the number of unique words (words not already listed in the index) decreases. Therefore, as the number of documents in your portal increases the index size will slow in its growth.

Content items are indexed for search during publishing.

Document Repository Service

The Document Repository Service stores content uploaded into the portal system, including images and file content items uploaded into Publisher.


  Back to Top       Previous  Next