User Manual

Get User Tasks

23/2/26
Get User Tasks

Kuika's Get User Tasks action is used to list tasks belonging to the user or found in the pool. This action allows active steps in processes to be viewed, an inbox screen to be created, and task tracking to be managed through a centralized structure.

It is particularly preferred in approval mechanisms, task management screens, process-based filtering, and reporting scenarios.

Technical Features

  • Task Listing: Tasks assigned (claimed) to the user, tasks in the pool, or both can be listed together.
  • StepInstance (Many) Data Type: The action returns multiple task records. Results can be displayed in Table, List, or custom-designed card structures.
  • Filtering and Paging: Filtering can be performed based on process, date, application, and search key using optional parameters. Paging is supported with the Page and PageSize parameters.
  • Process-Based Listing: Tasks belonging to a specific workflow can be filtered using ProcessDefinitionId.
  • Web and Mobile Application Support: The Get User Tasks action is supported in both web and mobile applications.

Get User Tasks Action Implementation Steps

  1. Log in to the Kuika platform.
  2. Open the project you are working on from the Apps screen.
  3. While in the UI Design module, open the screen where you want to display the task list.
  1. Click on the + ADD ACTION menu in the Properties panel on the right.
  2. Depending on the relevant trigger event (pageInit, OnClick, etc.), add the Process Automation > Get User Tasks action.

Configuring Action Parameters

ShowPool (Boolean – Optional)

Lists tasks in the pool that have not yet been claimed.

  • True: Pool tasks are included.
  • False: Pool tasks are not included.

ShowClaimed (Boolean – Optional)

Lists tasks claimed by the user.

  • True: Claimed tasks are included.
  • False: Claimed tasks are not included.

UserName (String – Required depending on the scenario)

The username or email address of the user whose tasks will be retrieved.

Can be linked to Current User with the Symbol Picker.

Select from single process (Boolean)

Used to list tasks belonging to a specific process. When enabled, a process filter can be applied.

Optional Parameters

  • Can be added from the ADD OPTIONAL PARAMETER field.
    • Apps: Used to filter tasks belonging to a specific application.
    • ProcessDefinitionId: Used to retrieve tasks from a specific Workflow.
    • Page: Specifies the page number.
    • PageSize: Specifies the number of records to retrieve per page.
    • SearchKey: Enables searching by task title or content.
    • CreatedFrom: Retrieves tasks created after a specific date.
    • CreatedTo: Retrieves tasks created up to a specific date.
    • FilterLate: Used to filter late tasks.
    • SortBy: Determines the criteria by which tasks are sorted.

Usage Scenario: User Inbox Screen

When an employee logs into the system, they want to see their own tasks.

Configuration:

  • ShowClaimed: True
  • ShowPool: False
  • UserName: Current User

The action runs under pageInit and the results are bound to a Table element. When the user opens the page, the task list loads automatically.

Get User Tasks Action Advanced Customizations

  • Dynamic Filtering: Real-time filtering can be performed by linking the SearchKey parameter to a search box.
  • Process-Based Management: Only tasks from a specific workflow can be retrieved using ProcessDefinitionId.
  • Pagination and Performance: The Page and PageSize parameters can be used to build a high-performance structure for large data lists.
  • Reporting: Weekly or monthly task reports can be generated using the CreatedFrom and CreatedTo parameters.

Technical Risks

  • Incorrect User Information: Incorrect entry of the UserName parameter will result in the wrong task list being returned.
  • Empty Parameter Combination: If both ShowPool and ShowClaimed values are set to False, the result will be empty.
  • Performance Issues: Entering a very high PageSize value may cause performance issues in intensive data environments.
  • Incorrect Process Filtering: If ProcessDefinitionId is entered incorrectly, the task list may return empty.
  • Date Format Errors: The CreatedFrom and CreatedTo parameters must be in DateTime format.

The Get User Tasks action is one of the basic Process Automation actions for task listing and inbox management on the Kuika platform. With the correct parameter configuration, filterable, paginated, and reportable task management screens can be created.

Other Related Content

No items found.

Glossary

No items found.

Alt Başlıklar