高度なワークフロー

概要

ビジネスプロセスの柔軟な設定と自動化を実現するプラグインです。 Redmineの標準的なワークフローを超える複雑なシナリオを設定し、自動的に実行することができます。柔軟な「カスタムルール」システムにより、特定の制限を設定できます。

---

主な機能

• カスタムフィールドの新しい形式：「日付と時刻」
• カスタムルール
• 自動アクション

---

互換性

Redmine: 5.0 - 6.1

ウェブブラウザ: Chrome, Firefox, Safari, Edge

データベース: MySQL 5.7, MySQL 8.0, PostgreSQL 14-16, SQLite

プラグイン: redmine_kanban, redmine_advanced_checklists, advanced_charts, appearance_custom, module_manager, periodic_reminder, user_group_editor, queries_perfect, selectbox_autocompiler, cost_calculator

---

インストールとアップデート

1. 古いバージョンのプラグインがRedmineに存在する場合は削除してください。

   cd redmine/plugins
   rm -r advanced_workflow
   

2. 新しいプラグインフォルダ advanced_workflow を redmine/plugins/ にコピーしてください。
3. Redmineのルートディレクトリでマイグレーションを実行してください。

   bundle exec rake redmine:plugins:migrate RAILS_ENV=production NAME=advanced_workflow
   

4. Redmineを停止して起動してください。（一部のRedmineインストール（例：Docker）では、サーバーを単に再起動するのではなく、停止してから起動することが重要です。）

---

削除

1. Redmineのルートディレクトリで削除コマンドを実行してください。

    bundle exec rake redmine:plugins:migrate RAILS_ENV=production NAME=advanced_workflow VERSION=0

2. プラグインフォルダ advanced_workflow を redmine/plugins/ から削除してください。

    rm -r advanced_workflow

3. Redmineを停止して起動してください。

---

設定

1. 「管理」->「ロールと権限」でユーザーロールを設定してください。
2. 各プロジェクトの設定で「高度なワークフロー」モジュールを有効にしてください。
3. 「管理」->「モジュール」->「高度なワークフロー」で、その他のプラグイン設定を確認および変更してください。

---

管理

**「ロールと権限」**セクション

• プロジェクトレベルでルールを管理 - プロジェクト内のルールとアクションの変更へのアクセス。

---

**「カスタムフィールド」**セクション

高度なワークフロープラグインは、カスタムフィールドの新しい形式「日付と時刻」を追加します。

**「日付と時刻」**はフィルター（条件）として使用できます。

利用可能なオプション：

• 次の時間 - フィルターは、UTC現在時刻から次の1時間以内に「日付と時刻」フィールドの値が含まれるチケットを対象とします。

---

**「モジュール」**セクション

管理 -> モジュール -> 高度なワークフロー で設定可能な項目:

• ユーザーとして実行 - スケジュールに従ってアクションを実行する管理者を選択するオプション。

• スケジュールされたアクションの実行中の最大チケット数。

---

**「カスタムルール」**セクション

カスタムルールを使用すると、特定の条件下でチケットをユーザーに割り当てる制限を設定できます。

管理 -> カスタムルール でルールを作成および設定できます。

ルールの作成

作成時には、名前とアクティブ化を指定する必要があります。

ルールの編集

ルールの作成後、条件および制限を編集できます。

利用可能な条件：

• プロジェクト
• トラッカー
• バージョン
• 作成者
• 現在のユーザー
• グループに割り当て
• 作成者グループ
• ロールに割り当て
• 現在のユーザーのロール
• チケットのステータス
• 親チケットのトラッカー
• 親チケットのバージョン
• カスタムフィールド「チケット」（タイプ：「リスト」、「テキスト」、「浮動小数点」、「整数」、「日付」、「日付と時刻」）
• カスタムフィールド「プロジェクト」（タイプ：「リスト」、「テキスト」、「浮動小数点」、「整数」、「日付」）

利用可能な制限：

• 担当者
• 担当グループ
• 担当者のロール
• 期日
• トラッカー
• バージョン

---

**「自動アクション」**セクション

自動アクションを使用すると、チケットの保存時またはスケジュールに従って、特定の条件下で選択したアクションを実行できます。

管理 -> 自動アクション でアクションを作成および設定できます:

アクションの作成

作成時には、名前、実行方法、アクティブ化を指定する必要があります。

