Contents

List of Figures

List of Tables

List of Procedures

Preface

About This Manual

Overview of Process Builder Components
Using Process Builder
Advanced Scripting and Setting Up Searching
Sample Applications
Reference Material

Conventions Used in This Manual
Viewing Documentation
For More Information

Chapter 1 Overview of iPlanet Process Manager

Workflow in Business Processes
Designing a Process
Performing Tasks in a Process
Administering Processes
Summary of Process Manager Components

Chapter 2 Introduction to Process Builder

About Processes and Process Builder

What is a Process?
What is Process Builder?
Who Should Use Process Builder?
What is a Process Instance?

About Applications

Creating an Application
Deploying an Application
Sample Applications

Configuring Builder for Secure Deployment

About https Deployment Support for Process Builder
Configuring the Server (iWS and iPM)
Enabling Content Store Over https

Configuring Builder for Deployment Through a Proxy
Configuring Builder for Internationalization Support

Enabling Non-ASCII Character Display in Builder
Enabling the InputMethodEditor for Non-ASCII Character Display in Builder
Operating Character Set Changes
Configuring Locale Settings for Applications Using Mulitbyte Characters

Starting Process Builder

Editing the preferences.ini File

Specifying a Cluster
Specifying a Corporate Directory
Adding or Changing Local Application Folders

Starting Process Builder on Windows NT
Starting Process Builder on Solaris

Using Process Builder

Process Builder Applications
Application Tree View
Process Map
Map Palette

Activities Tab
Documentation Tab

Messages Window
Main Toolbar
Menu Commands

Application
Edit
Insert
Format
Window
Help

HTML Page Editor Toolbar

Chapter 3 Planning an Application

Planning Overview
Planning the Process Map

Entry Points
User Activities
Automated Activities
Custom Activities
Subprocesses
Decision Points
Parallel Processing
Exit Points
Transitions
Notifications
Exceptions

Planning Assignments

Planning Groups and Roles
Planning for Monitoring
Planning Delegations

Determining the Data Requirements

File Attachments

Planning Forms

Planning Access to Forms

Planning Custom Scripts
Planning Searches
Planning Deployment

Chapter 4 Creating an Application

Application Creation Overview
Getting Information from the Administrator
Creating a New Application

The New Application Dialog Box
Setting Application Properties
The Application Properties Dialog Box

Using Sample Applications

Applications and the Corporate Directory
Setting Your Corporate Directory

Deleting an Application

Chapter 5 Designing a Process Map

Drawing the Process Map
Saving a Process Map to a File
Adding Items with the Map Palette
Deleting Items
Entry Points
User Activities

Setting Activity Expirations
Setting Activity Assignments
Using Parallel Approval

Parallel Approval Completion Script

Automated Activities
Subprocesses

Connecting the Parent and Child Process

Custom Activities

Using a Custom Activity
Custom Activity Inspector Window
Inspector Window After Setting a Custom Activity
Adding a Custom Palette

Exception Manager

Default Exception Manager
Creating an Exception Manager
Exception Manager Properties

Decision Points
Split-Join (Parallel Processing)

Properties of a Parallel Process
Adding a Parallel Process

Notifications

Notification Properties
Built-in Email Notification Scripts

Exit Points
Transitions

Types of Transitions
Adding a Transition
Transition Properties

Setting the Property for a Virtual Transition
Setting the Property for a Conditional Transition

Example Using a True/False Field

Chapter 6 Defining Groups and Roles

Groups and Roles Overview

Default Groups and Roles

Creating Groups and Roles

The Create a New Role or Group Dialog Box

Types of Groups and Roles
Adding a New Group or Role

The Application Group Dialog Box
The Corporate Group Dialog Box
The Dynamic Group Dialog Box
The Field Role Dialog Box

Prioritizing Groups and Roles
Deleting Groups and Roles

Chapter 7 Defining Data Fields

Data Field Overview
Creating a Data Field

The Create a New Data Field Dialog Box

Creating a Custom Data Field
Creating a Predefined Data Field
Adding a Data Field

Setting Field Properties
Custom Data Fields with Predefined Class IDs

CheckBox
Computed
Date
DateTime
Digital Signature
File Attachment

Usage Tips for File Attachments
File Attachment Properties

Password
Radio Buttons
Select List
TextArea
TextField
URL
UserPicker Widget

Custom Data Fields with Your Own Class ID
Predefined Data Fields

Address
Name
Telephone

Deleting Data Fields
Setting Up the Content Store

The Content Store Inspector Window
Troubleshooting the Content Store

Chapter 8 Designing Forms

Planning Forms
Creating Forms
Modifying Forms

Using Process Builder's Form Editor
Using an External Editor
Using the HTML Page Editor Toolbar
Using the Edit, Insert and Format Menus

Edit
Insert HTML Element
Format

