Recursos web per al Customer Engagement

Els recursos web són fitxers virtuals que s'emmagatzemen a la base de dades del Dynamics 365 Customer Engagement (on-premises) i que podeu recuperar mitjançant una adreça URL única.

Capacitats dels recursos web

Els recursos web representen fitxers que es poden utilitzar per ampliar l'aplicació web del Dynamics 365 Customer Engagement (on-premises), com ara fitxers html, JavaScript i CSS, i diversos formats d'imatge. Podeu utilitzar recursos web en personalitzacions de formularis, la SiteMapcinta o la franja de l'aplicació perquè es pot fer referència a ells mitjançant la sintaxi d'URL.

La sintaxi d'URL per als recursos web permet referències de camins relatius. Amb les vostres eines de desenvolupament, podeu crear un grup de fitxers interdependents en un servidor de desenvolupament mitjançant tipus de fitxers compatibles amb recursos web. Aleshores, si utilitzeu una convenció de nomenclatura coherent i referències de camí relatives, el lloc web funcionarà després de carregar tots els fitxers al Dynamics 365 Customer Engagement (on-premises).

Com que els recursos web s'emmagatzemen al Dynamics 365 Customer Engagement (on-premises) i són components de la solució, es poden exportar i instal·lar fàcilment a implementacions locals del Dynamics 365 Customer Engagement (on-premises) o al Dynamics 365 for Customer Engagement. Els recursos web també estan disponibles per als usuaris del Dynamics 365 for Microsoft Office Outlook amb accés fora de línia quan estan fora de línia, ja que se sincronitzen amb les dades de l'usuari.

Podeu utilitzar l'editor de formularis per afegir i configurar recursos web habilitats per a formularis als formularis d'entitat.

Com que els recursos web s'emmagatzemen com a registres a la base de dades, es poden administrar mitjançant programació mitjançant les tècniques estàndard per crear, recuperar i actualitzar registres. Els recursos web basats en text (JScript, CSS, XML, XSL, RESX i HTML) es poden editar i desar a l'aplicació.

Limitacions dels recursos web

No hi ha cap tipus de recurs web que admeti les capacitats d'una pàgina ASP.NET(.aspx) per executar codi al servidor. Els recursos web es limiten a fitxers estàtics o fitxers que es processen al navegador. Un recurs web pot contenir codi que es processa al navegador per executar trucades de servei web per interactuar amb les dades del Dynamics 365 Customer Engagement (on-premises). Per obtenir més informació, vegeu Treballar amb dades del Customer Engagement mitjançant recursos web.

Els recursos web només estan disponibles mitjançant el context de seguretat de l'aplicació web del Dynamics 365 Customer Engagement (on-premises). Només hi poden accedir els usuaris amb llicència del Dynamics 365 Customer Engagement (on-premises) que tinguin els privilegis necessaris.

Limitacions de mida

La mida màxima dels fitxers que es poden carregar la determina la propietat Organization.MaxUploadFileSize . Aquesta propietat es defineix a la pestanya Correu electrònic de la configuració del sistema a l'aplicació Dynamics 365. Aquesta configuració limita la mida dels fitxers que es poden adjuntar a missatges de correu electrònic, notes i recursos web. La configuració predeterminada és de 5 MB.

Tipus de recursos web

Podeu utilitzar deu formats de fitxer per crear recursos web. A la taula següent s'enumeren cada format de fitxer, les extensions de fitxer permeses i el valor de tipus que utilitzeu per a cadascun.

Fitxer Extensions de fitxer Tipus
Pàgina web (HTML) .htm, .html 1
Full d'estil (CSS) .Css 2
Script (JScript) .js 3
Dades (XML) .xml 4
Imatge (PNG) .png 5
Imatge (JPG) .jpg 6
Imatge (GIF) .gif 7
Silverlight (XAP) .xap 8
Full d'estil (XSL) .xsl, .xslt 9
Imatge (ICO) .ico 10
Format vectorial (SVG) .svg 11
Cadena (RESX) .resx 12

Recursos web de referència

Hi ha diversos mètodes que podeu utilitzar per fer referència a recursos web.

Nota

  • Quan sigui possible, utilitzeu la $webresource directiva. Només les referències que utilitzen la $webresource directiva a les ordres del mapa del lloc o de la franja establiran dependències. Les dependències no es creen quan els recursos web fan referència entre si.
    • Per visualitzar un recurs web del Silverlight fora d'un formulari o gràfic d'entitat, creeu un recurs web HTML que sigui la pàgina d'amfitrió del recurs web del Silverlight. A continuació, utilitzeu la directiva $webresource: per obrir el recurs web HTML.

Directiva $webresource

Sempre heu d'utilitzar la $webresource directiva quan feu referència a un recurs web des d'un control de la franja o des d'una SiteMap subàrea. Utilitzeu la $webresource directiva en qualsevol lloc on l'XML permeti un valor d'URL. L'exemple següent mostra com utilitzar-lo.

$webresource:<name of Web Resource>

Nota

