Customer Engagement-i veebiressursid

Veebiressursid on virtuaalsed failid , mis on salvestatud Dynamics 365 Customer Engagement (on-premises)-i andmebaasi ja mida saate tuua kordumatu URL-aadressi abil.

Veebiressursside võimalused

Veebiressursid tähistavad faile, mida saab kasutada Dynamics 365 Customer Engagement (on-premises) veebirakenduse laiendamiseks, näiteks html-failid, JavaScript ja CSS ning mitmed pildivormingud. Veebiressursse saate kasutada vormi kohandustes, SiteMapvõi rakenduse lindil, kuna neile saab viidata URL-i süntaksi abil.

Veebiressursside URL-i süntaks võimaldab suhtelisi teeviiteid. Arendustööriistade abil saate luua arendusserveris üksteisest sõltuvate failide rühma, kasutades veebiressurssidega ühilduvaid failitüüpe. Seejärel, kui kasutate järjepidevat nimetamiskonventsiooni ja suhtelisi teeviiteid, toimib veebisait pärast kõigi failide üleslaadimist Dynamics 365 Customer Engagement (on-premises)-i.

Kuna veebiressursid on salvestatud rakenduses Dynamics 365 Customer Engagement (on-premises) ja need on lahenduse komponendid, saab neid hõlpsasti eksportida ja installida Dynamics 365 Customer Engagement (on-premises)'i asutusesisestesse juurutustesse või Dynamics 365 for Customer Engagement-i. Veebiressursid on saadaval ka ühenduseta juurdepääsuga rakenduse Dynamics 365 for Microsoft Office Outlook kasutajatele, kuna need sünkroonitakse kasutaja andmetega.

Vormiredaktori abil saate oma olemivormidele lisada ja konfigureerida vormitoega veebiressursse.

Kuna veebiressursid talletatakse andmebaasis kirjetena, saab neid hallata programmiliselt, kasutades kirjete loomiseks, toomiseks ja värskendamiseks standardseid tehnikaid. Tekstipõhiseid veebiressursse (JScript, CSS, XML, XSL, RESX ja HTML) saab rakenduses redigeerida ja salvestada.

Veebiressursside piirangud

Pole ühtegi tüüpi veebiressurssi, mis toetaks ASP.NET (.aspx) lehe võimalusi serveris koodi käivitamiseks. Veebiressursid on piiratud staatiliste failidega või brauseris töödeldavate failidega. Veebiressurss võib sisaldada koodi, mida töödeldakse brauseris, et käivitada veebiteenuse kõnesid, et suhelda Dynamics 365 Customer Engagement (on-premises)-i andmetega. Lisateabe saamiseks vaadake teemat Customer Engagement-i andmetega töötamine veebiressursside abil.

Veebiressursid on saadaval ainult Dynamics 365 Customer Engagement (on-premises)-i veebirakenduse turbekonteksti abil. Neile pääsevad juurde ainult litsentsitud Dynamics 365 Customer Engagement (on-premises)-i kasutajad, kellel on vajalikud õigused.

Suuruse piirangud

Üleslaaditavate failide maksimaalse mahu määrab atribuut Organization.MaxUploadFileSize . See atribuut määratakse Dynamics 365 rakenduse süsteemisätete vahekaardil E-post. See säte piirab meilisõnumitele, märkmetele ja veebiressurssidele manustatavate failide mahtu. Vaikesäte on 5 MB.

Veebiressursside tüübid

Veebiressursside loomiseks saate kasutada kümmet failivormingut. Järgmises tabelis on loetletud kõik failivormingud, lubatud faililaiendid ja tüübiväärtus, mida te iga faili puhul kasutate.

Fail	Faililaiendid	Tüüp
Veebileht (HTML)	.htm, .html	1
Laadileht (CSS)	.Css	2
Skript (JScript)	.js	3
Andmed (XML)	.xml	4
Pilt (PNG)	.png	5
Pilt (JPG)	.jpg	6
Pilt (GIF)	.gif	7
Silverlight (XAP)	.xap	8
Laadileht (XSL)	.xsl, .xslt	9
Pilt (ICO)	.ico	10
Vektorvorming (SVG)	.svg	11
String (RESX)	.resx	12

Veebiressursside tegemine

Veebiressurssidele viitamiseks on mitu meetodit.

Märkus.

• Võimaluse korral kasutage direktiivi.$webresource Sõltuvusi loovad ainult viited, mis kasutavad saidikaardil või lindikäskudes direktiivi $webresource . Sõltuvusi ei looda, kui veebiressursid viitavad üksteisele.
  • Silverlighti veebiressursi kuvamiseks väljaspool olemivormi või diagrammi looge HTML-veebiressurss, mis on Silverlighti veebiressursi hostileht. Seejärel kasutage HTML-i veebiressursi avamiseks direktiivi $webresource:.

$webresource direktiiv

Peaksite alati kasutama $webresource direktiivi, kui viitate veebiressursile lindi juhtelemendist või SiteMap alamalast. Kasutage direktiivi $webresource kõikjal, kus XML lubab URL-i väärtust. Järgmine näide näitab, kuidas seda kasutada.

$webresource:<name of Web Resource>  

Märkus.

Direktiivi kasutamisel $webresource loob või värskendab Dynamics 365 Customer Engagement (on-premises) lahenduse sõltuvusi.

