Dataverse レコードの検索

検索操作はカスタム API を使用した Dataverse メッセージとして定義されています。 .NET プロジェクトの場合は、SDK for .NET を使用します。

現時点では、SDK にはこれらの操作を使用するクラスは含まれていません。 .NET Framework プロジェクトの場合は、Power Platform CLI pac modelbuilder ビルド を使用して、カスタム アクションの場合と同様に、これらのメッセージの *Request クラスと *Response クラスを生成します。

OrganizationRequest および OrganizationResponse クラスも使用できます。

詳細については、以下を参照してください:

• .NET 用 SDK の事前バインド クラスを生成する
• .NET 用 SDK でメッセージを使用する

Web API が公開する検索操作は、 CSDL $metadata ドキュメントで説明されている OData アクションまたは関数です。

詳細については、以下を参照してください:

• Web API アクションの使用
• Web API 関数の使用

ネイティブ検索 2.0 エンドポイントは OData サービスではないため、サービス ドキュメントはありません。 ネイティブ検索 2.0 エンドポイントは、対応する Web API アクションおよび関数と同じパラメーターを受け入れ、同じ応答を返します。

を使用した /api/search/v1.0/は非推奨ではなく、引き続きサポートされます。

ErrorCode: -2147185397 メッセージ: Dataverse Search feature is disabled for this organization.

回答

HTTP/1.1 400 Bad Request
{"error":{"code":"0x80048d0b","message":"Dataverse Search feature is disabled for this organization."}}

回答

HTTP/1.1 400 Bad Request
{"error":{"code":"0x80048d0b","message":"Dataverse Search feature is disabled for this organization."}}

この関数は、組織の IsExternalSearchIndexEnabled プロパティ値を返します。

static bool IsExternalSearchIndexEnabled(IOrganizationService service) {

    QueryExpression query = new QueryExpression("organization") { 
        ColumnSet = new ColumnSet("isexternalsearchindexenabled")
    };

    EntityCollection organizations = service.RetrieveMultiple(query);
    return (bool)organizations.Entities.FirstOrDefault()["isexternalsearchindexenabled"];
}

詳細情報: QueryExpression を使用してクエリを構築する

この Web API クエリは、組織の IsExternalSearchIndexEnabled プロパティ値を返します。

要求

GET [Organization URI]/api/data/v9.2/organizations?$select=isexternalsearchindexenabled HTTP/1.1
OData-MaxVersion: 4.0
OData-Version: 4.0
If-None-Match: null
Accept: application/json

回答

HTTP/1.1 200 OK
Content-Type: application/json; odata.metadata=minimal
OData-Version: 4.0

{
   "@odata.context": "[Organization URI]/api/data/v9.2/$metadata#organizations(isexternalsearchindexenabled)",
   "value": [
      {
         "@odata.etag": "W/\"73925407\"",
         "isexternalsearchindexenabled": true,
         "organizationid": "00aa00aa-bb11-cc22-dd33-44ee44ee44ee"
      }
   ]
}

詳細: Web API を使用するクエリ データ

この設定を確認するには、.NET 用 SDK または Web API を使用する必要があります。

static void RetrieveSearchSettingsForTable(IOrganizationService service, string logicalName = "account") {

    RetrieveMetadataChangesRequest request = new RetrieveMetadataChangesRequest() { 
            Query = new EntityQueryExpression() { 
                Properties = new MetadataPropertiesExpression(
                    "CanEnableSyncToExternalSearchIndex", 
                    "SyncToExternalSearchIndex")
            }
    };
    request.Query.Criteria.Conditions.Add(
        new MetadataConditionExpression(
            propertyName: "LogicalName", 
            conditionOperator: MetadataConditionOperator.Equals, 
            value: logicalName));

    var response = (RetrieveMetadataChangesResponse)service.Execute(request);

    EntityMetadata table = response.EntityMetadata.FirstOrDefault();

    Console.WriteLine($"CanEnableSyncToExternalSearchIndex: {table.CanEnableSyncToExternalSearchIndex.Value}");
    Console.WriteLine($"SyncToExternalSearchIndex: {table.SyncToExternalSearchIndex}");
}

出力

CanEnableSyncToExternalSearchIndex: True
SyncToExternalSearchIndex: True

詳細については、以下を参照してください:

• クエリ スキーマ定義
• テーブルの取得、更新、削除

要求

GET [Organization URI]/api/data/v9.2/EntityDefinitions(LogicalName='account')?$select=CanEnableSyncToExternalSearchIndex,SyncToExternalSearchIndex HTTP/1.1
OData-MaxVersion: 4.0
OData-Version: 4.0
If-None-Match: null
Accept: application/json

回答

HTTP/1.1 200 OK
Content-Type: application/json; odata.metadata=minimal
OData-Version: 4.0

{
   "@odata.context": "[Organization URI]/api/data/v9.2/$metadata#EntityDefinitions(CanEnableSyncToExternalSearchIndex,SyncToExternalSearchIndex)/$entity",
   "SyncToExternalSearchIndex": true,
   "MetadataId": "70816501-edb9-4740-a16c-6a5efbc05d84",
   "CanEnableSyncToExternalSearchIndex": {
      "Value": true,
      "CanBeChanged": true,
      "ManagedPropertyLogicalName": "canenablesynctoexternalsearchindex"
   }
}

詳細については、以下を参照してください:

• Web API を使用してテーブル定義をクエリ
• クエリ スキーマ定義
• Web API を使用したテーブル定義の作成および更新

この設定を確認するには、.NET 用 SDK または Web API を使用する必要があります。