Webové prostředky pro Customer Engagement

Webové prostředky jsou virtuální soubory uložené v databázi Dynamics 365 Customer Engagement (místní) a které můžete načíst pomocí jedinečné adresy URL.

Možnosti webových prostředků

Webové prostředky představují soubory, které je možné použít k rozšíření webové aplikace Dynamics 365 Customer Engagement (místní), jako jsou soubory HTML, JavaScript a CSS a několik formátů obrázků. Webové prostředky můžete použít v přizpůsobení formuláře, pásu SiteMapkaret aplikace nebo aplikace, protože na tyto prostředky lze odkazovat pomocí syntaxe adresy URL.

Syntaxe adresy URL webových prostředků umožňuje odkazy na relativní cestu. Pomocí vývojových nástrojů můžete vytvořit skupinu vzájemně závislých souborů na vývojovém serveru pomocí typů souborů kompatibilních s webovými prostředky. Pokud pak použijete konzistentní konvenci pojmenování a relativní odkazy na cestu, web bude fungovat po nahrání všech souborů do Dynamics 365 Customer Engagementu (místně).

Vzhledem k tomu, že webové prostředky jsou uložené v Dynamics 365 Customer Engagementu (místně) a jsou to komponenty řešení, je možné je snadno exportovat a nainstalovat do místních nasazení Dynamics 365 Customer Engagementu (místně) nebo do Dynamics 365 for Customer Engagement. Webové prostředky jsou také k dispozici uživatelům Dynamics 365 for Microsoft Office Outlook s offline přístupem, protože jsou synchronizovány s daty uživatele.

Editor formulářů můžete použít k přidání a konfiguraci webových prostředků s podporou formulářů do formulářů entity.

Vzhledem k tomu, že webové prostředky jsou uložené jako záznamy v databázi, je možné je spravovat prostřednictvím kódu programu pomocí standardních technik pro vytváření, načítání a aktualizaci záznamů. Textové webové prostředky (JScript, CSS, XML, XSL, RESX a HTML) lze upravovat a ukládat v aplikaci.

Omezení webových prostředků

Neexistuje žádný typ webového prostředku, který podporuje možnosti stránky ASP.NET(.aspx) ke spuštění kódu na serveru. Webové prostředky jsou omezené na statické soubory nebo soubory, které se zpracovávají v prohlížeči. Webový prostředek může obsahovat kód zpracovaný v prohlížeči, který provádí volání webové služby pro interakci s daty Dynamics 365 Customer Engagement (místní). Další informace najdete v tématu Práce s daty Customer Engagementu pomocí webových prostředků.

Webové prostředky jsou k dispozici pouze pomocí kontextu zabezpečení webových aplikací Dynamics 365 Customer Engagement (místní). Přístup k nim mají jenom licencovaní uživatelé Dynamics 365 Customer Engagementu (místní) s potřebnými oprávněními.

Omezení velikosti

Maximální velikost souborů, které lze nahrát, je určena vlastností Organization.MaxUploadFileSize . Tato vlastnost je nastavena na kartě E-mailnastavení systému v aplikaci Dynamics 365. Toto nastavení omezuje velikost souborů, které lze připojit k e-mailovým zprávám, poznámkám a webovým prostředkům. Výchozí nastavení je 5 MB.

Typy webových prostředků

K vytvoření webových prostředků můžete použít deset formátů souborů. V následující tabulce jsou uvedeny všechny formáty souborů, povolené přípony souborů a hodnota typu, kterou pro každý z nich používáte.

File	Přípony souborů	Typ
Webová stránka (HTML)	.htm, .html	1
Šablona stylů (CSS)	.css	2
Skript (JScript)	.js	3
Data (XML)	.xml	4
Obrázek (PNG)	.png	5
Obrázek (JPG)	.jpg	6
Obrázek (GIF)	.gif	7
Silverlight (XAP)	.xap	8
Šablona stylů (XSL)	.xsl, .xslt	9
Obrázek (ICO)	.ico	10
Formát vektoru (SVG)	.svg	11
Řetězec (RESX)	.resx	12

Referenční webové prostředky

Existuje několik metod, které můžete použít k odkaz na webové prostředky.

Poznámka:

• Pokud je to možné, použijte direktivu $webresource . Závislosti budou navazovat pouze odkazy, které používají direktivu $webresource v mapě webu nebo příkazech pásu karet. Závislosti se nevytvořily, když se webové prostředky vzájemně odkazují.
  • Chcete-li zobrazit webový prostředek Silverlight mimo formulář entity nebo graf, vytvořte webový prostředek HTML, který bude hostitelskou stránkou webového prostředku Silverlight. Pak pomocí direktivy $webresource: otevřete webový prostředek HTML.

direktiva $webresource

Direktivu $webresource byste měli vždy použít při odkazování na webový prostředek z ovládacího prvku pásu karet nebo z SiteMap dílčí oblasti. Direktivu $webresource použijte všude, kde XML povoluje hodnotu adresy URL. Následující ukázka ukazuje, jak ji používat.

$webresource:<name of Web Resource>  

Poznámka:

