Delen via

Webpagina (HTML) webresources

  • Artikel

 

Gepubliceerd: november 2016

Is van toepassing op: Dynamics CRM 2015

Gebruik webpagina (HTML) webresources om gebruikersinterface-elementen te maken voor clientuitbreidingen.

In dit onderwerp

Mogelijkheden van HTML-webresources

Beperkingen van HTML-webresources

Gebruik de tekstbewerker voor HTML-webresources

Voorkom dat webresources worden bewerkt voor beheerde oplossingen.

Raadpleeg andere webresources van een HTML webresources

Geef parameters door aan HTML webresources

Mogelijkheden van HTML-webresources

Aangezien een HTML webresource gewoon naar de browser van de gebruiker wordt gestreamed, kan deze alle inhoud bevatten die wordt weergegeven op de browser van de gebruiker.

Beperkingen van HTML-webresources

  • Een HTML-webresource kan geen code bevatten die op de server die moet worden uitgevoerd.ASP.NET-pagina's kunnen niet worden geüpload als HTML-webresources.

  • HTML-webresources kunnen slechts een beperkt aantal queryreeksparameters accepteren.Meer informatie:Geef parameters door aan HTML webresources

Gebruik de tekstbewerker voor HTML-webresources

De tekstbewerker in het webresourceformulier is bedoeld voor gebruik met zeer eenvoudige bewerking van HTML. Voor meer verfijnde HTML documenten, moet u de code bewerken in een externe tekstbewerker en de knop Bladeren gebruiken om de inhoud van uw bestand te uploaden.

Een complexere HTML pagina die script vereist om de inhoud van de pagina weer te geven, kan er bijvoorbeeld als het volgende voorbeeld uitzien.

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
 <title></title>
 <script src="Script/Script.js" type="text/javascript"></script>
 <link href="CSS/Styles.css" rel="stylesheet" type="text/css" />
</head>
<body onload="SDK.ImportWebResources.showData()">
 <div id="results" />
</body>
</html>

Nadat het document in de tekstbewerker werd geopend en opgeslagen, wordt de HTML aangepast naar dit.

<HTML><HEAD><TITLE></TITLE>
<META charset=utf-8></HEAD>
<BODY contentEditable=true onload=SDK.ImportWebResources.showData()>
<SCRIPT type=text/javascript src="Script/Script.js"></SCRIPT>
 <LINK rel=stylesheet type=text/css href="CSS/Styles.css">
<DIV id=results></DIV></BODY></HTML>

Voorkom dat webresources worden bewerkt voor beheerde oplossingen.

Vanwege de mogelijkheid om HTML webresources te wijzigen met behulp van de tekstbewerker, is het aan te bevelen dat u beheerde eigenschappen gebruikt om complexe HTML webresources in te stellen als niet aanpasbaar voor beheerde oplossingen. Bij het bekijken van webresources in het oplossingenvenster, opent u het dialoogvenster Beheerde eigenschappen om de eigenschap voor Aanpasbaar in te stellen op false.

Raadpleeg andere webresources van een HTML webresources

U kunt een verzameling van verwante bestanden maken buiten Microsoft Dynamics 365 om, die alle webresourcebestandstypes gebruiken. Als u voorzichtig bent en altijd relatieve paden gebruikt en elke webresource importeert met een consistente benaming die de mapstructuur van uw website weerspiegelt, merkt u dat de HTML webresource koppelingen bijhoudt naar bijbehorende CSS, XML, JScript, afbeeldings- en Silverlight bestanden die als webresources zijn geïmporteerd.

Als u bijvoorbeeld een webtoepassingsproject maakt met de volgende structuur [map]/bestand structuur:

  • page.htm

  • [Styles]

    • style.css

  • [Scripts]

    • script.js

Als u deze bestanden als webresources importeert, kunt u de prefix waar uw aanpassingsprefix van de oplossingsuitgever op de volgende manier benoemen:

  • new_/page.htm

  • new_/Styles/style.css

  • new_/Scripts/script.js

