Procedura: generare report di distribuzione

Aggiornamento: novembre 2007

In Progettazione distribuzione è possibile impostare le proprietà di un report di distribuzione e quindi generare tale report a partire da un diagramma distribuzione. I report di distribuzione sono progettati per facilitare la creazione di uno script di installazione a partire da informazioni XML strutturate contenute nel report. Nel report, oltre alle necessarie impostazioni di configurazione riguardanti applicazioni e datacenter, è contenuto un elenco di tutti i metadati SDM (System Definition Model) che costituiscono la convalida della distribuzione. Questi metadati SDM sono forniti dal livello dell'applicazione e dal livello di hosting dell'applicazione e descrivono la maggior parte delle informazioni necessarie alla distribuzione di un'applicazione. Per ulteriori informazioni, vedere Cenni preliminari sui report di distribuzione.

Nota:

Si sconsiglia di completare una definizione di distribuzione utilizzando dei diagrammi distribuzione o dei report di distribuzione generati a partire da sistemi predefiniti. Benché tali sistemi siano utili per valutare rapidamente la distribuzione di singole applicazioni nel datacenter, non è opportuno utilizzarli per la distribuzione finale. Per ulteriori informazioni, vedere Definizioni di distribuzione create nei diagrammi applicazioni e sistema.

Per impostare le proprietà di un report di distribuzione

1. Fare clic sulla superficie diagramma distribuzione per selezionarlo.

2. Nella finestra Proprietà, impostare la proprietà Percorso di destinazione.

   Suggerimento:
   Se la finestra Proprietà non è aperta, premere F4 o scegliere Finestra Proprietà dal menu Visualizza.

   Questa proprietà indica il percorso in cui i file di progetto verranno copiati se le proprietà Includi file di dati, Includi file di origine o Includi file binari sono impostate su True.

   Nota:
   La proprietà Percorso di destinazione deve essere impostata soltanto se almeno una delle proprietà Includi file di dati, Includi file di origine o Includi file binari è impostata su True La proprietà Percorso di destinazione non ha un valore predefinito.

3. Impostare la proprietà Includi file di dati.

   Questa proprietà indica quali file di dati verranno inclusi nel report di distribuzione e copiati nella directory del percorso di destinazione per essere utilizzati negli script.

   Se si sceglie True verranno inclusi i tipi di file elencati di seguito:

   • Progetti Web: file di codice, file di progetto, file di risorsa, file con estensione CONFIG, assembly di riferimento, file SDM e tutti gli altri file che non siano di origine o binari, quali ad esempio i file con estensione XSD, DISCO e WSDL.

   • Progetti Windows: file SDM, assembly presenti nella cartella della soluzione e tutti gli altri file che non siano di origine o binari.

   • Progetti Office: file SDM, assembly presenti nella cartella della soluzione e tutti gli altri file che non siano di origine o binari.

4. Impostare la proprietà Includi file di origine.

   Questa proprietà indica quali file di origine verranno inclusi nel report di distribuzione e copiati nella directory del percorso di destinazione.

   Se si sceglie True verranno inclusi i tipi di file elencati di seguito:

   • Progetti Web: nessun file.

   • Progetti Windows: file di codice, file di progetto, file di risorsa e file con estensione CONFIG.

   • Progetti Office: file di codice, file di progetto, file di risorsa e file con estensione CONFIG.

5. Impostare la proprietà Includi file binari.

   Questa proprietà indica quali file binari verranno inclusi nel report di distribuzione e copiati nella directory del percorso di destinazione.

   Se si sceglie True verranno inclusi i tipi di file elencati di seguito:

   • Progetti Web: nessun file.

   • Progetti Windows: file eseguibili e file App.config. Questi ultimi vengono inclusi anche se si imposta la proprietà Includi file di origine su True.

   • Progetti Office: assembly generati e file App.config. Questi ultimi vengono inclusi anche se si imposta la proprietà Includi file di origine su True.

6. Per includere delle immagini di diagramma nel report di distribuzione in formato HTML, impostare l'opzione Includi diagrammi su True (impostazione predefinita).

7. Per evitare di ricevere una notifica prima di sovrascrivere i file, impostare la proprietà Azione Sovrascrivi file su Sì.

