renderSearchPage (Référence API JavaScript) pour l'environnement d'intégration du canal de Dynamics 365 1.0

Vous permet de rechercher parmi les enregistrements d'un type d'entité spécifique. Cette API ouvre la page d'entité Unified Interface avec le champ de recherche déjà complété avec la chaîne recherchée transmise comme paramètre.

Syntaxe

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

Paramètres

Nom	Type	Requise	Description
entityLogicalName	String	Oui	Nom logique de l’entité de l’enregistrement à interroger, comme « compte ».
searchString	String	Oui	Chaîne à rechercher entre les attributs des enregistrement d’entité.
searchType	Valeur booléenne	No	Type de page de recherche à ouvrir, 0 pour la recherche par pertinence et 1 pour la recherche par catégorie. Si aucun paramètre n'est fourni, les enregistrements sont recherchés par catégorie. Pour en savoir plus sur la recherche par pertinence, consultez Configurer une recherche Dataverse.
successCallback	Function	No	Fonction à appeler lorsque certains enregistrements sont récupérés.
errorCallback	Fonction	Non	Fonction à appeler lorsque l'opération échoue.

Valeur retournée

En cas de réussite, renvoie un objet promise contenant les attributs spécifiés précédemment dans la description du paramètre successCallback.

Examples

L'exemple suivant montre comment rechercher le terme "Contoso" parmi les enregistrements d'une entité de compte en spécifiant le type de recherche par pertinence.

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

L'exemple suivant montre comment rechercher le terme "Contoso" parmi les enregistrements d'une entité de compte sans spécifier le type de recherche.

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