Webové zdroje pre Customer Engagement

Webové prostriedky sú virtuálne súbory , ktoré sú uložené v databáze Dynamics 365 Customer Engagement (on-premises) a ktoré môžete načítať pomocou jedinečnej adresy URL.

Možnosti webových zdrojov

Webové prostriedky predstavujú súbory, ktoré možno použiť na rozšírenie webovej aplikácie Dynamics 365 Customer Engagement (on-premises), ako sú súbory HTML, JavaScript a CSS a niekoľko formátov obrázkov. Webové prostriedky môžete použiť v prispôsobeniach formulárov, na páse SiteMaps nástrojmi alebo na páse s nástrojmi aplikácie, pretože na ne možno odkazovať pomocou syntaxe URL adresy.

Syntax URL pre webové prostriedky umožňuje relatívne odkazy na cesty. Pomocou vývojových nástrojov môžete vytvoriť skupinu vzájomne závislých súborov na vývojovom serveri pomocou typov súborov kompatibilných s webovými prostriedkami. Potom, ak použijete konzistentnú konvenciu pomenovania a odkazy na relatívne cesty, webová lokalita bude fungovať po nahratí všetkých súborov do Dynamics 365 Customer Engagement (on-premises).

Keďže webové prostriedky sú uložené v systéme Dynamics 365 Customer Engagement (on-premises) a sú komponentmi riešenia, možno ich jednoducho exportovať a nainštalovať do lokálnych nasadení Dynamics 365 Customer Engagement (on-premises) alebo do Dynamics 365 for Customer Engagement. Webové zdroje sú k dispozícii aj pre používateľov Dynamics 365 for Microsoft Office Outlook s offline prístupom v režime offline, pretože sú synchronizované s údajmi používateľa.

Editor formulárov môžete použiť na pridanie a konfiguráciu webových prostriedkov s podporou formulárov do formulárov entít.

Keďže webové prostriedky sú uložené ako záznamy v databáze, možno ich spravovať programovo pomocou štandardných techník na vytváranie, načítavanie a aktualizáciu záznamov. Textové webové zdroje (JScript, CSS, XML, XSL, RESX a HTML) je možné upravovať a ukladať v aplikácii.

Obmedzenia webových zdrojov

Neexistuje žiadny typ webového prostriedku, ktorý by podporoval možnosti stránky ASP.NET(.aspx) na spustenie kódu na serveri. Webové prostriedky sú obmedzené na statické súbory alebo súbory, ktoré sa spracúvajú v prehliadači. Webový zdroj môže obsahovať kód, ktorý sa spracováva v prehliadači na vykonávanie volaní webových služieb na interakciu s údajmi Dynamics 365 Customer Engagement (on-premises). Ďalšie informácie nájdete v časti Práca s údajmi Customer Engagement pomocou webových zdrojov.

Webové prostriedky sú k dispozícii iba pomocou kontextu zabezpečenia webovej aplikácie Dynamics 365 Customer Engagement (on-premises). Prístup k nim majú iba licencovaní používatelia Dynamics 365 Customer Engagement (on-premises), ktorí majú potrebné oprávnenia.

Obmedzenia veľkosti

Maximálna veľkosť súborov, ktoré je možné nahrať, je určená vlastnosťou Organization.MaxUploadFileSize . Táto vlastnosť je nastavená na karte E-mail v systémových nastaveniach v aplikácii Dynamics 365. Toto nastavenie obmedzuje veľkosť súborov, ktoré je možné priložiť k e-mailovým správam, poznámkam a webovým prostriedkom. Predvolené nastavenie je 5 MB.

Typy webových prostriedkov

Na vytvorenie webových zdrojov môžete použiť desať formátov súborov. V nasledujúcej tabuľke sú uvedené jednotlivé formáty súborov, povolené prípony súborov a hodnota typu, ktorú používate pre každý z nich.

Súbor Prípony súborov Typ
Webová stránka (HTML) .htm, .html 1
Šablóna štýlov (CSS) .Css 2
Skript (JScript) .js 3
Údaje (XML) .xml 4
Obrázok (PNG) .png 5
Obrázok (JPG) .jpg 6
Obrázok (GIF) .gif 7
Strieborný svit (XAP) .xap 8
Šablóna štýlov (XSL) .xsl, .xslt 9
Obrázok (ICO) .ico 10
Vektorový formát (SVG) .svg 11
Struna (RESX) .resx 12

Referenčné webové zdroje

Existuje niekoľko metód, ktoré môžete použiť na odkazovanie na webové zdroje.

Poznámka

  • Ak je to možné, použite smernicu $webresource . Závislosti vytvoria iba odkazy, ktoré používajú smernicu $webresource v príkazoch mapy lokality alebo na páse s nástrojmi. Závislosti sa nevytvárajú, keď webové prostriedky na seba odkazujú.
    • Ak chcete zobraziť webový prostriedok Silverlight mimo formulára entity alebo grafu, vytvorte webový prostriedok HTML, ktorý bude hostiteľskou stránkou webového prostriedku Silverlight. Potom pomocou smernice $webresource: otvorte webový zdroj HTML.

$webresource smernica

Smernicu $webresource by ste mali vždy použiť pri odkazovaní na webový prostriedok z ovládacieho prvku pása s nástrojmi alebo z SiteMap podoblasti. Smernicu použite $webresource všade tam, kde XML povoľuje hodnotu URL. Nasledujúca ukážka ukazuje, ako ho používať.

$webresource:<name of Web Resource>  

Poznámka

Pri použití $webresource smernice Dynamics 365 Customer Engagement (on-premises) vytvorí alebo aktualizuje závislosti riešení.

