Part 4: Testing the Application

In Part 4, we will once again test our updated Leave Request Application and confirm that the changes we have made are functioning properly. This part assumes that you have completed Parts 1, 2 and 3 of the tutorial.

ClosedStep 12: Testing the application

For this test, we will submit two Leave Request Forms. We will access the approving manager's Outlook and action one of the requests using SmartActions to send the request back for Rework. As the form originator, we will resubmit the request, then reject it as the approving manager. The second form that we submit, we will not action.

Step 12 Tasks

  1. Using the Runtime URL, submit two Leave Request Forms. Make the Leave Start Date for one of the requests today's date. This will fire off the escalation since we have it configured to start within two days of the Leave Start Date.
  2. Access the approving manager's Outlook and using SmartActions, reply to the request with Rework.
  3. Access the form originator's email and open the form. Edit the form entry in any manner you like, then resubmit it.
  4. As the approving manager, add some comments, then reject the resubmitted request. Confirm the email notification that is sent back to the form originator contains the manager's comments within the rejected email.
ClosedStep 12 Walkthrough
  1. Using the Runtime URL, open and submit two Leave Request Forms. Make the Leave Start Date for one of the forms today's date. This will fire off the escalation that we configured (remember it executes if within two days of the start date). Confirm you cannot edit the Approver Comments field (it should be read-only for the form originator). Enter any leave type or comments you like for each form.

    2. If you have time and would like to submit more Leave Requests so that reports will have additional content, feel free to do so!

    After you have submitted a form, confirm that the field entries are cleared (except the Employe Name and Email) and your new entry now shows up in the Previous Leave Requests List View. After you have submitted two forms, close your browser.

    At this point, we need to open the approving manager's Outlook. If you are building this application on a K2-provided VM, you are most likely logged in as Denallix Administrator. Administrator's manager is Jonno, so we'll open Jonno's Outlook. If you are building this application within your own environment, open the Outlook account for the user assigned the Manager Approval task. The screenshots and usernames used in this tutorial assume you are using the K2-provided Virtual Server image, so your screens and users may be different.

  2. Click on the User Shortcuts link found in the lower right corner of the screen. Expand the Legal folder, then click on Jonno's Outlook. Allow a minute or two for Outlook to open. If you see a message about syncing CRM, just let it complete. If you see a message about licensing, click Close to continue.

  3. Confirm there are two task notification emails for Jonno. Open one of the emails and Reply with
    Rework
    as the email message body. Send the email.

    4. As a reminder, we are going to action this request using SmartActions. SmartActions allow you to simply reply to a task notification email with one of the actions as the message body. K2 will read the action and move the workflow along accordingly.

  4. Confirm there is an escalation email for the task with today's date as the Leave Start Date.

  5. Now we will switch back and view the email that is sent back to the user for reworking their request. If you are on a K2-provided Virtual Server image, open Administrator’s outlook as describe here, otherwise open your own Outlook.
    Close Jonno's Outlook and open Administrator's Outlook. (Start, then search for Outlook). Allow a minute or so for Outlook to open. Confirm there is a task notification email for Administrator. This time, click on the link Click to open worklist item so that we can open and edit our original request.
  6. Make a change of some kind to your form entries. Select Resubmitted from the Action options and click Submit. You should see a confirmation dialog, click OK. Close out of the browser.
  7. Close Administrator's Outlook and open Jonno's Outlook. Once again, you should see a new task notification email. This time, click the link Click to open worklist item so that we can access the form.
  8. Confirm that you can now enter content into the Approver Comments field. Recall that we edited the Workflow Task state and turned off the read-only option for the comments. Enter a comment. Select Rejected from the action options and submit the form. Click OK for the confirmation dialog, then close out of the browser.
  9. Close Jonno's Outlook and open Administrator's Outlook. Confirm the rejected email arrived and there is content for the Approver Comments.

STEP 12 REVIEW

If your testing was successful, then congratulations! You have extended the Leave Request Application and have seen the Data, Forms and Workflow co-operate in a complete cycle from start to finish. We have completed the extended version of the Leave Request Application.

ClosedSummary

The exercises in this tutorial expanded on the functionality and interaction of K2's components: Data, Forms, Workflows. Key to these exercises are the following:

Data

  • SmartObjects can leverage connectivity with internal and external data sources
  • SmartObjects can be associated with form controls, creating an association that can automatically populate control values.
  • SmartObject methods can be called from views, forms and workflows and are commonly used to create, save (update) or retrieve (list) SmartObject properties.

Forms

  • Forms are containers for views and controls
  • Forms can contain multiple views
  • Views are logical sections of form content
  • There are two types of views: Item Views contain the content from one record. List Views contain multiple records.
  • Rules are comprised of Events, Conditions and Actions. Events are when something occurs, Conditions are if a specific criteria has been met and Actions do something if the Event and Condition has been met.
  • Rules can be applied to different workflow states, essentially creating custom forms for workflow tasks
  • Forms and views must be checked in before they can be exposed to users

Workflows

  • Workflows are comprised of steps which in turn, have associated events. The main container for a workflow is called a process.
  • There are two types of events: System Tasks are performed by the K2 server such as sending an email. User Tasks are performed by a human, such as making a decision of some kind.
  • Escalations keep your workflows flowing by sending email reminder notices, redirecting the unactioned task to another user or expiring the task altogether.
  • Workflows must be deployed before they can be exposed to users

K2 smartforms Product Documentation: User Guide4.6.10
Video Links Learn Support
No videos found for this article
K2 on YouTube
No Additional links found for this article
No self-learning content for this article
Try some scenarios...
No relevant support links available for this article