Chercher des enregistrements Dataverse

Les opérations de recherche sont définies comme des messages Dataverse utilisant les API personnalisées. Pour les projets .NET, vous pouvez utiliser le SDK pour .NET.

Aucune classe n’est actuellement incluse dans le SDK pour utiliser ces opérations. Pour les projets .NET Framework, vous pouvez utiliser la CLI Power Platform construction du modelbuilder pac pour générer des classes *Request et *Response pour ces messages comme vous le feriez pour n’importe quelle action personnalisée.

Vous pouvez également utiliser les classes OrganizationRequest et OrganizationResponse.

Pour plus d’informations :

• Générer des classes à liaison anticipée pour le SDK pour .NET
• Utilisez les messages avec le SDK pour .NET

Les opérations de recherche exposées avec l’API Web sont des actions ou des fonctions OData décrites dans le document de $métadonnées CSDL.

Pour plus d’informations :

• Utiliser des actions API Web
• Utiliser des fonctions API Web

La recherche native 2.0 point de terminaison n’est pas un service OData et n’a aucun document de service. La recherche native 2.0 point de terminaison accepte les mêmes paramètres et renvoie les mêmes réponses que les actions et fonctions de l’API Web correspondantes.

La recherche d’héritage Dataverse en utilisant /api/search/v1.0/ n’est pas obsolète et continue d’être prise en charge.

ErrorCode : -2147185397 Message : Dataverse Search feature is disabled for this organization.

Response

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

Response

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

Cette fonction renvoie la valeur de propriété IsExternalSearchIndexEnabled pour l’organisation.

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"];
}

Pour plus d’informations : Générer des requêtes avec QueryExpression

Cette requête d’API Web renvoie la valeur de propriété IsExternalSearchIndexEnabled pour l’organisation.

Requête

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

Response

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": "883278f5-07af-45eb-a0bc-3fea67caa544"
      }
   ]
}

Pour plus d’informations, consultez Interroger les données à l’aide de l’API web

Vous devez utiliser le SDK pour .NET ou l’API Web pour vérifier ce paramètre.

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}");
}

Sortie

CanEnableSyncToExternalSearchIndex: True
SyncToExternalSearchIndex: True

Pour plus d’informations :

• Rechercher les définitions de schéma
• Récupérer, mettre à jour et supprimer des tables

Requête

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

Response

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"
   }
}

Pour plus d’informations :

• Interroger les définitions de table à l’aide de l’API web
• Rechercher les définitions de schéma
• Créer et mettre à jour les définitions de table à l’aide de l’API web

Vous devez utiliser le SDK pour .NET ou l’API Web pour vérifier ce paramètre.