チケット拡張マニュアル2.0

オープンソース ソリューション専門企業

株式会社アンコウソフト-1-

www.ankosoft.co.jp

チケット拡張マニュアル2.0

目次
1. 機能紹介 .................................................................................................................................................................................................................3
1.1

一括編集 ...................................................................................................................................................................................................3

1.2

チケット閲覧履歴 ................................................................................................................................................................................4

1.3

チケットのステータス履歴検索.....................................................................................................................................................5

1.4

チケットインポート時の自動フィールドマッチング ...........................................................................................................5

1.5

チケット一覧の幅の自動調節 .........................................................................................................................................................6

1.6

チケット終了ステータス時に進捗率を 100%に適用 ..............................................................................................................8

2. インストールと支援環境 ................................................................................................................................................................................9
2.1

インストールと支援環境 ..................................................................................................................................................................9

3. プラグインのインストールとアンインストール ............................................................................................................................... 10
3.1

インストール（Linux 系列） ....................................................................................................................................................... 10

3.2

アンインストール(Linux 系列) ................................................................................................................................................... 11

3.3

インストール (Windows 系列) ..................................................................................................................................................... 12

3.4

アンインストール(Windows 系列) .............................................................................................................................................. 15

3.5

インストールされたプラグインのバージョン確認............................................................................................................. 16

4. 設定 ....................................................................................................................................................................................................................... 17
4.1

プラグイン ........................................................................................................................................................................................... 17

4.2

ライセンスの登録 ............................................................................................................................................................................. 23

4.3

権限 ......................................................................................................................................................................................................... 24

5. 機能説明 .............................................................................................................................................................................................................. 25
5.1

一括編集 ................................................................................................................................................................................................ 25

5.2

予定時間と作業時間 ......................................................................................................................................................................... 27

5.3

チケット閲覧履歴表示 .................................................................................................................................................................... 28

5.4

チケットステータス履歴フィルタ ............................................................................................................................................. 31

5.5

チケットインポート時の自動フィールドマッチング ........................................................................................................ 33

5.6

チケット一覧フィールドの幅の調節 ........................................................................................................................................ 34

5.7

終了ステータスの場合進捗率を自動で 100%に変更 ........................................................................................................... 36

6. 制約事項 .............................................................................................................................................................................................................. 37-2-

www.ankosoft.co.jp

チケット拡張マニュアル2.0

1. 機能紹介
1.1
1)

一括編集
既存の Redmine ではチケットを１件ずつ編集する不便さがありました。本製品はこの問題を解消するためにチケットを一括編集することができる機能を提供します。進捗率、ステータス、担当者、日程などを一括編集画面で変更することができます。一括編集画面で変更することができるフィールドは Redmine のシ
ステム管理者権限者が任意に指定することができます。また、予定時間と作業時間も一括編集することができ、合計の目標値を決めてチェックすることもできます。

<「一括編集」メニュー選択画面><一括編集結果画面>-3-

www.ankosoft.co.jp

チケット拡張マニュアル2.0<予定時間と作業時間入力画面>

1.2
1)

チケット閲覧履歴
チケットをいつ・誰が閲覧したのかを把握するために、チケット閲覧履歴機能を通して確認することができます。また、一度チケットを閲覧した後に説明やコメントが変更されたり追加された時に再びチケットを閲覧する必要がある場合、「閲覧有無」検索フィルタを通して確認することができます。

<チケット閲覧履歴画面>-4-www.ankosoft.co.jp

チケット拡張マニュアル2.0

1.3
1)

チケットのステータス履歴検索
チケットのステータスを変更した履歴を検索することができる機能です。チケット一覧ページで、検索フィルタでステータス履歴変更日を指定して、該当期間の変更されたステータスと変更された日時をチケッ
ト一覧で確認できます。

<ステータス履歴検索画面>

1.4
1)

チケットインポート時の自動フィールドマッチング
既存の Redmine4.2 未満で提供しているチケットインポート機能（CSV ファイルでチケットを一括で登録できる機能）を使う時に、「フィールドの対応関係」欄で、インポートするフィールドの指定を手動でする必要がありました。本プラグインでは CSV ファイルのフィールド名とチケットのフィールド名が同じ場合、自動でマッチングします。

<CSV ファイルのフィールド名とチケットのフィールド名の自動マッチング画面>-5-

www.ankosoft.co.jp

チケット拡張マニュアル2.0

1.5
1)

チケット一覧の幅の自動調節
チケット一覧で各項目の幅を自動調節することができる機能です。幅の調節は 4 種類のオプションを提供します。

