Webresources maken of bewerken om een app uit te breiden

Dit onderwerp is van toepassing op Dynamics 365 Customer Engagement (on-premises). Voor de Power Apps-versie van dit onderwerp, zie: Webresources voor modelgestuurde apps maken of bewerken om een app uit te breiden

Webresources worden doorgaans gebruikt door ontwikkelaars om een app uit te breiden met bestanden die in webontwikkeling worden gebruikt. Appgebruikers moeten mogelijk webresources beheren die door een ontwikkelaar of ontwerper worden geleverd.

Fooi

Voor een grondige bespreking van webresources raadpleegt u Webresources voor Customer Engagement.

Wat zijn webresources?

Webresources zijn virtuele bestanden die in het systeem worden opgeslagen. Elke webresource heeft een unieke naam die in een URL kan worden gebruikt om het bestand op te halen. Zie het zo: als u toegang had tot de werkelijke webserver die de webapp uitvoert, zou u bestanden naar deze website kunnen kopiëren. Maar met de meeste onlineservices is dit niet mogelijk. In plaats daarvan kunt u webresources gebruiken om bestanden te uploaden naar het systeem en er vervolgens bij naam naar verwijzen alsof u ze als bestanden naar de webserver hebt gekopieerd.

Als u bijvoorbeeld een html-pagina als webresource met de naam "new_myWebResource.htm" maakt, kunt u deze pagina in een browser openen met een URL die er zo uitziet:

<Dynamics 365 Customer Engagement (on-premises) URL>/WebResources/new_myWebResource.htm

waarbij <app URL> de URL is die u normaal gesproken gebruikt om de app te openen. Omdat de webresource bestaat uit gegevens in het systeem, kunnen alleen gebruikers met gebruiksrecht voor uw organisatie er op deze manier toegang toe krijgen. Normaal gesproken worden webresources opgenomen in formulieren in plaats van dat er direct naar wordt verwezen. Het meest voorkomende gebruik is JavaScript-bibliotheken te bieden voor formulierscripts.

Aangezien webresources gegevens in het systeem zijn en oplossingsbewust zijn, kunt u ze naar verschillende organisaties verplaatsen door ze te exporteren als onderdeel van een oplossing en ze in een andere organisatie in de oplossing importeren.

Webresources maken en bewerken

1. Open de oplossingenverkenner en selecteer vervolgens Webresources.

2. Kies onder Onderdelen de optie Webresources.

3. Selecteer Nieuw om een webresource te maken.

   Als u een webresource wilt bewerken, dubbelklikt u op de webresource die u wilt bewerken.

4. Het webresourceformulier heeft de volgende velden en mogelijkheden:

   Etiket	Beschrijving
   Naam	Vereist. Dit is de unieke naam voor deze webresource. U kunt deze niet wijzigen nadat u de webresource hebt opgeslagen. Deze naam kan alleen letters, cijfers, punten en niet-opeenvolgende voorwaartse slashes ("/") bevatten. Het prefix van de oplossingsuitgeveraanpassing wordt vóór aan de naam van de webresource toegevoegd.
   Weergavenaam	De naam die wordt weergegeven als u een lijst met webresources bekijkt.
   Beschrijving	Een beschrijving van de webresource.
   Type	Vereist. Dit is het type van de webresource. U kunt deze niet wijzigen nadat u de webresource hebt opgeslagen.
   Teksteditor	Als het type webresource een soort tekstbestand vertegenwoordigt, selecteert u deze knop om een pagina te openen en de inhoud te bewerken met de teksteditor.
   Taal	Hiermee kunt u een taal selecteren. Deze optie markeert slechts de record waarin de webresourcegegevens zijn opgeslagen. Het gedrag van de webresource verandert niet.
   Bestand uploaden	Selecteer de knop Bladeren... om een bestand te kiezen om als webresource te uploaden. U kunt een bestand uploaden wanneer u een nieuwe webresource maakt of om een bestaande webresource te overschrijven. De naamextensie van het bestand moet overeenkomen met toegestane bestandsextensies. De maximumbestandsgrootte voor uploaden van een bestand als webresource is standaard 5 MB. Deze waarde kan worden gewijzigd in Dynamics 365 Customer Engagement (on-premises) met de instelling Systeeminstellingen>E-mail>Maximale bestandsgrootte instellen voor bijlagen. Meer informatie: Dialoogvenster Systeeminstellingen - Tabblad E-mail
   URL	Zodra u de webresource hebt opgeslagen, wordt hier de URL naar de webresource weergegeven. Selecteer deze koppeling om de webresource in uw browser weer te geven.

