Compartilhar via


renderSearchPage (Referência da API JavaScript) para Dynamics 365 Channel Integration Framework 1.0

Permite pesquisar entre os registros de um determinado tipo de entidade. Essa API abre a página de entidade da Interface Unificada com o campo de pesquisa pré-preenchido com a cadeia de caracteres de pesquisa que é passada como um parâmetro.

Sintaxe

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

Parâmetros

Nome Tipo Obrigatório Description
entityLogicalName String Yes O nome lógico da entidade do registro que você deseja consultar, como "conta".
cadeia de caracteres de pesquisa String Yes Cadeia de caracteres para pesquisar entre os atributos dos registros da entidade.
tipo de pesquisa booleano Não Tipo de página de pesquisa a ser aberta — 0 para pesquisa de relevância e 1 para pesquisa categorizada. Se nenhum parâmetro for fornecido, os registros serão pesquisados por categoria. Para obter informações sobre a pesquisa de relevância, consulte Configurar a pesquisa do Dataverse.
sucessoRetorno de chamada Função Não Uma função a ser chamada quando alguns registros são recuperados.
erroRetorno de chamada Função Não Uma função a ser chamada quando a operação falhar.

Valor de retorno

Em caso de êxito, retorna um objeto promise contendo os atributos especificados anteriormente na descrição do parâmetro successCallback .

Exemplos

O exemplo a seguir mostra como consultar o termo "Contoso" entre os registros de uma entidade de conta especificando o tipo de pesquisa de relevância.

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

O exemplo a seguir mostra como consultar o termo "Contoso" entre os registros de uma entidade de conta, sem especificar o tipo de pesquisa.

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