Solución de problemas de implementación de soluciones de OfficeTroubleshoot Office solution deployment

Este tema contiene información sobre cómo solucionar problemas comunes que pueden surgir al implementar soluciones de Office.This topic contains information about how to solve common problems that you might encounter when you deploy Office solutions.

Se aplica a: La información de este tema se aplica al documento-proyectos y agregar de VSTO de nivel-en los proyectos.Applies to: The information in this topic applies to document-level projects and VSTO Add-in projects. Consulte características disponibles por tipo de aplicación y el proyecto de Office.See Features available by Office application and project type.

Solucionar problemas de soluciones de Office con el Visor de eventosTroubleshoot Office solutions by using the event viewer

Puede usar el visor de eventos en Windows para ver todos los mensajes de error capturados por Runtime de Microsoft Visual Studio Tools para OfficeVisual Studio Tools for Office runtime , cuando instale o desinstale soluciones de Office.You can use the event viewer in Windows to see error messages that are captured by the Runtime de Microsoft Visual Studio Tools para OfficeVisual Studio Tools for Office runtime when you install or uninstall Office solutions. Puede usar estos mensajes desde el registrador de eventos para resolver los problemas de instalación e implementación.You can use these messages from the event logger to resolve installation and deployment problems. Para obtener más información, consulte registro de eventos para soluciones de Office.For more information, see Event logging for Office solutions.

Cambiar el nombre del ensamblado produce conflictosChange the assembly name causes conflicts

Si cambia el nombre del ensamblado valor en el aplicación página de la Diseñador de proyectos después de que ya ha implementado una solución, las herramientas de publicación modificarán el Paquete de instalación de tener una Setup.exe archivo y dos manifiestos de implementación.If you change the Assembly Name value in the Application page of the Project Designer after you've already deployed a solution, the publishing tools will modify the Setup package to have one Setup.exe file and two deployment manifests. Si implementa dos archivos de manifiesto, podrían producirse las siguientes condiciones:If you deploy two manifest files, the following conditions might occur:

  • Si el usuario final instala ambas versiones, la aplicación cargará ambos complementos VSTO.If the end user installs both versions, the application will load both VSTO Add-ins.

  • Si el complemento VSTO se instaló antes de cambiar el nombre del ensamblado, el usuario final nunca recibirá actualizaciones.If the VSTO Add-in was installed before the assembly name was changed, the end user will never receive updates.

    Para evitar estas condiciones, no cambie la solución nombre del ensamblado valor después de implementar la solución.To avoid these conditions, don't change the solution's Assembly Name value after you deploy the solution.

Busque actualizaciones tarda mucho tiempoCheck for updates takes a long time

Visual Studio 2010 Tools para Office runtime proporciona una entrada del registro que los administradores pueden usar para establecer el valor de tiempo de espera para descargar los manifiestos y la solución.Visual Studio 2010 Tools for Office runtime provides a registry entry that administrators can use to set the time-out value for downloading the manifests and the solution.

Para establecer el valor de tiempo de esperaTo set the time-out value

  1. En el registro, navegue a la clave siguiente:In the registry, navigate to the following key:

    HKEY_CURRENT_USER\Software\Microsoft\VSTAHKEY_CURRENT_USER\Software\Microsoft\VSTA

  2. En la subclave AddInTimeout , establezca el valor de tiempo de espera en milisegundos.In the AddInTimeout subkey, set the time-out value in milliseconds.

    Si la subclave AddInTimeout no existe, créela como DWORD.If the AddInTimeout subkey doesn't exist, create it as a DWORD.

No se puede actualizar ni publicar en un recurso compartido de redCan't update or publish to a network file share

Soluciones de Office que están en un recurso compartido de red podrían mostrar un mensaje erróneo durante las actualizaciones si la solución Setup.exe archivo está bloqueado en un proceso mientras se publica la actualización.Office solutions that are on a network file share might display a misleading message during updates if the solution's Setup.exe file is locked in a process while the update is being published. El mensaje podría decir lo siguiente: "No se puede agregar 'setup.exe' en la Web.The message might say the following: "Unable to add 'setup.exe' to the Web. Ya existe un archivo 'setup.exe' en este sitio web."The file 'setup.exe' already exists in this Web."

