Delen via


Webresources voor Microsoft Dynamics 365

 

Gepubliceerd: januari 2017

Is van toepassing op: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Webresources zijn virtuele bestanden die worden opgeslagen in de Microsoft Dynamics 365 database en die u kunt ophalen via een uniek URL-adres.

In dit onderwerp

Mogelijkheden van webresources

Types webresource

Verwijzen naar webresources

Mogelijkheden van webresources

Webresources zijn bestanden die kunnen worden gebruikt om de Microsoft Dynamics 365 - webtoepassing, zoals HTML-bestanden, JavaScript en Silverlight toepassingen uit te breiden. U kunt webresources gebruiken in formulieraanpassingen, de SiteMap of het toepassingslint, aangezien hier naar kan worden verwezen door syntaxis URL te gebruiken.

De URL-syntaxis voor webresources staat relatieve padreferenties toe. Met uw ontwikkelingshulpprogramma's, kunt u een groep onderling afhankelijke bestanden op een ontwikkelingsserver maken door bestandstypes te gebruiken die compatibel zijn met webresources. Vervolgens, als u een consistente naamconventie en relatieve padreferenties gebruikt, zal de website functioneren nadat u alle bestanden hebt geüpload in Microsoft Dynamics 365.

Omdat webresources in Microsoft Dynamics 365 zijn opgeslagen en oplossingsonderdelen zijn, kunnen ze gemakkelijk naar on-premises Microsoft Dynamics 365 - installaties of naar Microsoft Dynamics 365 (online) worden geëxporteerd en geïnstalleerd. Webresources zijn tevens beschikbaar voor gebruikers van Microsoft Dynamics 365 voor Microsoft Office Outlook met offlinetoegang wanneer offline, omdat deze met de gegevens van de gebruiker zijn gesynchroniseerd.

U kunt de formuliereneditor gebruiken om de webresources met formulier toe te voegen en te configureren in uw entiteitsformulieren.

Omdat webresources als records in de database worden opgeslagen, kunnen ze ook worden beheerd door de standaardtechnieken te gebruiken om records te maken, op te halen, en bij te werken. Op tekst gebaseerde webresources (JScript, CSS, XML, XSL, and HTML) kan in de toepassing worden bewerkt en opgeslagen.

Beperkingen van webresources

Er is geen type webresource met de mogelijkheden van een ASP.NET(.aspx)-pagina om code op de server uit te voeren. Webresources zijn beperkt tot bestanden of statische bestanden die in de browser worden verwerkt. Een webresource kan code bevatten die in de browser verwerkt wordt om webservices uit te voeren om met Microsoft Dynamics 365 gegevens samen te werken. Voor meer informatie, zie Werken met Dynamics 365-gegevens met behulp van webresources,

Webresources zijn alleen beschikbaar door de de Microsoft Dynamics 365 webtoepassingbeveiligingscontext te gebruiken. Alleen de gelicentieerde gebruikers van Microsoft Dynamics 365 die over de benodigde bevoegdheden beschikken hebben hiertoe toegang.

Afmetingsbeperkingen

De maximale bestandsgrootte voor uploaden wordt bepaald door de eigenschap Organization.MaxUploadFileSize. Deze eigenschap wordt ingesteld op het tabblad E-mail van de Systeeminstellingen in de Dynamics 365-toepassing. Met deze instelling kunt u de bestandsgrootte beperken van bestanden die aan e-mailberichten, notities en webresources kunnen worden toegevoegd. De standaardinstelling is 5 MB.

Types webresource

U kunt tien bestandsindelingen gebruiken om webresources te maken. De onderstaande tabel toont de bestandsindeling, toegestane bestandextensies, en de typewaarde die u gebruikt voor elk.

Bestand

Bestandsextensies

Type

Webpagina (HTML)

.htm, .html

1

Opmaakmodel (CSS)

.css

2

Script (JScript)

.js

3

Gegevens (XML)

.xml

4

Afbeelding (PNG)

.png

5

Afbeelding (JPG)

.jpg

6

Afbeelding (GIF)

.gif

7

Silverlight (XAP)

.xap

8

Opmaakmodel (XSL)

.xsl, .xslt

9

Afbeelding (ICO)

.ico

10

Verwijzen naar webresources

Er zijn diverse methoden die u kunt gebruiken om te verwijzen naar webresources.

Notitie

  • Indien mogelijk, gebruikt u de richtlijn $webresource. Alleen de referenties die de richtlijn $webresource in het siteoverzicht of de lintopdrachten gebruiken, zullen afhankelijkheden instellen. Afhankelijkheden worden niet gemaakt als webresources naar elkaar verwijzen.

  • Als u een Silverlight-webresource buiten een entiteitsformulier of grafiek wilt weergeven, kunt u een HTML-webresource maken die kan dienen als hostpagina voor de Silverlight-webresource. Gebruik vervolgens de instructie $webresource: om de HTML-webresource te openen.

$webresource richtlijn

Zorg ervoor dat u de richtlijn $webresource altijd gebruikt bij het raadplegen van een webresource voor een lintbesturingselement of in een subgebied van SiteMap. Gebruik de richtlijn $webresource overal waar de XML een URL-waarde toestaat. In het volgende voorbeeld ziet u hoe u dit gebruikt.