Xrm.Navigation.openWebResource

Navigácia Xrm. Funkcia openWebResource otvorí webový prostriedok HTML v novom okne s parametrami na odovzdanie názvu webového prostriedku, všetkých údajov reťazca dotazu, ktoré sa majú odovzdať v parametri dát, a informácií o výške a šírke okna.

Vygenerovaná URL adresa obsahuje jedinečný token GUID, aby sa načítal webový prostriedok uložený vo vyrovnávacej pamäti.

Relatívna adresa URL

Pri odkazovaní na webový prostriedok z oblastí, ktoré nepodporujú používanie smernice $webresource: , je možné použiť relatívnu adresu URL. Ak to chcete povoliť, odporúčame používať konzistentnú konvenciu pomenovania webových prostriedkov, ktoré odrážajú štruktúru virtuálnych súborov. Predpona prispôsobenia vydavateľa riešenia bude vždy zahrnutá ako predpona názvu webového zdroja. Môže to predstavovať virtuálny "koreňový" priečinok pre všetky webové prostriedky pridané týmto vydavateľom. Potom môžete použiť lomku (/) na simuláciu štruktúry priečinkov, ktorú bude rešpektovať webový server.

Z iného webového zdroja by ste mali vždy používať relatívne URL adresy, aby ste na seba navzájom odkazovali. Napríklad, ak má webový zdroj new_/content/contentpage.htm webovej stránky odkazovať na webový prostriedok new_/Styles/styles.cssCSS , vytvorte prepojenie nasledovne:

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

Ak chcete, aby webový prostriedok new_/content/contentpage.htm webovej stránky otvoril webový prostriedok isv_/foldername/dialogpage.htm, vytvorte prepojenie nasledovne:

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

Poznámka

Nepoužívajte relatívnu URL adresu pomocou priečinka WebResources ako koreňovej cesty pre URL adresu. Nepoužívajte napríklad toto: /WebResources/<name of web resource>. Ak používateľ patrí do viac ako jednej organizácie na serveri, táto cesta bude vždy odkazovať na predvolenú organizáciu používateľa. Ak používateľ nepoužíva svoju predvolenú organizáciu a očakávaný webový zdroj nie je zahrnutý v predvolenej organizácii používateľa, vyskytne sa chyba "Súbor sa nenašiel", aj keď sa webový prostriedok vyskytuje v organizácii, v ktorej používateľ práve pracuje.

Úplná adresa URL

Nasledujúca ukážka zobrazuje štýl URL adresy, ktorý môžete použiť na zobrazenie webových zdrojov.

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

Aplikácia spracuje túto URL adresu a vráti súbor, ktorý obsahuje najnovšiu verziu webového prostriedku. Táto adresa URL bude vyzerať takto:

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

Hodnota verzie sa aktualizuje pri publikovaní prispôsobení a zabezpečí, aby prehliadač používal najnovšiu verziu webového prostriedku uloženú vo vyrovnávacej pamäti. Z tohto dôvodu použite relatívnu cestu k webovému prostriedku Xrm.Navigation. openWebResource alebo $webresource smernicu (ak je to možné), pretože hodnota verzie bude zahrnutá automaticky. V prípade veľkých webových zdrojov to môže mať významný vplyv na výkon, ak nepoužívate verziu súboru uloženú vo vyrovnávacej pamäti.

Nasledujúca ukážka zobrazuje URL adresu pre Dynamics 365 for Customer Engagement, kde MyOrganization je názov vašej organizácie a je to názov webového zdroja new_/test/test.htm :

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

Poznámka

Zahrnutie znaku "/" a prípony názvu súboru do názvu webového prostriedku je voliteľným osvedčeným postupom.

Nasledujúca ukážka zobrazuje URL adresu lokálneho systému Dynamics 365 Customer Engagement (on-premises), kde myServer je názov servera:

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

Keď píšete kód, ktorý odkazuje na webový zdroj, ktorý bude musieť fungovať pre Dynamics 365 for Customer Engagement alebo lokálny Dynamics 365 Customer Engagement (on-premises), mali by ste použiť funkciu getClientUrl .

Nástroje komunity

Tu sú niektoré z nástrojov komunity, ktoré pracujú s webovými zdrojmi.

Názov nástroja Ďalšie informácie
WebResourceManager https://github.com/gotdibbs/WebResourceManager
XrmToolkit https://xrmtoolkit.com/Home/Features
Správca webových zdrojov https://www.xrmtoolbox.com/plugins/MsCrmTools.WebResourcesManager/

Poznámka

Nástroje komunity nie sú produktom systému Microsoft Dynamics a spoločnosť Microsoft nerozširuje podporu pre nástroje komunity. Ak máte otázky týkajúce sa nástroja, obráťte sa na vydavateľa nástroja.

Pozrite si tiež

Písanie rozšírení klientskych aplikácií pre Dynamics 365 Customer Engagement
Vytváranie prístupných webových zdrojov
Webová stránka (HTML) Webové zdroje
Webové zdroje programu Silverlight (XAP)
Skript (JScript) Webové zdroje
Obrázkové webové zdroje
Webové zdroje pre šablóny štýlov (XSL)
Dátové (XML) webové zdroje
Webové zdroje šablóny štýlov (CSS)
Správy a metódy webových zdrojov
Ukáža: Odovzdanie viacerých hodnôt webovému prostriedku prostredníctvom parametra Data
Ukáža: Import súborov ako webových zdrojov
Používanie údajov webovej služby vo webových zdrojoch
Zjednodušenie vývoja webových zdrojov pomocou Fiddler AutoResponder