統合サービスデスクのエンティティ検索を使用したデータ検索

[アーティクル]
03/06/2017

公開日: 2016年11月

対象: Dynamics 365 (online)、Dynamics 365 (on-premises)、Dynamics CRM 2013、Dynamics CRM 2015、Dynamics CRM 2016

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

エンティティ検索は、Dynamics 365 の [エンティティ検索] 領域 ([設定] > [統合サービスデスク] > [エンティティ検索]) で定義します。エンティティ検索を定義するには、名前、検索が適用されるエンティティ、サーバーからデータを取得するクエリを表す FetchXML クエリの、3 つを指定する必要があります。

次の 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 クエリを定義しているときは、その目的のために必要なフィールドのみを返す必要があります。これにより、要求と返されるデータのサイズが制限されるため、ネットワークへの影響を最小限に抑えることができ、リソース使用率が最適化されます。

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

次の方法で共有

統合サービスデスクのエンティティ検索を使用したデータ検索

関連項目

その他のリソース

次の方法で共有

統合サービス デスクのエンティティ検索を使用したデータ検索

関連項目

その他のリソース

統合サービスデスクのエンティティ検索を使用したデータ検索