Solucionar problemas de implementación de las soluciones de Office

Esta sección contiene sugerencias para resolver problemas comunes que podrían encontrarse al implementar soluciones de Microsoft Office.

Se aplica a: la información de este tema se aplica a los proyectos de nivel de documento y los proyectos de nivel de aplicación para Microsoft Office 2010 y 2007 Microsoft Office System. Para obtener más información, vea Características disponibles por aplicación y tipo de proyecto de Office.

Solución de problemas de soluciones de Office mediante el visor de eventos

Puede usar el visor de eventos de Windows para ver los mensajes de error capturados por el Motor en tiempo de ejecución de Microsoft Visual Studio Tools para Office al instalar o desinstalar soluciones de Office. Puede utilizar estos mensajes desde el registrador de eventos para resolver los problemas de instalación e implementación. Para obtener más información, vea Registro de eventos para soluciones de Office.

Cambiar el nombre del ensamblado produce conflictos

Si cambia el valor de Nombre del ensamblado en la página Aplicación del Diseñador de proyectos después de haber implementado una solución, las herramientas de publicación modificarán el paquete de instalación de tal forma que habrá un archivo Setup.exe y dos manifiestos de implementación. La implementación de dos archivos de manifiesto puede producir las condiciones siguientes:

  • Si el usuario final instala ambas versiones, la aplicación cargará ambos complementos.

  • Si el complemento se instaló antes de cambiar el nombre del ensamblado, el usuario final nunca recibirá actualizaciones.

Para evitar estas condiciones, no cambie el valor Nombre del ensamblado de la solución después de implementarla.

Buscar actualizaciones tarda mucho tiempo

Visual Studio 2010 Tools para Office Runtime proporciona una entrada del Registro que permite a los administradores establecer el valor de tiempo de espera para descargar los manifiestos y la solución. 

Para establecer el valor de tiempo de espera

  1. En el Registro, navegue a la siguiente clave:

    HKEY_CURRENT_USER\Software\Microsoft\VSTA

  2. En la subclave AddInTimeout, establezca el valor de tiempo de espera en milisegundos.

    Si la subclave AddInTimeout no existe, créela como DWORD.

No se puede actualizar ni publicar en un recurso compartido de archivos de red

Las soluciones de Office que están en un recurso compartido de archivos de red podrían mostrar un mensaje erróneo durante las actualizaciones si el archivo Setup.exe de la solución está bloqueado en un proceso mientras se publica la actualización. El mensaje podría decir lo siguiente: "No se puede agregar 'setup.exe' al sitio web. Ya existe un archivo 'setup.exe' en este sitio web."

Para ayudar a evitar el bloqueo del archivo, puede hacer que el recurso compartido sea de sólo lectura para los usuarios finales. Sin embargo, si los documentos están en el recurso compartido, también se volverán de sólo lectura para los usuarios finales.

No están instalados los requisitos previos para Microsoft Office

Puede agregar Microsoft .NET Framework, Motor en tiempo de ejecución de Microsoft Visual Studio Tools para Office y los ensamblados de interoperabilidad primarios de Microsoft Office al paquete de instalación como requisitos previos que se implementan con la solución de Office. Para obtener información sobre cómo instalar los ensamblados de interoperabilidad primarios, vea Configurar un equipo para desarrollar soluciones de Office y Cómo: Instalar ensamblados de interoperabilidad primarios de Office.

Publicar con 'Localhost' puede provocar problemas de instalación

Si utiliza "https://localhost" como ubicación de instalación o publicación para las soluciones de nivel de documento, el Asistente para publicación no convierte la cadena al nombre de equipo real. Esto significa que la solución sólo se puede instalar en el equipo de desarrollo. Para que las soluciones implementadas utilicen IIS en el equipo de desarrollo, utilice el nombre completo en todas las ubicaciones HTTP/HTTPS/FTP en lugar de localhost.

Se cargan los ensamblados almacenados en memoria caché en lugar de los ensamblados actualizados

Fusion, el cargador de ensamblados de .NET Framework, carga la copia en caché de los ensamblados cuando la ruta de acceso de resultados del proyecto está en un recurso compartido de archivos de red, el ensamblado está firmado con un nombre seguro y la versión del ensamblado de la personalización no cambia. Si actualiza un ensamblado que cumple estas condiciones, no verá la actualización la próxima vez que ejecute el proyecto porque se cargará la copia en caché.

Puede configurar Visual Studio para que Fusion descargue los ensamblados cada vez que se ejecute el proyecto.

