YouTrack サーバー 2024.2 ヘルプ

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

YouTrack には、JavaScript でワークフローを作成するために使用できる Web ベースのワークフローエディターが組み込まれています。

統合開発環境でコードを書くことを好む場合でも、JavaScript をサポートする外部エディターを使用してワークフローを YouTrack にインポートすることができます。

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

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

  2. JavaScript で記述されたワークフローを見つけて、リストから選択します。

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

    • 選択したワークフローが JavaScript ワークフローエディターで開きます。

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

Js workflow editor

ヘッダーコントロール

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

コントロール

説明

ワークフロー

ワークフロー管理ページに戻ります。このリンクを使用して、MPS ベースのワークフローを含む YouTrack のすべてのワークフローを表示します。

ワークフロー名

現在のワークフローに割り当てられている名前を表示します。

名前の編集

ワークフローの編集ダイアログを開きます。ここで、ワークフローの名前とタイトルを変更できます。

ワークフローの削除

このアクションの確認に従って、現在選択されているワークフローを削除します。詳しくは、ワークフローとルールを削除するを参照してください。

サイドバーコントロール

エディターの左側にはサイドバーがあります。このサイドバーでは、JavaScript で記述されたワークフロー、モジュール、インポートクライアントのリストを表示できます。

このリストには、組織が YouTrack に追加したすべての既定のワークフローとカスタムワークフローが含まれています。ワークフロー API モジュールもサイドバーに表示され、読み取り専用です。

サイドバーの上部に次のコントロールが表示されます。

コントロール

説明

新しいワークフロー

YouTrack に新しいワークフローを追加できます。ワークフローコンストラクターまたは JavaScript エディターを使用してワークフローを追加するオプションがあります。

JavaScript エディターオプションを選択すると、新しいワークフローダイアログが開きます。ここで、新しいワークフローを定義してリストに追加できます。手順については、ワークフローを作成するを参照してください。

名前でフィルタリング

リストをフィルタリングして、入力フィールドの部分文字列に一致するワークフローとモジュールを表示できます。

サイドバーを隠す

サイドバーのワークフローとルールのリストを非表示にします。このコントロールを使用して、ページの全幅でワークフローエディターを表示します。

書き込み権限があるワークフローのワークフローリストには、以下のコントロールが含まれています。

コントロール

説明

ワークフローの編集

ワークフローの編集ダイアログを開きます。ここで、ワークフローの名前を変更して、人間が読める形式のタイトルを付けることができます。タイトルプロパティは、ワークフロー管理ページのリストにのみ表示されます。

モジュールの追加

対応するワークフローにルールまたはカスタムスクリプトを追加します。テンプレートを選択して新規モジュールダイアログを開き、名前を入力してから新しいモジュールを保存します。

さらに表示

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

アクション

説明

エクスポート

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

ワークフローの削除

確認プロンプトに続いて、対応するワークフローを YouTrack から完全に削除します。ワークフローに属するルールは、それらがアタッチされているプロジェクトから削除され、YouTrack からも削除されます。

このコントロールはリスト内の個々のモジュールに対しても利用可能です。詳しくは、ワークフローとルールを削除するを参照してください。

ワークフローエディターのツールバー

ワークフローエディターを使用すると、YouTrack で直接スクリプトを作成および更新できます。ワークフローエディターのツールバーには、次のコントロールが表示されます。

コントロール

説明

フルスクリーン

集中モードでエディターを開きます。アプリケーションとページヘッダーのすべてのコントロールが非表示になります。サイドバーも折りたたむと、ワークフローエディターとそのツールバーのみが表示されます。

コード検査

エディター内のエラーと警告のハイライトを切り替えます。

さらに表示

追加のアクションとオプションのリストを開きます。

閉じる

ワークフローエディターを閉じます。新規モジュールダイアログがワークフローエディターパネルに表示されます。

最終更新者

モジュールに最新のアップデートを適用したユーザのフルネームと同様に最後の修正の時間を表示します。

保存

現在のモジュールに対する未保存の変更を保存します。

キャンセル

未保存の変更を破棄します。

さらに表示メニューでは次のオプションが使用できます。

コントロール

説明

元に戻す

現在のスクリプトに対する最新の変更を元に戻します。

やり直し

最後に戻された変更を復元します。

コードの整形

JavaScript の標準レイアウトに合うように、スペースとインデントを修正します。

名前変更

モジュールの編集ダイアログを開きます。ここで、現在のモジュールの名前を編集できます。

削除

このアクションの確認に従って、現在のモジュールを削除します。

エディターオプション

エディターオプションダイアログを開きます。ここでは、ワークフローエディターの外観と動作に影響を与える設定を管理します。

さらに表示メニューのエディターオプション項目では、次の設定が可能です。

設定

説明

リガチャー

コード表示に使用される書体を切り替えます。

ショートカットスキーム

エディターでサポートされているキーボードショートカットのセットを定義します。ここでは、デフォルトVimEmacs キーボードショートカットスキームから選択できます。

テーマ

エディターで使用される配色を設定します。ここでは、またはダークから選択できます。

コンソールツールバー

エディターの下部にはコンソールがあります。コンソールには、現在のスクリプトに関連したロギングメッセージが表示されます。コンソールツールバーでは、次のコントロールを使用できます。

コントロール

説明

表示 / 隠す

コンソールペインの表示 / 非表示を切り替えます。

表示

ログエントリをフィルタリングして、すべてまたはメッセージのみを表示します。入力フィールドを使用して、部分文字列と一致するログ項目をフィルターに掛けます。

フィルター

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

更新

コンソールを再ロードして、ページのロード後に追加された新しいログエントリを表示します。

ダウンロード

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

クリア

コンソールからすべてのログエントリを削除します。

関連ページ:

ワークフローを編集する

既存のワークフローを変更して、特定のユースケースに適応させることができます。YouTrack カスタムワークフローリポジトリからルールをアップロードしてカスタマイズしたり、独自のワークフローを変更したり、YouTrack インスタンスで使用できるデフォルトのワークフローを編集したりできます。デフォルトワークフローに変更を適用すると、デフォルトワークフローの新しいバージョンが製品のアップグレードに含まれていても、変更は保持されます。いつでも変更を元に戻し、ワークフローのデフォルト定義を復元できます...

ワークフローを作成する

課題追跡を強化し、プロジェクトの変更を自動化する場合は、ワークフローを作成します。管理者は、ワークフローページで YouTrack のワークフローの完全なリストにアクセスできます。ここでのみ、YouTrack にワークフローを追加できます。ワークフローを追加するときに、ワークフローコンストラクターを使用するか、JavaScript 用の Web ベースのワークフローエディターを使用するかを選択できます。ワークフローコンストラクターは、事前定義された条件とアクションを使用して自動化を構築できる、コ...

状態マシン

ワークフローコンストラクターは、ステートマシンルールの作成に使用できる一連のツールを備えた編集インターフェースをサポートしています。このインターフェースは、他のルールタイプを作成するためのインターフェースとは異なります。ステートマシンルールを作成するためのインターフェースは、カスタムフィールド値間の遷移を定義するための一連のツールを備えた無料のキャンバスとして提供されます。キャンバスにアクセスしてステートマシンルールを作成するには、ルールヘッダーでルールタイプをステートマシンに設定します。ステー...