カスタムスクリプト

カスタムスクリプトを使用すると、コードブロックを整理して再利用できます。特定のタイプのルールは含まれていません。代わりに、他のスクリプトで使用できるコードが含まれています。

カスタムスクリプトは、JavaScript エディターを使用して作成されたワークフロー内のモジュールとして保存されます。カスタムスクリプトを追加するには、管理> ワークフローで JavaScript ワークフローを開くか作成し、エディターのサイドバーにあるモジュールの追加コントロールを使用して、カスタムスクリプトのテンプレートを選択します。

どのスクリプトでも、exports オブジェクトのプロパティとして割り当てることにより、他のスクリプトで使用するオブジェクトと関数を定義できます。

以下に例を示します。

最初に、単純な関数を定義するカスタムスクリプトを作成します。

    // 'math.js'

    exports.f = function (x) {
      return x * x - 6 * x + 13;
    };

    // And these are a couple of constants we need.
    exports.lower = 0;
    exports.upper = 9;
  

require('./math') を使用してこのスクリプトを別のファイルに読み込むと、YouTrack は exports オブジェクト用に定義したプロパティを含むオブジェクトを返します。この例では、そのオブジェクトが math 定数に割り当てられているため、math.f として関数にアクセスできます。

次に、この関数を参照するアクションルールを記述します。

    // 'chart.js'

    const entities = require('@jetbrains/youtrack-scripting-api/entities');

    const math = require('./math');

    exports.rule = entities.Issue.action({
      title: 'Draw a chart',
      command: 'draw',
      action: (ctx) => {
        const issue = ctx.issue;
        var chart = '';
        for (var x = math.lower; x <= math.upper; x++) {
          var fx = math.f(x);
          var line = x + ' | ';
          for (var i = 0; i < fx; i++) {
            line = line + "#";
          }
          chart = chart + line + "\n";
        }
        issue.addComment(chart);
      }
    });
  

2026 年 4 月 23 日

関連ページ：

JavaScript ワークフローリファレンス

YouTrack を使用すると、JavaScript でワークフローを作成できます。以前のバージョンの YouTrack のワークフローに使用されていたドメイン固有のプログラミング言語は非推奨になり、YouTrack 2020.5 では完全に削除されました。JavaScript は間違いなく今日世界で最も人気のあるプログラミング言語です。独自がそれに慣れていないのなら、あなたの組織には流暢な人がいる可能性があります。JavaScript に切り替えることで、YouTrack 用のワークフローをこ...

アクションルール

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