JavaScript-biblioteker til Microsoft Dynamics CRM 2015

Artikel
07/06/2017

Udgivet: november 2016

Gælder for: Dynamics CRM 2015

JavaScript-biblioteker er Webressourcer for script (JScript) , der indeholder funktioner, som du kan bruge til at:

Håndtere formular- og felthændelser.
Udføre handlinger for kontrolelementer, der er konfigureret på båndet.
Understøtte andre funktioner.

Brug af JScript-biblioteker

Du kan bruge JavaScript-biblioteker meget i stil med JavaScript-biblioteker i ethvert webprogram.

Knytte funktioner til formular- og felthændelser

Du kan tilknytte op til 50 scriptwebressourcer, så de er udstyret med en objektformular.

Når du føjer et bibliotek til formularen, er det tilgængeligt for alle hændelser i formularen. For enhver hændelse kan du bestemme, hvilke funktioner der skal være hændelseshandlere. Du kan angive op til 50 funktioner som hændelseshandlere for en hvilken som helst hændelse.

Tilknytte funktioner på kørselstidspunktet

Du kan føje funktioner til OnChange-attributten, formularen OnSave og opslagskontrolelementets PreSearch-hændelser på kørselstidspunktet ved hjælp af Xrm.Page.data.entity attribute.addOnChange, Xrm.Page.data.entity.addOnSave og opslagskontrolelementets addPreSearch-metoder. Når disse metoder anvendes, tilføjes funktionen i bunden af hændelseshandlerens pipeline, og de modtager kørselskonteksten som den første parameter. Du kan bruge de tilsvarende removeOnChange,removeOnSave- og removePreSearch-metoder til at fjerne funktioner, der er tilføjet på denne måde.

Kørselskontekst

Hver hændelseshandler kan være konfigureret til at acceptere et kontekstobjekt for kørsel som den første parameter. Kørselskonteksten indeholder funktioner, der kan kaldes for at bestemme:

Dybde: Den relative rækkefølge, som denne handler udføres i.
Hændelseskilde: En reference til det objekt, der startede hændelsen.

Denne funktionsmåde er vigtig, når du opretter en funktion, der reagerer på hændelser fra flere forskellige formular- eller felthændelser.
Delte variabler: Giver en funktion mulighed for at angive en variabel som et nøgle-/værdipar, som andre hændelseshandlere kan få adgang til.

Flere oplysninger:Kontekst for udførelse (klientsidereference)

I dialogboksen Egenskaber for handler kan du angive en kommasepareret liste af strengværdier, der overføres til funktionen. Dette kan være nyttigt for at tillade, at funktionsmåden for en funktion kan ændres uden at kræve ændringer i koden.

Knytte funktioner til kommandolinjens (båndets) kommandoer

Hvert kontrolelement på kommandolinjen eller båndet er knyttet til en <CommandUIDefinition> (RibbonDiffXml) der indeholder et <Actions> (RibbonDiffXml) -element, der indeholder en eller flere handlinger<JavaScriptFunction> (RibbonDiffXml) er en af de tilgængelige handlinger.JavaScriptFunction-elementet kræver en henvisning til et bibliotek og en funktion i det pågældende bibliotek.

Udvikle og teste scripts

Du kan redigere scripts via webressourceformularen eller under fanen Hændelser, hvor du kan konfigurere formularbiblioteker og hændelseshandlere.

Eller du kan bruge dit foretrukne scriptredigeringsværktøj og overføre ændringerne for at opdatere din scriptwebressource. Når du har foretaget ændringer, skal du udgive webressourcen.

Oprettelse af scriptbiblioteker

Når du udformer funktioner, der skal bruges i JScript-biblioteker, kan funktionerne indlæses i en formular med andre JScript-biblioteker. Hvis et andet bibliotek indeholder en funktion, der har samme navn som en funktion, du leverer, er det den funktion, der indlæses sidst, som definerer siden. For at undgå, at dine funktioner bliver overskrevet af funktioner i et andet bibliotek, skal du sikre dig, at dine funktioner har entydige navne.

Der er to strategier, som du kan bruge til at sikre, at dine funktioner har entydige navne:

Entydigt funktionspræfiks
Definer de enkelte funktioner med standardsyntaksen og et ensartet navn, der indeholder en entydig navngivningskonvention, som vist i følgende eksempel.
```
function MyUniqueName_performMyAction()
{
// Code to perform your action.
}
```
Biblioteknavne med navneområde
Knyt hver af dine funktioner til et JScript-objekt for at oprette en slags navneområde, der skal bruges, når du kalder funktioner, som vist i følgende eksempel.
```
//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
  }
};
```
Når du bruger funktionen, kan du derefter angive det fulde navn. I følgende eksempel vises dette.
```
MyUniqueName.MyFunctions.performMyAction();
```
Hvis du kalder en funktion i en anden funktion, kan du bruge this-nøgleordet som en genvej til det objekt, der indeholder begge funktioner. Men, hvis din funktion bruges som en hændelseshandler, vil this-nøgleordet henvise til det objekt, hvor hændelsen opstår.

Fejlfinding af scripts

Hver browser sit eget sæt udviklingsværktøjer. Følgende instruktioner beskriver brugen af Internet Explorer.

Fejlfinding af script i Microsoft Dynamics CRM-formularer

Tryk på F12 for at åbne udviklingsværktøjerne.
Under fanen Script skal du til højre for knappen Start fejlfinding bruge rullelisten til at finde dit JScript-bibliotek.
Angiv et pausepunkt ved at klikke på venstre margen i din funktion.
Klik på Start fejlfinding.
Hvis dit script er i Onload-hændelsen, skal du måske vælge Microsoft Dynamics 365-vinduet og trykke på F5 for at genindlæse vinduet.

Yderligere oplysninger finder du i Fejlfinding af script med udviklerværktøjer.

Se også

Bruge JavaScript med Microsoft Dynamics CRM 2015
Udviklervejledning til tilpasning til Microsoft Dynamics CRM 2015
Skrive klientprogramudvidelser
Webressourcer for script (JScript)
Skrive kode til Microsoft Dynamics CRM 2015-formularer
Tilpasning af objektformularer
Definer handlinger på båndet
Eksempel: Importer filer som webressourcer
Eksempel: Webressourceværktøj

Del via