Condividi tramite

Distribuzione di una soluzione Office utilizzando ClickOnce

  • Articolo

È possibile distribuire la soluzione di Office 2010 o di Office 2013 a meno passaggi se si utilizza ClickOnce.Se si pubblicano gli aggiornamenti, la soluzione automaticamente vengono rilevati e installerà.Tuttavia, ClickOnce è necessario installare separatamente la soluzione per ciascun utente di un computer.Pertanto, è necessario considerare l'utilizzo di Windows Installer (MSI) se più utenti eseguirà la soluzione nello stesso computer.

Per un elenco completo delle differenze tra la distribuzione ClickOnce e distribuzione Windows Installer, vedere Scelta di una strategia di distribuzione.

In questo argomento

  • Pubblicare la soluzione

  • Scegliere come si desidera concedere l'attendibilità alla soluzione

  • Help users install the solution

  • Inserire il documento della soluzione nel computer dell'utente finale (personalizzazioni a livello di documento solo)

  • Inserire il documento di una soluzione in un server che esegue SharePoint (personalizzazioni a livello di documento solo)

  • Creare un programma di installazione personalizzato

  • Publish an update

  • Modificare il percorso di installazione di una soluzione

  • Annullare una soluzione a una versione precedente

Per ulteriori informazioni su come distribuire una soluzione Office creando un file di Windows Installer, vedere Distribuzione di una soluzione Office tramite Windows Installer.

Pubblicare la soluzione

È possibile pubblicare la soluzione utilizzando Pubblicazione guidata o Progettazione progetti.In questa procedura, verrà utilizzato Progettazione progetti in quanto fornisce un set completo di opzioni di pubblicazione.Vedere Pubblicazione guidata (sviluppo per Office in Visual Studio).