$webresource:<name of Web Resource>

Notitie

Als u de richtlijn $webresource gebruikt, zal Microsoft Dynamics 365 oplossingsafhankelijkheden maken of bijwerken.

Xrm.Utility.openWebResource

De Xrm.Utility.openWebResource functie opent een HTML webresource in een nieuw venster met parameters om de naam van de webresource, alle gegevens van een querytekenreeks die in de gegevensparameter moet worden doorgegeven, plus informatie over de hoogte en breedte van het venster in te voeren.

Het URL gegenereerde bevat het unieke token GUID zodat de webresources die in het cachegeheugen zijn opgeslagen worden geladen.

Relatieve URL

Bij het raadplegen van een webresource van gebieden die met behulp van de richtlijnen $webresource: niet ondersteunen, kan een relatief URL worden gebruikt. Als u dit wilt inschakelen, raden we aan dat u een consistente naamconventie voor de webresources gebruikt die een bestandstructuur virtueel weergeven. Het voervoegsel van de oplossingsuitgeveraanpassing wordt altijd vóór aan de naam van de webresource toegevoegd. Dit kan een virtuele "hoofd"map voorstellen voor alle webresources die door deze uitgever zijn toegevoegd. U kunt dan het slashteken (/) gebruiken om een mapstructuur te simuleren dat door de webserver wordt gebruikt.

Van een andere webresource, moet u altijd relatieve URLs gebruiken om naar elkaar te verwijzen. Bijvoorbeeld, om de webresource van de webpagina new_/content/contentpage.htm te laten refereren naar de CSS webresource new_/Styles/styles.css, maakt u als volgt de koppeling:

<link rel="stylesheet" type="text/css" href="../styles/styles.css" />

Om de webresource van de webpagina new_/content/contentpage.htm de webresource van de webpagina isv_/foldername/dialogpage.htm te laten openen, maakt u als volgt de koppeling:

<a href="../../isv_/foldername/dialogpage.htm">Dialog Page</a>

Notitie

Gebruik geen relatieve URL met de map URL als het hoofdmappad voor WebResources. Gebruik dit bijvoorbeeld niet: /WebResources/<name of web resource>. Als een gebruiker bij meerdere organisaties op een server hoort, zal dit pad altijd verwijzen naar standaardorganisatie van de gebruiker. Als de gebruiker de standaardorganisatie niet gebruikt en de verwachte webresource niet is opgenomen in de standaardorganisatie van de gebruiker, treedt een "bestand niet gevonden" fout op, hoewel de webresource wel voorkomt in de organisatie waar de gebruiker momenteel in werkt.

Volledige URL

Het volgende voorbeeld laat de opmaak van URL zien die u kunt gebruiken om webresources te bekijken.

<Microsoft CRM URL>/WebResources/<name of web resource>

De toepassing zal dit URL verwerken en het bestand opleveren dat de nieuwste versie van de webresource bevat. Dit URL zit er als volgt uit:

<Microsoft CRM URL>/%7B<GUID value>%7D/WebResources/<name of web resource>

De GUID waarde wordt bijgewerkt wanneer u aanpassingen publiceert en ervoor zorgt dat de browser de laatste cache-versie van de webresource gebruikt. Gebruik hierom een relatief pad naar een webresource, de functie Xrm.Utility.openWebResource, of de $webresource richtlijn (indien mogelijk) omdat de GUID waarde automatisch wordt opgenomen. Voor grote webresources als de webresources Silverlight, zijn er aanzienlijke prestatieimplicaties als u niet de cache-versie van het bestand gebruikt.

Dit voorbeeld laat een URL zien voor Microsoft Dynamics 365 (online), waarbij MyOrganization de naam van uw organisatie is, en new_/test/test.htm de naam van de webresource:

https://MyOrganization.crm.dynamics.com/WebResources/new_/test/test.htm

Notitie

Het teken "/" gebruiken en een bestandsextensie in de naam van de webresource is een optionele aanbevolen procedure.

Dit voorbeeld laat een URL voor on-premises Microsoft Dynamics 365 zien, waarbij myServer de naam van de server is:

http://myServer/MyOrganization/WebResources/new_/test/test.htm

Als u code schrijft om te verwijzen naar een webresource die voor Microsoft Dynamics 365 (online) of Microsoft Dynamics 365 on-premises moet werken, moet u de getClientUrl functie gebruiken.

Zie ook

Microsoft Dynamics 365 uitbreiden op de client
JavaScript-bibliotheken voor Microsoft Dynamics 365
Toegankelijke webresources maken
Webpagina (HTML) webresources
Silverlight-webresources (XAP)
Scriptwebresources (JScript)
Afbeelding-webresources (JPG, PNG, GIF, ICO)
Opmaakmodelwebresources (XSL)
Gegevens (XML) Webresources
CSS-webresources
Berichten en methoden van de entiteit WebResource
Voorbeeld: Meerdere waarden aan een webresource doorgeven met de gegevensparameter
Voorbeeld: Hulpprogramma Webresource
Voorbeeld: Importbestanden gebruiken als webresources
Werken met Dynamics 365-gegevens met behulp van webresources

Microsoft Dynamics 365

© 2017 Microsoft. Alle rechten voorbehouden. Auteursrecht