YouTrack および Hub ヘルプの開発者ポータル

ワークフローのトラブルシューティング

ワークフローの作成時またはプロジェクトへのワークフローのアタッチ時に課題が発生した場合は、以下の条件のリストを確認して、状況を解決する方法を決定してください。

条件

ワークフロールールが期待どおりに動作せず、スクリプトからの診断メッセージをインスペクションしたい場合。

原因

ワークフロースクリプトのメッセージは、ブラウザーの開発者コンソールではなく、ワークフローエディターのコンソールに表示されます。

ソリューション

console.log()console.warn()console.error() を使用してルールにログ記録ステートメントを追加し、ルールをトリガーする条件を再現します。

Web ベースのワークフローエディターでルールを開き、コンソールペインを確認してください。スケジュールされたルールのトラブルシューティングを行っている場合は、cron 式も確認してください。不正な cron 式によってルールのスケジュールが妨げられると、エラーがワークフローログに記録されます。

YouTrack サーバー環境の場合、ワークフローログのエントリは workflow.log ファイルにも書き込まれます。YouTrack クラウドインスタンスの場合は、ワークフローエディターコンソールを使用し、インスタンスログの確認方法についてサポートが必要な場合は YouTrack サポートチームにお問い合わせください。

条件

アクションルールを作成できません。YouTrack はエラー Action rule can't have same event name as another action rule を返します。

原因

アクションルールの名前が既存のコマンドと一致しています。アクションルールの名前は、ルールを実行するコマンドに割り当てられます。コマンドはサーバーごとに一意である必要があります。

ソリューション

アクションルールには別の名前を使用してください。

条件

ワークフロールールは欠落している課題フィールドに対してエラーをスローしますが、必要なセットアップフラグはワークフローリストに表示されません。

原因

フィールドは要件セクションに追加されません。

ソリューション

要件セクションにフィールドを追加します。

原因

要件セクションのフィールドへの参照が、大文字と小文字を間違えて記述されています。

ソリューション

ワークフロースクリプト内の要件管理チェックでは大文字と小文字が区別されませんが、ワークフローは課題フィールドへのアクセス時に大文字と小文字を区別します。カスタムフィールドページのフィールド名と、スクリプトの要件セクションの参照を比較してください。要件セクションの参照を、カスタムフィールド名の大文字と小文字に合わせて更新してください。

条件

カスタムスクリプトに変更が適用されましたが、動作は変更されていません。

原因

カスタムスクリプトは、参照する他のスクリプトが更新されたとき、またはアプリケーションの起動時にのみ再ロードされます。

ソリューション

カスタムスクリプトを参照するスクリプトに小さな変更を加え(たとえば、新しい行を追加)、それを保存します。

2026 年 7 月 06 日