Controllo di ricerca nella Knowledge Base (riferimento lato client)

 

Data di pubblicazione: gennaio 2017

Si applica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Puoi aggiungere un controllo ricerca della knowledge base ai moduli entità nell'istanza di Dynamics 365 per cui è abilitata la funzionalità di gestione delle informazioni. Con questo controllo, è possibile automatizzare o migliorare, a livello di programmazione, le esperienze di ricerca degli utenti quando utilizzano il controllo per utilizzare le informazioni in Dynamics 365.Ulteriori informazioni:Entità di gestione delle informazioni

Nota

• Puoi scegliere le informazioni native di Dynamics 365 o le informazioni di Parature come origine della gestione e della ricerca delle informazioni. Se usi Parature come origine della knowledge base e il controllo di ricerca della knowledge base è presente nel modulo, devi aver già stabilito una connessione a Parature in modo da poter effettuare direttamente chiamate all'API Parature senza richiedere un token di sicurezza. Queste sono richieste tra domini e pertanto devi utilizzare la condivisione delle risorse multiorigine.

  I seguenti nuovi API client introdotti in Aggiornamento 1 di CRM Online 2016 e Dynamics 365 Service Pack 1 (locale) non sono supportati se stai utilizzando Parature come origine della Knowledge Base: evento PostSearch, addOnPostSearch, removeOnPostSearch, getTotalRecordCount e openSearchResult.

• Con il rilascio di Aggiornamento 1 di CRM Online 2016 e Dynamics 365 SP1 (locale), il controllo di ricerca della Knowledge Base è inoltre supportato per i client mobili Dynamics 365 per telefoni e tablet.

Il controllo di ricerca della Knowledge Base è di tipo Xrm.Page.ui e quindi supporta tutti i metodi standard dei controlli. Inoltre, supporta eventi o metodi aggiuntivi. Per informazioni sui metodi di controllo standard, vedi Controllo Xrm.Page.ui (riferimento lato client).

Se conosci il nome del controllo, puoi accedervi con il codice seguente, dove <nome> indica il nome del controllo.

kbSearchControl = Xrm.Page.getControl("<name>");

Nota

Quando il controllo di ricerca nella Knowledge Base viene aggiunto al riquadro social il nome diventa "searchwidgetcontrol_notescontrol". Questo nome non può essere modificato.

Tutti esempi indicati in questo argomento utilizzano kbSearchControl per rappresentare il controllo di ricerca della Knowledge Base nel modulo.

In questo argomento

Eventi del controllo di ricerca della Knowledge Base

Metodi del controllo di ricerca della Knowledge Base

Eventi del controllo di ricerca della Knowledge Base

Utilizza gli eventi per il controllo per permettere al codice di rispondere all'elemento selezionato o aperto.

OnResultOpened

Questo evento si verifica quando un articolo della Knowledge Base viene aperto nel controllo di ricerca nella Knowledge Base in linea o mediante l'azione di apertura di una nuova finestra. Utilizza i metodi addOnResultOpened e removeOnResultOpened per amministrare i gestori di questo evento.

OnSelection

Questo evento si verifica quando un articolo della Knowledge Base viene selezionato nel controllo di ricerca nella Knowledge Base. Utilizza i metodi addOnSelection e removeOnSelection per amministrare i gestori di questo evento.

PostSearch

Questo evento si verifica quando la ricerca è stata completata e i risultati vengono visualizzati. Utilizza i nuovi metodi addOnPostSearch e removeOnPostSearchper gestire i gestori di questo evento.

Metodi del controllo di ricerca della Knowledge Base

Utilizza i metodi per il controllo ricerca della Knowledge Base per impostare o rimuovere i gestori eventi e interagire con la query di ricerca e i risultati della ricerca.

addOnPostSearch

Utilizza questo metodo per aggiungere un gestore all'evento PostSearch.

Parametro: Funzione. Funzione da aggiungere.

Esempio: aggiungi la funzione myFunction all'evento PostSearch.

