Partager via

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

  • Article

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