5. Nadat u uw wijzigingen hebt toegevoegd, kiest u Opslaan en vervolgens Publiceren.

Notitie

Het publiceren van aanpassingen kan een probleem veroorzaken met de normale werking van het systeem. We raden aan aanpassingen te publiceren wanneer dit minimale gevolgen heeft voor gebruikers.

De teksteditor gebruiken

De teksteditor uit de toepassing voor webresources moet alleen worden gebruikt voor eenvoudige bewerkingen van tekstbestanden. U kunt deze gebruiken voor het maken en bewerken van HTML-webresources, maar u moet alleen HTML-webresources bewerken die met de teksteditor zijn gemaakt. De teksteditor is ontworpen voor zeer eenvoudige HTML-inhoud. Als de inhoud van een HTML-webresource niet met de teksteditor is gemaakt, gebruikt u niet de teksteditor om deze te bewerken.

De teksteditor gebruikt een besturingselement waarmee de HTML-bron zo wordt gewijzigd dat deze kan worden bewerkt. Deze wijzigingen kunnen de pagina anders laten werken in de browser en kunnen ertoe leiden dat geavanceerde code niet meer werkt. Het openen en opslaan van een HTML-resource zonder wijzigingen aan te brengen kan bepaalde HTML-webresources beschadigen.

We raden u aan een externe toepassing te gebruiken om tekstbestanden te bewerken en ze vervolgens lokaal op te slaan voordat u ze uploadt met de knop Bestand uploaden. Zo kunt u een kopie van de webresource behouden als u naar een eerdere versie moet terugkeren. U kunt een eenvoudige editor zoals Kladblok gebruiken, maar een teksteditor met meer geavanceerde mogelijkheden wordt sterk aanbevolen. Visual Studio Express is gratis en biedt krachtige mogelijkheden voor het bewerken van de bestanden die worden gebruikt door op tekst gebaseerde webresources.

Een webresource maken en bewerken in een formulier

U kunt webresources toevoegen aan of bewerken in een formulier om het aantrekkelijker en bruikbaarder te maken voor gebruikers. Zorg dat u de beveiligingsrol Systeembeheerder of soortgelijke bevoegdheden hebt.

Notitie

U kunt een webresource niet opnemen in een formulierkoptekst of -voettekst.

1. Open de oplossingenverkenner.

2. Vouw onder Onderdelen achtereenvolgens Entiteiten en de entiteit waarmee u wilt werken uit.

3. Kies Formulieren, zoek in de lijst een formulier van het type Hoofd en dubbelklik of tik vervolgens op het item om het formulier te openen en te bewerken.

4. Als u een webresource wilt toevoegen, selecteert u het tabblad (bijvoorbeeld Algemeen of Notities) waar u deze wilt invoegen en selecteert u op het tabblad Invoegen de optie Webresource.
   -OF-
   Als u een webresource wilt bewerken, selecteert u een formuliertabblad en de webresource die u wilt bewerken. Vervolgens selecteert u op het tabblad Start de optie Eigenschappen wijzigen.

5. Voer in het dialoogvenster Webresource toevoegen of Eigenschappen van webresource op het tabblad Algemeen de gewenste informatie in de vereiste velden in. Let hierbij met name op het volgende:

   • Selecteer in het vak Webresource de gewenste afbeeldings-, HTML- of Silverlight-webresource uit die u wilt gebruiken.

     Notitie

     Nadat u een webresource hebt opgegeven, verschijnt de sectie Eigenschappen van webresource onder aan dit tabblad met opties die variëren op basis van het type webresource dat u toevoegt. Deze opties omvatten het opgeven van aangepaste parameters, het doorgeven van een code van het recordobjecttype als parameter of het opgeven van vervangende tekst die de resource beschrijft of, voor afbeeldingen, die de afbeelding toegankelijker maakt voor alle gebruikers. Hier zijn een paar belangrijke eigenschappen. Voor een volledige lijst, zie: Webresource-eigenschappen. - Geef in het veld Naam een unieke naam voor het veld op. De naam mag alleen alfanumerieke tekens en onderstrepingstekens bevatten.

   • In het veld Label wordt automatisch een variant ingevuld van de naam die u opgeeft. U moet echter wel controleren of dat label aan uw behoeften voldoet en dit zo nodig bijwerken.

