ワークフローの作成

このセクションでは、「ワークフローに関する詳しい手順」に記載されているサンプルワークフローの作成方法について説明します。

サンプルワークフローの追加:

1. Swarmの[ワークフロー]ページで、[+ ワークフローを追加]ボタンをクリックします。
2. ワークフローの名前を入力します。
3. 任意: ワークフローの説明を入力します。


4. ルールワークフロールールを以下のように設定します。

   • [レビューなしのコミット時]を[却下]に設定します。
   • [レビューありのコミット時]を[承認済みでない場合は却下]に設定します。
   • [終了状態のレビューの更新時]を[却下]に設定します。
   ヒント

   レビューの保護状態は、Swarm管理者によってグローバルに設定されます。デフォルト設定の場合、[アーカイブ済み]、[却下]、[承認:コミット]の状態になっているレビューが保護されます。

   • [次の賛成票をカウント]を[メンバー]に設定します。

   • [自動的にレビューを承認]を[投票数ベース]に設定します。

     ヒント

     [最小賛成票]の値は、ワークフローが関連付けられているプロジェクトやブランチに対して設定されます。

5. 自分がワークフローの所有者として自動的に追加されます。

   任意: 必要に応じて、自分以外の所有者を追加します。このフィールドに文字を入力すると、Helixサーバ内でその文字に一致するグループやユーザが自動的に表示されます(グループとユーザの組み合わせで最大20件)。

   重要

   • 1つのワークフローにつき、1人以上の所有者が必要です。
   • 所有者である自分自身をワークフローから削除すると、super ユーザ権限を持っていない限り、このワークフローの設定を編集できなくなります。

6. 任意: 自分が所有しているワークフローを他のSwarmユーザも使用できるようにするには、[他のユーザと共有済み]チェックボックスを選択します。

   ヒント

   ワークフロールールが正しく機能することが確認できない場合は、このチェックボックスを選択しないでください。このチェックボックスを選択するまで、自分が所有するワークフローを他のSwarmユーザが使用することはできません。ワークフローに問題がないことを確認してからこのチェックボックスを選択して、他のユーザとワークフローを共有してください。

7. [テスト]

任意: ワークフローにテストを追加します。テストは、ワークフローに関連付けられたレビューの作成時、更新時、または送信時に実行されます。テストの[日時]ドロップダウンから選択されます。

ヒント
• テストは、[保存]ボタンをクリックしたときにのみワークフローに保存されます。
• レビューが複数のワークフローに関連付けられている場合、それらすべてのワークフローのすべてのテストがレビュー用に実行されます。同じテストが複数の関連付けられたワークフローで行われる場合、そのテストは1回だけ実行されます。

テストを追加するには: 

1. テスト領域で、をクリックします。
2. [テスト]ドロップダウンリストから実行するテストを選択します。
3. テストを実行する日時を[日時]ドロップダウンリストから選択します。
   ヒント

   • レビューコンテンツの変更とは、レビュー内のファイルまたはファイルのコンテンツが変更されたときを指します。レビューの説明を変更しても、テストはトリガされません。

   • オンデマンドテストは、レビュー内容の変更チェックによる影響を受けることはありません。

   • [更新時]では、テストは次の場合に実行されます。
     • レビューが作成された場合。

     • レビューが送信され、レビューコンテンツが以前のレビューリビジョンと比較して変更された場合。

     • レビューが更新され、以前のレビューリビジョン以降にレビューコンテンツが変更された場合。
   ヒント

   最後にテストにパスしてからレビューの内容が変更されていない場合、レビューのバージョン作成時や送信時にテストが再実行されることはありません。テストがまだ実行中の場合や、Swarmが「パス」状態で更新されていない場合は、送信時にもテストが再実行されます。

   • [送信時]では、プリコミットレビューが送信された場合、またはポストコミットレビューが作成された場合に、テストが実行されます。
   • [オンデマンド]の場合、テストが自動的に実行されることはありませんが、レビューページの[テストステータス]ドロップダウンで手動でテストを実行することができます。
4. テストが失敗した場合にSwarmで承認をブロックするかどうかを、[ブロック]ドロップダウンリストで選択します。
   • [なし]を選択すると、テストが失敗しても承認はブロックされません。
   • [承認]を選択すると、テストが失敗した場合にレビューの承認がブロックされます。
5. [承認] ボタンをクリックして、テストをワークフローに追加します。

ワークフローでテストを編集するには:

1. 編集するテストの横にある[編集] ボタンをクリックします。
2. [テスト]、[日時]、[ブロック]ドロップダウンリストが表示されます。
3. 必要に応じて変更します。
4. [承認] ボタンをクリックして、変更内容を確認します。

ワークフローからテストを削除するには:

ワークフローから削除するテストの横にある[削除] ボタンをクリックします。

テストはすぐに削除されます。確認は要求されません。テストの削除を完了するには、ワークフローを保存する必要があります。

8. [保存]をクリックします。

   注意

   いずれかの必須フィールドに値が入力されていない場合は、[保存]ボタンが無効になります。

9. これで、プロジェクトに関連付けられたワークフローが作成されました(「ワークフローをプロジェクトまたはブランチに追加する」を参照)。