プロジェクト

全般

プロフィール

操作

Redmine Plugin: Wiki Lists

English page is here.

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

リンク

Redmine本家: http://www.redmine.org/plugins/redmine_wiki_lists
リポジトリ: https://github.com/tkusukawa/redmine_wiki_lists/
ダウンロード: https://github.com/tkusukawa/redmine_wiki_lists/releases

インストール

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

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

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

<使い方>チケットリストの表示: ref_issues

wikiやチケットの説明/注記の中にチケットの一覧を表示します。

書式: {{ref_issues([option].., [column]..)}}

options

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

古いオプション 表示

  • -i=CUSTOM_QUERY_ID
    -q=CUSTOM_QUERY_NAME
    カスタムクエリの結果を表示します。
  • -0
    結果が0件の場合に表を表示しません。
  • -f:<ATTRIBUTE>␣<OPERATOR>␣<[VALUE[|VALUE...]]>
    指定した条件でフィルタリングした結果を表示します。
    例 {{ref_issues(-f:tracker_id = 3)}}
    ※ 「=」等の両側にスペースが必要です。
      シングルクオートやダブルクオートは使えません。(今のところ端がスペースの文字をVALUEにできません)
     
    [ATTRIBUTE]
    issue_id,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_*,
    tracker,category,status,assigned_to,version,project,
    treated,
    

    ※ カスタムフィールド(cf_1等)を使う場合は-pでプロジェクトを限定するか、-iや-qでカスタムクエリを指定する必要があります。
     
    [OPERATOR]
    =:等しい, !:等しくない, o:未完了, c:完了, !*:なし, 
    *:すべて, >=:以上, <=:以下, ><:次の範囲内, 
    >t+:今日から○日後以降, >w:今週, lw:先週, 
    l2w:直近2週間, m:今月, lm:先月, 
    y:今年, >t-:今日より○日前以降, 
    ~:含む, !~:含まない, =p:次のプロジェクト内のチケット, 
    =!p:次のプロジェクト外のチケット, !p:次のプロジェクト内のチケットを除く
    

     
    絞り込み条件を複数記述した場合はAND条件となります。
     
    チケットでこのマクロを利用する場合、[](角括弧)内に下記 column を書くことで当該チケットの属性をVALUEとして参照利用できます。
    → [<column>]以外にも [id],[current_project_id],[current_user],[current_user_id],[<数字>days_ago] が利用できます。
  • -l[=column]
    チケットの検索結果を表にせずにリンク付きテキストとして表示します。
    カラムを指定することで題名以外のチケット属性を表示することができます。
  • -t[=column]
    チケットの検索結果を表にせずに表示します。
    マクロ等は再帰的に解釈されます。
  • -c
    抽出されたチケットの数を表示します。

column

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

  • project : プロジェクト
  • tracker : トラッカー
  • parent : 親チケット
  • status : ステータス
  • priority : 優先度
  • subject : 題名
  • author : 作成者
  • assigned_to : 担当者
  • updated_on : 更新日時
  • category : カテゴリ
  • fixed_version : 対象バージョン
  • start_date : 開始日
  • due_date : 期日
  • estimated_hours : 予定工数
  • done_ratio : 進捗%
  • created_on : 作成日時
  • closed_on : 終了日時
  • relations : 関連チケット
  • cf_* : カスタムフィールド(*はID番号)

例1. カスタムクエリをIDで指定して表示
表記 {{ref_issues(-i=9)}}
結果
例2. カスタムクエリを名前で指定して表示
表記 {{ref_issues(-q=MyCustomQuery1)}}
結果
例3. 題名に「sorting」を含むチケットの一覧を表示
表記 {{ref_issues(-f:subject ~ sorting)}}
結果
例4. 作成が 89(kusu) でステータスが '終了'でないチケットの(project,subject,author,assigned_to,status)を表示
表記 {{ref_issues(-f:author_id = 89, -f:status ! 終了(Closed), project, subject, author, assigned_to, status)}}
結果
例5. プロジェクトをWiki Listsに限定し、トラッカー名がSupport(3)かQuestion(6)のチケット一覧を表示
表記 {{ref_issues(-f:project = Wiki Lists, -f:tracker = Support | Question)}}
結果
例6. 題名が「Sample」のチケットへのリンクをチケットIDで表示
表記 {{ref_issues(-f:subject = Sample, -l=id)}}
結果 1389
例7. 題名が「Sample」のチケットの説明の内容を表示
表記 {{ref_issues(-f:subject = Sample, -t=description)}}
結果

