YouTrack クラウド 2024.3 ヘルプ

ワークフローコンストラクター

ワークフローコンストラクターは、定義済みの条件とアクションを使用して自動化を構築できるコード不要のドラッグアンドドロップインターフェースです。この機能の概要については、この短いビデオを参照してください。

ワークフローコンストラクターにアクセスするには:

  1. アプリケーションヘッダーの 管理メニューから、ワークフローを選択します。

  2. コンストラクターを使用して作成されたワークフローを見つけて、リストから選択します。

  3. サイドバーのワークフローの編集ボタンをクリックします。

    • 選択したワークフローがワークフローコンストラクターで開きます。

ワークフローコンストラクターで新しいワークフローを開いてページにアクセスすることもできます。ワークフローリストから、ワークフローを追加ボタンをクリックし、ワークフローコンストラクターを選択します。

The YouTrack Workflow Constructor.

ワークフローヘッダー

ワークフローコンストラクターの上部には、コンストラクターに現在表示されているワークフローを管理できる対話的なコントロールが表示されます。

The header for the workflow constructor.

次のコントロールは、ワークフローページのヘッダーに表示されます。

コントロール

説明

ワークフロータイトル

現在のワークフローのタイトルを保存します。タイトルを編集するには、テキストをクリックして、入力フィールドに変更を直接入力します。

さらに表示

現在のワークフローで使用できるアクションのリストを表示します。次のアクションを使用できます。

アクション

説明

コードに変換

このアクションは、現在のワークフローを JavaScript 表現に変換します。ビジュアルエディターで作成されたワークフローがコードに変換されると、JavaScript をサポートする Web ベースのワークフローエディターでのみ編集できるようになります。詳細については、Web ベースのワークフローエディターを参照してください。

エクスポート

このアクションにより、現在のワークフローが ZIP アーカイブとしてダウンロードされます。

ワークフローの削除

確認プロンプトに続いて、現在のワークフローを YouTrack から完全に削除します。

プロジェクト

選択したプロジェクトに現在のワークフローをアタッチします。

保存

現在のワークフローへの変更を保存します。

オープン

ワークフローコンストラクターで互換性のあるワークフローを開きます。このメニューの追加オプションを使用すると、ワークフローを削除したり、新しいワークフローを開いたりできます。

全画面モード

全画面モードのオンとオフを切り替えます。全画面モードでは、アプリケーションのヘッダーとフッターが非表示になり、コンストラクターを操作するためのスペースが増えます。

ルールの追加

ルールタイプを選択できるダイアログを開き、現在のワークフローにルールを追加します。

現在のワークフローに属する各ルールは、ワークフローコンストラクターの独自のタブに表示されます。

  • アイコンはルールタイプを示します。ワークフローコンストラクターは、変更時、スケジュール時、アクションのルールをサポートします。

  • タブには、ワークフロールールの名前が表示されます。

  • インジケーターは、ワークフロールールの現在のステータスを示します。アクティブな場合は緑色、非アクティブな場合は灰色です。

ブロック

ワークフローコンストラクターの左側には、ワークフローの構築に使用できるブロックのリストが表示されます。

The sidebar for the workflow constructor.

ブロックは 3 つのセクションに編成されています。

  • ビルドブロックセクションには、一般的な演算子と式が含まれています。これらのブロックを使用して、さまざまな条件とアクションを組み合わせます。

    詳細は、ビルドブロックを参照してください。

  • 条件セクションには、さまざまな状況に対する事前定義されたチェックが含まれています。

    詳細は、条件を参照してください。

  • アクションセクションには、ワークフローを使用して課題に適用できるすべてのアクションが含まれています。

    詳細は、アクションを参照してください。

このパネルの上部にある入力フィールドを使用して、リストまたはブロックを名前でフィルタリングします。これにより、コメント、リンク、タグなどの特定のアイテムをチェックまたは更新できるブロックをすばやく見つけることができます。

ルールヘッダー

各ルールには、ワークフローコンストラクターに現在表示されているルールを管理できる対話的なコントロールのセットがあります。

The header for a rule in the workflow constructor.

次のコントロールは、各ワークフロールールのヘッダーに表示されます。

コントロール

説明

ルールタイプ

現在のルールに割り当てられているルールタイプのアイコンを表示します。ルールタイプを変更するには、アイコンをクリックして別のタイプを選択します。

トリガーをサポートするルールの設定を失うことなく、さまざまなルールタイプを自由に切り替えることができます。

ルール名

現在のワークフロールールの名前を格納します。名前を編集するには、テキストをクリックして、変更内容を入力フィールドに直接入力します。

さらに表示

現在のルールで使用できるアクションのリストを表示します。次のアクションを使用できます。

アクション

説明

クローン

現在のルールのクローンをワークフローに追加します。

ルールの削除

確認プロンプトに続いて、ワークフロールールを完全に削除します。

アクティブ