⚫ モニターサイズに自動調節(幅調節不可)- ノーマル Redmine で提供する形態で、モニターサイズに自動的に調節された画面で構成されます。

<モニターサイズに自動調節(幅調節不可)での画面>⚫ モニターサイズに自動調節(幅調節可能)- モニターサイズに自動的に調節された画面で表示されますが、手動で幅を調整することが可能です。

<モニターサイズに自動調節(幅調節可能)での画面>-6-

www.ankosoft.co.jp

チケット拡張マニュアル2.0⚫ 文字幅に自動調節(幅調節不可)- 各項目の文字幅に合わせて自動的に調節された画面で表示され、幅を調整することはできません。

<文字幅に自動調節(幅調節不可)での画面>⚫ 文字幅に自動調節(幅調節可能)- 文字幅に自動調節(幅調節可能)各項目の文字幅に合わせて自動的に調節された画面で表示され、手動で幅を調整することができます。

<文字幅に自動調節(幅調節可能)での画面>-7-

www.ankosoft.co.jp

チケット拡張マニュアル2.0

1.6
1)

チケット終了ステータス時に進捗率を 100%に適用
チケットステータスを終了に変更しても進捗率を 100%に変更しない場合があります。この問題を解決する
ために終了ステータスにした場合、自動で進捗率を 100%と入力して、変更履歴にも記録が残ります。

<自動で進捗率が 100%に変更された画面>-8-

www.ankosoft.co.jp

チケット拡張マニュアル2.0

2. インストールと支援環境
2.1 インストールと支援環境
1)

本製品をインストールして使用するためには下記の環境が必要です。本製品をインストールする前にインストール先環境と支援環境が正しいことをご確認ください。
区分

インストール

支援環境

2)

種別

種類とバージョン

備考

Redmine3.x ～ 4.2Ruby

2.0 ～ 2.7

Database

Mysql、MariaDB、Postgresql、Microsoft SQL Server

Plugins

Openalm Common 1.7.5 以上

本製品と一緒に提供します。

Chrome、Safari、Edge、Firefox

IE はサポートをしませんが、IE11 では動作することを確認しています。
Safari では項目「1.5」の「チケット一覧の幅の自動調節」機能は提供しません。

Browsers

プラグインのインストール環境の確認方法はシステム管理者で Redmine にログイン後、「管理」->「情報」
で確認できます。
* ユーザーのアクションが必要な場合はで表示します。

で表示し、結果と参照を示す場合は<プラグインのインストール環境の確認画面>-9-

www.ankosoft.co.jp

チケット拡張マニュアル2.0

3. プラグインのインストールとアンインストール
3.1 インストール（Linux 系列）
1)

インストール環境は顧客の環境によって異なるため、パスなどは顧客環境に読み替えて適用してください。
例示では bitnami を使って Redmine をインストールした場合のプラグインのインストール方法で説明します。

2)

弊社から提供する圧縮ファイルを下記のパスに解凍してください。
解凍先パス: {REDMINE_ROOT}/plugins
もし openalm_common がすでに Redmine にインストールされている場合、 インストールされている
openalm_common と弊社が提供する openalm_common のバージョンが同一の場合は、openalm_common を新たにインストールする必要がありません。openalm_common のファイル名のアンダーバーより右側の数字がバージョンを意味します。
例) ファイル名が「openalm_common_1.7.5.zip」 の場合、「1.7.5」がバージョンです。
#cd /opt/redmine-xxx#./use_redmine#cp openalm_common_x.x.x.zip /opt/redmine-xxx/apps/redmine/htdocs/plugins (すでに同一のバージョンがインストールされている場合は省略します。)#cp openalm_extended_fields_x.x.x.zip /opt/redmine-xxx/apps/redmine/htdocs/plugins#cd /opt/redmine-xxx/apps/redmine/htdocs/plugins#unzip openalm_common_x.x.x.zip (すでに同一のバージョンがインストールされている場合は省略します。)#unzip openalm_extended_fields_x.x.x.zip

3)

