Risorse Web Silverlight (XAP)

  • Articolo

 

Data di pubblicazione: gennaio 2017

Si applica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Importante

Le risorse Web Microsoft Silverlight continuano a essere supportate in Microsoft Dynamics 365 (online e locale) per la compatibilità con le versioni precedenti. Per i componenti che verranno essere eseguiti su tutti i client, è consigliabile utilizzare le risorse Web HTML con HTML5 invece di Silverlight.

HTML5 è la tecnologia client preferita per il Web, su plug-in Web come Silverlight e Flash. HTML5 può essere utilizzato da qualsiasi dispositivo (PC, tablet, smartphone e altri) e utilizza notevolmente JavaScript (e numerose librerie JavaScript avanzate, come jQuery) e i CSS.

Microsoft Dynamics 365 (online e locale) supportano l'aggiunta di risorse Web Silverlight 4.0 ai moduli dell'entità. È possibile visualizzare le risorse Web Silverlight 5.0 in un elemento HTML utilizzando un elemento <object> che lo ospita, configurato per tale versione.

Nota

  • Le risorse Web Microsoft Silverlight non possono essere visualizzate nella versione a 64 bit di Microsoft Office Outlook.

  • 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.

In questo argomento

Creare risorse Web Silverlight

Accedere ai dati sul contesto

Passare i dati da un modulo a una risorsa Web Silverlight incorporata

Sviluppo e test delle risorse Web Silverlight

Eseguire il debug delle risorse Web Silverlight

Creare risorse Web Silverlight

Le risorse Web Silverlight possono essere create facilmente tramite il modulo delle risorse Web, immettendo un nome e un nome di visualizzazione, selezionando Silverlight (XAP) come tipo, quindi caricando il file XAP. Prima di poter essere utilizzata, la risorsa Web deve essere pubblicata. Tuttavia, poiché le risorse Web Silverlight consentono in genere un certo livello di interazione con i dati sul contesto in Microsoft Dynamics 365, è necessario pianificarne la modalità di creazione.

Accedere ai dati sul contesto

Quando si utilizza il pulsante Anteprima nel modulo delle risorse Web oppure si passa semplicemente ai dati URL, l'applicazione Silverlight viene ospitata in una pagina generica HTML senza informazioni sul contesto. Se l'applicazione Silverlight non richiede informazioni sul contesto, è possibile utilizzare questo URL per visualizzare la risorsa Web Silverlight.

Se le informazioni sul contesto non sono richieste, è necessario completare una delle operazioni seguenti:

  1. Aggiungere una risorsa Web Silverlight a un modulo dell'entità.

  2. Visualizzare la risorsa Web HTMLSilverlight utilizzando una risorsa Web configurata per fornire informazioni sul contesto.

Se la risorsa Web Silverlight è stata progettata per essere visualizzata in un modulo dell'entità, il modulo ha un oggetto Xrm.Page.context che è possibile utilizzare per accedere alle informazioni sul contesto. Per ulteriori informazioni, vedere Contesto sul lato client (riferimento sul lato client)

Se è necessario disporre dell'applicazione Silverlight al di fuori del contesto del modulo, è necessario configurare una risorsa Web HTML per fornire queste informazioni sul contesto aggiungendo un riferimento alla pagina ClientGlobalContext.js.aspx. Dopo aver aggiunto tale riferimento, l'applicazione Silverlight può accedere alle informazioni sul contesto come lo farebbe da un modulo dell'entità. Nel seguente esempio viene illustrato come chiamare la funzione getClientUrl dall'oggetto Xrm.Page.context.

private string clientUrl = "";
ScriptObject xrm = (ScriptObject)HtmlPage.Window.GetProperty("Xrm");
ScriptObject page = (ScriptObject)xrm.GetProperty("Page");
ScriptObject pageContext = (ScriptObject)page.GetProperty("context");
clientUrl = (string)pageContext.Invoke("getClientUrl");

Passare i dati da un modulo a una risorsa Web Silverlight incorporata

Quando si aggiunge una risorsa Web Silverlight incorporata a un modulo, è possibile selezionare l'opzione Passa il codice del tipo di oggetto e l'identificatore univoco come parametri. È inoltre possibile immettere del testo come parametro personalizzato.

Questi valori vengono passati al controllo Silverlight come un InitParams, un dizionario di coppie chiave/valore.

I valori passati sono descritti nella tabella seguente.

Chiave

Descrizione

ID

Identificatore univoco del record.

tipo

Il codice del tipo di entità. Per le entità personalizzate questo può essere diverso nelle varie organizzazioni.

typename

Nome logico dell'entità.

orgname

Nome dell'organizzazione.

userlcid

Codice della lingua che rappresenta la preferenza della lingua dell'utente.

orglcid

Codice della lingua che rappresenta la lingua di base dell'organizzazione.

Dati di