現在のルールのステータスを切り替えます。ワークフロールールをアクティブ化する前に、少なくとも 1 つのプロジェクトに割り当てて、保存する必要があります。タイトルが付けられていないワークフローは保存できないため、タイトルも必要です。

プロジェクトでルールがアクティブになると、保存されたバージョンのルールに保存されているビジネスロジックが、選択したプロジェクトのすべての課題に適用されます。ワークフローコンストラクターで保存されていない変更は無視されます。

トリガー

ワークフロールールを初期化する初期条件を格納します。

  • 変更時ルールは、課題に更新が適用されるたびに初期化されます。追加のトリガーは考慮されません。

  • オンスケジュールルールは、設定されたスケジュールでトリガーされます。このルールタイプのトリガーセクションでは、スケジュールを選択し、処理に適格な課題を決定するオプションのフィルターを追加できます。詳細については、スケジュール規則を参照してください。

  • アクションルールは、ユーザーが課題で対応するアクションを選択するか、コマンドでアクションを適用するとトリガーされます。このルールタイプのトリガーセクションでは、カスタムアクションの名前を入力できます。詳細については、アクションルールを参照してください。

前提条件

コンストラクターのこのセクションには、ルールを実行するために存在する必要のある一連の条件が格納されます。

  • 条件をワークフロールールの前提条件セクションにドラッグして、基本基準を定義します。

  • 複数の条件を追加すると、各条件は論理 AND 演算子で自動的に接続されます。これは、前提条件セクションのすべての条件が満たされた場合にのみ、ワークフロールールを実行するための前提条件が満たされることを意味します。

    ビルドブロックを使用して、さまざまな方法で条件を組み合わせることができます。詳細については、ビルドブロックを参照してください。

アクション

コンストラクターのこのセクションには、前提条件セクションの条件が満たされたときに課題に適用される一連の更新が格納されます。

  • 1 つ以上のアクションブロックをワークフロールールのアクションセクションにドラッグして、実行するアクションを定義します。

  • 追加の条件を確認してくださいアクションを使用して、トランザクション中に追加のチェックを実行します。詳細については、追加条件を確認するを参照してください。

ローカル変数への参照

ワークフロールールを記述する場合、現在のコンテキストの一部と見なされるすべてのオブジェクトに直接アクセスできます。コンテキストには次が含まれます。

  • ワークフロールールで定義された更新のターゲットとなる課題。

  • アクションが割り当てられているユーザー。

現在の課題と現在のコンテキストでの現在のユーザーの定義は、ルールの種類によって異なります。

ルールタイプ

課題

ユーザー

変更時

変更される課題

この変更を開始したユーザー

スケジュール

検索条件に一致する課題

専用のワークフローユーザーアカウント (パーミッションのフルセットを持つシステムユーザー)

アクション

アクションメニューまたはコマンドを使用してアクションを適用するときに選択される課題

アクションを選択した、またはコマンドを適用したユーザー

現在のコンテキストでも使用できる他のオブジェクトには、対象の課題が属するプロジェクト、プロジェクトチーム、グループ、ロールが含まれます。

現在のコンテキストに含まれているオブジェクトはすべて、ワークフロールールで参照できます。これらのオブジェクトに割り当てられているプロパティまたはフィールドの多くも使用できます。

オブジェクトへの参照の追加

ワークフロールールを作成する場合、さまざまなブロックを使用して、特定の課題、プロジェクト、ユーザーなどへの参照を定義できます。ルールに条件とアクションを追加すると、これらのローカル変数を参照して再利用するオプションがあります。

この動作は、別のブロックから取るオプションでサポートされています。このオプションは、ワークフローで使用される標準オブジェクトへの参照を格納するすべての設定に使用できます。

このオプションは、ワークフローに同じタイプのオブジェクトへの参照を格納するブロックがすでに含まれている場合にのみ使用できます。

ワークフロールールでローカル変数を参照するには:

  1. ローカル変数を保存する設定で、別のブロックから取るオプションを選択します。

    • 有効にすると、互換性のあるオブジェクトを他のブロックに保存する設定がハイライトされます。

    Selecting local variables in a workflow rule.
  2. 現在のブロックに使用する値を含むハイライトされたフィールドを選択します。

    • 選択したフィールドへの参照は、現在のブロックの設定に保存されます。

ワークフロールールの前提条件セクションとアクションセクションの各ブロックには、序数が割り当てられます。他のブロック内のオブジェクトを指す参照には、元の定義を格納するターゲットブロックの序数が付けられます。

A local reference in a workflow rule.

ワークフロールールでブロックを並べ替えると、これらの参照は自動的に更新されます。

フィールドへの参照の挿入

現在のコンテキストでオブジェクトに割り当てられているプロパティまたはフィールドの多くは、変数としても使用できます。これらの変数は、次のような文字列を格納する任意の設定に挿入できます。

  • 課題の概要と説明

  • アラートおよびその他のメッセージ

  • コメントテキスト

  • コマンド

  • タグ