DB にテーブルを生成します。
#cd /opt/redmine-xxx/apps/redmine/htdocs#bundle exec rake redmine:plugins:migrate RAILS_ENV=production== 20200205035655 CreateOpenalmCommonHolidays: migrating ======================-- create_table(:openalm_common_holidays, {:options=>"ENGINE=InnoDB", :id=>:integer})-> 0.0273s== 20200205035655 CreateOpenalmCommonHolidays: migrated (0.0273s) =============== 20200618054704 CreateOpenalmEmailTemplates: migrating ======================-- create_table(:openalm_email_templates, {:options=>"ENGINE=InnoDB", :id=>:integer})-> 0.0189s== 20200618054704 CreateOpenalmEmailTemplates: migrated (0.0190s) =============== 20200622040653 CreateOpenalmUpdateErrorLogs: migrating =====================-- create_table(:openalm_update_error_logs, {:options=>"ENGINE=InnoDB", :id=>:integer})-> 0.0169s== 20200622040653 CreateOpenalmUpdateErrorLogs: migrated (0.0169s) ============== 20200622040913 CreateOpenalmEtcErrorLogs: migrating ========================-- create_table(:openalm_etc_error_logs, {:options=>"ENGINE=InnoDB", :id=>:integer})-> 0.0198s== 20200622040913 CreateOpenalmEtcErrorLogs: migrated (0.0200s) ================= 20201005073351 AddEmailSubjectToOpenalmEmailTemplates: migrating ===========-- add_column(:openalm_email_templates, :email_subject_type, :string, {:default=>"template"})-> 0.0121s== 20201005073351 AddEmailSubjectToOpenalmEmailTemplates: migrated (0.0122s) ==== 20201015060000 CreateOpenalmIssueViewHistories: migrating ==================-- create_table(:openalm_issue_view_histories, {:options=>"ENGINE=InnoDB", :id=>:integer})-> 0.0139s-- add_index(:openalm_issue_view_histories, :issue_id)-> 0.0050s-- add_index(:openalm_issue_view_histories, :user_id)-10-

www.ankosoft.co.jp

チケット拡張マニュアル2.0-> 0.0064s== 20201015060000 CreateOpenalmIssueViewHistories: migrated (0.0256s) =========

4)

エラーが発生しないで正常に実行できたら web サーバーを再起動させることによってインストールが完了します。
#cd /opt/redmine-xxx#./ctlscript.sh restart apache

3.2 アンインストール(Linux 系列)
1)「openalm extended fields」プラグインで使用するテーブルを DB から削除します。テーブル削除後は関連データーを復元することはできません。
#cd /opt/redmine-xxx#./use_redmine#cd /opt/redmine-xxx/apps/redmine/htdocs#bundle exec rake redmine:plugins:migrate NAME=openalm_extended_fields VERSION=0 RAILS_ENV=production== 20201015060000 CreateOpenalmIssueViewHistories: reverting ==================-- remove_index(:openalm_issue_view_histories,{:column=>:user_id, :name=>"index_openalm_issue_view_histories_on_user_id"})-> 0.0488s-- remove_index(:openalm_issue_view_histories,{:column=>:issue_id, :name=>"index_openalm_issue_view_histories_on_issue_id"})-> 0.0056s-- drop_table(:openalm_issue_view_histories, {:options=>"ENGINE=InnoDB", :id=>:integer})-> 0.0460s== 20201015060000 CreateOpenalmIssueViewHistories: reverted (0.1168s) =========

2)「openalm_common」プラグインで使用するテーブルを DB から削除します。テーブル削除後は関連データーを復元することはできません。弊社から購入した他のプラグインがある場合は「openalm_common」プラグインで使用するテーブルを DB から削除しないでください。「openalm_common」プラグインで使用するテーブルを DB から削除すると弊社から購入した他のプラグインが動作しなくなる場合があります。もし「openalm_common」プラグインで使用するテーブルを DB から削除しない場合でも Redmine には影響を与えません。
#bundle exec rake redmine:plugins:migrate NAME=openalm_common VERSION=0 RAILS_ENV=production== 20201005073351 AddEmailSubjectToOpenalmEmailTemplates: reverting ===========-- remove_column(:openalm_email_templates, :email_subject_type, :string, {:default=>"template"})-> 0.1061s== 20201005073351 AddEmailSubjectToOpenalmEmailTemplates: reverted (0.1111s) ==== 20200622040913 CreateOpenalmEtcErrorLogs: reverting ========================-- drop_table(:openalm_etc_error_logs, {:options=>"ENGINE=InnoDB", :id=>:integer})-> 0.0297s== 20200622040913 CreateOpenalmEtcErrorLogs: reverted (0.0299s) ================= 20200622040653 CreateOpenalmUpdateErrorLogs: reverting =====================-- drop_table(:openalm_update_error_logs, {:options=>"ENGINE=InnoDB", :id=>:integer})-> 0.0180s== 20200622040653 CreateOpenalmUpdateErrorLogs: reverted (0.0183s) ============== 20200618054704 CreateOpenalmEmailTemplates: reverting ======================-- drop_table(:openalm_email_templates, {:options=>"ENGINE=InnoDB", :id=>:integer})-> 0.0088s== 20200618054704 CreateOpenalmEmailTemplates: reverted (0.0090s) =============== 20200205035655 CreateOpenalmCommonHolidays: reverting ======================-- drop_table(:openalm_common_holidays, {:options=>"ENGINE=InnoDB", :id=>:integer})-11-

