任务列表(Tasklist)宏用于在 Confluence 页面中添加任务的列表。用户在查看页面的时候可以直接编辑任务而不需要离开页面进入编辑页面后再编辑。当然用户还必须具有编辑页面的权限才可以进行编辑。
你可以具有轻量的任务列表,这个任务列表你可以直接在你页面中进行编辑,通过编辑器的插入菜单。这个方法允许你通知用户,这个任务已经被指给他们了。
请查看在 Confluence 中管理任务页面中的相关内容。
使用任务列表宏
希望在页面中加入任务列表宏:
- 打开你希望编辑 Confluence 页面,然后单击 编辑(Edit)按钮。页面的编辑模式将会被打开。
- 下一步,在编辑工具栏中单击宏浏览器图标。这时候宏浏览器将会在屏幕的中间打开。
- 在宏浏览器中,在窗口的右上角的对话框中输入你希望插入的宏的名称。当找到与你输入的宏名称接近的宏后将会在中间的面板上显示。单击需要的宏然后来查看可用进行配置的宏选项,在这里你可以对需要插入的宏设置相关参数,然后单击 插入(insert)来将需要的宏插入到页面中。
参数
宏参数的定义为,你可以使用这些参数在宏输出的内容和格式上进行定义。
Confluence 使用的存储格式或者 wikimarkup 格式中使用的参数和在宏浏览器中使用的标签是不同的,这些将会在下面在括号内容中列出(example
)。
参数 | 默认值 | 说明 |
---|
标题(Title)
(title ) | 'Task List' | 任务列表的名字。这个将会在任务列表的标题栏中显示。 |
列表宽度(Width of List)
(width ) | 530px | 任务列表的宽度。 |
启动锁定(Enable Locking)
(enableLocking ) | False | 如果这里设置为 (true)的话,你可以对每一个独立的任务进行锁定。当任务锁定后,任何是不能修改的。 请参考编辑任务列表中的相关内容。 |
删除提示(Prompt on Delete)
(promptOnDelete ) | False | 如果这里设置为 (true)的话,当用户对任务进行删除的时候将会收到提示信息。 |
在查看一个页面的时候编辑任务列表
在对页面进行查看的时候,你可以对任务列表进行下面的操作:
操作 | 说明 |
---|
添加一个任务(Adding a task) | 在列表的标题下面输入任务的描述信息然后单击添加(Add)。 |
完成和不完成一个任务(Completing/uncompleting a task) | 单击位于任务边上的选择框来讲一个任务标记为完成。任务的名字将会被高亮显示,同时任务进程工具条也会被更新。取消选择这个选择框,来标记任务还没有被完成。你可以选择标记所有来标记所有任务都没有被完成。 |
编辑一个任务(Editing a task) | 移动的你的鼠标到任务的标题栏中,然后单击标题右侧的编辑图标(显示的是铅笔的形状)。这是任务的名称变化成可以编辑的样式,编辑图标也会别替换成保存图标。输入你需要修改的内容,然后直接回车或者单击保存按钮完成保存。 |
删除一个任务(Deleting a task) | 移动你的光标到任务上,然后单击删除按钮(垃圾箱图标)。这个图标在任务的右侧显示。 |
查看一个任务的细节(Viewing details of a task) | 单击任务名字左侧的图标。任务的细节将会展开,然后供查看。 |
锁定一个任务(Locking a task) | 对一个任务完成锁定。锁定参数 必须需要先进行选择,你可以单击锁定的小图标来避免任务被修改,删除或者其他改变。 |
修改优先级(Changing the priority) | 当任务细节可见的时候,单击下面的选项 — High, Medium 或者 Low。 |
指派任务(Assigning the task) | 当任务细节可见的时候,修改任务的指派可以通过在查找框内输入字符找到用户后完成指派。 |
屏幕截图:任务列表中显示任务细节
任务排序
对任务列表中的任务有下面两种排序方法:
从排序方式中选择一个希望排序的选项:
选项 | 描述 |
---|
自定义(Custom) | 这个是默认的选项。 |
优先级(Priority) | 按照你为每一个任务指派的优先级进行排序。 |
创建的日期(Date Created) | 按照任务创建的日期进行排序。 |
完成的(Completed) | 移动所有完成的任务到任务列表的底部或者顶部。 |
名字(Name) | 按照任务列表的名字进行排序。 |
指派人(Assignee) | 按照任务指派人的名字进行排序。 |
一旦你选择了排序选项后,使用排序方式的的图标来对排序的序列方式。
将任务拖动到新的位置:
将任务向上或者向下拖动,使用拖动我'Drag Me' 来处理正确的任务名字。请确认任务在已经存在的任务的左侧。
一个空间将会显示,你将运行将任务放置到这里。
查看任务完成的进度
任务列表中的顶部有 2 个不同颜色显示的进度条,包括了任务完成的百分比。
屏幕截图:任务列表的的进度条
说明
- 在这里没有办法向任务添加截止日子。如果你有兴趣能够提高这个功能,你可以在下面的链接中进行备注:
错误的渲染宏 'jira' : Unable to locate JIRA server for this macro. It may be due to Application Link configuration. JIRA 官方也许会考虑将这个问题继续修改。 - 任务列表宏不能修改任务指派给的用户。但是你可以从编辑工具栏中使用轻量任务列表访问。请查看:在 Confluence 页面中管理任务的相关信息。
代码示例
下面的代码是提供给希望进一步编辑 Confluence 页面的高级用户使用的。
宏名字:tasklist
宏内容:对任务的描述,接受 Wiki 标记格式。
存储格式示例
注意:宏中包含的 CDATA
定义了任务的列表。内容是使用 Wiki 标记格式进行编码的。在表格的第一行定义了任务列表的标题头,其他行中定义了一个任务。
< ac:structured-macro ac:name = "tasklist" >
< ac:parameter ac:name = "title" >My title</ ac:parameter >
< ac:parameter ac:name = "enableLocking" >true</ ac:parameter >
< ac:parameter ac:name = "width" >20%</ ac:parameter >
< ac:parameter ac:name = "promptOnDelete" >true</ ac:parameter >
< ac:plain-text-body > <![CDATA[||Completed||Priority||Locked||CreatedDate||CompletedDate||Assignee||Name||
|F|M|F|1371784117215| |admin|Book tickets|
|F|M|F|1371784127222| |admin|Check passport expiry|
]]> </ ac:plain-text-body >
</ ac:structured-macro >
|
Wiki 标记格式示例
注意: 宏内容中的(标签 {tasklist
} 之间) 定义了标签列表。内容是使用 Wiki 标记格式进行编码的。在表格的第一行定义了任务列表的标题头,其他行中定义了一个任务。
{tasklist:title=My title|enableLocking= true |width= 20 %|promptOnDelete= true }
||Completed||Priority||Locked||CreatedDate||CompletedDate||Assignee||Name||
|F|M|F| 1371784117215 | |admin|Book tickets|
|F|M|F| 1371784127222 | |admin|Check passport expiry|
{tasklist}
|