TracKanbanBoard 0.2

说明

trackanbanboard是一个trac wiki宏，用于使用敏捷看板方法管理票据。将看板宏添加到wiki页面，并使用它对项目中的票据进行优先级排序和管理。

主要功能：

• 定义板列及其映射到票据状态的方式
• 通过在板上拖动票据更改票据状态
• 通过拖放票链接
将现有车票添加到板上
• 直接从Board创建新票
• 查看和修改票证字段（摘要、说明等）并从“票证详细信息”对话框添加注释
• 定义在“票证详细信息”对话框中可见的票证字段

安装

1. 克隆存储库：

   git clone https://projects.developer.nokia.com/git/TracKanbanBoard.git trackanbanboard
   

2. 运行安装脚本：

   cd trackanbanboard
   python setup.py install
   

3. 在TRAC配置中启用组件：

   [components]
   trackanbanboard.* = enabled
   

4. 创建/修改wiki页面并将看板处理器放入其中。空数据将给出错误以及详细的使用说明：

   This is wiki text:
   {{{
   #!KanbanBoard
   }}}
   

数据存储

插件使用trac票证作为看板“卡片”。任何现有的项目票可以添加到董事会，并修改从董事会或从默认的TRAC票查看。

板配置和状态以json格式存储在wiki页面中的看板（kanbanboard）处理器块（见下面的示例）。当卡片被移动时，插件会更新状态并重写wiki页面。

示例

下面是一个宏定义示例，该宏定义生成具有三列（新建、进行中和完成）的看板，并在票据对话框中显示状态和优先级字段。第一列包含三张票（按从上到下的顺序排列：23、24和25），第二列一张票和第三列为空。保存板状态时，配置中的无效票证ID将被忽略并自动删除。

{{{
#!KanbanBoard height=250px
{
  "columns": [
    { "id": 1, "name": "New", "states": ["new"], "tickets": [23, 24, 25], "wip": 3 },
    { "id": 2, "name": "Ongoing", "states": ["assigned", "accepted", "reopened"], "tickets": [21], "wip": 3 },
    { "id": 3, "name": "Done", "states": ["closed"], "tickets": [], "wip": 5 }
  ],
  "fields": [
    "status", "priority"
  ]
}
}}}

不同选项和属性的描述可以用[[macrolist（kanbanboard）]]宏显示。

如何使用

通过将票证链接拖放到Board，可以将票证添加到Board。链接可以从与Board相同的页面、单独的浏览器窗口或通过单击“添加票证”按钮打开的票证查询对话框中拖动。

可以通过单击“新建票据”按钮并输入票据详细信息来创建新票据。以这种方式创建的票据将自动添加到板中。

车上的每张“卡”都会显示车票ID和摘要。可在“票证详细信息”对话框中查看其他详细信息，该对话框可通过单击各个卡打开。详细信息对话框包含：

• 链接到相应的TRAC票证页面（在标题栏中）
• 票证创建和修改时间
• 摘要
• 任何用户定义的字段（由宏定义中的“字段”属性定义）
• 票据说明为纯文本
• 更改历史记录
• 注释字段

如果用户具有ticket_modify和wiki_modify权限，则摘要、说明、自定义字段和注释是可编辑的，可以通过单击“保存”按钮保存更改。

通过单击“票证详细信息”对话框中的“从板上删除”按钮，可以从板上删除票证。从板上删除票据不会修改或删除票据。

如果用户具有适当的权限，也可以通过将票证从一列拖到另一列来修改票证状态。在这种情况下，ticket的新状态是目的列的“states”属性的第一个状态。