Brug JavaScript med Customer Engagement (i det lokale miljø)

Dynamics 365 for Customer Engagement giver mange muligheder for at bruge JavaScript. Al JavaScript, der bruges i Dynamics 365 Customer Engagement (i det lokale miljø), tilføjes ved at oprette JavaScript-webressourcer. Dette emne indeholder oplysninger til udviklere, der bruger JavaScript, og indeholder links til relevante emner i Dynamics 365 Customer Engagement Web Services og andre kilder.

Områder, hvor du kan bruge JavaScript i Dynamics 365 Customer Engagement (i det lokale miljø)

Du kan bruge JavaScript til at udføre handlinger i formularscripts, kommandoer på kommandolinjen (bånd) og webressourcer.

Formularscripts

Den mest almindelige brug af JavaScript i Dynamics 365 Customer Engagement (i det lokale miljø) er at tilføje funktioner som hændelseshandlere for objektformularhændelser. Du kan få flere oplysninger under Klientscripting i Customer Engagement ved hjælp af JavaScript.

Kommandoer på kommandolinjen (bånd)

Når du tilpasser kommandolinjen dynamics 365 Customer Engagement (i det lokale miljø), kan du konfigurere kommandoer for kontrolelementer, du tilføjer. Disse kommandoer indeholder regler, der styrer, om kontrolelementet er aktiveret, og hvilken handling der udføres, når kontrolelementet bruges. Du kan få flere oplysninger under Tilpas kommandoer og båndet.

Webressourcer

Dynamics 365 Customer Engagement (i det lokale miljø) indeholder en organisationsejet enhed, der gemmer en binær repræsentation af en fil, som du kan få adgang til ved hjælp af en URL-adresse. Denne fil kaldes en webressource. Der er flere typer webressourcer. En webressource, der repræsenterer et JavaScript-bibliotek, kaldes en JavaScript-webressource. Du kan bruge en html-webressource (webside) til at angive en brugergrænseflade med JavaScript-biblioteker, der er inkluderet på samme måde som for filer på en webserver. Da disse filer er en del af Dynamics 365 Customer Engagement (i det lokale miljø), er brugere, der har adgang til dem, allerede godkendt. Derfor kan du bruge Dynamics 365 Customer Engagement-webtjenester (i det lokale miljø) uden at skulle skrive kode for at godkende brugeren. Du kan få flere oplysninger under Webressourcer til Dynamics 365 Customer Engagement og Arbejd med Dynamics 365 Customer Engagement-data ved hjælp af webressourcer.

Brug af jQuery

Brug jQuery med HTML-webressourcer
Vi anbefaler, at du bruger jQuery sammen med HTML-webressourcer til at levere brugergrænseflader, fordi det er et fremragende bibliotek på tværs af browsere.

Med HTML-webressourcer kan du styre de biblioteker, der findes, og der er ingen begrænsning i at manipulere DOM. Du er velkommen til at bruge jQuery i dine HTML-webressourcer.

Notat

Hvis scriptreferencen til ClientGlobalContext.js.aspx placeres efter din egen jQuery-reference, overskriver de ClientGlobalContext.js.aspx scripts den tidligere indlæste version af jQuery. Du kan undgå dette ved at placere ClientGlobalContext.js.aspx scriptreference før andre scriptreferencer i webressourcen.

Skriv JavaScript til flere browsere

Da du ikke ved, hvilken browser der vil være i brug, skal du sørge for, at alle scripts, du bruger, fungerer sammen med alle understøttede browsere. De fleste af de betydelige forskelle mellem Internet Explorer og andre browsere har at gøre med HTML- og XML DOM-manipulation. Da HTML DOM-manipulation ikke understøttes, kan de ændringer, der kræves for at understøtte andre browsere, være små, hvis scriptlogik kun udfører understøttede handlinger og bruger klient-API'en.

Et bibliotek på tværs af browsere som jQuery er en god løsning til udvikling af webressourcer, men det bør ikke være nødvendigt for formularscripts eller kommandoer på båndet. Flere oplysninger: Undgå at bruge jQuery til formularscripts

Bedste praksis for JavaScript-programmering

I følgende afsnit beskrives de bedste fremgangsmåder, når du bruger JavaScript med Dynamics 365 Customer Engagement (i det lokale miljø).

Undgå at bruge ikke-understøttede metoder

På internettet kan du finde mange eksempler eller forslag, der beskriver brugen af ikke-understøttede metoder. Disse kan omfatte brug af ikke-dokumenteret intern funktion for sidekontrolelementer. Disse metoder kan fungere, men fordi de ikke understøttes, kan du ikke forvente, at de fortsat fungerer i fremtidige versioner af Dynamics 365 Customer Engagement (i det lokale miljø).

Brug et JavaScript-bibliotek på tværs af browsere til brugergrænsefladen i HTML-webressourcer

