Kuika's Get My Tasks History action is used to list the tasks a user has completed in the past. It makes process management more transparent and traceable by displaying which tasks the user completed and when.
Technical Specifications
Task History Tracking: Provides a detailed history of the tasks the user has completed.
User-Based Query: Provides access to a specific user's task completion history.
Web Application Support: This action is only supported in web applications.
Get My Tasks History Action Application Steps
Log in to the Kuika platform.
Open the project you will be working on from the Apps screen.
Go to the UI Design module and open the Properties panel.
From the + ADD ACTION menu, add the Process Automation > Get My Tasks History action according to the trigger event you want (Initial Actions, OnClick, OnBlur, etc.).
Configuring Action Parameters
Optional parameters (can be added with + ADD OPTIONAL PARAMETER):
Apps (String): Specifies the applications for which the task history will be queried.
Process Definition Id (String): Enters the ID number of the business processes to which the tasks belong.
User Name (String): The username or email address of the user whose task history is being queried.
Page (Integer): Specifies which page of the task list will be displayed.
Page Size (Integer): Determines how many tasks will be displayed on a page.
Search Key (String): Enables searching tasks by keyword.
Created From (Date): Specifies the start date for task creation.
Created To (Date): Specifies the end date for task creation.
Filter Late (Boolean): Used to list overdue tasks.
Outcome Message Behavior
OutcomeMessage is an optional parameter for the Resume Process action.
When a value is entered for this parameter, a column named Outcome Message is automatically displayed at the end of the task history table created by the Get My Tasks History action.
This column reflects how the process was completed (e.g., Approved, Rejected, Returned, etc.).
If the Outcome Message parameter is not defined in the process, this column is not added to the table.
If the Outcome Message parameter is not defined in the process, this column is not added to the table.
Usage Scenario: Tracking Task Completion History
A manager tracks performance by viewing the tasks completed in the past by a specific user on their team. When the Get My Tasks History action is triggered, the list of completed tasks for the relevant user is displayed.
Configuring the Get My Tasks History Action
User Name: “jane.doe@kuika.com” (User whose task history is being queried)
Apps: “ProjectApp” (Application to which the tasks belong)
Created From: “2024-01-01” (Start date of task history)
Created To: “2024-12-31” (End date of task history)
Page: 1 (Page where the task list will be displayed)
Page Size: 20 (Number of tasks to display per page)
Filter Late: false (Whether to filter overdue tasks)
When the action is executed, the tasks of the specified user within the selected date range are displayed in a table.
If the OutcomeMessage parameter is defined in the process, this value appears in the Outcome Message column at the end of each task row.
Get My Tasks History Action Advanced Customizations
Dynamic Filtering: Comprehensive filtering can be performed using date range, application, and keyword combinations.
Pagination: Performance and visibility are improved with pagination in large task histories.
Timeout Tracking: Tasks that are completed but overdue can be separated using the Filter Late parameter.
User-Based Reporting: Custom task history queries can be performed for different users.
Reporting and Integration: Task history data can be integrated with external systems for comprehensive analysis.
OutcomeMessage Field: Adds the task completion result to the table.
Technical Risks
Incorrect username or Process Definition Id parameters may cause the query to fail.
Performance issues may occur with very large data sets; paging and filtering should be used as a precaution.
The Get My Tasks History action is a powerful tool in the Kuika platform for tracking users' past task performance and optimizing process management.