This is the issue[#1389]'s description that explain 'ref_issues' wiki macro example.

refer issue's field value
notation {{ref_issues(-f:issue_id = 1389, -t = cf_2 )}}
results

SampleY

use field value for filter condition
notation {{ref_issues(-f:subject = [cf_2])}}
results
例8. 題名に「sorting」を含むチケットの数を表示
表記 {{ref_issues(-f:subject ~ sorting, -c)}}
結果 3
例9-1. チケット番号でフィルタ (次の範囲内)
表記 {{ref_issues(-f:issue_id >< 1389|1391)}}
結果
# プロジェクト トラッカー ステータス 優先度 題名 担当者 更新日 対象バージョン 進捗率
1391 Wiki Lists Defect 終了(Closed) 急いで(Urgent) Error Ismael Morales 2016/12/05 23:38

操作
1390 r-labs Defect 新規(New) 通常(Normal) Testlink Plugin Issue 2015/09/03 17:34

操作
1389 Wiki Lists Feature 解決(Resolved) 通常(Normal) Sample Tomohisa Kusukawa 2017/01/08 02:30

操作
例9-2. チケット番号でフィルタ (OR)
表記 {{ref_issues(-f:issue_id == 1389|1391)}}
結果
# プロジェクト トラッカー ステータス 優先度 題名 担当者 更新日 対象バージョン 進捗率
1391 Wiki Lists Defect 終了(Closed) 急いで(Urgent) Error Ismael Morales 2016/12/05 23:38

操作
1389 Wiki Lists Feature 解決(Resolved) 通常(Normal) Sample Tomohisa Kusukawa 2017/01/08 02:30

操作
例10. 検索結果が0件の場合に表を表示しない
表記 {{ref_issues(-0,-f:subject = Sample2)}}
結果
例11. 名称指定のOR検索
表記 {{ref_issues(-f:category == sample|error, subject, category)}}
結果
例12. ユーザkusuが2017-05-01から昨日までに作成または更新したチケットを検索
表記 {{ref_issues(-f:treated kusu 2017-05-01|[1days_ago])}}
結果
# プロジェクト トラッカー ステータス 優先度 題名 担当者 更新日 対象バージョン 進捗率
1514 Work Time Defect 解決(Resolved) 通常(Normal) CKEditorプラグイン利用時にMemoの整形が機能しない Tomohisa Kusukawa 2021/12/12 18:10

操作
1513 Work Time Feature 解決(Resolved) 通常(Normal) エンターキーでSubmitしないようにしたい Tomohisa Kusukawa 2021/12/26 16:50

操作
1512 Wiki Lists Defect 解決(Resolved) 通常(Normal) 日本語の説明Wikiでエラー Tomohisa Kusukawa 2021/04/18 12:00 0.0.11

操作
1511 Wiki Lists Defect 終了(Closed) 通常(Normal) Ruby2.7でエラーになる Tomohisa Kusukawa 2021/04/18 08:33 0.0.10

操作
1507 Work Time Defect 解決(Resolved) 高め(High) Work Time cannot be saved with Redmine-trunk(r19944) Tomohisa Kusukawa 2020/11/03 11:05 Work Time - 0.4.1

操作
1504 Work Time Defect 新規(New) 通常(Normal) 日毎工数入力時、工数の書き込みに失敗しても、メモは追記される Tomohisa Kusukawa 2020/08/05 09:10 Work Time - 0.4.0

操作
1502 Work Time Defect 終了(Closed) 通常(Normal) redmine work time plugin fails Tomohisa Kusukawa 2020/10/04 17:24 Work Time - 0.4.1

操作
1501 r-labs Defect 終了(Closed) 通常(Normal) redmine work time plugin fails 2019/06/23 18:19

操作
1499 Work Time Support 終了(Closed) 通常(Normal) support Redmine4.0 (Rails5) Tomohisa Kusukawa 2020/10/04 17:25 Work Time - 0.4.0

操作
1497 Wiki Lists Feature 終了(Closed) 通常(Normal) filter by enum value of custom field: key value list Tomohisa Kusukawa 2021/04/18 08:35 0.0.10

操作
1482 Wiki Lists Feature 終了(Closed) 通常(Normal) want to use field reference of Issue in History part Tomohisa Kusukawa 2021/04/18 08:34 0.0.10

操作
1477 Work Time Question 新規(New) 通常(Normal) チケットに関連づいてない作業時間の集計について 2017/07/27 00:28

操作
1476 Wiki Lists Defect 終了(Closed) 高め(High) Mysql2::Error: Not unique table/alias: 'users' Tomohisa Kusukawa 2023/11/24 07:06 0.0.9

操作
1447 Wiki Lists Feature 終了(Closed) 通常(Normal) recognize login name by filter attribute 'treated' Tomohisa Kusukawa 2017/07/29 09:51 0.0.8

操作
1446 Wiki Lists Feature 終了(Closed) 通常(Normal) add [current_project_id] for value field Tomohisa Kusukawa 2017/07/29 09:51 0.0.8

操作
1428 Work Time Feature 終了(Closed) 通常(Normal) CKEditorプラグイン利用時にmemoが正しく読み書きできるようにしたい Tomohisa Kusukawa 2016/08/27 23:15 Work Time - 0.3.3

操作
872 Work Time Defect 終了(Closed) 通常(Normal) 権限設定の項目順序変更 Tomohisa Kusukawa 2023/11/26 17:35 Work Time - 0.1.5

操作

変更履歴

ロードマップ

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