www.ankosoft.co.jp

チケット拡張マニュアル2.0-> 0.0146s== 20200205035655 CreateOpenalmCommonHolidays: reverted (0.0148s) =============

3)

プラグインフォルダーを削除します。
#cd plugins#rm -rf openalm_extended_fields#rm -rf openalm_common (「openalm_common」プラグインを残す必要がある場合は実施をしません。)

4)

エラーがなく正常に実行されたら、web サーバーを再起動するとアンインストールが完了します。
#cd /opt/redmine-xxx#./ctlscript.sh restart apache

3.3 インストール (Windows 系列)
1)

インストール環境は顧客の環境によって異なるため、パスなどは顧客環境に読み替えて適用してください。
例示では bitnami を使って Redmine をインストールした場合のプラグインのインストール方法で説明します。

2)

弊社から提供する圧縮ファイルを下記のパスに解凍してください。
解凍先パス: {REDMINE_ROOT}/plugins
もし openalm_common がすでに Redmine にインストールされている場合、 インストールされている
openalm_common と弊社が提供する openalm_common のバージョンが同一の場合は、openalm_common を新たにインストールする必要がありません。openalm_common のファイル名のアンダーバーより右側の数字がバージョンを意味します。
例) ファイル名が「openalm_common_1.7.5.zip」 の場合、「1.7.5」がバージョンです。
「C:\Bitnami\redmine-4.2.0-0\apps\redmine\htdocs\plugins\」（このフォルダパスは環境により異なります。）に「openalm_common」と「openalm_extended_fields」の２つのフォルダーをコピーします。

<プラグインインストールフォルダー>-12-www.ankosoft.co.jp

チケット拡張マニュアル2.0

3)

Windows の「スタート」ボタンをクリックして、「Bitnami Redmine Stack」の中の「Bitnami Redmine
Stack を使用する」をクリックします。

<「Bitnami Redmine Stack を使用する」画面>
4)

コ マ ン ド プ ロ ン プ ト が 起 動 し ま す の で 、 「 bundle exec rake redmine:plugins:migrate
RAILS_ENV=production」を実行します。下図のように「CreateOpenalmIssueViewHistories: migrated」な
どの文字が表示されれば DB にテーブルが正常に生成されたことになります。

<テーブル生成完了画面>-13-

www.ankosoft.co.jp

チケット拡張マニュアル2.0

5)

Windows の「スタート」ボタンをクリックして、「Bitnami Redmine Stack」の中の「Bitnami Redmine
Stack Manager Tool」をクリックして実行します。

<「Bitnami Redmine Stack Manager Tool」クリック画面>
6)「Manage Servers」タブで、「Thin_redmine」と「Thin_redmine2」を選択して「Restart」ボタンをクリックして再起動させます。

<「Thin_redmine」と「Thin_redmine2」の再起動画面>-14-

www.ankosoft.co.jp

チケット拡張マニュアル2.0

3.4 アンインストール(Windows 系列)
1)

インストール環境は顧客の環境によって異なるため、パスなどは顧客環境に読み替えて適用してください。
例示では bitnami を使って Redmine をインストールした場合のプラグインのアンインストール方法で説明
します。

2)

「openalm extended fields」プラグインで使用するテーブルを DB から削除します。テーブル削除後は関連データーを復元することはできません。
項 目 「 3.3.3) 」 で 説 明 を し た 「 Bitnami Redmine Stack 」 を ク リ ッ ク し て 、 「 bundle exec rake
redmine:plugins:migrate NAME=openalm_extended_fields VERSION=0 RAILS_ENV=production」を実行します。下図のように「CreateOpenalmIssueViewHistories: reverted」などの文字が表示されれば DB からテーブルが正常に削除されたことになります。

