プロジェクト

全般

プロフィール

操作

Wiki Lists » 履歴 » リビジョン 17

« 前 | リビジョン 17/31 (差分) | 次 »
Tomohisa Kusukawa, 2014/08/12 23:31


Redmine Plugin: Wiki Lists

English page is here.

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

ダウンロード

butbucket

インストール

https://bitbucket.org/tkusukawa/redmine_wiki_lists/downloads
から最新のzipファイルをダウンロードし
$REDMINE/plugins/
に展開します。

$ cd $REDMINE/plugins
$ unzip wiki_lists-~.zip

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

動作環境

  • redmine_wiki_lists-0.0.3.zip
    • redmine-2.3.*

使い方

チケットリストの表示

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

①カスタムクエリーで抽出されたチケット、
②指定したワードを含むチケット、
③属性値がワードと一致するチケット
の何れかで表示するチケットを抽出します。

書式: {{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_NAME
    表示項目および絞り込み条件にカスタムクエリの内容を使用します。
  • -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番号)

例1. 題名に「sorting」を含むチケットの一覧を表示
表記 {{ref_issues(-s=sorting)}}
結果
例2. 題名に「sorting」を含むチケットを 題名、作成者、担当者、ステータスの形で表示
表記 {{ref_issues(-s=sorting,subject,author, assigned_to, status)}}
結果
例3. プロジェクトをwiki_listsに限定し、題名に「sortring」を含むチケットの一覧を表示
表記 {{ref_issues(-p=wiki_lists,-s=sorting)}}
結果
例4. カスタムクエリをIDで指定して表示
表記 {{ref_issues(-i=9)}}
結果
例5. カスタムクエリを名前で指定して表示
表記 {{ref_issues(-q=MyCustomQuery1)}}
結果
例6. カスタムクエリをIDで指定し、担当ユーザがID89のものを表示
表記 {{ref_issues(-i=9,-f:assigned_to_id=89)}}
結果
例7. カスタムクエリをIDで指定し、担当ユーザがID89のものをリンク文字で表示
表記 {{ref_issues(-i=9,-f:assigned_to_id=89,-l)}}
結果 filter by enum value of custom field: key value list want to use field reference of Issue in History part add [current_project_id] for value field can not use custom fields even when restrict the project ref_issues with custom fields not working use custom field to additional filter overwrite_sql_for_fieldをRedmine2.0に合わせる
例8. カスタムクエリをIDで指定し、担当ユーザがID89のものをリンク文字でチケット番号を表示
表記 {{ref_issues(-i=9,-f:assigned_to_id=89,-l=id)}}
結果 1497 1482 1446 1443 1326 1248 1063

変更履歴

ロードマップ

Tomohisa Kusukawa さんが9年以上前に更新 · 17件の履歴