Para ayudar a evitar el bloqueo de archivos, puede hacer el recurso compartido de solo lectura a los usuarios finales.To help prevent file locking, you can make the share read-only to the end users. Sin embargo, si los documentos se encuentran en el recurso compartido, también serán de solo lectura para los usuarios finales.However, if documents are on the share, they will also become read-only to the end users.

Requisitos previos para Microsoft Office no están instaladosPrerequisites for Microsoft Office aren't installed

Puede agregar .NET Framework, Runtime de Microsoft Visual Studio Tools para OfficeVisual Studio Tools for Office runtimey los ensamblados de Office de interoperabilidad primarios al paquete de instalación como requisitos previos que se implementan con la solución de Office.You can add the .NET Framework, the Runtime de Microsoft Visual Studio Tools para OfficeVisual Studio Tools for Office runtime, and the Office primary interop assemblies to your Setup package as prerequisites that are deployed with your Office solution. 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.For information about how to install the primary interop assemblies, see Configure a computer to develop Office solutions and How to: Install Office primary interop assemblies.

Publicación mediante 'Localhost' puede causar problemas de instalaciónPublish using 'Localhost' can cause installation problems

Cuando se usa "http://localhost" como la ubicación de instalación o publicación para las soluciones de nivel de documento, el Asistente para publicación no convierte la cadena en el nombre de equipo real.When you use "http://localhost" as the publish or installation location for document-level solutions, the Publish Wizard doesn't convert the string to the real computer name. En este caso, la solución debe instalarse en el equipo de desarrollo.In this case, the solution must be installed on the development computer. Para que las soluciones implementadas usen IIS en el equipo de desarrollo, use el nombre completo para todas las ubicaciones HTTP/HTTPS/FTP en lugar de localhost.To make deployed solutions use IIS on the development computer, use the fully qualified name for all HTTP/HTTPS/FTP locations instead of localhost.

Los ensamblados almacenados en caché se cargan en lugar de los ensamblados actualizadosCached assemblies are loaded instead of updated assemblies

Fusion, el cargador de ensamblados de .NET Framework, carga la copia en caché de los ensamblados cuando la ruta de acceso de salida del proyecto se encuentra en un recurso compartido de red, el ensamblado se firma con un nombre seguro y no cambia la versión del ensamblado de la personalización.Fusion, the .NET Framework assembly loader, loads the cached copy of assemblies when the project output path is on a network file share, the assembly is signed with a strong name, and the assembly version of the customization doesn't change. Si actualiza un ensamblado que cumple estas condiciones, la actualización no aparecerá la próxima vez que se ejecute el proyecto, ya que se carga la copia en caché.If you update an assembly that meets these conditions, the update won't appear the next time that you run the project because the cached copy is loaded.

Puede configurar Visual Studio para que Fusion descargue los ensamblados cada vez que se ejecute el proyecto.You can configure Visual Studio so that Fusion will download assemblies every time that the project is run.

Para descargar los ensamblados en lugar de cargar las copias en cachéTo download assemblies instead of loading cached copies

  1. En la barra de menús, elija Proyecto, NombreDeProyectoPropiedades.On the menu bar, choose Project, ProjectNameProperties.

  2. En la página Aplicación , elija Información de ensamblado.On the Application page, choose Assembly Information.

  3. Establecer el número de revisión, el tercer campo de la versión del ensamblado, para un carácter comodín (*).Set the revision number, third field, of the Assembly Version, to a wild card (*). Por ejemplo, "1.0. *".For example, "1.0.*". A continuación, elija el Aceptar botón.Then choose the OK button.

    Después de cambiar la versión del ensamblado, puede continuar para firmar el ensamblado con un nombre seguro y Fusion cargará la versión más reciente de la personalización.After you change the assembly version, you can continue to sign your assembly with a strong name, and Fusion will load the most recent version of the customization.

[!NOTE]

