Risoluzione dei problemi relativi alla distribuzione di soluzioni Office

Articolo
08/11/2011

In questa sezione sono inclusi suggerimenti per la risoluzione di problemi comuni che possono verificarsi durante la distribuzione di soluzioni Office.

Si applica a: le informazioni fornite in questo argomento sono valide per i progetti a livello di documento e di applicazione per Microsoft Office 2010 e Microsoft Office System 2007. Per ulteriori informazioni, vedere Funzionalità disponibili in base ai tipi di progetto e applicazioni di Office.

Risoluzione di problemi delle soluzioni di Office mediante il Visualizzatore eventi

È possibile utilizzare il Visualizzatore eventi in Windows per visualizzare i messaggi di errore rilevati da Runtime di Visual Studio Tools per Office quando si installano o disinstallano soluzioni di Office. Questi messaggi del logger di eventi possono essere utilizzati per risolvere i problemi di installazione e di distribuzione. Per ulteriori informazioni, vedere Registrazione degli eventi per le soluzioni Office.

Modifica del nome di assembly che causa conflitti

Se si modifica il valore Nome assembly nella pagina Applicazione di Progettazione progetti dopo aver già distribuito una soluzione, gli strumenti di pubblicazione modificheranno il package di installazione in modo che contenga un file Setup.exe e due manifesti di distribuzione. La distribuzione di due file manifesto può determinare le seguenti condizioni:

Se l'utente finale installa entrambe le versioni, nell'applicazione verranno caricati entrambi i componenti aggiuntivi.
Se il componente aggiuntivo è stato installato prima della modifica del nome di assembly, l'utente finale non riceverà mai aggiornamenti.

Per evitare il verificarsi di queste condizioni, non modificare il valore Nome assembly della soluzione dopo averla distribuita.

Controllo della disponibilità di aggiornamenti che richiede molto tempo

In Visual Studio 2010 Tools per Office Runtime viene fornita una voce del Registro di sistema che consente agli amministratori di impostare il valore di timeout per scaricare i manifesti e la soluzione.

Per impostare il valore di timeout

Nel Registro di sistema passare alla seguente chiave:

HKEY_CURRENT_USER\Software\Microsoft\VSTA
Nella sottochiave AddInTimeout, impostare il valore di timeout in millisecondi.

Se la sottochiave AddInTimeout non esiste, crearla come DWORD.

Impossibilità di eseguire l'aggiornamento o la pubblicazione in una condivisione di file di rete

Le soluzioni Office situate in una condivisione di file di rete potrebbero visualizzare un messaggio fuorviante durante gli aggiornamenti se il file Setup.exe della soluzione è bloccato in un processo mentre viene pubblicato l'aggiornamento. Il messaggio potrebbe indicare che è impossibile aggiungere il file Setup.exe al sito Web, poiché tale file esiste già nel sito Web.

Per impedire il blocco del file, è possibile rendere la condivisione di sola lettura per gli utenti finali. Tuttavia, se nella condivisione sono presenti documenti, diventeranno anch'essi di sola lettura per gli utenti finali.

Prerequisiti per Microsoft Office non installati

È possibile aggiungere Microsoft .NET Framework, Runtime di Visual Studio Tools per Office e gli assembly di interoperabilità primari di Microsoft Office al pacchetto di installazione come prerequisiti distribuiti con la soluzione Office. Per informazioni su come installare gli assembly di interoperabilità primari, vedere Configurazione di un computer per sviluppare soluzioni Office e Procedura: installare assembly di interoperabilità primari di Office.

Pubblicazione mediante "localhost" che può provocare problemi di installazione

Quando si utilizza "https://localhost" come percorso di installazione o di pubblicazione per soluzioni a livello di documento, la Pubblicazione guidata non converte la stringa nel nome effettivo del computer. In tal caso, la soluzione può essere installata solo nel computer di sviluppo. Per fare in modo che le soluzioni distribuite utilizzino IIS nel computer di sviluppo, utilizzare il nome completo per tutti i percorsi HTTP/HTTPS/FTP invece di localhost.

Caricamento di assembly memorizzati nella cache anziché di assembly aggiornati

Fusion, caricatore di assembly di .NET Framework, carica la copia di assembly memorizzata nella cache quando il percorso di output del progetto è situato in una condivisione di file di rete, l'assembly è firmato con un nome sicuro e la versione di assembly della personalizzazione non viene modificata. Se si aggiorna un assembly che soddisfa tali condizioni, l'aggiornamento non verrà visualizzato la volta successiva che si esegue il progetto poiché viene caricata la copia memorizzata nella cache.

È possibile configurare Visual Studio in modo che Fusion scarichi gli assembly ogni volta che il progetto viene eseguito.

Per scaricare assembly anziché caricare copie memorizzate nella cache

Scegliere Proprietà NomeProgetto dal menu Progetto.
Nella pagina Applicazione fare clic su Informazioni assembly.
Nella prima casella Versione assembly digitare un asterisco (*).
Scegliere OK.

