プロジェクト

全般

プロフィール

Wiki Lists » 履歴 » バージョン 8

Tomohisa Kusukawa, 2013/07/23 02:09

1 5 Tomohisa Kusukawa
h1. Redmine Plugin: Wiki Lists 
2 1 Tomohisa Kusukawa
3
{{>toc}}
4
5
English page is [[Wiki Lists en|here]].
6
7
Redmineのwikiに表を表示するプラグインです。
8
9
h2. ダウンロード
10
11
"butbucket":https://bitbucket.org/kusu/redmine_wiki_lists/downloads
12
13
h2. インストール
14
15 4 Tomohisa Kusukawa
https://bitbucket.org/kusu/redmine_wiki_lists/downloads
16 2 Tomohisa Kusukawa
から最新のzipファイルをダウンロードし
17
(redmine2.0の場合)$REDMINE/plugins/
18
(redmine1.*.*の場合)$REDMINE/vendor/plugins
19
に展開します。
20
<pre>
21
$ cd $REDMINE/plugins ← redmine2.0以降の場合
22
or
23
$ cd $REDMINE/vendor/plugins  ← redmine1.*.*の場合
24
$ unzip wiki_lists-~.zip
25
</pre>
26 1 Tomohisa Kusukawa
27
これでRedmineを起動すると下記のマクロが使えるようになります。
28 5 Tomohisa Kusukawa
29 7 Tomohisa Kusukawa
h2. 変更履歴
30
31
→ "ロードマップ":/projects/wiki_lists/roadmap?completed=1
32 5 Tomohisa Kusukawa
33
h1. 使い方
34 1 Tomohisa Kusukawa
35
h2. チケットリストの表示
36
37 8 Tomohisa Kusukawa
wikiやチケットの中にチケットの一覧を表示します。
38 1 Tomohisa Kusukawa
39 8 Tomohisa Kusukawa
①カスタムクエリーで抽出されたチケット、
40
②指定したワードを含むチケット、
41
③属性値がワードと一致するチケット
42
の何れかで表示するチケットを抽出します。
43 1 Tomohisa Kusukawa
44 8 Tomohisa Kusukawa
h3. 書式: {{@ref_issues([options].., [column]..)@}}
45 1 Tomohisa Kusukawa
46 8 Tomohisa Kusukawa
*options:* 以下のオプションを指定できます。
47 1 Tomohisa Kusukawa
48 8 Tomohisa Kusukawa
* -i=[CustomQueryID] 
49
  表示項目および絞り込み条件にカスタムクエリの内容を使用します。
50 1 Tomohisa Kusukawa
51 8 Tomohisa Kusukawa
* -q=[CustomQuery名]
52
  表示項目および絞り込み条件にカスタムクエリの内容を使用します。
53
54
* -p[=identifire]
55
  特定のプロジェクトのチケットのみ表示します。
56
57
* -s[=WORD[|WORD...]]
58
  題名(subject)にワードを含むチケットを表示を表示します。
59
  ワードを省略すると記述ページの題名を検索ワードとして使用します。
60
61
* -d[=WORD[|WORD...]]
62
  説明(description)にワードを含むチケットを表示します。。
63
  ワードを省略すると記述ページの題名を検索ワードとして使用します。
64
65
* -w[=WORD[|WORD...]]
66
  題名または説明にワードを含むチケットを表示します。
67
  ワードを省略すると記述ページの題名を検索ワードとして使用します。
68
69
* -f:ATTRIBUTE[=WORD[|WORD...]]
70
  指定した属性(ATTRIBUTE)がWORDと一致するチケットを表示します。
71
  ワードを省略すると記述ページの題名を検索ワードとして使用します。
72
  属性には以下のものが利用できます。
73
  tracker_id,project_id,subject,description, 
74
  due_date,category_id,status_id,assigned_to_id,priority_id, 
75
  fixed_version_id,author_id,lock_version,created_on,updated_on, 
76
  start_date,done_ratio,estimated_hours,parent_id,root_id, 
77
  lft,rgt,is_private,closed_on, cf_* }
78
79 1 Tomohisa Kusukawa
絞り込み条件を複数記述した場合はAND条件となります。
80
WORDsは'|'で区切ることで複数のワードのOR条件を指定できます。
81 8 Tomohisa Kusukawa
絞り込み条件の指定が無い場合は当該ページの題名が検索キーワードに使われます。
82 1 Tomohisa Kusukawa
83 8 Tomohisa Kusukawa
* -l[=column]
84
  チケットの検索結果をリンク付きテキストとして表示します。
85
  カラムを指定することで題名以外のチケット属性を表示することができます。
86
87 1 Tomohisa Kusukawa
*column:* 表示する列を指定します。
88
省略した場合はカスタムクエリで指定した列が表示されます。
89
90
* project : プロジェクト
91
* tracker : トラッカー
92
* parent : 親チケット
93
* status : ステータス
94
* priority : 優先度
95
* subject : 題名
96
* author : 作成者
97
* assigned_to : 担当者
98
* updated_on : 更新日
99
* category : カテゴリ
100
* fixed_version : 対象バージョン
101
* start_date : 開始日
102
* due_date : 期日
103
* estimated_hours : 予定工数
104
* done_ratio : 進捗%
105 6 Tomohisa Kusukawa
* created : 作成日
106 1 Tomohisa Kusukawa
* cf_* : カスタムフィールド(*はID番号)
107
108
h3. 例
109 6 Tomohisa Kusukawa
110 8 Tomohisa Kusukawa
例1. カスタムクエリを利用し、特定ユーザが担当しているもの
111 3 Tomohisa Kusukawa
112 8 Tomohisa Kusukawa
{{@ref_issues(-i=9,-f:assigned_to_id=337)@}}
113 3 Tomohisa Kusukawa
114 8 Tomohisa Kusukawa
{{ref_issues(-i=9,-f:assigned_to_id=337)}}
115 3 Tomohisa Kusukawa
116
117 8 Tomohisa Kusukawa
例2. プロジェクトをwikiextに限定し、題名か本文にemoticonsかjenkisを含むチケットをリンク文字列で表示する
118 3 Tomohisa Kusukawa
119 8 Tomohisa Kusukawa
{{@ref_issues(-p=wikiext,-w=emoticons|jenkins,-l)@}}
120 3 Tomohisa Kusukawa
121 8 Tomohisa Kusukawa
{{ref_issues(-p=wikiext,-w=emoticons|jenkins,-l)}}
122 3 Tomohisa Kusukawa
123 8 Tomohisa Kusukawa
h2. Wikiページの一覧リストの表示
124
125 3 Tomohisa Kusukawa
h3. 書式
126
127 1 Tomohisa Kusukawa
<pre>
128 8 Tomohisa Kusukawa
{{wiki_list}}
129 1 Tomohisa Kusukawa
</pre>