---
id: object/table/1170
type: object
title: Table 1170 "User Task"
summary: Table 1170 "User Task" in Base Application (Microsoft.Foundation.Task). 20 fields, 7 public procedures, 4 events. Present since at least BC23, still in BC30, changed in BC24, BC29.
tier: official
language: en
tags:
  - table
  - base application
versions:
  introduced: null
  last_changed: "29"
  deprecated: null
review:
  state: derived
  by: null
  at: null
  flags: []
generated:
  at: "2026-10-11T00:31:51.816Z"
  pipeline: 0.2.0
  prompts: {}
  input_hash: 11c5300ed8303bc89b31540b8d7bd4445648f35338ae1d929ee2621328ac251d
evidence:
  - kind: code
    url: https://github.com/microsoft/BCApps/blob/ea08af5ef2d6a9b5c5af4a029288abbe2c883220/src/Layers/W1/BaseApp/Modules/Foundation/UserTask/UserTask.Table.al
    title: src/Layers/W1/BaseApp/Modules/Foundation/UserTask/UserTask.Table.al (releases/29.x)
    date: null
    commit: ea08af5ef2d6a9b5c5af4a029288abbe2c883220
    t: null
    quote: null
links:
  learn:
    - https://learn.microsoft.com/dynamics365/business-central/across-user-tasks
    - https://learn.microsoft.com/dynamics365/business-central/finance-accounting
  objects: []
  features: []
  topics:
    - topic/business-central/business-functionality/finance
    - topic/business-central/business-functionality/general-business-functionality
  localizations: []
  videos: []
  posts: []
  guidelines: []
object_type: table
object_id: 1170
name: User Task
namespace: Microsoft.Foundation.Task
app: Base Application
extends: null
first_version: "23"
last_version: "30"
present_in:
  - "23"
  - "24"
  - "25"
  - "26"
  - "27"
  - "28"
  - "29"
  - "30"
changed_in:
  - "24"
  - "29"
source_major: "29"
obsolete: null
countries: []
ms_search_form_ids: []
counts:
  fields: 20
  procedures: 11
  events: 4
  subscribers: 0
relations:
  out: 1
  referenced_by: 0
  pages: 5
  extended_by: 0
  event_subscribers: 0
  calls: 2
  called_by: 0
  implements: 0
---

# Table 1170 "User Task"

> Table 1170 "User Task" in Base Application (Microsoft.Foundation.Task). 20 fields, 7 public procedures, 4 events. Present since at least BC23, still in BC30, changed in BC24, BC29.