Se producirá a partir de Visual Studio 2017, si intenta usar caracteres comodín en la versión de ensamblado de un error de compilación.Starting with Visual Studio 2017, if you try using wild cards in the Assembly Version a build error will occur. Esto es porque los caracteres comodín en la versión del ensamblado se interrumpirá la característica de MSBuild determinista.This is because wild cards in the assembly version will break the MSBuild Deterministic feature. Le pedirá que quite los caracteres comodín de la versión del ensamblado, o deshabilitar determinismo.You will be instructed to either remove the wildcards from the assembly version, or disable determinism. Para obtener más información acerca de la característica determinista vea: Propiedades comunes de proyectos de MSBuild y personalizar una compilaciónTo learn more about the Deterministic feature see: Common MSBuild project properties and Customize your build

Se produce un error en la instalación cuando el identificador URI tiene caracteres que no son ASCII de EE. UU.Installation fails when the URI has characters that aren't US-ASCII

Al publicar una solución de Office en una ubicación HTTP/HTTPS/FTP, la ruta de acceso no puede tener caracteres Unicode que no estén en US-ASCII.When you publish an Office solution to an HTTP/HTTPS/FTP location, the path can't have any Unicode characters that aren't in US-ASCII. Estos caracteres pueden producir un comportamiento incoherente en el programa de instalación.Such characters can cause inconsistent behavior in the Setup program. Utilice los caracteres US-ASCII para la ruta de instalación.Use US-ASCII characters for the installation path.

Aparece un mensaje para desinstalar manualmente al publicar e instalar una solución en el equipo de desarrolloPrompt to manually uninstall appears when you publish and install a solution on the development computer

Al compilar una solución de Office, la versión generada se registra automáticamente.When you build an Office solution, the built version is automatically registered. Si previamente ha publicado e instalado la misma solución en el equipo de desarrollo, Runtime de Microsoft Visual Studio Tools para OfficeVisual Studio Tools for Office runtime detecta que la ruta de instalación para la versión publicada y la versión generada son diferentes después de que la solución se compile, se vuelva a compilar o se publique.If you have previously published and installed the same solution to your development computer, Runtime de Microsoft Visual Studio Tools para OfficeVisual Studio Tools for Office runtime detects that the installation path for the published version and the built version are different after the solution is next built, rebuilt, or published. El mensaje de error dice: "No se puede instalar la personalización hay instalada otra versión y no se puede actualizar desde esta ubicación".The error message says "the customization cannot be installed because another version is currently installed and cannot be upgraded from this location." Las claves del registro se actualizan cada vez que se vuelve a compilar una solución.The registry keys are updated whenever a solution is rebuilt. Por lo tanto, debe desinstalar la versión anterior antes de publicar, depurar o ejecutar la nueva versión.Therefore, you must uninstall the previous version before you publish, debug, or run the new version.

Para evitar que aparezca el mensaje, cree otra cuenta de usuario en el equipo de desarrollo para probar la implementación.To prevent the message from appearing, create another user account on your development computer to test your deployment. Como alternativa, puede desinstalar la versión de la lista de programas instalados en el equipo antes de publicar, depurar o volver a compilar la solución.As an alternative, you can uninstall the version from the list of installed programs on the computer before you next publish, debug, or rebuild the solution.

Excepción no detectada o método no encuentra errores al instalar una soluciónUncaught exception or method not found error when you install a solution

Al instalar soluciones de Office abriendo el manifiesto de implementación (un .vsto archivo), puede que aparezcan mensajes de error de Office application, documento o libro, las condiciones siguientes:When you install Office solutions by opening the deployment manifest (a .vsto file), Office application, document, or workbook, error messages for the following conditions might appear:

  • Método no encontrado.Method not found.

  • MissingMethodException.MissingMethodException.

  • Excepción no detectada.Uncaught exception.

    Para evitar estos mensajes de error, instale la solución ejecutando el programa de instalación.To prevent these error messages, install the solution by running the Setup program.

    Al instalar la solución sin ejecutar el programa de instalación, el instalador no busca ni instalar los requisitos previos.When you install the solution without running the Setup program, the installer doesn't check for or install prerequisites. El programa de instalación comprueba la versión correcta de los requisitos previos y los instala según sea necesario.The Setup program checks for the correct version of prerequisites and installs them as necessary.

