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.

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 di Dynamics 365 Customer Engagement (on-premises)>/WebResources/new_myWebResource.htm

dove <URL> app è l'URL che usi solitamente 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 risorse Web

1. Aprire Esplora soluzioni e quindi selezionare 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 della risorsa Web include i campi e le funzionalità seguenti:

   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 verrà 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.
   Lingua	Consente di selezionare una lingua. Questa opzione contrassegna semplicemente il record che memorizza i dati della risorsa Web. Non modifica il comportamento della risorsa Web.
   Carica il file	Selezionare 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, la dimensione massima del file che può essere caricata come risorsa Web è di 5 MB. Questo valore può essere modificato in Dynamics 365 Customer Engagement (on-premises) utilizzando l'impostazione Impostazioni di sistema>E-mail della scheda >Imposta limite dimensioni 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 aggiunto le modifiche, scegliere Salva e quindi Pubblica.

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à per la modifica dei file utilizzati dalle risorse Web basate su testo.

Creare e modificare una risorsa Web in un modulo

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

1. Apri Esplora soluzioni.

2. In Componenti espandere Entità e 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 Note) in cui si desidera inserirla e quindi nella scheda Inserisci selezionare Risorsa Web.
   -O-
   Per modificare una risorsa Web, selezionare una scheda del modulo e la risorsa Web che si desidera modificare, quindi nella scheda Home selezionare Modifica proprietà.

5. Nella finestra di dialogo Aggiungi risorsa Web o Proprietà risorsa Web , nella scheda Generale , immettere le informazioni appropriate nei campi obbligatori. In particolare, si noti quanto segue:

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

     Annotazioni

     Dopo aver specificato una risorsa Web, nella parte inferiore di questa scheda viene visualizzata la sezione Proprietà risorsa Web , che fornisce opzioni che variano in base al tipo di risorsa Web che si sta aggiungendo. Queste opzioni includono la specifica di parametri personalizzati, il passaggio di un codice di tipo oggetto record come parametro o la specifica di testo alternativo che descriva la risorsa o, per le immagini, che renda l'immagine più accessibile a tutti gli utenti. Ecco alcune proprietà importanti. Per un elenco completo, vedere: Proprietà delle risorse Web. - Nella casella Nome , inserisci un nome univoco per il campo. Il nome può contenere solo caratteri alfanumerici e di sottolineatura.

   • Il campo Etichetta viene compilato automaticamente con una variante del nome specificato, ma assicurati che l'etichetta proposta soddisfi le tue esigenze o aggiornala di conseguenza.

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

7. Se nella finestra di dialogo Aggiungi risorsa Web o Proprietà risorsa Web viene visualizzata la scheda Dipendenze, nell'elenco Campi disponibili selezionare i campi richiesti dalla risorsa Web, selezionare il pulsante Aggiungi record selezionati per spostare i campi selezionati nell'elenco Campi dipendenti e 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 che stai modificando, nel riquadro di spostamento seleziona l'entità su cui stai lavorando, quindi seleziona 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 immagine

Le risorse Web sono file virtuali in più formati, ad esempio file html, applicazioni JavaScript e Silverlight, archiviati nel sistema e recuperabili utilizzando un indirizzo URL univoco.

1. Apri Esplora soluzioni.

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

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

   • Il nome immesso nella casella di testo Nome , più l'estensione del file, diventerà il nome del file.

   • Il nome immesso nella casella di testo Nome visualizzato verrà visualizzato nel nome visualizzato.

   • Nella casella 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: Scegli Risorsa Web>Anteprima.

   • Per modificare una risorsa web di testo: scegli Editor di testo.

   • Per visualizzare l'anteprima di una risorsa Web di testo: Scegli Risorsa Web>Anteprima.

5. Quando sei pronto per salvare i tuoi dati, scegli Salva e chiudi.

6. Pubblicare la personalizzazione.

   • Solo per il componente modificato: scegli Salva>Pubblica nella Home.

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

Vedere anche

Proprietà risorsa Web
Creare e progettare i moduli
Inizia con la personalizzazione
Risorse Web per Customer Engagement