JavaScript-bibliotheken voor Microsoft Dynamics CRM 2015

Artikel
07/06/2017

Gepubliceerd: november 2016

Is van toepassing op: Dynamics CRM 2015

JavaScript bibliotheken zijn Scriptwebresources (JScript) die functies bevatten die u kunt gebruiken om:

Formulier- en veldgebeurtenissen verwerken.
Acties uitvoeren voor besturingselementen die in het Lint zijn geconfigureerd.
Andere functies ondersteunen.

JScript-bibliotheken gebruiken

U kunt zoveel JavaScript bibliotheken gebruiken als u JavaScript bibliotheken zou gebruiken in eender welke webtoepassing.

Koppel functies aan formulier- en veldgebeurtenissen

U kunt maximaal 50 scriptwebresourcen koppelen zodat deze worden geladen met een entiteitformulier.

Nadat u een bibliotheek aan het formulier toevoegt, is deze beschikbaar voor alle gebeurtenissen in het formulier. Voor elke gebeurtenis kunt u bepalen welke functies gebeurtenishandlers zijn. U kunt maximaal 50 functies opgeven als gebeurtenishandlers voor elke gebeurtenis.

Functies koppelen tijdens het uitvoeren

U kunt functies toevoegen aan het OnChange kenmerk, formulier OnSave, en opzoekbesturing PreSearch gebeurtenissen tijdens het gebruik van Xrm.Page.data.entity attribute.addOnChange, de Xrm.Page.data.entity.addOnSave, en de opzoekbesturingselement addPreSearch-methodes. Wanneer deze methoden worden gebruikt, wordt de functie toegevoegd onderaan de pipeline van de gebeurtenishandler en ontvangen ze de uitvoeringscontext als eerste parameter. U kunt de bijbehorende removeOnChange, removeOnSave en removePreSearch methodes gebruiken om functies te verwijderen die op deze manier zijn toegevoegd.

Uitvoeringscontext

Elke gebeurtenishandler kan worden geconfigureerd om een object van de uitvoeringscontext als eerste parameter te accepteren. De uitvoeringscontext bevat functies die kunnen worden aangeroepen om het volgende te bepalen:

Diepte: De relatieve volgorde waarin deze handler wordt uitgevoerd.
Gebeurtenisbron: een verwijzing naar het object dat de gebeurtenis deed starten.

Deze mogelijkheid is belangrijk als u een aan functie maakt die reageert op gebeurtenissen vanuit verschillende formulier- of veldgebeurtenissen.
Gedeelde Variabelen: Hiermee kan een functie een variabele instellen als een sleutel/waardepaar dat toegankelijk is voor andere gebeurtenishandlers.

Meer informatie:Uitvoeringscontext (clientreferentie)

In het dialoogvenster handlereigenschappen kunt u een lijst met door komma's gescheiden tekenreekswaarden invoeren die aan de functie wordt doorgegeven. Dit kan handig zijn om het gedrag van een functie te kunnen wijzigen zonder wijzigingen in de code te vereisen.

Gerelateerde functies met opdrachtbalk (Lint)-opdrachten

Elk besturingselement in de opdrachtbalk of het lint is gekoppeld aan een <CommandUIDefinition> (RibbonDiffXml), dat een <Actions> (RibbonDiffXml)-element bevat met een of meer acties.<JavaScriptFunction> (RibbonDiffXml) is een van de beschikbare acties. Het JavaScriptFunction element vereist een verwijzing naar een bibliotheek en een functie in deze bibliotheek.

Scripts testen en ontwikkelen

U kunt scripts bewerken via het webresourceformulier of op het tabblad Gebeurtenissen waar u formulierbibliotheken en gebeurtenishandlers configureert.

Of u kunt uw favoriete scripthulpmiddel gebruiken en uw wijzigingen uploaden om uw scriptwebresource bij te werken. U moet de webresource publiceren nadat u wijzigingen aanbrengt.

Scriptbibliotheken maken

Wanneer u functies ontwerpt die worden gebruikt in JScript bibliotheken, kunnen uw functies in een formulier worden geladen met andere JScript bibliotheken. Als een andere bibliotheek een functie bevat met dezelfde naam als een functie die u aanbiedt, wordt de laatst geladen functie gedefinieerd voor de pagina. Om te voorkomen dat uw functies worden overschreven door functies in een andere bibliotheek, moet u ervoor zorgen dat uw functies unieke namen hebben.

Twee strategieën die u kunt gebruiken om ervoor te zorgen dat uw functies unieke namen hebben, zijn:

Uniek functievoorvoegsel
Definieer elk van de functies met de standaardsyntaxis met een consistente naam die een unieke naamconventie omvat, zoals getoond in het volgende voorbeeld.
```
function MyUniqueName_performMyAction()
{
// Code to perform your action.
}
```
Bibliotheeknamen met naamruimtes
Koppel elk van uw functies aan een JScript object voor een type naamruimte die u wilt gebruiken om uw functies aan te roepen, zoals aangegeven in het volgende voorbeeld.
```
//If the MyUniqueName namespace object isn’t defined, create it.
if (typeof (MyUniqueName) == "undefined")
 { MyUniqueName = {}; }
  // Create Namespace container for functions in this library;
  MyUniqueName.MyFunctions = {
   performMyAction: function(){
   // Code to perform your action.
   //Call another function in your library
   this.anotherAction();
  },
  anotherAction: function(){
   // Code in another function
  }
};
```
Als u uw functie gebruikt, kunt u dan de volledige naam opgeven. In het volgende voorbeeld wordt dit getoond.
```
MyUniqueName.MyFunctions.performMyAction();
```
Als u een functie in een andere functie aanroept, kunt u het this trefwoord gebruiken als een snelkoppeling naar het object dat beide functies bevat. Wanneer uw functie echter wordt gebruikt als gebeurtenishandler, zal het trefwoord this verwijzen naar het object waarop de gebeurtenis zich voordoet.

Foutopsporingscripts

Elke browser heeft zijn eigen serie ontwikkelaarhulpprogramma's. De volgende instructies beschrijven het gebruik van Internet Explorer.

Fouten opsporen in een script in Microsoft Dynamics CRM-formulieren

Druk op F12 om de ontwikkelaarhulpprogramma's te openen.
Gebruik op het tabblad Script, rechts van de knop Foutopsporing starten, de vervolgkeuzelijst om uw bibliotheek JScript te zoeken.
Stel een onderbrekingspunt in door op de linkermarge in uw functie te klikken.
Klik op Foutopsporing starten.
Als uw script in de gebeurtenis Onload zit, moet u mogelijk het venster Microsoft Dynamics 365 selecteren en op F5 drukken om het venster opnieuw te laden.

Voor meer informatie, zie Foutopsporingscript met Ontwikkelaarhulpprogramma's.

Zie ook

JavaScript gebruiken met Microsoft Dynamics CRM 2015
Ontwikkelaarshandleiding over aanpassing voor Microsoft Dynamics CRM 2015
Uitbreidingen van clienttoepassingen schrijven
Scriptwebresources (JScript)
Code schrijven voor Microsoft Dynamics CRM 2015-formulieren
Entiteitformulieren aanpassen
Lintacties definiëren
Voorbeeld: Importbestanden gebruiken als webresources
Voorbeeld: Hulpprogramma Webresource

Delen via