プロジェクト

全般

プロフィール

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

Tomohisa Kusukawa, 2016/12/05 23:40

1 15 Tomohisa Kusukawa
h1. Redmine Plugin: Wiki Lists {{count}}
2 1 Tomohisa Kusukawa
3 15 Tomohisa Kusukawa
{{>toc}}
4 1 Tomohisa Kusukawa
5
English page is [[Wiki Lists en|here]].
6
7 12 Tomohisa Kusukawa
Redmineのwikiやチケットにチケット一覧を表示するマクロプラグインです。
8 1 Tomohisa Kusukawa
9 19 Tomohisa Kusukawa
h2. リンク
10 1 Tomohisa Kusukawa
11 19 Tomohisa Kusukawa
Redmine本家: http://www.redmine.org/plugins/redmine_wiki_lists
12 20 Tomohisa Kusukawa
リポジトリ: https://github.com/tkusukawa/redmine_wiki_lists/
13
ダウンロード: https://github.com/tkusukawa/redmine_wiki_lists/releases
14 1 Tomohisa Kusukawa
15
h2. インストール
16
17 20 Tomohisa Kusukawa
https://github.com/tkusukawa/redmine_wiki_lists/releases
18 2 Tomohisa Kusukawa
から最新のzipファイルをダウンロードし
19 12 Tomohisa Kusukawa
$REDMINE/plugins/
20 2 Tomohisa Kusukawa
に展開します。
21
<pre>
22 12 Tomohisa Kusukawa
$ cd $REDMINE/plugins
23 2 Tomohisa Kusukawa
$ unzip wiki_lists-~.zip
24 11 Tomohisa Kusukawa
</pre>
25 1 Tomohisa Kusukawa
26
これでRedmineを起動すると下記のマクロが使えるようになります。
27 7 Tomohisa Kusukawa
28 1 Tomohisa Kusukawa
h1. 使い方
29
30 19 Tomohisa Kusukawa
h2. チケットリストの表示: ref_issues
31 1 Tomohisa Kusukawa
32 19 Tomohisa Kusukawa
wikiやチケットの説明/注記の中にチケットの一覧を表示します。
33 8 Tomohisa Kusukawa
34 19 Tomohisa Kusukawa
h3. 書式: {{@ref_issues([option].., [column]..)@}}
35 8 Tomohisa Kusukawa
36
*options:* 以下のオプションを指定できます。
37 1 Tomohisa Kusukawa
38 19 Tomohisa Kusukawa
古いオプション {{collapse
39
|* -s[=WORD[|WORD...]]
40 1 Tomohisa Kusukawa
  題名(subject)にワードを含むチケットを表示を表示します。
41
  ワードを省略すると記述ページの題名を検索ワードとして使用します。
42 19 Tomohisa Kusukawa
 
43
* -d[=WORD[|WORD...]]
44 1 Tomohisa Kusukawa
  説明(description)にワードを含むチケットを表示します。。
45
  ワードを省略すると記述ページの題名を検索ワードとして使用します。
46 19 Tomohisa Kusukawa
 
47
* -w[=WORD[|WORD...]]
48 1 Tomohisa Kusukawa
  題名または説明にワードを含むチケットを表示します。
49
  ワードを省略すると記述ページの題名を検索ワードとして使用します。
50
51 22 Tomohisa Kusukawa
* -p[=IDENTIFIRE]
52 1 Tomohisa Kusukawa
  表示するチケットのプロジェクトを限定します。
53 23 Tomohisa Kusukawa
}}
54 22 Tomohisa Kusukawa
55 1 Tomohisa Kusukawa
* -i=CUSTOM_QUERY_ID
56 22 Tomohisa Kusukawa
  -q=CUSTOM_QUERY_NAME
57 19 Tomohisa Kusukawa
  カスタムクエリの結果を表示します。
58 1 Tomohisa Kusukawa
59 19 Tomohisa Kusukawa
* -f:ATTRIBUTE OPERATOR [VALUE[|VALUE...]]
60 1 Tomohisa Kusukawa
  指定した条件でフィルタリングした結果を表示します。
61 23 Tomohisa Kusukawa
62
* -0
63 19 Tomohisa Kusukawa
 
64
  [ATTRIBUTE]
65
<pre>
66
tracker_id,project_id,subject,description, 
67 12 Tomohisa Kusukawa
due_date,category_id,status_id,assigned_to_id,priority_id, 
68 1 Tomohisa Kusukawa
fixed_version_id,author_id,lock_version,created_on,updated_on, 
69
start_date,done_ratio,estimated_hours,parent_id,root_id, 
70 23 Tomohisa Kusukawa
lft,rgt,is_private,closed_on,
71
cf_*,
72
issue_id,tracker,category,status,assigned_to,version,project,
73 19 Tomohisa Kusukawa
</pre>
74
  [OPERATOR]
75
<pre>
76
=:等しい, !:等しくない, o:未完了, c:完了, !*:なし, 
77
*:すべて, >=:以上, <=:以下, ><:次の範囲内, 
78
>t+:今日から○日後以降, >w:今週, lw:先週, 
79
l2w:直近2週間, m:今月, lm:先月, 
80
y:今年, >t-:今日より○日前以降, 
81
~:含む, !~:含まない, =p:次のプロジェクト内のチケット, 
82
=!p:次のプロジェクト外のチケット, !p:次のプロジェクト内のチケットを除く
83
</pre>
84 1 Tomohisa Kusukawa
85
絞り込み条件を複数記述した場合はAND条件となります。
86 19 Tomohisa Kusukawa
チケットでこのマクロを利用する場合、[](角括弧)内に下記カラム名を書くことで当該チケットの属性をVALUEとして参照利用できます。
87 1 Tomohisa Kusukawa
88
* -l[=column]
89 19 Tomohisa Kusukawa
  チケットの検索結果を表にせずにリンク付きテキストとして表示します。
