Friday, November 18, 2016

Lesson 3: Create Process Application, BPD and Model Teams for Hiring Tutorials

Objective: The objective of this tutorial is to create the following components for the Hiring Tutorial requirements that will be implemented on IBM BPM on Cloud instance:
Create the process application
Create the Business Process Definition (BPD)
Model Teams
Note: This tutorial is an extract from the IBM material on Hiring Tutorials, which were additionally enhanced on specific points, wherever required.
 
Pre-requisites:
You must have Process Designer installed and running on your computer (Refer my Lesson 1 blog for more details). You must also understand the information in Process requirements (Refer Lesson 2 blog for more details).
 
Concepts:
Concept
Description
Process Application
A container in the Process Center repository that stores process models and supporting implementations. A process application typically includes business process definitions (BPDs), the services to handle implementation of activities and integration with other systems, and any other items that are required to run the processes. Each process application can include one or more tracks.
Process Center
A central repository for all project assets that are created in Process Designer. When multiple Process Designer clients connect to Process Center, users can share items, such as processes and services. Users can also see changes that other users make as they happen.
Process Designer
An authoring tool that you use to model and implement your business processes and demonstrate a process design and flow during development.

Details:

Create the process application:
1.  Login to BPM on Cloud (https://www.bpm.ibmcloud.com) with your login credentials. Go to IBM Process Center page. When Process Center page opens, the Process Apps page displays the list of process applications that are available in Process Center on the left hand side. These are the processes that are shipped with the product OR created by other users.
 
2.  Now click the +Create New Process App option on the right panel of Process Center.

3.  Enter the following information
Process App Name: My Hiring Sample 
Acronym: MHIS 
Description: Contains the process for filling a position.
Click Create. The process application is now in your list of process apps.

 Note:
Sometimes, the acronym value that you enter might already exists. If so, please change the value and try till you don’t get the red background.


4.  Click Create. The process application is now in your list of process apps. 


5.  To open the My Hiring Sample process application, locate the process application in Process Center and click Open in Designer. A Process Designer page opens, displaying the Process App Settings
 
6.  The following steps in this tutorial can be done either in cloud version OR in the Process Designer Desktop editor that you installed (in my previous Lesson 1 blog). Infact the Process Designer will be connected to cloud in the background. So the changes you made in the cloud will be now visible if you open your Process Designer. Now open the Process Designer Editor from your local machine, which it will ask your IBMId and password and once you provide the details, it will open with the following screen where you can see the Process App that you created in Cloud from the previous step.


7.  Now click the option “Open in Designer” and you will see the following screen:

Lesson checkpoint: 
You created a process application to contain the Standard HR Open New Position process.
In this lesson, so far, you learned:
- How to start Process Designer 
- How to create a process model container, which is known as the process application in Process Center 
- That your workspace is in Process Center 
- That the process application contains the process model that is created in Process Designer
Next, you will create a business process definition. 
Create the Business Process Definition (BPD):
8.  To create a model in the My Hiring Sample process application, you must create a BPD for the Standard HR Open New Position process. After you name the BPD, you model it by defining lanes and teams and then adding flow objects such as activities, events, and gateways.
Concept
Description
Business Process Definition
A reusable process diagram or model that defines what is common to all runtime instances of that process model.

9. Make sure that the My Hiring Sample (MHS) process application is open in the Process Designer desktop editor. 
10. In the Designer library, click the plus sign next to Processes and select Business Process Definition.
 

11. Type Standard HR Open New Position and click Finish.
 


12. The BPD is created and the process diagram opens showing the following modeling constructs:
 

Number
Area
Description
1
Main Tool bar
Provides access to Designer, Inspector, Optimizer, and Process Center. The main toolbar is also where you go to save all open editors, take a snapshot, and view web help.
2
Library
Provide access to library items for the current process implementation
3
Main Canvas
The area in which you can graphically model your process. Each BPD automatically includes a start event and an end event. Two default lanes are included for user and system tasks.
4
Palette
Provides elements that you can use to model your process. You can hide the palette by clicking the colored border to the left of the available elements. To restore the palette and view the available components, click the same border.

Model teams:
13.  Teams that are assigned to activities and lanes determine which users can work on tasks in IBM Process Portal. If a team is assigned to a lane, members of that team can work on all the tasks that are part of that lane.
14.  Based on the Process requirements, you must create a team for each of the identified user roles: hiring manager, general manager, and human resources manager. To model the teams, you add lanes and assign teams to the BPD. Each lane contains the activities that the associated team or system completes. You also define the teams by specifying the cost per hour, members, and managers.
15.  When you create a BPD, Process Designer generates two lanes: Team and System. For the Standard HR Open New Position BPD, you must have the following lanes and teams:
Lane
Team Title
Team Properties
Hiring Manager
Hiring Manager
Cost per Hour: 65.00, Members: Standard Members (tw_allusers), 
Managers: Managers of All Users
General Manager
General Managers
Cost per Hour: 75.00, Members: Standard Members (tw_allusers), Managers: Managers of All Users
Human Resources
Human Resource Managers
Cost per Hour: 50.00, Members: Standard Members (tw_allusers), Managers: Managers of All Users
System
System
Because the activities in the system lane are completed by the system, there is no associated team.

16.  The system lane contains the activities that IBM Business Process Manager completes.
Concept
Description
Lanes
Provide context for a process model. Each lane contains a series of activities that are assigned to a specific team or system.
Teams
Contain the members who complete the runtime activities that are modeled in each lane.
Members
User groups or individual users that are part of a team.
Managers
The team whose members can use the Team Performance dashboard in Process Portal to manage this team and its tasks.

Model the Teams:
17. Make sure that the Standard HR Open New Position process is open and the Diagram tab is selected. 
18. Click the Team lane and, in the Properties tab, change the name to Human Resources.

19. Create the HR Managers team: 
a. In the Behavior section of the team properties, for Default Lane Team click New. 
b. Type HRManagers for the name and click Finish

c. In the Simulation Properties section, for Cost per Hour type 50.00. 
d. In the Members section, click the list to select Standard Members. 
Note: The group tw_allusers is created automatically when you install IBM Business Process Manager. All registered users are part of tw_allusers.
e. Click Add group and select tw_allusers
f. In the Managers section, click Select and select Managers of All Users.
g. Click Save.
 
20. Click the back arrow to return to the Standard HR Open New Position process.


Tip: You can also click the list in the HRManagers field to view the artifacts that are open.
21. You are now back in the main canvas of the Standard HR Open New Position process.
22. Add a General Manager lane:
a. Drag a lane from the palette onto the diagram. 

b. Name the lane General Manager. 
c. In the Properties tab, select Blue from the Presentation Color list. Changing its color means that it is easier to distinguish this lane from other lanes in the diagram.


23. Create the General Managers team that is associated with the General Manager lane. Include the following properties: 
Name: GeneralManagers
Cost per Hour: 75.00 
Members: Standard Members (tw_allusers) 
Managers: Managers of All Users
24. Click Save to see the output as shown below.
25. In the Standard HR Open New Position diagram, add a Hiring Manager lane. Select Green from the Presentation Color list. 
26. Create the Hiring Managers team that is associated with the Hiring Manager lane. Include the following properties:  
Name: HiringManagers 
Cost per Hour: 65.00 
Members: Standard Members (group tw_allusers) 
Managers: Managers of All Users
27. Click Save to see the output as shown below.
28. In the Standard HR Open New Position diagram, click the System lane. In the Properties tab, select Purple from the Presentation Color list.
Tip: To reorder lanes, you can right-click a lane and select Move Lane Down until it is positioned where you want it. 
29. Your diagram matches the following image:

30. To view the teams you created, click Teams in the library.

Lesson checkpoint:
31. You modeled the teams and created the foundation for the BPD by adding the appropriate lanes and associating and defining teams.
32. In this lesson, you learned 
How to add lanes to a BPD 
How to associate a team to a lane 
How to define a team

What Next:
In the next lesson 4, you use sequence flows to connect the activities and events to establish the process flow for this Hiring Tutorials requirement.

 

Saturday, November 12, 2016

Lesson 2: Hiring Tutorial Requirements

Objective: The objective of this tutorial is to give overview on the Hiring Tutorial requirements that will be implemented on IBM BPM on Cloud instance.
Note: This tutorial is an extract from the IBM material on Hiring Tutorials, which were additionally enhanced on specific points, wherever required.
http://www.ibm.com/support/knowledgecenter/SSV2LR/com.ibm.wbpm.main.doc/tutorial/pdf/hiring_sample_pdf.pdf


Details:

General Overview of Hiring Tutorial:
1.  In this tutorial, you use the tools in IBM® Process Designer to re-create the Hiring Sample process application that is in IBM Process Center.
2.  This tutorial gets you started using Process Designer tool by having you iteratively model and test an instance of a hiring process. As you complete the lessons, you learn about Process Designer so that you can build your own processes.
Note: This tutorial is a learning exercise that describes one way of modelling, implementing, and testing a process. Depending on your process and process application, other techniques might be more appropriate.
3.  This tutorial contains the following modules: 
–Hiring tutorial: Model the process 
–Hiring tutorial: Implement the process 
–Hiring tutorial: create the user interface 
–Hiring tutorial: integrate the process with services 
–Hiring tutorial: Conduct the final playback
4.  After you complete this tutorial, you will be able to do the following tasks: 
–Model a process that is based on the process requirements. 
–Implement the process, including data variables and services that are required by the process. 
–Create the user interface for the process. 
–Conduct playbacks at each phase to validate the work that you completed. 
–Run and review the process.
5.  Each module in this tutorial contains lessons and builds on the previous module so that you can work with the tutorial from beginning to end.
Note: The process application that you are creating in this tutorial is called the My Hiring Sample, and the process application that is included in Process Center is called the Hiring Sample.

Hiring Tutorial Process Requirements:
1.  The process that you are going to model is called the Standard HR Open New Position process. This process covers how to fill a job position by submitting, approving, and routing a job requisition to the Human Resources (HR) department to search for job candidates.

2.  The Standard HR Open New Position process includes the following requirements: 
a) The following are the 3 parties that are involved in the requirements:
–Hiring Manager
–General Manager
–Human Resources
–Systems 

