任务列表

使用任务列表可显示当前用户的现有任务列表。可以根据指定用户、团队、日期和搜索条件对任务列表进行过滤。

该视图使用 CometD Web 消息传递自动刷新视图的内容。有关更多信息，请参阅配置通知和刷新行为。

限制和局限性

限制

此视图不使用可视性属性。
要对定制仪表板中的视图启用导航操作，还请将“导航控制器”控件添加到定制仪表板。有关更多信息，请参阅导航控制器控件。
在某些情况下，系统管理员可能会禁用 cometD Web 消息传递。如果在定制仪表板中使用此视图，请确保该仪表包含备选刷新机制，例如“刷新控制器”或“刷新按钮”。有关更多信息，请参阅 "刷新控制器" 控件和 "刷新按钮" 控件。

限制: 无

配置属性

在配置属性选项卡中设置或修改视图配置。

表 1. 任务列表配置属性
配置属性	属性变量	描述
高度	`height (Integer)`	控件的高度（以像素为单位）。如果任务列表超过了指定高度，那么将显示滚动条。要在不显示滚动条的情况下显示完整的任务列表，请输入 0。缺省值：未指定任何值时，控件高度为 600 像素。
初始列表大小	`initialMaxRows (Integer)`	显示在列表中的任务的初始数量。缺省值：如果未指定任何值，那么将显示 25 个任务。
团队标识	`teamId (String)`	根据团队标识过滤任务列表。如果未指定任何值，那么将显示所有团队的任务。缺省值：无
用户标识	`userId (String)`	根据用户标识过滤任务列表。如果未指定任何值并且未指定团队标识，那么将显示当前用户的所有任务。缺省值：无
列表作用域	`listScope (TaskListScope)`	显示为打开、已完成、已分配或未分配的任务的范围。此选项与团队标识和用户标识选项一起工作。有关选项如何协同工作以生成不同作用域视图组合的示例，请参阅配置 "任务列表" 控件部分。缺省值：`Open Tasks`
包括已分配的用户	`includeAssignedUsers (Boolean)`	启用数据绑定，以包含在任务列表结果中分配了任务的用户的列表缺省值：无
按到期范围过滤	`dueSlice (DateRange)`	仅显示在指定的开始日期和结束日期之间到期的任务。要显示截至指定日期或在指定日期之后到期的所有任务，请将开始日期或结束日期保留为空。缺省值：无
搜索过滤器	`searchFilter (String)`	仅显示与指定的搜索条件匹配的任务。缺省值：无
检索任务列表	`retrieveTaskListService (Default Task List Service)`	用于检索任务列表的服务。缺省值：`Default Task List Service`
展开所有行	`expandAllRows (Boolean)`	为用户提供一个切换选项，用于显示或隐藏所有行中的任务详细信息。缺省值: `False` (未选中)
已分配的用户	`assignedUsers (UserInfo) (List)`	在任务列表中分配了任务的用户的列表。这是只读选项。缺省值：无
任务	`tasks (TaskListItem) (List)`	当前显示的任务的列表。这是只读选项。缺省值：无

配置任务列表控件

以下视图场景是如何使用团队标识用户标识的示例。以及当列表作用域设置为 Open Tasks时用于作用域任务列表结果的列表作用域配置选项。

当前用户视图 (缺省值)-当团队标识和用户标识选项都为空时，列表将显示当前用户的所有团队的未分配任务以及分配给当前用户的所有任务。
团队视图-当指定了团队标识的值并且用户标识为空白时，列表将显示指定团队的未分配任务以及分配给团队所有用户的任务。
注: 您必须是团队管理员才能查看分配给团队所有用户的任务。
团队成员视图 - 当同时为团队标识和用户标识指定值时，列表显示指定团队的所有未分配任务以及分配给指定用户的关联团队任务。
单个用户视图 - 当团队标识为空，而指定了用户标识时，列表显示指定用户的关联团队的未分配任务以及分配给指定用户的任务。仅显示当前用户管理的团队中的任务。