質問

Zendeskアプリフレームワーク（ZAF）をデバッグするにはどうすればよいですか？

回答

Zendeskアプリフレームワークを使用すると、複雑な機能を備えたアプリを構築できます。この記事では、最も一般的なシナリオで問題に対処する方法に関するガイドラインを提供します。

免責事項：Zendeskカスタマーサポートは、Zendesk Appsフレームワーク（ZAF）の機能と機能のデモンストレーションのみをサポートできます。カスタムコードまたは実装に関する問題は、アプリ開発者と話し合う必要があります。

これらの問題をトラブルシューティングするには、以下の手順に従います。

  • エラーをキャプチャする
  • インストール済みアプリのリストを生成する
  • アプリを特定する
  • HARファイルを生成
  • アプリAPIを使用する

エラーをキャプチャする

ブラウザの開発者ツールを使用する。アプリが予期しない動作をする場合は、エラーのリストを収集して、ブラウザの開発者用ツールでさらに調査します。

さまざまなブラウザで開発者ツールにアクセスする：

  • Chrome:Chrome DevToolsを開く 
  • Firefox：Webコンソール 
  • Safari：MacのSafariで「開発」メニューの開発者ツールを使用する 
  • Microsoft Edge：Microsoft Edge DevToolsを開く

コンソールにエラーまたは警告メッセージが表示されます。ネットワークリクエストエラーについては、ツールの「ネットワーク」タブを確認してください。

インストール済みアプリのリストを生成する

アカウントにインストールされているすべてのアプリのリストを生成します。

APIエンドポイント List App Installations は、インストールされたアプリのJSONリストを生成します。含まれるプロパティは、 noapps かつ app_ids クエリパラメータ:

  • enabled:アプリが現在アクティブかどうかを示します
  • app_id: アプリのID。これは、 app_idsパラメータです。
  • インストールID：アプリのインストールID。これは、オプションで noappsパラメータです。アプリで許可されている場合は、アプリを複数回インストールできます。インストールごとにインストールIDは異なりますが、アプリIDは同じです。

エンドポイントにアクセスするには：

  • curlを使用 
    curl https://{subdomain}.zendesk.com/api/v2/apps/installations.json\
    -u{email_address}:{password}
  • または /api/v2/apps/installations.json アカウントのサブドメインURL： 
    https://your_subdomain.zendesk.com/api/v2/apps/installations.json

Zendeskアカウントのエージェントである必要があります

アプリを特定する

アプリを選択的に非アクティブにして、原因を見つけます。アプリを非アクティブにするには：

  • Supportで、次の記事の手順に従ってください：インストール済みアプリの管理
  • または、 ?noapps チケットURLのサフィックス： 
https://your_subdomain.zendesk.com/agent/tickets/123456?noapps

HARファイルを生成

HARファイルは、ブラウザとWebサイト間で情報やイベントを追跡するための標準形式です。ネットワークイベントをHARファイルに記録して、パフォーマンスやレンダリングの問題をトラブルシューティングします。HARファイルを生成するには、次の記事を参照してください：トラブルシューティング用のHARファイルを生成しています。

アプリAPIを使用する

APIエンドポイントの List App Installations を活用して、インストールされたアプリのリストを生成することで、問題を解決します。JSON応答に含まれるプロパティのうち、 インストールID を noapps 複数のアプリを同時に無効にするには：

https://your_subdomain.zendesk.com/agent/tickets/123456?noapps=11111,22222,44444

Supportアプリを一から作成する方法については、次の記事を参照してください：初めてのSupportアプリの作成 - パート1：基礎を築く。サーバーサイドアプリの構築方法に関する情報が必要な場合は、次の記事を参照してください：サーバーサイドアプリの構築 - パート1：主要な概念。

翻訳に関する免責事項：この記事は、お客様の利便性のために自動翻訳ソフ トウェアによって翻訳されたものです。Zendeskでは、翻訳の正確さを期すために相応の努力を払っておりますが、翻訳の正確性につ いては保証いたしません。

翻訳された記事の内容の正確性に関して疑問が生じた場合は、正式版である英語の記事 を参照してください。

Powered by Zendesk