Академический Документы
Профессиональный Документы
Культура Документы
EMC Corporation
Corporate Headquarters:
Hopkinton, MA 01748-9103
1-508-435-1000
www.EMC.com
Copyright © 2009 EMC Corporation. All rights reserved.
Published September 2009
EMC believes the information in this publication is accurate as of its publication date. The information is subject to change
without notice.
THE INFORMATION IN THIS PUBLICATION IS PROVIDED AS IS. EMC CORPORATION MAKES NO REPRESENTATIONS
OR WARRANTIES OF ANY KIND WITH RESPECT TO THE INFORMATION IN THIS PUBLICATION, AND SPECIFICALLY
DISCLAIMS IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
Use, copying, and distribution of any EMC software described in this publication requires an applicable software license.
For the most up-to-date listing of EMC product names, see EMC Corporation Trademarks on EMC.com.
All other trademarks used herein are the property of their respective owners.
Table of Contents
Preface ................................................................................................................................ 13
Chapter 1 Installing the Sample Application ................................................................ 15
Preparing for deployment ................................................................................. 15
Required products and versions .................................................................... 15
Grant extended user privileges .......................................................................... 16
Apply the required hotfixes ............................................................................... 16
Deploy the DAR files ........................................................................................ 17
Set the BAM server port and host ...................................................................... 18
Deploy the grants.war file ................................................................................. 19
Restart the system............................................................................................. 19
Configuring the Grants Management sample application .................................... 19
Create email inboxes ..................................................................................... 20
Change email listener poller frequency .......................................................... 20
Create base folder ......................................................................................... 21
Configuring process parameters .................................................................... 21
Modifying HTTP Outbound activity URLs ..................................................... 23
Using Corticon with the xCP Grants Management sample application
(optional) ......................................................................................................... 24
Configuring the Invoke Corticon Rules activity .............................................. 24
Starting the Grants Management sample application .......................................... 25
Users and roles ................................................................................................ 25
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 3
Table of Contents
4 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Table of Contents
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 5
Table of Contents
6 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Table of Contents
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 7
Table of Contents
List of Figures
8 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Table of Contents
Figure 38. Grant Initiate Vote on Grant Request Process Form in TaskSpace ........................... 106
Figure 39. Grant Initiate Correspondence Process Form in Forms Builder ............................. 107
Figure 40. Grant Initiate Correspondence Process Form in TaskSpace .................................... 107
Figure 41. Grant Initiate Request Supporting Documents Process Form in Forms
Builder .......................................................................................................... 108
Figure 42. Grant Initiate Request Supporting Documents Process Form in TaskSpace ............ 109
Figure 43. Grant Request Search Form in Forms Builder ...................................................... 110
Figure 44. Grant Request Search Form in TaskSpace ............................................................ 110
Figure 45. Grant WQ Task List in Forms Builder .................................................................. 111
Figure 46. Grant WQ Task List in TaskSpace ........................................................................ 111
Figure 47. Configured options for the Grants_Administrator_Task_List tab............................ 117
Figure 48. Configured actions for the Grants_Administratorr_Task_List tab ........................... 117
Figure 49. Grants In Progress Dashboard in TaskSpace ......................................................... 126
Figure 50. Open Grants Report in PRS ................................................................................. 126
Figure 51. Grants Trends Dashboard in TaskSpace ................................................................ 133
Figure 52. New Grant Applications by State report in PRS .................................................... 133
Figure 53. Worker Performance Dashboard in TaskSpace ...................................................... 145
Figure 54. Average Review Duration report in PRS ............................................................... 146
Figure 55. Funding Dashboard in TaskSpace ........................................................................ 154
Figure 56. Overall Funding Amount Average report in PRS .................................................. 155
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 9
Table of Contents
List of Tables
10 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Table of Contents
Table 38. Grants Management sample application delivered tabs ......................................... 116
Table 39. Grants Management sample application configurable actions ................................ 118
Table 40. Grants Management sample application delivered types ....................................... 123
Table 41. Open Grants report configuration ........................................................................ 127
Table 42. Average Grant Duration (Hours) report configuration........................................... 130
Table 43. Grant Duration report configuration .................................................................... 131
Table 44. New Grant Applications Received report configuration ........................................ 134
Table 45. New Grant Applications by State report configuration .......................................... 136
Table 46. New Grant Applications by City report configuration ........................................... 138
Table 47. Average Grant Review (Days) report configuration ............................................... 140
Table 48. Approved Funding Total Last Month ($) report configuration ............................... 141
Table 49. Grant Applications by Purpose report configuration ............................................. 143
Table 50. Grants Manager Workload report configuration ................................................... 147
Table 51. Grant Applications by Purpose report configuration ............................................. 149
Table 52. Grants Reviewer Workload report configuration ................................................... 150
Table 53. Average Grant Management Duration report configuration ................................... 151
Table 54. Average Review Duration report configuration .................................................... 152
Table 55. Overall Funding Amount Average report configuration ........................................ 155
Table 56. Average Funding Amount per Manager report configuration ................................ 157
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 11
Table of Contents
12 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Preface
The Grants Management Sample Application Guide is provided to illustrate the use of the xCelerated
Composition Platform (xCP) to configure a case management application.
Intended Audience
This guide is intended to help EMC partners and customers use the EMC Documentum xCelerated
Composition Platform and EMC products to build repeatable business solutions. People who want
to evaluate the xCelerated Composition Platform and designers who want to modify it can use this
guide to acquaint themselves with the platform and the Grants Management sample application.
Note: The Grants Management sample application is provided to illustrate the use of the xCelerated
Composition Platform to configure a case management application. However, the Grants
Management sample application is not supported by EMC Technical Support, nor is it intended to be
deployed as a production application.
Related Documentation
Additional information can be found in the following sources:
• EMC Documentum Administrator User Guide
This manual provides the system administrator with information to install and use Documentum
Administrator.
• EMC Documentum Business Activity Monitor Implementation Guide
This guide provides business users insight into processes executing in the Documentum Process
Engine. It provides the ability to generate alerts in real time and creates a dashboard view that
shows process status and performance statistics.
• EMC Documentum Composer User Guide
This guide describes how to use Documentum Composer to develop enterprise applications and
deploy these applications on Documentum Content Server.
• EMC Documentum Content Server Administration Guide
This guide contains information, instructions, and procedures for the normal system
administration tasks of a Documentum installation.
• EMC Documentum Document Image Services Development Guide
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 13
Preface
This guide provides information on the Image Viewer Framework provided in the Document
Image Services product.
• EMC Documentum Forms Builder Development Guide
This guide explains how to create and deploy custom adaptors in forms.
• EMC Documentum Process Builder User Guide
This guide explains how to create business process templates and workflows.
• EMC Documentum TaskSpace Configuration Guide
This guide explains how to configure the TaskSpace product and its components, including
Forms Builder templates.
Revision History
The following changes have been made to this document.
14 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Chapter 1
Installing the Sample Application
To install all of the products that comprise the xCelerated Composition Platform and the Grants
Management sample application on a single Windows machine, see the EMC xCelerated Composition
Platform Developer Edition Installation Guide.
This chapter describes how to deploy and configure the Grants Management Sample Application
on an existing Documentum system.
It consists of these major sections:
• Preparing for deployment
• Deploying the GrantsManagement.dar
• Configuring the Grants Management sample application
• Starting the Grants Management sample application
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 15
Installing the Sample Application
• TaskSpace 6.5 SP2, which provides a configurable user interface for task processing and document
retrieval
• Business Activity Monitoring (BAM) 6.5 SP2, which provides the ability to show business process
status and generate performance statistic
• Documentum Composer 6.5 SP2, which enables you to install the DAR (Documentum archive)
files to your system.
2. Enter the text “Grants Management” (with quotation marks) to navigate to the product
listing for EMC Documentum xCelerated Composition Platform Grants Management Sample
Application.
3. Navigate to and download the Grants_Management_1.0_Hotfixes.zip.
16 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Installing the Sample Application
d. Run UpdateSDTFilters.bat.
8. Replace the following JAR files in <bam-server.war>\WEB-INF\lib or <bam-server.ear>\APP-
INF\lib for WebLogic 9.2:
• bam-engine.jar
• common.jar
• daos-dfc.jar
• reports.jar
• server-services.jar
9. Deploy the GrantsManagement.dar file.
The section Deploy the DAR files, page 17 provides more information on this topic.
10. Install the Grants Management sample application.
The section Deploy the grants.war file, page 19 provides more information on this topic.
11. Start the application server that hosts the BAM application.
2. Enter the text “Grants Management” (with quotation marks) to navigate to the product
listing for EMC Documentum xCelerated Composition Platform Grants Management Sample
Application.
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 17
Installing the Sample Application
18 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Installing the Sample Application
4. In the Connection page, change the BAM host and port from the default values to the location
where the BAM server is hosted.
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 19
Installing the Sample Application
20 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Installing the Sample Application
This location is already configured in the Receive Application via FTP activity template in the Create
Grant Request process template. If you need to change it to another path, you must also update the
path in the Receive Application via FTP activity template.
Configure the Status Check URL — The process templates Send Advanced Notification, Validate and
Classify Grant Request, and Send Notification include a process parameter that must be configured to
the location on your system where the grants.war file has been deployed. This process parameter
creates the URL that the Grant Applicant uses to check the status of their grant request.
Configuring the system email addresses — The Manage Grants Request and Validate and Classify
Grant Request process templates include a process parameter that points to the sending email address
for automatic notifications. You must go into Process Builder, uninstall each process, and change
the default email address for the process parameter SystemEmailAddress. In addition, the Request
Documents process uses a process parameter to set the email address to which the applicant sends
the required documents.
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 21
Installing the Sample Application
GrantStatusCheckURL http://localhost:9080/ This should point to host and port where the
grants grants.war is deployed:
http://<host>:<port>/grants
22 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Installing the Sample Application
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 23
Installing the Sample Application
24 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Installing the Sample Application
2. In the URL Path to the WSDL File box, type the fully qualified URL to the WSDL file that
contains the operation you want to run.
The Corticon WSDL, Corticon_rules_for_EMC_Grant_Mgmt.wsdl, invokes the Corticon
Decision Service and can be found on the Corticon ftp site.
3. Click Read WSDL File.
Process Builder reads the specified WSDL file and populates the remaining fields on the screen.
To launch the Grants Management sample application, enter this URL in a supported browser:
http://<host where taskspace.war is deployed>:<port>/taskspace/?appname=GrantsManagement
Role Username/Password
Grants Administrator admin1 / admin1
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 25
Installing the Sample Application
Role Username/Password
Grants Manager mgr1 / mgr1
mgr2 / mgr2
mgr3 / mgr3
Grants Reviewer reviewer1 / reviewer1
reviewer2 / reviewer2
reviewer3 / reviewer3
reviewer4 / reviewer4
reviewer5 / reviewer5
26 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Chapter 2
Understanding the Grants Management
Sample Application
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 27
Understanding the Grants Management Sample Application
The following is a high-level scenario for the Grants Management sample application:
1. A Grant Applicant fills out the Grant Application Request form and submits it online or through
email.
2. Grants Management application system receives the submission and does the following:
• Assigns the grant request a unique identification number.
• Sends an email to the Grant Applicant advising that the Grant Application Request form
was received.
After the Grant Applicant receives an email notifying the applicant that the Grant Application
Request form was received, the applicant can check its status using the link in the message.
• Calculates a due date for the request to be approved or denied.
• Adds the Grant Application Request to the queue of grant requests waiting to be processed.
• Performs automated request validation and classification based on preconfigured rules that
exist within the process or originate in a business rules management product.
28 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Understanding the Grants Management Sample Application
This includes automatic rejection of the request if it does not meet certain criteria and
automatic classification of low, medium, or high priority in the system.
3. A Grants Manager can do the following:
• View and work on assigned Grant Application Requests.
• Pull and acquire the next highest priority Grant Application Request from the queue of grant
requests waiting to be processed.
• Start a discussion for the case to be shared among all reviewers.
• Assign and send Grant Application Requests to Grants Reviewers to obtain their expert
feedback and reviews.
• Verify that all the necessary information is collected from the Grant Applicant. If information
is missing, request more information from the Grants Applicant using email.
• Collect all of the comments and votes from the Grants Reviewers and formally decide to
approve or deny the grant request.
• Monitor active requests using the Grants In Progress dashboard.
4. A Grants Reviewer is an expert in a specific area or field and can do the following:
• Review grant requests as assigned by the Grants Managers.
• Participate in discussions with other Grants Reviewers and the Grants Manager.
• Provide comments and feedback to the Grants Managers regarding the grant request.
• Vote to approve or deny the grant request.
5. When a Grants Manager approves or denies the grant request, the Grant Management sample
application system does the following:
• Sends an email notification to the Grant Applicant to advise of the approval or denial.
• Archives the grant request.
6. A Grants Administrator can do the following:
• View all grant requests that are rejected, pending, in review, approved, and denied.
• Assign or reassign grant requests to Grants Managers.
• View the Worker Performance, Funding, and Grant Trends dashboards.
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 29
Understanding the Grants Management Sample Application
After the applicant submits the grant application, the system sends a confirmation email with the new
grant ID. The applicant uses this ID to track the progress of the application.
The section Status check, page 37, provides more information on how the applicant can retrieve the
status of the request.
Case folder
The case folder is based on the custom folder type grant_request that is defined in TaskSpace. The
grant_request folder contains a list of attributes that are based on the fields associated with the grant
application and these attributes are used throughout the lifecycle of the grant request. Within the
Grant Request parent folder reside the following custom sub-folders:
• grant_submitted_app_folder, which contains the original grant application
• grant_review_history_folder, which contains information that pertains to the review process
• grant_correspondence_folder, which contains correspondence between the Grants Manager and
the Grant Applicant
In TaskSpace, the components Grants Root Folder Contents, Grants Review History Folder Contents,
Grant Correspondence Folder, and Grant Submitted Application Folder are based on the folder types.
For each folder type, there is a Forms Builder form that displays the contents of each folder.
30 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Understanding the Grants Management Sample Application
The Process Grant Request, page 65 manual activity is the central to all of the duties of the Grants
Manager. All actions that the manager takes to process the request are initiated through the Grant
Manager Task Form, page 99 that is associated with this activity.
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 31
Understanding the Grants Management Sample Application
TaskSpace allows application designers to create actions tailored for a specific application
(configurable actions). A configurable action can be assigned as an action button to a specific tab
(search, task list, folder, or open items folder), as a button on a form template, or as an item in a
context menu which is displayed for a specific object type.
Most of the buttons located on the Grants Manager’s task form are linked to a configurable action.
The section Configurable actions, page 117 provides more information on the delivered actions
available in the application.
32 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Understanding the Grants Management Sample Application
The section Grants Reviewer, page 41 provides more information on the grant review process and
the different tasks of the reviewers.
Performance dashboard
The Grants Administrator uses the Worker Performance dashboard and reports, page 144 to view
reports that calculate the number of grants being reviewed and managed by Grants Reviewers and
Grants Managers. The report also calculates the average time it takes for reviewers and managers to
complete their work.
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 33
Understanding the Grants Management Sample Application
Trends dashboard
The Grants Administrator uses the Grants Trends dashboard and reports, page 132 to view reports
that illustrate general trends as they relate to the number of applications received, total funding
approved, and purposes of grant requests.
Funding dashboard
The Funding dashboard and reports, page 154 provide Grants Administrators a gauge report that
shows the average overall funding amount and another report that shows the average funding
amount approved per manager.
Operational dashboard
The Grants In Progress dashboard and reports, page 125 provide detailed information about
individual grants, including a list of grant applications that are currently being processed and dial
gauge reports that calculate the time to process grants. Grants Managers can see only grants they are
managing.
34 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Chapter 3
Grants Management Sample
Application Roles and Functions
There are four user types for the Grants Management sample application:
• Grant Applicant
• Grants Manager
• Grants Reviewer
• Grants Administrator
The Grants Management sample application is pre-configured with roles for three of the user types.
The Grant Applicant, usually a person who does not belong to the organization, is the only user type
that is not configured as a role in the sample application.
Grant Applicant
The Grant Applicant accesses the Grant Application Portal, a lightweight web application, to access
the Grant Application Request form, complete the form, and submit it online. Grant Applicants can
also use the Grant Application Portal to check the status of their grant request. This portal is installed
automatically as part of the xCelerated Composition Platform or it can be deployed separately using
the grants.war file that is available on Subscribenet.
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 35
Grants Management Sample Application Roles and Functions
The Grant Applicant uses the Grant Application Request form to request grant funding. The Grant
Application Request form is an example of the xCelerated Composition Platform’s high-fidelity
form technology.
The Grant Application Request form is a high-fidelity form that comes with the sample application.
Required fields are red in color.
Note: The Funding Amount field restricts applicants to entering values less than $2,147,483,647. The
system replaces dollar values that exceed that limit with the number 2147483647.
Individual applicants may only apply for grants of $500,000 or less. If the individual applies for more
than the limit, the applicant receives an email notification stating that the application is ineligible due
to the excessive funding request. Organizations, however, are able to request up to the $2 billion limit.
The Grant Applicant can submit the form online or through email.
After preparing the Grant Application Request form, the Grant Applicant clicks the Submit the
form button above the Grant Application Request form to submit the form online using HTTP. The
system sends the form to a URL that has been configured and is monitored by Process Integrator, the
message integration component of xCelerated Composition Platform.
Alternatively, the Grant Applicant can save the Grant Application Request form to a local machine to
fill it out and submit it later using email or HTTP. The Grant Applicant must have OpenOffice.org
Writer, the word processor component of the OpenOffice.org software package, installed locally to
open the form, fill it out, or modify it. When the Grant Applicant completes the form, the applicant
36 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Grants Management Sample Application Roles and Functions
clicks one of the embedded buttons on the offline form to submit the Grant Application Request
using email or HTTP:
• Submit by Email: This opens a new email dialog (depending on the email client configured on the
user’s system) with the completed form inserted as an attachment. Before sending the email, the
Grant Applicant must change the To email address to newapps@<email_server_hostname> where
email_server_hostname is the same address as the one configured in the Receive Application Via
Email activity in the Create Grant Request process.
• Submit Online: This submits the form using HTTP. Before submitting the form online, the Grants
Applicant must change the HTTP submission URL to http:/host:port/bps/http/ReceiveGrantsApp,
where host is the hostname where Process Integrator is installed and port is where the application
server is listening.
Note: These buttons use custom macros. You may need to adjust your macro security settings in
OpenOffice.org before you can use the Submit by Email and Submit Online buttons.
Status check
The Grant Applicant can also check the processing status of the grant. After submitting the
application, the applicant receives an email indicating the Grant ID. The Grant Application Portal
uses this ID to check the status of the grant request. To check the status, the applicant clicks the Check
Status button and enters the grant ID in the Enter Grant ID dialog box. The system returns the grant
ID along with the date of the grant’s submission and the current status of the request.
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 37
Grants Management Sample Application Roles and Functions
Grants Manager
The Grants Manager has the main role in the Grants Management sample application. The
information and functions available to the Grants Manager depends on the application configuration
for that specific role. Every role in the application accesses different information and functions that
are configured for that role.
When the Grants Manager logs into the Grants Management sample application, which is a
Documentum TaskSpace application, the Grants Managers sees the following tabs:
• My Grants: Provides access to a task list of grant requests to work.
• My Folder: Provides access to working documents.
• Grants In Progress: Provides detailed information about individual grant applications that have
been submitted.
• Open Items: Provides access to the Grants Manager’s working area.
On the My Grants tab, the Grants Manager can work on the grant requests that are in the task list
and click the Get Next Task to obtain the next request with the highest priority from the queue of
grant requests waiting to be processed.
The Grants Manager right-clicks the Grant ID and selects View to open the grant request in the Open
Items tab. The Grant Request Information page enables the Grants Manager to perform all the
functions involved in managing the grant request.
The Grant Request Information page displays data from the grant application in three tabs: Request
Information, Applicant Information, and Assessments. This page also displays the Submitted
38 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Grants Management Sample Application Roles and Functions
Application folder, Review History folder, and the Correspondence folder. The grant request can be
closed on the Open Items tab and reopened at any time from the My Grants task list.
The following options are available when the Grants Manager opens a grant request:
• Review the grant request and verify that all the necessary information is collected from the Grant
Applicant.
If information or documents are missing, the Grants Manager can click Request Documents to
send an email to the Grant Applicant to request the information or documents. These messages
and any related attachments are contained in the Correspondence folder.
Note: When the Grants Manager requests additional information, the Grant Applicant must
submit the information as an attachment. The information cannot be embedded in the body of
the email.
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 39
Grants Management Sample Application Roles and Functions
• Select an Applicant Rating and a Risk factor on the Assessments tab, and then enter information
about the risk details. The initial risk rating is assigned automatically by the system during the
grant request creation process. When done, click Save.
• Click Show Discussion to view or add comments about the grant request. The discussion thread
is viewable to the Grants Manager, Grants Reviewers, and Grants Administrator.
• Click Send to Reviewers to select Grants Reviewers, create review instructions, and send the
grant request out for review.
• Collect all the comments and votes from the Grants Reviewers and formally decide to approve
or deny the grant request.
Note: The Approve button is disabled until the required documents are received and the
following checkboxes are selected:
Application Form
Identification Documents
Liability Checklist
40 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Grants Management Sample Application Roles and Functions
• Double-click the Review History folder to view the status of the reviews along with comments
and recommendations from the reviewers.
• Add information in the Grant Request Remarks box. The remarks go with the grant request when
it is archived. The remarks also appear in the final email sent to the Grant Applicant when the
grant request is approved or denied.
The Grants Manager also has access to the Grants In Progress dashboard, which provides detailed
information about individual grant applications that have been submitted. Grants Managers are not
able to see grants that they are not managing. Grants In Progress dashboard and reports, page 125
provides detailed information about the Grants In Progress dashboard and the set of reports that
provide detailed information about individual grants.
Grants Reviewer
A Grants Reviewer is an expert in a specific area or field. A Grants Reviewer can see the following
tabs after logging into the Grants Management sample application:
• My Grants: Provides access to a task list of grants requests assigned to them by Grants Managers.
• My Folder: Provides access to working documents.
• Open Items: Provides access to the reviewer’s working area.
From their task list, the Grants Reviewers select grant requests assigned to them by Grants Managers.
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 41
Grants Management Sample Application Roles and Functions
When a Grants Reviewer selects a grant request to review, the system displays information about the
grant request, including the following:
• Instructions from the Grants Manager.
• Assessments made by the Grants Manager.
• Discussions, if any, from the Grants Managers, other Grants Reviewers, and the Grants
Administrator.
The Grants Reviewer cannot change any information about the grant request. Grants Reviewers
can perform the following functions:
• Provide comments and feedback to the Grants Managers regarding the grant request by selecting
a Remarks Type and then entering comments.
The Reviewer Remarks will be archived with the grant request, but they will not be seen by the
Grant Applicant. Remarks are required from the Grants Reviewer.
• Click Show Discussion to view or add comments about the grant request. Grants Managers,
Grants Reviewers, and Grants Administrators can all view the discussion threads.
• View email threads with their attachments that are contained in the Correspondence folder.
The Grants Reviewer can also participate in discussions on items in the Correspondence folder,
if discussions are enabled.
• Vote to approve or deny the grant request.
• View other Grants Reviewer votes and remarks.
42 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Grants Management Sample Application Roles and Functions
Grants Administrator
The Grants Administrator manages the grant request queue and balances the workload by assigning
and reassigning tasks to Grants Managers. The Grants Administrator can search for and look at all
grant requests in the Grants Management sample application, including grant requests that are
rejected, pending information, in review, approved, and denied.
The following tabs are available when the Grants Administrator logs into the Grants Management
sample application:
• Search: A list of grant requests that displays information about the request, including its status
• Tasks: The Grants Administrator’s default inbox.
• Queue Management: A work queue monitor that enables the Grants Administrator to manage
and monitor the open and active grant requests in the queue.
• Administration: Includes the following administrative tools for the Grants Administrator to
manage the Grants Management sample application:
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 43
Grants Management Sample Application Roles and Functions
The Grants Administrator right-clicks the grant ID and selects Open to open a grant request on
the Open Items tab.
44 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Grants Management Sample Application Roles and Functions
The Grants Administrator can perform the following functions after opening a grant request:
• Review the grant request.
• Select an Applicant Rating and Risk factor on the Assessments tab, and then enter information
about the risk details. When done, click Save.
• Click Show Discussion to view or add comments about the grant request. The discussion thread
is viewable to the Grants Manager, Grants Reviewers, and Grants Administrator.
• Review the history of the grant request by double-clicking the Review History folder.
From the Queue Management tab, Grants Administrators can manage the grant request queue
(grants_wq in our Grants Management sample application) and balance the workload by assigning or
reassigning grant review tasks to Grants Managers.
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 45
Grants Management Sample Application Roles and Functions
The Grants Administrator can click My Categories to configure which categories appear in the
drop-down box of the monitor screen. Only categories managed by the Grants Administrator are
available for selection.
The Grants Administrator can click View Members to view the members assigned to a queue and
click View Workload to unassign, reassign, or suspend grant requests.
The Grants Administrator also has access to several dashboards: Grants Trends, Worker Performance,
and Funding dashboards. The Grants Trends dashboard and reports, page 132 contain reports that
illustrate general trends about grant requests. The Worker Performance dashboard and reports,
page 144 show information on the performance and productivity of Grants Reviewers and Grants
46 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Grants Management Sample Application Roles and Functions
Managers. The Funding dashboard and reports, page 154 show information on general funding
requests and the funding amounts approved by each Grants Manager.
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 47
Grants Management Sample Application Roles and Functions
48 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Chapter 4
Implementing the Business Logic
Process templates define the business processes executed by the Process Engine component of the
xCelerated Composition Platform.
To view and modify process templates, log in to Process Builder with your username and password.
The Documentum Process Builder User Guide provides details on how to create and modify process
templates.
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 49
Implementing the Business Logic
The Create Grant Request process template enables the Grants Management sample application
to receive the high-fidelity Grants Application Request form through FTP, HTTP, SMTP, or a web
service. It then creates the folder structure for the new grant request, assigns it a unique grant ID,
extracts data from the form, and associates it to the grant request. Finally, the process calls the
Validate and Classify Grant Request process.
50 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Implementing the Business Logic
Target Namespace URI — When an inbound web service activity is included in the process, you
must enter the target namespace URI for the WSDL location on the Advanced tab of the Process
Properties page. The value for the Target Namespace URI is http://www.emc.com/GrantsApp.
This FTP Inbound – Initiate activity receives the .odt file that contains the application from the local
file system and finds it in C:\applicantfolder\application, which is the base FTP folder on the
inbound application server machine. (This is the machine that is running Process Integrator.)
The Receive Application via FTP activity takes the application data from the GrantsApplicationForm
and maps it to the GrantsApplicationPackage enabling it to persist throughout the lifecycle of the
grant request.
This Email Inbound – Initiate activity retrieves the grant application from the Inbox and maps
the data from the email attachment to the GrantsApplicationPackage enabling the data to persist
throughout the lifecycle of the grant request.
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 51
Implementing the Business Logic
The Receive Application via HTTP activity maps the data from the form data from the attachment
to the GrantsApplicationPackage enabling the data to persist throughout the lifecycle of the grant
request. The mapping for content type is set to .odt since this activity only receives that content format.
Join
This Join activity is triggered whenever one of the three of the activities that receive an .odt version
of the grant application is received.
This Web Service Inbound activity receives the XML version of the grant request through a web
service.
This activity uses the Process First option, where you define the port and operation and the system
creates a WSDL from the process definition. The system creates one WSDL for a process, with a
section for each Web Service Inbound activity contained within it. The system gets the port type
and operation name from the WSDL.
Note: Before adding a Web Service Inbound activity to a process, configure the target namespace URI
on the Advanced tab of the Process Properties dialog box. The system cannot validate or save the
process without the target namespace.
This Process Data Mapping activity maps the application data from the GrantsApplication SDT
to the GrantsApplicationForm, which is part of the GrantsApplicationPackage package. The
GrantsApplicationPackage is the package that is used by the system throughout the rest of the
grant request lifecycle.
52 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Implementing the Business Logic
Generate Unique ID
The Generate Unique ID activity template is a BOF activity template that creates a unique ID for each
request that is submitted through the Create Grant Request process template. The activity is triggered
whenever one of the two flows receives a grant application. It executes the CreateUniqueId method
from the BOF module, which generates the grant ID based on the current time in milliseconds. The
grant ID is used throughout the lifecycle of the grant request.
You can configure the BOF activity template to invoke any custom module that generates a unique
ID for the grant request or employ a web service to generate the number. This can be done using
the Dynamic Web Services activity template. When using either activity template to create the ID,
ensure that the generated identifier is mapped to the process variable generatedUniqueId in the
data mapper.
The Documentum Process Builder User Guide provides more details on using the BOF Module activity
template.
Note: Due to a size limitation in the grant_request_id field, the generated ID should not exceed
16 characters or the process will fail.
/*
** Confidential Property of Documentum, Inc.
** (c) Copyright Documentum, Inc. 1991-2007
** All Rights reserved.
** May not be used without prior written agreement
** signed by a Documentum corporate officer.
*/
import com.documentum.fc.client.IDfModule;
Interface —
package com.documentum.bps.outbound.bof.bofmodule;
/*
** Confidential Property of Documentum, Inc.
** (c) Copyright Documentum, Inc. 1991-2007
** All Rights reserved.
** May not be used without prior written agreement
** signed by a Documentum corporate officer.
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 53
Implementing the Business Logic
The New Case from Template activity creates a folder structure for the new grant request based upon
the template found in the specified location: /Grants Management/Config/Grant Request Template. It
also propagates the ACL assigned to the folder to all child objects.
In the Create Grant Request activity, the unique ID generated in the Generate Unique ID activity
template is mapped from the generatedUniqueId variable to the grant_request_id and the
object_name attributes of the Grant Request Template. Additionally, the data from the application
is mapped to the /Grant Requests/New folder in the repository and the Grants Request ACL is
assigned to the folder structure and propagated to all the child objects contained in the grant request.
Then, all data is mapped to the GrantRequestPackage where it can be used throughout the lifecycle
of the grant request.
This Link to Folder activity executes the BPM Link To Folder method and moves the
GrantsApplicationPackage to the Submitted Application folder that is located based on the folder
path: GrantRequestPackage.r_folder_path[FIRST].
This Process Data Mapping activity applies the Grants ReadOnly ACL to the
GrantsApplicationPackage. The Grants ReadOnly ACL ensures that the grant application is read-only
to the Grants Managers and the Grants Reviewers. Only Grants Administrators have permission to
edit the application and then save the edited version.
Note: Changes made to the application after it has been submitted will not be reflected in the process
data. Any editing of the application by the Grants Administrator will cause the process data and the
grant application to become out of sync.
This Process Data Mapping activity maps the r_creation_date from the GrantsApplicationPackage
package to the grant_received_date of the GrantRequestPackage. It also maps all data from the
GrantsApplicationForm that is contained within the GrantsApplicationPackage and maps it to the
attributes of the GrantRequestPackage package.
This Invoke Process activity starts the Grant Request Status Monitoring Process. It also maps the
object ID of GrantsRequestPackage package to the object ID of the GrantsRequest package and the
54 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Implementing the Business Logic
grant_request_id to the GrantRequestNumber process variable. This maps the data from the parent
process to the child process.
The workflow ID of the process also is added to the gt_monitoring_instance_id of the
GrantRequestPackage package.
This Invoke Process activity starts the Validate and Classify Grant Request process.
The Validate and Classify Grant Request process template begins by setting the date that the grant
request is received. The next activity is a transition that takes one path if the Corticon Business Rules
server is configured for handling decision logic, and another path that implements rudimentary rule
logic contained in process activities.
In both paths, the system checks that the required fields have meaningful data and rejects requests
that are invalid or ineligible.
For valid requests, the process then classifies the status of the request. If the Corticon business rules
server is configured, the process receives values for the grant’s priority, rating, and risk assessments
based on the Corticon business rules. Otherwise, the system performs a simple assessment based
solely on the funding amount.
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 55
Implementing the Business Logic
The process also enables discussions on the request folder, sends a notification to the applicant
informing them that the grant request was received, and moves the request to the In Review folder.
Process variable CorticonRemarks A string value that holds remarks received from
the Corticon server.
Process parameter SystemEmailAddress The value grantnotification@localhost is the email
address that you set up for grantnotification.
Process parameter CheckStatusURL http://localhost:9080/grants. This should point to
host and port where the grants.war is deployed:
Process parameter GrantsProcessACL This ACL is not used in this process at this time.
Process parameter IsCorticonServerA- This Boolean value indicates the existence of a
vailable Corticon business rules server.
56 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Implementing the Business Logic
The Invoke Corticon Rules activity template must be configured to interact with the Corticon Rules
server.
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 57
Implementing the Business Logic
The Port Type list box is empty until you click Read WSDL File.
4. Click Next to view the Input Message Mappings in the data mapper.
5. Click Next to view the Output Message Mappings in the data mapper.
58 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Implementing the Business Logic
The Corticon rule set uses data that characterizes grant applications (amount, purpose, applicant
type, state, and EIN/Taxpayer ID) in evaluating the status, priority, rating, and risk of the applicant
and application.
The set of rules includes general rules that apply to the application based on criteria such as amount
or applicant type. For example, Rule 5 states that applications for amounts less than $50,000 are
considered low priority with a basic rating, and medium risk.
There are also exception rules that override the general rules. For example, Rule 3 overrides Rule 5
for individuals applying for Science and Technology grants in states that are considered to be leaders
in the high-tech industry. These applications receive enhanced overall grant application status
with medium priority, a gold rating, and low risk.
Rating = Basic
Risk = Medium
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 59
Implementing the Business Logic
Risk = High
7 $250,001 to Individual N/A Priority = High
$500,000
Rating = Gold
Risk = High
8 $50,001 to Organization Purpose = Agriculture Priority = High
$250,000
State = CA, NE, AR, OK, Rating = Platinum
or KS
Risk = Low
9 $50,001 to Organization N/A Priority = Medium
$250,000
Rating = Basic
Risk = Medium
10 Greater than Organization N/A Priority = High
$250,000
Rating = Basic
Risk = High
11 Greater than Organization Purpose = Science and Priority = Medium
$250,000 Technology
Rating = Gold
State = CA, MA, TX, NY,
or NC Risk = High
Note: Rule 3 overrides Rule 5; Rule 4 overrides Rule 6; Rule 8 overrides Rule 9; and Rule 11 overrides
Rule 10.
60 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Implementing the Business Logic
Rule1
This Process Data Mapping activity uses a copy function to add the value Low to the grant_priority
and the grant_risk attributes.
Rule2
This Process Data Mapping activity uses a copy function to add the value Medium to the
grant_priority and the grant_risk attributes.
Rule3
This Process Data Mapping activity uses a copy function to add the value High to the grant_priority
and the grant_risk attributes.
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 61
Implementing the Business Logic
62 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Implementing the Business Logic
The Manage Grants Request process template retrieves the new grant request and maps request
package data to process variables to display the process data in the Grant Manager Task List. This
process enables the Grants Manager to perform the duties involved in managing the grant requests.
The following forms open and use adaptors to invoke a new process when the Grants Manager
clicks a button from the grant request:
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 63
Implementing the Business Logic
Send to Reviewer Grant Initiate Vote on Grant Request Process Start Review Process
Form (UserGroupInCaseReviewerSelector
adaptor)
Notify Applicant Grant Initiate Correspondence Process Send Notification
(FormSendNotificationDataSourceAdaptor
adaptor)
Request Grant Initiate Request Supporting Request Documents
Documents Documents Process Form (FormSendNotifi-
cationDataSourceAdaptor adaptor)
When the Grants Manager approves or denies the request, it sets the appropriate status, notifies the
applicant of the decision, and archives the request.
64 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Implementing the Business Logic
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 65
Implementing the Business Logic
66 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Implementing the Business Logic
Send Notification
The Send Notification process template enables the Grants Manager to send ad hoc email messages to
the Grant Applicant. This process is invoked by other processes as a utility.
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 67
Implementing the Business Logic
Finalize
This is an automatic activity that uses the dm_noop_auto_method_java method. It is the final activity
of the process and joins the flows together.
68 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Implementing the Business Logic
The Send Advanced Notification process sends automatic notifications to the applicant based on the
grant request. This process notifies the applicant that the application has been received, when the
application is rejected, and when the application is approved or denied.
Send Notification
This Split activity routes the workitem to different activities based on the grant request status.
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 69
Implementing the Business Logic
This SMTP activity generates an email to inform the applicant that the application has been received
and includes a link that the applicant can use to check the status of the grant request. This activity
uses placeholder values in the subject and the body of the email that is replaced at runtime with
values that are specific to the individual request, such as the grant ID and the link to check the status
of the request. These values come from the GrantRequest package data.
This SMTP activity generates an email to inform the applicant that the application has been rejected
because of incomplete information. This activity uses placeholder values in the subject and the body
of the email that is replaced at runtime with values that are specific to the individual request, such as
the grant ID and the applicant name. These values come from the GrantRequest package data.
This SMTP activity generates an email to inform the applicant that the application has been denied.
This activity uses placeholder values in the subject and the body of the email that is replaced at
runtime with values that are specific to the individual request, such as the grant ID and the applicant
name. It also includes placeholder values for the remarks that are gathered during the review process.
These values come from the GrantRequest package data.
This SMTP activity generates an email to inform the applicant that the funding amount exceeds the
funding limit of $500,000 for an individual applicant. Individual applicants who request more than
$500,000 are not eligible for funding.
This SMTP activity generates an email to inform the applicant that the application has been approved.
This activity uses placeholder values in the subject and the body of the email that is replaced at
runtime with values that are specific to the individual request, such as the grant ID number and the
70 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Implementing the Business Logic
applicant name. It also includes placeholder values for the remarks that are gathered during the
review process. These values come from the GrantRequest package data.
Finalize
This is an automatic activity that uses the dm_noop_auto_method_java method. It is the final activity
of the process and joins the flows together.
Request Documents
The Grants Manager uses the Request Documents process template to send an email to the applicant
requesting more documents. The process waits for an email response, and notifies the Grants
Manager if a response is not received in 24 hours. When the requested documents are received, they
are placed in the grant request folder.
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 71
Implementing the Business Logic
This SMTP activity maps process data to the email message. It also maps the message identifier to the
GrantRequestCorrelation process variable. This mapping is used to achieve correlation in the Wait
for Additional Documents activity.
This Process Data Mapping activity maps the body of the grant_email_request process variable to the
content of the attachment, the subject to the subject of the attachment, and the creation date of the
request to the object_name.
This New Case from Template activity is based on the Correspondence template. It maps the date
that the correspondence was sent or received to the folder name and the grant ID to the path to
the Correspondence folder.
This Link to Folder activity executes the BPM Link To Folder method and moves the
correspondence to folder that is located based on the folder path: /Grant Requests/In
Review/<dmp:param>ReceiveData.GrantRequestId</dmp:param>/Correspondence]
Set Request Id
This Process Data Mapping activity maps the incoming grant_request_id from the package to the
GrantRequestId of the ReceiveData SDT. It also sets the ReceivedResponse to true.
This activity polls the email server for an email message corresponding to the current workflow
instance. The system matches the value of the email references header with the value of the
GrantRequestCorrelation process variable.
72 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Implementing the Business Logic
This activity has a timer that waits 24 hours for the corresponding (matching) message to arrive. If the
matching message is not received within the time frame the system sends a notification to the Grants
Manager and completes the task. If the email message is received, it maps the email attachments to
the process data attachments.
Join
This is an automatic activity that uses the dm_noop_auto_method_java method. It is the final activity
of the process and joins the flows together.
When the Grants Manager clicks the Send for Review button, the Start Review Process template
initializes the process variables and retrieves the list of reviewers for the grant request using the
UserGroupInCaseReviewerSelector adaptor from the form.
The system expands the list of reviewers into individual users and invokes the Grant Initiate Vote on
Request process for each user.
The system checks the list of reviewers and determines if the reviewer is a group or an individual
user. If the reviewer is actually a group, the system expands the group into a list of individual users
and starts the Vote On Grant Request process for each user. If the reviewer is not a group, the system
starts the Vote on Grant Request process for that single user.
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 73
Implementing the Business Logic
do
{
isGroup = is Reviewers[countIndex] a group ? (DQL Query)
do
{
Invoke "Vote On Grant Request" process for AllReviewers[ExpandedCountIndex]
ExpandedCountIndex = ExpandedCountIndex + 1
countIndex = countIndex + 1
74 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Implementing the Business Logic
Note: The system uses TotalCount and CountIndex when it loops through the list of users
and groups that the Grants Manager selects are reviewers. It uses TotalExpandedCount and
ExpandedCountIndex when it loops through the expanded list of user from a group.
Is Group
This activity runs a DQL query to evaluate if the selected reviewer is a group or an individual user
and stores that information in the process variable IsGroup.
Expand Group
If the reviewer is a group, this DQL Read activity gets the individual usernames from the group and
adds those names to the list of grant reviewer names.
Copy User
This Process Data Mapping activity finds individual user names (that are not part of a group) adds
this username to the list of reviewers.
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 75
Implementing the Business Logic
More Reviewers
This Process Data Mapping activity checks for more users in the list of reviewers that is comprised of
a single user name or the expanded list of user names from a group.
Finalize
This is an automatic activity that uses the dm_noop_auto_method_java method. It is the final activity
of the process and joins the flows together.
The Vote on Grant Request process template creates the review data object and links it to the Review
History folder after the Grants Reviewer votes. It then maps the request package data to process
variables to display in Task List.
After the reviewer votes, the remarks are captured and added to the Review History folder.
The Grants SDT ACL enables the reviewers to have write permission on the SDT GrantReviewDetails..
After the reviewer votes, the remarks are captured and added to the Review History folder.
76 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Implementing the Business Logic
Process variable Review EntryId This is the object ID of the review object.
Process variable GrantRequestForT- Holds the grant request attributes that appear in
(SDT) askList the TaskList. These include the attributes for grant
ID, applicant name, funding purpose, funding
amount, received date, due date, priority, and
status.
Process variable GrantReviewDetails Holds the attributes that are used during the
(SDT) review process. These include attributes for: grant
ID, grant owner, reviewer name, remarks, and
reviewer decision.
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 77
Implementing the Business Logic
Reviewer Votes
This is a manual activity that uses the Grant Reviewer Task Form to capture reviewer comments.
The performer of the task is based on process data. When creating the activity, the performer of the
review is selected based on the value of the Performer process variable.
Vote Yes/Vote No
This DQL Write activity updates the ReviewEntryID process variable and the SDT attributes,
remarks_category and reviewer_category with the reviewer’s decision.
Finalize
This is an automatic activity that uses the dm_noop_auto_method_java method. It is the final activity
of the process and joins the flows together.
When the Grant Applicant uses the Grant Application Portal to check the status of the request, the
Check Grant Request Status process template retrieves the grant status. It then takes the grant ID
from the incoming request, finds the current status, and sends a response back to the Grant Applicant.
78 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Implementing the Business Logic
The Grant Request Status Monitoring process template is invoked by the Create Grant Request
process and is used to monitor the progression of the request. As different processes in the Grants
Management sample application work on the request, they notify this process of the most current
state of the request.
This process enables the reports to show the progress of each open grant application. Since there are
many individual processes that contain only partial information about the progress of the application,
it was necessary to create on process that reported on the entire lifecycle of the grant request.
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 79
Implementing the Business Logic
Process.PE Applicant
Amount Requested
Process Instance ID Description
Funding Purpose
Start Date and Time Grant ID
The system displays this information in the Grants In Progress dashboard for the Grants Manager.
The process tracks the following statuses: pending info, in review, approved, and denied.
80 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Implementing the Business Logic
Submitted
Submitted a start activity that is triggered by an invoke process activity belonging to the Create Grant
Request process. This is an automatic activity that uses the dm_noop_auto_method_java method.
Pending Info
This is an HTTP Inbound activity that maps the RequestId from the incoming request to the
GrantRequestNumber process variable to achieve message correlation.
In Review
This is an HTTP Inbound activity that maps the RequestId from the incoming request to the
GrantRequestNumber process variable to achieve message correlation.
Approved/Denied
This is an HTTP Inbound activity that maps the RequestId from the incoming request to the
GrantRequestNumber process variable to achieve message correlation.
Archived
This is an HTTP Inbound activity that maps the RequestId from the incoming request to the
GrantRequestNumber process variable to achieve message correlation.
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 81
Implementing the Business Logic
82 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Chapter 5
Implementing the Presentation Layer
This section lists the components that control the user interface for the Grants Management sample
application. These components are pre-configured and installed on your system when you install
the xCelerated Composition Platform or when you deploy the GrantsManagement.dar and the
grants.war files.
queue_manager
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 83
Implementing the Presentation Layer
queue_processor mgr2/mgr2
mgr3/mgr3
grants_reviewer form_user reviewer1/reviewer1
reviewer2/reviewer2
reviewer3/reviewer3
reviewer4/reviewer4
reviewer5/reviewer5
Role permissions
The following user role permissions are pre-configured and installed with the Grants Management
sample application:
Permissions
The following Access Control Lists (ACLs) are pre-configured and installed with the Grants
Management sample application. These ACLs are used in all of the processes, forms, folders, and
data within the Grants Management sample application.
Reviewer – Relate
84 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Implementing the Presentation Layer
Reviewer – Write
Folders (grant_request) Grants Request ACL Administrator – Delete
Reviewer – Version
Delivered Folder Structure
The Grants Management sample application is installed with the following folder structure for
the Grants Management sample application:
Folder Purpose
Grants Root Folder The main folder for the grant request. It contains all of the
required supporting documentation along with the Grants
Review History Folder and the Grants Submitted Application
folder.
Grants Submitted Application A sub-folder that contains an instance of the submitted
Folder high-fidelity Grant Application form.
Grants Review History Folder A sub-folder that displays the status of the reviews along with
comments and recommendations from the reviewers.
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 85
Implementing the Presentation Layer
86 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Implementing the Presentation Layer
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 87
Implementing the Presentation Layer
Submit buttons
To use the button that is embedded in the high-fidelity form, the Grant Applicant must have
OpenOffice.org Writer installed on their local machine. When the Grant Applicant is done, they click
submit button on the offline form to submit the Grant Application Request using email or HTTP.
Since the Grant Applicant can also submit the application online, the form was designed to include
another button to submit the application online using HTTP. The Applicant clicks the Submit the
form button above the Grant Application Request form to submit the form online using HTTP. The
system sends the form to a URL that has been configured and is monitored by Process Integrator, the
message integration component of the xCelerated Composition Platform.
You can add, modify, or pre-populate the fields of the Grant Application Request form and use the
customized form instead of the application form that is delivered with the application.
Editing the fields of the ODT form — To add or remove fields from the high fidelity form, use
Documentum Forms Builder. Open the Grant Application Request form in Forms Builder, modify
the form, and save, validate, and install the new form in the repository. After the form is installed,
copy it to the path specified in the following procedure to add a modified form. The Documentum
Forms Builder User Guide provides more information on editing high fidelity forms in the section
entitled “Editing high fidelity form templates.”
Note: Use care when editing fields. Deleting fields that are used in the processes can break existing
functionality in the application. Similarly, when adding a new field you must modify the process
data, forms, and processes to make use of the newly added field.
Pre-populating the values in the ODT form — To populate values in the fields of the application
form, use either Documentum Forms Builder or the OpenOffice.org client and type in the values
you want to pre-populate.
88 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Implementing the Presentation Layer
7. Ensure that the system is using the modified form by accessing the Grant Application Portal at
http://hostname:port/grants/apply and viewing the application form.
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 89
Implementing the Presentation Layer
90 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Implementing the Presentation Layer
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 91
Implementing the Presentation Layer
This folder establishes the folder path where the submitted applications are placed within the Grants
Root Folder. The document list is designed to show only the object name and modify date, with the
content type, object type, and object ID included as hidden fields.
92 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Implementing the Presentation Layer
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 93
Implementing the Presentation Layer
The folder content form is associated with the Review History folder and displays the status of the
reviews along with comments and recommendations from the reviewers. The document list is
designed to show the modify date along with the reviewer name, action, category, and remarks.
94 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Implementing the Presentation Layer
Figure 25. Grant Review History Folder Content Form in Forms Builder
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 95
Implementing the Presentation Layer
The folder content form is associated with the Correspondence folder and contains incoming and
outgoing correspondence with attachments. When the Grants Manager initiates correspondence by
selecting the Request Documents button, the system creates a folder that contains the outgoing
message and any response messages including their attachments. The folder name uses the date and
time at which the Request Documents process began.
Reviewers have read-only access to items in the Correspondence folder and cannot participate in
discussions related to items in the Correspondence folder. Administrators have read-only access to
the items in the Correspondence folder but are able to participate in discussions related to items in
the folder.
96 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Implementing the Presentation Layer
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 97
Implementing the Presentation Layer
The search criteria on the form include the grant ID, the name of the applicant, the requested grant
amount, date ranges for both received data and due date, and priority.
When creating a task list page, ensure that you have a finalized design before laying out the page.
Any changes to fields will rearrange the page and override custom labels and custom layout.
98 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Implementing the Presentation Layer
Adaptors used in the Grant Manager Task Form — There are two custom adaptors used in the
Grant Manager Task Form.
• The system uses the FormSendNotificationDataSourceAdaptor to populate some of the fields in
the email correspondence between the Grants Manager and the applicant. The adaptor retrieves
the email address and name of the applicant from the grant_request package. It also supplies the
grant request number for the subject of the email notifications and queries for the Grant Manger’s
email address and populates the sender email information.
• The CopyDataToObjectAttribute adaptor initializes when the form opens. The adaptor serves
two purposes. It displays the performer name as the owner of the grant request and it makes this
information available to BAM for inclusion in many of the dashboard reports.
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 99
Implementing the Presentation Layer
Required Documents Received group box — All three of the required documents must be selected
to enable the Approve button. The data binding is defined in the properties of each field.
Grant Request Folder View — The folder view control adds a box inside the task template at
runtime that displays the Grant Request Folder information. The folder view is bound to the
DocumentId of the GrantRequest package.
100 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Implementing the Presentation Layer
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 101
Implementing the Presentation Layer
102 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Implementing the Presentation Layer
When creating a task list page, ensure that you have a finalized design before laying out the page.
Any changes to fields will rearrange the page and override custom labels and custom layout.
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 103
Implementing the Presentation Layer
The reviewer is required to select a remark type and enter remarks regarding their review. This
information is mapped to the remarks_category and the reviewer_remarks attributes of the
GrantReviewDetails structured data type.
The Vote to Approve button is a forward button that sends the task forward through the process. The
Vote to Deny button sends the task to a reject flow.
104 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Implementing the Presentation Layer
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 105
Implementing the Presentation Layer
Figure 37. Grant Initiate Vote on Grant Request Process Form in Forms Builder
Figure 38. Grant Initiate Vote on Grant Request Process Form in TaskSpace
106 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Implementing the Presentation Layer
This form uses the SendNotificationDataSourceAdaptor to populate the To: field with the grant
applicant’s email address, the Subject with the title of the funding project, and From field with the
sender email address when the form initializes. The information for these fields is retrieved from the
process variables RecipientEmailAddress, Subject, and SenderEmailAddress.
Note: The From field is hidden in TaskSpace.
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 107
Implementing the Presentation Layer
Figure 41. Grant Initiate Request Supporting Documents Process Form in Forms Builder
108 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Implementing the Presentation Layer
Figure 42. Grant Initiate Request Supporting Documents Process Form in TaskSpace
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 109
Implementing the Presentation Layer
110 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Implementing the Presentation Layer
The work queue task list form enables the administrator to search for the grant requests that have
been assigned to the work queue based on process metadata. The returned list of grant requests
enable the administrator to perform actions such as unassign, reassign, or suspend the tasks.
When creating a search page, ensure that you have a finalized design before laying out the page. Any
changes to fields will rearrange the page and override custom labels and custom layout.
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 111
Implementing the Presentation Layer
Main configuration
The title, top bar, and login logo for the Grants Management sample application are pre-configured
and delivered with the application. Different formats are also set to specific viewers in the
configuration page.
Components node
In the TaskSpace Configuration tab, the Components node displays a list of the current components
for the application.
112 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Implementing the Presentation Layer
Grant Correspondence Folder Content Folder This folder establishes the folder path
Form Contents for the Correspondence folder.
Grant Manager Task Form Task This is the task form for the manager
review.
Grant Manager Task List Form Task List This is the My Grants tab and displays
the Grant Manager task list.
Grant Request Folder Form Folder This folder information form
Information displays three tabs: Request
Information, Applicant Information,
and Assessments. The Request
Information and Applicant
Information tabs display information
from the grant application. The
Assessments tab displays an applicant
rating and a risk factor that is initially
assigned by the system during the
grant request creation process.
Grant Request Search Form Search This search form enables the Grants
Administrator to search for and
retrieve a list of grants from within
the system that contains the specified
search criteria.
Grant Reviewer Task Form Task This is the form that the reviewer uses
to select and type review remarks and
to vote to deny or approve the request.
Grant Reviewer Task List Form Task List This is the My Tasks tab and displays
the new tasks that the reviewer has.
Grant Review History Folder Content Folder This folder establishes the folder path
Contents for the Review History folder.
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 113
Implementing the Presentation Layer
Grants Root Folder Content Folder This folder establishes the root folder
Contents path for the Submitted Application
folder, Review History folder, and
required supporting documents.
Grant Submitted Application Folder Folder This folder establishes the folder path
Content Contents where the submitted applications are
placed within the Grants Root Folder.
Grant WQ Task List Task List Displays the work queue that the
Grants Administrator uses to manage
the workload of the Grants Managers.
Dashboards node
In the TaskSpace Configuration tab, the Dashboards node displays a list of the current dashboards for
the application.
114 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Implementing the Presentation Layer
GrantsTrends_Dashboard Dashboard This is the Grants Trends tab that displays the
GrantsTrends_Dashboard dashboard and is
available only for the Grants Administrator.
GrantsWorkerPerformance_ Dashboard This is the Worker Performance tab that displays
Dashboard the GrantsWorkerPerformance_Dashboard
dashboard and is available only for the Grants
Administrator.
Processes
The Process Management node enables you to search for and then administer process templates
and the associated process instances.
See Chapter 4, Implementing the Business Logic for a list of delivered process templates and their
function within the Grants Management sample application.
Tabs
In the TaskSpace Configuration tab, the Tabs node displays a list of the delivered tabs for the Grants
Management sample application.
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 115
Implementing the Presentation Layer
Grants_Administrator_ Task List The Tasks tab that displays the Grants Administrator’s
Task_List task list.
Grants_Folder Folder The Grants folder that uses the Grants Root Folder
content template. This folder contains the Review
History Folder, the Submitted Application Folder, and
the required documentation.
Grants_Funding Dash- The Funding tab that displays reports to the Grants
board Administrator that show overall funding and funding
approved per manager.
Grants_Manager_Task_List Task List The My Grants tab that displays the task list form for
the Grants Manager.
Grants_Reviewer_Task_List Task List The My Grants tab that displays the for the task list
form used by the Grants Reviewer.
Grants_Search Search The Search tab that displays the Grant Request search
form that enables the Grants Administrator to search
for and retrieve a list of grants from within the system.
GrantsInProgress Dash- The Grants In Progress tab that displays the
board GrantsInProgress_Dashboard to the Grants Manager.
GrantsTrends_Tab Dash- The Grants Trends tab that displays the
board GrantsTrends_Dashboard to the Grants Administrator.
GrantsWorkerPerformance Dash- The Worker Performance tab that displays the
board GrantsWorkerPerformance_Dashboard to the Grants
Administrator.
116 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Implementing the Presentation Layer
Configurable actions
In the TaskSpace Configuration tab, the Actions node displays the list of the delivered actions for
the Grants Management sample application.
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 117
Implementing the Presentation Layer
Menus
There are no custom menus delivered with the Grants Management sample application.
Roles
In the TaskSpace Configuration tab, the Roles node displays the list of the delivered roles for the
Grants Management sample application.
118 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Implementing the Presentation Layer
grants_manager
Tabs — The Grants Manager has access to the following delivered tabs:
• Grants_Manager_Task_List
• GrantsInProgress
Global Search — The Grants Manager does not have global search capability.
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 119
Implementing the Presentation Layer
Folder View — The Grants Manager has access to the following folders in the Grants root folder:
• grant_correspondence_folder
• grant_request
• grant_review_history_folder
• grant_submitted_app_folder
• dm_folder
120 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Implementing the Presentation Layer
Document View — The Grants Manager has access dm_document and it is mapped to the
DefaultDocView.
grants_reviewer
Tabs — The Grants Reviewer has access to the following delivered tab: Grants_Reviewer_Task_List
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 121
Implementing the Presentation Layer
Global Search — The Grants Reviewer does not have global search capability.
Folder View — The Grants Reviewer has access to the following folders in the Grants root folder:
• grant_correspondence_folder
• grant_request
• grant_review_history_folder
• grant_submitted_app_folder
• dm_folder
grants_administrator
Tabs — The Grants Administrator has access to the following tabs:
• Grants_Search
• Grants_Administrator_Task_List
• GrantsWorkerPerformance
• GrantsTrends_Tab
• Grants_Funding
Workflow — The Grants Administrator has access to the grants_wq queue and the Grant WQ
Task List.
Folder View — The Grants Administrator has access to the following folders in the Grants root
folder:
• grant_correspondence_folder
• grant_request
• grant_review_history_folder
• grant_submitted_app_folder
122 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Implementing the Presentation Layer
Types
In the TaskSpace Configuration tab, the Types node displays the list of the delivered types for the
Grants Management sample application.
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 123
Implementing the Presentation Layer
124 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Chapter 6
Monitoring the System
The Grants Management sample application ships with four dashboards that analyze business trends,
performance and progress of submitted grant applications. Only Grants Administrators and Grants
Managers have dashboards assigned to their roles.
Each dashboard consists of reports that follow a theme:
• The Grants In Progress dashboard provides detailed information about submitted grant
applications. Grants In Progress dashboard and reports, page 125 provides more information.
• The Grants Trends dashboard contains reports that illustrate general trends about grant requests.
Grants Trends dashboard and reports, page 132 provides more information.
• The Worker Performer dashboard reports on the performance and productivity of Grants
Reviewers and Grants Managers. Worker Performance dashboard and reports, page 144 provides
more information.
• The Funding dashboard contains two reports that calculate the average amount of grant money
being managed by Grant Managers. Funding dashboard and reports, page 154 provides more
information.
Process Reporting Services (PRS) is a report design tool. This tool is a core component of the
xCelerated Composition Platform (xCP). The Documentum Business Activity Monitor Implementation
Guide provides instructions on how to create and edit BAM reports that are displayed in dashboards.
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 125
Monitoring the System
126 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Monitoring the System
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 127
Monitoring the System
128 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Monitoring the System
• Column-6: Description
• Column-7: Applicant
• Column-8: None
Multi-drill Process Instance is selected as the Every process is assigned a Process
configuration in Dashboard Event Instance ID automatically. This
PRS identification number is monitored
and can be included in a report.
Instead of being visible in this report,
the Process Instance ID is used in a
multi-drill configuration. Multi-drill
reports are configured in the Chart
Data tab. In this example, the Process
Instance ID is coupled with the Grant
ID column. This enables dashboard
users to select a specific Grant ID,
which then updates the contents
of surrounding reports to display
data for the corresponding process
instance.
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 129
Monitoring the System
130 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Monitoring the System
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 131
Monitoring the System
Process Diagram
The Process Diagram dashlet indicates the grant application status as it travels through the Grant
Request Status Monitoring process:
• Activities in the diagram annotated with a gear icon and green check mark have been completed.
• Activities annotated with a blue gear icon are in-process.
• Activities grayed out have not been completed.
The Process Diagram dashlet is empty until the Grants Manager selects a grant ID in the Open
Grants report.
The Process Diagram dashlet ships with the product.
132 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Monitoring the System
The Grant Trends dashboard contains reports that illustrate general trends as they relate to the
number of applications received, total funding approved, and purposes of grant requests.
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 133
Monitoring the System
134 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Monitoring the System
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 135
Monitoring the System
136 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Monitoring the System
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 137
Monitoring the System
138 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Monitoring the System
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 139
Monitoring the System
140 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Monitoring the System
Table 48. Approved Funding Total Last Month ($) report configuration
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 141
Monitoring the System
142 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Monitoring the System
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 143
Monitoring the System
144 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Monitoring the System
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 145
Monitoring the System
The Worker Performance dashboard contains reports that measure the workload and efficiency of
Grant Reviewers and Grants Managers.
• Grants Manager Workload: This report looks at the Manage Grants Request process and
calculates the number of grants that each Grants Manager is currently managing. The Grants
Manager name is configured as a single drill-down. When clicked, the system opens the Grant
Applications by Purpose report.
The Grant Applications by Purpose report shows the grants that each Grants Manager is working
on, grouped by purpose.
• Grants Reviewer Workload: This report looks at the Start Review Process and shows the number
of grants being reviewed by each Grants Reviewer. This report shows which Grants Reviewers
currently have heavier or lighter workloads than others.
• Average Grant Management Duration: This report shows the average amount of time (in
hours) it takes Grants Managers to process a grant request, from the time they receive the grant
application until they approve or reject it.
• Average Review Duration: This report calculates the average time (in hours) it takes for Grant
Reviewers to review a grant, from the time they receive the grant application until they vote to
approve or deny it.
146 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Monitoring the System
The STD.PERFORMER_NAME
<>’grants_wq’ segment of the
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 147
Monitoring the System
148 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Monitoring the System
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 149
Monitoring the System
150 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Monitoring the System
The STD.PERFORMER_NAME
<>’grants_wq’ segment of the
filter expression excludes activities
completed by the grants_wq queue
from the count.
Chart type Bar
Chart data • Category (X) axis: Performer The Grants Reviewer name is
configuration Name.AE displayed on the X-axis.
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 151
Monitoring the System
The STD.PERFORMER_NAME
<>’grants_wq’ segment of the filter
expression excludes the grants_wq
queue from the report. This report
focuses on the average time it takes a
Grants Manager to conduct a review.
The work queue is not relevant for
this report.
Chart type Bar
Chart data • Category (X) axis: Performer The Grants Manager name is
configuration Name displayed on the X-axis.
152 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Monitoring the System
The STD.PERFORMER_NAME
<>’grants_wq’ segment of the filter
expression excludes the grants_wq
queue from the report. This report
focuses on the average time it takes a
Grant Reviewer to conduct a review.
The work queue is not relevant for
this report.
Chart type Bar
Chart data • Category (X) axis: Performer The Grants Reviewer name is
configuration Name.AE displayed on the X-axis.
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 153
Monitoring the System
154 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Monitoring the System
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 155
Monitoring the System
156 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Monitoring the System
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 157
Monitoring the System
158 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Index
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 159
Index
160 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Index
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 161
Index
P R
packages Receive Application via Email acrtivity, 51
GrantRequestPackage, 51, 56 Receive Application via Email activity, 20
GrantsApplicationPackage, 50 Receive Application via FTP activity, 51
passwords and usernames, Receive Application via HTTP activity, 51
pre-configured, 83 Receive Application via Webservice
Pending Info activity, 81 activity, 52
permissions, Access Control Lists, 84 remarks
permissions, role, 84 reviewer, 42
port, 18 reporting
priority, assigning, 61 sub-processes, 49
privileges reports
extending to Administrator, 16 Approved Funding Total Last Month
role-based, 84 ($), 132, 141
Process Diagram dashlet, 132 Average Grant Duration (Hours), 125,
Process Grant Request activity, 65 129
Process Integrator. See Documentum Average Grant Management
Process Integrator Duration, 144, 151
process parameters Average Grant Review, 139
CheckStatusURL, 56 Average Grant Review (Days), 132
configuring, 21 Average Review Duration, 144, 152
GrantsProcessACL, 56 Grant Application by Purpose, 143
SystemEmailAddress, 56 Grant Applications by Purpose, 132,
Process Reporting Services tool, 125 149
process templates Grant Duration (Hours), 131
Check Grant Request Status, 78 Grants Manager Workload, 144, 147
Create Grant Request, 50 Grants Reviewer Workload, 144, 150
Grant Request Status Monitoring, 79 New Grant Applications by City, 136,
Manage Grants Request, 23, 63 138
requirements for, 20 New Grant Applications by State, 132,
Send Notification, 67 136
Start Review Process, 23, 73 New Grant Applications Received, 132
Open Grants, 125, 127
162 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide
Index
Process Diagram dashlet, 132 Set Process Variables for Grants Manager
Request Documents Task List activity, 65
Archive request from Manager, 72 Set Status to Not Eligible activity, 62
Ataach Supporting Documents to Set Status to Pending Info activity, 62
Correspondence, 73 Set Status to Rejected activity, 62
Create folder to store email Set the status to Approved activity, 66
correspondence, 72 Set the status to Denied activity, 66
Join, 73 Signal Grant Request Status Monitoring
Send Request for Additional Process on Denial activity, 66
Documents, 72 Signal Grant Status Monitoring Process —
Set Request Id, 72 InReview activity, 75
Store Manager request details, 72 Signal Grants Monitoring Process on
Supporting Documents Received?, 73 Approval activity, 49
Wait for Additional Documents, 72 Start Grant Status Monitoring Process
Respond with Grant Request Status activity, 54
activity, 79 Start Review Process
Retrieve New Grant Request activity, 65 Expand Group, 75
Reviewer Votes activity, 78 Finalize, 76
risk rating, 40 Invoke Vote on Grant Request, 76
risk, assigning, 61 Is Group, 75
role permissions, 84 More Reviewers, 76
roles, 25 More Total Reviewers, 76
Grants Reviewer, 41 Signal Grant Status Monitoring Process
pre-configured, 35, 83 — InReview, 75
Rule1 activity, 61 (Start Review Process
Rule2 activity, 61 Copy User, 75
Rule3 activity, 61 Initialize Process Variables, 75
Start Review Process logic algorithm, 74
Start Review Process process template, 23
S Start Review Process template, 73
Send Advanced Notification Submitted activity, 81
Finalize, 71 SystemEmailAddress process
Send Not Eligible Message, 70 parameter, 56
Send Notification, 69
Send Rejected for More Info
Message, 70 T
Send Request Approved Message, 70 Target namespace URI, 51
Send Request Denied Message, 70 TaskSpace
Set Received Grant Request Email, 70 configurable actions, 32
Send Notification editing process parameters, 21
Finalize, 68 templates, forms, 86
Send Email To Applicant, 68
Send Notification process template, 67
Send Notification to Applicant activity, 67
U
Send Notification to Applicant on Rejection updateapp, 20
activity, 63 user types, 35
Send Notification to Applicant on usernamesand passwords, pre-
Successful Submission activity, 62 configured, 83
Set Process Variable with Date Request users, 25
Received activity, 56
EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide 163
Index
164 EMC Documentum Grants Management Sample Application 1.0 Technical Reference Guide