Søgekontrolelement til Parature-videnbasen (klientsidereference)

Artikel
07/06/2017

Udgivet: november 2016

Gælder for: Dynamics CRM 2015

I Opdatering 1 til Microsoft Dynamics CRM Online 2015 og efterfølgende versioner kan en organisation, som har aktiveret Parature-integration, tilføje et nyt kontrolelement til søgning i videnbasen i formularer. Dette kontrolelement understøtter programmering, som kan automatisere eller forbedre brugerens oplevelse, når kontrolelement bruges.

Vigtigt

For Microsoft Dynamics CRM Online-organisationer er denne funktion kun tilgængelig, hvis organisationen har opdateret til Dynamics CRM Online 2015 Update 1. Denne funktion er ikke tilgængelig for Dynamics CRM (i det lokale miljø).

Disse hændelser og metoder er ikke direkte forbundet med en Parature API. Men hvis kontrolelementet findes i formularen, bør der allerede være oprettet forbindelse til Parature, så du kan foretage direkte kald til Parature API'en uden at kræve et sikkerheds-id. Disse vil dog være anmodninger på tværs af domæner, så du skal bruge CORS (Cross-Origin Resource Sharing).

Søgekontrolelementet til vidensstyring er et Xrm.Page.ui kontrolelement, så det understøtter alle standardmetoder for kontrolelementer. Men det understøtter også yderligere hændelser og metoder. Du kan finde oplysninger om de standardkontrolmetoder under Kontrolelementet Xrm.Page.ui (klientsidereference).

Hvis du kender navnet på kontrolelementet, du kan få adgang til det ved hjælp af følgende, hvor <navn> repræsenterer navnet på kontrolelementet...

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

Bemærk

Når søgekontrolelementet til videnbasen føjes til ruden Socialt, bliver navnet "searchwidgetcontrol_notescontrol". Dette navn kan ikke ændres.

Alle eksemplerne nedenfor bruger kbSearchControl til at repræsentere søgekontrolelementet til videnbasen i formularen.

Hændelser

Brug hændelserne for dette kontrolelement til at tillade kode at svare på det valgte eller åbnede emne.

OnResultOpened

Denne hændelse indtræffer, når en KB-artikel åbnes i det indbyggede søgekontrolelement til videnbasen eller via en pop ud-handling. Brug metoderne addOnResultOpened og removeOnResultOpened til at administrere hændelseshandlere for denne hændelse.

OnSelection

Denne hændelse opstår, når der er valgt en KB-artikel i søgekontrolelementet til videnbasen. Brug metoderne addOnSelection og removeOnSelection til at administrere hændelseshandlere for denne hændelse.

Metoder

Brug metoderne for søgekontrolelementet til videnbasen til at angive eller fjerne hændelseshandlere og arbejde med søgeforespørgslen og søgeresultaterne.

addOnResultOpened

Brug denne metode til at føje en hændelseshandler til hændelsen OnResultOpened.

Parameter: Funktion. Den funktion, der skal tilføjes.

Eksempel: Føj funktionen myFunction til OnResultOpened-hændelsen.

kbSearchControl.addOnResultOpened(myFunction);

addOnSelection

Brug denne metode til at føje en hændelseshandler til hændelsen OnSelection.

Parameter: Funktion. Den funktion, der skal tilføjes.

Eksempel: Føj funktionen myFunction til OnSelection-hændelsen.

kbSearchControl.addOnSelection(myFunction);

getSearchQuery

Brug denne metode til at hente den tekst, der bruges som søgekriteriet for søgekontrolelementet til videnbasen.

Returværdi: Streng. Teksten i søgeforespørgslen.

Eksempel: Indstil variablen searchQuery til teksten i søgeforespørgslen.

var searchQuery = kbSearchControl.getSearchQuery();

getSelectedResult

Brug denne metode til at hente det aktuelt valgte resultat af søgekontrolelementet. Det aktuelt valgte resultat repræsenterer også det resultat, der er åbent.

Returværdi: KBSearchResult. Det aktuelt valgte resultat.

