Building the Leave Request Approval Application (V1 or "Basic" Version)

1. Launch K2 Designer (Start > All Programs > K2 blackpearl > K2 Designer).
   (If the shortcut is not on your desktop or if you are not using a K2-provided virtual machine for this tutorial, check with your K2 administrator what the web address (URL) is for your K2 Designer environment, then open the site using a browser like Internet Explorer, Chrome or Firefox.)
   



On the left side of the screen is the Category Browser. This is where your K2 artifacts (forms, views, workflows, etc.) will be stored. The All Items category is the primary category for storing applications that you will build. First you are going to create a main category for your applications called K2 Learning. As you work through K2 tutorials, you can create categories under the K2 Learning category to keep your files organized. Once again, note that creating categories is not a requirement to building K2 applications. It does however, keep your K2 artifacts organized as you work through the tutorials.
2. Right-click All Items and select New Category.



3. Name the new category
   K2 Learning
   then click OK.



If you are using an environment that is shared with other users, you may want to add your name to the folder name, so that your application does not conflict with another user's applications.

Now you will create the categories specific to your Leave Request Basic application. Using the same steps as above, you'll add folders that will store the Forms, Views and SmartObjects for your application.

4. Right-click the K2 Learning category and select New Category. Name the new category
   Leave Request
   then click OK.
   
5. Right-click the Leave Request category and select New Category. Name the new category
   Forms
   then click OK. This category will house the forms for your application.
6. Repeat the step above for two more categories and name them
   SmartObjects
   Views
   These categories will house your views and SmartObject.

Your Category Browser should look like the image below.

STEP 1 REVIEW

In this step, you prepared the K2 Designer environment by creating categories (or folders) for your application (Leave Request) and application artifacts (Forms, SmartObjects, Views). You created a main category (K2 Learning) that you can use for future tutorials and for practice applications.

1. Right-click the SmartObjects category and select New SmartObject.



2. Navigate to the General settings screen. (If you are on the SmartObjects landing screen, click Next in the lower right corner of the screen.) On the General settings screen, name the SmartObject
   Leave Request SmartObject
   and confirm the SmartObject Type is set to the default SmartBox. CHECK the option to Allow this SmartObject to be used in Workflows. The Category setting is fine as it is. Click Next when ready.
You don't need to adjust the category because you started from the SmartObjects category to create this SmartObject. You can create SmartObjects in a number of ways, then move them into the SmartObjects category from this General settings screen.
When you select 'Allow this SmartObject to be used in Workflows', you are telling K2 to make the SmartObject properties and methods available as options in the K2 Workflow Designer. As you build your own applications, you may find that your SmartObjects do not appear as options in the K2 Workflow Designer. Simply edit the SmartObject in question from K2 Designer, and from this General settings screen, check the 'Allow' option, then click Finish to save the SmartObject edit. In Part 3 of this tutorial, you will observe the SmartObject options as you work through building your Leave Request Workflow.



You will now be directed to the Define Properties screen. This is where you will add the properties (or columns/fields) that you need for your application to your SmartBox SmartObject. Notice that K2 has automatically added the ID property, which is the key identifier for each SmartObject record. In the next few steps, you will be adding the remaining properties that you need for your application to your Leave Request SmartObject.

3. Begin by clicking Add. (Refer to A in the image below the table.) Enter the property Name and data Type using the table entries below as a guide. Click the <Add property> link to continue adding the properties until you have entered all eight. Click OK, then Next to continue.

Name	Type	Notes
Leave Request Title	Text
Employee Name	Text
Employee Email	Text
Leave Start Date	Date
Leave End Date	Date
Leave Type	Text
Requester Comments	Memo
Request Status	Text	This field will be updated by the workflow as the leave request is submitted and then approved or rejected



4. On the Configure Associations screen, click Finish to publish the new SmartObject to the K2 server.

STEP 2 REVIEW

You have just created your first K2 SmartBox SmartObject! Taking a closer look at the SmartObject properties, you might recognize them as the future form fields you will use for your Leave Request Form (with the exception of the ID property, which is hidden). When a user submits a Leave Request, the form content will be saved to this SmartBox SmartObject. As the workflow progresses, the Request Status property will be updated with the appropriate status value.

1. Right-click the Leave Request SmartObject (located in the SmartObjects category) and select Design View.