6. Op het tabblad Opmaak verschillen de opties die worden weergegeven op basis van het type webresource dat wordt ingevoegd. Deze opties omvatten onder andere het opgeven van het aantal kolommen en rijen dat wordt weergegeven, of er een rand wordt weergegeven en het schuifgedrag.

7. Als het tabblad Afhankelijkheden wordt weergegeven in het dialoogvenster Webresource toevoegen of Eigenschappen van webresource, selecteert u in de lijst Beschikbare velden de velden die vereist zijn door de webresource, selecteert u de knop Geselecteerde records toevoegen om de geselecteerde velden naar de lijst Afhankelijke velden te verplaatsen en selecteert u vervolgens OK om het dialoogvenster te sluiten.

8. Als u klaar bent met het bewerken van het formulier, selecteert u op het tabblad Start de optie Opslaan en sluiten om het formulier te sluiten. U kunt als volgt vooraf bekijken hoe het hoofdformulier wordt weergegeven en hoe gebeurtenissen werken:

   • Selecteer op het tabblad Start de optie Voorbeeld en selecteer vervolgens Formulier maken, Formulier bijwerken of Alleen-lezen formulier.
   • Als u het formulier Voorbeeld wilt sluiten, selecteert u Sluiten in het menu Bestand.

9. Als de aanpassingen zijn voltooid, publiceert u deze:

   • Als u alleen aanpassingen wilt publiceren voor het onderdeel dat u momenteel bewerkt, selecteert u in het navigatiedeelvenster de entiteit waaraan u hebt gewerkt en vervolgens Publiceren.
   • Als u aanpassingen wilt publiceren voor alle niet-gepubliceerde onderdelen tegelijk, selecteert u Entiteiten in het navigatiedeelvenster en Alle aanpassingen publiceren op de werkbalk Acties.

Een afbeeldingswebresource toevoegen of bewerken

Webresources zijn virtuele bestanden in verschillende indelingen, zoals HTML-bestanden, JavaScript- en Silverlight-toepassingen, die in het systeem worden opgeslagen en kunnen worden opgehaald middels een uniek URL-adres.

1. Open de oplossingenverkenner.

2. Als u een nieuwe webresource wilt maken, kiest u Onderdelen>Webresources en kiest u vervolgens Nieuw op de werkbalk Acties.

3. Typ of wijzig informatie in de tekstvakken.

   • De naam die wordt ingevoerd in het tekstvak Naam. Dit wordt samen met de bestandsextensie de bestandsnaam.

   • De naam die wordt ingevoerd in het tekstvak Weergavenaam wordt weergegeven bij Weergavenaam.

   • Selecteer in de vervolgkeuzelijst Type het gewenste bestandstype.

4. Kies Bladeren om het bestand van de lokale computer te selecteren en te uploaden.

   • Een voorbeeld van een geüploade afbeeldingswebresource bekijken: Kies Webresource>Voorbeeld.

   • Een tekstwebresource bewerken: Kies Teksteditor.

   • Een voorbeeld van een tekstwebresource bekijken: Kies Webresource>Voorbeeld.

5. Wanneer u gereed bent om uw gegevens op te slaan, kiest u Opslaan en sluiten.

6. Uw aanpassing publiceren.

   • Alleen voor het bewerkte onderdeel: Kies Opslaan>Publiceren op de pagina Start.

   • Voor alle niet-gepubliceerde aanpassingen tegelijk kiest u Alle aanpassingen publiceren.

Notitie

Het installeren van een oplossing of publiceren van aanpassingen kan de normale werking van het systeem onderbreken. We adviseren u om het importeren van een oplossing te plannen wanneer dit minimale gevolgen heeft voor gebruikers.

Zie ook

Eigenschappen van webresource
Formulieren maken en ontwerpen
Aan de slag gaan met aanpassing
Webresources voor Customer Engagement