kbSearchControl.addOnPostSearch(myFunction);

addOnResultOpened

Utilizza questo metodo per aggiungere un gestore all'evento OnResultOpened.

Parametro: Funzione. Funzione da aggiungere.

Esempio: aggiungi la funzione myFunction all'evento OnResultOpened.

kbSearchControl.addOnResultOpened(myFunction);

addOnSelection

Utilizza questo metodo per aggiungere un gestore all'evento OnSelection.

Parametro: Funzione. Funzione da aggiungere.

Esempio: aggiungi la funzione myFunction all'evento OnSelection.

kbSearchControl.addOnSelection(myFunction);

getSearchQuery

Utilizza questo metodo per ottenere il testo utilizzato come criterio di ricerca per il controllo di gestione della Knowledge Base.

Valore restituito: Stringa. Testo della query di ricerca.

Esempio: imposta la variabile searchQuery sul testo della query di ricerca.

var searchQuery = kbSearchControl.getSearchQuery();

getSelectedResults

Utilizza questo metodo per ottenere il risultato attualmente selezionato del controllo di ricerca. Il risultato attualmente selezionato rappresenta anche il risultato attualmente aperto.

Valore restituito: KBSearchResult. Risultato attualmente selezionato.

Esempio: imposta la variabile kbSearchResult sul risultato attualmente selezionato.

var kbSearchResult = kbSearchControl.getSelectedResults();

Proprietà KBSearchResult

Nella tabella seguente vengono descritte le proprietà dell'oggetto KBSearchResult.

Proprietà	Tipo	Descrizione
answer	String	Il markup HTML con il contenuto dell'articolo. Puoi passare il contenuto a un'azione personalizzata che lo inserisce in un messaggio e-mail da inviare al cliente.
articleId	String	ID articolo in Dynamics 365 o reparto Parature Questo valore viene utilizzato come chiave alternativa. Puoi utilizzarla per verificare se l'articolo è già presente in Dynamics 365.
articleUid	String	ID articolo univoco in Dynamics 365 o nel sistema Parature. Quando usi Parature come origine di informazioni, questo conterrà l'ID account Parature e l'ID reparto, ad esempio "7924/8112/Article/25". Questo valore viene utilizzato come chiave alternativa. Questo ID è necessario per creare un nuovo record della Knowledge Base durante l'associazione di un articolo, se non è già esistente.
attachmentCount	Numero	Numero di allegati nell'articolo. Applicabile solo quando usi Parature come origine di esempio.
createdOn	Date	Data di creazione dell'articolo. Il valore utilizzerà il formato dell'ora e il fuso orario dell'utente. Puoi utilizzare l'età dell'articolo nella logica aziendale.
expiredDate	Date	La data dell'articolo è scaduta o scadrà. Sarà null quando usi Dynamics 365 come origine delle informazioni. Puoi confrontare questa data con la data corrente per determinare se l'articolo è scaduto o meno. Il valore utilizza il formato dell'ora e il fuso orario dell'utente.
folderHref	String	Collegamento al percorso di cartelle dell'articolo in Parature. Applicabile solo quando usi Parature come origine di esempio.
href	String	Collegamento diretto agli articoli nell'API Parature che può essere usato per ottenere direttamente il contenuto dell'articolo. Applicabile solo quando usi Parature come origine di esempio.
isAssociated	Boolean	Indica se l'articolo è associato al record padre o meno. Puoi controllare questo valore prima dell'associazione dell'articolo al record corrente con gli script dei moduli o in un altro processo avviato dagli script dei moduli.
lastModifiedOn	Date	Data dell'ultima modifica dell'articolo. Il valore utilizzerà il formato dell'ora e il fuso orario dell'utente.
publicUrl	String	URL del portale di supporto dell'articolo. Se l'opzione URL portale è disabilitata, sarà vuoto. Utilizza un'azione personalizzata per includerlo in un collegamento nel contenuto di un messaggio e-mail da inviare a un cliente.
published	Boolean	Indica se l'articolo è nello stato pubblicato.True se pubblicato; altrimenti False. Devi controllare se l'articolo è pubblicato prima di inviare le relative informazioni a un cliente.
question	String	Titolo dell'articolo. Se desideri fare riferimento all'articolo in un processo aziendale, puoi farvi riferimento tramite il nome utilizzando questo valore.
rating	Number	Valutazione dell'articolo.
searchBlurb	String	Un breve frammento dell'articolo contenente le aree in cui la query di ricerca è stata eseguita. Utilizza questa opzione per consentire il controllo dell'articolo agli utenti nell'elenco di ricerca e consentirgli di determinare se si tratta dell'articolo che stanno cercando.
serviceDeskUri	String	Collegamento all'articolo in Dynamics 365 o nel service desk di Parature. Usa questo collegamento per aprire l'articolo usando Dynamics 365 o il service desk di Parature.
timesViewed	Number	Il numero di visualizzazioni dell'articolo nel portale da parte dei clienti.