Using Right-Mouse-Button Menu Commands
Changing Field Properties for a Form
Hints for Setting Field Properties
Accessing the Data Dictionary
Using Scripts to Validate User Input

Adding a Banner to Forms
Setting Access to Forms

Forms for Assignees
Forms for Monitoring the Process
Forms for the Administrator
Setting Access to an Entry Point

Chapter 9 Using Scripts

Overview of Scripts

Kinds of Scripts
When to Use Scripts
About Writing Scripts

Predefined Scripts

Assignment Scripts
Completion Scripts
Verification Scripts

Predefined

Email Notification Scripts

defaultNotificationHeader()
defaultNotificationSubject()
emailById(userId)
emailOfAssignees()
emailOfCreator()
emailOfRole(role)

Initialization and Shutdown Scripts

Creating Scripts

The Script Editor Window
Setting a Script as a Template

Using Client-side Scripts

Chapter 10 Deploying an Application

Before You Deploy

Set up and Configure iPlanet Process Manager
Deploy Subprocesses First
Save the Process Map, If Desired
Fix Application Errors

Steps for Deploying an Application
The Deploy Application Dialog Box
Revising a Deployed Application

Summary of Allowed Revisions

Changes to Activities and Transitions
Changes to Data Elements
Changes to Forms, Scripts, and Content Store

Deployed Applications Compared with Local Copies
Using a Backup of a Local Application
Saving a Local Application to Another Name

Redeploying an Application
Deploying an Application to More Than One Cluster on the Same Machine
Deploying Applications with the Command Line Deploy Tool

Deploying an Application with the pmdeploy Command

A Typical Deployment Descriptor .dd File
Syntax for pmdeploy

Chapter 11 Advanced Techniques for Scripting

Introduction
Getting Information about the Current Process

Getting and Setting Data Field Values
Getting Data Field Values in Decision Point and Automation Script Transitions

Getting Information about Users and their Attributes

Finding Users and Accessing their Attributes
Modifying User Attributes
Adding and Deleting Users

Accessing the Content Store

Example of Accessing a Stored Item
Storing Files in the Content Store

Logging Error and Informational Messages
Verifying Form Input

Verifying Form Input with Client-Side JavaScript

Event Handler Example
onSubmitForm Example

Verifying Form Data in Completion Scripts

Initializing and Shutting Down Applications
Debugging Hints

Displaying the Progress of a Script
Testing Expiration Setter and Handler Scripts

Sample Scripts

Assignment Script
Expiration Setter Script
Expiration Handler Script
Completion Script
Automation Script

Chapter 12 Scripting with EJB Components

Calling EJB Components from JavaScript
A Sample Script
Handling Exceptions
Data Conversion Issues
Adding EJB References to a Process Manager Application
Adding iAS EJB References to a Process Manager Application

Adding iAS EJB References

Adding EJB References to an Application Using the Command Line Deploy Tool

Chapter 13 Setting Up Searching

Types of Searching

Global Searching
Application-Specific Searching

Enabling Searching

Allowing a Group to Search
Setting Up Forms
Allowing Searching for Fields

Chapter 14 The Data Sheet Application

Data Sheet Application Overview
Data Sheet Process Map
Data Sheet Walkthrough

The Data Sheet Entry Point

The Title Field

Add Art Activity

Assignment Script
Expiration Setter Script
The Forms

The Automated Activity
The Approve Pricing (Product Manager) Activity

Assignment Script
Forms
Notification

The VP Approval Decision Point
The Approve Price (VP) Activity

Assignment Script
Forms

Exit Points

Groups and Roles
Data Dictionary
Forms
Script Dictionary

The buildDS Script
The lookupCode Script
The buildDataSheet Script
The computeTitle Script

Content Store
Finished Data Sheet Example

The description.txt File
The image.gif File
The printer.html Template File
The Finished Data Sheet

Configuring the Data Sheet Application

Configuration Hints

How Users Access the Data Sheet
Process Express and iPlanet Application Server

Adding an Email Attribute for a User
Using File Attachments and Content Stores

Step 1: Administer the Web Server
Step 2: Edit the Access Control List
Step 3: Assign the Content Store's Style
Step 4: Optionally, Add a Directory to the Web Server
Step 5: Set the Values for the Application's Content Store

Chapter 15 The Office Setup Application

Office Setup Application Overview
Office Setup Process Map
Office Setup Walkthrough

Start Entry Point
Assign Office and Specify Computer Work Item
Basic Setup Split
Set Up Phone Work Item
Install Network Connection Work Item
Order Computer Work Item
Install Computer Work Item
Basic Setup Join
CheckSetup Work Item
Setup Complete Exit Point

The Office Setup Groups
Data Dictionary
Form Dictionary
Script Dictionary

Completion Scripts

setRequesterField
verifySetup

Toolkit Scripts

buildExitNotification

