Procedura dettagliata: distribuzione di una personalizzazione a livello di documento tramite un manifesto di distribuzione (System 2003)

Articolo
04/28/2010

Aggiornamento: novembre 2007

Si applica a
Le informazioni contenute in questo argomento riguardano solo i progetti Visual Studio Tools per Office e le versioni di Microsoft Office specificati. Tipo di progetto Progetti a livello di documento Versione Microsoft Office Microsoft Office 2003 Per ulteriori informazioni, vedere la classe Funzionalità disponibili in base ai tipi di progetto e applicazione.

Le informazioni contenute in questo argomento riguardano solo i progetti Visual Studio Tools per Office e le versioni di Microsoft Office specificati.

Tipo di progetto

Progetti a livello di documento

Versione Microsoft Office

Microsoft Office 2003

Per ulteriori informazioni, vedere la classe Funzionalità disponibili in base ai tipi di progetto e applicazione.

In questa procedura dettagliata viene illustrato come distribuire una personalizzazione a livello di documento per Microsoft Office Excel o Microsoft Office Word in una condivisione di rete su un server. Al termine della procedura dettagliata, sarà possibile eseguire la soluzione sul server dal computer di sviluppo. Per ulteriori informazioni sulle personalizzazioni a livello di documento, vedere Architettura delle personalizzazioni a livello di documento.

In un ambiente di produzione in genere una soluzione Visual Studio Tools per Office viene pubblicata innanzitutto su un server di prova, quindi viene ridistribuita su un server di produzione dopo essere stata approvata dal reparto IT. In questa procedura dettagliata verrà pubblicata una soluzione in un percorso temporaneo nel computer di sviluppo, quindi ridistribuita tale soluzione dal percorso temporaneo a un server. Per ulteriori informazioni sui diversi modi in cui è possibile distribuire una soluzione, vedere Modelli di distribuzione (2003 System).

In questa procedura dettagliata vengono illustrate le attività seguenti:

Utilizzo della Pubblicazione guidata per pubblicare la soluzione in un percorso nel computer di sviluppo.
Ridistribuzione manuale della soluzione dal computer locale a una condivisione di rete su un server.
Modifica a livello di codice del manifesto dell' applicazione incorporato nel documento in modo che punti al nuovo percorso del manifesto di distribuzione.
Modifica del manifesto di distribuzione in modo che punti al nuovo percorso del manifesto dell'applicazione esterno.
Modifica del manifesto dell'applicazione esterno in modo che punti al nuovo percorso dell'assembly e al manifesto di distribuzione.

Prerequisiti

Per completare questa procedura dettagliata, è necessario disporre dei seguenti componenti:

Visual Studio Tools per Office (componente facoltativo di Visual Studio 2008 Professional e Visual Studio Team System).

Microsoft Office Word 2003 o Microsoft Office Excel 2003.

Nota:
In questa procedura dettagliata si presuppone che venga distribuita una soluzione Word. Se si desidera eseguire la procedura dettagliata con una soluzione Excel, sostituire il nome del progetto Word con il nome del progetto Excel in tutti gli esempi di codice e XML.

Accesso a un server di rete per la distribuzione. In questa procedura dettagliata si presuppone che la soluzione venga ridistribuita nella condivisione di rete \\DeployServer\ShareFolder.
Privilegi di amministratore nel computer di sviluppo in modo da poter impostare i criteri di sicurezza per un percorso di rete.

Creazione del progetto

In questo passaggio creare un progetto Documento di Word.

Per creare un nuovo progetto

Creare un progetto Documento di Word con il nome WordDeployment, utilizzando il modello di progetto per Office 2003.

Nella procedura guidata, scegliere Crea un nuovo documento. Per ulteriori informazioni, vedere la classe Procedura: creare progetti Visual Studio Tools per Office.

Il nuovo documento di Word verrà aperto nella finestra di progettazione di Visual Studio e il progetto WordDeployment verrà aggiunto a Esplora soluzioni.