Et JavaScript-bibliotek på tværs af browsere, f.eks . jQuery, giver mange fordele, når du udvikler HTML-webressourcer, der skal understøtte flere browsere. JavaScript-biblioteker som jQuery giver en samlet udviklingsoplevelse for alle browsere, der understøttes af Dynamics 365 Customer Engagement (i det lokale miljø). Disse funktioner er relevante, når du bruger HTML-webressourcer til at levere brugergrænseflader. JavaScript-biblioteker som jQuery giver ensartede måder at interagere med DOM (Document Object Model).

Brug ikke jQuery til formularscript eller kommandoer

Vi anbefaler eller understøtter ikke brug af jQuery for nogen sider i programmet. Dette omfatter formularscripts og båndkommandoer. Flere oplysninger: Brug af jQuery.

Genkend begrænsninger for CDN-biblioteker (Content Delivery Network)

JavaScript-biblioteker (Content Delivery Network– CDN) giver mange fordele for offentlige websteder. Da disse biblioteker hostes på internettet, behøver du ikke at oprette webressourcer, der indeholder indholdet af bibliotekerne. For Dynamics 365 Customer Engagement (i det lokale miljø) skal du overveje følgende problemer, før du bruger et CDN JavaScript-bibliotek.

Brugere af Dynamics 365 for Microsoft Office Outlook med offlineadgangsklienten har mulighed for at arbejde uden internetforbindelse, mens de arbejder offline. Hvis du er afhængig af en internetforbindelse til JavaScript-biblioteker, mislykkes din kode.
Nogle organisationer vil begrænse medarbejdernes adgang til internettet. Medmindre de konfigurerer netværket til at give adgang til CDN-bibliotekswebstederne, kan koden mislykkes for disse organisationer.

Alternativet til at bruge CDN-biblioteker er at oprette en scriptwebressource (JavaScript) med indholdet af biblioteket. Da webressourcer er organisationsejede enheder, synkroniseres de, når en Dynamics 365 for Outlook med offlineadgangsbruger går offline. Da disse webressourcer nu bliver en del af programmet, blokeres de ikke, hvis en organisation begrænser adgangen til internettet.

Brug funktionsregistrering, når du skriver funktioner til flere browsere

Selv når du bruger et bibliotek på tværs af browsere som jQuery, skal du være meget opmærksom på forskellene mellem browsere. Du kan generelt registrere, hvilken browser der bruges, ved at forespørge egenskaben navigator.useragent . Dette kaldes browserregistrering. Browserregistrering er ikke en god strategi i de fleste tilfælde, fordi den ikke kan tage højde for, hvilke funktioner nyere versioner af en browser har. Nogle browsere giver også mulighed for at ændre navigation.useragent egenskaben, så de ser ud til at være en anden browser.

Funktionsregistrering er den anbefalede fremgangsmåde. Ved at registrere, hvilke funktioner der er tilgængelige, kan du oprette kodestier for de browsere, du understøtter, uden at vide præcis, hvilken browser der bruges. Du kan finde flere oplysninger om funktionsregistrering under Sådan registrerer du funktioner i stedet for browsere.

Få ikke adgang til DOM

JavaScript-udviklere bruges til at interagere med DOM-elementer (Document Object Model) i kode. Du kan bruge window.getElementById metoden eller jQuery-biblioteket. Du kan frit bruge disse teknikker i dine HTML-webressourcer, men de understøttes ikke for at få adgang til elementer på programsider eller objektformularer i Dynamics 365 Customer Engagement (i det lokale miljø). Adgang til objektformularelementer vises i stedet via klient-API-objektmodellen. Dynamics 365 Customer Engagement -udviklingsteamet (i det lokale miljø) forbeholder sig ret til at ændre, hvordan sider sammensættes, herunder ID værdierne for elementer, så brug af klient-API-objektmodellen beskytter din kode mod ændringer i den måde, sider implementeres på.

Definer entydige navne til dine JavaScript-funktioner

Når du er den eneste udvikler af en HTML-side, kan du nemt administrere navnene på de JavaScript-funktioner, du bruger. I Dynamics 365 Customer Engagement (i det lokale miljø) kan andre løsninger føje JavaScript-funktioner til den side, hvor din funktion bruges.

Hvis to JavaScript-funktioner på en side har samme navn, overskrives den første funktion, der er defineret af den anden. Derfor skal du sørge for at definere entydige navne for dine JavaScript-funktioner. Du kan få flere oplysninger under Klientscripting i Customer Engagement ved hjælp af JavaScript.

Brug asynkrone dataadgangsmetoder

Når du får adgang til data ved hjælp af webtjenesterne for Dynamics 365 Customer Engagement (i det lokale miljø), skal du altid bruge en XMLHttpRequest , der er konfigureret til at køre asynkront. Årsagen er, at browseren arbejder på en enkelt tråd. Hvis denne tråd bruges til at udføre en langvarig proces synkront, holder browseren op med at svare.