Condividi tramite


Distribuzione delle personalizzazioni a livello di documento (2003 System)

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.

Per distribuire una personalizzazione a livello di documento per Microsoft Office Word 2003 o Microsoft Office Excel 2003 in genere è necessario utilizzare quattro file:

  • Il file di Word o di Excel, ovvero modello, documento o cartella di lavoro, su cui lavora l'utente finale.

  • L'assembly contenente il codice personalizzato compilato e gli eventuali assembly dipendenti, ad esempio risorse, satelliti o librerie di supporto.

  • L'eventuale manifesto di distribuzione.

  • L'eventuale manifesto di applicazione.

Quando si distribuisce la soluzione, considerare le seguenti linee guida di base:

Per distribuire la soluzione, copiare il documento, l'assembly ed eventualmente i manifesti di applicazione e di distribuzione nel percorso di distribuzione. Per ulteriori informazioni sui tipi di distribuzione, vedere Modelli di distribuzione (2003 System).

In Visual Studio Tools per Office è inclusa la Pubblicazione guidata, che consente di creare i manifesti di applicazione e di distribuzione, nonché di copiare automaticamente tutti i file nel percorso di distribuzione. Queste operazioni possono comunque essere eseguite anche manualmente. Per ulteriori informazioni, vedere°Procedura: distribuire le soluzioni Office (2003 System) e Procedura: distribuire file di soluzione utilizzando la Pubblicazione guidata (2003 System).

Pubblicazione guidata

Il comando Pubblica del menu di scelta rapida del progetto in Esplora soluzioni consente di avviare la Pubblicazione guidata. Identificare il percorso della cartella in cui si desidera pubblicare la soluzione. Il documento e il manifesto di distribuzione verranno copiati automaticamente in tale cartella. Per ulteriori informazioni, vedere la classe Procedura: distribuire file di soluzione utilizzando la Pubblicazione guidata (2003 System).

Gli assembly e un manifesto di applicazione aggiornato vengono inoltre copiati in una sottocartella della cartella di distribuzione principale. La sottocartella contiene un numero di versione. Se si seleziona l'opzione Incrementa automaticamente revisione a ogni rilascio nel riquadro Pubblica di Progettazione progetti, verrà creata una nuova sottocartella ogni volta che si pubblica la soluzione. Le versioni precedente rimangono disponibili. I manifesti di applicazione e di distribuzione garantiscono sempre l'utilizzo dell'assembly corrente da parte della soluzione. Per ulteriori informazioni, vedere Manifesti dell'applicazione e di distribuzione nelle soluzioni di Office, Procedura: distribuire file di soluzione utilizzando la Pubblicazione guidata (2003 System), Pagina Pubblica, Progettazione progetti (System 2003) e Pubblicazione guidata (System 2003).

Aggiornamento degli assembly distribuiti (controllo delle versioni)

Se si distribuisce una soluzione denominata ExcelWorkbook1 nella cartella C:\DeployFolder, la struttura di file sarà simile alla seguente:

C:\DeployFolder

Questa cartella contiene i due file e la sottocartella indicati di seguito:

  • La cartella di lavoro (ExcelWorkbook1.xls).

  • Il manifesto di distribuzione (ExcelWorkbook1.application).

    C:\DeployFolder\ExcelApplication1_1.0.0.0

    La cartella contiene i file seguenti:

    • Gli assembly.

    • Il manifesto di applicazione (ExcelWorkbook1.dll.manifest).

    • Una copia della cartella di lavoro.

    • Una copia del manifesto di distribuzione.

Se si aggiorna l'assembly e si ripubblica la soluzione, la struttura di directory risulterà simile alla seguente:

C:\DeployFolder

Questa cartella contiene i due file e le sottocartelle indicati di seguito:

  • La cartella di lavoro, con un manifesto di applicazione incorporato aggiornato.

  • Il manifesto di distribuzione, aggiornato in modo da puntare al manifesto di applicazione in C:\DeployFolder\ExcelWorkbook1_1.0.0.1.

    C:\DeployFolder\ExcelWorkbook1_1.0.0.0

    La cartella contiene i file seguenti:

    • Gli assembly originari.

    • Il manifesto di applicazione originario.

    • La cartella di lavoro originaria.

    • Il manifesto di distribuzione originario.

    C:\DeployFolder\ExcelWorkbook1_1.0.0.1

    La cartella contiene i file seguenti:

    • Gli assembly aggiornati.

    • Il manifesto di applicazione aggiornato.

    • Una copia della cartella di lavoro aggiornata.

    • Una copia del manifesto di distribuzione aggiornato.