Aggiunta del codice su cui si basa il documento

Il progetto richiede del codice in modo da verificare che la soluzione funzioni correttamente all'apertura del documento. Per questa procedura dettagliata, aggiungere una finestra di messaggio al gestore eventi Startup del documento.

Per aggiungere una finestra di messaggio a un evento di inizializzazione

In Esplora soluzioni fare clic con il pulsante destro del mouse su ThisDocument.vb o ThisDocument.cs, quindi scegliere Visualizza codice dal menu di scelta rapida.

Aggiungere il codice riportato di seguito nel gestore eventi Startup all'interno della classe ThisDocument per visualizzare una finestra di messaggio durante l'inizializzazione.

Private Sub ThisDocument_Startup(ByVal sender As Object, ByVal e As System.EventArgs) _
    Handles Me.Startup

    MessageBox.Show("The document is deployed correctly.")
End Sub

private void ThisDocument_Startup(object sender, System.EventArgs e)
{
    MessageBox.Show("The document is deployed correctly.");
}

Premere F5 per eseguire il progetto.

Verrà visualizzata la finestra di messaggio all'avvio di Word.
Chiudere la finestra di messaggio.
Uscire da Word.

Pubblicazione della soluzione

Il primo passaggio relativo alla distribuzione di tale processo è di pubblicare la soluzione in un percorso temporaneo nel computer locale.

Per pubblicare la soluzione

Fare clic con il pulsante destro del mouse sul nodo del progetto in Esplora soluzioni.
Scegliere Pubblica dal menu di scelta rapida.

Verrà visualizzata la Pubblicazione guidata.
Nella casella Specificare il percorso in cui pubblicare l'applicazione digitare C:\TestDeploy.
Fare clic su Fine.

Il documento della soluzione e il manifesto di distribuzione verranno copiati in C:\TestDeploy. L'assembly della soluzione, il manifesto di applicazione aggiornato e le copie del documento della soluzione e del manifesto di distribuzione verranno copiati in C:\TestDeploy\WordDeployment_1.0.0.0. Per ulteriori informazioni, vedere la classe Distribuzione delle personalizzazioni a livello di documento (2003 System).

Dal menu File fare clic su Chiudi soluzione per chiudere la soluzione WordDeployment in Visual Studio.

Nota:
L'assembly non dispone ancora dell'autorizzazione per l'esecuzione, pertanto, se si tenta di eseguire la soluzione verrà restituito un errore. Il criterio di sicurezza verrà aggiornato per assegnare autorizzazioni di attendibilità totale all'assembly in una fase successiva.

Quando si pubblica una soluzione, il manifesto di applicazione incorporato nel documento della soluzione punta al percorso completo del manifesto di distribuzione. Se si ridistribuiscono i file di soluzione in un altro percorso, è necessario aggiornare il manifesto di applicazione incorporato in modo che punti al nuovo percorso del manifesto di distribuzione. È inoltre necessario aggiornare il manifesto di distribuzione e il manifesto di applicazione esterno in modo che puntino ai nuovi percorsi dei file.

Aggiornamento del manifesto di applicazione incorporato

Per modificare il manifesto dell'applicazione incorporato, utilizzare la classe ServerDocument fornita da Visual Studio Tools per Office. Quando si utilizza la classe ServerDocument, il codice deve essere eseguito in un nuovo progetto, ad esempio in un progetto console, anziché nella soluzione Visual Studio Tools per Office e il documento della soluzione Visual Studio Tools per Office deve essere chiuso.

Nota:
In Visual Studio Tools per Office è incluso un esempio in cui viene illustrato come creare uno strumento per modificare il manifesto dell'applicazione incorporato. Per ulteriori informazioni, vedere la classe Esempio ServerDocument.

Per aggiornare il manifesto di applicazione incorporato