getTotalRecordCount

Ottiene il numero di risultati trovati nel controllo di ricerca.

Valore restituito: Integer. Il numero di risultati di ricerca.

Esempio: impostare la variabile searchCount al numero di risultati della ricerca nel controllo di ricerca.

var searchCount = kbSearchControl.getTotalResultCount();

openSearchResult

Apre un risultato trovare nel controllo della ricerca specificando il numero di risultati.

var openResultStatus = kbSearchControl.openSearchResult(resultNumber, mode);

Argomenti

• resultNumber (Integer): valore numerico che specifica il numero di risultati da aprire. Il numero di risultati inizia da 1. Obbligatorio.

• mode (String): specificare "Inline" o "Popout". (Facoltativo). Se non specifichi un valore per l'argomento, viene utilizzata l'opzione predefinita ("Inline").

  La modalità "Inline" apre il risultato in linea nel riquadro di lettura del controllo o in una scheda del pannello di riferimento. La modalità "Popout" apre il risultato in una finestra a comparsa.

Valore restituito: booleano. Lo stato di apertura del risultato di ricerca specificato. Restituisce 1 riuscito; 0 se non riuscito. Il metodo restituirà -1 se il valore resultNumber non è presente, o se il valore mode specificato non è valido.

removeOnPostSearch

Utilizza questo metodo per rimuovere un gestore dall'evento PostSearch.

Parametro: Funzione. Funzione da rimuovere.

Esempio: rimuovi la funzione myFunction dall'evento PostSearch.

kbSearchControl.removeOnPostSearch(myFunction);

removeOnResultOpened

Utilizza questo metodo per rimuovere un gestore dall'evento OnResultOpened.

Parametro: Funzione. Funzione da rimuovere.

Esempio: rimuovi la funzione myFunction dall'evento OnResultOpened.

kbSearchControl.removeOnResultOpened(myFunction);

removeOnSelection

Utilizza questo metodo per rimuovere un gestore dall'evento OnSelection.

Parametro: Funzione. Funzione da rimuovere.

Esempio: rimuovi la funzione myFunction dall'evento OnSelection.

kbSearchControl.removeOnSelection(myFunction);

setSearchQuery

Utilizza questo metodo per impostare il testo utilizzato come criterio di ricerca per il controllo di gestione della Knowledge Base.

Parametro: Stringa. Testo della query di ricerca.

Esempio: imposta il testo della query di ricerca su "How to solve the problem".

kbSearchControl.setSearchQuery("How to solve the problem");

Vedere anche

Utilizzare articoli della Knowledge Base in Dynamics 365
Utilizzare la knowledge base di Parature in Dynamics 365
Riferimento programmazione sul lato client
Creare il codice per moduli di Microsoft Dynamics 365
Estendere Microsoft Dynamics 365 nel client

Microsoft Dynamics 365

© 2017 Microsoft. Tutti i diritti sono riservati. Copyright