Zoekbesturingselement voor Parature Knowledge Base (clientreferentie)
Gepubliceerd: november 2016
Is van toepassing op: Dynamics CRM 2015
Wanneer een organisatie in Update 1 voor Microsoft Dynamics CRM Online 2015 of hoger Parature-integratie heeft ingeschakeld, kunnen zij een nieuw zoekbesturingselement voor Knowledge Base toevoegen aan formulieren. Dit besturingselement levert programmeerbaarheidsondersteuning om de gebruikerservaring te automatiseren of te verbeteren bij gebruik van dit besturingselement.
Belangrijk
Voor Microsoft Dynamics CRM Online-organisaties is deze functie alleen beschikbaar als uw organisatie is bijgewerkt naar Dynamics CRM Online 2015 Update 1. Deze functie is niet beschikbaar voor Dynamics CRM (on-premises).
Deze gebeurtenissen en methoden zijn niet rechtstreeks verbonden aan een Parature-API. Als het besturingselement echter aanwezig is in het formulier, zou reeds een verbinding met Parature tot stand moeten zijn gebracht zodat u direct Parature-API-aanroepen kunt doen zonder dat een beveiligingstoken is vereist. Dit zijn echter domeinoverschrijdende aanvragen, dus moet u CORS (Cross-Origin Resource Sharing) gebruiken.
Het besturingselement voor zoeken bij Knowledge Base-beheer is een Xrm.Page.ui-besturingselement, dus het ondersteunt alle standaardmethoden waarover besturingselementen beschikken. Maar het ondersteunt tevens extra gebeurtenissen en methoden. Zie Xrm.Page.ui control (referentie aan de clientzijde) voor informatie over de standaardmethoden van besturingselementen.
Als u de naam van het besturingselement weet, kunt u hier toegang toe krijgen met de volgende code, waarbij <naam> de naam van het besturingselement aangeeft.
kbSearchControl = Xrm.Page.getControl("<name>");
Notitie
Wanneer het besturingselement Zoeken in Knowledge Base wordt toegevoegd, wordt de naam van het sociale deelvenster "searchwidgetcontrol_notescontrol". Deze naam kan niet worden gewijzigd.
Alle onderliggende exemplaren gebruiken kbSearchControl om het besturingselement Zoeken in Knowledge Base weer te geven in het formulier.
Gebeurtenissen
Gebruik de gebeurtenissen voor dit besturingselement om code in staat te stellen te reageren op het geselecteerde of geopende item.
OnResultOpened
Deze gebeurtenis doet zich voor als een KB-artikel wordt geopend in het besturingselement Zoeken in Knowledge Base via In venster of via de actie Nieuw venster. Gebruik de methoden addOnResultOpened en removeOnResultOpened om gebeurtenishandlers voor deze gebeurtenis te beheren.
OnSelection
Deze gebeurtenis doet zich voor als een KB-artikel wordt geselecteerd in het besturingselement Zoeken in Knowledge Base. Gebruik de methoden addOnSelection en removeOnSelection om gebeurtenishandlers voor deze gebeurtenis te beheren.
Methoden
Gebruik de methoden voor het besturingselement Zoeken in Knowledge Base om gebeurtenishandlers in te stellen of te verwijderen en interacties uit te voeren met de zoekquery en zoekresultaten.
addOnResultOpened
Gebruik deze methode om een gebeurtenishandler toe te voegen aan de gebeurtenis OnResultOpened.
Parameter: Functie. De toe te voegen functie.
Voorbeeld: Voeg de functie met de naam myFunction toe aan de gebeurtenis OnResultOpened.
kbSearchControl.addOnResultOpened(myFunction);
addOnSelection
Gebruik deze methode om een gebeurtenishandler toe te voegen aan de gebeurtenis OnSelection.
Parameter: Functie. De toe te voegen functie.
Voorbeeld: Voeg de functie met de naam myFunction toe aan de gebeurtenis OnSelection.
kbSearchControl.addOnSelection(myFunction);
getSearchQuery
Gebruik deze methode om de tekst op te halen die wordt gebruikt als zoekcriterium voor het besturingselement Knowledge Base-beheer.
Retourwaarde: Tekenreeks. De tekst van de zoekquery.
Voorbeeld: Stel de variabele searchQuery in op de tekst van de zoekquery.
var searchQuery = kbSearchControl.getSearchQuery();
getSelectedResult
Gebruik deze methode om het huidige geselecteerde resultaat van het besturingselement Zoeken op te halen. Het huidige geselecteerde resultaat staat tevens voor het resultaat dat momenteel is geopend.
Retourwaarde: KBSearchResult. Het huidige geselecteerde resultaat.
Voorbeeld: Stel de variabele kbSearchResult in op het huidige geselecteerde resultaat.
var kbSearchResult = kbSearchControl.getSelectedResult();
Eigenschappen van KBSearchResult
In de volgende tabel worden de eigenschappen van het object KBSearchResult beschreven.
Eigenschap |
Type |
Beschrijving |
|---|---|---|
answer |
String |
De HTML-markering die de inhoud van het artikel bevat. U kunt deze inhoud doorgeven aan een aangepaste actie die deze zou kunnen opnemen in een e-mailbericht voor verzending aan de klant. |
articleId |
String |
De artikel-id in een Parature-afdeling Deze waarde wordt gebruikt als alternatieve sleutel. U kunt deze gebruiken om te zien of dit artikel al bestaat in CRM of niet. |
articleUid |
String |
De unieke artikel-id voor het Parature-systeem. Dit bevat tevens de Parature-account-id en -afdelings-id, bijvoorbeeld "7924/8112/Article/25". Deze waarde wordt gebruikt als alternatieve sleutel. Deze id is nodig om een nieuwe KB-record te maken bij het koppelen van een artikel als een dergelijke record nog niet bestaat. |
createdOn |
Date |
De datum waarop het artikel is gemaakt. Mogelijk wilt u de leeftijd van het artikel gebruiken in uw bedrijfslogica. |
expiredDate |
Date |
De datum waarop het artikel verloopt of zal verlopen. U kunt deze datum met de huidige datum vergelijken om te bepalen of het artikel al dan niet is verlopen. De waarde gebruikt de tijdzone en indeling van de huidige gebruiker. |
isAssociated |
Boolean |
Geeft aan of het artikel is gekoppeld met de bovenliggende record of niet. U kunt deze waarde controleren voordat u het artikel koppelt aan de huidige record via formulierscript of in een ander proces dat door formulierscripts wordt geïnitieerd. |
lastModifiedOn |
Date |
De datum waarop het artikel het laatst is gewijzigd. Deze waarde wordt gebruikt in de tijdzone en indeling van de huidige gebruiker. |
publicUrl |
String |
URL voor ondersteuningsportal van het artikel. Gebruik een aangepaste actie om deze op te nemen in een koppeling in de inhoud van een e-mailbericht voor verzending aan een klant. |
published |
Boolean |
Geeft aan of het artikel is gepubliceerd of in conceptversie verkeert. U dient te controleren of het artikel is gepubliceerd voordat u informatie hierover naar een klant verzendt. |
question |
String |
De titel van het artikel. Als u naar het artikel gaat verwijzen in ee bedrijfsproces, kunt u hiernaar verwijzen bij naam met behulp van deze waarde. |
rating |
Number |
De kwalificatie van het artikel. |
searchBlurb |
String |
Een kort fragment van artikelinhoud dat de gebieden bevatten waar de zoekquery resultaten heeft opgeleverd. Gebruik dit om de gebruikers in de zoeklijst een glimp van het artikel te bieden en hun te helpen bepalen of dit het artikel is dat zij zoeken. |
serviceDeskUri |
String |
Koppeling naar het artikel in de Parature-servicedesk. Gebruik deze koppeling voor het openen van het artikel via de Parature-servicedesk. |
timesViewed |
Number |
Het aantal malen dat een artikel door klanten is bekeken op de Parature-portal. |
removeOnResultOpened
Gebruik deze methode om een gebeurtenishandler te verwijderen uit de gebeurtenis OnResultOpened.
Parameter: Functie. De te verwijderen functie.
Voorbeeld: Verwijder de functie met de naam myFunction uit de gebeurtenis OnResultOpened.
kbSearchControl.removeOnResultOpened(myFunction);
removeOnSelection
Gebruik deze methode om een gebeurtenishandler te verwijderen uit de gebeurtenis OnSelection.
Parameter: Functie. De te verwijderen functie.
Voorbeeld: Verwijder de functie met de naam myFunction uit de gebeurtenis OnSelection.
kbSearchControl.removeOnSelection(myFunction);
setSearchQuery
Gebruik deze methode om de tekst in te stellen die wordt gebruikt als zoekcriterium voor het besturingselement Knowledge Base-beheer.
Parameter: Tekenreeks. De tekst voor de zoekquery.
Voorbeeld: Stel de tekst van de zoekquery in op "How to solve the problem".
kbSearchControl.setSearchQuery("How to solve the problem");
Zie ook
Microsoft Dynamics CRM 2015 integreren met Parature
Programmeerreferentie op de client
Code schrijven voor Microsoft Dynamics CRM 2015-formulieren
Uitbreidingen van clienttoepassingen schrijven
© 2017 Microsoft. Alle rechten voorbehouden. Auteursrecht