8. Impostare la proprietà Risoluzione errore su Chiedi conferma, Ignora o Interrompi.

   Se il report di distribuzione viene generato mediante l'automazione, impostare questa proprietà su Ignora se si desidera creare il report anche nel caso in cui si verifichino degli errori. Se si desidera che la creazione del report venga interrotta in caso di errore, impostare questa proprietà su Interrompi.

9. Impostare la proprietà Solo errori su uno dei seguenti valori:

   • True

     Il report in formato HTML conterrà soltanto un elenco di errori e avvisi di convalida.

   • False

     Il report HTML conterrà tutti gli altri dati (endpoint, impostazioni, risorse, ecc.) oltre all'elenco degli errori e degli avvisi di convalida.

     Nota:
     In alcuni casi il testo degli errori contenuto nel report di distribuzione non corrisponde al testo degli errori contenuto nella finestra Elenco errori.

A questo punto è possibile generare un report di distribuzione.

Per generare un report di distribuzione

1. Dopo aver impostato tutte le proprietà del report di distribuzione, scegliere Genera report distribuzione dal menu Diagramma.

   Suggerimento:
   È anche possibile fare clic con il pulsante destro del mouse sulla superficie diagramma distribuzione, quindi selezionare Genera report distribuzione.

2. Se per il diagramma distribuzione esiste già un report e la proprietà Azione Sovrascrivi file non è impostata su Sì, verrà visualizzato un messaggio in cui si richiede di confermare la sovrascrittura del report esistente.

   Nota:
   Solo i report già esistenti vengono sovrascritti. Gli altri file e directory, invece, non subiscono alcuna modifica. In questo modo vengono conservati tutti gli eventuali file aggiuntivi inclusi nella struttura della directory. Per evitare di ricevere in futuro la notifica riguardo la sovrascrittura dei file, impostare la proprietà Azione Sovrascrivi file su Sì.

   Quando richiesto, scegliere una delle opzioni elencate di seguito:

   • Sì: il file corrente verrà sovrascritto e, qualora la stessa situazione si verifichi nuovamente, verrà visualizzato un messaggio di richiesta di conferma.

   • No: il file corrente non verrà sovrascritto e, qualora la stessa situazione si verifichi nuovamente, verrà visualizzato un messaggio di richiesta di conferma.

   • Annulla: il processo di generazione del report verrà interrotto.

   In Progettazione distribuzione è prevista la generazione di due report di distribuzione in Esplora soluzioni: uno in formato HTML (estensione HTML) e l'altro in formato XML (estensione XML). Al termine della generazione del report, sia il file HTML sia il file XML vengono aggiunti nella cartella della soluzione del sistema associato al diagramma distribuzione.

I report in formato HTML e XML contengono per lo più le stesse informazioni. Tuttavia, nel report in formato HTML sono contenute anche delle immagini di diagrammi della soluzione e un elenco di proprietari. Inoltre, nel report in formato HTML non sono contenute le risorse i cui valori predefiniti sono impostati su NULL e non sono stati modificati. Nel report in formato XML, invece, queste risorse sono disponibili e possono essere utilizzate negli script.

E' possibile generare i report di distribuzione anche in modo automatico tramite Visual Studio oppure mediante una voce della riga di comando. Per ulteriori informazioni, vedere Procedura: utilizzare l'automazione con report distribuzione e Procedura: creare report di distribuzione dalla riga di comando.

Nota:

Quando un'applicazione è in esecuzione, vengono cercate le impostazioni nel file denominato <nomeapp>.exe.config. Se questo file non è presente, è possibile che l'applicazione non funzioni correttamente. Nel report di distribuzione non viene copiato né elencato <nomeapp>.exe.config, ma viene incluso solo app.config, che è una copia di <nomeapp>.exe.config. Per risolvere questo problema, verificare che app.config venga rinominato correttamente dallo script di distribuzione.

Sicurezza

Nel report di distribuzione possono essere contenuti dei dati aziendali o istituzionali sensibili o riservati. Di conseguenza, tali report devono essere inviati o eliminati con estrema cautela.

Nota:
Quando la proprietà Includi file di origine o la proprietà Includi file di dati è impostata su True verrà visualizzato un messaggio in cui si avvisa che la directory di output potrebbe non essere protetta.

Vedere anche

Attività

Procedura: personalizzare report distribuzione

Concetti

Cenni preliminari sui report di distribuzione