b) The following is the final Process Diagram that we are going to develop:

c) The Hiring Manager must either fill a new position or replace an employee who is departing from an existing position. 

d) The Hiring Manager must determine the position requirements and prepare a job requisition to be submitted to the HR department. For a new position, the hiring manager can provide the following information: 
– An ID for the job requisition
– Name of the hiring manager 
– Title of the position 
– Name of the department that requires the job requisition 
– Number of employees that are required to fill the position 
– Whether the job requisition is for a new or existing position 
– Whether the job is part-time, full-time, or contract 
– When the position starts 
– Where the position is located 

e) For an existing position, the hiring manager must provide the following information about the person who will be replaced: 
– First name 
– Last name 
– The person's manager or supervisor 
– The person's pay grade or level 
– The person's classification for taxation 
– Comments regarding the person 

f) The hiring manager reviews and approves the job requisition before the hiring procedure starts. 
– If the job requisition is to fill an existing position, the hiring manager must send the job requisition directly to HR. When HR receives the job requisition, they search for candidates. 
– If the job request is to fill a new position, the hiring manager must send it to the general manager (GM) for approval. 
g) The GM must evaluate the job requisition and either approve or reject it. 
– If the GM approves the job requisition, it then goes to HR so that HR can find job candidates. 
– If the GM rejects the job requisition, the hiring manager is notified and the job requisition process is terminated. 
– If the GM does not handle the request by the due date, the GM is notified.
 