Eksempel: Indstil variablen kbSearchResult til det aktuelt valgte resultat.

var kbSearchResult = kbSearchControl.getSelectedResult();

Egenskaber for KBSearchResult

I følgende tabel beskrives egenskaberne for objektet KBSearchResult.

Egenskab	Type	Beskrivelse
answer	String	Den HTML-kode, der indeholder artiklens indhold. Du kan overføre indholdet til en brugerdefineret handling, der kan medtages i en mail til kunden.
articleId	String	Artikel-id'et i en Parature afdeling Denne værdi bruges som en alternativ nøgle. Du kan bruge den til at se, om denne artikel allerede findes i CRM.
articleUid	String	Det entydige artikel-id for Parature systemet. Det indeholder Parature firma-id og afdelings-id, for eksempel "7924/8112/Article/25". Denne værdi bruges som en alternativ nøgle. Dette id bruges til at oprette en ny post i KB og samtidig tilknytte en artikel, hvis der ikke allerede findes en.
createdOn	Date	Den dato, artiklen blev oprettet. Du kan evt. bruge alderen på artiklen i din forretningslogik.
expiredDate	Date	Den dato, hvor artiklen udløber eller er udløbet. Du kan sammenligne denne dato med den aktuelle data for at bestemme, om artiklen er udløbet. Værdien bruger den aktuelle brugers tidszone og -format.
isAssociated	Boolean	Angiver, om artiklen er knyttet til den overordnede post. Du kan kontrollere denne værdi, før du knytter artiklen til den aktuelle post, ved hjælp af formularscripts eller i en anden proces, der er iværksat af formularscripts.
lastModifiedOn	Date	Den dato, hvor artiklen sidst blev ændret. Værdien vises i den aktuelle brugers tidszone og -format.
publicUrl	String	URL-adressen til artiklens supportportal. Brug en brugerdefineret handling til at medtage adressen i et link i en mail til en kunde.
published	Boolean	Angiver, om artiklen er i publiceret tilstand eller kladdetilstand. Du bør kontrollere, om artiklen er offentliggjort, før du sender oplysninger om den til en kunde.
question	String	Titlen på artiklen. Hvis du vil henvise til artiklen i en forretningsproces, kan du referere til navnet på den ved hjælp af denne værdi.
rating	Number	Klassificeringen af artiklen.
searchBlurb	String	Et kort stykke af artikelindhold, som indeholder de områder, hvor der var et søgeresultat. Brug det til at give brugere på søgelisten et indblik i artiklen og hjælpe dem med at afgøre, om dette er den artikel, de leder efter.
serviceDeskUri	String	Link til artiklen i Parature-servicedesk. Brug dette hyperlink til at åbne artiklen via Parature-servicedesk.
timesViewed	Number	Det antal gange, en artikel er åbnet på Parature-portalen af kunder.

removeOnResultOpened

Brug denne metode til at fjerne en hændelseshandler fra hændelsen OnResultOpened.

Parameter: Funktion. Den funktion, der skal fjernes.

Eksempel: Fjern funktionen myFunction fra OnResultOpened-hændelsen.

kbSearchControl.removeOnResultOpened(myFunction);

removeOnSelection

Brug denne metode til at fjerne en hændelseshandler fra hændelsen OnSelection.

Parameter: Funktion. Den funktion, der skal fjernes.

Eksempel: Fjern funktionen myFunction fra OnSelection-hændelsen.

kbSearchControl.removeOnSelection(myFunction);

setSearchQuery

Brug denne metode til at indstille den tekst, der bruges som søgekriteriet for søgekontrolelementet til videnbasen.

Parameter: Streng. Teksten til søgeforespørgslen.

Eksempel: Indstil teksten til søgeforespørgslen til "How to solve the problem".

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

Se også

Integrere Microsoft Dynamics CRM 2015 med Parature
Programmeringsreference på klientsiden
Skrive kode til Microsoft Dynamics CRM 2015-formularer
Skrive klientprogramudvidelser

Del via