Dopo aver modificato la versione di assembly, è possibile continuare a firmare l'assembly con un nome sicuro e Fusion caricherà la versione più recente della personalizzazione.

Schemi XML nelle personalizzazioni a livello di documento non registrati

Se si allega uno schema XML a un documento in un progetto a livello di documento per Microsoft Office System 2007, lo schema non viene registrato nella libreria dell'utente. Per eseguire questa operazione, è necessario creare un file del programma di installazione separato. Per ulteriori informazioni, vedere XML Schema e dati nelle personalizzazioni a livello di documento.

Esito negativo dell'installazione quando l'URI contiene caratteri non US-ASCII

Quando si pubblica una soluzione Office in un percorso HTTP/HTTPS/FTP, tale percorso non può contenere caratteri Unicode in formato non US-ASCII. Tali caratteri possono determinare un comportamento incoerente nel programma di installazione. Utilizzare caratteri US-ASCII per il percorso di installazione.

Richiesta di disinstallazione manuale visualizzata al momento della pubblicazione e installazione di una soluzione nel computer di sviluppo

Quando si compila una soluzione Office, la versione compilata viene registrata automaticamente. Se la stessa soluzione è stata pubblicata e installata in precedenza nel computer di sviluppo, dopo la compilazione, ricompilazione o pubblicazione successiva in Runtime di Visual Studio Tools per Office verrà rilevato un diverso percorso di installazione per la versione pubblicata e la versione compilata. Verrà visualizzato il messaggio di errore "Impossibile installare la personalizzazione perché ne è installata un'altra versione che non può essere aggiornata da questo percorso". Poiché la ricompilazione della soluzione comporta l'aggiornamento delle chiavi del Registro di sistema, prima di pubblicare, eseguire il debug o eseguire la seconda versione è necessario disinstallare la prima versione.

Per impedire la visualizzazione del messaggio, creare un altro account utente nel computer di sviluppo per testare la distribuzione. In alternativa, è possibile disinstallare la versione dall'elenco dei programmi installati nel computer prima della successiva pubblicazione, del successivo debug o della successiva ricompilazione della soluzione.

Errore di eccezione non intercettata o metodo non trovato durante l'installazione di una soluzione

Quando si installano soluzioni di Office aprendo il manifesto di distribuzione (un file con estensione vsto), un'applicazione, un documento o una cartella di lavoro di Office, è possibile che vengano visualizzati messaggi di errore relativi alle condizioni seguenti:

Metodo non trovato.
MissingMethodException.
Eccezione non intercettata.

Per evitare la visualizzazione di tali messaggi di errore, installare la soluzione eseguendo il programma di installazione.

Se si installa la soluzione senza eseguire il programma di installazione, i prerequisiti non verranno verificati o installati. Il programma di installazione verifica la versione corretta dei requisiti e li installa secondo le necessità.

Le chiavi del Registro di sistema del manifesto per i componenti aggiuntivi vengono modificati dopo la compilazione di un progetto di programma di installazione Windows Installer

Quando si compila il progetto di programma di installazione Windows Installer, la chiave del Registro di sistema del manifesto che fa parte di un programma di installazione di un componente aggiuntivo viene a volte modificata da file manifesto con estensione vsto a file manifesto con estensione dll.

Per risolvere questo problema, creare il progetto di programma di installazione in una soluzione diversa oppure utilizzare CompanyName.AddinName come valore della chiave del Registro di sistema che include il nome del componente aggiuntivo.

Il programma di installazione ClickOnce per la soluzione Office creata non installa gli assembly di interoperabilità primari

Quando si esegue il programma di installazione creato da ClickOnce per la soluzione Office, il programma di installazione per gli assembly di interoperabilità primari di Office viene eseguito solo se non è ancora stato installato alcun assembly di interoperabilità primario.

Se gli assembly di interoperabilità primari non vengono installati correttamente dal programma di installazione, installarli manualmente eseguendo il file del programma di installazione denominato o2007pia.msi dalla directory di installazione.

La reinstallazione di soluzioni Office genera un'eccezione di argomento non compreso nell'intervallo

Quando si reinstalla una soluzione Office, è possibile che venga generata un'eccezione ArgumentOutOfRangeException con il messaggio di errore seguente: Argomento specificato non compreso nell'intervallo.

Ciò si verifica se la distinzione tra maiuscole e minuscole dell'URL per il percorso di installazione è diversa. Ad esempio, questi errori verrebbero visualizzati se si installasse una soluzione Office da https://www.microsoft.com/it/it/default.aspxhttps://www.microsoft.com/it/it/default.aspx la prima volta e si utilizzasse https://www.microsoft.com/it/it/default.aspx la seconda volta.

Per impedire che il messaggio venga visualizzato, utilizzare la stessa distinzione tra maiuscole e minuscole quando si installano soluzioni Office.

Condividi tramite