Jiraインテグレーションは、Jira課題をSupportチケットに関連付け、製品チームとサポートチーム間のコラボレーションを容易にします。Jiraインテグレーションで最も頻繁に発生する問題を特定し、解決する方法について説明します。
この記事では、次のトピックについて説明します。
- 一般的なトラブルシューティング手順
- 401エラーを受け取る
- 「Do you follow the installation instructions...」というエラーメッセージが表示される
- 設定中にZendeskサブドメインが正しくありません
- 502（Bad Gateway）エラーの受信
- 「Zendesk通知。通知に失敗しました。後でもう一度やり直してください。」というエラー メッセージ
- JiraのアップデートとコメントがZendeskにありません
- 「Failed to Save Jira Field」エラーが表示される
一般的なトラブルシューティング手順
Jiraの問題をトラブルシューティングするための適切な最初のステップは、ZendeskサブドメインをJiraインテグレーションから切断することです。次に、プラグインをアンインストールしてから再インストールします。これは Jira でキャッシュと cookie をクリアする操作に相当します。
401エラーを受け取る
Supportで401の不正なエラーは、Jira管理者の資格情報が正しくないか、管理者に必要な権限がないことを意味します。このエラーが発生した場合は、アカウントが正しく設定されていることを確認してください。
- Jiraユーザー名は、メールアドレスではなくユーザー名でなければなりません。パスワードも正しい必要があります。
- Jira管理者アカウントは、ユーザー、開発者、管理者のユーザー グループの一部である
- Jira管理者アカウントには、プロジェクトの作成または既存のプロジェクトの編集を防止する権限スキームがありません（「Settings」>「Issues」>の「Permission schemes」）
- ユーザーディレクトリとして、JIRA Internal Directoryを使用していること。
- Jira管理者アカウントは最近削除されていません
- Jiraサーバーを使用している場合、サーバーまたはそのホストは最近移動されていません
このエラーは、Jiraの他のプラグインがSupportプラグインをブロックしている可能性もあります。Jiraサービスデスクのトライアル版に含まれる特定のプラグインに注意してください。これらの他のプラグインをJiraで個別に無効にして、Supportインスタンスをチェックして、問題が解決するかどうかを確認します。
「インストール手順に従いましたか？」というエラーメッセージが表示される
このエラーメッセージは、SupportでJiraを初めてインストールまたは再インストールした後に表示されます。
このエラーメッセージをトラブルシューティングするには：
- ZendeskでJiraアプリをアンインストールします。
- 管理センターで、「> Apps and integrations」「> Zendesk Support apps > Jira」に移動します。
- ドロップダウンオプションで「アンインストール」をクリックします。
- JIRAを切断：
- Jiraで、「Manage your apps」に移動し、「Zendesk Support for Jira」をクリックします。
- 「Configure」を選択し、「Disconnect」をクリックします。
- JiraでZendesk Support for Jiraをアンインストールします。
- 「Manage your apps」ページに戻り、Zendesk Support for Jiraアプリをクリックします。
- 「アンインストール」をクリックします。
- JiraとZendeskの両方からログアウトする
- 新しいブラウザウィンドウを開き、Zendeskに管理者としてログインします。別のブラウザタブで、Jiraに管理者としてログインします。
- JiraにZendesk Support for Jiraを再インストールします。これにより、ZendeskにもJIRAアプリがインストールされます。
設定中にZendeskサブドメインが正しくありません
Jiraカウントに接続されているZendeskサブドメインを変更できない場合は、次の記事を参照してください。Jira error：設定中にZendeskサブドメインが正しくありません。
502（Bad Gateway）エラーを受信する
この問題は、エージェントが課題を作成したり、課題をチケットにリンクしたときに表示されます。これは、ベースURLが正しく設定されていないことが原因と考えられます。
このエラーメッセージをトラブルシューティングするには：
- Jiraにサインインして、アドオンの設定ページに移動します。
- JiraベースURLを更新し、Jira URLホストと一致することを確認します。
- スペルが間違っていないか、または.comなどの部分が欠けていないか確認してください
詳細については、次の記事を参照してください：Zendesk Support for Jiraインテグレーション。
「Zendesk通知。通知に失敗しました。後でもう一度やり直してください。」というエラーメッセージが表示される
このエラーはお使いのブラウザが原因で発生し、お使いのコンピュータからZendeskへのAPIコールがブロックされます。この動作を回避するには、Webサイトの追跡または厳格なプライバシー設定を無効にします。
Safariから：
Firefoxから：
それ以外の場合は、このエラーが発生しない場所でGoogle Chromeを使用してください。
JiraのアップデートとコメントがZendeskにありません
Jiraからのコメントの一部がZendeskに表示されない場合は、APIコールのコリジョンが原因です。これらのコリジョンは、一度に複数の更新を短時間に実行した場合に発生し、一部のコールがZendeskのチケットに届かない可能性があります。
コリジョンエラーを回避するには、更新間隔を5～10秒以上空けます。
詳細については、次の記事を参照してください。
「Failed to Save Jira Field」エラーが表示される
このエラーメッセージは、Zendesk SupportのJira課題作成フォームにフィールドを追加するときに表示されます。
このエラー メッセージは、Create a new Jira issueフォームですでに設定されているフィールドの数が多すぎる場合に発生します。
このエラーを解決し、追加のフィールドを設定するには、他のプロジェクトで設定されている既存のフィールドと、アクティブに使用されなくなった課題を削除します。非アクティブなプロジェクトや課題に設定されているフィールドを削除すると、フィールドの総数が減ります。このアクションにより、アクティブな他のプロジェクトや課題のフィールドを設定できます。
翻訳に関する免責事項：この記事は、お客様の利便性のために自動翻訳ソフ トウェアによって翻訳されたものです。Zendeskでは、翻訳の正確さを期すために相応の努力を払っておりますが、翻訳の正確性につ いては保証いたしません。
翻訳された記事の内容の正確性に関して疑問が生じた場合は、正式版である英語の記事 を参照してください。