Jira の自動化レポート「編集中に不明なフィールドが設定されました。プロジェクト/タイプで利用できない可能性があります」

要約

Jira の自動化プラグインを使用して自動化ルールを実行すると、A4J が「Some Errors (一部のエラー)」と次の説明でルールが完了したと報告するという問題が発生することがあります。

• 「課題に対して編集するフィールドやフィールド値がない (フィールド値がそのプロジェクトに存在しない場合を含む):」

• 「編集中の不明なフィールド セット。プロジェクト/タイプで利用できない場合があります。カスタム フィールド設定を確認してください。フィールドは無視されました -」

  

アプリケーション ログには、次の情報も記録されます。

atlassian-jira.log

環境

Jira Data Center on any version from 9.0.0

診断

上記の原因のどれがここの原因であるかを突き止めるには、次の手順に従います。

根本原因 1 の診断

フィールドと値が適切に設定されているかどうかを確認するには、次の手順に従います。

1. Jira で、[Jira 管理] (歯車アイコン) > [課題] > [カスタム フィールド] に移動します。

2. 検索によって影響を受けるフィールドを見つけます。

3. [アクション] メニュー (...) で [設定] を選択します。

4. このページの内容:

   1. 影響を受けるプロジェクトに設定されたカスタム フィールド コンテキスト、または「グローバル コンテキスト」を持つカスタム フィールド コンテキストがあることを確認します。

   2. 自動化で使用される課題タイプが適切なフィールド コンテキストで利用できるかどうか、または「グローバル コンテキスト」でも設定されているかどうかを確認します。

   3. 選択しようとしている値が適切なコンテキストで利用できるかどうかを確認します (これは、事前設定された値のあるフィールドを使用している場合にのみ適用されます)。

根本原因 2 の診断

カスタム フィールドとその値が適切に設定されていることを確認しても自動化の使用時にエラーが表示される場合は、影響を受ける自動化ルールのアクターに権限ヘルパーツールによる更新を実行するために十分な権限がない可能性があることをご確認ください。

1. 影響を受ける課題にアクセスします。

2. 課題コンテキストの [管理者] ドロップダウン メニューをクリックします。

3. 「権限ヘルパー」を選択します。

4. フォームに次のとおり入力します。

   • ユーザー :<Actor for your Rule>

   • 権限:「課題の編集」

5. [送信]をクリックします。

根本原因 3 の診断

ワークフロー プロパティで説明したように、ワークフローの特定のステータスにプロパティを追加して、ユーザーが課題を編集できないようにすることができます。

この根本原因が該当するかを確認する方法

• Take note of the workflow status of the Jira issue that the rule failed to edit

• この課題に関連付けられているワークフローを編集して、ダイアグラム ビューに切り替えます。

• Click on the status and check it's properties

• 下図のように、 jira.permission.edit.user や jira.permission.edit.denied など、課題編集に関連するプロパティ キーが表示される場合は、この根本原因が関連しています。

原因

Root Cause 1 - Field/value not available

このエラー メッセージが示すように、この課題に最も可能性の高い原因は、編集しようとしている フィールド または入力しようとしている 値 のどちらかが、課題が属する プロジェクトに利用できないことです。

Root Cause 2 - Lack of permissions due to the Project Permission Scheme

もう 1 つの原因として考えられるのは、影響を受ける自動化ルールのアクターに、プロジェクトに関連付けられた権限スキームにより、影響を受ける課題を編集する権限がないことです。

根本原因 3 - ワークフロー設定の特定のステータスに追加されたプロパティが原因で、権限が不足しています

考えられるもう 1 つの原因は、影響を受ける自動化ルールのアクターに影響を受ける課題を編集する権限がないことです。これは、ワークフロー設定で使用されている一部のプロパティにより、一部のユーザーが特定のステータスにある課題を編集できなくなっているためです。

ソリューション

Adjust the field/permissions/workflow settings as per the Diagnostics section, in order to ensure that the field and values are available for the project you want to use them on and that the rule actor has the necessary permissions to edit the issue.

必要なステップに関する追加のガイダンスについては、次をご参照ください。

• カスタム フィールド コンテキストの設定

• プロジェクト権限を管理する

• ワークフロープロパティ設定