Per pubblicare la soluzione

  1. In Esplora soluzioni, selezionare il nodo denominato per il progetto.

  2. Sulla barra dei menu, scegliere Progetto, ProjectName Proprietà.

  3. In Progettazione progetti, scegliere la scheda Pubblica, nella figura seguente.

    Scheda Pubblica in Progettazione progetti

  4. Nella casella Posizione cartella di pubblicazione (sito Web, server ftp o percorso di file), immettere il percorso della cartella in cui si Progettazione progetti per copiare i file della soluzione.

    È possibile fornire uno dei seguenti tipi di percorsi.

    • Un percorso locale (ad esempio, C:\FolderName\FolderName).

    • Un URL, ad esempio https://www.contoso.com/mySolution/).

    • Un percorso di (UNC) la convenzione di denominazione uniforme a una cartella nella rete (ad esempio, \\ServerName\FolderName).

    • Un percorso relativo (ad esempio, PublishFolder \, ovvero la cartella in cui il progetto viene generato per impostazione predefinita).

  5. Nella casella URL cartella di installazione, immettere il percorso completo della posizione in cui gli utenti finali cercheranno la soluzione.

    Se non si conosce la posizione inoltre, non fornisce alcuna in questo campo.Per impostazione predefinita, ClickOnce ricerca degli aggiornamenti nella cartella da cui gli utenti installano la soluzione.

  6. Scegliere il pulsante Prerequisiti.

  7. Nella finestra di dialogo Prerequisiti, assicurarsi che la casella di controllo Crea programma di installazione per installare componenti dei prerequisiti è selezionata.

  8. Nell'elenco Scegli i prerequisiti da installare, selezionare le caselle di controllo per Windows Installer 4.5 e il package appropriato di .NET Framework.

    Ad esempio, se la soluzione è destinata a .NET Framework 4.5, selezionare le caselle di controllo per Windows Installer 4.5 e Microsoft .NET Framework 4.5 completo.

  9. Se la soluzione è destinato a.NET Framework 4,5, anche selezionare la casella di controllo Visual Studio 2010 Tools per Office Runtime.

    [!NOTA]

    Per impostazione predefinita, questa casella di controllo non viene visualizzato.Per visualizzare questa casella di controllo, è necessario creare un programma di avvio automatico.Vedere Creare un programma di avvio automatico per un componente aggiuntivo di Office VSTO 2013 con Visual Studio 2012.

  10. In Specificare il percorso di installazione dei prerequisiti, scegliere una delle opzioni visualizzate e quindi scegliere il pulsante OK.

    Nella seguente tabella viene descritta ciascuna opzione.

    Opzione

    Descrizione

    Scarica prerequisiti dal sito Web del fornitore del componente

    L'utente è necessario scaricare e installare i prerequisiti dal fornitore.

    Scarica prerequisiti dallo stesso percorso dell'applicazione

    I prerequisiti software installato con la soluzione.Se si seleziona questa opzione, Visual Studio copia tutti i pacchetti di prerequisiti nel percorso di pubblicazione automaticamente.Per il corretto funzionamento di questa opzione, i package dei prerequisiti devono essere presenti nel computer di sviluppo.

    Scarica prerequisiti dal seguente percorso

    Visual Studio copia tutti i pacchetti di prerequisiti la posizione specificata e li installa con la soluzione.

    Vedere Finestra di dialogo Prerequisiti.

  11. Scegliere il pulsante Aggiornamenti, specificare la frequenza desidera che il componente aggiuntivo o la personalizzazione di ogni utente finale per controllare gli aggiornamenti quindi scegliere il pulsante OK.

    [!NOTA]

    Se la distribuzione viene eseguita tramite un CD o un'unità rimovibile, scegliere il pulsante di opzione Non verificare mai disponibilità aggiornamenti.

    Per informazioni su come pubblicare un aggiornamento, vedere Publish an Update.

  12. Scegliere il pulsante Options, rivedere le opzioni nella finestra di dialogo Options quindi scegliere il pulsante OK.

  13. Scegliere il pulsante Pubblica.

    Visual Studio aggiunge le cartelle e file nella cartella di pubblicazione specificato precedentemente in questa procedura.

    • La cartella File applicazione.

    • Il programma di installazione.

    • Un manifesto di distribuzione che punta al manifesto di distribuzione della versione più recente.

    La cartella File applicazione contiene una sottocartella per ogni versione pubblicata.Ogni sottocartella specifica contiene i seguenti file.

    • Un manifesto di applicazione.

    • Un manifesto di distribuzione.

    • Assembly di personalizzazione.

    Nella figura seguente viene mostrata la struttura della cartella di pubblicazione di un componente aggiuntivo di Outlook.

    Struttura della cartella di pubblicazione

    [!NOTA]

    ClickOnce aggiunge l'estensione .deploy agli assembly in modo che un'installazione protetta di Internet Information Services (IIS) non bloccare i file a causa di un'estensione non sicura.Quando l'utente installa la soluzione, ClickOnce rimuove l'estensione deploy.

  14. Copiare i file della soluzione nel percorso di installazione specificato precedentemente in questa procedura.

Scegliere come si desidera concedere l'attendibilità alla soluzione

Prima di una soluzione possa essere eseguita nei computer degli utenti, oppure concedere l'attendibilità agli utenti devono rispondere a una richiesta di attendibilità quando si installano la soluzione.Per concedere l'attendibilità alla soluzione, firmare i manifesti con un certificato che identifica un editore conosciuto e attendibile.Vedere Attendibili di soluzione la firma dei manifesti di applicazione e di distribuzione.

Se si implementa una personalizzazione a livello di documento e si desidera inserire il documento in una cartella sul computer dell'utente o per rendere disponibile il documento in un sito di SharePoint, assicurarsi di Office si tratta della posizione del documento.Vedere Concessione dell'attendibilità ai documenti.

Gli utenti della guida installano la soluzione

Gli utenti possono installare la soluzione eseguendo il programma di installazione, aprendo il manifesto di distribuzione o, nel caso di una personalizzazione a livello di documento, aprire direttamente il documento.Come procedura consigliata, gli utenti devono installare la soluzione utilizzando il programma di installazione.Gli altri due approcci non garantiscono che il software essenziale sia installato.Se gli utenti desiderano aprire il documento dal percorso di installazione, è necessario aggiungerlo all'elenco di percorsi attendibili nel Centro protezione dell'applicazione di Office.

Bb772100.collapse_all(it-it,VS.110).gifAprire il documento di una personalizzazione a livello di documento