<テーブル削除完了画面>
3)「openalm_common」プラグインで使用するテーブルを DB から削除します。テーブル削除後は関連データーを復元することはできません。弊社から購入した他のプラグインがある場合は「openalm_common」プラグインで使用するテーブルを DB から削除しないでください。「openalm_common」プラグインで使用するテーブルを DB から削除すると弊社から購入した他のプラグインが動作しなくなる場合があります。もし「openalm_common」プラグインで使用するテーブルを DB から削除しない場合でも Redmine には影響を与えません。
項 目 「 3.3.3) 」 で 説 明 を し た 「 Bitnami Redmine Stack 」 を ク リ ッ ク し て 、 「 bundle exec rake
redmine:plugins:migrate NAME=openalm_common VERSION=0 RAILS_ENV=production」を実行します。下図のように「CreateOpenalmCommonHolidays: reverted」などの文字が表示されれば DB からテーブルが正常に削除されたことになります。

<テーブル削除完了画面>-15-

www.ankosoft.co.jp

チケット拡張マニュアル2.0

4){REDMINE_ROOT}/plugins 配下のプラグインフォルダーを削除します。「openalm_common」プラグインは上記の 3)でテーブルを DB から削除した場合は削除しますが、そうではない場合は{REDMINE_ROOT}/plugins/
openalm_common フォルダーは削除しません。

5)

エラーがなく正常に実行されたら、web サーバーを再起動するとアンインストールが完了します。web サー
バーを再起動させる方法は項目「3.3.5)」と「3.3.6)」と同じです。

3.5

インストールされたプラグインのバージョン確認

1)

システム管理者(admin)権限があるユーザーで Redmine にログインして「管理」>「情報」をクリックすると、Redmine plugins の項目にインストールされたプラグイン名が下図のように表示されます。

2)

Redmine plugins の欄に「openalm_common」と「openalm_extended_fields」が表示されることを確認してください。

<プラグインが正常にインストールされた画面>-16-

www.ankosoft.co.jp

チケット拡張マニュアル2.0

4. 設定
4.1
1)

プラグイン
システム管理者(admin)権限があるユーザーで Redmine にログインして「管理」> 「プラグイン」>「OPENALM Common plugin」の設定をクリックします。

<プラグイン設定画面>
2)「チケットのトラッカー別の色」ではチケットのトラッカー別の色を指定して、チケット一覧でチケットのトラッカー別の色を区別するために設定します。色設定欄でマウスの左ボタンをクリックすると色を選択できるカラーピッカー画面が表示され、任意の色をマウスで選択すると、色コードが入力できます。もし希望する色を選択できない場合、直接色コードを入力することも可能です。

<チケットのトラッカー別の色の設定画面>-17-

www.ankosoft.co.jp

チケット拡張マニュアル2.0

3)

チケット一覧ページで、チケットのトラッカー別に色が表示されることを確認することができます。

<チケットのトラッカー別の色が表示された画面>
4)「チケットの優先度別の色」では、チケットの優先度によって色を表示するための設定で、色の欄でマウスの左ボタンをクリックすると、色選択メニューが表示されて、任意の色をクリックすると、色コード値が入力されます。各優先度別に、背景色、文字色、枠の色を指定することができます。

<チケットの優先度別の色の設定画面>
区分
低め
通常
高め
急いで
今すぐ

背景色
#eaf7ff#ffc4c4#f7a8a8#f07d7d

文字色#555599#db0306#c90206#990000<色のサンプル>-18-

枠色#add7f3#ffb4b4#f7a8a8#f07d7d

www.ankosoft.co.jp

チケット拡張マニュアル2.0

5)

チケットの一覧ページで、チケットの優先度別の色が表示された画面を確認することができます。

<チケットの優先度別の色が適用された画面>
6)「チケットのユーザーのポップアップ」欄でチケットの担当者選択ポップアップに表示する項目を指定できます。ここで設定した値がユーザーの担当者を検索する時に一緒に表示されます。必須設定ではないた
め、必要に応じて設定してください。「チケットのユーザーのポップアップ」欄に表示されるフィールドはユーザー情報に追加されたカスタムフィールド名が表示されます。その登録方法は下記のとおりです。

<チケットのユーザーのポップアップの設定画面>-19-

www.ankosoft.co.jp

チケット拡張マニュアル2.0

7)「管理」->「カスタムフィールド」->「新しいカスタムフィールド」をクリックして、任意のカスタムフ
ィールドを「ユーザー」に作成します。

<「ユーザー」のカスタムフィールド定義画面>
8)

チケットの担当者の横にある検索アイコンをクリックすると、担当者選択ポップアップ画面が表示されます。下図の例示では、上の項目で設定した「チーム」と「部署」のカスタムフィールドの値が表示されています。

<担当者選択ポップアップ画面>-20-