フィールドへの参照を挿入するには:

  1. 文字列を格納する設定の値を設定する場合は、 参照を挿入アイコンをクリックします。

    Option to insert a reference to a local variable.
  2. 文字列に挿入する値へのアクセスを提供するオプションを選択します。現在の課題、現在のユーザーのフィールドとプロパティにアクセスしたり、ワークフロールールの他の場所で定義されているオブジェクトを参照したりできます。

  3. 参照リンクをクリックして、使用可能なフィールドのリストを表示します。

    Browsing available fields for issues.
  4. 文字列に挿入する値を格納するフィールドを選択します。

    • 選択した変数への参照が、設定の値にプレースホルダーとして挿入されます。

    Field references in an action block.

ロギングと検証

ワークフローコンストラクターの下部のセクションは、ワークフロールールの課題を特定して修正できます。

Validity checks in the workflow constructor.

妥当性チェックは、ルールがアクティブなプロジェクトで使用できない要素への参照がルールに含まれている場合に通知します。

  • 自動的に修正できる変更については、プロジェクトを更新するをクリックして、ワークフローコンストラクターを移動せずに、不足している要素をプロジェクト設定に追加できます。

  • タグの欠落や参照の課題などの他の課題は、アプリケーションの別の領域で欠落しているアイテムを手動で作成することによって修正する必要があります。

有効性チェックは、課題が検出された場合にのみ表示されます。それ以外の場合、イベントログはアクティブです。

Event log in the workflow constructor.

イベントログには、ワークフロールールが期待どおりに実行されない原因となったエラーが表示されます。この情報を使用して、課題のトラブルシューティングを行い、他のワークフロールールとの競合を検出します。

イベントログでは、次のコントロールを使用できます。

コントロール

説明

ロギング

現在のルールのログ機能を切り替えます。アクティブなルールのログのみを有効にできます。

ワークフロールールをアクティブ化する前に、少なくとも 1 つのプロジェクトに割り当てて、保存する必要があります。タイトルが付けられていないワークフローは保存できないため、タイトルも必要です。

フィルター

ログエントリのリストをフィルターして、部分文字列と一致するエントリを表示します。このコントロールをもう一度クリックすると、フィルターが非表示になります。

リフレッシュ

リストを再読み込みし、ページの読み込み後に追加された新しいログエントリを表示します。

ダウンロード

現在コンソールにファイルとして表示されているログエントリをダウンロードします。

クリア

イベントログから現在のログエントリを削除します。

関連ページ:

Web ベースのワークフローエディター

YouTrack には、JavaScript でワークフローを作成するために使用できる Web ベースのワークフローエディターが組み込まれています。統合開発環境でコードを書くことを好む場合でも、JavaScript をサポートする外部エディターを使用してワークフローを YouTrack にインポートすることができます。ワークフローコンストラクターにアクセスするには: アプリケーションヘッダーの管理メニューから、ワークフローを選択します。JavaScript で記述されたワークフローを見つけて、リス...

ビルドブロック

ワークフローコンストラクターは、ワークフローの構築に使用できる事前定義されたブロックのセットを提供します。ビルドブロックセクションには、一般的な演算子と式が含まれています。これらのブロックを使用して、さまざまな条件とアクションを組み合わせます。OR:このブロックを使用すると、条件の 1 つが真の場合にワークフロールールを実行できます。例: 次の一連の前提条件は、コメントまたは添付ファイルが課題に追加されたときに、このルールで指定されたアクションを適用します。AND:このブロックを使用すると、ブロ...

条件

ワークフローコンストラクターは、さまざまな事前定義された条件をサポートします。これらの条件により、ワークフロールールを実行するために満たす必要のある基本的な基準を説明できます。条件をワークフロールールの前提条件セクションにドラッグして、基本基準を定義します。複数の条件を追加すると、各条件は論理 AND 演算子で自動的に接続されます。これは、前提条件セクションのすべての条件が満たされた場合にのみ、ワークフロールールを実行するための前提条件が満たされることを意味します。ビルドブロックを使用して、さまざま...

スケジュール規則

on-schedule ルールは、設定されたスケジュールに従って適用される一連の変更を定義します。例: 特定の属性値に関する課題を定期的にチェックし、ユーザーまたはグループに通知することができます。これらのルールは、以前のワークフローで使用されていたスケジュール済みルールを置き換えます。スケジュール通りのルールは、特別なワークフローユーザーによって実行されます。これは、すべての権限が付与されたシステムユーザーアカウントです。このアカウントの権限は変更できません。ワークフローユーザーアカウントはライ...

アクションルール

アクションルールを使用すると、コマンドとして適用したり、課題、記事、コメント、添付ファイルのさらに表示メニューから直接アクセスしたりできるアクションを使用して、YouTrack を拡張できます。アクションルールは、次の YouTrack エンティティで使用できます。課題、記事、課題に関するコメント、記事コメント、添付ファイルを発行する、記事の添付ファイル、アクションルールを作成すると、追加の設定を使用して、ルールをトリガーする方法を指定できます。アクションワークフロールールの実行に使用されるコマ...