Embedded Client-Side Script

Customizing the Appearance of the Forms
Configuring the Office Setup Application
Advanced Office Setup Application

Chapter 16 The Loan Management and Credit History Applications

Loan Management Application Overview
Credit History Application Overview
Loan Management Process Map
Credit History Process Map
Loan Management and Credit History Walkthrough

New Loan Request Entry Point
Verification Work Item
Check Credit History Subprocess

Check Credit History Subprocess Properties
Data Mapping
Completion Script
The Subprocess Failed Exception Manager

Credit History Application as a Subprocess
Check Authorization Work Item
LookUp Credit History Automated Activity
Canceled Exit Point
OK Exit Point
Meeting Work Item (Parent Process)
Loan Refused Exit Point
Loan Approved Exit Point

Groups and Roles
Data Dictionary
Loan Management Script Dictionary

storeCreditInformation Completion Script
CustomerId Toolkit Script

Credit History Script Dictionary

LookUpCreditHistory Automation Script

Configuring the Loan Management Application
Configuring the Credit History Application

Chapter 17 The Insurance Claim Processing Application

Application Overview
Process Map

Entry Point
Activities
Custom Activities

Look Up Details
Update Log
Log Denial

Decision Point
Exit Points

Application Walkthrough

The Entry Point (Enter Policy No.)
Custom Activity (Look Up Details)
Activity (Policy Details)
Activity (Re-enter Policy No.)
Activity (Enter Claim Details)
Activity (Confirmation)
Activity (Approver)
Activity (Clarification)
Activity (Inform Customer)
Parallel Activities
Activity (Send Check)
Custom Activity (Update Log)

Groups and Roles

Group and Role Priorities

Data Dictionary
Forms

Entry.html
Resubmit.html
Details.html
EnterClaim.html
Confirmation.html
Approver.html
Clarify.html
InfCustomer.html
SendCheck.html
ClaimApproved.html
ClaimDenied.html
ExpirationExit.html

Script Dictionary

Expiration Scripts

Script at Policy Details Activity
Script at Enter Claim Details Activity
Script at Confirmation
Script at Resubmit Policy No.

Completion Scripts

Completion Script at Policy Details Activity
Completion Script at Enter Claim Details Activity

Required Files

The database.xml File
The Policy.log File
The Banner Image
The Background Image

Configuring the Insurance Claim Processing Application
Custom Activity Code

The LogPerformer Activity
The LogdenialPerformer Activity
The LookupPerformer Activity
Code Walkthrough for LookupPerformer.java

Definitions and Packages
The init, perform, and destroy Methods
The GetPolicy Method

Appendix A JavaScript API Reference

ProcessInstance

getCreationDate
getCreatorUser
getData
getEntityKey
getEntryNodeName
getExitNodeName
getInstanceId
getPriority
getRoleUser
getTitle
setData
setEntityKey
setRoleById

WorkItem

addUserAssignee
addGroupAssignee
assignees
extend
getCreationDate
getExpirationDate
getNodeName
hasExpired
isStateActive
isStateRunning
isStateSuspended
isUserAssignee
moveTo
removeAssignees
resume
setExpirationDate
suspend

ContentStore

copy
download
exists
getBaseURL
getBaseURL
getBaseURL
getContent
getException
getRootURL
getSize
getStatus
getVersion
initialize
isException
list
mkdir
move
remove
rmdir
store
upload

CorporateDirectory

addUser
deleteUserByCN
deleteUserByDN
deleteUserById
getUserByCN
getUserByDN
getUserById
modifyUserByCN
modifyUserByDN
modifyUserById

User

getUserId

Logging and Error Handling Global Functions

logErrorMsg
logHistoryMsg
logInfoMsg
logSecurityMsg

Assignment, Completion, and Email Scripts

checkParallelApproval
defaultNotificationHeader
defaultNotificationSubject
emailById
emailOfAssignees
emailOfCreator
emailOfRole
randomToGroup
toCreator
toGroup
toManagerOf
toManagerOfCreator
toManagerOfRole
toParallelApproval
toUserById
toUserFromField

Miscellaneous Global Functions

ejbLookup
evaluateTemplate
expireIn
getAction
getApplicationName
getApplicationPath
getApplicationPrettyName
getBaseForFileName
getConnector
getContentStore ()
getCreatorUserId
getCorporateDirectory
__getIncludePath
getJndiNamingContext
getProcessInstance
getSubProcessInstance
getWorkItem
__includeFile
mapTo
mount
setConnector
__setIncludePath
setRedirectionURL
url_OnDisplayHistory
url_OnDisplayProcessInstance

Miscellaneous Global Fu

url_OnDisplayWorklist
url_OnListApplications
url_OnListEntryNodes

Alphabetical Summary of JavaScript Methods and Functions

Appendix B Reserved Words

Glossary

Index