Creare un nuovo progetto Applicazione console.
Aggiungere al progetto riferimenti agli assembly Microsoft.VisualStudio.Tools.Applications.Runtime e System.Windows.Forms.
Aprire il file Program.cs o Module1.vb, quindi aggiungere all'inizio del file l'istruzione Imports o using riportata di seguito.
```
Imports Microsoft.VisualStudio.Tools.Applications.Runtime
```
```
using Microsoft.VisualStudio.Tools.Applications.Runtime;
```

Copiare il codice riportato di seguito nella funzione Main. Questo codice crea un oggetto ServerDocument che fornisce l'accesso al manifesto di applicazione incorporato del documento della soluzione. Il codice assegna il nuovo percorso del manifesto di distribuzione alla proprietà DeployManifestPath, quindi salva e chiude l'oggetto ServerDocument.

Dim sd As ServerDocument = Nothing
Try
    sd = New ServerDocument("C:\TestDeploy\WordDeployment.doc")
    sd.AppManifest.DeployManifestPath = _
        "\\DeployServer\ShareFolder\WordDeployment.application"
    sd.Save()

Finally
    If Not sd Is Nothing Then
        sd.Close()
    End If
End Try

ServerDocument sd = null;
try
{
    sd = new ServerDocument(@"C:\TestDeploy\WordDeployment.doc");
    sd.AppManifest.DeployManifestPath = 
        @"\\DeployServer\ShareFolder\WordDeployment.application";
    sd.Save();
}
finally
{
    if (sd != null)
    {
        sd.Close();
    }
}

Premere F5 per eseguire il progetto.

Durante l'aggiornamento del manifesto di applicazione incorporato verrà visualizzata brevemente e quindi chiusa la finestra della console.

Aggiornamento del manifesto di distribuzione

Dopo aver aggiornato nel documento della soluzione Visual Studio Tools per Office il manifesto dell'applicazione incorporato, è necessario aggiornare il manifesto di distribuzione in modo che punti al nuovo percorso del manifesto dell'applicazione esterno.

Per aggiornare il manifesto di distribuzione

Aprire il manifesto di distribuzione in un editor di testo quale il Blocco note. Il manifesto di distribuzione è contenuto nella cartella di pubblicazione C:\TestDeploy. È denominato WordDeployment.application.
Impostare l'attributo codebase dell'elemento <dependentAssembly> sul percorso di distribuzione finale completo del manifesto di applicazione esterno. Per ulteriori informazioni, vedere la classe Elemento <dependentAssembly> (Riferimento Visual Studio Tools per Office). L'attributo per questa procedura dettagliata deve essere simile all'esempio riportato di seguito.
```
<dependentAssembly
    codebase="\\DeployServer\ShareFolder\
    WordDeployment_1.0.0.0\WordDeployment.dll.manifest"
```
Salvare e chiudere il file del manifesto di distribuzione.

Aggiornamento del manifesto di applicazione esterno

Oltre ad aggiornare il manifesto di distribuzione, è necessario inoltre modificare il manifesto dell'applicazione esterno in modo che punti al percorso di distribuzione finale dell'assembly della soluzione e del manifesto di distribuzione. Ogni volta che si pubblica una soluzione Visual Studio Tools per Office, viene generato un nuovo manifesto dell'applicazione esterno che punta alla versione corrente dell'assembly della soluzione.

Per aggiornare il manifesto di applicazione esterno

Aprire il manifesto di applicazione in un editor di testo quale il Blocco note. Il manifesto dell'applicazione è contenuto nella cartella di pubblicazione C:\TestDeploy\WordDeployment_1.0.0.0. È denominato WordDeployment.dll.manifest.
Individuare l'elemento <installFrom> figlio dell'elemento <dependency> e impostare l'attributo codebase sul percorso completo dell'assembly della soluzione corrente. Per ulteriori informazioni, vedere la classe Elemento <installFrom> (Riferimenti a Visual Studio Tools per Office). L'attributo per questa procedura dettagliata deve essere simile all'esempio riportato di seguito.
```
<dependentAssembly
    codebase="\\DeployServer\ShareFolder\
    WordDeployment_1.0.0.0\WordDeployment.dll"
```
Individuare l'elemento <installFrom> figlio dell'elemento <assembly> e impostare l'attributo codebase sul percorso completo del manifesto di distribuzione. Per ulteriori informazioni, vedere la classe Elemento <installFrom> (Riferimenti a Visual Studio Tools per Office). L'attributo per questa procedura dettagliata deve essere simile all'esempio riportato di seguito.
```
<dependentAssembly
    codebase="\\DeployServer\ShareFolder\WordDeployment.application"
```
Salvare e chiudere il file del manifesto di applicazione.

