Resurse web pentru Customer Engagement

Resursele web sunt fișiere virtuale care sunt stocate în baza de date Dynamics 365 Customer Engagement (on-premises) și pe care le puteți prelua utilizând o adresă URL unică.

Capacitățile resurselor web

Resursele web reprezintă fișiere care pot fi utilizate pentru a extinde aplicația web Dynamics 365 Customer Engagement (on-premises), cum ar fi fișiere html, JavaScript și CSS și mai multe formate de imagine. Puteți utiliza resurse web în particularizările formularului, în panglica SiteMapaplicației sau a aplicației, deoarece acestea pot fi menționate utilizând sintaxa URL.

Sintaxa URL pentru resursele web permite referințe la căi relative. Cu instrumentele de dezvoltare, puteți crea un grup de fișiere interdependente pe un server de dezvoltare utilizând tipuri de fișiere compatibile cu resursele web. Apoi, dacă utilizați o convenție de denumire consecventă și referințe de cale relative, site-ul web va funcționa după ce încărcați toate fișierele în Dynamics 365 Customer Engagement (on-premises).

Deoarece resursele web sunt stocate în Dynamics 365 Customer Engagement (on-premises) și sunt componente ale soluției, acestea pot fi exportate și instalate cu ușurință în implementări locale ale Dynamics 365 Customer Engagement (on-premises) sau în Dynamics 365 for Customer Engagement. Resursele web sunt, de asemenea, disponibile pentru utilizatorii Dynamics 365 for Microsoft Office Outlook cu acces offline atunci când sunt offline, deoarece sunt sincronizate cu datele utilizatorului.

Puteți utiliza editorul de formulare pentru a adăuga și configura resurse web activate pentru formulare în formularele de entitate.

Deoarece resursele web sunt stocate ca înregistrări în baza de date, acestea pot fi gestionate programatic utilizând tehnicile standard pentru a crea, prelua și actualiza înregistrări. Resursele web bazate pe text (JScript, CSS, XML, XSL, RESX și HTML) pot fi editate și salvate în aplicație.

Limitări ale resurselor web

Nu există niciun tip de resursă web care să accepte capacitățile unei pagini ASP.NET(.aspx) de a executa cod pe server. Resursele web sunt limitate la fișiere statice sau fișiere care sunt procesate în browser. O resursă web poate conține cod care este procesat în browser pentru a executa apeluri de serviciu web pentru a interacționa cu datele Dynamics 365 Customer Engagement (on-premises). Pentru mai multe informații, consultați Lucrul cu datele Customer Engagement utilizând resurse web.

Resursele web sunt disponibile numai utilizând contextul de securitate al aplicației web Dynamics 365 Customer Engagement (on-premises). Numai utilizatorii licențiați Dynamics 365 Customer Engagement (on-premises) care au privilegiile necesare le pot accesa.

Limitări de dimensiune

Dimensiunea maximă a fișierelor care pot fi încărcate este determinată de proprietatea Organization.MaxUploadFileSize . Această proprietate este setată în fila E-mail a Setărilor de sistem din aplicația Dynamics 365. Această setare limitează dimensiunea fișierelor care pot fi atașate la mesaje de e-mail, note și resurse web. Setarea implicită este 5 MB.

Tipuri de resurse web

Puteți utiliza zece formate de fișiere pentru a crea resurse web. Următorul tabel listează fiecare format de fișier, extensiile de fișier permise și valoarea de tip pe care o utilizați pentru fiecare.

Fișier	Extensii de fișiere	Tip
Pagină web (HTML)	.htm, .html	1
Foaie de stil (CSS)	.Css	2
Script (JScript)	.js	3
Date (XML)	.xml	4
Imagine (PNG)	.png	5
Imagine (JPG)	.jpg	6
Imagine (GIF)	.gif	7
Silverlight (XAP)	.xap	8
Foaie de stil (XSL)	.xsl, .xslt	9
Imagine (ICO)	.ico	10
Format vectorial (SVG)	.svg	11
Șir (RESX)	.resx	12

Resurse web de referință

Există mai multe metode pe care le puteți utiliza pentru a face referire la resurse web.

Notă

• Când este posibil, utilizați $webresource directiva. Numai referințele care utilizează $webresource directiva în harta site-ului sau comenzile din panglică vor stabili dependențe. Dependențele nu sunt create atunci când resursele web fac referire între ele.
  • Pentru a afișa o resursă web Silverlight în afara unui formular de entitate sau a unei diagrame, creați o resursă web HTML care să fie pagina gazdă pentru resursa web Silverlight. Apoi utilizați directiva $webresource: pentru a deschide resursa web HTML.

Directiva $webresource

Ar trebui să utilizați $webresource întotdeauna directiva atunci când faceți referire la o resursă web dintr-un control panglică sau dintr-o SiteMap subzonă. Utilizați $webresource directiva oriunde XML permite o valoare URL. Următorul exemplu arată cum să îl utilizați.

$webresource:<name of Web Resource>  

Notă