Para descargar los ensamblados en lugar de cargar las copias en caché

  1. En el menú Proyecto, haga clic en Propiedades de nombreDeProyecto.

  2. En la página Aplicación, haga clic en Información de ensamblado.

  3. En el primer cuadro Versión de ensamblado, escriba un asterisco (*).

  4. Haga clic en Aceptar.

Después de cambiar la versión de ensamblado, puede continuar firmando el ensamblado con un nombre seguro y Fusion cargará la versión última de la personalización.

Los esquemas XML de personalizaciones de nivel de documento no se registran

Si asocia un esquema XML a un documento en un proyecto de nivel de documento para Microsoft Office System 2007, el esquema no se registra en la biblioteca del usuario. Debe crear un archivo de instalador independiente para que se efectúe el registro. Para obtener más información, vea Esquemas y datos XML en personalizaciones de nivel de documento.

Se produce un error en la instalación cuando el identificador URI tiene caracteres que no son EE.UU.-ASCII

Al publicar una solución de Office en una ubicación HTTP/HTTPS/FTP, la ruta de acceso no puede tener ningún carácter Unicode que no sea EE. UU.-ASCII. Estos caracteres pueden producir un comportamiento incoherente en el programa de instalación. Utilice caracteres EE.UU.-ASCII para la ruta de instalación.

Al publicar e instalar una solución en el equipo de desarrollo, aparece un mensaje en el que se indica que debe realizarse una desinstalación manual

Cuando se genera una solución de Office, se registra automáticamente la versión compilada. Si anteriormente se publicó e instaló la misma solución en el equipo de desarrollo, Motor en tiempo de ejecución de Microsoft Visual Studio Tools para Office detecta que la ruta de instalación de la versión publicada y de la versión generada son diferentes después de la siguiente compilación, recompilación o publicación. El mensaje de error dice: "No se puede instalar la personalización porque hay instalada otra versión y no se puede actualizar desde esta ubicación". Dado que al volver a generar la solución se actualizan las claves del Registro, es necesario desinstalar la primera versión antes de publicar, depurar o ejecutar la segunda versión.

Para evitar que aparezca este mensaje, cree otra cuenta de usuario en el equipo de desarrollo para probar la implementación. Como alternativa, puede desinstalar la versión desde la lista de programas instalados del equipo antes de volver a publicar, depurar o generar la solución.

Error de excepción no detectada o método no encontrado al instalar una solución

Al instalar las soluciones de Office abriendo el manifiesto de implementación (un archivo .vsto), o bien la aplicación, documento o libro de Office, puede ver los mensajes de error para las siguientes condiciones:

  • Método no encontrado.

  • MissingMethodException.

  • Excepción no detectada.

Para evitar que aparezcan estos mensajes de error, instale la solución ejecutando el programa de instalación.

Al instalar la solución sin ejecutar el programa de instalación, el instalador no comprueba ni instala los requisitos previos. El programa de instalación comprueba la versión correcta de los requisitos previos y los instala según sea necesario.

Las claves del Registro del manifiesto para los complementos cambian después de generar un proyecto de instalación de Windows Installer

La clave del Registro del manifiesto que forma parte de un programa de instalación de complementos cambia en ocasiones de .vsto a .dll.manifest al generar el proyecto de instalación de Windows Installer.

Para solucionar este problema, cree el proyecto de instalación en otra solución distinta o use CompanyName.AddinName como valor de la clave del Registro que contiene el nombre del complemento.

El instalador de ClickOnce para la solución de Office no instala los ensamblados de interoperabilidad primarios

Cuando ejecuta el programa de instalación creado por ClickOnce para su solución de Office, el instalador de los ensamblados de interoperabilidad primarios de Office solo se ejecuta si no hay ensamblados de este tipo ya instalados.

Si el programa de instalación no instala los ensamblados de interoperabilidad primarios correctamente, instálelos de forma manual. Para ello, ejecute el archivo instalador denominado o2007pia.msi desde el directorio de instalación.

Al volver a instalar las soluciones de Office, se produce una excepción por un argumento fuera del intervalo

Cuando instale de nuevo una solución de Office, puede ver una excepción ArgumentOutOfRangeException con el siguiente mensaje de error: "El argumento especificado está fuera del intervalo de valores válidos".

Esto ocurre si el uso de mayúsculas en la dirección URL de la ubicación de instalación es diferente. Por ejemplo, este error podría producirse si instala por primera vez una solución de Office desde https://fabrikam.com/ExcelSolution.vsto y la segunda vez usa https://fabrikam.com/excelsolution.vsto.

Para evitar que este mensaje aparezca, use del mismo modo las mayúsculas y minúsculas al instalar las soluciones de Office.

Vea también

Conceptos

Solucionar problemas en implementaciones ClickOnce

Otros recursos

Implementar soluciones de Office