Quan s'utilitza la directiva, el $webresource Dynamics 365 Customer Engagement (on-premises) crearà o actualitzarà les dependències de la solució.

Xrm.Navigation.openWebResource

El Xrm.Navigation. La funció openWebResource obrirà un recurs web HTML en una finestra nova amb paràmetres per passar el nom del recurs web, qualsevol dada de cadena de consulta que s'ha de passar al paràmetre data i informació sobre l'alçada i l'amplada de la finestra.

L'adreça URL generada inclou el testimoni GUID únic perquè es carregui el recurs web a la memòria cau.

URL relatiu

Quan es fa referència a un recurs web des d'àrees que no admeten l'ús de la $webresource: directiva, es pot utilitzar un URL relatiu. Per habilitar-ho, us recomanem que utilitzeu una convenció de nomenclatura coherent per als recursos web que reflecteixin una estructura de fitxers virtuals. El prefix de personalització de l'editor de solucions sempre s'inclourà com a prefix al nom del recurs web. Això pot representar una carpeta "arrel" virtual per a tots els recursos web afegits per aquest editor. A continuació, podeu utilitzar el caràcter de barra inclinada (/) per simular una estructura de carpetes que serà respectada pel servidor web.

Des d'un altre recurs web, sempre heu d'utilitzar URL relatius per fer referència entre ells. Per exemple, perquè el recurs new_/content/contentpage.htm web de la pàgina web faci referència al recurs new_/Styles/styles.cssweb CSS , creeu l'enllaç de la manera següent:

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

Perquè el recurs new_/content/contentpage.htm web de la pàgina web obri el recurs isv_/foldername/dialogpage.htmweb de la pàgina web, creeu l'enllaç de la manera següent:

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

Nota

No utilitzeu una adreça URL relativa utilitzant la carpeta WebResources com a camí arrel per a l'adreça URL. Per exemple, no utilitzeu això: /WebResources/<name of web resource>. Quan un usuari pertany a més d'una organització en un servidor, aquest camí sempre farà referència a l'organització per defecte de l'usuari. Si l'usuari no utilitza la seva organització per defecte i el recurs web esperat no s'inclou a l'organització per defecte de l'usuari, es produeix un error "Fitxer no trobat" encara que el recurs web es produeixi a l'organització en què l'usuari està treballant actualment.

URL complet

L'exemple següent mostra l'estil de l'adreça URL que podeu utilitzar per visualitzar recursos web.

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

L'aplicació processarà aquesta adreça URL i retornarà el fitxer que conté la versió més recent del recurs web. Aquest URL tindrà aquest aspecte:

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

El valor de la versió s'actualitza quan publiqueu personalitzacions i garanteix que el navegador utilitzi la darrera versió a la memòria cau del recurs web. Per això, utilitzeu un camí relatiu a un recurs web, Xrm.Navigation. openWebResource , o la directiva $webresource (quan sigui possible) perquè el valor de la versió s'inclourà automàticament. Per a recursos web grans, pot haver-hi implicacions significatives en el rendiment si no utilitzeu la versió a la memòria cau del fitxer.

L'exemple següent mostra una adreça URL per al Dynamics 365 for Customer Engagement, on MyOrganization és el nom de l'organització i new_/test/test.htm és el nom del recurs web:

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

Nota

Incloure el caràcter '/' i una extensió de nom de fitxer al nom del recurs web és una pràctica recomanada opcional.

L'exemple següent mostra una adreça URL per al Dynamics 365 Customer Engagement local (on-premises), on myServer és el nom del servidor:

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

Quan escriviu codi per fer referència a un recurs web que haurà de funcionar per al Dynamics 365 for Customer Engagement o el Dynamics 365 Customer Engagement local (on-premises), heu d'utilitzar la funció getClientUrl .

Eines de la comunitat

Aquestes són algunes de les eines de la comunitat que funcionen amb recursos web.

Nom de l'eina Més informació
WebResourceManager https://github.com/gotdibbs/WebResourceManager
XrmToolkit https://xrmtoolkit.com/Home/Features
Gestor de recursos web https://www.xrmtoolbox.com/plugins/MsCrmTools.WebResourcesManager/

Nota

Les eines de la comunitat no són un producte de Microsoft Dynamics i Microsoft no amplia el suport a les eines de la comunitat. Si teniu preguntes relacionades amb una eina, poseu-vos en contacte amb l'editor de l'eina.

Consulteu també

Escriure extensions d'aplicació client per al Dynamics 365 Customer Engagement
Crear recursos web accessibles
Recursos web de pàgines web (HTML)
Recursos web del Silverlight (XAP)
Recursos web de l'script (JScript)
Recursos web d'imatges
Recursos web del full d'estil (XSL)
Recursos web de dades (XML)
Recursos web del full d'estil (CSS)
Missatges i mètodes de recursos web
Exemple: Passar diversos valors a un recurs web a través del paràmetre Data
Exemple: Importació de fitxers com a recursos web
Utilitzar dades de servei web en recursos web
Optimitzeu el desenvolupament de recursos web amb Fiddler AutoResponder

  • Last updated on