What Next:
In the next lesson 3, you will understand how to create Process Application, Business Process Definition (BPD), Model Teams for the Hiring Tutorials requirement.

Lesson 1: IBM BPM on Cloud Free Trial Setup

Objective: The objective of this blog is to give overview on the initial steps to create the IBM BPM on Cloud free trial account (valid for 30 days), how to download and install the Process Designer module from cloud, common issues and resolution in this process.

Details:
1.  Create a free trial id with IBM BPM Cloud by logging into the below URL and click the button “Try for Free”. 
https://www.bpm.ibmcloud.com/

2.  It will open a registration form, as shown below and fill the form with all the required details.

3.  Fill out the registration form and submit. You might have to create the IBMId, if it is not available. You will get an email with the activation code, which need to be entered to activate the IBMId and BPM Cloud account.

4.  Now login to IBM BPM with your IBMId (email id) credentials from the following URL:
https://www.bpm.ibmcloud.com/#login

5.  You will be taken to the following IBM BPM on Cloud Home Page. There are two menu options – Learn and Work. By default, you will be in the Learn tab.

6.  Learn Tab: 
If you are new to BPM, you can learn from the videos available under:
  a. BPM101 – which will have videos covering the basics of BPM
  b. Tutorials – which will have the videos covering the Hiring Tutorials
  c.  Samples – which will have the videos covering the Industry Accelerators

