Jiraインテグレーションは、Jira課題をSupportチケットと結び付けて、製品チームとサポートチーム間のコラボレーションを容易にします。Jiraインテグレーションで最もよく遭遇する問題を特定し、解決する方法を学びます。
この記事では、次のトピックについて説明します。
- 一般的なトラブルシューティングの手順
- 401エラーの発生
- 「インストール手順に従いました...」というエラーメッセージが表示される
- 設定中のZendeskサブドメインが正しくありません
- 502（不正なゲートウェイ）エラーの発生
- 「Zendeskの通知を受ける」通知に失敗しました。後でもう一度やり直してください。」というエラーメッセージ
- JiraアップデートとコメントがZendeskに表示されません
一般的なトラブルシューティングの手順
Jiraの問題をトラブルシューティングするための良い最初のステップは、ZendeskサブドメインをJiraインテグレーションから切断することです。プラグインをアンインストールしてから再インストールします。これは、Jiraでキャッシュとcookieをクリアするのに相当します。
401エラーの発生
Supportで401の不正エラーが発生した場合、Jira管理者の資格情報が正しくないか、管理者に必要な権限がないことを示します。このエラーが表示された場合は、アカウントが正しく設定されていることを確認してください。
- Jiraユーザー名は、メールアドレスではなく、ユーザー名でなければなりません。パスワードも正しい必要があります。
- Jira管理アカウントが、ユーザー、開発者、管理者のユーザーグループの一部である
- Jira管理者アカウントに、プロジェクトの作成または既存のプロジェクトの編集を禁止するためのアクセス権限スキームが設定されていない（「設定」>「問題」>「権限スキーム」）
- ディレクトリとして、Jira Internal Directoryを使用していること。
- Jira管理者アカウントが最近削除されていないこと。
- Jiraサーバーを使用している場合、サーバーまたはそのホスティングが最近移行されていないことを示します。
このエラーは、Jira内のほかのプラグインがSupportプラグインをブロックしている可能性もあります。JIRAサービスデスクのトライアル版の特定のプラグインに注意してください。Jiraインスタンスで他のプラグインを個別に無効にして、Supportインスタンスで問題が解決するかどうか確認してみてください。
「インストール手順に従いました...」というエラーメッセージが表示される
このエラーメッセージは、SupportでJiraアプリを初めてインストールまたは再インストールした後に表示されます。
このエラーメッセージをトラブルシューティングするには：
- ZendeskでJiraアプリをアンインストールします。
- 「 管理センター 」>「 アプリおよびインテグレーション 」>「Zendesk Supportアプリ 」>「JIRA 」の順に進みます。
- ドロップダウンオプションで「 アンインストール 」をクリックします。
- Jiraの接続を切断：
- JIRAで、「Manage your apps」に移動し、「Zendesk Support for Jira」をクリックします。
- 「 設定」を選択し、「 切断」をクリックします。
- JiraでZendesk Support for Jiraアプリをアンインストールします。
- 「Manage your apps」ページに戻り、「Zendesk Support for Jira」アプリをクリックします。
- 「 アンインストール」をクリックします。
- JiraとZendeskの両方からログアウトする
- 新しいブラウザウィンドウを開き、Zendeskに管理者としてログインします。別のブラウザタブで、Jiraに管理者としてログインする
- Zendesk Support for JiraアプリをJiraに再インストールします。これにより、JIRAアプリがZendeskにインストールされます。
設定中のZendeskサブドメインが正しくありません
Jiraアカウントに接続されているZendeskサブドメインを変更できない場合は、次の記事を参照してください：Jiraエラー:設定中のZendeskサブドメインが正しくありません」でツリーベースの最大権限を有効にします。
502（不正なゲートウェイ）エラーの発生
この問題は、エージェントが問題を作成するか、問題をチケットにリンクするときに表示されます。これは、ベースURLが誤って設定されていることが原因である可能性が高いです。
このエラーメッセージをトラブルシューティングするには：
- Jiraにサインインし、アドオンの設定ページに移動します。
- Jira Base URLを更新し、自社のJira URLホストと一致することを確認してください
- .comなど、間違ったスペルや不足している部分を確認します
詳細については、次の記事を参照してください：Zendesk Support for Jiraインテグレーションの使用
「Zendeskの通知を受ける」通知に失敗しました。後でもう一度やり直してください。」というエラーメッセージ
このエラーはブラウザに起因します。ブラウザは、ご使用のコンピュータからZendeskへのAPIコールをブロックします。この動作を回避するには、Webサイトの追跡または厳格なプライバシー設定を無効にしてください。
Safariから：
Firefoxから：
それ以外の場合は、このエラーが発生しないGoogle Chromeを使用してください。
JiraアップデートとコメントがZendeskに表示されません
Jiraからの一部のコメントがZendeskに表示されない場合は、APIコールの競合が原因です。この競合は、短時間に複数の更新を同時に実行した場合に発生し、コールの一部はZendeskのチケットに到達しない可能性があります。
コリジョンエラーを避けるため、更新の間隔は少なくとも5～10秒にします。
詳細については、次の記事を参照してください。
翻訳に関する免責事項：この記事は、お客様の利便性のために自動翻訳ソフ トウェアによって翻訳されたものです。Zendeskでは、翻訳の正確さを期すために相応の努力を払っておりますが、翻訳の正確性につ いては保証いたしません。
翻訳された記事の内容の正確性に関して疑問が生じた場合は、正式版である英語の記事 を参照してください。