renderSearchPage (JavaScript API-Referenz) für Dynamics 365-Kanalintegrationsframework 1.0

Ermöglicht die Suche in Datensätzen eines bestimmten Entitätstyps. Die API öffnet die Entitätsseite der einheitlichen Oberfläche mit vorab ausgefülltem Suchfeld und der Suchzeichenfolge, die als Parameter übergeben wird.

Syntax

Microsoft.CIFramework.renderSearchPage(entityLogicalName, searchString, searchType).then(successCallback, errorCallback);

Parameter

Name des Dataflows	Typ	Erforderlich	Beschreibung
entityLogicalName	Zeichenfolge	Ja	Der logische Entitätsname des Datensatzes, der abgefragt werden soll, z.B. Konto.
searchZeichenfolge	Zeichenfolge	Ja	Zeichenfolge zum Suchen in Attributen der Entitätsdatensätze.
searchType	Boolesch	Nein	Typ der Suchseite, um 0 für Relevanzsuche und 1 für kategorisierte Suche zu öffnen. Wenn kein Parameter angegeben wird, werden die Datensätze nach Kategorie durchsucht. Weitere Informationen zur Relevanzsuche finden Sie unter Dataverse-Suche konfigurieren.
successCallback	Funktion	Nein	Eine Funktion, die aufgerufen werden kann, wenn einige Datensätze abgerufen werden.
errorCallback	Funktion	Nein	Eine Funktion zum Aufrufen, wenn der Vorgang fehlschlug.

Rückgabewert

Bei Erfolg wird ein Versprechenobjekt mit den Attributen zurückgegeben, die zuvor in der Beschreibung des successCallback-Parameters angegeben wurden.

Beispiele

Das folgende Beispiel zeigt, wie der Begriff Contoso unter den Datensätzen einer Entität Konto, indem der Relevanzsuchtyp abgefragt wird.

var entityname = "account"
var searchterm = "Contoso"
var searchtype = 0 // relevance search

Microsoft.CIFramework.renderSearchPage(entityname, searchterm, searchtype).then(
      function (success) {
        console.log(success);
    },
    function (error) {
        console.log(error);
    }
  );

Das folgende Beispiel zeigt, wie der Begriff Contoso unter den Datensätzen einer Konto-Entität Konto abgefragt wird, ohne dass der Suchtyp angegeben wird.

var entityname = "account"
var searchterm = "Contoso"

Microsoft.CIFramework.renderSearchPage(entityname, searchterm).then( // if search type is not passed, it defaults to categorized search
        function (success) {​​
            console.log(success);
    }​​,
    function (error) {​​
        console.log(error);
    }​​
);