Risorse Web pagine Web (HTML)

  • Articolo

 

Data di pubblicazione: novembre 2016

Si applica a: Dynamics CRM 2015

Utilizzare le risorse Web della pagina Web (HTML) per creare gli elementi di interfaccia utente per le estensioni client.

In questo argomento

Funzionalità delle risorse Web HTML

Limitazioni delle risorse Web HTML

Utilizzare l'editor di testo per le risorse Web HTML

Evitare la modifica delle risorse Web per le soluzioni gestite

Fare riferimento ad altre risorse Web da una risorsa Web HTML

Passare i parametri alle risorse Web HTML

Funzionalità delle risorse Web HTML

Poiché una risorsa Web HTML viene solo inviata come flusso al browser dell'utente, può includere qualsiasi contenuto visualizzato nel browser dell'utente.

Limitazioni delle risorse Web HTML

  • Una risorsa Web HTML non può contenere codice che deve essere eseguito nel server. Le pagine ASP.NET non possono essere caricate come risorse Web HTML.

  • Le risorse Web HTML possono accettare solo un numero limitato di parametri di stringa di query.Ulteriori informazioni:Passare i parametri alle risorse Web HTML

Utilizzare l'editor di testo per le risorse Web HTML

L'editor di testo contenuto nel modulo delle risorse Web è progettato per essere utilizzato con modifiche HTML molto semplici. Per i documenti HTML più complessi, è necessario modificare il codice in un editor esterno e utilizzare il pulsante Sfoglia per caricare il contenuto del file.

Ad esempio, una pagina HTML più complessa che richiede script per visualizzare i contenuti della pagina inizierà come nel seguente esempio.

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
 <title></title>
 <script src="Script/Script.js" type="text/javascript"></script>
 <link href="CSS/Styles.css" rel="stylesheet" type="text/css" />
</head>
<body onload="SDK.ImportWebResources.showData()">
 <div id="results" />
</body>
</html>

Una volta che il documento viene aperto nell'editor di testo e viene salvato, il codice HTML viene modificato coerentemente con l'editor.

<HTML><HEAD><TITLE></TITLE>
<META charset=utf-8></HEAD>
<BODY contentEditable=true onload=SDK.ImportWebResources.showData()>
<SCRIPT type=text/javascript src="Script/Script.js"></SCRIPT>
 <LINK rel=stylesheet type=text/css href="CSS/Styles.css">
<DIV id=results></DIV></BODY></HTML>

Evitare la modifica delle risorse Web per le soluzioni gestite

Data la possibilità di modificare il codice HTML nelle risorse Web utilizzando l'editor di testo, è consigliabile utilizzare le proprietà gestite per definire le risorse Web HTML complesse come non personalizzabili per le soluzioni gestite. Quando si visualizzano risorse Web nella finestra delle soluzioni, aprire la finestra di dialogo Proprietà gestite per impostare la proprietà Personalizzabile su false.

Fare riferimento ad altre risorse Web da una risorsa Web HTML

È possibile creare un set di file correlati all'esterno di Microsoft Dynamics 365 che utilizza qualunque tipo di file della risorsa Web. Se si presta attenzione a utilizzare sempre percorsi correlati e a importare ogni risorsa Web con una convenzione di denominazione coerente che rifletta la struttura della cartella del sito Web, la risorsa Web HTML manterrà i collegamenti alle immagini CSS, XML, JScriptcorrelate e ai file di Silverlight che sono stati importati come risorse Web.

Ad esempio, si crea un progetto di applicazioni Web che utilizza la seguente struttura [cartella]/file:

  • page.htm

  • [Styles]

    • style.css

  • [Scripts]

    • script.js

Quando si importano questi file come risorse Web, è possibile indicare dove il prefisso di personalizzazione dell'autore di soluzioni è "nuovo" nel modo seguente:

  • new_/page.htm

  • new_/Styles/style.css

  • new_/Scripts/script.js

Quando si segue questo criterio, la risorsa Web new_/page.htmHTML può fare riferimento gli altri file nel modo più comune utilizzando i percorsi correlati come illustrato nell'esempio seguente.

<script src="Scripts/script.js" type="text/javascript"></script>
<link href="Styles/style.css" rel="stylesheet" type="text/css" />

Il prefisso di personalizzazione dell'autore di soluzioni diventa una cartella di radice virtuale per tutte le risorse Web della soluzione. Se si modifica il prefisso di personalizzazione, i percorsi correlati all'interno delle risorse Web HTML non verranno modificati.

Nota

  • Una risorsa Web HTML aggiunta a un modulo non può utilizzare gli oggetti globali definiti dalla libreria JavaScript caricata nel modulo. Una risorsa Web HTML può interagire con gli oggetti Xrm.Utility o Xrm.Page nel modulo mediante parent.Xrm.Page o parent.Xrm.Utility, ma gli oggetti globali definiti da script di modulo non sono accessibili tramite il padre. È necessario caricare tutte le librerie richieste da una risorsa Web HTML nella risorsa Web HTML in modo da non dipendere dagli script caricati nel modulo.

  • Riferimenti inclusi nel codice tra risorse Web non sono registrati come dipendenze delle soluzioni.

Poiché le risorse Web vengono anche scaricate per gli utenti di Microsoft Dynamics CRM per Microsoft Office Outlook con accesso offline, gli utenti avranno accesso al contenuto delle risorse Web anche in modalità offline.

Passare i parametri alle risorse Web HTML

Una risorsa Web HTML può accettare solo i parametri nella tabella seguente.

Parametro

Nome

Descrizione

typename

Nome entità

Nome dell'entità.

type

Codice tipo entità

Numero intero che identifica in modo univoco l'entità in un'organizzazione specifica.

id

GUID oggetto

GUID che rappresenta un record.

orgname

Nome organizzazione

Nome univoco dell'organizzazione.

userlcid

Codice della lingua dell'utente

Identificatore del codice della lingua utilizzato dall'utente corrente.

orglcid

Codice della lingua dell'organizzazione

Identificativo del codice della lingua che rappresenta la lingua di base per l'organizzazione.

data

Parametro dati facoltativo

Un valore facoltativo che può essere passato.

formid

ID modulo

GUID che rappresenta un ID modulo.

entrypoint

Punto di accesso

Un valore di stringa. Questo parametro deve essere passato come valore facoltativo alle risorse Web aperte come contenuto personalizzato della guida per un'entità. Una volta abilitato, l'URL personalizzato della guida includerà un valore di "form" o "hierarchychart".Ulteriori informazioni:Aggiungere il contenuto personalizzato della guida

pagemode

Solo per uso interno.

sicurezza

Solo per uso interno.

tabSet

Solo per uso interno.

Per passare più di un valore nel parametro dati, è necessario codificare i parametri nel valore del parametro dati e quindi includere la logica per decodificare i vari parametri utilizzando script nella risorsa Web HTML. Nell'argomento Esempio: passare più valori a una risorsa Web tramite il parametro dati viene illustrato un metodo per instradare con il passaggio più valori di parametro.

Vedere anche

Risorse Web per Microsoft Dynamics CRM 2015
Creare risorse Web accessibili
Risorse Web CSS
Risorse Web per script (JScript)
Risorse Web dati (XML)
Risorse Web immagini (JPG, PNG, GIF, ICO)
Risorse Web Silverlight (XAP)
Risorse Web dei fogli di stile (XSL)

© 2017 Microsoft. Tutti i diritti sono riservati. Copyright