Manifiesto de las claves del registro para que el cambio de complementos una vez compilado un proyecto de InstallShield Limited EditionManifest registry keys for Add-ins change after an InstallShield Limited Edition project is built

La clave del registro del manifiesto que forma parte de una instalación de complementos de VSTO de programa a veces, los cambios de .vsto a . dll.manifest cuando compila un proyecto de InstallShield Limited Edition.The manifest registry key that's part of a VSTO Add-in Setup program sometimes changes from .vsto to .dll.manifest when you build an InstallShield Limited Edition project.

Para evitar este problema, cree el proyecto de InstallShield Limited Edition en una solución distinta o use CompanyName.AddinName como el valor de la clave del registro que contiene el nombre del complemento de VSTO.To work around this issue, create the InstallShield Limited Edition project in a different solution, or use CompanyName.AddinName as the value of the registry key that contains the name of the VSTO Add-in.

El instalador de ClickOnce para la solución de Office no instala a los ensamblados de interoperabilidad primariosThe ClickOnce Installer for your Office solution doesn't install the primary interop assemblies

Al ejecutar el programa de instalación que crea ClickOnce para la solución de Office, el programa de instalación para los ensamblados de interoperabilidad primarios (PIA) de Office solo se ejecuta si hay ensamblados ya instalados.When you run the Setup program that ClickOnce creates for your Office solution, the installer for the Office primary interop assemblies (PIAs) runs only if no PIAs are already installed.

Si el programa de instalación no instala los PIA correctamente, instálelos manualmente ejecutando el archivo de instalador que se denomina o2007pia.msi desde el directorio de instalación.If the Setup program doesn't install the PIAs correctly, install them manually by running the installer file that's named o2007pia.msi from the installation directory.

Reinstalar un argumento excepción fuera de intervalo de las causas de las soluciones de OfficeReinstall Office solutions causes an argument out of range exception

Cuando vuelva a instalar una solución de Office, un ArgumentOutOfRangeException excepción puede aparecer el siguiente mensaje de error: Argumento especificado estaba fuera del intervalo de valores válidos.When you reinstall an Office solution, a ArgumentOutOfRangeException exception might appear with the following error message: Specified argument was out of the range of valid values.

Esta situación se produce si las mayúsculas y minúsculas de la dirección URL de la ubicación de instalación son diferentes.This situation occurs if the casing for the URL for the installation location is different. Por ejemplo, este error podría aparecer si instaló una solución de Office desde http://fabrikam.com/ExcelSolution.vsto la primera vez y, a continuación, usar http://fabrikam.com/excelsolution.vsto la segunda vez.For example, this error would appear if you installed an Office solution from http://fabrikam.com/ExcelSolution.vsto the first time and then used http://fabrikam.com/excelsolution.vsto the second time.

Para evitar que aparezca el mensaje, use la misma grafía al instalar soluciones de Office.To prevent the message from appearing, use the same casing when you install Office solutions.

No se puede instalar una solución ClickOnce abriendo el manifiesto de implementación desde la webCan't install a ClickOnce solution by opening the deployment manifest from the web

Los usuarios pueden instalar una solución de Office abriendo el manifiesto de implementación desde la Web.Users can install Office solutions by opening the deployment manifest from the web. Sin embargo, algunas instalaciones de Internet Information Services (IIS) bloquean el .vsto la extensión de nombre de archivo.However, some installations of Internet Information Services (IIS) block the .vsto file name extension. Debe definir el tipo MIME en IIS antes de usarlos para implementar una solución de Office.You must define the MIME type in IIS before you use it to deploy an Office solution.

Para obtener información sobre cómo definir el tipo MIME en IIS 7, consulte agregar un tipo MIME (IIS7).For information about how to define the MIME type in IIS 7, see Add a MIME Type (IIS7).

Establezca la extensión en .vsto y el tipo MIME en application/x-ms-vsto.Set the extension to .vsto and the MIME type to application/x-ms-vsto.

Vea tambiénSee also