k2 designer for sharepoint hands-on exercise - leave request...
TRANSCRIPT
© SourceCode Technology Holdings, Inc. All Rights Reserved.
K2 Designer for SharePoint Hands-On Exercise - Leave Request process
This hands-on learning module will guide process designers through creating a list-item based workflow using the K2 Designer for SharePoint
Contents
Module Overview ................................................................................................................................... 4
Scenario and Requirements .................................................................................................................. 7
LAB 1: Review the Process Design document ...................................................................................... 9
LAB 2: Assemble, deploy and test the Leave Request process ......................................................... 11
REVIEW and Q&A ............................................................................................................................... 24
100.HNL100-JNB Version: 1 Revision: 3
100.HNL - K2 Designer for SharePoint Hands-On Exercise - Leave Request process
Module Overview
© SourceCode Technology Holdings, Inc. All Rights Reserved Page 2
--c8Lvz-t0O13ncjCBt3lA
The information contained in this document and its associated resources, including uniform resource locators and identifiers, is subject to
change without notice.
Unless explicitly stated otherwise, the people, organizations, companies, places, domain names, e-mail addresses, products, logos, and events
depicted are fictitious and no association with any actual people, organizations, companies, places, domain names, e-mail addresses, products,
logos, and events is intended, or should be inferred under any circumstance.
SourceCode may have patents, patent applications, trademarks, copyrights, and/or other intellectual property rights covering all or part of the
subject matter in this document and its associated resources. Except as expressly permitted by license agreement with SourceCode
Technology Holdings, Inc. the furnishing of this document and associated resources, does not grant any license whatsoever to these patents,
trademarks, copyrights, and/or other intellectual property.
This document and its associated resources are the sole property of SourceCode Technology Holdings, Inc. and SourceCode reserves all rights
related to the information contained herein. Without limiting rights under copyright, no part of this document or its associated resources, may be
reproduced, stored or introduced into a retrieval system, or transmitted in any form or by any means, without the prior written consent of
SourceCode Technology Holdings, Inc.
Copyright © 2011. SourceCode Technology Holdings, Inc. All rights reserved. SourceCode software products are protected by one or more U.S.
Patents. Other patents pending. SourceCode, K2, K2 blackpearl, K2 blackpoint, K2 connect, the four squares logo and K2 logotype are
registered trademarks or trademarks of SourceCode Technology Holdings, Inc. in the United States and/or other countries
The names of actual companies and products mentioned herein may be the trademarks of their respective owners.
Distribution Information Organization K2
Date Tuesday, June 26, 2012
Email [email protected]
Questions, Comments or Feedback about this training module?
Please E-mail [email protected] with your comments or feedback. We appreciate any feedback that helps us to
improve the quality of our learning material.
100.HNL - K2 Designer for SharePoint Hands-On Exercise - Leave Request process
Module Overview
© SourceCode Technology Holdings, Inc. All Rights Reserved Page 3
--c8Lvz-t0O13ncjCBt3lA
Conventions The following table documents the conventions used throughout this module:
Convention Description
Bold Text With Border Represents commands, controls, items, menus, options, parameters, and file and folder paths. For example, in an instruction to click on the
OK button; look for a control on the page with OK as its name.
When you see text represented like this, you should see a control, window or field on the user interface with the same name.
Fixed-pitch font Represents text (or code) that must be entered exactly as shown. When you see text represented in this style, you should be typing this text into a textbox, control, code window or other UI component.
[Italic text in Square
Brackets]
Represents variables or values to be selected from the K2 Context browser
<ALL CAPITALS> Represents a key to be pressed on the keyboard. For example, <CTRL> represents the Control key on the keyboard.
Represents a best practice. Best practices are the recommended approach or guidance for specific scenarios. When you see the Best Practice icon, consider how this practice impacts your requirements or how you can implement this practice in your environment.
Represents important information. Important information is highlighted in order to draw attention to a key piece of information, and typically serves as a warning or point you should bear in mind when using the K2 platform in your K2 solutions.
Represents a note. Notes explain a topic or provide additional information, and can provide a summary or explanatory point about a topic.
Explains a concept, or a provides an explanation for a step in an exercise
Represents a hint, tip or available tools and resources that can help you during the design and development cycles of a K2 solution.
Represents trivia. The text included next to this icon is for interest only – think of it as a quick break from learning about K2.
Indicates an estimate time to complete an exercise, step or discussion.
100.HNL - K2 Designer for SharePoint Hands-On Exercise - Leave Request process
Module Overview
© SourceCode Technology Holdings, Inc. All Rights Reserved Page 4
--c8Lvz-t0O13ncjCBt3lA
Module Overview This module is a practical, hands-on exercise module which guides process designers through designing a K2
process using the K2 Designer for SharePoint. The process is based on a SharePoint list item, and will utilize the
Generated Forms approach for user interfaces. Participants will apply the process development principles
discussed in the K2 Learning module 100.LAX - K2 Designer for SharePoint – Fundamentals to implement a
“Leave Request Approval process” scenario.
Target Audience This module is intended for users who will design K2 processes using the K2 Designer for SharePoint.
Outcomes At the end of this module, you will be able to design a SharePoint list-item based workflow using the K2 Designer
for SharePoint. You will understand how to interact with SharePoint list items as part of a K2 process.
Complexity This Course Level Definition
100 Introduction to the topic or overview and assumes little or no expertise with the topic being covered. Typically level 100 modules cover concepts, functions, features and benefits.
200 Covers intermediate learning materials and assumes 100-level knowledge and provides specific details about
the topic and a fairly complete understanding of the features. 200-level training may discuss case studies that cover a breadth of common scenarios or explain how to use more advanced features.
300 Covers advanced learning materials and assumes 200-level knowledge, and an in-depth understanding of product features in a real-world environment. 300-level training provides a detailed technical subset of product technologies that illustrate specific aspects of the product that are key to improving performance or interoperability and include architecture, performance, migration, development and deployment.
400 Expert learning materials and assumes a deep level of technical knowledge and experience, as well as a detailed, thorough understanding of the topic. 400-level courses are essentially expert-to-expert sessions and the 400-level training content provides the means for customers to push products to maximum performance, achieve the broadest possible interoperability and create applications using the most advanced features.
Prerequisites and Required Knowledge To successfully complete this module, you should have covered the K2 Learning modules listed below (or have
sufficient experience with the K2 platform to be familiar with the topics covered in the listed modules).
Reference Module Name Important topics (if applicable)
100.LAX K2 Designer for SharePoint – Fundamentals
Designing, assembling, deploying and testing list-item based processes using the K2 Designer for SharePoint
This learning module also refers to (or uses) other technologies. Because the purpose of this module is not to
instruct you on these other technologies, you should be familiar with the technologies, systems or approaches
listed below (to the required level of proficiency) in order to successfully complete this learning module.
Skill or Technology Proficiency
100.HNL - K2 Designer for SharePoint Hands-On Exercise - Leave Request process
Module Overview
© SourceCode Technology Holdings, Inc. All Rights Reserved Page 5
--c8Lvz-t0O13ncjCBt3lA
Skill or Technology Proficiency
Microsoft SharePoint (2007 or 2010) Intermediate
Understand SharePoint terms like sites, lists and libraries
Able to create new lists and libraries in SharePoint
Know how to interact with list items and documents in SharePoint
Understand basic SharePoint Security concepts
Compatibility This learning module is compatible with the following K2 products and versions
These are the minimum compatibility requirements for this learning module. Earlier and later updates to the listed products may include, exclude or change the available components, screen layouts or product configuration.
Product
Version
Notes
K2 blackpearl 4.5 with Update 1370
K2 blackpoint 4.5 with update 1370
100.HNL - K2 Designer for SharePoint Hands-On Exercise - Leave Request process
Module Overview
© SourceCode Technology Holdings, Inc. All Rights Reserved Page 6
--c8Lvz-t0O13ncjCBt3lA
Virtual Environment Prerequisites This learning module has prerequisites which need to be configured to support the lab exercises. Follow the
instructions below to set up the necessary prerequisites for this learning module.
This script should be executed in the Virtual Server environment which accompanies this learning module. The script is only compatible with the following virtual server images provided by K2: K2 blackpearl Solutions Version 3 (upgraded to K2 4.5 update 1420)
K2 blackpearl 4.1.x
K2 blackpearl 5.1.x
K2 blackpoint Solutions Version 3 (upgraded to K2 4.5 update 1420)
K2 blackpoint 4.1.x
K2 blackpoint 5.1.x
Step Instructions
Step 1: Install the prerequisites for this training module in the Virtual Server environment
A script is provided that will create all the necessary prerequisites for this module.
Tasks:
1. Copy the file K2 Learning -100.HNL.exe provided with this learning module to any
location in the Virtual Server environment. You may download this installer from the
K2 Learning Module Installers (Download) shortcut on the Virtual Environment
desktop, or directly from the following URL: ftp://K2LearningInstallers:[email protected]/K2 Learning-
100.HNL.exe
Ask your instructor for help, if needed.
2. Double-click the file K2 Learning -100.HNL.exe to start the extract process. You
should extract the files to
C:\K2 Learning (this value should be set correctly by default)
3. After the extract process has completed, double-click the file
C:\K2 Learning\100.HNL\Setup\SetupPreRequisites.bat to install and deploy the
prerequisites for this training module. The installation process may take up to 5 minutes to complete
4. Once you see the success message (Completed setting up prerequisites for
learning module…) close the command window.
100.HNL - K2 Designer for SharePoint Hands-On Exercise - Leave Request process
Scenario and Requirements
© SourceCode Technology Holdings, Inc. All Rights Reserved Page 7
--c8Lvz-t0O13ncjCBt3lA
Scenario and Requirements
In this module, you will implement a leave Request process. As a starting point, we have gathered some
requirements from the business before starting the process design and discovery phase.
The business has requested an automated leave approval process
All leave requests will be approved by the employee’s manager
A SharePoint-based calendar should display all employee leave requests, both pending and approved
Denied leave requests should not appear in the calendar
Human Resources will manually capture the employee’s leave details into the HR system – no automatic
integration is required
The employee should be notified of the approval decisions via email
If the approval step has not completed within 2 days before the leave is due to start, remind the originator to
follow up
The requirements listed are typical of a simple process. Based on the business requirements, we have selected the
K2 Designer for SharePoint to build the process, and SharePoint lists will be used to store the data for the request.
Typically, the selected implementation mechanism (in other words, which K2 design tool to use, where to store the data, how to integrate with external systems and so on) is made after the process design and discovery is completed. Process design may raise requirements that cannot be implemented in a particular technology, so the selection of the technology should only be made once design and discovery is completed. When phasing in functionality over several versions of a process, it is a good idea to select the appropriate design tool from the start, since this will make things a little easier when new functionality needs to be added to new versions of the process. K2 processes are portable between designers though, so a process designed in K2 Designer for SharePoint can be extended in K2 Studio or the K2 Designer for Visual Studio design tools.
Scenario and Requirements
The business has requested an automated leave approval process
All leave requests will be approved by the employee’s manager
A SharePoint-based calendar should display all employee leave
requests, both pending and approved
Denied leave requests should not appear in the calendar
Human Resources will manually capture the employee’s leave
details into the HR system – no automatic integration is required
The employee should be notified of the approval decisions via email
If the approval step has not completed within 2 days before the
leave is due to start, remind the origonator to follow up
100.HNL - K2 Designer for SharePoint Hands-On Exercise - Leave Request process
Scenario and Requirements
© SourceCode Technology Holdings, Inc. All Rights Reserved Page 8
--c8Lvz-t0O13ncjCBt3lA
During the process discovery and design phase, a visual representation of the process was created and is shown
below:
This process map will be used as the base for building the process in the K2 Designer for SharePoint.
100.HNL - K2 Designer for SharePoint Hands-On Exercise - Leave Request process
LAB 1: Review the Process Design document
© SourceCode Technology Holdings, Inc. All Rights Reserved Page 9
--c8Lvz-t0O13ncjCBt3lA
LAB 1: Review the Process Design document
Objective In this lab, you will review a process design document to understand how requirements and specifications for a K2
process can be gathered and documented.
If you are performing this lab as part of a group, feel free to discuss the process requirements and design
document.
Duration This lab has one part and should take around 10 minutes to complete.
Context The organization wants to implement an automated Leave Request approval process. The initial version is fairly
straightforward: there needs to be a calendar of leave requests so that other employees can see who will be on
leave and when. Managers will approve and deny leave requests, and HR will manually capture leave request
information into the HR system
In future version of the process, the organization may use more complex user interfaces and integrate
automatically with the HR system to remove the manual HR user step from the process, but for now, the simplified
implementation is sufficient for the first version of the process.
LAB 1: Review the Process Design document
This lab comprises 1 part and should take around 10 minutes
to complete
In this lab
exercise, you will
review the design
specification
document for the
Leave Request
approval process
described in the
scenario.
100.HNL - K2 Designer for SharePoint Hands-On Exercise - Leave Request process
LAB 1: Review the Process Design document
© SourceCode Technology Holdings, Inc. All Rights Reserved Page 10
--c8Lvz-t0O13ncjCBt3lA
Lab Part 1: Review the Process Design document Step Instructions
Step 1: Install the prerequisites
Tasks:
1. If you have not already done so, follow the instructions under the heading Virtual Environment Prerequisites at the start of this document to install the required SharePoint items for this learning module.
Step 2: Review the process design document
Task:
1. Review the process design document located at C:\K2 Learning\100.HNL\LAB 1\
100.HNL LAB 1 - Process Design Document.docx
2. Feel free to discuss the process design and the process requirements within your group.
Part 1 Complete!
The next lab exercise will cover the assembly, deployment and testing of the process.
100.HNL - K2 Designer for SharePoint Hands-On Exercise - Leave Request process
LAB 2: Assemble, deploy and test the Leave Request process
© SourceCode Technology Holdings, Inc. All Rights Reserved Page 11
--c8Lvz-t0O13ncjCBt3lA
LAB 2: Assemble, deploy and test the Leave Request process
Objective In this lab, you will implement the Leave Request process described in the process design document.
This lab will cover the following concepts:
Starting a process when a new SharePoint list item is created
Updating and creating SharePoint list items during a process
Configuring user steps
Sending emails during a process
Parallel paths in a process
Simple escalations
Using an inline function to calculate an escalation date
Duration This lab has three parts and should take around 30 minutes to complete.
1. Prepare the prerequisites for creating the process. 2. Use the K2 Designer for SharePoint to assemble the process 3. Deploy and test the K2 process
Context Since the process discovery and design phase is complete, we can now being to implement the Leave Request
approval process, using the process design document reviewed in the previous lab as a guideline.
Lab Part 1: Set up and review the prerequisites Step Instructions
Step 1: Tasks:
LAB 2: Create the Leave Request approval
process
This lab comprises 4 parts and should take around 30 minutes
to complete
In this lab
exercise, you will
design, assemble,
deploy and test
the Leave Request
Approval process
100.HNL - K2 Designer for SharePoint Hands-On Exercise - Leave Request process
LAB 2: Assemble, deploy and test the Leave Request process
© SourceCode Technology Holdings, Inc. All Rights Reserved Page 12
--c8Lvz-t0O13ncjCBt3lA
Step Instructions
Install the prerequisites
1. If you have not already done so, Follow the instructions under the heading Virtual Environment Prerequisites at the start of this document to install the required SharePoint items for this learning module.
Step 2: Review the prerequisites
Tasks:
1. Using Internet Explorer, browse to the site: http://portal.denallix.com/K2Learning/100.HNL
2. Review the layout of this site. There is a leave calendar list that will display leave
requests, and a K2 Worklist Web Part to display K2 tasks. A K2 Process Portal subsite also exists for this site.
Part 2: Assemble the Leave Request Process Step Instructions
Step 1: Create the new process from the originating SharePoint list
We will create the K2 process from the Leave Calendar list. When a user enters a new leave request, the process will automatically start.
Task:
1. Create a new K2 process in the 100.HNL Leave Request Calendar list and configure the
process properties
2. Configure the process security Step-By-Step Walkthrough:
a) Open the List Settings for the SharePoint list 100.HNL Leave Request Calendar
b) In the list settings, locate the K2 Process icon in the ribbon, and click it to start designing a
new K2 process
c) Once the K2 dialog box has loaded, click on the Create a new Process option to create the
new process.
d) On the process settings screen, provide the process general properties using the table below
Name 100HNL–LAB2 – Leave Request Approval
Description Leave Request Approval
Category K2Learning
Start Option Start Process when an item is created
Folio [Title]
e) Click on Next button to continue to the next screen. Since we don’t need to add additional
fields and cannot set the process start screen options, keep clicking Next until you get to the
Process Rights screen.
f) On the Process Rights screen, configure process rights as specified by the design
document:
Administrator Admin and View
Denallix\Human Resources
Start and View
Domain Users: Start and View Participate
SP Web Service Start and View Participate
Step 2: Add a step to update the original
Task:
1. Create a new step which updates the Title and status of the original calendar list item
100.HNL - K2 Designer for SharePoint Hands-On Exercise - Leave Request process
LAB 2: Assemble, deploy and test the Leave Request process
© SourceCode Technology Holdings, Inc. All Rights Reserved Page 13
--c8Lvz-t0O13ncjCBt3lA
Step Instructions
calendar item title and status
After the process has started, we want to update the calendar item with the originator’s name and set the item’s status to Pending.
Step Name Update List Item
Outcomes Continue
SharePoint List Item Changes
Title [Originator Full Name] – [Leave Type] (Pending Approval)
Status Pending
Step-By-Step Walkthrough: a) In the ribbon at the top of the screen, click on the Step category drop-down menu and select
the Lists item, since we want to interact with a SharePoint list item in this step.
b) In the list of available steps, locate the Edit List Item step, and drag it into the new step that
was just created after the Start step. A wizard screen will pop up – it may take a few seconds to populate fully.
c) In the list of available columns, scroll down to find the Title column, select the Update
checkbox and drag items from the Context Browser into the Title textbox [Originator Full Name] (from process context) – [Leave Type] (from SharePoint columns
context) (Pending Approval (hardcoded value))
d) Select the Status column checkbox and then select Pending from the drop-down menu.
The wizard screen should look something like this
e) Click the OK button to finish the wizard
Step 3: Add a step to set the process Folio
We want to give a user-friendly reference to the process instance, which includes the originators name and leave type
Task:
1. Create a new step which updates the Folio of the process
Step Name Set Folio
Outcomes Continue
Folio Value [Originator Full Name] – [Leave Type]
Step-By-Step Walkthrough:
a) On the Process designer, hover over the Update List Item event that we created in the
previous step, and click the icon to create a new outcome for the step
b) In the Workflow Step Outcomes screen, click the Add button to add a new outcome
c) Change the name of the outcome to Continue and then click the OK button
d) In the ribbon at the top of the screen, click on the Step category drop-down menu and select
the General item.
e) In the list of available steps, locate the Set Folio step, and drag it into the new step that was
100.HNL - K2 Designer for SharePoint Hands-On Exercise - Leave Request process
LAB 2: Assemble, deploy and test the Leave Request process
© SourceCode Technology Holdings, Inc. All Rights Reserved Page 14
--c8Lvz-t0O13ncjCBt3lA
Step Instructions
just created after the Update List Item step. A wizard screen will pop up.
f) Using the context browser, configure the value for the process folio as follows:
[Originator Full Name] (from Process context) – [Leave Type] (from SharePoint Context)
g) Click the OK button to complete the wizard.
Step 4: Add the approval step and its outcomes to the process according to the process design document
The process will divide into parallel paths if the request is approved, so we will manually add an additional outcome to the process
Task:
1. Add the manager approval User Task and configure the step as described in the process design document.
Step-By-Step Walkthrough:
a) Add a new outcome to the Set Folio step that you just created.
b) From the ribbon toolbar, drag a User Task into the new step that was created. In the first
screen of the wizard, configure the user task as follows
Name Approve Request
Instruction Please approve or deny the leave request
Actions Approve
Deny
c) Click Next to continue to the Outcomes screen.
d) There are two auto-generated outcomes on the Outcomes screen. Click Add to add a third
outcome. Rename the new outcome to Approved-2
e) Select the checkbox next to the new outcome you just created, and then click the Edit button
to edit the outcome. We have to provide a rule of the outcome, because we only want to follow this outcome if the approver approved the request.
f) On the Outcome Rules screen, click the Add Action statement button to start defining the
rule. The rule will default to One participant(s) selected the Approved action. This is what we
want, so click the OK button to apply the new rule.
g) You should now see three outcomes on the Approval step. Rename the two approval
outcomes to Approval-1 and Approval-2 for clarity. Click Next to continue to the User
Form screen.
h) Using the context browser, drag fields from the SharePoint context onto the user form, and
configure them as shown:
Field Required Read-Only
[Title] X
[Leave Type] X
100.HNL - K2 Designer for SharePoint Hands-On Exercise - Leave Request process
LAB 2: Assemble, deploy and test the Leave Request process
© SourceCode Technology Holdings, Inc. All Rights Reserved Page 15
--c8Lvz-t0O13ncjCBt3lA
Step Instructions
[Start Date] X
[End Date] X
i) Click Next to continue to the Participants screen, and then drag Manager from the context
browser into the default task group. Select the checkbox next to Notify recipients… since we
will send a customized email notification to the manager.
j) On the Event Notification Settings screen, configure the email to include fields form the context browser. You should be familiar enough with the context browser to locate the various fields in the different categories.
Subject: New leave request - Approval required
Message: Dear [Participant Name] A new leave request has been submitted by [Originator Full Name] for [Leave Type] from [Start Date] until [End Date] To check the current leave calendar, click here: [link to 100.HNL SharePoint Site] (Hint: you can drag items from the “SharePoint sites” category onto the email body) Please approve or deny the leave request using the link below: [Link to task item]
k) Click Finish to complete the wizard. You should see that three outcomes flow out of the
Approve request step.
Step 5: Create the “Send Denied notification” email step
Task:
1. Add the Denied notification to the process (attached to the “Deny” outcome from the Approval step) and configure the step with the following properties
Name Send Denied notification
Outcomes Continue
Email Content
From: [email protected]
To: [Originator]
Subject: Leave Request Denied
Message: Dear [User] Your request for [Type of Leave] from [Start Date] to [End Date] has been denied by your manager.
Step-By-Step Walkthrough:
a) Drag a Send Email task into the blank step that is connected to the Denied outcome of the
Approval step.
b) Use the following table to configure the email wizard. Note the use of items from the context browser.
From: [email protected]
To: [Originator]
Subject: Leave Request Denied
100.HNL - K2 Designer for SharePoint Hands-On Exercise - Leave Request process
LAB 2: Assemble, deploy and test the Leave Request process
© SourceCode Technology Holdings, Inc. All Rights Reserved Page 16
--c8Lvz-t0O13ncjCBt3lA
Step Instructions
Message: Dear [User] Your request for [Type of Leave] from [Start Date] to [End Date] has been denied by your manager.
c) Click Finish to complete the wizard.
d) Double-click the newly added step and rename the step to Send Denied Notification
Step 6: Delete the original list item
Task:
1. Add a new step after the Send Denied notification step which deletes the original leave
request calendar entry.
Step-By-Step Walkthrough:
a) Add a new outcome to the Send Denied notification step.
b) In the ribbon toolbar, switch to the Lists category, and then drag the Delete list item task
into the new blank step you just added. This wizard will automatically delete the current list item, so no configuration is required.
Step 7: Create a step which set the status of the original list item to
Approved
Task:
1. Create a new step in one of the parallel Approve outcomes, which updates the Title and
status of the original calendar list item
Step Name Update List Item status
Outcomes Continue
SharePoint List Item Changes
Title [Originator Full Name] – [Leave Type]
Status Approved
Step-By-Step Walkthrough:
a) Drag the Edit List item step into a blank step connected to either of the Approval outcomes
of the Approve request task.
b) Configure the list item as shown below.
Title [Originator Full Name] – [Leave Type]
Status Approved
c) Click OK to complete the wizard.
d) Double-click the new step, and change the name of the step to Update List Item status
Step 8: Create the “Send Approved notification” email step
Task:
1. Add the Approved notification to the process and configure the step with the following properties
Name Send Approved notification
Outcomes Continue
Email Content
From: [email protected]
100.HNL - K2 Designer for SharePoint Hands-On Exercise - Leave Request process
LAB 2: Assemble, deploy and test the Leave Request process
© SourceCode Technology Holdings, Inc. All Rights Reserved Page 17
--c8Lvz-t0O13ncjCBt3lA
Step Instructions
To: [Originator]
Subject: Leave Request Approved
Message: Dear [User] Your request for [Type of Leave] from [Start Date] to [End Date] has been approved by your manager.
Step-By-Step Walkthrough:
a) Add a new outcome to the Update List Item status step you just created.
b) Drag a Send Email task into the new blank step that was created.
c) Use the following table to configure the email wizard. Note the use of items from the context browser.
From: [email protected]
To: [Originator]
Subject: Leave Request Approved
Message: Dear [User] Your request for [Type of Leave] from [Start Date] to [End Date] has been approved by your manager.
d) Click Finish to complete the wizard.
e) Rename the step to Send Approved Notification
Step 9:
Add the Capture
Leave Details
step and its outcomes to the process according to the process design document
The process will complete after this step, so you can delete the outcome from this step.
Task:
1. Add the Capture Leave Details User Task and configure the step with the following properties
Name Capture Leave Details
Instruction Please update the HR system with the approved leave request
information below
Actions Task Completed
Outcomes (End Process)
Participants HR Department
User Form Fields
Field Required Read-Only
[Title] X
[Leave Type] X
[Start Date] X
[End Date] X
Notification Yes (customized notification message)
Customized Notification text
Subject: Approved Leave Request – please capture leave
request details
100.HNL - K2 Designer for SharePoint Hands-On Exercise - Leave Request process
LAB 2: Assemble, deploy and test the Leave Request process
© SourceCode Technology Holdings, Inc. All Rights Reserved Page 18
--c8Lvz-t0O13ncjCBt3lA
Step Instructions
Message: A new leave request has been approved for [Originator Full Name] for [Leave Type] from [Start Date] until [End Date]
Please open the leave request information screen using the link below, capture the leave request details in the HR system, and complete the task [Link to task item]
Step-By-Step Walkthrough:
a) Drag a User Task step into the other parallel Approval path of the process.
b) Configure the first screen of the wizard as follows
Name Capture Leave Details
Instruction Please update the HR system with the approved leave request
information below
Actions Task Completed
c) Click Next to continue to the Outcomes screen.
d) Delete the default outcome that was created, since the process will end after HR has
completed their task.
e) Using the context browser, drag fields from the SharePoint context onto the user form, and configure them as shown:
Field Required Read-Only
[Title] X
[Leave Type] X
[Start Date] X
[End Date] X
f) Click Next to continue to the Participants screen, and then search for the Human Resources
group in the context browser (remember to use the icon to change the search scope to
Group).
Drag the group into the default task group, and select the checkbox next to Notify
recipients… since we will send a customized email notification to the manager.
g) On the Event Notification Settings screen, configure the email to include fields from the
context browser. You should be familiar enough with the context browser to locate the various fields in the different categories.
Subject: Approved Leave Request – please capture leave request
details
Message: A new leave request has been approved for [Originator Full Name]
for [Leave Type] from [Start Date] until [End Date] Please open the leave request information screen using the
link below, capture the leave request details in the HR
system, and complete the task
[Link to task item]
100.HNL - K2 Designer for SharePoint Hands-On Exercise - Leave Request process
LAB 2: Assemble, deploy and test the Leave Request process
© SourceCode Technology Holdings, Inc. All Rights Reserved Page 19
--c8Lvz-t0O13ncjCBt3lA
Step Instructions
h) Click Finish to complete the wizard
Step 10: Add an escalation to the Approval step
We will use an inline function to calculate a value for the escalation date.
Task:
1. Add an escalation to the Approval step as described in the process design document
Name Remind originator
Escalation Type E-mail
Escalate On [2 days before the leave start date]
Escalation Email Settings
From: [email protected]
To: [Originator]
Subject: Leave Request - no approval action taken yet
Message: Dear [User]
Your request for [Leave Type] from [Start Date] to
[End Date] has not been approved yet. Please follow up on the approval status with
your manager
Step-By-Step Walkthrough:
a) Right-click on the Approve Request step in the process, and select Escalations
b) Click on the Add button to add a new escalation
c) Set the escalation name to Remind Originator and the Escalation type to E-Mail
d) Expand the Context Browser’s Inline Functions Category, then expand Date and Time and
then drag the Add Days function into the Escalate On textbox.
e) The inline function wizard will launch. Configure the wizard to subtract 2 days from the leave start date, as shown below
100.HNL - K2 Designer for SharePoint Hands-On Exercise - Leave Request process
LAB 2: Assemble, deploy and test the Leave Request process
© SourceCode Technology Holdings, Inc. All Rights Reserved Page 20
--c8Lvz-t0O13ncjCBt3lA
Step Instructions
f) Click the OK button to complete the inline function configuration screen
g) Click the Next button to continue to the email notification configuration screen.
h) Configure the email as specified in the table below
From: [email protected]
To: [Originator]
Subject: Leave Request - no approval action taken yet
Message: Dear [User]
Your request for [Leave Type] from [Start Date] to [End Date] has not been approved yet.
Please follow up on the approval status with your manager
i) Click Finish to complete the wizard screen.
j) Click on OK to close the escalations screen.
Part 2 complete!
You have completed the required steps to assemble the process - you process should look similar to the screenshot
below
Leave the K2 designer open, since you will use it in the next part to deploy the process.
100.HNL - K2 Designer for SharePoint Hands-On Exercise - Leave Request process
LAB 2: Assemble, deploy and test the Leave Request process
© SourceCode Technology Holdings, Inc. All Rights Reserved Page 21
--c8Lvz-t0O13ncjCBt3lA
Lab Part 3: Deploy and Test the process Step Instructions
Step 1: Deploy the process designed in the previous Lab exercise
Task:
1. Deploy the K2 process assembled in Part 2 of this lab.
Step-By-Step Walkthrough:
a) In the process designer, click on File and then select Deploy to deploy the process.
b) Wait for the process build to complete, and click next to deploy the process.
Step 2: Add the process to a K2 process portal site
Task:
1. Add the process to the existing K2 process portal site located at http://portal.denallix.com/K2Learning/100.HNL/100.HNL.K2ProcessPortalSite
Step-By-Step Walkthrough:
a) Click the web browser’s Back button to exit the designer, Click OK to acknowledge the
warning message.
b) Browse to the K2 process portal site called 100.HNL.K2ProcessPortalSite
c) In the bottom left-hand corner of the screen, click on the Settings link to open the settings
screen.
d) Click the Show All link to show all processes, and then click the checkbox next to the new
process you just created K2Learning\100HNL-LAB2 – Leave Request Approval
e) Click the OK button to save your change
Testing the process
The process is ready to be tested. The following steps will not describe every task step-by-step, since may steps use technologies and interfaces you will already be familiar with. Step-by-step guides will only be provided where new functionality or complex tasks are described.
Step 3: Register a new leave request
Task:
1. Using Administrator’s Internet Explorer, browse to the site http://portal.denallix.com/K2Learning/100.HNL
2. Use the Submit Leave Request link on the SharePoint site to register a new leave
request. Use a start and end date within the current month for the leave request, and select any category you wish.
Step 4: Approve the leave request
Task:
1. Open William’s browser, and open the SharePoint site at http://portal.denallix.com/K2Learning/100.HNL
2. Notice that the leave request has been added to the leave calendar, but with a “Pending” status.
3. Using the K2 task list on the site, open the Leave Request approval task and approve the
leave request
Step 5: Confirm that the Leave request is approved
Task:
1. Open Administrator’s Outlook and confirm that a Leave Request Approved email was
received
2. If you selected a leave start date within 2 days from today, you should also see an alert
100.HNL - K2 Designer for SharePoint Hands-On Exercise - Leave Request process
LAB 2: Assemble, deploy and test the Leave Request process
© SourceCode Technology Holdings, Inc. All Rights Reserved Page 22
--c8Lvz-t0O13ncjCBt3lA
Step Instructions
email for the approval escalation.
3. Open the SharePoint site at http://portal.denallix.com/K2Learning/100.HNL and verify that the calendar list item title has changed the submitter name and the leave type.
Step 4: Complete the “Capture leave details” step
Task:
1. Open Codi’s Outlook, and verify that a task notification email was received. Note that the email content has been customized as designed in the process.
2. Open Codi’s browser to launch an IE session as Codi.
3. Using the task link in Codi’s Outlook, open the Leave Request approval task and complete the HR user’s task.
Lab Complete!
Congratulations, you have successfully completed this lab exercise.
Lab Challenge Steps If time allows, try to complete the Lab Challenge steps.
Step Instructions
Step 1: Report on the process
Task:
1. Use the K2 Process Portal site located at http://portal.denallix.com/K2Learning/100.HNL/100.HNL.K2ProcessPortalSite to run a process instances report. Drill-down on the report to see the process history, and open the View Flow report to review the Process Flow.
Step 2: Format the dates in the emails
Task:
1. You may have noticed that the dates are not formatted well in the email notifications. Using an inline function, you can covert the date to a different format before sending out the email.
In the Inline Functions category of the context browser, use the FormatDateTime inline
function (under the Date and Time category) to format the date into an easier-to read
format.
100.HNL - K2 Designer for SharePoint Hands-On Exercise - Leave Request process
LAB 2: Assemble, deploy and test the Leave Request process
© SourceCode Technology Holdings, Inc. All Rights Reserved Page 23
--c8Lvz-t0O13ncjCBt3lA
Step Instructions
For some examples of supported “Format” values, refer to the following link: http://msdn.microsoft.com/en-us/library/az4se3k1.aspx
100.HNL - K2 Designer for SharePoint Hands-On Exercise - Leave Request process
REVIEW and Q&A
© SourceCode Technology Holdings, Inc. All Rights Reserved Page 24
--c8Lvz-t0O13ncjCBt3lA
REVIEW and Q&A
This has been a very hands-on module which allowed to you to become more familiar with the K2 Designer for
SharePoint and build a process with limited step-by-step guidance.
If you have questions about this module or the exercise, feel free to discuss these with your instructor.
Random Fact: Honolulu is the “biggest” city in the world. That’s because Hawaii’s state constitution states that any island not named as part of a county forms part of Honolulu. This makes the entire island of Oahu, where Honolulu is located, plus all the other small, uninhabited islands, known as the Northwestern Hawaiian Islands, part of Honolulu. Honolulu is about 1,500 miles (2,414 km) long, which is roughly the distance from Los Angeles, California, to Denver, Colorado.
2e3cf7ff-fffc-43b7-b5de-7723081b7794
Questions and Answers about this practical exercise
Review and Q&A