Als u dit patroon volgt, kan uw new_/page.htmHTML-webresource op de meest voorkomende manier naar andere bestanden verwijzen met behulp van relatieve paden zoals getoond in het volgende voorbeeld.

<script src="Scripts/script.js" type="text/javascript"></script>
<link href="Styles/style.css" rel="stylesheet" type="text/css" />

Het prefix van de aanpassing van de oplossingsuitgever wordt een virtuele rootmap voor alle webresources van uw oplossing. Als u uw aanpassingsvoorvoegsel wijzigt, worden de relatieve paden binnen uw HTML webresources niet gewijzigd.

Notitie

  • Een HTML-webresource die aan een formulier wordt toegevoegd, kan geen globale objecten gebruiken die zijn gedefinieerd door de JavaScript-bibliotheek die in het formulier is geladen. Een HTML-webresource kan met de Xrm.Page- of Xrm.Utility-objecten binnen het formulier communiceren met behulp van parent.Xrm.Page of parent.Xrm.Utility, maar globale objecten die zijn gedefinieerd door formulierscripts, zijn niet toegankelijk met behulp van het bovenliggende item. U moet eventuele bibliotheken die een HTML-webresource nodig heeft, laden in de HTML-webresource, zodat ze niet afhankelijk zijn van scripts die in het formulier worden geladen.

  • Verwijzingen die zijn opgenomen in code tussen de webresources worden niet bijgehouden als oplossingsafhankelijkheden.

Omdat webresources ook worden gedownload voor gebruikers van Microsoft Dynamics CRM voor Microsoft Office Outlook met offlinetoegang, hebben gebruikers toegang tot webresourceinhoud terwijl ze offline werken.

Geef parameters door aan HTML webresources

Een HTML webresource kan alleen de parameters in de volgende tabel accepteren.

Parameter

Naam

Beschrijving

typename

Naam van de entiteit

De naam van de entiteit.

type

Entiteittypecode

Een geheel getal dat uniek de entiteit in een specifieke organisatie identificeert.

id

Object-GUID

De GUID die een record vertegenwoordigt.

orgname

Organisatienaam

De unieke naam van de organisatie.

userlcid

Gebruikerstaalcode

De taalcode-id die de huidige gebruiker gebruikt.

orglcid

Taalcode van organisatie

De taalcode-id die de standaardtaal voor de organisatie weergeeft.

data

Optionele gegevensparameter

Een optionele waarde die kan worden doorgegeven.

formid

Formulier-id

De GUID die een formulier-id vertegenwoordigt.

entrypoint

Entry Point

Een tekenreekswaarde. Deze parameter is bedoeld om als een optionele waarde te worden doorgegeven aan webresources die worden geopend als aangepaste Help-inhoud voor een entiteit. Indien ingeschakeld bevat de aangepaste Help-URL de waarde “form” of “hierarchychart”.Meer informatie:Aangepaste Help-inhoud toevoegen

pagemode

Uitsluitend voor intern gebruik.

beveiliging

Uitsluitend voor intern gebruik.

tabSet

Uitsluitend voor intern gebruik.

Als u meer dan één waarde in de gegevensparameter doorgeeft, moet u parameters coderen in de waarde van de gegevensparameter en vervolgens logica toepassen om de meerdere parameters te decoderen met behulp van script in uw HTML webresource. In het onderwerp Voorbeeld: Meerdere waarden aan een webresource doorgeven met de gegevensparameter wordt een methode getoond om het doorgeven van meerdere parameterwaarden uit te voeren.

Zie ook

Webresources voor Microsoft Dynamics CRM 2015
Toegankelijke webresources maken
CSS-webresources
Scriptwebresources (JScript)
Gegevens (XML) Webresources
Afbeelding-webresources (JPG, PNG, GIF, ICO)
Silverlight-webresources (XAP)
Opmaakmodelwebresources (XSL)

© 2017 Microsoft. Alle rechten voorbehouden. Auteursrecht