www.ankosoft.co.jp

チケット拡張マニュアル2.09)システム管理者(admin)権限があるユーザーで Redmine にログインして「管理」> 「プラグイン」>「OPENALM Extended Fields plugin」の設定をクリックします。

<チケット拡張の設定画面>-21-

www.ankosoft.co.jp

チケット拡張マニュアル2.0

区分
一括編集

説明
「一括編集」画面に表示・編集するフィールドを指定します。

予定時間と作業時間「予定時間と作業時間」画面に表示・編集するフィールドを指定します。

チケットの閲覧の有無確認をする日時(登録日基準)

チケットの閲覧の有無を確認する基準日を定めます。登録日を基準として設定した日時から閲覧の有無を確認します。設定しなければ既存チケット
は全部未閲覧された状態になります。プラグインを適用した日時を設定することを推薦します。
チェックボックスをオンにすると、チケットを閲覧するたびに閲覧履歴を残して詳細をクリックすると詳細閲覧日時が表示されます。

チケット閲覧履歴を閲覧時ごとに登録<「チケット閲覧履歴を閲覧時ごとに登録」をオンにした場合>
チェックボックスをオフにすると、閲覧履歴で「最初の閲覧日時」と「最新の閲覧日時」が表示され、詳細閲覧日時は表示されません。

チケット一覧フィールドの幅の調節

終了ステータスの場合進捗率を自動で 100%に変更
検索条件で使用するステータ
ス履歴<「チケット閲覧履歴を閲覧時ごとに登録」をオフにした場合>
チケット一覧フィールドの幅の調節を設定できます。
下記の４つの設定値から任意の値を選択してください。
⚫ モニターサイズに自動調節(幅調節不可)⚫ モニターサイズに自動調節(幅調節可能)⚫ 文字幅に自動調節(幅調節不可)⚫ 文字幅に自動調節(幅調節可能)「オン」にすると、チケットのステータスの項目で「終了ステータス」に変更される場合、進捗率を自動で 100%に変更します。
チケット一覧ページで「ステータス履歴」というフィルタに表示されるス
テータスを指定します。

-22-www.ankosoft.co.jp

チケット拡張マニュアル2.0

4.2
1)

ライセンスの登録
システムセキュリティーキーをコピーして下記のリンク先のページをブラウザで開いて、評価版もしくは購入したライセンスキーを取得して、取得したライセンスキーを「ライセンスキー登録」に入力して適用をクリックしてライセンスキーを登録します。

https://www.redmine-marketplace.com

2)

正常にライセンスキーが登録されると、有効期限が表示されます。

3)

有効期限が満了になると下図のように表示されます。

-23-

www.ankosoft.co.jp

チケット拡張マニュアル2.0

4.3
1)

権限
システム管理者(admin)権限があるユーザーで Redmine にログインして「管理」>「ロールと権限」をクリックして権限を付与したいロールをクリックします。

<「ロールと権限」ページ画面>
2)

チケットトラッキングの「閲覧履歴」はチケットを閲覧した履歴を表示ができる権限で、必要に応じて付与してください。デフォルト値はオフになっています。

<「ロールと権限」設定画面>
3)「閲覧履歴」権限がある場合は、チケットを詳細ページで閲覧履歴アイコンが表示されます。

<「閲覧履歴」アイコンが表示された画面>-24-

www.ankosoft.co.jp

チケット拡張マニュアル2.0

5. 機能説明
5.1
1)

一括編集
チケット一覧画面で一括編集するチケットを選択します。チケットの選択方法は、下図のように、チケッ
ト番号の左側のチェックボックスをオンにすることにより、選択できます。一括編集するチケットを選択した後に、マウス右ボタンをクリックするとコンテクストメニューが表示されますので、「一括編集」をクリックします。

<一括編集するチケットを選択した画面>
2)

一括編集画面で編集したいフィールドを編集してください。もし編集したいフィールドが一括編集画面に表示されていない場合は、項目「4.1」の「プラグイン」を参考にしてフィールドを追加してください。

3)

各フィールドの値を変更後、送信ボタンをクリックするとチケットの変更・更新が実行され、更新結果をお知らせするポップアップ画面が表示されます。必須項目の値が空欄の場合など、何らかの理由で更新に失敗する場合があります。その際にはチケット更新に失敗した理由が表示されるので、再度正しい値を入力して「送信」ボタンをクリックしてチケットの更新をしてください。

<「一括編集」画面>-25-

www.ankosoft.co.jp