In this step, you are designing a view directly from the Leave Request SmartObject. You don't have to create views in this manner, but you can save several steps by letting K2 do all of the basic work. K2 will create the view and automatically add the controls (which are bound to the SmartObject properties you added in the previous step).



2. If on the Views Introduction screen, click Next.
3. On the General settings screen, name the new view
   Leave Request Item View
   then change the category to the Views category. (A below) Confirm Item View is selected and click Next.

You do not need to make any edits to the Data Source, because you designed this view directly from the Leave Request SmartObject (the data source) itself.



4. On the Layout design screen, click Create Labels and Controls.
When you select Create Labels and Controls, K2 will give us an option to select which fields (SmartObject properties) you want on your view, plus a few other settings for the layout table. (The Create Layout Table Only option creates a blank table where you can drag and drop controls yourself. For this exercise you will use the Create Labels and Controls option.)



5. On the Labels and Controls settings screen, make the following configurations:
   • Keep the number of columns set to 2
     • The first column will house your control labels and the second column will house the controls
   • Include all of the fields, except the ID
     • This is a hidden field that will contain the SmartBox SmartObject record ID. You do not need it to be a part of your user interface.
   • Select the Display Only option for the Employee Email
     • We don't want the user to be able to change the email value.
   • Change the Label Position to Left
   • CHECK the box to add the Colon suffix
   • CHECK the box to add the Standard Create Button
     • Once again, you are allowing K2 to perform some of your legwork. You could manually add a button control to your view and configure it to create a new record in the SmartBox SmartObject. You will have K2 generate the Create button automatically and add the necessary rules that will create the record for us.
   Click OK when ready.



Your new View should look similar to the image below. You've highlighted the sections you will use the most (Breadcrumb Bar, View Menu, Design Canvas, Toolbox, Properties Pane and Navigation Wizards/Save/Help) to help you with terminology if you are new to K2 Designer. As you move forward with the steps and exercises, you will become more familiar with the Designer layout and terms.



Now that you have the basic view designed, you'll add a few customizations that will make the view a little more user friendly. 99% of view and form design are preference and you will learn what works for your users and what doesn't as you build more applications. First, you'll adjust the width of the label column and second you'll adjust the width of the two date fields.

Notice the Employee Email Data Label. Where a label is a static control (it never changes), a data label is a control that cannot be changed by the user, but is dynamic in nature. The Employee Email value will change to reflect the user currently logged in. (This is actually a rule you will set in a later step.) Data labels can also be hidden to perform some type of function within the form or view.
6. Hover over the center column line until you see the double lines/arrows. Click+drag the column line so that it is closer to your labels. In other words, reduce the width of the Labels column.



7. Highlight the Leave Start Date Calendar box by clicking it. In the Properties Pane, change the Width to
   50%
   then repeat this same step for the Leave End Date Calendar box.



Next, you'll change the Leave Type text box to a drop-down list and add some choices for your users to select. This will keep the Leave Types consistent as they are saved to the SmartBox.

8. Highlight the Leave Type Text box. Select the Change Control icon found in the View Menu. Change the control to a Drop-Down List.



9. With the Leave Type control still highlighted, open the Data Source Type editor (A below) found in the Properties Pane. Select the option to Use a static list of values in the control. (B below) Open the list editor and Add the following options for both the Value and the Display, then click OK when you are done.
   • Paid Time Off
   • Study Leave
   • Family Responsibility



10. Change the Width property of the Leave Type drop-down control to
    50%
    (Remember to click and highlight the drop-down control so that you see its properties represented in the Properties pane.)



You have one last adjustment to make to your view layout. You'll move the Create button to the right side of the view, which will make the view flow smoother for your users.

11. Click and drag the Create button into the second cell. Click within the cell itself to highlight it, then click the Right-Align icon found in the View Menu.



Your view should now look like the image below.



12. Click Finish in the Navigation Wizard (lower right corner of the screen) to save and exit from this view.

STEP 3 REVIEW

In this step, you created an Item View based on the Leave Request SmartObject. By designing the view directly from the SmartObject, K2 automatically created the view fields which you were able to include and /or display. You selected the Create button for your View. K2 creates all of the necessary rules and actions so that when the button is clicked, a new SmartBox SmartObject record is created in the associated Leave Request SmartObject. You also applied some minor formatting and you manually entered the values for your Leave Type drop-down list.

