Procedura: modificare la posizione delle personalizzazioni a livello di documento (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.

Quando si modifica il percorso di una soluzione a livello di documento distribuita, questa viene ridistribuita. Si supponga, ad esempio che uno sviluppatore abbia pubblicato una soluzione su un server di test. Il reparto IT ridistribuirà la soluzione a un server di produzione dopo l'approvazione. Per continuare a utilizzare le soluzioni Visual Studio Tools per Office, è necessario aggiornare i manifesti dell'applicazione e quelli di distribuzione con il nuovo percorso dei file di soluzione.

Sono disponibili due tipi di scenari di ridistribuzione per le soluzioni Word ed Excel:

Modifica del manifesto dell'applicazione direttamente nel documento, mediante codice.

Questo scenario è utile nelle seguenti circostanze:
- Prima che la soluzione venga distribuita agli utenti finali.
- Quando il server obsoleto viene improvvisamente messo fuori servizio e gli utenti finali non possono accedere ai file memorizzati su tale server.
- Quando pochi utenti finali utilizzano la soluzione ed è semplice creare uno script per aggiornare il documento di ciascun utente.
Modifica dei file manifesto sul server senza utilizzare codice per l'aggiornamento del manifesto dell'applicazione nel documento.

Questo scenario è utile nelle seguenti circostanze:
- Dopo che è stata distribuita la soluzione agli utenti finali.
- Quando il server precedente è ancora disponibile a tutti gli utenti finali.
- Quando molti utenti finali utilizzano la soluzione ed è difficile eseguire script sul documento di ciascun utente.

Nota:
Nel computer in uso è possibile che vengano visualizzati nomi o percorsi diversi per alcuni elementi dell'interfaccia utente di Visual Studio nelle istruzioni seguenti. La versione di Visual Studio in uso e le impostazioni configurate determinano questi elementi. Per ulteriori informazioni vedere Impostazioni di Visual Studio.

Modifica del manifesto dell'applicazione mediante codice

Per effettuare la ridistribuzione utilizzando codice per la modifica del manifesto dell'applicazione

Utilizzare la Pubblicazione guidata per pubblicare la soluzione sul server di test. Per ulteriori informazioni, vedere la classe Procedura: distribuire file di soluzione utilizzando la Pubblicazione guidata (2003 System).

Con la Pubblicazione guidata, i documenti e gli assembly vengono copiati sul server e vengono creati i manifesti di applicazione e di distribuzione.
Copiare il manifesto dell'applicazione, gli assembly e il manifesto di distribuzione nel nuovo percorso.

A questo punto sono disponibili due insiemi di file, uno sul server obsoleto e uno sul nuovo server.
Modificare il nuovo manifesto dell'applicazione in modo che faccia riferimento al nuovo manifesto di distribuzione e ai nuovi assembly. Per ulteriori informazioni, vedere la classe Manifesti dell'applicazione per le soluzioni Office (System 2003).
Aumentare il numero di versione del manifesto dell'applicazione.
Modificare il nuovo manifesto di distribuzione in modo che faccia riferimento al nuovo manifesto dell'applicazione. Per ulteriori informazioni, vedere la classe Manifesti di distribuzione per le soluzioni Office (System 2003).
Aumentare il numero di versione del nuovo manifesto di distribuzione.

Aggiornare il manifesto dell'applicazione incorporato nel documento affinché faccia riferimento al nuovo percorso del manifesto di distribuzione. Per ulteriori informazioni, vedere la classe Procedura: modificare il percorso del manifesto di distribuzione a livello di codice (System 2003).

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

Modifica dei manifesti senza codice

Per effettuare la ridistribuzione modificando i file sul server

Utilizzare la Pubblicazione guidata per pubblicare la soluzione nel server di test. Per ulteriori informazioni, vedere la classe Procedura: distribuire file di soluzione utilizzando la Pubblicazione guidata (2003 System).

Con la Pubblicazione guidata, i documenti e gli assembly vengono copiati sul server e vengono creati i manifesti di applicazione e di distribuzione.
Copiare il manifesto dell'applicazione, gli assembly e il manifesto di distribuzione nel nuovo percorso.

A questo punto sono disponibili due insiemi di file: uno sul server obsoleto e uno sul nuovo server.
Modificare il nuovo manifesto dell'applicazione in modo che faccia riferimento al nuovo manifesto di distribuzione e ai nuovi assembly. Per ulteriori informazioni, vedere la classe Manifesti dell'applicazione per le soluzioni Office (System 2003).
Aumentare il numero di versione del manifesto dell'applicazione.
Modificare il nuovo manifesto di distribuzione in modo che faccia riferimento al nuovo manifesto dell'applicazione. Per ulteriori informazioni, vedere la classe Manifesti di distribuzione per le soluzioni Office (System 2003).
Aumentare il numero di versione del nuovo manifesto di distribuzione.
Modificare il manifesto di distribuzione precedente in modo che faccia riferimento al nuovo manifesto dell'applicazione.
Aumentare il numero di versione del manifesto di distribuzione precedente.

La prossima volta che sarà aperto da un utente finale, il documento della soluzione verificherà il manifesto di distribuzione precedente e sarà reindirizzato al nuovo manifesto dell'applicazione. Scaricherà quindi il nuovo manifesto dell'applicazione contenente i puntatori ai nuovi assembly e al nuovo manifesto di distribuzione e utilizzerà i file nei nuovi percorsi.