Creare o modificare risorse Web per estendere un'app

Questo argomento si applica a Dynamics 365 Customer Engagement (on-premises). Per la versione Power Apps di questo argomento, vedi: Creare o modificare risorse Web per app basate su modello per estendere un'app

Le risorse Web in genere vengono utilizzate dagli sviluppatori per estendere un'app utilizzando file che sono utilizzati nello sviluppo Web. È possibile che gli utenti di app debbano gestire risorse Web fornite da uno sviluppatore o un designer.

Mancia

Per una discussione approfondita sulle risorse Web, vedi Risorse Web per Customer Engagement.

Cosa sono le risorse Web?

Le risorse Web sono file virtuali archiviati nel sistema. Ogni risorsa Web dispone di un nome univoco che può essere utilizzato in un URL per recuperare il file. Si può pensare alle risorse Web nel seguente modo: se si avesse accesso all'app Web effettiva in cui è eseguita l'applicazione Web, sarebbe possibile copiare file nel sito Web. Tuttavia, con la maggior parte dei servizi online, non è possibile eseguire questa operazione. In alternativa, è possibile utilizzare le risorse Web per caricare i file nel sistema e quindi fare riferimento a loro in base al nome come se si fossero copiati come i file nel server Web.

Ad esempio, se si crea una pagina HTML come risorsa Web denominata "new_myWebResource.htm", è possibile aprire la pagina in un browser tramite un URL simile al seguente:

<URL Dynamics 365 Customer Engagement (on-premises)>/WebResources/new_myWebResource.htm

dove <URL app> è l'URL che si utilizza in genere per aprire l'app. Dato che la risorsa Web rappresenta i dati nel sistema, solo gli utenti con licenza dell'organizzazione possono accedere a tali dati in questo modo. In generale, le risorse Web sono incluse in moduli anziché avere un riferimento diretto. In genere sono utilizzate per fornire librerie JavaScript per gli script dei moduli.

Poiché le risorse Web sono dati nel sistema e riconoscono le soluzioni, è possibile spostarle in organizzazioni differenti esportandole come parte di una soluzione e importando la soluzione in un'organizzazione diversa.

Creare e modificare le risorse Web

1. Apri Esplora soluzioni e quindi seleziona Risorse Web.

2. In Componenti, scegli Risorse Web.

3. Per creare una risorsa Web, selezionare Nuovo.

   Per modificare una risorsa Web, fare doppio clic sulla risorsa Web che si desidera modificare.

4. Il modulo delle risorse Web dispone dei seguenti campi e funzionalità:

   Etichetta	Descrizione
   Nome	Obbligatorio. È il numero univoco per questa risorsa Web. Non è possibile modificarlo dopo che si è salvato la risorsa Web. Questo nome può includere solo lettere, numeri, punti e caratteri barra non consecutivi (“/”). Il prefisso di personalizzazione dell'autore della soluzione viene anteposto al nome della risorsa Web.
   Nome visualizzato	Nome visualizzato se si visualizza un elenco di risorse Web.
   Descrizione	Descrizione della risorsa Web.
   Tipo	Obbligatorio. Questo è il tipo di risorsa Web. Non è possibile modificarlo dopo che si è salvato la risorsa Web.
   Editor di testo	Se il tipo di risorsa Web rappresenta un genere di file di testo, selezionare questo pulsante per aprire una pagina per modificare il contenuto nell'editor di testo.
   Linguaggio	Consente di selezionare una lingua. Questa opzione contrassegna semplicemente il record in cui sono archiviati i dati delle risorse Web. Non modifica il comportamento della risorsa Web.
   Carica file	Seleziona il pulsante Sfoglia... per scegliere un file da caricare come risorsa Web. È possibile caricare un file durante la creazione di una nuova risorsa Web o per sovrascrivere una risorsa Web esistente. L'estensione del nome del file deve corrispondere alle estensioni consentite. Per impostazione predefinita le dimensioni massime del file che può essere caricato come risorsa Web corrisponde a 5 MB. Questo valore può essere modificato in Dynamics 365 Customer Engagement (on-premises) tramite Impostazioni di sistema>scheda E-mail >Impostazione della dimensione massima del file per gli allegati. Per ulteriori informazioni, vedere Finestra di dialogo Impostazioni di sistema - scheda E-mail
   URL	Una volta salvata la risorsa Web, l'URL della risorsa Web verrà visualizzato qui. Selezionare questo collegamento per visualizzare la risorsa Web nel browser.