1. Right-click the Leave Request SmartObject and select Design View. If on the View home screen, click Next.
2. Name the new view
   Leave Request List View
   then move it to the Views category.
3. Change the View Type to List View. UNCHECK the option to Call this method when the form loads. Click Next when ready.
Call this method when the form loads. Because you have designed this list view based off of a SmartObject, K2 by default will retrieve all content from the SmartObject when the view is loaded. This is not what you want. You want only the records that pertain to the current user, not all of the records. That is why you turn off this option. In a later step, you will configure a rule to retrieve only the records for the current user.



4. Select the Create Labels and Controls option. On the layout screen, include the following fields:
   • Leave Request Title
   • Employee Name
   • Leave Start Date
   • Leave End Date
   • Leave Type
   • Request Status

There are no other changes to the layout editor, so click OK when ready. Click Finish (Navigation Wizard - lower right corner) to save and exit from this view. Here you are only displaying the current user's records. You don't want the user to make any changes, so you keep the 'Enable list editing' option disabled.

STEP 4 REVIEW

In this step you created a basic List View based off of the Leave Request SmartObject. You will use this view to retrieve previous leave request records for the current user. You have disable the list editing functionality (by keeping the default) so that the user cannot change any records that have already been submitted.

1. Right-click the Forms category and select New Form. If on the Forms home screen, click Next.



2. Name the new form
   Leave Request Form
   then click Next. Because you created the form directly from the Forms category, it will created withing that category, so you don't need to move it.



You should now be on the Form Designer screen. The Form Designer has a design canvas and many of the same toolbars and panes as the View Designer.

3. Drag the Leave Request Item View onto the form design canvas.



4. Double-click the (Enter View Title) view title and change it to
   Leave Request



5. Now you'll add the List View to just below the Item View. Drag the Leave Request List View to just under the Item View. You will notice that K2 automatically adds a new placeholder as you drag the view onto the canvas. Drop the view into the placeholder.



6. Double-click the (Enter View Title) view title and change it to
   Previous Leave Requests
   (Remember that this view will contain all of the prior leave requests for the current user.)



The last step in creating your form will be to customize the look and feel by changing the default theme to the Lithium theme.

K2 has a number of predefined themes that you can apply to your forms, or you can create your own as you advance in your K2 knowledge. Lithium is K2's latest theme and is compatible with mobile devices, so it is a good option if your users will be using devices like tablets and phones to access SmartForms. It is possible to extend the standard list of themes with custom themes, for example if your organization has a particular color scheme.
7. First, you want to access the Properties Pane for the form. You need to make sure that neither of the views is already highlighted. Click anywhere outside of the views. In the Properties Pane, navigate to the Theme property found under the Appearance heading. Select Lithium.