Při použití direktivy $webresource Vytvoří nebo aktualizuje závislosti řešení Dynamics 365 Customer Engagement (místní prostředí).

Xrm.Navigation.openWebResource

The Xrm.Navigation. Funkce openWebResource otevře webový prostředek HTML v novém okně s parametry, které předají název webového prostředku, veškerá data řetězce dotazu, která se mají předat v parametru dat, a informace o výšce a šířce okna.

Vygenerovaná adresa URL obsahuje jedinečný token GUID, aby se načetl webový prostředek uložený v mezipaměti.

Relativní adresa URL

Při odkazování na webový prostředek z oblastí, které nepodporují použití $webresource: direktivy, lze použít relativní adresu URL. Pokud to chcete povolit, doporučujeme použít konzistentní zásady vytváření názvů pro webové prostředky, které odrážejí strukturu virtuálních souborů. Předpona vlastního nastavení vydavatele řešení bude vždy zahrnuta jako předpona názvu webového prostředku. To může představovat virtuální kořenovou složku pro všechny webové prostředky přidané tímto vydavatelem. Pak můžete pomocí znaku lomítka (/) simulovat strukturu složek, kterou bude webový server respektovat.

Z jiného webového prostředku byste měli vždy použít relativní adresy URL k vzájemnému odkazování. Například pro webový prostředek new_/content/contentpage.htm webové stránky odkazovat na webový prostředek new_/Styles/styles.cssCSS vytvořte odkaz následujícím způsobem:

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

Aby webový prostředek new_/content/contentpage.htm webové stránky otevřel webový prostředek isv_/foldername/dialogpage.htmwebové stránky, vytvořte odkaz následujícím způsobem:

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

Poznámka:

Nepoužívejte relativní adresu URL pomocí složky WebResources jako kořenovou cestu pro adresu URL. Nepoužívejte například: /WebResources/<name of web resource>. Pokud uživatel patří do více než jedné organizace na serveru, bude tato cesta vždy odkazovat na výchozí organizaci uživatelů. Pokud uživatel nepoužívá výchozí organizaci a očekávaný webový prostředek není součástí výchozí organizace uživatele, dojde k chybě Soubor nenalezena, i když k webovému prostředku dochází v organizaci, ve které uživatel právě pracuje.

Úplná adresa URL

Následující ukázka ukazuje styl adresy URL, kterou můžete použít k zobrazení webových prostředků.

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

Aplikace zpracuje tuto adresu URL a vrátí soubor, který obsahuje nejnovější verzi webového prostředku. Tato adresa URL bude vypadat takto:

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

Hodnota verze se aktualizuje při publikování vlastních nastavení a zajistí, že prohlížeč používá nejnovější verzi webového prostředku uložené v mezipaměti. Z tohoto důvodu použijte relativní cestu k webovému prostředku, Xrm.Navigation. openWebResource , nebo $webresource Direktiva (pokud je to možné), protože hodnota verze bude automaticky zahrnuta. U velkých webových prostředků může mít významný dopad na výkon, pokud nepoužíváte verzi souboru uloženou v mezipaměti.

Následující ukázka ukazuje adresu URL pro Dynamics 365 for Customer Engagement, kde MyOrganization je název vaší organizace a new_/test/test.htm je název webového prostředku:

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

Poznámka:

Zahrnutí znaku /a přípony názvu souboru do názvu webového prostředku je volitelným osvědčeným postupem.

Následující ukázka ukazuje adresu URL pro místní Dynamics 365 Customer Engagement (místní), kde myServer je název serveru:

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

Když napíšete kód odkaz na webový prostředek, který bude muset fungovat pro Dynamics 365 for Customer Engagement nebo místní Dynamics 365 Customer Engagement (místní), měli byste použít funkci getClientUrl .

Nástroje komunity

Tady jsou některé komunitní nástroje, které pracují s webovými prostředky.

Název nástroje	Více informací
WebResourceManager	https://github.com/gotdibbs/WebResourceManager
XrmToolkit	https://xrmtoolkit.com/Home/Features
Správce webových zdrojů	https://www.xrmtoolbox.com/plugins/MsCrmTools.WebResourcesManager/

Poznámka:

Komunitní nástroje nejsou produktem Microsoft Dynamics a Společnost Microsoft nepodporuje nástroje komunity. Pokud máte dotazy týkající se nástroje, obraťte se na vydavatele nástroje.

Viz také

Zápis rozšíření klientských aplikací pro Dynamics 365 Customer Engagement
Vytváření přístupných webových prostředků
Webové prostředky webové stránky (HTML)
Webové zdroje produktu Silverlight (XAP)
Webové prostředky skriptu (JScript)
Webové prostředky obrázku
Webové prostředky šablon stylů (XSL)
Webové prostředky dat (XML)
Webové prostředky šablon stylů CSS
Zprávy a metody webových prostředků
Ukázka: Předání více hodnot webovému prostředku prostřednictvím datového parametru
Ukázka: Import souborů jako webových prostředků
Použití dat webové služby ve webových prostředcích
Zjednodušení vývoje webových prostředků pomocí nástroje Fiddler AutoResponder