5. Dopo aver apportato le modifiche, scegli Salva, quindi Pubblica.

Nota

La pubblicazione delle personalizzazioni può interferire con il normale funzionamento del sistema. Si consiglia di pubblicare le personalizzazioni in un momento nel quale l'interruzione causerà disagi minimi agli utenti.

Utilizzare l'editor di testo nel modo appropriato

L'editor di testo fornito nell'applicazione per le risorse Web deve essere utilizzato solo per apportare modifiche semplici ai file di testo. È possibile utilizzarlo per creare e modificare risorse Web HTML, ma devono essere modificate solo le risorse Web HTML che sono state create utilizzando l'editor di testo. L'editor di testo è progettato per gestire contenuto HTML molto semplice. Se il contenuto di una risorsa Web HTML non è stato creato tramite l'editor di testo, non utilizzare l'editor di testo per modificarlo.

Nell'editor di testo viene utilizzato un controllo che modifica l'origine HTML in modo da consentirne la modifica. Queste modifiche possono modificare il comportamento della pagina nel browser e causare l'arresto di codice più sofisticato. L'apertura di una risorsa Web HTML con l'editor di testo e il salvataggio di questa senza l'apporto di modifiche possono interrompere alcune risorse Web HTML.

Si consiglia di utilizzare un editor esterno per modificare i file di testo e quindi salvarli localmente prima di caricarli con il pulsante Carica file. In questo modo si dispone di una copia della risorsa Web se si desidera tornare alla versione precedente. È possibile utilizzare un editor semplice come il Blocco note, ma si consiglia di utilizzare un editor di testo con funzionalità più avanzate. Visual Studio Express è gratuito e offre potenti funzionalità adatte per modificare i file utilizzati dalle risorse Web basate su testo.

Creare e modificare una risorsa Web in un modulo

È possibile aggiungere o modificare le risorse Web a un modulo per renderlo più utile per gli utenti. Assicurati di disporre del ruolo di sicurezza Amministratore di sistema o di privilegi equivalenti.

Nota

Non puoi includere una risorsa Web nell'intestazione o nel piè di pagina di un modulo.

1. Apri Esplora soluzioni.

2. In Componenti, espandere Entità, quindi espandere l'entità che si desidera utilizzare.

3. Scegliere Moduli, individuare un modulo di tipo Principale nell'elenco, quindi fare doppio clic o toccare la voce per aprire e modificare il modulo.

4. Per aggiungere una risorsa Web, selezionare la scheda (ad esempio Generale o Commenti) in cui si desidera inserirla, quindi nella scheda Inserisci, selezionare Risorsa Web.
   -OPPURE-
   Per modificare una risorsa Web, selezionare una scheda del modulo e la risorsa Web che si desidera modificare e quindi nella scheda Home selezionare Cambia proprietà.

5. Nella scheda Generale della finestra di dialogo Aggiungi risorsa Web o Proprietà risorsa Web immettere le informazioni appropriate nei campi richiesti. In particolare, prestare attenzione agli aspetti seguenti:

   • Nella casella Risorsa Web selezionare l'immagine, il file HTML o la risorsa Web Silverlight che si desidera utilizzare.

     Nota

     Dopo aver specificato una risorsa Web, la sezione Proprietà risorsa Web verrà visualizzata nella parte inferiore della scheda con le opzioni disponibili che variano in base al tipo di risorsa Web che si sta aggiungendo. Queste opzioni includono la specifica dei parametri personalizzati, la specifica di un codice del tipo di oggetto come parametro o di un testo alternativo che descrive la risorsa o, per le immagini, che rende l'immagine più accessibile a tutti gli utenti. Di seguito sono elencate alcune proprietà importanti. Per un elenco completo, vedere: Proprietà risorsa Web. - Nel campo Nome immettere un nome univoco per il campo. Il nome può contenere solo caratteri alfanumerici e di sottolineatura.

   • Il campo Etichetta viene popolato automaticamente con una variazione del nome specificato, è tuttavia necessario verificare che l'etichetta proposta soddisfi le esigenze o che venga aggiornata di conseguenza.

