BizCoves 9.0 BluePrint

Transcription

BizCoves 9.0 BluePrint
BizFlow® 9.0 BizCoves
BluePrint
HandySoft Global Corporation — 1952 Gallows Road Suite 100 — Vienna, VA USA 703.442.5600 — www.handysoft.com
© 1999-2004 HANDYSOFT GLOBAL CORPORATION. ALL RIGHTS RESERVED. THIS DOCUMENTATION IS PROTECTED
BY COPYRIGHT AND DISTRIBUTED UNDER A LICENSE THAT RESTRICTS ITS USE, COPYING, AND DISTRIBUTION. NO
PART OF THIS DOCUMENTATION MAY BE REPRODUCED IN ANY FORM OR BY ANY MEANS WITHOUT THE PRIOR
WRITTEN AUTHORIZATION OF HANDYSOFT. WHILE EVERY PRECAUTION HAS BEEN TAKEN IN THE PREPARATION OF
THIS DOCUMENTATION, HANDYSOFT ASSUMES NO REPSONSIBILITY FOR ERRORS OR OMISSIONS. THIS
DOCUMENTATION AND THE FEATURES DESCRIBED HEREIN ARE SUBJECT TO CHANGE WITHOUT NOTICE.
HANDYSOFT ASSUMES NO RESPONSIBILITY REGARDING THE ACCURACY OF THE INFORMATION THAT IS PROVIDED
BY HANDYSOFT AND USE OF SUCH INFORMATION IS AT THE RECIPEINT’S OWN RISK.
BizFlow is a registered trademark and/or trademark of HandySoft Global Corporation in the United States
and/or other countries.
All other trademarks are the property of their respective owners.
The example organizations, companies, persons, server and object IDs, and email addresses depicted herein
are fictitious. No association with any real or actual entity is intended or should be inferred.
This document may contain suggested guidelines that can be followed in order to implement integration with a
third-party software product. As such, any files that accompany this document are templates that can be
used to quick-start the integration. Because HandySoft has no control over the evolution of the third-party
software, we cannot be held responsible for any modifications that may need to be made in order to fully
implement this integration as a result. As the third-party software evolves, full integration may require additional
procedures and may require alteration or additions to the template files.
This BluePrint paper is intended for use with BizFlow 9.0.
BC0090001_10152004B
HandySoft Global Corporation — 1952 Gallows Road Suite 100 — Vienna, VA USA 703.442.5600 — www.handysoft.com
BizFlow 9.0 BizCoves BluePrint
Contents
Contents
Introduction .......................................................................................................................................1
Recommended Configurations for this BizCoves BluePrint Paper.........................................1
About BizCoves .............................................................................................................................1
Extensibility of BizCove Framework.............................................................................................2
Models in this BluePrint Paper......................................................................................................3
Standalone Website or Intranet......................................................................................................4
IFRAME Parameters .......................................................................................................................4
Authentication and Access to BizCoves.......................................................................................7
Step 1 — Register Users.................................................................................................................7
Step 2 — Create User Groups .....................................................................................................7
Step 3 — Create the Process Definitions ...................................................................................8
Step 4 — Create the BizCoves ....................................................................................................8
Step 5 — Create the Work Area Pages ...................................................................................10
Test User Access...........................................................................................................................12
Conditional Logic ...........................................................................................................................14
Sharepoint 2001 with NT Single Sign-On ......................................................................................17
Adding a BizCove to Sharepoint ..............................................................................................17
Using Windows NT Single Sign-On .............................................................................................18
Sharepoint 2003 Portal Adapter ...................................................................................................19
How To Use the Sharepoint 2003 Adapter ..............................................................................19
Installing New Files.......................................................................................................................20
New Files ...................................................................................................................................20
New JAR Files............................................................................................................................20
URL and Parameters of the BizFlow Gateway JSP .................................................................20
Configuring BizFlow .....................................................................................................................23
Creating the BizCove on Sharepoint 2003 ..............................................................................23
Hummingbird and Credential Storage........................................................................................28
Adding a BizCove to Hummingbird .........................................................................................28
e-Clip Tags and Parameters ......................................................................................................29
Adding the BizCove e-Clip to a User Page.............................................................................30
Credential Storage for End-users ..............................................................................................30
BizFlow 9.0 BizCoves BluePrint
Contents
Integrating BizCoves into a Plumtree Portal ...............................................................................32
How the Plumtree Adapter Works ............................................................................................33
Installing New Files.......................................................................................................................33
Modified JSP Files.....................................................................................................................33
New Files ...................................................................................................................................34
New JAR Files............................................................................................................................34
URL and Parameters ...................................................................................................................34
bizflowgateway.jsp..................................................................................................................34
adminprefs.jsp..........................................................................................................................38
Configuring BizFlow .....................................................................................................................38
Copy Files..................................................................................................................................38
Modify web.xml File.................................................................................................................38
Configuring Plumtree..................................................................................................................39
Single Sign-On ..........................................................................................................................39
How to Use the Universal Password for each User..............................................................39
BizFlow as a Service in Plumtree............................................................................................40
Register BizFlow as a Remote Server ....................................................................................41
Register the Service.................................................................................................................42
Create the Portlet Template..................................................................................................46
Create the Portlet....................................................................................................................46
View the Portlet........................................................................................................................48
Registering the BizFlow Preferences in Plumtree ....................................................................49
Registering the Preferences ...................................................................................................50
Accessing the BizFlow Preferences.......................................................................................51
Setting the Time Zone .................................................................................................................52
Non-Personalized Time Zone Setting for All Users................................................................52
Personalized Time Zone Setting .............................................................................................52
Look-and-feel Customization ........................................................................................................55
Creating the New Theme’s Style Sheets..................................................................................55
Adding Your Theme to the System ...........................................................................................55
Summary...........................................................................................................................................57
BizFlow 9.0 BizCoves BluePrint
Introduction
Introduction
The BizCoves models in this BluePrint paper are examples on how your organization can
leverage the flexibility offered by BizFlow® to integrate – and tailor – BizCoves to your
existing environment and applications:
•
Standalone website or intranet
•
Portal such as Sharepoint, Hummingbird, or PlumTree
Code samples and instructions are provided for each model to serve as a brief but
concise guide to integrators or managers interested in the benefits of customizing
BizCoves or deploying them outside of BizFlow.
For more services around those models and for file packages that are required, please
contact HandySoft Global Corporation.
Recommended Configurations for this
BizCoves BluePrint Paper
In order to develop the BizCove models in this BluePrint paper make sure you are using
the following:
•
BizFlow 9.0 SP1
•
Microsoft Sharepoint 2001 SP 2; although Sharepoint 2003 is not officially
supported at this time for BizFlow 9.0, the BizFlow Portal Adapter for Sharepoint
2003 can be purchased to support it(configuration steps are provided in this
BluePrint)
•
Hummingbird 5.1.05 with latest service packs
•
PlumTree 5.0
About BizCoves
BizCoves organize and simplify the way people work.
BizCoves are containers, which, thanks to a straightforward and elegant user interface,
provide at-a-glance access to work items and functionality to handle them, as well as
reports on process benchmarking or monitoring.
Work area pages using BizCoves are personally assigned to workflow participants based
on their responsibilities within an organization. As a result, users no longer sift through the
information they don’t need, while managers have access to the big picture through
reports and monitoring BizCoves.
October / 2004
1
BizFlow 9.0 BizCoves BluePrint
Introduction
Out-of-the-box BizCoves offer great customization capabilities
Out of the box, BizFlow already offers great flexibility in the way BizCoves can be
designed and adapted to each user’s work and responsibilities:
•
Personalization – Worklist BizCoves display work items assigned to a user, an
organizational unit or a user group, and can narrow down the list to specific
process activities.
•
Functionality selection and customization – BizCoves’ names, icons and controls
are fully customizable, whether choosing your own image, labeling buttons with
your own terminology, or modifying their location. The eight types of reporting
BizCoves can be displayed as tables or charts, and a report’s timeframe can be
set to whatever range you want. You also have full control over the columns
displayed within the BizCoves. Customizable filters allows you to alert users about
urgent tasks or communicate critical business information.
For more details on BizCove types, and how to create them using the BizFlow
administration tool, please refer to the BizFlow User Guide.
Extensibility of BizCove Framework
Thanks to BizFlow extensibility, BizCove Work Area Pages may be easily transported to
other portal applications, intranets or websites through:
•
Extensive APIs enabling conditional logic
•
The support of single sign-on and automatic user identification
•
Look-and-feel customization via CSS
A Very Comprehensive Set of APIs
Using Java, C++, COM and SOAP APIs, applications can communicate with BizFlow to
directly control the content and functionality within BizCoves. Result sets in XML can be
easily parsed to store and display information.
Furthermore, APIs, through conditional logic statements, enable the BizCoves’
information and functionality to be uniquely specific to users, according to data related
to their groups, organizational unit or authority groups. Other information such as
customized greeting messages can also be displayed.
Note:
For more information on the BizFlow API Libraries, please refer to the BizFlow API Developer
Guides, “C++ Application Program Interface Developer Guide”, “Java Application Program Interface
Developer Guide”, “SOAP Application Program Interface Developer Guide”, and “XML Application
Program Interface Developer Guide.”
Full Single Sign-on Support for a Seamless User Experience
BizFlow supports Windows NT and PKI single sign-on technologies as well as user
identification across applications. (Those need to be set up correctly.) This automatic
authentication capability allows users to log in only once – to the portal or application in
which BizCoves are displayed – without logging into BizFlow.
October / 2004
2
BizFlow 9.0 BizCoves BluePrint
Introduction
Note:
Notes about NT and PKI Single Sign-On:
NT Single Sign On -- You must be using Microsoft Windows NT 4.0 or higher or Windows 2000, and your
network must use Microsoft Active Server Directory for authentication. With NT Single Sign On, once a
user logs onto NT or Windows, they are given automatic access to BizCoves.
Selecting NT Single Sign On is a BizFlow Administrator Preference option found in the General tab. For
more information about single sign on or how to select it, refer to the “BizFlow Administrator User
Guide.”
Customizable User Interface
The user Interface that dictates the look and feel of any BizCove can be easily
customized for usability, consistency or presentation. The XML data that is used to create
the BizCove does not contain any formatting information. Cascading Style Sheets (CSS)
determine the way the XML data will be rendered, or displayed. Style sheets can be
edited to modify BizCoves’ themes with your own selection of fonts, colors or to position
the information differently.
Models in this BluePrint Paper
Each model in this BluePrint paper illustrates a way to deploy BizCoves using the
techniques previously discussed:
•
Standalone Website or Intranet — Explains how to present BizCoves within a
corporate intranet or Web site.
•
Conditional Logic — Explains how to use conditional logic so that the information
and functionality displayed to the user within the BizCove is uniquely specific to
that user.
•
Authentication and Access to BizCoves– Explains how to grant access to BizCoves
based on user authentication and user group participation.
•
Integrating BizCoves into Sharepoint 2001 Portal with Single Sign-on — Presents
the procedure to integrate the BizCove into a Sharepoint 2001 portal. This
BluePrint paper also illustrates how NT single sign-on affects user authentication.
•
Integrating BizCoves into Sharepoint 2003 — Explains how to integrate the
BizCove into a Sharepoint 2003 portal using the portal adapter.
•
Integrating BizCoves into Hummingbird Portal — Explains how to integrate
BizCoves within a Hummingbird portal.
•
Integrating BizCoves into a Plumtree Portal – Describes how to deploy BizCoves in
Plumtree using BizFlow as a Web service. For this deployment, single sign-on must
be employed, so use of the universal password is covered.
•
Look-and-feel Customization – Details how to use the CSS to create your own
BizCove theme or appearance.
October / 2004
3
BizFlow 9.0 BizCoves BluePrint
Standalone Website or Intranet
Standalone Website or Intranet
BizCoves can be easily integrated into a regular Web page using the <IFRAME> tag,
supported by both Netscape (6.x minimum) and Internet Explorer (5.x recommended).
The IFRAME element allows you to insert the BizCove within a block of text, and is very
similar to inserting an image or an object. In its simplest version, no programming is
required since the call to the BizCove also includes user authentication. Should the user
be authenticated by BizFlow, a small popup window prompts the user for a login and
password.
The BizCove is inserted via the SRC attribute of the IFRAME tag, using the following format:
src=”http://<%BIZFLOW_SERVER%>/bizflow/
bizlogin.jsp?loginID=<%LOGINID%>&password=<%PASSWORD%>&forceLogin=tru
e&returnURL=http://<%BIZFLOW_SERVER%>/bizflow/data/bizcoves/
<%BIZCOVE_FOLDER%>/
<%BIZCOVE_TYPE%>_<%BIZCOVE_ID%>.jsp%3frefresh=y”
Replace <%BIZFLOW_SERVER%> with the server name or IP address followed by a colon
(:), followed by the Web Server port number.
IFRAME Parameters
Parameter
Instructions
<%BIZFLOW_SERVER%>
Replace with the DNS or IP and port
number of the BizFlow server containing
the BizCove.
Example: bizflow.company.com or
123.456.6.123:7201
<%LOGINID%>
Replace with a valid user ID. The user
must be authorized to view the BizCove.
<%PASSWORD%>
Replace with the user’s password
matching with the user ID.
<%BIZCOVE_FOLDER%>
Replace with one the following values
according to the BizCove type:
Process initiation BizCove: definition
Worklist Bizcove: worklist
Monitoring Bizcove: monitor
Report BizCove: report
October / 2004
4
BizFlow 9.0 BizCoves BluePrint
Standalone Website or Intranet
Parameter
Instructions
Report list BizCove: reportlist
External report BizCove: externalreport
<%BIZCOVE_TYPE%>
Replace with one of the following values
according to the BizCove type:
Process initiation: definition
Worklist: worklist
Monitoring: monitor
Process benchmark report: report1a
Activity benchmark report: report1b
Current activity status report: report2a
Historic activity status report: report2b
Overdue activity report: report3a
Activities due shortly report: report3b
Completed processes report: report4a
Completed activities report: report4b
External report: externalreport
<%BIZCOVE_ID%>
Replace with the BizCove ID on the
BizFlow server containing the BizCove.
As an example, this simple HTML code displays a Worklist BizCove, without any
programming required.
<HTML>
<BODY>
<IFRAME name="worklistbizcove" id="1"
src="http://bizflowserver:8080/bizflow/
bizlogin.jsp?loginID=user&password=password
&forceLogin=true&returnURL=http://bizflowserver:8080/
bizflow/data/bizcoves/worklist/
worklist_1000101.jsp%3frefresh=y"
width="500"
height="350"
scrolling="yes”
frameborder=”0”
marginheight=”5”
marginwidth=”5”
October / 2004
5
BizFlow 9.0 BizCoves BluePrint
Standalone Website or Intranet
align="center">
</IFRAME>
</BODY>
</HTML>
Figure 1.
BizCoves integrated using the IFRAME model
To modify the look-and-feel and position of the IFRAME, edit its attributes. Refer to an
HTML manual for more information about the IFRAME tag.
October / 2004
6
BizFlow 9.0 BizCoves BluePrint
Authentication and Access to BizCoves
Authentication and Access to
BizCoves
This section explains how to grant access to BizCoves based on user authentication and
user group participation. Access to different BizCoves is controlled by authentication
and which organizational unit a participant belongs to, which user groups a participant
belongs to, and whether or not the participant is a user or manager.
How you choose to deploy your BizCoves is dependent upon how users are
authenticated by BizFlow. If you use LDAP import to authenticate users, you may want to
use user groups to create distinct BizCoves for users. Whether or not you deploy your
BizCoves through a portal or through BizFlow and the Work Area Pages also determines
access to the BizCoves. If you are using a portal, you may want to create a distinct
BizCove for each user group to limit access. You can create as many user groups, each
with as many users, as you need to filter the work appropriately. If you decide to use a
portal to deploy your BizCoves, you can follow the instructions later in this BluePrint on
how to integrate with portals.
The example in this section explains how to create BizCoves so that two participants in
the same organizational unit can each access both the work sent to their organizational
unit and work sent to their user group while being able to initiate work only from their own
user group. This example also shows how the manager’s BizCove can be entirely
different from that of the users’. All of the steps in this section reflect the example that is
shown in the related figures. This example is just a suggested way to organize the
BizCoves. The way you construct yours will depend on factors including folder
authorization, use of organizational units, and use of user groups.
Step 1 — Register Users
Go to Authentication in the default General Administrator menu.
1. Create an organizational unit called Claims Department.
2. Register three users in the new organizational unit with User licenses: Terry, Fred,
and Jane. Terry is the manager.
Step 2 — Create User Groups
Go to User Group in the default Business Administrator menu.
1. Create a user group hierarchy called ClaimsDepartment with user groups
underneath called Fast Track Officer and Claims Processor.
October / 2004
7
BizFlow 9.0 BizCoves BluePrint
Authentication and Access to BizCoves
2. Assign your users so that Fred is in the Fast Track Officer user group and Jane is in
the Claims Processor user group.
Step 3 — Create the Process Definitions
Go to Process Design in the default Designer menu.
Create some process definitions to use that have at least one normal activity. For
example:
Process Definition
Participant
Normal Claim
Claims Processor
Special Claim
Fast Track Officer
Vacation Request
Initiator
1. Set the participant in the normal activity to the user group that is going to do the
work.
2. Set the participant to initiator for any processes you want to make generally
available.
Step 4 — Create the BizCoves
Go to BizCove in the default Business Administrator menu. You will create a process
initiation BizCove for each user group and a worklist BizCove for the organizational unit.
1. Create a process initiation BizCove called Fast Track Process Initiation BizCove.
2. Designate the Fast Track Officer user group to have access to this BizCove.
October / 2004
8
BizFlow 9.0 BizCoves BluePrint
Authentication and Access to BizCoves
3. Add the Special Claim, Normal Claim and Vacation Request process definitions
to the BizCove.
4. Finish the wizard. You can create filters and buttons as you want. Refer to the
BizFlow User Guide for assistance.
October / 2004
9
BizFlow 9.0 BizCoves BluePrint
Authentication and Access to BizCoves
5. Create a process initiation BizCove called Claims Processing Process Initiation
BizCove.
6. Designate the Claims Processor user group to have access to this BizCove.
7. Add the Normal Claim and Vacation Request process definitions to the BizCove.
8. Finish the wizard. You can create filters and buttons as you want. Refer to the
BizFlow User Guide for assistance.
9. Create a report BizCove. For example, create an Activity Benchmark report
including all of the processes you created.
10. Designate the Claims Department organizational unit to have access to this
BizCove.
11. Finish the wizard.
12. Create a worklist BizCove called the Claims Department Worklist BizCove.
13. Designate the Claims Department organizational unit to have access to this
BizCove.
14. When you define the scope of the Work Area, include any of the process
definitions for which you set any of the user groups as participants so that they’ll
be able to see the running processes.
Remember, you can include the entire folder, a process definition or the specific
activity for which the user group is a participant. This will determine what work will
be included in the BizCove. Any work assigned to the members of the user group
will be displayed as long as the activity with the workitem has been included. It
does not mean that the work will not be assigned if the activity (process definition
or folder) is not included, the participants just won’t be able to see it.
15. Finish the wizard.
Step 5 — Create the Work Area Pages
Go to BizCove in the default Business Administrator menu.
You can either deploy the BizCoves through a portal, which this BluePrint examines in
other sections that follow, or you can deploy through Work Area Pages. BizFlow lets the
business administrator create two BizCoves for each user group or organizational unit.
One is for the general users of the user group or organizational unit and one is for the
manager. The example in this BluePrint uses four different Work Area Pages.
1. Create a user Work Area Page for the Claims Department organizational unit.
October / 2004
10
BizFlow 9.0 BizCoves BluePrint
Authentication and Access to BizCoves
2. Choose two columns.
October / 2004
11
BizFlow 9.0 BizCoves BluePrint
Authentication and Access to BizCoves
3. Add BizCoves:
•
Column 1 — assign the Report BizCove that you created
•
Column 2 — assign the Claims Department Worklist BizCove
4. Create a manager Work Area Page for the Claims Department organizational
unit.
5. Choose two columns.
6. Add BizCoves:
•
Column 1 — assign the Report BizCove that you created
•
Column 2 — assign the Claims Processing Process Initiation BizCove and the
Fast Track Process Initiation BizCove
7. Create a user Work Area Page for the Fast Track user group.
8. Choose one column.
9. Add the Fast Track Process Initiation BizCove.
10. Create a user Work Area Page for the Claims Processor user group.
11. Choose one column.
12. Add the Claims Processing Process Initiation BizCove.
Test User Access
Now try logging in as each one of the users, Terry, Fred and Jane to see how access to
the BizCoves varies.
Figure 2.
Jane will see work assigned to members of the Claims Processor user group in the
Claims Department Organizational Unit Work Area Page. Jane can also select the Claims
Processor user group Work Area Page from the Show drop box to see the two process
definitions that they are allowed to initiate in the user group.
October / 2004
12
BizFlow 9.0 BizCoves BluePrint
Authentication and Access to BizCoves
Figure 3.
Fred will see work assigned to members of the Claims Processor user group in the
Claims Department Organizational Unit Work Area Page. Fred can also select the Fast
Track Officer user group Work Area Page from the Show drop box to see the three process
definitions that they are allowed to initiate in the user group.
Figure 4.
Because Terry is the manager of the organizational unit, the manager Work Area
Page is displayed. Terry can initiate the process definitions from either user group BizCove.
October / 2004
13
BizFlow 9.0 BizCoves BluePrint
Conditional Logic
Conditional Logic
One of the core benefits and usability points of BizCoves is their ability to display only
what pertains to users, based on their user group, organizational unit, authority group or
other filtering criteria. The conditional logic model enables personalization outside
BizFlow, and even enhances its capabilities. To benefit from the conditional logic
capability, JSP and Java Beans (hwjsp.jar, hwweb.jar) must be used.
As an example, by using the following beans in the code below, it is very easy to greet
the user by name and/or organizational unit.
<jsp:useBean id="hwSessionInfo"
class="com.hs.bf.web.beans.HWSessionInfo" scope="session"/>
<jsp:useBean id="hwSessionFactory"
class="com.hs.bf.web.beans.HWSessionFactory"
scope="application"/>
<%
// Retrieves the User ID
String userID = hwSessionInfo.get("USERID");
// Retrieves the organizational unit
String deptID = hwSessionInfo.get("DEPTID");
%>
Additionally, you may retrieve any information about the authority groups to which the
user belongs, and use this to display information and capabilities to which the user has
access authorization.
<%
HWFilter hwfilter = new HWFilter();
inputStream resultStream =
hwSession.getGroups(hwSessionInfo.toString(),hwFilter.toByteArray());
%>
Combined with conditional statements, the BizFlow API allows you to fully tailor how
BizCoves display to their audience. The following are examples of the difference
between how the BizCoves display for the manager and how they display for a user.
October / 2004
14
BizFlow 9.0 BizCoves BluePrint
Conditional Logic
Figure 5.
October / 2004
The manager’s BizCoves
15
BizFlow 9.0 BizCoves BluePrint
Conditional Logic
Figure 6.
October / 2004
The user’s BizCoves
16
BizFlow 9.0 BizCoves BluePrint
Sharepoint 2001 with NT Single Sign-On
Sharepoint 2001 with NT Single SignOn
BizCoves may be integrated into the Sharepoint portal by adding a new Web Part and
assigning the BizCove to it. To provide a seamless user experience, Windows NT Single
Sign On is supported so users can view BizCoves directly from Sharepoint without logging
into BizFlow. BizFlow Preferences are also accessible from Sharepoint, through each
embedded BizCove.
Figure 7.
BizCoves integrated into Sharepoint
Adding a BizCove to Sharepoint
Follow these steps to add and define the new Web Part.
1. Log in to the Sharepoint Portal.
October / 2004
17
BizFlow 9.0 BizCoves BluePrint
Sharepoint 2001 with NT Single Sign-On
2. Click on the Content link located at the top right of the window.
3. Click Create a New Web Part.
4. Modify the General Settings for the new Web Part.
a. At Name, enter a name for the New Web Part.
b. Check Include this Web Part on the Dashboard.
5. Modify the Advanced Settings for the new Web Part.
a. Check Get Content from the Following Link.
b. Enter the BizCove link in the following format:
http://<%BIZFLOW_SERVER%>/bizflow/bizcoves/<%BIZCOVE_FOLDER%>/
<%BIZCOVE_TYPE%>_<%BIZCOVE_ID%>.jsp
For information on how to replace the parameters in this example, refer to the
table IFRAME Parameters.
6. Check Isolate this Web Part’s content from the Other Web Parts.
7. Check Provide Content Personalization for this Web Part through the Following
Link.
8. Enter the link to BizFlow Preferences:
javascript:self.showModalDialog('http://<%BIZFLOW_SERVER%>/bizflow/preference/
preference.htm',",'dialogHeight:435px;dialogWidth: 526px;status:no;help:no;');
9. Click on the Save button to save the New Web Part.
Using Windows NT Single Sign-On
By registering the Windows NT Key in the BizFlow Preferences and turning on the NT Single
Sign-on feature, users have the option to directly access BizFlow from Sharepoint without
logging in a second time. If Single Sign-on is selected, the BizCoves will immediately
display in Sharepoint. If Single Sign-on has not been set up, the BizFlow login dialog box
will be displayed to prompt for the user’s ID and password.
October / 2004
18
BizFlow 9.0 BizCoves BluePrint
Sharepoint 2003 Portal Adapter
Sharepoint 2003 Portal Adapter
An adapter that is specifically designed by HandySoft to act as a proxy between BizFlow
and the portal facilitates the integration of BizCoves into the Sharepoint 2003 portal.
How To Use the Sharepoint 2003 Adapter
1. Login to Bizflow using SSO.
2. Redirect to the required URL.
October / 2004
19
BizFlow 9.0 BizCoves BluePrint
Sharepoint 2003 Portal Adapter
Installing New Files
New Files
The following JSP files and JS files are added. These files must be installed in the gadgets
directory of the BizFlow web application directory on the Web server:
•
gadgets/sharepoint/bizflowgateway.jsp
•
gadgets/sharepoint/constants.jsp
•
gadgets/sharepoint/setprefs.jsp
•
gadgets/sharepoint/userprefs.jsp
•
gadgets/loginfn.jsp
™ These files are located in the BizFlow folder in the zip file distributed with the BizFlow
Portal Adapter for Sharepoint 2003.
New JAR Files
The following JAR file is added. This JAR file must be installed in the WEB-INF/lib directory
of the BizFlow web application directory on the Web server.
•
WEB-INF/lib/hwextutil.jar
This file is located in the BizFlow folder in the zip file distributed with the BizFlow Portal
Adapter for Sharepoint 2003.
URL and Parameters of the BizFlow Gateway
JSP
The main module of the BizFlow Portal Adapter for Sharepoint 2003 is bizflowgateway.jsp.
Context URL: /bizflow/gadgets/sharepoint/bizflowgateway.jsp
Parameters:
Parameter
Name
Explanation
DEFAULT
Mandatory
loginID
User ID
NO
password
The password of the
user
NO
loginType
Login type
•
October / 2004
BIZFLOWSECURITY
NO
BIZFLOWSECURITY:
20
BizFlow 9.0 BizCoves BluePrint
Sharepoint 2003 Portal Adapter
Parameter
Name
Explanation
DEFAULT
Mandatory
using login ID and
password
™ loginID and
password
parameters
must exist
•
NTSSO: using NT
SID
™ Ignore login
ID and
password
parameters
•
PROPERTYAUTH:
get login id and
password from a
cookie
If this parameter is
not specified, the
loginType is assumed
to be
“BIZFLOWSECURITY”
NTSID
User’s NTSID. This
parameter is only
used if loginType is
“NTSSO”.
NO
targetURL
The URL of the Bizflow
web application to
be executed.
NO
forceLogin
When the user is
already logged into
another browser, and
the value is true, the
user will be forcibly
logged out and the
new attempt to login
will be successful.
false
NO
If the user is already
logged into another
browser, and this
October / 2004
21
BizFlow 9.0 BizCoves BluePrint
Sharepoint 2003 Portal Adapter
Parameter
Name
Explanation
DEFAULT
Mandatory
value is false, the
new attempt to login
will fail.
localGMT
Timezone. For
example, when using
the GMT-5 timezone,
this value is –5.
0
bizcoveID
The ID of a BizCove
1000202
bizcoveType
The type of a
BizCove. The value is
one of the following:
z
definition
z
worklist
z
report
z
externalreport
z
monitor
YES
YES
™ When the loginType is “BIZFLOWSECURITY”, and the loginID and password
parameters do not exist in the URL, the BizFlow Gateway gets the value of loginID
and password from a Cookie:
o
The cookie name of loginID is “loginID”
o
The cookie name of password is “password”
™ When the loginType is “PROPERTYAUTH”, the BizFlow Gateway tries to get the
BizFlow ID and password from the Cookie. If the BizFflow ID and password do not
exist in the Cookie, the login screen will be displayed. Once the user inputs the
BizFlow ID and password, they are saved in the Cookie and the user will no longer
be prompted unless an error occurs during login to BizFlow.
™ If you want to customize the login screen, please modify
gadgets/sharepoint/userprefs.jsp.
The following are examples of the URL:
October / 2004
22
BizFlow 9.0 BizCoves BluePrint
Sharepoint 2003 Portal Adapter
http://jkcom:8080/bizflow/gadgets/sharepoint/bizflowgateway.jsp?loginType=PROPERTYAUTH&bi
zcoveID=1000202&bizcoveType=worklist
http://jkcom:8080/bizflow/gadgets/sharepoint/bizflowgateway.jsp?loginType=PROPERTYAUTH&bi
zcoveID=1000203&bizcoveType=definition
http://jkcom:8080/bizflow/gadgets/sharepoint/bizflowgateway.jsp?loginType=PROPERTYAUTH&bi
zcoveID=1000204&bizcoveType=monitor
Configuring BizFlow
1.
Copy all of the new JSP files and jar files to the following folder:
%WEB_APPLICATION_HOME%\bizflow
2.
Restart the web server.
Creating the BizCove on Sharepoint 2003
1. Click Modify My Page at the top and select the Browse menu.
2. Select Page Viewer Web Part in left frame.
October / 2004
23
BizFlow 9.0 BizCoves BluePrint
Sharepoint 2003 Portal Adapter
3. Drag it down to the place where a BizCove shows up.
October / 2004
24
BizFlow 9.0 BizCoves BluePrint
Sharepoint 2003 Portal Adapter
4. Click the ▼ icon on the Page Viewer Web Part and select Modify My Web
Part.
5. Enter the URL of the BizFlow Gateway in the Link field.
October / 2004
25
BizFlow 9.0 BizCoves BluePrint
Sharepoint 2003 Portal Adapter
A sample URL is:
http://jkcom:8080/bizflow/gadgets/sharepoint/bizflowgateway.jsp?loginType=PROPE
RTYAUTH&bizcoveID=1000202&bizcoveType=worklist
6. Expand Appearance.
7. Enter the title of a BizCove.
October / 2004
26
BizFlow 9.0 BizCoves BluePrint
Sharepoint 2003 Portal Adapter
8. If needed, change Appearance, Layout and Advanced options and click
OK.
October / 2004
27
BizFlow 9.0 BizCoves BluePrint
Hummingbird and Credential Storage
Hummingbird and Credential
Storage
The integration of BizCoves into Hummingbird is similar to interfacing with Sharepoint. But,
instead of using Windows NT Single Sign-On, Hummingbird supports credential storage
that retains the user’s login ID and password for specific applications. Specifically, the
BizFlow user ID and password are stored in the hcl.bizflow credential file and will be used
to launch BizCoves without requiring the user to login a second time.
Adding a BizCove to Hummingbird
Integration with Hummingbird requires the creation of a Hummingbird e-Clip, to which
the BizCove is added, then a component is scripted utilizing the IFRAME tag.
1. Create and name an e-Clip file in the folder of the www e-Clip category:
$Home\Hummingbird\eip\repository\eclips\www\, using the following code
pattern. Tags and parameters in this example are detailed below. For more
information on other e-Clip parameters, please consult Hummingbird
documentation.
<ECLIP>
<DESCRIPTION>
This is a BizCove integrated into the Hummingbird Portal
</DESCRIPTION>
<PARAMETERS>
title="BizCove Eclip"
credentials=hcl.bizflow
credentialendocingmethod=url
cache=transient
</PARAMETERS>
<COMPONENTS>
Iframe
http://<%BIZFLOW_SERVER%>/bizflow/
bizlogin.jsp?loginID=$Username$&password=$Password$&forceLogin=true&returnURL
=http://<%BIZFLOW_SERVER%>/bizflow/data/bizcoves/<%BIZCOVE_FOLDER%>/
<%BIZCOVE_TYPE%>_<%BIZCOVE_ID%>.jsp
</COMPONENTS>
</ECLIP>
October / 2004
28
BizFlow 9.0 BizCoves BluePrint
Hummingbird and Credential Storage
e-Clip Tags and Parameters
Tag/Parameter
Description/Instructions
<DESCRIPTION>[…]</ DESCRIPTION>
Describes the purpose of the e-Clip. In
some themes, the description may be
displayed.
<PARAMETERS>[…]</ PARAMETERS>
Sets the parameters for the e-Clip such as
the caching mechanism.
title
The title of the e-Clip must be enclosed
within double-quotes and if none exists, “”
is the default to use.
credentials
This must be set to hcl.bizflow, which is the
file used to store credentials i.e. user login
and password.
credentialencodingmetho d
Indicates the encoding method to use
when transmitting the user’s credentials.
For BizCoves, this must be set to url.
cache
Sets the caching scope for the e-Clip:
global: cached results are available to all
users.
session: cached results are on a per-user
basis (personalized or private
information).
transient: no caching (default).
<COMPONENTS>[...]</ COMPONENTS>
Lists the components that input and
output information related to the BizCove.
Iframe
Indicates that the BizCove uses IFRAME to
be integrated to the Hummingbird portal.
This cannot be changed or left out.
http:// <%BIZFLOW_SERVER%>/ bizflow/
bizlogin.jsp?loginID=$Usern
ame$&password=$Passwor
d$&forceLogin=true&retur nURL=http://
<%BIZFLOW_SERVER%>/
bizflow/data/bizcoves/
<%BIZCOVE_FOLDER%>/
<%BIZCOVE_TYPE%>_<%BIZ COVE_ID%>.jsp
This is the URL of the BizCove component.
Refer to the table IFRAME Parameters. for
more information on how to replace the
parameters for the BizFlow server and the
BizCove.
October / 2004
29
BizFlow 9.0 BizCoves BluePrint
Hummingbird and Credential Storage
2. Add the scripted component using IFrame for the e-Clip by updating or
creating the IFrame file in the directory
$Home\Hummingbird\eip\repository\compscr\, using the following code:
<COMPONENT>
<REPLACE>
<IFRAME
src="$eClipRequest$"
width="100%"
height="320px"
scrolling="yes"
frameborder=0
marginheight=0
marginwidth=0
align="left">
</IFRAME>
</REPLACE>
</COMPONENT>
Unlike the src attribute, parameters such as width, height or alignment can be changed.
They are used to build the IFRAME when the BizCove is displayed. Please refer to an HTML
guide for more details about the IFRAME element.
Adding the BizCove e-Clip to a User Page
1. Select General Information, then select Add User Page.
2. Enter a name.
3. Click the Create User Page icon.
4. Click the Insert e-Clip button.
5. Select www as the Category.
6. From the list, select the e-Clip that you created.
7. Click the Add e-Clip To User Page icon. Hummingbird displays the BizCove.
8. Click the Build Page icon.
Credential Storage for End-users
To benefit from credential storage and single sign-on, users need to modify the
credentials in their Hummingbird user’s profile. If there is a BizFlow application available,
select hcl.bizflow, and enter a valid user name and password.
If there is no BizFlow application, do the following:
October / 2004
30
BizFlow 9.0 BizCoves BluePrint
Hummingbird and Credential Storage
1. From the Browse tab, select Administration Tools, and then select Application
Management.
2. Select the Add tab to add a new application.
3. Enter the application identifier as follows: hcl.bizflow
4. Select Simple (username/password) as Authentication type, and press the Save
button.
5. Return to the portal page.
6. Select hcl.bizflow, enter a valid user name and password, and press the Save
button.
October / 2004
31
BizFlow 9.0 BizCoves BluePrint
Integrating BizCoves into a Plumtree Portal
Integrating BizCoves into a Plumtree
Portal
Unlike the IFRAME model, the integration of BizCoves in the Plumtree portal is based on
an adapter that is specifically designed by HandySoft to act as a proxy between BizFlow
and the portal. The Bizflow adapter modifies the content of the Bizflow web application
as Plumtree expects it to be and returns it to Plumtree.
BizCoves are embedded in Plumtree without losing any functionality
•
JavaScript code is included and URLs remain unchanged (absolute path),
including the Refresh link.
•
The BizFlow Workitem Handler is automatically installed if it is not present on the
user’s desktop the very first time a task it worked on.
Figure 8.
A BizCove in the Plumtree portal
The following BizFlow features are supported in the Plumtree Portal:
•
Process Initiation Bizcove
•
Monitor Bizcove
•
Report Bizcove
•
Reportlist Bizcove
•
Worklist Bizcove
•
Preferences
October / 2004
32
BizFlow 9.0 BizCoves BluePrint
Integrating BizCoves into a Plumtree Portal
Note:
Some files need to be modified and added. To integrate BizCoves as Plumtree Gadgets, you must
first adapt your BizFlow server. A set of new JSP and JAR files need to be installed, while some existing
ones need to be modified. Please contact HandySoft to have this package made available to you.
After installing those files, both BizFlow and Plumtree need to be configured to enable communication
between each server.
How the Plumtree Adapter Works
1. Login into Bizflow using SSO.
2. Remove the HTML tags that are not allowed by Plumtree, such as <HTML>,
<HEAD>, and <BODY> from the HTML of the Bizflow web application.
3. Embed the context of the Java Script files that are in the HTML of the
Bizflow web application into the resulting HTML.
™ Because the resulting HTML is embedded in the Plumtree portal,
the relative URL of the resulting HTML must be modified to be an
absolute URL. Luckily, Plumtree modifies the relative URL of the
resulting HTML but it doesn’t modify the relative URL of Java
Script files that are in the resulting HTML. So If the context of the
Java Script files has a relative URL, the context of the Java Script
files must be embedded into the resulting HTML.
4. Modify the refresh URL in the resulting HTML of the Bizflow web application.
™ Because the refresh URL of the HTML page doesn’t consider the
environment of the Plumtree portal, all refresh URLs must be
modified to accommodate the Plumtree environment.
5. If needed, change the Java Script function in the resulting HTML of the
Bizflow web application to work in the Plumtree environment.
6. If the Workitem Handler program is not installed on the client, it will install
automatically.
Installing New Files
Modified JSP Files
The following BizFlow JSP files are modified and must be overwritten in same location:
•
includes\bizcoves\common\userinfo.js
•
includes\instance\piactivity.js
•
includes\instance\piattach.js
•
includes\instance\picomment.js
October / 2004
33
BizFlow 9.0 BizCoves BluePrint
Integrating BizCoves into a Plumtree Portal
™ These modified JSP files are in the webapps/bizflow folder in the zip file distributed with
the Bizflow Adapter for Plumtree.
New Files
The following JSP files and JS files are added. These files must be installed in the gadgets
directory of the BizFlow web application directory:
•
gadgets/plumtree/adminprefs.jsp
•
gadgets/plumtree/bg_definition.js
•
gadgets/plumtree/bg_embeededdefinition.js
•
gadgets/plumtree/bg_monitor.js
•
gadgets/plumtree/bg_worklist.js
•
gadgets/plumtree/bizflowgateway.jsp
•
gadgets/plumtree/bizflowprefreences.jsp
•
gadgets/plumtree/mainstyle-en.css
•
gadgets/plumtree/setprefs.jsp
•
gadgets/plumtree/userprefs.jsp
•
gadgets/plumtree/userprefs_simple.jsp
•
gadgets/bizflowpreferences.jsp
•
gadgets/loginfn.jsp
™ These files are in webapps/bizflow folder in the zip file distributed with the Bizflow
Adapter for Plumtree.
New JAR Files
The following JAR files are added. These JAR files must be installed in WEB-INF/lib directory
of Bizflow web application directory
•
WEB-INF/lib/bizcove.jar
•
WEB-INF/lib/gdk.jar
•
WEB-INF/lib/hwextutil.jar
™ These files are in the webapps/bizflow folder of the zip file distributed with the Bizflow
Adapter for Plumtree
URL and Parameters
bizflowgateway.jsp
The main module of the Bizflow adapter for Plumtree is bizflowgateway.jsp.
October / 2004
34
BizFlow 9.0 BizCoves BluePrint
Integrating BizCoves into a Plumtree Portal
Context URL: /bizflow/gadgets/plumtree/bizflowgateway.jsp
Parameters:
Parameter
Name
Explanation
DEFAULT
Mandatory
loginID
User ID
NO
password
The password of the
user
NO
loginType
Login type
•
BIZFLOWSECURITY
NO
BIZFLOWSECURITY:
using login ID and
password
™ loginID and
password
parameters
must exist
•
NTSSO: using NT
SID
™ Ignore login
ID and
password
parameters
•
BASICAUTH: using
login ID and
password for
Plumtree
•
PROPERTYAUTH:
get login id and
password from
properties of the
Plumtree
If this parameter is
not specified, the
loginType is assumed
to be
“BIZFLOWSECURITY”
NTSID
October / 2004
User’s NTSID. This
parameter is only
used if loginType is
“NTSSO”.
NO
35
BizFlow 9.0 BizCoves BluePrint
Integrating BizCoves into a Plumtree Portal
Parameter
Name
Explanation
targetURL
The URL of the Bizflow
web application to
be executed.
forceLogin
When the user is
already logged into
another browser, and
the value is true, the
user will be forcibly
logged out and the
new attempt to login
will be successful.
DEFAULT
Mandatory
NO
false
NO
If the user is already
logged into another
browser, and this
value is false, the
new attempt to login
will fail.
pwdPropertyName
Administrative
property name to
pass a user’s
password.
•
In the case of All
so that user’s
password is same,
please use this
parameter.
•
If you use this
parameter, the
value of the
loginType
parameter must
be
BIZFLOWSECURITY
NO
localGMT
Timezone. For
example, when using
the GMT-5 timezone,
this value is –5.
0
useBizcoveStyleSheet
If this value is false, it
will remove the
true
October / 2004
36
BizFlow 9.0 BizCoves BluePrint
Integrating BizCoves into a Plumtree Portal
Parameter
Name
Explanation
DEFAULT
Mandatory
Bizflow style sheet
information from the
HTML content of the
Bizcove.
™ When the loginType is “BIZFLOWSECURITY”, and the login ID and password
parameters do not exist in the URL, the Bizflow adapter for Plumtree module gets
the value of the login ID and password from the “Authorization” HTTP header. In
order to use the “Authorization” HTTP header, the “User’s Basic Authentication
Information” must be set in Advanced Settings when registering a gadget.
™ When the loginType is “PROPERTYAUTH”, the BizFlow Gateway tries to get the
BizFlow ID and password from the properties of the Plumtree portal. If, however,
the BizFlow ID and password do not exist in the Plumtree properties, the login
screen will be displayed. Once the user inputs the BizFlow ID and password, they
are saved in the properties of the Plumtree portal and the user will no longer be
prompted unless an error occurs during login to BizFlow.
™ If you want to customize the login screen, please modify
gadgets/plumtree/userprefs.jsp.
October / 2004
37
BizFlow 9.0 BizCoves BluePrint
Integrating BizCoves into a Plumtree Portal
adminprefs.jsp
The adminprefs.jsp file saves information from the BizCove into the Plumtree Administrator
properties.
Context URL: /bizflow/gadgets/plumtree/adminprefs.jsp
Parameters:
Parameter
Name
pwdPropertyName
Explanation
Administrative
property name to
pass a user’s
password.
DEFAULT
Mandatory
NO
In the case of All so
that user’s
password is same,
please use this
parameter.
Configuring BizFlow
Copy Files
Copy all modified JSP files, new JSP files and jar file to the root directory of the BizFlow
web application.
Modify web.xml File
Configuration of BizFlow for the Plumtree Portal occurs in the web.xml file, located under
$BIZFLOW_HOME\WEB-INF\ where $BIZFLOW_HOME is the Web application directory for
BizFlow on the Web server.
Example: If the web application directory of Bizflow is C:\Program Files\Apache Tomcat
4.0\webapps\bizflow, the web.xml resides in C:\Program Files\Apache Tomcat
4.0\webapps\bizflow\WEB-INF\web.xml
1. Set the com.hs.bf.xml.soap.endPoint parameter to specify the RPCRouter URL for
BizFlow:
<init-param><param-name>com.hs.bf.xml.soap.endPoint</param-name><paramvalue>http://<%BIZFLOW_SERVER%>:PORT/bizflow/rpcrouter</param-value></initparam>
October / 2004
38
BizFlow 9.0 BizCoves BluePrint
Integrating BizCoves into a Plumtree Portal
Replace <%BIZFLOW_SERVER%> with the IP address or name of the machine
where BizFlow is installed that contains the BizCove and replace PORT with the
port number of the web server.
Here is an example: machine_name:8080 or 123.456.6.123:8080
2. Set the com.hs.bf.web.gadget.basedir parameter to specify the root directory
path of BizFlow:
<init-param><param-name>com.hs.bf.web.gadget.basedir</param-name><paramvalue><%WEB_APPLICATION_ROOT_DIRECTORY%></param-value></init-param>
If the web application directory of BizFlow is C:\Program Files\Apache Tomcat
4.0\webapps\bizflow, <%WEB_APPLICATION_ROOT_DIRECTORY%> is C:/ Program
Files/Apache Tomcat 4.0/webapps. (Make sure to change \ to /.)
3. Restart the BizFlow server.
Configuring Plumtree
This configures the BizFlow gadgets on Plumtree.
Single Sign-On
Plumtree requires single sign-on to be set up between the portal and any application,
including BizFlow. Please refer to the Plumtree documentation to enable SSO.
How to Use the Universal Password for each User
1. Decide the property name as password parameter.
2. Add the pwdPropertyName=YOUR_PROPERTY_NAME parameter to the URL of
bizflowgateway.jsp and specify BIZFLOWSECURITY as the value of the loginType
parameter when creatinge the BizFlow web service.
For example, If you use “ADMIN_PASSWORD” as the property name of the
password parameter, the URL of the bizflowgateway.jsp is
bizflow/gadgets/plumtree/bizflowgateway.jsp?forceLogin=true&loginType=
BIZFLOWSECURITY&pwdPropertyName=ADMIN_PASSWORD&localGMT=-5
3. Add pwdPropertyName=YOUR_PROPERTY_NAME parameter tot the URL of
adminprefs.jsp when entering the Administrative Preferences URL.
For example, If you use “ADMIN_PASSWORD” as property name of password
parameter. The Administrative Preferences URL is
bizflow/gadgets/plumtree/adminprefs.jsp?pwdPropertyName=ADMIN_PASSWORD
4. Set the password when configuring the Bizflow BizCove.
October / 2004
39
BizFlow 9.0 BizCoves BluePrint
Integrating BizCoves into a Plumtree Portal
BizFlow as a Service in Plumtree
After enabling single sign-on between Plumtree and BizFlow, BizCoves may be integrated
using a service. The following instructions provide a summary of the procedure; for more
details, please refer to the Plumtree documentation.
1. Log into Plumtree as an administrator.
2. Click the Administrator menu at the top.
3. In the Admin Objects Directory, select the Create Objects drop box and select
Administrative Folder.
4. Enter a name and a description, and click OK.
October / 2004
40
BizFlow 9.0 BizCoves BluePrint
Integrating BizCoves into a Plumtree Portal
Register BizFlow as a Remote Server
1. Select the folder you just created.
2. Select Remote Server from the Create Objects drop box.
3. Enter the base URL of the BizFlow server, including the port number.
For example: http://bizflow:8080/
4. Leave Base Authentication Type set to None.
October / 2004
41
BizFlow 9.0 BizCoves BluePrint
Integrating BizCoves into a Plumtree Portal
5. Click Properties and Names and enter the name of the remote server, for
example BizFlow web server.
6. Click Finish and select your folder as the one in which to save the property of the
remote server.
7. Click Save.
8. Click Close.
Register the Service
1. Make sure you are in the folder you previously created.
2. Select Web Service – Remote Portlet from the list in the Create Objects drop box.
October / 2004
42
BizFlow 9.0 BizCoves BluePrint
Integrating BizCoves into a Plumtree Portal
3. Click Browse and select the remote server you created, for example BizFlow web
server.
4. In the HTTP settings, enter the base URL of bizflowgateway.jsp for the portlet URL.
This is core module acting as the gateway between BizFlow and Plumtree. The
base URL of the bizflowgateway.jsp is:
“bizflow/gadgets/plumtree/bizflowgateway.jsp?forceLogin=true”
Note:
You may also need to add parameters. See bizflowgateway.jsp on page 34
Note:
If you use BASICAUTH login type, please add loginType=BASICAUTH into the URL and if you want
to specify timezone, add localGMT parameter. For example If you use GMT-5 timezone, the url is
bizflow/gadgets/plumtree/bizflowgateway.jsp?forceLogin=true&loginType=BASICAUTH&localGMT=-5
5. Make sure the status of the Web service is enabled.
October / 2004
43
BizFlow 9.0 BizCoves BluePrint
Integrating BizCoves into a Plumtree Portal
6. Click HTTP Configuration.
7. Add the gateway URL prefix “bizflow”.
October / 2004
44
BizFlow 9.0 BizCoves BluePrint
Integrating BizCoves into a Plumtree Portal
8. Select Advanced Settings.
9. Select User’s Basic Authentication Information.
10. Click Preferences (on the left).
11. Enter as the Administrative Preferences URL and Portlet Template Preferences URL,
the basic URL:
bizflow/gadgets/plumtree/adminprefs.jsp
Note:
You may also need to add parameters. See bizflowgateway.jsp on page 34
12. Click Properties and Names (on the left).
13. In the Properties and Name page, enter the name of the Web service.
14. Click Finish.
15. Select your folder to save the Web service.
16. Click Save.
17. Click Close.
October / 2004
45
BizFlow 9.0 BizCoves BluePrint
Integrating BizCoves into a Plumtree Portal
Create the Portlet Template
1. In your folder, select Portlet Template in list in the the Create Objects drop box.
2. Click Browse and select the Web Service you created.
3. Select Properties and Names (on the left).
4. On the Properties and Name page, enter the name of the portlet template, for
example:
BizFlow BizCove Template
5. Click Finish.
6. Select your folder to save the Web service.
7. Click Save.
8. Click Close.
Create the Portlet
1. In your folder, select Portlet in the list in the Create Objects drop box.
October / 2004
46
BizFlow 9.0 BizCoves BluePrint
Integrating BizCoves into a Plumtree Portal
2. Select the portlet template you designed (BizFlow BizCove Template) and click
OK.
3. Click the Edit button.
4. Select the type and ID of the BizCove to be inserted into the portlet.
5. Click Finish.
6. Select Properties and Names (on the left).
7. In the Properties and Names screen name the portlet, for example, BizCove
Worklist.
8. Select Security (on the left).
October / 2004
47
BizFlow 9.0 BizCoves BluePrint
Integrating BizCoves into a Plumtree Portal
9. In order to allow every user to view the portlet, choose Select in the Security
page.
10. Click Finish.
9. Select your folder to save the portlet.
10. Click Save.
11. Click Close.
View the Portlet
The portlet needs to be added to a page.
1. Select Add Portlets from of My Pages at the top of the screen.
2. Select the portlet you created, for example, BizCove Worklist
3. If configured correctly, the BizCove is displayed in the portal.
October / 2004
48
BizFlow 9.0 BizCoves BluePrint
Integrating BizCoves into a Plumtree Portal
Registering the BizFlow Preferences in
Plumtree
Add or modify the bizflowpreferences.jsp, this jsp file must be located in the
gadgets/plumtree directory under the BizFlow web application directory. You should
have copied it there earlier in this BluePrint. See New Files on page 20.
The following in the bizflowpreferences.jsp file:
<%@ page language="java" import="java.io.FileInputStream,
java.io.FileReader,
java.io.FileOutputStream,
java.net.URL,
java.net.MalformedURLException,
java.net.URLEncoder" %>
<head>
<title>
Sarbanes User Preferences
</title>
</head>
<SCRIPT language='javascript'>
function openPreferencesWindow()
{
var height = 520;
var width = 540;
var strXLocation = String((screen.width - width) / 2);
var strYLocation = String((screen.height - height) /2);
this.location =
"bizflowgateway.jsp?forceLogin=true&loginType=BASICAUTH&refresh=y&prefPage=true";
}
October / 2004
49
BizFlow 9.0 BizCoves BluePrint
Integrating BizCoves into a Plumtree Portal
openPreferencesWindow();
</SCRIPT>
Registering the Preferences
1. Go to the web service of the Bizflow BizCove.
2. Select the Preferences menu on the left side of the screen.
3. Enter the following at the Portlet Preferences URL: on right side
bizflow/gadgets/plumtree/bizflowpreferences.jsp
4. Click Finish (at the top of the screen).
October / 2004
50
BizFlow 9.0 BizCoves BluePrint
Integrating BizCoves into a Plumtree Portal
Accessing the BizFlow Preferences
1. Click the icon with the pencil image
in the BizCove portlet.
2. From the on My Preferences list, click a Portlet name.
October / 2004
51
BizFlow 9.0 BizCoves BluePrint
Integrating BizCoves into a Plumtree Portal
The BizFlow preferences will be displayed.
Setting the Time Zone
If you do not specify a Time Zone, the GMT+0 time zone is used.
You can specify a Time Zone for all users using the localGMT parameter of
bizflowgateway.jsp or allow each user to specify a personalized Time Zone.
Non-Personalized Time Zone Setting for All Users
Please add the localGMT pararmeter when you Register the Service.
Personalized Time Zone Setting
To allow each user to specify their own personalized Time Zone, the “Send timezone to
Portles” option of Web Service must be turned on. The localGMT parameter must not be
specified in the URL of bizflowgateway.jsp to prevent use of a personalized Time Zone.
October / 2004
52
BizFlow 9.0 BizCoves BluePrint
Integrating BizCoves into a Plumtree Portal
Each user can then specify a personalized time zone using the “Edit Locale Settings”
menu under My Account.
October / 2004
53
BizFlow 9.0 BizCoves BluePrint
Integrating BizCoves into a Plumtree Portal
October / 2004
54
BizFlow 9.0 BizCoves BluePrint
Look-and-feel Customization
Look-and-feel Customization
Using the CSS (Cascading Style Sheet), a BizCove’s look-and-feel and user controls can
easily be customized to reflect your corporate identity or be consistent with your portal’s
user interface. BizFlow comes with five built-in themes. When a user creates a new
BizCove through the BizCove creation wizard, the themes are presented to the user in a
list so that one of them can be applied to the BizCove. You may create your own
BizCove appearance themes by following these instructions:
Creating the New Theme’s Style Sheets
The files for each theme – CSS and images – are stored under $BIZFLOW_HOME/bizflow/
themes/ where $BIZFLOW_HOME is the BizFlow server root directory.
Example: $BIZFLOW_HOME/bizflow/themes/fall/ contains the CSS and image files for the
theme “Fall”. Under each theme directory, there are separate CSS files for each locale.
1. To create and name the directory of your own theme, copy the directory of a an
existing theme – such as Fall – including its content, and rename the new
directory. The folder name should be one word, for example you could call it
mytheme:
$BIZFLOW_HOME/bizflow/themes/mytheme/
2. Within your new theme directory, locate the bizflow_xx.css file for each of the
locales that you use:
bizflow_en.css for English, bizflow_fr.css for French, bizflow_de.css for German,
bizflow_zh for Traditional Chinese, bizflow_ko for Korean, bizflow_ja for Japanese.
3. One at a time, open each of the CSS files in a text editor and modify it for your
new look and feel.
a. Only modify properties and values. DO NOT modify class names.
b. Save each CSS file when you are finished modifying it.
Note:
Unless you want to have a different look for each locale, remember to modify all the locale CSS
files the same way.
Adding Your Theme to the System
Open the bizcove_xx.xconf file XML file – under $BIZFLOW_HOME/bizflow/WEB-INF/ –
corresponding to each locale for which you have created a style sheet in a text editor so
that you can edit it. For example, if you are using the English locale, edit
bizcove_en.xconf for English and if you are using the French locale, edit bizcove_fr.xconf.
Notice that in the XML file there is a section that lists the themes that BizFlow uses. For
each one, the theme “listname” is the name that this theme is called in the list presented
October / 2004
55
BizFlow 9.0 BizCoves BluePrint
Look-and-feel Customization
to the user in the BizCove creation wizard and “name” is the name of the folder where
the image and CSS files that define the theme are found (the folder you just created.)
1. Add the following element as a child of <themes>:
<theme listname="<display_name>" name="<theme_folder_name>"/>
Replace <display_name> with the name that you want to call this theme. This
name will be displayed in a list to the user along with the other theme names. You
can call the theme whatever you want but it should be specific to the locale of
the XML file. For example, this would be My Theme in English or Mon Thème in
French.
Replace <theme_folder_name> with the same name that you named the folder
you created for your theme. This is not locale specific and will be the same no
matter which locale XML file you are editing. See Step 1 on page 55.
Final examples:
For the English locale (bizcove_en.xconf):
<themes>
<theme listname="default" name="default"/>
<theme listname="fall" name="fall"/>
<theme listname="winter" name="winter"/>
<theme listname="modern" name="modern"/>
<theme listname="fancy" name="fancy"/>
<theme listname="My Theme" name="mytheme"/>
</themes>
For the French local (bizcove_fr.xconf):
<themes>
<theme listname="Standard" name="default"/>
<theme listname="Automne" name="fall"/>
<theme listname="Hiver" name="winter"/>
<theme listname="Moderne" name="modern"/>
<theme listname="Elegant" name="fancy"/>
<theme listname="Mon Thème" name="mytheme"/>
</themes>
October / 2004
56
BizFlow 9.0 BizCoves BluePrint
Summary
Summary
BizCoves can be deployed in a number of ways including through the Internet, portals or
through BizFlow, giving users access to BizCoves where they are the most needed. There
are several methods and techniques that can be used to extend BizCoves. These
techniques can be used together or separately to provide customized BizCoves. The
point-and-click configuration options offered as a standard part of BizFlow enable you to
define many of the design and usability aspects of the BizCoves including the basic type
of BizCove, user interface theme and button format, how much information is shown and
how it is organized. More advanced techniques provide even more functionality such as
launching the BizCoves within a portal, applying a customized theme or style sheet so
that the BizCoves are more a part of a corporate look, and using conditional logic so
that the BizCove provides personalized information and functionality that is different for
each user who logs in.
October / 2004
57