Xrm.Navigation.openWebResource

The Xrm.Navigation. funktsioon openWebResource avab uues aknas HTML-i veebiressursi, mis sisaldab parameetreid veebiressursi nime edastamiseks, andmeparameetris edastatavaid päringustringi andmeid ning teavet akna kõrguse ja laiuse kohta.

Loodud URL sisaldab kordumatut GUID-luba, nii et vahemällu salvestatud veebiressurss laaditakse.

Suhteline URL

Veebiressursile viitamisel piirkondadest, mis ei toeta direktiivi kasutamist $webresource: , saab kasutada suhtelist URL-i. Selle lubamiseks soovitame kasutada virtuaalset failistruktuuri kajastavate veebiressursside jaoks ühtset nimetamiskonventsiooni. Lahenduse väljastaja kohandamise eesliide lisatakse alati veebiressursi nime eesliitena. See võib kujutada endast virtuaalset juurkausta kõigi selle väljaandja lisatud veebiressursside jaoks. Seejärel saate kasutada kaldkriipsu (/), et simuleerida kaustastruktuuri, mida veebiserver austab.

Teisest veebiressursist peaksite üksteisele viitamiseks alati kasutama suhtelisi URL-e. Näiteks selleks, et veebilehe veebiressurss new_/content/contentpage.htm viitaks CSS-i veebiressursile new_/Styles/styles.css, looge link järgmiselt:

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

Veebilehe veebiressursi new_/content/contentpage.htm avamiseks veebilehe veebiressursi isv_/foldername/dialogpage.htmloomiseks looge link järgmiselt.

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

Märkus.

Ärge kasutage suhtelist URL-i, kasutades URL-i juurteena kausta WebResources. Näiteks ärge kasutage seda: /WebResources/<name of web resource>. Kui kasutaja kuulub serveris rohkem kui ühte organisatsiooni, viitab see tee alati kasutaja vaikeorganisatsioonile. Kui kasutaja ei kasuta oma vaikeorganisatsiooni ja eeldatav veebiressurss ei kuulu kasutaja vaikeorganisatsiooni, ilmneb tõrge "Faili ei leitud", isegi kui veebiressurss esineb organisatsioonis, kus kasutaja praegu töötab.

Täielik URL

Järgmises näidises on näidatud URL-i laad, mida saate kasutada veebiressursside vaatamiseks.

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

Rakendus töötleb seda URL-i ja tagastab faili, mis sisaldab veebiressursi uusimat versiooni. See URL näeb välja selline:

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

Versiooni väärtust värskendatakse kohanduste avaldamisel ja see tagab, et brauser kasutab veebiressursi uusimat vahemällu salvestatud versiooni. Seetõttu kasutage suhtelist teed veebiressursini Xrm.Navigation. funktsiooni openWebResource või $webresource direktiivi (kui võimalik), kuna versiooni väärtus kaasatakse automaatselt. Suurte veebiressursside puhul võib see oluliselt mõjutada jõudlust, kui te ei kasuta faili vahemällu salvestatud versiooni.

Järgmises näidises kuvatakse Dynamics 365 for Customer Engagement-i URL, kus MyOrganization on teie organisatsiooni nimi ja new_/test/test.htm veebiressursi nimi.

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

Märkus.

Märgi "/" ja failinimelaiendi lisamine veebiressursi nimesse on valikuline hea tava.

Järgmises näidises on toodud asutusesisese Dynamics 365 Customer Engagement (on-premises) URL, kus myServer on serveri nimi.

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

Kui kirjutate koodi, mis viitab veebiressursile, mis peab töötama kas Dynamics 365 for Customer Engagement-i või asutusesisese Dynamics 365 Customer Engagement (on-premises)-i jaoks, peaksite kasutama funktsiooni getClientUrl .

Kogukonna tööriistad

Siin on mõned kogukonna tööriistad, mis töötavad veebiressurssidega.

Tööriista nimi	Lisateave
Veebiressursi haldur	https://github.com/gotdibbs/WebResourceManager
XrmToolkit	https://xrmtoolkit.com/Home/Features
Veebiressursside haldur	https://www.xrmtoolbox.com/plugins/MsCrmTools.WebResourcesManager/

Märkus.

Kogukonna tööriistad ei ole Microsoft Dynamicsi toode ja Microsoft ei laienda kogukonna tööriistade tuge. Kui teil on tööriistaga seotud küsimusi, võtke ühendust tööriista väljaandjaga.

Vt ka

Dynamics 365 Customer Engagement-i kliendirakenduse laiendite kirjutamine
Juurdepääsetavate veebiressursside loomine
Veebileht (HTML) Veebiressursid
Silverlighti (XAP) veebiressursid
Skripti (JScript) veebiressursid
Pildi veebiressursid
Laaditabeli (XSL) veebiressursid
Andmete (XML) veebiressursid
Laadilehe (CSS) veebiressursid
Veebiressursside teated ja meetodid
Näide: mitme väärtuse edastamine veebiressursile parameetri Data kaudu
Näide: failide importimine veebiressurssidena
Veebiteenuse andmete kasutamine veebiressurssides
Veebiressursside arendamise sujuvamaks muutmine Fiddler AutoResponderi abil