Webressourcer til Microsoft Dynamics 365
Udgivet: januar 2017
Gælder for: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
Webressourcer er virtuelle filer, der gemmes i Microsoft Dynamics 365-databasen, og som du kan hente ved hjælp af en entydig URL-adresse.
Dette emne indeholder
Funktioner i webressourcer
Webressourcetyper
Henvisning af webressourcer
Funktioner i webressourcer
Webressourcer repræsenterer filer, der kan bruges til at udvide Microsoft Dynamics 365 -webprogrammet som HTML-filer, JavaScript og Silverlight programmer. Du kan bruge webressourcer i form af tilpasninger, SiteMap eller programbåndet, fordi de kan bruges som reference ved hjælp af URL-syntaks.
URL-syntaksen til webressourcer giver mulighed for relative stireferencer. Med dine udviklingsværktøjer kan du oprette en gruppe af indbyrdes afhængige filer på en udviklingsserver ved hjælp af filtyper, der er kompatible med webressourcer. Derefter, hvis du bruger en ensartet navngivningskonvention og relative stireferencer, fungerer webstedet, når du har overført alle filer i Microsoft Dynamics 365.
Da webressourcer er gemt i Microsoft Dynamics 365 og er løsningskomponenter, kan de nemt eksporteres og installeres på lokale installationer af Microsoft Dynamics 365 eller Microsoft Dynamics 365 (online). Webressourcer er også tilgængelige for brugere af Microsoft Dynamics 365 til Microsoft Office Outlook med offlineadgang, når du arbejder offline, fordi de synkroniseres med brugerens data.
Du kan bruge formulareditoren til at tilføje og konfigurere formularaktiverede webressourcer til dine objektformularer.
Da webressourcer gemmes som poster i databasen, kan de administreres via programmering ved hjælp af standardteknikker til at oprette, hente og opdatere poster. Tekstbaserede webressourcer (JScript, CSS, XML, XSL, and HTML) kan redigeres og gemmes i programmet.
Begrænsninger i webressourcer
Der er ingen type af webressource, der understøtter funktionerne i en ASP.NET(.aspx) side til at udføre kode på serveren. Webressourcer er begrænset til statiske filer eller filer, der behandles i browseren. En webressource kan indeholde kode, der er behandlet i browseren til at udføre webserviceopkald til at kommunikere med Microsoft Dynamics 365 data. Du kan finde flere oplysninger under Arbejde med Dynamics 365-data ved hjælp af webressourcer,
Webressourcer er kun tilgængelige ved hjælp af Microsoft Dynamics 365 webprogrammets sikkerhedskontekst. Kun licenserede Microsoft Dynamics 365 brugere, der har de nødvendige rettigheder, kan få adgang til dem.
Størrelsesbegrænsninger
Maksimumstørrelsen på de filer, du kan overføre, bestemmes af egenskaben Organization.MaxUploadFileSize. Denne egenskab angives under fanen Mail under Systemindstillinger i Dynamics 365-programmet. Denne indstilling begrænser størrelsen på filer, der kan vedhæftes mailmeddelelser, noter og webressourcer. Standardindstillingen er 5 MB.
Webressourcetyper
Du kan bruge ti filformater til at oprette webressourcer. I følgende tabel vises hvert filformat, tilladte filtypenavne og den typeværdi, du bruger til hver.
Fil |
Filtypenavne |
Skriv |
|---|---|---|
Webside (HTML) |
.htm, .html |
1 |
Typografiark (CSS) |
.css |
2 |
Script (JScript) |
.js |
3 |
Data (XML) |
.xml |
4 |
Billede (PNG) |
.png |
5 |
Billede (JPG) |
.jpg |
6 |
Billede (GIF) |
.gif |
7 |
Silverlight (XAP) |
.xap |
8 |
Typografiark (XSL) |
.xsl, .xslt |
9 |
Billede (ICO) |
.ico |
10 |
Henvisning af webressourcer
Der findes flere metoder, du kan bruge til at henvise til webressourcer.
Bemærk
-
Når det er muligt, kan du bruge $webresource direktivet. Kun referencer, der bruger $webresource direktivet i oversigten over webstedet eller kommandoerne på båndet vil oprette afhængigheder. Afhængigheder oprettes ikke, når webressourcer henviser til hinanden.
-
Hvis du vil have vist en Silverlight-webressource uden for en objektformular eller et objektdiagram, skal du oprette en HTML-webressource, som skal være værtssiden for Silverlight-webressourcen. Brug derefter $webresource: -direktivet til at åbne HTML-webressourcen.
$webresource direktiv
Du bør altid bruge $webresource direktivet, når der refereres til en webressource fra et kontrolelement på båndet eller fra et SiteMap underområde. Brug af $webresource direktivet overalt tillader XML'en URL-værdi. I følgende eksempel vises, hvordan du kan bruge det.
$webresource:<name of Web Resource>
Bemærk
Når du bruger $webresource direktivet, opretter eller opdaterer Microsoft Dynamics 365 løsningsafhængigheder.
Xrm.Utility.openWebResource
Funktionen Xrm.Utility.openWebResource åbner en HTML webressource i et nyt vindue med parametre til at overføre navnet på webressourcen, alle former for forespørgselsstrengdata overføres i dataparameteren og oplysninger om højden og bredden på vinduet.
Den URL-genererede indeholder det entydige GUID token, så den cachelagrede webressource vil blive indlæst.
Relativ URL-adresse
Når der refereres til en webressource fra områder, der ikke understøtter brug af $webresource: direktivet, kan en relativ URL bruges. For at gøre det muligt anbefaler vi, at du bruger en ensartet navngivningskonvention for webressourcer, der afspejler en virtuel filstruktur. Løsningsudgiverens tilpasningspræfiks bliver altid medtaget foran navnet på webressourcen. Dette kan repræsentere en virtuel "rod" mappe til alle webressourcer, der er tilføjet af denne udgiver. Du kan derefter bruge en skråstreg (/) til at simulere en mappestruktur, der vil blive accepteret af webserveren.
Fra en anden webressource skal du altid bruge relative URLs til at henvise til hinanden. Eksempelvis til webressourcens webside new_/content/contentpage.htm for at referere til CSS webressource new_/Styles/styles.css, oprettes et link på følgende måde:
<link rel="stylesheet" type="text/css" href="../styles/styles.css" />
For websidens webressource new_/content/contentpage.htm for at åbne websidens webressource isv_/foldername/dialogpage.htm, oprettes linket på følgende måde:
<a href="../../isv_/foldername/dialogpage.htm">Dialog Page</a>
Bemærk
Brug ikke en relativ URL ved hjælp af WebResources mappen som rodsti til URL. Du skal f.eks. ikke bruge dette: /WebResources/<name of web resource>. Når en bruger tilhører mere end én organisation på en server, vil denne sti altid henvise til brugerens standardorganisation. Hvis brugeren ikke benytter deres standardorganisation og den forventede webressource ikke er inkluderet i brugerens standardorganisation, opstår fejlen "Filen blev ikke fundet", selvom webressourcen forekommer i den organisation, som brugeren aktuelt arbejder i.
Komplet URL
Følgende eksempel viser formatet for URL, du kan bruge til at få vist webressourcer.
<Microsoft CRM URL>/WebResources/<name of web resource>
Programmet behandler denne URL og vender tilbage til den fil, der indeholder den nyeste version af webressourcen. Denne URL ser sådan ud:
<Microsoft CRM URL>/%7B<GUID value>%7D/WebResources/<name of web resource>
GUID værdien opdateres, når du udgiver tilpasninger og sikrer, at browseren bruger den nyeste cachelagrede version af webressourcen. Derfor skal du bruge en relativ sti til en webressource, Xrm.Utility.openWebResource funktionen, eller $webresource direktiv (når det er muligt), da GUID værdien medtages automatisk. For store webressourcer som f.eks Silverlight webressourcer kan der være betydelige konsekvenser med ydeevnen, hvis du ikke bruger den cachelagrede version af filen.
Følgende eksempel viser en URL-adresse til Microsoft Dynamics 365 (online), hvor MyOrganization er navnet på din organisation, og new_/test/test.htm er navnet på webressourcen:
https://MyOrganization.crm.dynamics.com/WebResources/new_/test/test.htm
Bemærk
Herunder tegnet '/' og et filtypenavn i navnet på webressourcen er en valgfri bedste praksis.
Følgende eksempel viser en URL for en lokal Microsoft Dynamics 365, hvor myServer er navnet på serveren:
http://myServer/MyOrganization/WebResources/new_/test/test.htm
Når du skriver kode til at henvise til en webressource, der skal fungere for enten Microsoft Dynamics 365 (online) eller lokale Microsoft Dynamics 365, skal du bruge funktionen getClientUrl.
Se også
Udvide Microsoft Dynamics 365 på klienten
JavaScript-biblioteker til Microsoft Dynamics 365
Opret tilgængelige webressourcer
Webressourcer for webside (HTML)
Silverlight-webressourcer (XAP )
Webressourcer for script (JScript)
JPG-, PNG-, GIF- og ICO-webressourcer (billeder)
XSL-webressourcer (typografiark)
Datawebressourcer (XML)
CSS-webressourcer
Meddelelser og metoder for objektet WebResource
Eksempel: Send flere værdier til en webressource via dataparameteren
Eksempel: Webressourceværktøj
Eksempel: Importer filer som webressourcer
Arbejde med Dynamics 365-data ved hjælp af webressourcer
Microsoft Dynamics 365
© 2017 Microsoft. Alle rettigheder forbeholdes. Ophavsret