Questa struttura verrà ripetuta ogni volta che si aggiorna l'assembly. Se il documento o la cartella di lavoro viene aggiornata e non è più compatibile con l'assembly esistente, distribuire la soluzione in una nuova cartella di distribuzione.

Utilizzo di MSBuild a un prompt dei comandi

Per pubblicare la soluzione è anche possibile utilizzare MSBuild a un prompt dei comandi. Quando si utilizza MSBuild a un prompt dei comandi, è possibile pubblicare i file di soluzione in un percorso e contemporaneamente modificare il manifesto di applicazione incorporato nella cartella di lavoro o nel documento in modo che punti a un manifesto di distribuzione in un percorso differente. Per eseguire MSBuild a un prompt dei comandi per pubblicare la soluzione, utilizzare la sintassi seguente:

msbuild.exe /target:Publish /property:UpdateUrl=<update location> /property:PublishDir=<publish location> <project file>

Se ad esempio si desidera pubblicare un progetto C#, denominato ExcelWorkbook1, nella cartella condivisa \\PublishServer\PublishFolder, ma si prevede di spostare in futuro il manifesto di distribuzione, il manifesto di applicazione esterno e l'assembly nella cartella condivisa \\DeploymentServer\DeploymentFolder, eseguire il comando riportato di seguito.

msbuild.exe /target:Publish /property:PublishDir=\\PublishServer\PublishFolder\ /property:UpdateUrl=\\DeploymentServer\DeploymentFolder\ C:\ExcelWorkbook1\ExcelWorkbook1.csproj

Per ulteriori informazioni sull'utilizzo di MSBuild a un prompt dei comandi, vedere Compilazione di applicazioni ClickOnce dalla riga di comando.

Manifesti di applicazione e di distribuzione

I manifesti di applicazione e di distribuzione vengono utilizzati per consentire a un documento di aggiornarsi in base all'ultimo assembly. Per ulteriori informazioni, vedere la classe Manifesti dell'applicazione e di distribuzione nelle soluzioni di Office.

Aggiornamento dei manifesti di distribuzione

È possibile modificare il manifesto di distribuzione di una soluzione più volte nel corso dell'intera durata della soluzione. Il manifesto di distribuzione in genere viene aggiornato per due motivi principali:

Aggiornamento dei manifesti di applicazione

La necessità di dover aggiornare un manifesto di applicazione esistente in uso in una soluzione potrebbe non presentarsi mai. Infatti, in genere, si crea un nuovo manifesto di applicazione e si utilizza il manifesto di distribuzione per caricare il nuovo manifesto di applicazione nella soluzione. Vi sono tuttavia principalmente due casi in cui potrebbe essere necessario aggiornare direttamente un manifesto di applicazione in un documento:

Distribuzione di soluzioni Microsoft Office localizzate

Gli aspetti da considerare per la distribuzione di versioni localizzate di soluzioni Visual Studio Tools per Office sono per lo più quelli indicati per la distribuzione di altri tipi di soluzioni tramite Visual Studio. Esistono tuttavia elementi aggiuntivi da prendere in considerazione quando si creano e distribuiscono versioni localizzate di soluzioni Visual Studio Tools per Office. Per ulteriori informazioni, vedere Globalizzazione e localizzazione di soluzioni Office, Procedura: localizzare soluzioni di Excel e Distribuzione e localizzazione.

Vedere anche

Attività

Procedura: preparare il computer degli utenti finali per l'esecuzione delle soluzioni Office (System 2003)

Procedura: distribuire le soluzioni Office (2003 System)

Concetti

Distribuzione di soluzioni Office (System 2003)

Distribuzione di componenti aggiuntivi a livello di applicazione (System 2003)

Modelli di distribuzione (2003 System)

Modello non in linea per le soluzioni Office (2003 System)

Distribuzione protetta (System 2003)

Altre risorse

Distribuzione di applicazioni e componenti