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
Versione Microsoft Office
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:
Gli utenti devono disporre di .NET Framework installato. Per ulteriori informazioni, vedere Ridistribuzione di .NET Framework e Utilizzo di più versioni di .NET Framework.
Gli utenti devono disporre del runtime di Visual Studio Tools per Office installato. Per ulteriori informazioni, vedere la classe Procedura: preparare il computer degli utenti finali per l'esecuzione delle soluzioni Office (System 2003).
È necessario che ciascun utente finale disponga almeno dell'accesso in lettura al documento di Office e all'assembly.
Per il funzionamento della soluzione Word o Excel, è necessario che al documento e all'assembly venga attribuita l'attendibilità totale. I documenti memorizzati nel computer dell'utente dispongono in genere dell'attendibilità totale per impostazione predefinita. Un assembly nel computer dell'utente tuttavia non riceve automaticamente l'attendibilità totale. Per ulteriori informazioni, vedere la classe Sicurezza nelle soluzioni Office (System 2003).
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:
Si desidera distribuire una nuova versione dell'assembly della soluzione. Per ulteriori informazioni, vedere la classe Procedura: aggiornare i file di assembly distribuiti (System 2003).
Si desidera cambiare il percorso dell'assembly della soluzione. Per ulteriori informazioni, vedere la classe Procedura: modificare la posizione delle personalizzazioni a livello di documento (System 2003).
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:
Il manifesto di distribuzione e gli assembly sono stati spostati su un nuovo server perché il server originario sta per diventare inattivo. In questo caso è necessario modificare i percorsi di tali elementi nel manifesto di applicazione. Per ulteriori informazioni, vedere la classe Procedura: modificare la posizione delle personalizzazioni a livello di documento (System 2003).
Si desidera rimuovere il manifesto di applicazione dal documento, ad esempio per archiviare il documento senza che esegua codice e venga modificato oppure per inviare il documento completato all'esterno del proprio gruppo di lavoro senza alcun riferimento al codice. Per ulteriori informazioni, vedere la classe Procedura: rimuovere estensioni di codice gestito da documenti (System 2003).
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: 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)