Gli utenti possono aprire il documento di una personalizzazione a livello di documento direttamente dal percorso di installazione o copiando il documento nel computer locale e aprendo quindi la copia.

Come procedura consigliata, gli utenti devono effettuare una copia del documento nel computer in modo da più utenti non possa provare a effettuare la stessa copia contemporaneamente.Per applicare questo approccio, è possibile configurare il programma di installazione per copiare il documento nei computer degli utenti.Vedere Inserire il documento della soluzione nel computer dell'utente finale (personalizzazioni a livello di documento solo).

Bb772100.collapse_all(it-it,VS.110).gifInstallando la soluzione aprendo il manifesto di distribuzione da un sito Web IIS

Gli utenti possono installare una soluzione Office aprendo il manifesto di distribuzione dal web.Tuttavia, un'installazione protetta di Internet Information Services (IIS) bloccherà i file con estensione vsto.Il tipo MIME deve essere definito in IIS prima di poter distribuire una soluzione Office tramite IIS.

Per aggiungere il tipo MIME vsto a IIS 6.0

  1. Nel server che esegue IIS 6.0, scegliere Avvio, Tutti i programmi, Strumenti di amministrazione, Gestione Internet Information Services (IIS).

  2. Scegliere il nome del computer, la cartella Siti Web, oppure il sito Web che si configura.

  3. Sulla barra dei menu, scegliere Azione, Proprietà.

  4. Nella scheda Intestazioni HTTP, scegliere il pulsante Tipi MIME.

  5. Nella finestra Tipi MIME, scegliere il pulsante Nuova.

  6. Nella finestra Tipo MIME, immettere vsto mentre l'estensione, immette application/x-ms-vsto come tipo MIME quindi applicare le nuove impostazioni.

    [!NOTA]

    Per rendere effettive le modifiche, riavviare il servizio Pubblicazione sul Web o attendere il processo di lavoro per riciclare.È quindi necessario svuotare la cache del disco del browser e quindi provare a riaprire il file vsto.

Per aggiungere il tipo MIME vsto a IIS 7.0

  1. Nel server che esegue IIS 7.0, scegliere Avvio, Tutti i programmi, Accessori.

  2. Aprire il menu di scelta rapida per Prompt dei comandidei controlli e quindi scegliere Esegui come amministratore.

  3. Nella casella Apri, immettere il seguente percorso e quindi scegliere il pulsante OK.

    %windir%\system32\inetsrv

  4. Il seguente comando e quindi applicare le nuove impostazioni.

    set config /section:staticContent /+[fileExtension='.vsto',mimeType='application/x-ms-vsto']

    [!NOTA]

    Per rendere effettive le modifiche, è necessario riavviare il servizio Pubblicazione sul Web o, è necessario attendere il processo di lavoro per riciclare.È quindi necessario svuotare la cache del disco del browser e quindi provare a riaprire il file vsto.

Inserire il documento della soluzione nel computer dell'utente finale (personalizzazioni a livello di documento solo)

È possibile copiare il documento della soluzione nel computer dell'utente finale per la creazione di un'azione post-distribuzione.In tal modo, l'utente non deve copiare manualmente al percorso di installazione nel computer dopo l'installazione della soluzione.È necessario creare una classe che definisce l'azione post-distribuzione, compilazione e pubblica la soluzione, modificare il manifesto dell'applicazione e la firma dell'applicazione e il manifesto di distribuzione.

Le procedure riportate di seguito si presuppone che il nome del progetto sia ExcelWorkbook e che si pubblica la soluzione nella directory di C:\publish nel computer.