7.  Work Tab:
This is where you do all the development work. It has 3 tabs:
a) Development:
This is the Development Environment, where you primarily use the modules of Process Center, Process Portal.

b) Test:
This is the Test Environment, where you do the testing and use the modules of Process Portal, Process Admin Console.

c) Process Runtime:
This is the Production Environment, where you finally host the modules, once they are tested thoroughly. 

8.  Download of IBM Process Designer:
a) Incase if you don’t have the IBM Process Designer module already downloaded, you can download the same from the Process Center under Development tab, as highlighted below.

b) Once you click the link, it will download the zip file IBM Process Designer.zip. Once it is downloaded, you can copy the entire zip in a new folder (let’s say C:\IBM_Process_Designer) and unzip it.

c) Now click the file installProcessDesigner_admin.bat, which will open the command prompt and install the Process Designer under C:\IBM folder. Incase, if you would like to install the Process Designer in some other location, open the command prompt and invoke the bat file with path parameter.
installProcessDesigner_admin.bat "D:\Process Designer\"
d) In my case, I am going with the default path of C:\IBM, once the process Designer is installed, you will see the following folders created.

e) You will find the eclipse.exe in the path C:\IBM\ProcessDesigner\v8.5 



f) Once you click the eclipse.exe, it will try to open the Process Designer as follows:

g) You will be asked to enter the IBM BPM On Cloud user id, which will be your free trial user id. Enter the user id and then click “Continue” button.

h) You will now asked to enter the IBM id. Enter the IBM Id and password and click “Sign in” button.

i) You will get the following Getting Started Screen, which you can close it.

j) You will see the following Process Apps screen

9.  Access of Process Center from the BPM on Cloud and common issue you might face:
a) Now launch the Process Center from Development Tab in IBM BPM Cloud 

b) Common issues faced:
i) When I logged in to Process Center cloud module for the first time, the option of +Create New Process App listed on the right hand corner was not available.
ii) Also when I click the “Open In Designer” across the module "Hiring Sample (HSS)", I was getting the following error message:

Error:
You do not have permission to access this process application. To access a process application or toolkit, you must have Read permission and be part of the bpmAuthorGroup (tw_authors by default). Contact your administrator for access.

Fix:
You need to send an email on this to SupportBPMonCloud@us.ibm.com, stating the above problem along with your IBM On Cloud user id details. Usually, you will get a response back in a day or two informing this issue is resolved. 
iii) Also I was not getting the “Admin” menu in the top (after “Servers”). 
No fix for this. It seems the Admin option will not be visible in Free trial.