(If you have trouble seeing the Theme property, it's quite possible that a view is currently selected.)



Once the Lithium theme is applied, the form style should change to something like the image below.


8. Click Finish to save and exit the Form Designer. In the Category Browser, right-click the Leave Request Form and select Check In. If you get a message about associated views, click OK to check in the Views associated with this Form.

Views and forms are not available to your users until you have checked them in. This essentially "publishes" the artifacts to the K2 server. If you make a change to a view or form, you must check it out then check it back in, before those changes are evident to your users.

STEP 5 REVIEW

In this step, you created a new form and then added your Item View and List View to the form canvas. You gave your form a complete make-over by simply changing the theme.

1. Create a New Category under Leave Request and name it
   Workflows



2. Right-click the Leave Request category and select New Workflow.



3. The Workflow Settings screen opens. Name the workflow
   Leave Request Workflow
4. Click the ellipses to the right of the Category field, then change the category to Workflows.



5. Click the ellipses to the right of the Form field. Navigate to and select the Leave Request Form. In this step, you are associating the Leave Request Workflow with the Leave Request Form. This will in turn, expose all of the form controls (actually the SmartBox SmartObject properties) to the workflow designer. In later steps, you will update the Request Status property using the SmartObject property in the workflow.
6. For the Folio, expand the SmartForms tree in the Context Browser and drag the Leave Request Title Text Box control into the Folio field. Use the image below as a guide.



What is the Folio? The folio is a text field that is commonly used to distinguish one process instance from another process instance (of the same workflow). The folio is not required, nor does it have to be unique. Since all processes, or workflows, will have the same process name, using a unique folio value will aid in identifying the individual process instances of the workflow. This is especially useful when viewing workflow reports having many process instances.

To make the folio unique, you can use a combination of fields, such as a customer name combined with an order number. Setting the folio value typically comes from properties found in the context browser. The property values are variables that are replaced at runtime by actual content specific to the process instance.

You can also use the folio as a variable throughout your workflow. For example, if you assign a customer name as the folio, you can use the folio to customize emails so that the customer is referenced by their name.

Three instances of the same workflow showing unique folio values


7. Click the black arrow just to the left of the Form label to expose the Item Reference settings. UNCHECK the option to Create Item Reference. Now, CHECK the option once again. Confirm that the Leave Request SmartObject has been added as the Item Reference.



At this time, you will not make any changes to the State options, so click Next when ready.

Item References
K2 keeps track of items that relate to the current process instance, known as Item References. For example, when a workflow is started from a SharePoint list or library, or from a SmartObject, K2 will store a pointer to the current record in the Item References properties so that those values can be used later on in the workflow or rules. For now, just think of Item References as a shortcut to the current record values from the SmartObject, or data source.
8. You should now be on the Configure the rule to start the workflow screen. Here, you want to tell K2 to start the workflow when the Create button has been clicked. Confirm that the Select Rule drop-down contains the value On Leave Request Item View, when the Create Button is Clicked. Click Finish.



At this point, you have configured the basic settings for your Leave Request Workflow. You still need to assign permissions however, and to do that, you need to access the advanced workflow settings.

9. Double-click the Start button to open the advanced workflow settings wizard.



10. This is the same wizard you just worked through, however the advanced version contains the permissions settings. Click Next until you reach the Workflow Rights screen (five times).
11. Begin by changing the search scope to Groups. (A below) Enter
    domain users
    into the search box and click the search icon or hit enter. You should now see the Domain Users group in the search results pane. (B below) Click and drag Domain Users into the permissions pane. CHECK the Start and View boxes.
If you do not assign permissions, your users will see an error when they submit the form. The Start setting allows users to start the workflow and the View setting allows users to view the workflow reporting information.

Click Finish



Now that you have your workflow settings complete, you can move on to adding steps to the workflow. recall that the workflow steps are basically the lines that connect one event to another. The first event you are going to add will be a System Event using the SmartObject Event wizard. (System events are tasks that K2 performs, rather than a user. Here, you will set the Request Status property to indicate the Leave Request has been submitted.

12. Select the SmartObjects tab in the workflow ribbon. Drag the Save Leave Request event into the event box. ("Save" is the equivalent of "Update".)
If you do not see the Leave Request SmartObject methods in the ribbon toolbar, it's possible you have more than one SmartObject created. (Perhaps this is not the first application being built.) In this case, click the black drop-down arrow next to the SmartObject category name (this will be the folder icon at the left of the ribbon toolbar) and select the Leave Request SmartObject. You should now see the correct methods for this application.
13. Recall that when you created the Leave Request SmartObject, you allowed the SmartObject to be used in workflows. This is where that setting comes into play. Had you not checked the 'Allow' option, none of the Leave Request SmartObject methods would appear as they do below. (The SmartObject events displayed in the image below are 'Create', 'Delete', 'Load' and 'Save'.)



14. The Save wizard opens. The first configuration you need to make is to tell K2 which record you want to update. You do this by assigning the SmartObject ID for the current record into the Save event. In the Context Browser, expand the Item References node, then Leave Request SmartObject. Drag the SmartObject ID into the ID input property. The ID as the input property tells K2 to update the record that is part of the current workflow, or the current record.
15. Now you'll set the status property. Scroll down until you see Request Status. Enter
    Submitted
    into the value field. Click Next, then Finish to complete the Save event configuration. You have just instructed K2 to update the current SmartBox SmartObject record, Request Status value.



16. To keep your workspace organized, you'll rename the Save event so that you know exactly what that event does. Double-click the Save Leave Request title and change it to
    Set Status Submitted

STEP 6 REVIEW

In this step you created the Leave Request Workflow and configured it to use the Leave Request Form. You assigned Workflow Rights, or permissions, to all domain users so that they can start the workflow and view workflow progress. You added a SmartObject Save event, which will update the status property to indicate the form has been submitted. You will update the status property again as the workflow progresses by adding additional SmartObject Save events, indicating either Approved or Rejected.

1. Hover over the Set Status Submitted event until you can see the Workflow Step Outcome icon. (The icon looks like a blue mini-flowchart. If you don't see the icon when hovering, click once on the workflow canvas to refocus your mouse to the canvas. Then try hovering again.) Click the Outcome icon to opens its wizard.



2. On the configuration screen, click Add. Replace New Outcome with
   Continue
   then click OK. Here, you are simply giving your step, or outcome line, a label so that it is easy for us to tell exactly what that step does. In this case, it is very straightforward. However, as you build more complex workflows, you may be adding conditions and more advanced options to the step. Giving the label a descriptive name will assist you (and others working with your workflow design), insight as to what the step is doing or the logic behind the step.



3. Notice that K2 has added a new event box. Switch back to the Workflow Steps tab, then drag a User Task (SmartForms) event into the new event box.



4. The User Task wizard opens. Name the task
   Manager Approval
   
5. On this screen you can will also configure the actions. Actions are the decision options that the user assigned the task can make. You can have many actions, but you need at least one. For your workflow, you will have two. Enter the following actions (on separate lines):
   Approved
   Rejected
   then click Next when ready.



6. The User Form setting is fine, so click Next. The work item rule is fine, so click Next.
7. On the Participants screen, drag the Manager name into the Task Group window. CHECK the box to Notify participants when they receive a work item. Here, you are assigning this task to the form originator's manager. (You also have the option to search for participants in the same manner as you did for the workflow permissions.) If you choose to not notify the participant, they will have to rely on manually checking their worklists to see if they have any tasks assigned to them.
If you are building this application within your own environment, you will want to assign the task participant to a user where you have access to their Outlook. You might consider assigning this task to yourself for access/testing purposes. If you are building this application on a K2-provided VM, you will have access to the manager's Outlook.



You will not customize the task notification email for this application, so click Finish. Your screen should look like the image below. Notice that K2 has added two additional steps and event boxes for the actions you just configured.



8. Save your work. (File > Save)

STEP 7 REVIEW

In Step 7, you added a User Task and assigned it to the form originator's manager. You added two actions (Approved and Rejected). K2 automatically generated outcome lines for each of the actions you added. You can have many actions, but you need to have at least one. By checking the option to notify the participant of a worklist item, the manager will receive an email indicating they have a task, with a link to open the form and action the task.

1. Copy the Set Status Submitted event by click+dragging a box over it to highlight it. Select Copy when the option menu appears.



2. Hover over the Approved outcome event, right-click, then click Paste.



3. Hover over the Rejected outcome event, right-click, then click Paste once again.

Your screen should look like the image below. K2 added an additional step and event for each of the system tasks you just copied and pasted.



Notice that K2 copied the Save event as well as the Continue outcome line. In the next few steps, you will adjust each new event so that they are consistent with their outcome, then you'll add a Placeholder event to the last two empty event boxes. A Placeholder simply completes an outcome line without adding a formal event. This allows you to deploy and test your workflow without receiving errors of missing events.

4. Double-click inside of the Set Status Submitted1 event (the Approval side) to open its wizard. Change the name to
   Set Status Approved
   then click Next.



5. There are no necessary changes to the Workflow Step Outcomes screen, so click Next. (You can change Continue1 to just Continue if you like to keep your lines consistent.)
6. On the input properties screen, change the Request Status property from Submitted to
   Approved
   then click Finish. Be sure to keep the ID property as it is, since you have already configured it to reflect the current record. You just want to update the status property so that it reflects the outcome line for an Approved decision.



7. Repeat the steps above for the Rejected side. Change the Request Status to
   Rejected
   then click Finish.
8. Still on the Workflow Steps screen, drag a Placeholder into each of the empty event boxes (one for the Approved side and one for the Rejected side).



Save your work.

STEP 8 REVIEW

In this step, you reused the Save event for the Approved and Rejected outcomes. By copying and pasting the event, you could take advantage of configurations already in place (the ID property already mapped). Copying an event will also copy its associated outcome, so you added Placeholders into each of the new event boxes that were created. You cannot deploy or test your application with empty event boxes, so the Placeholders tell K2 that the event boxes are empty by design.

1. Deploy the workflow by clicking (File > Deploy)



2. You will see the Deploying Workflow dialog while the workflow is being compiled and deployed. When you see the Deployment Successful dialog, your workflow is deployed and ready for use! Click Close & Exit.

1. In K2 Designer, click on the Leave Request Form and select Edit. Click the Rules button in the Breadcrumb Bar (at the top of the screen). (A below) Highlight the Leave Request Workflow (Default) state, then the When the Form is Initializing rule. Click Edit Rule.



First, you want to populate the Leave Request List View. Recall that this is the view you created to output a list of all leave requests previously submitted by the form originator. To do this, you want to execute (call) a SmartObject method (Get List) for the list view. You want K2 to populate the previous leave requests when the form is loaded.

2. From the Rule Designer Actions pane (A below), click once on the action Execute a View method to add it to the Rule Definition pane.



3. Click the select View link so that you can tell K2 which view you want to apply this action. Select Leave Request List View.



4. Click the select method link and choose Get List. The Get List method retrieves content from a data source.



Now click the (configure) link. There are two primary sections to the editor that opens. First, you need to tell K2 which user records you want to retrieve (this is the input value) and second, you need to tell K2 which SmartObject properties you want to return (these are the output values).

5. On the Input Mappings screen (A below) expand the System Values in the Context Browser and drag the Current User > Email property into the Input Properties Employee Email field. Here, you are telling K2 to use the current user's email as the filter to search for previous leave requests. You want K2 to return all user records that have the same email as your current user.



6. Now click the Output Mappings button. (A below). On this screen, you want to tell K2 which properties you want returned to your form. Using the image below as a guide, drag the highlighted Return Properties into the Leave Request List View fields. (You may have to collapse the Item View in order to see the List View.) You are simply telling K2 which fields you want populated with returned records. In this case, you are returning all of the fields, but you don't have to.



Next, you want to display the current user's name and email on the Leave Request Item View. K2 will automatically populate these fields based on who is logged in. These values will then be saved to the Leave Request SmartObject when the form is submitted, along with the leave request details. This step is simply a matter of transferring system values to the Item View fields.

7. Still in the Rule Designer (Actions tab), search the keyword
   transfer
   then click on Transfer data to add it to the Rule Definition pane. (As you become more familiar with rules, conditions and actions, you will find searching for a keyword to be much more convenient than scrolling through all of the rule options.)



8. Click the (configure) link. In the Context Browser, expand the System Values node, then Current User. Drag the Display Name into the Employee Name Text Box field. Drag the Email into the Employee Email Data Label field. Click OK.

This step highlights the reason behind making the Email a data label and not a text box. Recall that a data label cannot be changed by the user. You need the email to be consistent throughout the entire workflow process, so that rules (like the one you are configuring now) will be stable.



9. Your Rule Definition pane should now look like the image below. Click OK to close the Rule Designer.

STEP 10 REVIEW

In this step, you edited the Form Initializing rule on the Leave Request Workflow (Default) state, so that the current user's previous leave requests will populate the Leave Request List View when the form is first loaded. The Default state is the form configuration that the form originator will see. You configured the current user's email as the value K2 will use to search for records in the Leave Request SmartObject. You also configured the system values for the Display Name and Email (again, for the current user) to populate their corresponding fields on the Item View. System Values are a convenient mechanism for using the current user's details as filters and values throughout the workflow.

1. Continuing on with Rules, highlight the Workflow Task state and the When the Form is Initializing rule, then click Edit Rule. The Workflow Task state is the form and rule configuration that the manager will see when they approve or reject the request.



First, you want to configure an action so that the originator's previous leave requests are loaded. Recall in previous steps, you told K2 to retrieve the previous requests of the current user. On the manager's form, you don't want the current user (that would be the manager), instead you need K2 to retrieve the form originator's records. You also want to hide the Create button for the manager, as it is not needed. K2 will add a third view to this form (the Workflow Task view) that contains the task actions (Approved, Rejected, etc.) and a submit button for the manager to use.

2. Click on Execute a View method to add it to the Rule Definition pane. Click the select View link and choose the Leave Request List View. Then click the select method link and choose Get List.



3. Click the (configure) link. Using steps very similar to those in Step 10, you will map the Input Properties and the Return Properties. But, instead of using the System Value for the email input, you will use the SmartObject value for the email input because you don’t want the email of the current user, you want the email of the user who submitted the Leave Request.

In the Context Browser expand the Leave Request Item View node, then the Leave Request SmartObject. Drag the Employee Email into the Employee Email input property.



4. Now switch to the Output Mappings screen (A below) and map the Return Properties for the Leave Request List View. Click Finish when ready to close the configuration screen, but do not exit the Rule Designer just yet.



5. The last configuration is to hide the Create button for the approving manager. With the Actions tab still highlighted (A below) search for the keyword
   hide
   then click once on Hide a View control to add it to the Rule Definition pane. Click the select View link and choose Leave Request Item View. Click the select control link and choose Create Button. Click OK to close the Rule Designer, then click Finish to complete the rule configurations.



6. Right-click the Leave Request Form and select Check In. If you get a message about checking in associated views, click OK to continue.

STEP 11 REVIEW

In this final step to creating your basic Leave Request Approval application, you configured two actions for the Workflow Task state. This is the state that represents the form and rule configuration that the approving manager will interact with. First, you configured an action that will retrieve the originator's previous leave requests. Then, you hid the Create Button from the manager, as it is not needed.

1. From K2 Designer, click to highlight the Leave Request Form. In the Properties pane, notice the Runtime URL. This is the link (or URL) to your form. You can provide this link to your end users so that they can submit their own forms. (You may need to click the little down-arrow icon in the top right of the panel to expand the properties for the form.)
2. Click the Runtime URL link. Depending on your environment, it may take a few seconds for the form to open.



3. Complete the form fields with the exception of the Request Status field, then click the Create button



4. You should see an animated processing icon, then you will be returned to the form as you left it. Change the fields (title, dates, etc.) and click the Create button again. Once again, the form processes very quickly and you are returned to the form as you left it. If you did not receive any errors, close the browser.
   (Usually, you would add some kind of confirmation message to indicate to the user that their request was submitted. You will add this functionality in the extended version of the Leave Request Approval application)



Now you need to open the approving manager's Outlook and confirm the task notification emails were received. Then you will action one of the tasks. If you are working on a K2-provided virtual environment (VM), you are likely logged in as Denallix Administrator. Administrator's manager is Jonno, so you'll open Jonno's Outlook. (If you are building this application in your own environment, you will need to access the appropriate Outlook account of the Manager for the user that submitted the leave request or whatever user you selected for the Manager Approval task when you designed the workflow.)

5. If using a K2-provided virtual machine, close all open Internet Explorer windows. Then, click the User Shortcuts arrows found in the lower-right corner of the screen. Expand the Legal folder and click IE (Jonno) as well as Outlook (Jonno) to open IE and Outlook as Administrator's manager, Jonno.



Jonno's Outlook will begin to open. This can take a minute or two when using a virtual machine environment. If you see a message about synchronizing CRM data, continue to wait. If you see a message about licensing, close to continue.

6. Confirm there are two task notification emails. In one of the emails, Click to open the worklist item link to open the form and action the request.



Notice the Workflow view that K2 has placed at the top of the form. This is the default panel that K2 added to the form when you workflow-enabled the form by adding it to the Manager Approval task. The approver will select their decision from the drop-down list and then click the Submit button to complete the task. This workflow panel is not the only way to workflow-enable forms, you can also define your own controls and rules to workflow-enable a form. For the purposes of this exercise you are just using the simplest approach to workflow-enable forms.

Confirm that the Leave Request details are correct (A below) and then confirm that both form submissions show up in the Previous Leave Requests view with the Request Status as Submitted. (B below)

7. Action the request by selecting one of the Action items, then click Submit. This time, you will receive K2's generic confirmation message. Click OK to close the dialog and then exit the browser.



8. Open the second worklist item. In the Previous Leave Requests list, confirm that the Request Status value has now changed for the request that you approved in the previous step. If you wish, you can Approve or Reject this second leave request.

STEP 12 REVIEW

In this step, you tested your Leave Request Approval application by submitting two forms using the Runtime URL. The Runtime URL is the "user" link that allows your users to access and submit your forms. (Note: depending on your K2 environment setup, this link would probably only be available to internal users in your organization but there are ways of exposing SmartForms to the outside world.) You confirmed the task notification emails were sent and after actioning one of the worklist items, you confirmed the Request Status property was updated appropriately in the Leave Request SmartObject.