Bb772100.collapse_all(it-it,VS.110).gifCreare una classe che definisce l'azione post-distribuzione

  1. Nella barra dei menu, scegliere File, Aggiungi, Nuovo progetto.

  2. Nella finestra di dialogo Aggiungi nuovo progetto, selezionare nel riquadro Modelli installati, selezionare la cartella Finestre.

  3. Nel riquadro Modelli, scegliere il modello Libreria di classi.

  4. Nel campo Nome, immettere FileCopyPDAquindi scegliere il pulsante OK.

  5. In Esplora soluzioni, selezionare il progetto FileCopyPDA.

  6. Nella barra dei menu, scegliere Progetto, Aggiungi riferimento.

  7. Nella scheda .NET, aggiungere riferimenti a Microsoft.VisualStudio.Tools.Applications.Runtime e Microsoft.VisualStudio.Tools.Applications.ServerDocument.

  8. Rinominare la classe a FileCopyPDAquindi sostituire il contenuto del file con il codice.Mediante il codice vengono effettuate le seguenti attività:

    • Copiare il documento nel desktop dell'utente.

    • Modifica della proprietà _AssemblyLocation da un percorso relativo a un percorso completo per il manifesto di distribuzione.

    • Eliminare il file se l'utente consente di disinstallare la soluzione.

    Imports Microsoft.VisualStudio.Tools.Applications.Deployment
Imports Microsoft.VisualStudio.Tools.Applications

Public Class FileCopyPDA
    Implements IAddInPostDeploymentAction

    Sub Execute(ByVal args As AddInPostDeploymentActionArgs) Implements IAddInPostDeploymentAction.Execute
        Dim dataDirectory As String = "Data\ExcelWorkbook.xlsx"
        Dim file As String = "ExcelWorkbook.xlsx"
        Dim sourcePath As String = args.AddInPath
        Dim deploymentManifestUri As Uri = args.ManifestLocation
        Dim destPath As String = Environment.GetFolderPath(Environment.SpecialFolder.DesktopDirectory)
        Dim sourceFile As String = System.IO.Path.Combine(sourcePath, dataDirectory)
        Dim destFile As String = System.IO.Path.Combine(destPath, file)

        Select Case args.InstallationStatus
            Case AddInInstallationStatus.InitialInstall, AddInInstallationStatus.Update
                System.IO.File.Copy(sourceFile, destFile)
                ServerDocument.RemoveCustomization(destFile)
                ServerDocument.AddCustomization(destFile, deploymentManifestUri)
                Exit Select
            Case AddInInstallationStatus.Uninstall
                If System.IO.File.Exists(destFile) Then
                    System.IO.File.Delete(destFile)
                End If
                Exit Select
        End Select
    End Sub

    using Microsoft.VisualStudio.Tools.Applications.Deployment;
using Microsoft.VisualStudio.Tools.Applications;
using System.IO;

namespace FileCopyPDA
{
    public class FileCopyPDA : IAddInPostDeploymentAction
    {
        public void Execute(AddInPostDeploymentActionArgs args) 
        {
            string dataDirectory = @"Data\ExcelWorkbook.xlsx";
            string file = @"ExcelWorkbook.xlsx";
            string sourcePath = args.AddInPath;
            Uri deploymentManifestUri = args.ManifestLocation;
            string destPath = Environment.GetFolderPath(Environment.SpecialFolder.DesktopDirectory);
            string sourceFile = System.IO.Path.Combine(sourcePath, dataDirectory);
            string destFile = System.IO.Path.Combine(destPath, file);

            switch (args.InstallationStatus)
            {
                case AddInInstallationStatus.InitialInstall:
                case AddInInstallationStatus.Update:
                    File.Copy(sourceFile, destFile);
                    ServerDocument.RemoveCustomization(destFile);
                    ServerDocument.AddCustomization(destFile, deploymentManifestUri);
                    break;
                case AddInInstallationStatus.Uninstall:
                    if (File.Exists(destFile))
                    {
                        File.Delete(destFile);
                    }
                    break;
            }
        }

Bb772100.collapse_all(it-it,VS.110).gifCompilare e pubblicare la soluzione

  1. In Esplora soluzioni, scegliere dal menu di scelta rapida del progetto FileCopyPDA quindi scegliere Compila.

  2. Aprire il menu di scelta rapida del progetto ExcelWorkbook quindi scegliere Compila.

  3. Aprire il menu di scelta rapida del progetto ExcelWorkbook quindi scegliere Aggiungi riferimento.

  4. Nella finestra di dialogo Aggiungi riferimento, scegliere la scheda Progetti, scegliere FileCopyPDAquindi scegliere il pulsante OK.

  5. In Esplora soluzioni, selezionare il progetto ExcelWorkbook.

  6. Sulla barra dei menu, scegliere Progetto, Nuova cartella.

