Controllo di ricerca nella Knowledge Base di Parature (riferimento lato client)

Articolo
07/06/2017

Data di pubblicazione: novembre 2016

Si applica a: Dynamics CRM 2015

Con Aggiornamento 1 di Microsoft Dynamics CRM Online 2015 o versione successiva, quando un'organizzazione dispone dell'integrazione con Parature abilitata, è possibile aggiungere un nuovo controllo di ricerca nella Knowledge Base ai moduli. Il controllo fornisce il supporto a livello di programmazione per automatizzare o migliorare l'esperienza dell'utente durante l'utilizzo del controllo.

Importante

Per le organizzazioni di Microsoft Dynamics CRM Online, questa funzionalità è disponibile solo se nell'organizzazione è stato eseguito l'Aggiornamento 1 di Dynamics CRM Online 2015. Questa funzionalità non è disponibile per Dynamics CRM (locale).

Questi eventi e metodi non sono direttamente connessi a un'API di Parature. Tuttavia, se il controllo è presente nel modulo, una connessione a Parature deve già essere stata stabilita per poter eseguire direttamente le chiamate alle API di Parature senza la necessità di un token di sicurezza. Queste sono richieste tra domini e pertanto devi utilizzare la condivisione delle risorse multiorigine.

Il controllo di ricerca nella 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 comando 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 di seguito utilizzano kbSearchControl per rappresentare il controllo di ricerca nella Knowledge Base nel modulo.

Eventi

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.

Metodi

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.

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

getSelectedResult

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.getSelectedResult();

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 un reparto di Parature Questo valore viene utilizzato come chiave alternativa. Puoi utilizzarla per verificare se l'articolo è già presente in CRM.
articleUid	String	ID articolo univoco per il sistema Parature. Contiene l'ID account e l'ID reparto di Parature, 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.
createdOn	Date	Data di creazione dell'articolo. Puoi utilizzare l'età dell'articolo nella logica aziendale.
expiredDate	Date	La data dell'articolo è scaduta o scadrà. 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.
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. 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 bozza o pubblicato. 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 del Service Desk di Parature. Utilizza questo collegamento per aprire l'articolo utilizzando il Service Desk di Parature.
timesViewed	Number	Il numero di visualizzazioni dell'articolo nel portale Parature da parte dei clienti.

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

Integrare Microsoft Dynamics CRM 2015 con Parature
Riferimento programmazione sul lato client
Creare il codice per moduli di Microsoft Dynamics CRM 2015
Scrivere estensioni di applicazioni client

Condividi tramite