チケット拡張マニュアル2.0<正常に反映された画面><エラーメッセージが表示された画面>-26-

www.ankosoft.co.jp

チケット拡張マニュアル2.0

5.2
1)

予定時間と作業時間
チケットに対して予定時間(計画)と作業時間(実績)を入力する時に一括で入力できる機能です。「一括編集」画面で「予定時間と作業時間」をクリックすると「予定時間と作業時間」を入力できる画面が表示されます。

<予定時間と作業時間編集画面>
2)

このページに表示される項目は任意に変更できます。項目「4.1」の「プラグイン」を参考にして表示する
フィールドを選択してください。

<予定時間と作業時間編集画面>-27-

www.ankosoft.co.jp

チケット拡張マニュアル2.0

3)

各項目の説明は下記の表のとおりです。

区分
総予定時間
予定時間合計チェック

合計作業時間
作業時間合計チェック

5.3
1)

説明
該当チケットの予定工数時間を表示します。親チケットの場合は、子チケットの予定工数時間を含んだ合計値を表示します。
予定工数の最下段にある「合計チェック」チェックボックスをオンにすると目標とする値を入力すると予定工数時間の合計が目標として入力した値と等しくなるまでチェックをします。
該当チケットの作業時間の合計で、親チケットの場合は、子チケットの作業時間を含んだ合計値を表示します。
作業時間の最下段にある「合計チェック」チェックボックスをオンにすると目標とする値を入力すると作業時間の合計が目標として入力した値と等しくなるまでチェックをします。

備考

チケット閲覧履歴表示
チケット詳細ページで「閲覧履歴」をクリックすると、「閲覧履歴」がポップアップで表示され、閲覧者
名、最初の閲覧日時、最近の閲覧日時が一覧で表示されます。

<閲覧履歴画面><閲覧履歴ポップアップ画面>-28-

www.ankosoft.co.jp

チケット拡張マニュアル2.0

2)

プラグイン設定で「チケット閲覧履歴を閲覧時ごとに登録」をオンにした場合は、下記のように「最近の閲覧日時」の欄をクリックすると、詳細閲覧日時が表示されます。

<「チケット閲覧履歴を閲覧時ごとに登録」設定画面><閲覧履歴詳細画面>
3)

チケット一覧のフィルタで「閲覧有無」を検索条件に追加できます。検索条件を「等しい」＋「いいえ」にすると、自分が一度も閲覧していないチケットが表示されます。検索条件を「等しくない」＋「いいえ」にすると自分が一度でも閲覧したチケットが表示されます。

<閲覧有無検索画面>-29-

www.ankosoft.co.jp

チケット拡張マニュアル2.0

4)

オプションで「閲覧有無」を選択すると、チケット一覧ページに「閲覧有無」情報が表示されます。
チケット作成後一度でも自分が該当チケットの詳細ページを表示した場合は「閲覧有無」は「はい」状態になり、それ以外の場合は「いいえ」状態になります。

<項目に閲覧有無を追加した画面>
5)

マイページの「追加」をクリックして、「未閲覧チケット(ウォッチ)」や「未閲覧チケット(担当している
チケット)」を選択するとマイページに「未閲覧チケット(ウォッチ)」や「未閲覧チケット(担当している
チケット)」一覧を表示することができます。

<マイページに未閲覧チケットを追加した画面>-30-

www.ankosoft.co.jp

チケット拡張マニュアル2.0

5.4

チケットステータス履歴フィルタ

1)

フィルタに「ステータス履歴」を追加して、検索したいステータスを選択して適用をクリックすると、過去に該当ステータスに変更されたチケットをチケット一覧として表示させることができます。また、フィルタ条件として「ステータス履歴変更日」を追加すると「ステータス履歴」で指定されたステータスが変更された日付を条件にしてチケット一覧に表示させます。新規にチケットを作成した際のステータスは「過去に該当ステータスに変更されたチケット」には含まれません。
「ステータス履歴」で選択可能なステータスは、Redmine のシステム管理者権限でログインをして「管理」->「プラグイン」->「OPENALM Extended Fields plugin」の「設定」をクリックして、「検索条件で使用するステータス履歴」の項目で設定が可能です。もし「検索条件で使用するステータス履歴」が空欄の場
合、「ステータス履歴」フィルタは表示されません。

2)「ステータス履歴変更日」を使用するためには、対象になるステータスを指定する必要があるため、「ステータス履歴」条件を一緒に指定してください。もし「ステータス履歴」を指定しないで、「ステータス
履歴変更日」だけを指定する場合、履歴変更日が存在する全てのステータスのチケットを検索対象にします。