  7. Digitare i dati e scegliere la chiave leave.

  8. In Esplora soluzioni, selezionare la cartella Dati.

  9. Sulla barra dei menu, scegliere Progetto, Aggiungi elemento esistente.

  10. Nella finestra di dialogo Aggiungi elemento esistente, individuare la directory di output del progetto ExcelWorkbook, selezionare il file ExcelWorkbook.xlsx quindi selezionare il pulsante Aggiungi.

  11. In Esplora soluzioni selezionare il file ExcelWorkbook.xlsx.

  12. Nella finestra Proprietà, modificare la proprietà Azione di compilazione a Contenuto e la proprietà Copia nella directory di output su Copia se più recente.

    Dopo avere completato questa procedura, il progetto sarà simile alla figura seguente.

    Struttura progetto dell'azione post-distribuzione.

  13. Pubblicare il progetto ExcelWorkbook.

Bb772100.collapse_all(it-it,VS.110).gifModificare il manifesto di applicazione

  1. Aprire la directory di c:\publish utilizzando Esplora file.

  2. Aprire la cartella di File applicazione e aprire quindi la cartella che corrisponde alla versione pubblicata più recente della soluzione.

  3. Aprire il file di ExcelWorkbook.dll.manifest in un editor di testo quale Blocco Note.

  4. Dopo l'elemento di </vstav3:update>, aggiungere il codice seguente.Per l'attributo di classe dell'elemento <vstav3:entryPoint>, utilizzare la sintassi seguente: NomeSpazioDeiNomi.NomeClasse.Nell'esempio seguente, lo spazio dei nomi è uguale a quello della classe, pertanto il nome del punto di ingresso risultante è FileCopyPDA.FileCopyPDA.

    <vstav3:postActions>
  <vstav3:postAction>
    <vstav3:entryPoint
      class="FileCopyPDA.FileCopyPDA">
      <assemblyIdentity
        name="FileCopyPDA"
        version="1.0.0.0"
        language="neutral"
        processorArchitecture="msil" />
    </vstav3:entryPoint>
    <vstav3:postActionData>
    </vstav3:postActionData>
  </vstav3:postAction>
</vstav3:postActions>

Bb772100.collapse_all(it-it,VS.110).gifFirmare nuovamente i manifesti di applicazione e di distribuzione

  1. Nella cartella %USERPROFILE%\Documents\Visual Studio 2012\Projects\ExcelWorkbook\ExcelWorkbook, copiare il file di certificato di ExcelWorkbook_TemporaryKey.pfx quindi incollarlo nella cartella di PublishFolder**\Application Files\ExcelWorkbook**MostRecentPublishedVersion.

  3. Aprire il prompt dei comandi di Visual Studio 2005 e quindi impostare le directory sulla cartella file \ ExcelWorkbook di c:\publish\ApplicationMostRecentPublishedVersion, ad esempio file \ ExcelWorkbook_1_0_0_4 di c:\publish\Application).

  4. Firmare il manifesto di applicazione modificato mediante il seguente comando:

    mage -sign ExcelWorkbook.dll.manifest -certfile ExcelWorkbook_TemporaryKey.pfx

    Verrà visualizzato il messaggio "ExcelWorkbook.dll.manifest firmato correttamente".

  6. Modificare a c:\publish la cartella e quindi aggiornare e firmare il manifesto di distribuzione eseguendo il comando seguente:

    mage -update ExcelWorkbook.vsto -appmanifest "Application Files\Ex
celWorkbookMostRecentVersionNumber>\ExcelWorkbook.dll.manifest" -certfile "Application Files\ExcelWorkbookMostRecentVersionNumber>\ExcelWorkbook_TemporaryKey.pfx"

    [!NOTA]

    Nell'esempio precedente, MostRecentVersionNumber di sostituzione con il numero di versione della versione pubblicata recente della soluzione, ad esempio 1_0_0_4).

    Verrà visualizzato il messaggio "ExcelWorkbook.vsto firmato correttamente".

