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

JavaScript の互換性

現在の JavaScript 実装は、最新の ECMAScript 仕様と互換性があります。これは、JavaScript のこの標準化された仕様でサポートされている機能が、YouTrack ワークフローで使用できることを意味します。

以前のバージョンの YouTrack に含まれていた JavaScript ランタイムは、ES6 /JS2015 の限定的なサポートを提供していました。これは、YouTrack でワークフローを作成するときに、完全な JavaScript 機能セットの約 22% に制限されることを意味しました。

レガシーワークフロープログラミング言語からの主な変更

JavaScript に切り替えると、ワークフローを作成するときに特定のエンティティとプロパティを参照する方法が変わります。従来のワークフロー API と比較した主な変更点の短いリストを次に示します。

1. issue 参照が省略されることはありません。コンテキストから issue を参照すると仮定して issue メソッドを呼び出すことはできません - 明示的に issue を参照する必要があります。

2. プロパティ関連のメソッドのスペルは異なります。また、これらの関数はプロパティになりました。取得メソッドは単純化されています。

   MPS ベースの API	JavaScript API
   issue.becomesResolved(), issue.becomesReported()	issue.becomesResolved, issue.becomesReported
   issue.getId(), issue.getUrl()	issue.id, issue.url

3. フィールド関連のキーワードがメソッドになりました。

   MPS ベースの API	JavaScript API
   X.required	issue.fields.required(ctx.X, <message>)
   X.changed	issue.fields.isChanged(ctx.X)
   X.becomes	issue.fields.becomes(ctx.X, <ctx.X.value>)
   X.oldValue	issue.fields.oldValue(ctx.X)

4. グローバルキーワードと警告文が変更されました。

   MPS ベースの API	JavaScript API
   message	workflow.message(<message>) (「@jetbrains/youtrack-scripting-api/workflow」モジュールを参照)
   assert	workflow.check(<condition>, <message>) (「@jetbrains/youtrack-scripting-api/workflow」モジュールを参照)
   loggedInUser	ctx.currentUser
   now	Date.now() (標準 JS 日付 API)

5. いくつかの方法が完全に変更されます。

   MPS ベースの API	JavaScript API
   loggedInUser.createNewIssue(<project name>)	new entities.Issue(<user>, <project>, <summary>)