90 1 Tomohisa Kusukawa
  カラムを指定することで題名以外のチケット属性を表示することができます。
91
92 19 Tomohisa Kusukawa
* -t[=column]
93
  チケットの検索結果を表にせずに表示します。
94
  マクロ等は再帰的に解釈されます。
95
96
* -c
97
  抽出されたチケットの数を表示します。
98
99 1 Tomohisa Kusukawa
*column:* 表示する列を指定します。
100
省略した場合はカスタムクエリで指定した列が表示されます。
101
102 18 Tomohisa Kusukawa
* project : プロジェクト
103 1 Tomohisa Kusukawa
* tracker : トラッカー
104
* parent : 親チケット
105
* status : ステータス
106
* priority : 優先度
107
* subject : 題名
108
* author : 作成者
109 18 Tomohisa Kusukawa
* assigned_to : 担当者
110
* updated_on : 更新日時
111
* category : カテゴリ
112 1 Tomohisa Kusukawa
* fixed_version : 対象バージョン
113 6 Tomohisa Kusukawa
* start_date : 開始日
114 10 Tomohisa Kusukawa
* due_date : 期日
115 1 Tomohisa Kusukawa
* estimated_hours : 予定工数
116 11 Tomohisa Kusukawa
* done_ratio : 進捗%
117
* created_on : 作成日時
118
* closed_on : 終了日時
119 1 Tomohisa Kusukawa
* relations : 関連チケット
120
* cf_* : カスタムフィールド(*はID番号)
121 11 Tomohisa Kusukawa
122
h3. 例
123
124 19 Tomohisa Kusukawa
|\2. *例1. カスタムクエリをIDで指定して表示*|
125
|表記|{{@ref_issues(-i=9)@}}|
126
|結果|{{ref_issues(-i=9)}}|
127 11 Tomohisa Kusukawa
128
129 19 Tomohisa Kusukawa
|\2. *例2. カスタムクエリを名前で指定して表示*|
130
|表記|{{@ref_issues(-q=MyCustomQuery1)@}}|
131
|結果|{{ref_issues(-q=MyCustomQuery1)}}|
132 11 Tomohisa Kusukawa
133
134 19 Tomohisa Kusukawa
|\2. *例3. 題名に「sorting」を含むチケットの一覧を表示*|
135
|表記|{{@ref_issues(-f:subject ~ sorting)@}}|
136
|結果|{{ref_issues(-f:subject ~ sorting)}}|
137 1 Tomohisa Kusukawa
138 11 Tomohisa Kusukawa
139 19 Tomohisa Kusukawa
|\2. *例4. 題名に「sorting」を含むチケットを 題名、作成者、担当者、ステータスの形で表示*|
140
|表記|{{@ref_issues(-f:subject ~ sorting, subject, author, assigned_to, status)@}}|
141
|結果|{{ref_issues(-f:subject ~ sorting, subject, author, assigned_to, status)}}|
142 1 Tomohisa Kusukawa
143 11 Tomohisa Kusukawa
144 21 Tomohisa Kusukawa
|\2. *例5. プロジェクトをWiki Listsに限定し、トラッカーIDが3(Support)か6(Question)のチケット一覧を表示*|
145
|表記|{<notextile>{ref_issues(-f:project = Wiki Lists, -f:tracker_id = 3 | 6)}</notextile>}|
146
|結果|{{ref_issues(-f:project = Wiki Lists, -f:tracker_id = 3 | 6)}}|
147 11 Tomohisa Kusukawa
148
149 19 Tomohisa Kusukawa
|\2. *例6. 題名が「Sample」のチケットへのリンクをチケットIDで表示*|
150
|表記|{{@ref_issues(-f:subject = Sample, -l=id)@}}|
151
|結果|{{ref_issues(-f:subject = Sample, -l=id)}}|
152 8 Tomohisa Kusukawa
153
154 19 Tomohisa Kusukawa
|\2. *例7. 題名が「Sample」のチケットの説明の内容を表示*|
155
|表記|{{@ref_issues(-f:subject = Sample, -t=description)@}}|
156
|結果|{{ref_issues(-f:subject = Sample, -t=description)}}|
157 8 Tomohisa Kusukawa
158 12 Tomohisa Kusukawa
159 19 Tomohisa Kusukawa
|\2. *例8. 題名に「sorting」を含むチケットの数を表示*|
160 1 Tomohisa Kusukawa
|表記|{{@ref_issues(-f:subject ~ sorting, -c)@}}|
161
|結果|{{ref_issues(-f:subject ~ sorting, -c)}}|
162 23 Tomohisa Kusukawa
163
Ver 0.0.7
164
|\2. *例9. チケット番号でフィルタ*|
165
|表記|{<notextile>{ref_issues(-f:issue_id >< 1389|1390)}</notextile>}|
166
|結果|{{ref_issues(-f:issue_id >< 1389|1390)}}|
167
168
|\2. *例10. 検索結果が0件の場合に表を表示しない*|
169
|表記|{<notextile>{ref_issues(-0,-f:subject = Sample2}</notextile>}|
170
|結果|{{ref_issues(-0,-f:subject = Sample2)}}|
171
172
|\2. *例11. 名称指定のOR検索*|
173
|表記|{<notextile>{ref_issues(-f:category = sample|error}</notextile>}|
174
|結果|{{ref_issues(-f:category = sample|error)}}|
175
176 1 Tomohisa Kusukawa
177
178
h2. 変更履歴
179
180
→ "ロードマップ":/projects/wiki_lists/roadmap?completed=1