  7. Copiare il file ExcelWorkbook.vsto nella directory di file \ ExcelWorkbook di c:\publish\ApplicationMostRecentVersionNumber.

Inserire il documento di una soluzione in un server che esegue SharePoint (personalizzazioni a livello di documento solo)

È possibile pubblicare la personalizzazione a livello di documento agli utenti finali tramite SharePoint.Quando gli utenti visitano il sito di SharePoint e aprono il documento, verranno automaticamente installate la soluzione dalla cartella di rete condivisa sul computer locale dell'utente.Dopo la soluzione viene installata localmente, la personalizzazione continuerà ad essere eseguito anche se il documento viene copiato altrove, ad esempio il desktop.

Per inserire il documento in un server che esegue SharePoint

  1. Aggiungere il documento della soluzione in una raccolta documenti di un sito di SharePoint.

  2. Eseguire i passaggi per uno degli approcci seguenti:

    • Utilizzare lo strumento di configurazione di Office per aggiungere il server che esegue SharePoint nel Centro protezione in Word o excel in tutti i computer degli utenti.

      Vedere Criteri di sicurezza e impostazioni in Office 2010.

    • Assicurarsi che ogni utente esegue le operazioni seguenti.

      1. Nel computer locale, aprire Word o Excel, scegliere la scheda File quindi scegliere il pulsante Options.

      2. Nella finestra di dialogo Centro protezione, scegliere il pulsante Percorsi attendibili.

      3. Selezionare la casella di controllo Consenti percorsi attendibili in questa rete (scelta non consigliata) quindi scegliere il pulsante Aggiungi nuovo percorso.

      4. Nella casella Tracciato, immettere l'url della raccolta documenti di SharePoint che contiene il documento caricato, ad esempio http://SharePointServerName/TeamName/ProjectName/DocumentLibraryName).

        Non aggiungere il nome della pagina Web predefinita, ad esempio default.aspx o AllItems.aspx.

      5. Selezionare la casella di controllo Considera attendibili anche le sottocartelle di questo percorso e quindi scegliere il pulsante OK.