<ステータス履歴とステータス履歴変更日の検索画面>
3)「オプション」の「項目」で「選択された項目」に「ステータス名(履歴変更日時)」を指定して適用ボタ
ンをクリックすると、該当情報がチケット一覧で確認できます。複数回変更された場合は最新の変更日時が表示されます。

-31-

www.ankosoft.co.jp

チケット拡張マニュアル2.0

4)「ステータス名(履歴変更日時)」で選択可能なステータスは、Redmine のシステム管理者権限でログインをして「管理」->「プラグイン」->「OPENALM Extended Fields plugin」の「設定」をクリックして、「検索条件で使用するステータス履歴」の項目で選択された項目になります。

<項目にステータス履歴変更日時を追加した画面>
5)

チケット一覧ページの最下段の「他の形式にエクスポート」で CSV、PDF をクリックすると該当項目が出力されます。

< CSV、PDF 説明画面><PDF で出力した画面>-32-

www.ankosoft.co.jp

チケット拡張マニュアル2.0

5.5
1)

チケットインポート時の自動フィールドマッチング
Redmine4.2 バージョン未満では CSV ファイルでチケットを一括登録する既存のチケットインポート機能を使用する時に、「フィールドの対応関係」を手動でする必要がありました。本プラグインを使用するとCSV ファイルの項目名とチケットのフィールド名が同じ場合、自動でマッチングされます。

<CSV ファイルの項目とチケットフィールドが自動マッチングされた画面><CSV ファイル>-33-

www.ankosoft.co.jp

チケット拡張マニュアル2.0

5.6

チケット一覧フィールドの幅の調節

1) プラグインの設定ページで「チケット一覧フィールドの幅の調節」の項目を指定することにより、次の通りチケット一覧の幅を自動調節することができます。
⚫

モニターサイズに自動調節(幅調節不可)- ノーマルの Redmine で提供する表示形態で、モニターサイズに自動的に調節された画面で表示されます。

<モニターサイズに自動調節(幅調節不可)での画面>⚫ モニターサイズに自動調節(幅調節可能)- モニターサイズに自動的に調節された画面で表示されますが、手動で幅を調整することが可能です。手動で変更した幅はブラウザを閉じると初期化されます。

<モニターサイズに自動調節(幅調節可能)での画面>-34-

www.ankosoft.co.jp

チケット拡張マニュアル2.0⚫ 文字幅に自動調節(幅調節不可)- 各項目の文字幅に合わせて自動的に調節された画面で表示され、幅を調整することはできません。

<文字幅に自動調節(幅調節不可)での画面>⚫ 文字幅に自動調節(幅調節可能)- 各項目の文字幅に合わせて自動的に調節された画面で表示され、手動で幅を調整することができます。
- 手動で変更した幅はブラウザを閉じると初期化されます。

<文字幅に自動調節(幅調節可能)での画面>-35-

www.ankosoft.co.jp

チケット拡張マニュアル2.0

5.7
1)

終了ステータスの場合進捗率を自動で 100%に変更
本機能は、チケットのステータスが終了ステータスになると自動で進捗率を 100%にする機能です。本機能を使用するためには、プラグインの設定ページで「終了ステータスの場合進捗率を自動で 100%に変更」のチェックボックスをオンにしてください。

<プラグイン設定画面>
2)

例として、下図のようにステータスを終了に変更して、進捗率は 80%の状態で保存します。

<進捗率変更例示画面>
3)

保存後は、進捗率が自動で 100%に変更されます。

<自動で進捗率が 100%に変更された画面>-36-

www.ankosoft.co.jp

チケット拡張マニュアル2.0

6. 制約事項
本プラグインには下記のように制約事項があります。
6.1. 「予定時間」や「作業時間」で時間を入力する際の制約事項は基本 Redmine での時間を入力する機能と同一の制約事項が存在します。
例えば、下図のように時間を入力する欄に非常に大きな数字を入力するとある桁数で四捨五入した値に変換されます。また、入力する桁数が大きい場合、下図のように「時間」の文字が他の欄にはみ出て表示されます。
合計時間欄で表示できる文字数よりも多くの文字を含む場合、全ての数値を表示することができません。

6.2. Redmine にログインをしていない匿名ユーザーでチケットを照会しても、チケット照会履歴には記録は残り
ません。

-37-

www.ankosoft.co.jp

チケット拡張マニュアル2.0ⓒ 2022 Ankosoft Inc.
-38-

www.ankosoft.co.jp