Risorse Web per Microsoft Dynamics 365
Data di pubblicazione: gennaio 2017
Si applica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
Le risorse Web sono file virtuali archiviati nel database di Microsoft Dynamics 365 che è possibile recuperare tramite un indirizzo URL univoco.
In questo argomento
Funzionalità delle risorse Web
Tipi di risorsa Web
Risorse Web di riferimento
Funzionalità delle risorse Web
Le risorse web indicano file che possono essere utilizzati per estendere l'applicazione web Microsoft Dynamics 365, quali file HTML, JavaScript e applicazioni Silverlight. È possibile utilizzare le risorse Web nelle personalizzazioni del modulo, SiteMap o nella barra multifunzione dell'applicazione perché è possibile farvi riferimento mediante la sintassi URL.
La sintassi dell'URL per le risorse Web consente i riferimenti di percorso relativi. Con gli strumenti di sviluppo, è possibile creare un gruppo di file interdipendenti in un server di sviluppo utilizzando i tipi di file compatibili con le risorse Web. In seguito, se si utilizza una convenzione di denominazione coerente e riferimenti di percorso relativi, il sito Web verrà eseguito dopo aver caricato tutti i file in Microsoft Dynamics 365.
Poiché le risorse Web sono archiviate in Microsoft Dynamics 365 e sono componenti di soluzione, è possibile che vengano esportate e installate in distribuzioni locali di Microsoft Dynamics 365 o in Microsoft Dynamics 365 (online). Le risorse web sono disponibili anche gli utenti di Microsoft Dynamics 365 per Microsoft Office Outlook con accesso offline in modalità offline perché vengono sincronizzate con i dati utente.
È possibile utilizzare un editor di moduli per aggiungere e configurare le risorse abilitate Web abilitate per i moduli nei moduli dell'entità.
Poiché le risorse Web sono memorizzate come record nel database, è possibile gestirle a livello di programmazione utilizzando le tecniche standard per creare, recuperare e aggiornare i record. Le risorse Web basate su testo (JScript, CSS, XML, XSL, and HTML) possono essere modificate e salvate nell'applicazione.
Limitazioni delle risorse Web
Non esiste alcun tipo di risorsa Web che supporti le funzionalità di una pagina ASP.NET(.aspx) per eseguire codice nel server. Le risorse web sono limitate a file statici o a file elaborati nel browser. Una risorsa Web può contenere codice che viene elaborato nel browser per eseguire le chiamate di servizi web per interagire con i dati Microsoft Dynamics 365. Per ulteriori informazioni, vedere Lavorare con i dati Dynamics 365 utilizzando le risorse Web.
Le risorse web sono disponibili solo utilizzando il contesto di protezione dell'applicazione web Microsoft Dynamics 365. Solo gli utenti con licenza di Microsoft Dynamics 365 con i privilegi necessari possono accedervi.
Limitazioni di dimensione
Le dimensioni massime dei file che è possibile caricare sono determinate dalla proprietà Organization.MaxUploadFileSize. Questa proprietà viene impostata nella scheda Posta elettronica in Impostazioni di sistema nell'applicazione Dynamics 365. Tramite questa impostazione è possibile limitare le dimensioni dei file che è possibile allegare ai messaggi di posta elettronica, alle note e alle risorse Web. L'impostazione predefinita è 5 MB.
Tipi di risorsa Web
È possibile utilizzare dieci formati di file per creare le risorse Web. Nella tabella seguente viene elencato ogni formato di file, le estensioni di file consentite e il valore di tipo che si utilizza per ognuno.
File |
Estensioni file |
Tipo |
|---|---|---|
Pagina Web (HTML) |
.htm, .html |
1 |
Foglio di stile (CSS) |
.css |
2 |
Script (JScript) |
.js |
3 |
Dati (XML) |
.xml |
4 |
Immagine (PNG) |
.png |
5 |
Immagine (JPG) |
.jpg |
6 |
Immagine (GIF) |
.gif |
7 |
Silverlight (XAP) |
.xap |
8 |
Foglio di stile (XSL) |
.xsl, .xslt |
9 |
Immagine (ICO) |
.ico |
10 |
Risorse Web di riferimento
Esistono diversi metodi che è possibile utilizzare per fare riferimento alle risorse Web.
Nota
-
Quando possibile, utilizzare la direttiva $webresource. Solo i riferimenti che utilizzano la direttiva $webresource nella mappa del sito o nei comandi della barra multifunzione stabiliranno dipendenze. Le dipendenze non vengono create quando le risorse Web fanno riferimento a loro stesse.
-
Per visualizzare una risorsa Web Silverlight all'esterno di un modulo o un grafico dell'entità, crea una risorsa Web HTML come pagina host per la risorsa Web Silverlight. Utilizza quindi la direttiva $webresource: per aprire la risorsa Web HTML.
direttiva $webresource
È sempre consigliabile utilizzare la direttiva $webresource quando si fa riferimento a una risorsa Web di un controllo della barra multifunzione o di un'area secondaria di SiteMap. Utilizzare la direttiva $webresource ovunque il codice XML consenta un valore URL. Nell'esempio seguente viene illustrato come utilizzarla.
$webresource:<name of Web Resource>
Nota
Quando si utilizza la direttiva $webresource, Microsoft Dynamics 365 creerà o aggiornerà le dipendenze delle soluzioni.
Xrm.Utility.openWebResource
La funzione Xrm.Utility.openWebResource aprirà una risorsa Web HTML in una nuova finestra con i parametri per passare il nome della risorsa Web, i dati di stringa di query da passare nel parametro dati e le informazioni sull'altezza e la larghezza della finestra.
L'URL generato include il token univoco GUID in modo che la risorsa Web memorizzata nella cache venga caricata.
URL relativo
Quando si fa riferimento a una risorsa Web nelle aree che non supportano l'utilizzo della direttiva $webresource:, un relativo URL può essere utilizzato. Per abilitare questa operazione, è consigliabile utilizzare una convenzioni di denominazione coerente per le risorse Web che rispecchiano una struttura di file server. Il prefisso di personalizzazione dell'autore della soluzione verrà sempre incluso come prefisso al nome della risorsa Web. Questo può rappresentare una cartella "radice" virtuale per tutte le risorse Web aggiunte dall'autore. È possibile utilizzare il carattere barra (/) per simulare una struttura di cartelle che verrà considerata dal server web.
Da un'altra risorsa Web, è consigliabile utilizzare sempre il relativo URLs per fare riferimento tra loro. Ad esempio, perché la risorsa Web new_/content/contentpage.htm della pagina Web faccia riferimento alla pagina Web CSSnew_/Styles/styles.css, creare il collegamento seguente:
<link rel="stylesheet" type="text/css" href="../styles/styles.css" />
Ad esempio, perché la risorsa Web new_/content/contentpage.htm della pagina Web apra la risorsa Web della pagina Web isv_/foldername/dialogpage.htm , creare il collegamento seguente:
<a href="../../isv_/foldername/dialogpage.htm">Dialog Page</a>
Nota
Non utilizzare un URL relativo utilizzando la cartella WebResources come percorso radice per URL. Ad esempio, non utilizzare il seguente: /WebResources/<name of web resource>. Quando un utente appartiene a più di un'organizzazione in un server, il percorso si riferirà sempre all'organizzazione predefinita degli utenti. Se l'utente non sta utilizzando l'organizzazione predefinita e la risorsa Web prevista non viene inclusa nell'organizzazione predefinita dell'utente, si verifica un errore "File non trovato" anche se la risorsa Web si verifica nell'organizzazione in cui l'utente sta attualmente lavorando.
URL completo
L'esempio seguente mostra lo stile di URL che è possibile utilizzare per visualizzare le risorse Web.
<Microsoft CRM URL>/WebResources/<name of web resource>
L'applicazione elaborerà questo URL e restituirà il file che contiene la versione più recente della risorsa Web. Questo URL sarà simile al seguente:
<Microsoft CRM URL>/%7B<GUID value>%7D/WebResources/<name of web resource>
Il valore GUID viene aggiornato quando si pubblicano personalizzazioni e assicura che il browser utilizza la versione più aggiornata memorizzata nella cache della risorsa Web. Per questo motivo, utilizzare un percorso relativo a una risorsa Web, la funzione Xrm.Utility.openWebResource o direttiva $webresource (quando sarà possibile) perché il valore GUID sarà automaticamente incluso. Per le grandi risorse Web, come risorse Web Silverlight, possono esserci implicazioni significative di prestazioni se non si utilizza la versione memorizzata nella cache del file.
Nell'esempio seguente viene illustrato un URL per Microsoft Dynamics 365 (online), dove MyOrganization è il nome dell'organizzazione e new_/test/test.htm è il nome della risorsa Web:
https://MyOrganization.crm.dynamics.com/WebResources/new_/test/test.htm
Nota
L'inclusione del carattere "/" e di un'estensione del nome file nel nome della risorsa Web è una procedura facoltativa.
Nell'esempio seguente viene illustrato un URL per Microsoft Dynamics 365 locale, dove myServer è il nome del server:
http://myServer/MyOrganization/WebResources/new_/test/test.htm
Quando si scrive il codice per fare riferimento a una risorsa Web che dovrà funzionare per Microsoft Dynamics 365 (online) o Microsoft Dynamics 365 locale, è necessario utilizzare la funzione getClientUrl.
Vedere anche
Estendere Microsoft Dynamics 365 nel client
Librerie JavaScript per Microsoft Dynamics 365
Creare risorse Web accessibili
Risorse Web pagine Web (HTML)
Risorse Web Silverlight (XAP)
Risorse Web per script (JScript)
Risorse Web immagini (JPG, PNG, GIF, ICO)
Risorse Web dei fogli di stile (XSL)
Risorse Web dati (XML)
Risorse Web CSS
Metodi e messaggi dell'entità WebResource
Esempio: passare più valori a una risorsa Web tramite il parametro dati
Esempio: utilità risorsa Web
Esempio: importare file come risorse Web
Lavorare con i dati Dynamics 365 utilizzando le risorse Web
Microsoft Dynamics 365
© 2017 Microsoft. Tutti i diritti sono riservati. Copyright