        Quando gli utenti effettuano l'accesso al sito di SharePoint, il documento viene aperto e la personalizzazione è installata.Gli utenti possono copiare il documento nel desktop.La personalizzazione continuerà ad essere eseguito perché proprietà nel punto del documento nel percorso di rete di documento.

Creare un programma di installazione personalizzato

È possibile creare un programma di installazione personalizzato per la soluzione Office, anziché utilizzare il programma di installazione creato automaticamente quando si pubblica la soluzione.Ad esempio, è possibile utilizzare uno script di accesso per avviare l'installazione, oppure utilizzare un file batch per installare la soluzione senza un'interazione.Questi scenari funzionano meglio se i prerequisiti sono già installati nei computer degli utenti finali.

Come parte del processo di installazione personalizzato, chiamare lo strumento del programma di installazione per le soluzioni Office (VSTOInstaller.exe), installato nel percorso seguente per impostazione predefinita:

%commonprogramfiles%\microsoft shared\VSTO\10.0\VSTOInstaller.exe

Se lo strumento non è in tale percorso, è possibile utilizzare la chiave del Registro di sistema HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VSTO Runtime Setup\v4\InstallerPath or HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\VSTO Runtime Setup\v4\InstallerPath HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VSTO Runtime Setup\v4\InstallerPath or HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\VSTO Runtime Setup\v4\InstallerPath HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VSTO Runtime Setup\v4\InstallerPath or HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\VSTO Runtime Setup\v4\InstallerPath HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VSTO Runtime Setup\v4\InstallerPath or HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\VSTO Runtime Setup\v4\InstallerPath HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VSTO Runtime Setup\v4\InstallerPath or HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\VSTO Runtime Setup\v4\InstallerPath HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VSTO Runtime Setup\v4\InstallerPath or HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\VSTO Runtime Setup\v4\InstallerPath HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VSTO Runtime Setup\v4\InstallerPath or HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\VSTO Runtime Setup\v4\InstallerPath per trovare il percorso dello strumento.

È possibile utilizzare i seguenti parametri con VSTOinstaller.exe.

Parametro

Definizione

/Install o /I

Installa la soluzione.È necessario utilizzare questa opzione con il percorso di un manifesto di distribuzione.È possibile specificare un percorso sul computer locale, una condivisione file di (UNC) la convenzione di denominazione dell'interfaccia, o in un sito Web HTTP/HTTPS.È possibile specificare un percorso locale (C:\FolderName\PublishFolder), un percorso relativo (Publish\), o un percorso completo (\\ServerName\FolderName o https://ServerName/FolderName).

/Uninstall o /U

Disinstalla la soluzione.È necessario utilizzare questa opzione con il percorso di un manifesto di distribuzione.È possibile specificare un percorso può essere sul computer locale, una condivisione di file UNC, o in un sito Web HTTP/HTTPS.È possibile specificare un percorso locale (c:\FolderName\PublishFolder), un percorso relativo (Publish\), o un percorso completo (\\ServerName\FolderName o https://ServerName/FolderName).

/Silent o /S

Installare o disinstalla senza che l'utente per l'input o visualizzare un messaggio.Se è necessaria la richiesta di attendibilità, la personalizzazione non viene installata o aggiornata.

/Help o /?

Visualizza le informazioni della Guida.

Quando si esegue VSTOinstaller.exe, i seguenti codici possibile che vengano visualizzati errori.

Codice di errore

Definizione

0

La soluzione è stata installata correttamente o disinstallato stata, o la guida di VSTOInstaller è presente.

-100

Una o più opzioni della riga di comando non è valido o sono state impostate più volte.Per ulteriori informazioni, immettere in "vstoinstaller/?" vedere o Creazione di un programma di installazione personalizzato per una soluzione Office ClickOnce.

-101

Una o più opzioni della riga di comando non è valida.Per ulteriori informazioni, immettere in "vstoinstaller/?".

-200

L'uri del manifesto di distribuzione non è valido.Per ulteriori informazioni, immettere in "vstoinstaller/?".

-201

Impossibile installare la soluzione perché il manifesto di distribuzione non è valido.Vedere Manifesti di distribuzione per le soluzioni Office.

-202

Impossibile installare la soluzione perché la sezione di Visual Studio Tools per Office del manifesto dell'applicazione non è valida.Vedere Manifesti di applicazione per le soluzioni Office.

-203

Impossibile installare la soluzione perché un errore di download si è verificato.Controllare la posizione del file di rete o URI del manifesto di distribuzione e riprovare.

-300

Impossibile installare la soluzione perché un'eccezione di sicurezza si è verificata.Vedere Sicurezza delle soluzioni Office.

-400

Impossibile installare la soluzione.

-401

Impossibile disinstallare la soluzione.

-500

L'operazione è stata annullata perché impossibile installare la soluzione o disinstallazione o il manifesto di distribuzione potrebbe non essere scaricato.

Pubblicare un aggiornamento

Per aggiornare una soluzione, la pubblicazione di nuovo utilizzando Progettazione progetti o Pubblicazione guidatae copiare la soluzione aggiornata nel percorso di installazione.Quando si copiano i file nel percorso di installazione, assicurarsi di sovrascrivere i file precedenti.

La volta successiva che la soluzione per un aggiornamento, cercherà e carica la nuova versione automaticamente.

Modificare il percorso di installazione di una soluzione

È possibile aggiungere o modificare il percorso di installazione dopo una soluzione viene pubblicata.È necessario modificare il percorso di installazione per uno o più dei seguenti motivi:

  • Il programma di installazione è stato compilato prima che il percorso di installazione è noto.

  • I file della soluzione sono stati copiati in un percorso diverso.

  • Il server che ospita i file di installazione presenta un nuovo nome o un percorso.

Per modificare il percorso di installazione di una soluzione, è necessario aggiornare il programma di installazione quindi gli utenti devono eseguirlo.Per le personalizzazioni a livello di documento, gli utenti devono aggiornare anche una proprietà nel documento per indicare la nuova posizione.

[!NOTA]

Se non si desidera richiedere agli utenti di aggiornare le proprietà del documento, è possibile chiedere agli utenti di ottenere il documento aggiornato dal percorso di installazione.

Per modificare il percorso di installazione nel programma di installazione

  1. Aprire una finestra Prompt dei comandi e impostare per le directory nella cartella di installazione.

  2. Eseguire il programma di installazione e includere il parametro di /url, che accetta come stringa il nuovo percorso di installazione.

    Di seguito viene illustrato come modificare il percorso di installazione in un percorso nel sito Web di Fabrikam, ma è possibile sostituire tale URL con il percorso desiderato:

    setup.exe /url="http://www.fabrikam.com/newlocation"

    [!NOTA]

    Se viene visualizzato un messaggio e segnalare che la firma dell'eseguibile sia stata invalidata, il certificato utilizzato per firmare la soluzione non è più valido e l'editore è sconosciuto.Di conseguenza, gli utenti devono confermare che garantisca l'attendibilità del codice sorgente della soluzione prima che possano installarlo.

    [!NOTA]

    Per visualizzare il valore corrente dell'URL, eseguire setup.exe /url.

Per le personalizzazioni a livello di documento, gli utenti devono aprire il documento e quindi aggiornare la proprietà di _AssemblyLocation.Nei passaggi seguenti viene descritto come gli utenti possono eseguire questa attività.

Per aggiornare la proprietà di _AssemblyLocation in un documento

  1. Nella scheda File, scegliere, Informazioninella figura seguente.

    Scheda Informazioni in Excel

  2. Nell'elenco Proprietà, scegliere Proprietà avanzate, nella figura seguente.

    Proprietà avanzate in Excel.

  3. Nella scheda Personalizzata nell'elenco Proprietà, scegliere _AssemblyLocation, come illustrato nella figura seguente.

    Proprietà AssemblyLocation.

    La casella Valori contiene l'identificatore del manifesto di distribuzione.

  4. Prima dell'identificatore, immettere il percorso completo del documento, seguito da una barra, nel formato Percorso |Identificatore, ad esempio File://ServerName/FolderName/FileName|74744e4b-e4d6-41eb-84f7-ad20346fe2d9.

    Per ulteriori informazioni sul formato dell'identificatore, vedere Cenni preliminari sulle proprietà personalizzate dei documenti.

  5. Scegliere il pulsante OK quindi salvare e chiudere il documento.

  6. Eseguire il programma di installazione senza il parametro di /url per installare la soluzione nel percorso specificato.

Annullare una soluzione a una versione precedente

Quando eseguire il rollback una soluzione, ripristinare gli utenti a una versione precedente di tale soluzione.

Per annullare una soluzione

  1. Aprire il percorso di installazione della soluzione.

  2. Nella cartella di pubblicazione di primo livello, eliminare il manifesto di distribuzione (ovvero il file con estensione VSTO).

  3. Individuare la sottocartella della versione a cui si desidera eseguire il rollback.

  4. Copiare il manifesto di distribuzione da tale sottocartella alla cartella di pubblicazione di primo livello.

    Ad esempio, annullare una soluzione denominata OutlookAddIn1 dalla versione 1.0.0.1 alla versione 1.0.0.0, copiare il file OutlookAddIn1.vsto la cartella OutlookAddIn1_1_0_0_0.Incollare il file nella cartella di pubblicazione di primo livello, sovrascrivendo il manifesto di distribuzione specifico di OutlookAddIn1_1_0_0_1 già presenti.

    Nella figura seguente viene mostrata la struttura di cartelle di pubblicazione in questo esempio.

    Struttura della cartella di pubblicazione

    La volta successiva che un utente apre l'applicazione o il documento in misura, la modifica del manifesto di distribuzione viene rilevata.La versione precedente della soluzione Office viene eseguita dalla cache ClickOnce.

[!NOTA]

I dati locali vengono salvati soltanto per una versione precedente di una soluzione.Se si esegue un rollback di due versioni, i dati locali non vengono mantenuti.Per ulteriori informazioni sui dati locali, vedere Accesso a dati locali e remoti in applicazioni ClickOnce.

Vedere anche

Altre risorse

Distribuzione di una soluzione Office

Distribuzione di una soluzione Office utilizzando ClickOnce

Procedura: pubblicare una soluzione Office utilizzando ClickOnce

Procedura: installare una soluzione Office ClickOnce

Procedura: pubblicare una soluzione Office a livello di documento in un server SharePoint tramite ClickOnce

Creazione di un programma di installazione personalizzato per una soluzione Office ClickOnce