Base Application · Microsoft.Foundation.Task · BC23-30 · [source at ea08af5e](https://github.com/microsoft/BCApps/blob/ea08af5ef2d6a9b5c5af4a029288abbe2c883220/src/Layers/W1/BaseApp/Modules/Foundation/UserTask/UserTask.Table.al) · facts from BC29

Learn documents this table through its pages: [Page 1164 "User Task List Part"](../page/1164.md) (1 Learn page), [Page 1170 "User Task List"](../page/1170.md) (1), [Page 1171 "User Task Card"](../page/1171.md) (1), [Page 1316 "Accountant Portal User Tasks"](../page/1316.md) (1).

## Properties

| Property | Value |
|---|---|
| Caption | User Task |
| DataClassification | CustomerContent |

## Fields

Explanation: the field's ToolTip in the code; without one, the ToolTip of a page control bound to the field (marked via the page); without that, its Caption (marked caption) when that differs from the name.

| No. | Name | Type | Explanation | Notes |
|---|---|---|---|---|
| 1 | ID | Integer | Specifies the ID that applies. | not editable; AutoIncrement |
| 2 | Title | Text[250] | Specifies the title of the task. |  |
| 3 | Created By | Guid | — | TableRelation User."User Security ID" where("License Type" = const("Full User")); not editable; DataClassification EndUserPseudonymousIdentifiers |
| 4 | Created DateTime | DateTime | Specifies when the task was created. | not editable |
| 5 | Assigned To | Guid | Specifies who the task is assigned to. | TableRelation User."User Security ID" where("License Type" = const("Full User")) |
| 7 | Completed By | Guid | — | TableRelation User."User Security ID" where("License Type" = const("Full User")); DataClassification EndUserPseudonymousIdentifiers |
| 8 | Completed DateTime | DateTime | Specifies when the task was completed. |  |
| 9 | Due DateTime | DateTime | Specifies when the task must be completed. |  |
| 10 | Percent Complete | Integer | Specifies the progress of the task. |  |
| 11 | Start DateTime | DateTime | Specifies when the task must start. |  |
| 12 | Priority | Option | Specifies the priority of the task. | OptionCaption: ,Low,Normal,High |
| 13 | Description | BLOB | Specifies a descriptions of the task. |  |
| 14 | Created By User Name | Code[50] | Specifies who created the task. | FlowField: lookup(User."User Name" where("User Security ID" = field("Created By"))); not editable |
| 15 | Assigned To User Name | Code[50] | Specifies who the task is assigned to. | FlowField: lookup(User."User Name" where("User Security ID" = field("Assigned To"))); not editable |
| 16 | Completed By User Name | Code[50] | Specifies who completed the task. | FlowField: lookup(User."User Name" where("User Security ID" = field("Completed By"))); not editable |
| 17 | Object Type | Option | Specifies the type of window that the task opens. | OptionCaption: ,,,Report,,,,,Page |
| 18 | Object ID | Integer | Specifies the window that the task opens. | TableRelation AllObj."Object ID" where("Object Type" = field("Object Type")) |
| 19 | Parent ID | Integer | — |  |
| 20 | User Task Group Assigned To | Code[20] | Specifies the group if the task has been assigned to a group of people. | TableRelation [Table 1175 "User Task Group"](../table/1175.md) ("User Task Group".Code) |
| 21 | ShouldShowPendingTasks | Boolean | — | FlowFilter; not editable |

## Keys

- Key1: ID (clustered)
- Key2: Assigned To, User Task Group Assigned To, Percent Complete, Due DateTime
- Key3: User Task Group Assigned To

## Events published

- `OnBeforeRunReportOrPageLink(var UserTask: Record "User Task"; var IsHandled: Boolean)` (integration)
- `OnCreateRecurrenceOnBeforeInsert(var UserTask: Record "User Task"; fromUserTask: Record "User Task"; Counter: Integer; RecurringStartDate: Date; Recurrence: DateFormula)` (integration)
- `OnBeforeSetCompleted(var UserTask: Record "User Task")` (integration)
- `OnAfterSetCompleted(var UserTask: Record "User Task")` (integration)

## Procedures

- `CreateRecurrence(RecurringStartDate: Date; Recurrence: DateFormula; Occurrences: Integer)`
- `SetCompleted()`
- `SetStyle(): Text`
- `GetDescription(): Text`
- `SetDescription(StreamText: Text)`
- `IsCompleted(): Boolean`
- `RunReportOrPageLink()`

## Triggers

OnDelete, OnInsert

## Relations

- User Task Group Assigned To: TableRelation [Table 1175 "User Task Group"](../table/1175.md)

## Pages and codeunits on this table

- [Page 1164 "User Task List Part"](../page/1164.md) (source table)
- [Page 1170 "User Task List"](../page/1170.md) (source table)
- [Page 1171 "User Task Card"](../page/1171.md) (source table)
- [Page 1316 "Accountant Portal User Tasks"](../page/1316.md) (source table)
- [Page 9078 "User Tasks Activities"](../page/9078.md) (source table)

## Calls

From the extracted call graph of BC29 (graphify-al on the snapshot checkout): calls whose target is known from a declared type or an `Object::"Name"` argument. Interface dispatch and calls through events are not counted, so the list is not complete.

- [Codeunit 10 "Type Helper"](../codeunit/10.md) (2 calls: `GetDescription → LFSeparator`, `GetDescription → ReadAsTextWithSeparator`)
- [Codeunit 4100 "Temp Blob"](../codeunit/4100.md) (2 calls: `GetDescription → CreateInStream`, `GetDescription → FromRecord`)

## Across versions

- Present in: BC23-30
- Changed (declaration) in: BC24, BC29

Source: AL metadata extracted from the code (names, ids, signatures, properties); no code bodies (D10).

## Ask your agent

Procedure bodies are not stored here (D10). The call sections above are our own, per object, from the BC29 call graph. For a procedure body or the calls of one procedure, ask bc-code-atlas (external, by Stefan Maron, MIT; default corpus w1-28), which the bc-observatory plugin connects: `bcatlas_resolve_node(object_type: "table", object_name: "User Task")`, then `bcatlas_get_procedure_body` or `bcatlas_get_neighbors` on the returned id.