Skype for Business Serverの通話品質ダッシュボード (CQD) 用データ API

概要： 通話品質ダッシュボード用のデータ API について説明します。 通話品質ダッシュボードは、Skype for Business Server用のツールです。

Data API を使用すると、Skype for Business Serverの通話品質ダッシュボードにプログラムでアクセスできます。

通話品質ダッシュボードのデータ API

Data API は、QoE キューブへのクエリ インターフェイスを提供します。 Data API は、指定されたディメンションとフィルターに基づいて集計された QoE メトリックを提供する多次元データベースを操作するための REST API です。

REST 操作を次の表に示します。

操作​​	説明
キューブの取得	使用可能なディメンションと測定値の一覧を取得します。
ディメンションのメンバーの取得	ディメンション メンバーの取得操作は、特定のディメンションのメンバーの一覧を返します。 また、メンバー リストをフィルター処理し、サブセットを取得して電信送金コストを削減することもできます。
クエリの実行	クエリの実行操作を使用すると、指定したディメンション、測定値、フィルターに基づいてキューブに対してクエリを実行し、データを返すことができます。
キャッシュのクリア	[キャッシュのクリア] 操作は、クエリとデータのサーバー上のキャッシュを削除します。 これによりキャッシュがリセットされ、新しい要求の後で QoE キューブから新しいデータが取得されます。
統合ログの取得	統合ログの取得操作は、QoE キューブ処理のアクティビティを説明するログ エントリの一覧を返します。
直近の統合データの取得	キューブから最後の統合データを取得します。

データ API のクロスオリジン リソース共有 (CORS) のサポート

Data API では、クロスオリジン リソース共有 (CORS) がサポートされています。 CORS は、あるドメインで実行されている Web アプリケーションが別のドメイン内のリソースにアクセスできるようにする HTTP 機能です。 Web ブラウザーでは、 同じ配信元ポリシー と呼ばれるセキュリティ制限が実装され、Web ページが別のドメインの API を呼び出すのを防ぎます。 CORS は、あるドメイン (配信元ドメイン) が別のドメインの API を呼び出すことを許可する安全な方法を提供します。 CORS の詳細については、 CORS 仕様を参照してください。

データ API の CORS の有効化

次に、data API web.configの抜粋を示します。corsTrustedOrigin アプリケーション設定に 2 つのドメインが一覧表示されています。 これらのサーバーから読み込まれたスクリプトによって行われたすべての要求は、Data API によって信頼されます。

正確なプロトコル、ホスト名、ポート (存在する場合) を必ず含めます。 末尾にスラッシュ文字 (/) を配置しないでください。 コンマで区切ることで、複数のエントリを指定できます。

<configuration>
  <appSettings>
    <add key="corsTrustedOrigin" value="https://<trusted-server>,http://<another-trusted-domain>:8080" /> <!-- Domains which are trusted to get the data -->
    <add key="QoEDataLib.DebugMode" value="True" /> <!-- Setting this to True, allows seeing of the detail logs in status page -->
...  </appSettings>
</configuration>