Unified Service Desk のエンティティ検索を使用したデータ検索

エンティティ検索は、Webサービスにクエリを実行してデータを返す定義です。 FetchXML Microsoft Dataverse エンティティ検索のクエリ内で置換パラメータを使用することもできます。 FetchXML エンティティ検索は、ウィンドウ ナビゲーション ルールで、フォームに表示されていないデータにアクセスするためのソースとしても、Dataverse への Web サービス呼び出しを使用してデータを検索するための宛先としても使用でき、その後、置換パラメーターで使用することができるよう、Unified Service Desk のコンテキスト データを作成できます。 エンティティ検索は、グローバルマネージャーでホストされたコントロールの DoSearch アクションで使用して、データを検索することもできます。

エンティティ検索は、Dataverse のエンティティ検索領域 (設定>Unified Service Desk>エンティティ検索) で定義します。 エンティティ検索を定義するには、名前、検索が適用されるエンティティ、およびサーバーからデータを取得するためのクエリを表すクエリの3つを指定する必要があります。 FetchXML

次の FetchXML クエリは、ケースから取得できる顧客IDに基づいて、アカウントの名前と住所の詳細を返します。

<fetch version="1.0" output-format="xml-platform" mapping="logical" distinct="false">  
  <entity name="account">  
    <attribute name="name" />  
    <attribute name="emailaddress1" />  
    <attribute name="telephone1" />     
    <attribute name="address1_line1" />  
    <attribute name="address1_city" />  
    <attribute name="address1_stateorprovince" />  
    <attribute name="address1_postalcode" />  
   <attribute name="address1_country" />  
   <attribute name="msdyusd_facebook"/>  
   <attribute name="msdyusd_twitter"/>  
    <order attribute="name" descending="false" />  
    <filter type="and">  
      <condition attribute="accountid" operator="eq" value="{[[incident.customerid.Id]x]}" />  
    </filter>  
  </entity>  
</fetch>  

エンティティ検索の定義はこのようになります。

重要

エンティティ検索でクエリを定義するときは、目的に必要なフィールドのみを返す必要があります。 FetchXML これにより、要求と返されるデータのサイズが制限されるため、ネットワークへの影響を最小限に抑えることができ、リソース使用率が最適化されます。

開発者は、Dataverse のレコードを検索するコードで既存のエンティティ検索の定義も再利用できます。 詳細: カスタム コードでのエンティティ検索定義の再利用

参照

カスタム コードでのエンティティ検索定義の再利用
Unified Service Desk でのウィンドウ ナビゲーションの規則の使用
アクション コール
Unified Service Desk の構成方法について
チュートリアル: CTI イベントのルーティングに対して汎用リスナー アダプターを使用する