r-labs » Wiki Lists

h1. Redmine Plugin: Wiki Lists 

{{count}} {{>toc}}

English page is [[Wiki Lists en|here]].

Redmineのwikiやチケットにチケット一覧を表示するマクロプラグインです。

h2. ダウンロード

"butbucket":https://bitbucket.org/kusu/redmine_wiki_lists/downloads

h2. インストール

https://bitbucket.org/kusu/redmine_wiki_lists/downloads

から最新のzipファイルをダウンロードし

$REDMINE/plugins/

に展開します。

<pre>

$ cd $REDMINE/plugins

$ unzip wiki_lists-～.zip

</pre>

これでRedmineを起動すると下記のマクロが使えるようになります。

h2. 動作環境

* redmine_wiki_lists-0.0.3.zip

** redmine-2.3.*

h1. 使い方

h2. チケットリストの表示

wikiやチケットの中にチケットの一覧を表示します。

①カスタムクエリーで抽出されたチケット、

②指定したワードを含むチケット、

③属性値がワードと一致するチケット

の何れかで表示するチケットを抽出します。

h3. 書式: {{@ref_issues([options].., [column]..)@}}

*options:* 以下のオプションを指定できます。

* -s[=WORD[|WORD...]]

  題名(subject)にワードを含むチケットを表示を表示します。

  ワードを省略すると記述ページの題名を検索ワードとして使用します。

* -d[=WORD[|WORD...]]

  説明(description)にワードを含むチケットを表示します。。

  ワードを省略すると記述ページの題名を検索ワードとして使用します。

* -w[=WORD[|WORD...]]

  題名または説明にワードを含むチケットを表示します。

  ワードを省略すると記述ページの題名を検索ワードとして使用します。

* -p[=IDENTIFIRE]

  特定のプロジェクトのチケットのみ表示します。

* -i=CUSTOM_QUERY_ID

  表示項目および絞り込み条件にカスタムクエリの内容を使用します。

* -q=CUSTOM_QUERY_NAMD

  表示項目および絞り込み条件にカスタムクエリの内容を使用します。

* -f:ATTRIBUTE[=WORD[|WORD...]]

  指定した属性(ATTRIBUTE)がWORDと一致するチケットを表示します。

  ワードを省略すると記述ページの題名を検索ワードとして使用します。

  属性には以下のものが利用できます。

|tracker_id,project_id,subject,description, 

due_date,category_id,status_id,assigned_to_id,priority_id, 

fixed_version_id,author_id,lock_version,created_on,updated_on, 

start_date,done_ratio,estimated_hours,parent_id,root_id, 

lft,rgt,is_private,closed_on, cf_* |

絞り込み条件を複数記述した場合はAND条件となります。

WORDsは'|'で区切ることで複数のワードのOR条件を指定できます。

絞り込み条件の指定が無い場合は当該ページの題名が検索キーワードに使われます。

チケットに記述する場合、[](角括弧)内に下記カラム名を書くことで当該チケットの属性をWORDとして参照利用できます。

* -l[=column]

  チケットの検索結果をリンク付きテキストとして表示します。

  カラムを指定することで題名以外のチケット属性を表示することができます。

*column:* 表示する列を指定します。

省略した場合はカスタムクエリで指定した列が表示されます。

* project : プロジェクト

* tracker : トラッカー

* parent : 親チケット

* status : ステータス

* priority : 優先度

* subject : 題名

* author : 作成者

* assigned_to : 担当者

* updated_on : 更新日

* category : カテゴリ

* fixed_version : 対象バージョン

* start_date : 開始日

* due_date : 期日

* estimated_hours : 予定工数

* done_ratio : 進捗％

* created : 作成日

* cf_* : カスタムフィールド(*はID番号)

h3. 例

|\2. *例1. 題名に「sorting」を含むチケットの一覧を表示*|

|表記|{{@ref_issues(-s=sorting)@}}|

|結果|{{ref_issues(-s=sorting)}}|

|\2. *例2. 題名に「sorting」を含むチケットを 題名、作成者、担当者、ステータスの形で表示*|

|表記|{{@ref_issues(-s=sorting,subject,author, assigned_to, status)@}}|

|結果|{{ref_issues(-s=sorting,subject,author, assigned_to, status)}}|

|\2. *例3. プロジェクトをwiki_listsに限定し、題名に「sortring」を含むチケットの一覧を表示*|

|表記|{{@ref_issues(-p=wiki_lists,-s=sorting)@}}|

|結果|{{ref_issues(-p=wiki_lists,-s=sorting)}}|

|\2. *例4. カスタムクエリをIDで指定して表示*|

|表記|{{@ref_issues(-i=9)@}}|

|結果|{{ref_issues(-i=9)}}|

|\2. *例5. カスタムクエリを名前で指定して表示*|

|表記|{{@ref_issues(-q=MyCustomQuery1)@}}|

|結果|{{ref_issues(-q=MyCustomQuery1)}}|

|\2. *例6. カスタムクエリをIDで指定し、担当ユーザがID89のものを表示*|

|表記|{{@ref_issues(-i=9,-f:assigned_to_id=89)@}}|

|結果|{{ref_issues(-i=9,-f:assigned_to_id=89)}}|

|\2. *例7. カスタムクエリをIDで指定し、担当ユーザがID89のものをリンク文字で表示*|

|表記|{{@ref_issues(-i=9,-f:assigned_to_id=89,-l)@}}|

|結果|{{ref_issues(-i=9,-f:assigned_to_id=89,-l)}}|

|\2. *例8. カスタムクエリをIDで指定し、担当ユーザがID89のものをリンク文字でチケット番号を表示*|

|表記|{{@ref_issues(-i=9,-f:assigned_to_id=89,-l=id)@}}|

|結果|{{ref_issues(-i=9,-f:assigned_to_id=89,-l=id)}}|

h2. 変更履歴

→ "ロードマップ":/projects/wiki_lists/roadmap?completed=1