Atunci când utilizați $webresource directiva, Dynamics 365 Customer Engagement (on-premises) va crea sau actualiza dependențele soluției.

Xrm.Navigation.openWebResource

The Xrm.Navigation. Funcția openWebResource va deschide o resursă web HTML într-o fereastră nouă cu parametri pentru a transmite numele resursei web, orice date ale șirului de interogare care urmează să fie transmise în parametrul data și informații despre înălțimea și lățimea ferestrei.

URL-ul generat include simbolul GUID unic, astfel încât resursa web din cache să fie încărcată.

URL relativ

Când faceți referire la o resursă web din zone care nu acceptă utilizarea directivei $webresource: , poate fi utilizată o adresă URL relativă. Pentru a activa acest lucru, vă recomandăm să utilizați o convenție de denumire consecventă pentru resursele web care reflectă o structură de fișiere virtuale. Prefixul de particularizare al editorului de soluții va fi întotdeauna inclus ca prefix la numele resursei web. Acesta poate reprezenta un folder virtual "rădăcină" pentru toate resursele web adăugate de editorul respectiv. Apoi puteți utiliza caracterul bară oblică (/) pentru a simula o structură de foldere care va fi onorată de serverul web.

Dintr-o altă resursă web, ar trebui să utilizați întotdeauna adrese URL relative pentru a vă referi reciproc. De exemplu, pentru ca resursa new_/content/contentpage.htm web a paginii web să facă referire la resursa new_/Styles/styles.cssweb CSS , creați linkul după cum urmează:

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

Pentru ca resursa new_/content/contentpage.htm web a paginii web să deschidă resursa isv_/foldername/dialogpage.htmweb a paginii web, creați linkul după cum urmează:

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

Notă

Nu utilizați o adresă URL relativă utilizând folderul WebResources ca cale rădăcină pentru adresa URL. De exemplu, nu utilizați acest lucru: /WebResources/<name of web resource>. Când un utilizator aparține mai multor organizații pe un server, această cale se va referi întotdeauna la organizația implicită a utilizatorului. Dacă utilizatorul nu utilizează organizația implicită și resursa web așteptată nu este inclusă în organizarea implicită a utilizatorului, apare o eroare "Fișier negăsit", chiar dacă resursa web apare în organizația în care lucrează utilizatorul în prezent.

Adresa URL completă

Următorul exemplu arată stilul URL-ului pe care îl puteți utiliza pentru a vizualiza resursele web.

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

Aplicația va procesa această adresă URL și va returna fișierul care conține cea mai recentă versiune a resursei web. Această adresă URL va arăta astfel:

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

Valoarea versiunii este actualizată atunci când publicați particularizări și se asigură că browserul utilizează cea mai recentă versiune cache a resursei web. Din acest motiv, utilizați o cale relativă către o resursă web, Xrm.Navigation. openWebResource sau Directiva $webresource (atunci când este posibil), deoarece valoarea versiunii va fi inclusă automat. Pentru resursele web mari, pot exista implicații semnificative de performanță dacă nu utilizați versiunea cache a fișierului.

Următorul exemplu afișează un URL pentru Dynamics 365 for Customer Engagement, unde MyOrganization este numele organizației și new_/test/test.htm este numele resursei web:

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

Notă

Includerea caracterului "/" și a unei extensii de nume de fișier în numele resursei web este o bună practică opțională.

Următorul eșantion afișează un URL pentru Dynamics 365 Customer Engagement local (local), unde myServer este numele serverului:

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

Când scrieți cod pentru a face referire la o resursă web care va trebui să funcționeze fie pentru Dynamics 365 for Customer Engagement, fie pentru Dynamics 365 Customer Engagement local (local), ar trebui să utilizați funcția getClientUrl .

Instrumente pentru comunitate

Iată câteva dintre instrumentele comunității care funcționează cu resurse web.

Nume instrument	Mai multe informații
WebResourceManager	https://github.com/gotdibbs/WebResourceManager
XrmToolkit	https://xrmtoolkit.com/Home/Features
WebResources Manager	https://www.xrmtoolbox.com/plugins/MsCrmTools.WebResourcesManager/

Notă

Instrumentele comunității nu sunt un produs al Microsoft Dynamics și Microsoft nu extinde suportul pentru instrumentele comunității. Dacă aveți întrebări referitoare la un instrument, contactați editorul instrumentului.

Consultați și

Scrierea extensiilor de aplicație client pentru Dynamics 365 Customer Engagement
Creați resurse web accesibile
Resurse web pentru pagini web (HTML)
Resurse web Silverlight (XAP)
Script (JScript) Resurse web
Resurse web pentru imagini
Resurse web pentru foaia de stil (XSL)
Resurse web de date (XML)
Resurse web pentru foaie de stil (CSS)
Mesaje și metode de resurse web
Exemplu: Transmiterea mai multor valori către o resursă web prin parametrul de date
Exemplu: Importul fișierelor ca resurse web
Utilizarea datelor serviciului web în resurse web
Simplificați dezvoltarea resurselor web folosind Fiddler AutoResponder