Copia dei file di soluzione sul server

Dopo aver modificato i manifesti, è possibile copiare i file di soluzione nella destinazione di distribuzione finale sul server.

Per copiare i file di soluzione sul server

Creare una cartella WordDeployment_1.0.0.0 nella condivisione file di rete \\DeployServer\ShareFolder.
Copiare il documento della soluzione e il manifesto di distribuzione in \\DeployServer\ShareFolder.
Copiare l'assembly della soluzione e il manifesto di applicazione in \\DeployServer\ShareFolder\WordDeployment_1.0.0.0.

Concessione dell'attendibilità totale alla cartella di rete

Per eseguire la soluzione Visual Studio Tools per Office dalla cartella di rete, è necessario concedere l'attendibilità totale alla cartella di rete nei criteri di sicurezza nel computer di sviluppo. È possibile modificare i criteri di sicurezza da un prompt dei comandi utilizzando lo strumento Criteri di sicurezza dall'accesso di codice, ovvero Caspol.exe. Per concedere l'attendibilità a un percorso di rete, è necessario disporre dri privilegi di amministratore e modificare i criteri di sicurezza a livello di computer.

Nota:
Le operazioni qui descritte vengono eseguite esclusivamente ai fini di questa procedura dettagliata. Eseguirle per concedere l'attendibilità ad assembly o directory solo se si è certi che siano sicuri e protetti. Per ulteriori informazioni sulla concessione e la rimozione di autorizzazioni, vedere Procedura: concedere autorizzazioni a cartelle e assembly (System 2003) e Procedura: rimuovere autorizzazioni da cartelle e assembly (System 2003).

Le operazioni qui descritte vengono eseguite esclusivamente ai fini di questa procedura dettagliata. Eseguirle per concedere l'attendibilità ad assembly o directory solo se si è certi che siano sicuri e protetti. Per ulteriori informazioni sulla concessione e la rimozione di autorizzazioni, vedere Procedura: concedere autorizzazioni a cartelle e assembly (System 2003) e Procedura: rimuovere autorizzazioni da cartelle e assembly (System 2003).

Per concedere l'attendibilità totale alla cartella di rete

Digitare il seguente comando al prompt dei comandi di Visual Studio:

caspol -m -ag LocalIntranet_Zone -url \\DeployServer\ShareFolder\* FullTrust -n "Remote Deployment" -d "Deployment Walkthrough"

Verifica della soluzione

È ora possibile verificare il funzionamento della soluzione per assicurarsi che il codice venga eseguito quando si apre il documento dal computer di sviluppo.

Per verificare il funzionamento della distribuzione

Nel computer di sviluppo aprire il file WordDeployment.doc in \\DeployServer\ShareFolder\.
Verificare che venga visualizzata la finestra di messaggio.

Passaggi successivi

La soluzione può essere distribuita anche utilizzando un file di Microsoft Windows Installer (con estensione MSI). Per ulteriori informazioni, vedere la classe Procedura dettagliata: distribuzione di una personalizzazione a livello di documento tramite un file di Windows Installer (System 2003).

Vedere anche

Attività

Procedura dettagliata: distribuzione di una personalizzazione a livello di documento tramite un file di Windows Installer (System 2003)

Concetti

Distribuzione di soluzioni Office (System 2003)

Distribuzione delle personalizzazioni a livello di documento (2003 System)

Modelli di distribuzione (2003 System)

Condividi tramite