Valore del testo immesso come parametro personalizzato.

Questi valori sono accessibili in fase di esecuzione utilizzando la sintassi mostrata nell'esempio seguente:

string entityTypeName = App.Current.Host.InitParams["typename"];

Sviluppo e test delle risorse Web Silverlight

Se la risorsa Web Silverlight è indipendente da ogni dato sul contesto di Microsoft Dynamics 365, è possibile sviluppare ed eseguire il test dell'applicazione Silverlight come di norma. Dopo aver creato una nuova risorsa Web caricando il file .xap, è possibile eseguire il test utilizzando il pulsante Anteprima nel modulo della risorsa Web dopo aver salvato e pubblicato la risorsa.

Tuttavia, è probabile che nell'applicazione Silverlight siano presenti dipendenze dei dati sul contesto che non possono essere completamente simulate all'esterno di Microsoft Dynamics 365.

Il processo di creazione di una risorsa Web Silverlight che include le dipendenze di contesto o del modulo è il seguente:

  1. Creare il progetto dell'applicazione Silverlight.

    È necessario selezionare per creare un'applicazione Web con il progetto.

  2. Sviluppare ed eseguire il più possibile il test dell'applicazione senza richiedere dati sul contesto da Microsoft Dynamics 365.

  3. Creare le risorse Web caricando i file .xap e .htm come risorse Web Silverlight e HTML.

  4. Scrivere il codice del progetto dell'applicazione Silverlight.

  5. Creare il progetto dell'applicazione Silverlight.

  6. Caricare la versione generata del file .xap nella cartella del progetto dell'applicazione Web ClientBin per aggiornare la risorsa Web Silverlight creata nel passaggio 3.

  7. Eseguire il test della risorsa Web Silverlight tramite una delle operazioni seguenti:

    • Visualizzandola utilizzando il pulsante Anteprima della risorsa Web host HTML creata.

    • Visualizzandola nel contesto del modulo di un'entità che si è aggiunto.

      Utilizzare questa opzione se l'applicazione Silverlight presenta dipendenze sugli elementi del modulo o informazioni sul contesto.

  8. Ripetere i passaggi da 4 a 7 fino al completamento del processo.

Nota

Se si desidera visualizzare una risorsa Web Silverlight all'esterno di un modulo dell'entità, ad esempio nel frame principale dell'applicazione modificando la mappa del sito, è necessario specificare una risorsa Web webpage (HTML) che funga da host per la risorsa Web Silverlight.

Importante

Non modificare mai il codice sorgente HTML per una pagina che ospita una risorsa Web Silverlight tramite l'editor di testo dell'applicazione. L'editor di testo modifica HTML e interrompe la definizione dell'elemento <object> necessaria per ospitare la risorsa Web SilverlightXAP . Per ulteriori informazioni, vedere bba8645a-a725-4c4d-a393-bab8ca692482#BKMK_UsingTextEditor.

Se è necessario utilizzare l'editor di testo, omettere il parametro data="data:application/x-silverlight-2," nell'elemento <object>. Sebbene questo può impedire l'interruzione della risorsa Web Silverlight, l'editor di testo può sempre introdurre altre modifiche non desiderate.

Eseguire il debug delle risorse Web Silverlight

Le risorse Web Silverlight che non si basano sui dati sul contesto di Microsoft Dynamics 365 possono essere sottoposte a debug in Microsoft Visual Studio. Tuttavia, se la risorsa Web Silverlight richiede dati sul contesto per eseguire le funzioni, sarà necessario completare una procedura diversa.

  1. Creare l'applicazione Silverlight.

  2. Caricare la versione generata del file .xap nella cartella del progetto dell'applicazione Web ClientBin .

  3. Visualizzare l'applicazione Silverlight nel contesto in cui deve essere utilizzata.

  4. Nel progetto dell'applicazione Silverlight, nel menu Visual Studio, selezionare Debug, quindi Connetti a processo.

  5. Nella finestra di dialogo Connetti a processo individuare un processo iexplore.exe dove il valore della colonna Tipo sia Silverlight, x86.

  6. Selezionare il processo e premere Connetti per chiudere la finestra di dialogo e avviare il debug.

  7. Nel progetto dell'applicazione Silverlight impostare un punto di interruzione.

  8. Aggiornare la finestra del browser oppure, nell'applicazione Silverlight, eseguire le azioni necessarie per verificare il codice.

Vedere anche

Creare risorse Web accessibili
Risorse Web per Microsoft Dynamics 365
Risorse Web pagine Web (HTML)
Risorse Web CSS
Risorse Web per script (JScript)
Risorse Web dati (XML)
Risorse Web immagini (JPG, PNG, GIF, ICO)
Risorse Web dei fogli di stile (XSL)

Microsoft Dynamics 365

© 2017 Microsoft. Tutti i diritti sono riservati. Copyright