6. Nella scheda Formattazione, le opzioni disponibili variano in base al tipo di risorsa Web inserita. Queste opzioni includono la specifica del numero di colonne e di righe visualizzate, le visualizzazioni di un bordo e il comportamento di scorrimento.

7. Se viene visualizzata la scheda Dipendenze nella finestra di dialogo Aggiungi risorsa Web o Proprietà risorsa Web, selezionare i campi necessari per la risorsa Web nell'elenco Campi disponibili, selezionare il pulsante Aggiungi record selezionato per spostare i campi selezionati nell'elenco Campi dipendenti, quindi selezionare OK per chiudere la finestra di dialogo.

8. Al termine della modifica del modulo, selezionare Salva e chiudi nella scheda Home per chiudere il modulo. Per visualizzare in anteprima l'aspetto del modulo principale e verificare il funzionamento degli eventi:

   • Nella scheda Home selezionare Anteprima e quindi selezionare Crea modulo, Aggiorna modulo o Modulo di sola lettura.
   • Per chiudere il modulo Anteprima, scegliere Chiudi dal menu File.

9. Dopo aver completato le personalizzazioni, è possibile pubblicarle:

   • Per pubblicare le personalizzazioni solo per il componente in corso di modifica, nel riquadro di spostamento, selezionare l'entità su cui si sta lavorando e selezionare Pubblica.
   • Per pubblicare le personalizzazioni per tutti i componenti non pubblicati contemporaneamente, nel riquadro di spostamento, selezionare Entità, quindi, sulla barra degli strumenti Azioni, selezionare Pubblica tutte le personalizzazioni.

Aggiungere o modificare una risorsa Web di immagine

Le risorse Web sono file virtuali in molteplici formati, quali file html, applicazioni JavaScript e Silverlight, che vengono archiviati nel sistema e che possono essere recuperati utilizzando un indirizzo URL univoco.

1. Aprire Esplora soluzioni.

2. Per creare una nuova risorsa Web, scegliere Componenti>Risorse Web, quindi, nella barra degli strumenti Azioni, scegliere Nuovo.

3. Immettere o modificare le informazioni nelle caselle di testo.

   • Il nome immesso nella casella di testo Nome insieme all'estensione di file diventerà il nome del file.

   • Il nome immesso nella casella di testo Nome visualizzato sarà visualizzato in Nome visualizzato.

   • Nella casella di riepilogo a discesa Tipo selezionare il tipo di file desiderato.

4. Scegliere Sfoglia per selezionare e caricare il file dal computer locale.

   • Per visualizzare l'anteprima di una risorsa Web immagine caricata: scegliere Risorsa Web>Anteprima.

   • Per modificare una risorsa Web testo: scegliere Editor di testo.

   • Per visualizzare l'anteprima di una risorsa Web test: scegliere Risorsa Web>Anteprima.

5. Quando si è pronti per salvare i dati, scegliere Salva e chiudi.

6. Pubblicare la personalizzazione.

   • Solo per il componente modificato: scegliere Salva>Pubblica sulla pagina Home.

   • Per tutti i componenti non pubblicati contemporaneamente, scegliere Pubblica tutte le personalizzazioni.

Nota

L'installazione di una soluzione e la pubblicazione di personalizzazioni possono interferire con il regolare funzionamento del sistema. Si consiglia di pianificare l'importazione di una soluzione in un momento nel quale l'interruzione causerà disagi minimi agli utenti.

Vedi anche

Proprietà delle risorse Web
Creare e progettare i moduli
Introduzione alla personalizzazione
Risorse Web per Customer Engagement