アクションは次の2つの異なる方法で実行できます。

• 保存時 - アクションはチケットの作成/編集時にすぐに実行されます。

• Cron job - ルールはcronスケジュールに従って定期的に実行されます。

アクションの編集

アクションの作成後、条件とアクションを編集できます。

利用可能な条件：

• チケットの標準フィルター
• チケットのカスタムフィルター

利用可能なアクション：

• 担当者
• 保存を無効化
• メールを送信
• ステータス
• トラッカー
• バージョン
• オープンなサブタスクのバージョン
• ウォッチャー
• ウェブフック（得る）
• ウェブフック マターモスト
• ウェブフック 電報
• チェックリスト（:redmine_advanced_checklists プラグインがインストールされている場合）

「メール送信」、「ウェブフック (得る)」、「ウェブフック 最重要」、「ウェブフック Telegram」アクションでは、アクション変数が利用できます。

---

使い方

ルールとアクションの有効化

ルールとアクションを作成した後、プロジェクト設定で個別に有効にする必要があります。

これを行うには、以下に移動します。

プロジェクト -> 設定 -> カスタムルール、 このプロジェクトに必要なルールを有効にします。

プロジェクト -> 設定 -> 自動アクション、 このプロジェクトに必要なアクションを有効にします。

カスタムルール

条件が満たされた場合に適用される利用可能な制限:

担当者:

チケットは選択したユーザーにのみ割り当てることができます。

担当グループ:

チケットは選択したグループのメンバーであるユーザーにのみ割り当てることができます。

担当者のロール：

チケットはプロジェクトで選択したロールを持つユーザーにのみ割り当てることができます。

期日:

チケットの期日は、定義された日付範囲内でのみ指定できます。

トラッカー:

チケットは選択したトラッカーのみを持つことができます。

バージョン:

チケットは選択したバージョンのみを持つことができます。

自動アクション

実行方法 「Cron job」

アクションはcronスケジュールに従って定期的に実行されます。

自動アクションが正しく機能するには、bundle exec rake advanced_workflows:run_actions コマンドを実行する新しいコマンドをサーバーのcrontabに追加する必要があります。

コマンドの例:

*/5 * * * * cd /absolute/path/to/redmine && redmine bundle exec rake advanced_workflows:run_actions >> /absolute/path/to/redmine/logs/cron_advanced_workflows.log

Redmineが起動しているユーザーの名義で、このコマンドをcronに追加し、/絶対パス/redmineをRedmineインストールフォルダの絶対パスに置き換えます。

cronコマンドは5分ごとに実行されます*/5 * * * *

すべての標準メッセージは、.../logs/cron_advanced_workflows.logファイルに追加されます。

条件が満たされた場合に実行される利用可能なアクション：

ウェブフック (得る):

指定されたURLに得るリクエストを送信します。 Jiraとの同期など、外部システムとの統合に使用されます。

すべてのチケットフィールド変数をサポートします。

ウェブフック 最重要:

最重要形式で指定されたURLにメッセージを送信します。 最重要との統合に使用されます。

すべてのチケットフィールド変数をサポートします。

ウェブフック Telegram

Telegram形式で指定されたURLにメッセージを送信します。 Telegramとの統合に使用されます。

すべてのチケットフィールド変数をサポートします。

メールを送信:

指定されたユーザーまたはグループのユーザーにメールを送信します。

すべてのチケットフィールド変数をサポートします。

バージョン:

チケットのバージョンを自動的に変更します。

• 現在のチケットのバージョンに置き換える - チケットのバージョンをプロジェクトの現在の（有効な）バージョンに置き換えます。

オープンなサブタスクのバージョン:

• 変更先 - すべてのオープンなサブタスクのバージョンを指定されたバージョンに変更します。

• チケットのバージョンと同じに設定 - すべてのオープンなサブタスクのバージョンをチケットのバージョンに変更します。

保存を無効化:

チケットの作成/編集を無効にします。

ウォッチャー:

指定されたウォッチャーをチケットに追加します。

ステータス:

チケットのステータスを指定されたステータスに変更します。

トラッカー:

チケットのトラッカーを指定されたトラッカーに変更します。

チェックリスト:

:redmine_advanced_checklists プラグインがインストールされている場合に利用可能です。

条件が満たされたときに、テンプレートからチェックリストを自動的に作成します。

事前に準備されたテンプレートを使用してください。