Compartir a través de


Implementar una solución de Office mediante ClickOnce

Puede implementar la solución de Office 2013 o de Office 2010 en menos pasos si utiliza ClickOnce.Si publica actualizaciones, la solución automáticamente las detectará y instalará.Sin embargo, ClickOnce es necesario para instalar la solución por separado para cada usuario de un equipo.Por tanto, debe considerar mediante Windows Installer (.msi) si más de un usuario ejecuta la solución en el mismo equipo.

Para obtener una lista completa de diferencias entre la implementación ClickOnce y la implementación de Windows Installer, vea Elegir una estrategia de implementación.

En este tema

  • Publicar la solución

  • Decida cómo desea conceder confianza a la solución

  • Help users install the solution

  • Coloque el documento de una solución en el equipo del usuario final (las personalizaciones de nivel de documento solo)

  • Coloque el documento de una solución en un servidor que ejecute SharePoint (las personalizaciones de nivel de documento solo)

  • Crear un instalador personalizado

  • Publish an update

  • Cambie la ubicación de instalación de una solución

  • Revertir una solución a una versión anterior

Para obtener más información sobre cómo implementar una solución de Office creando un archivo de Windows Installer, vea Implementar una solución de Office mediante Windows Installer.

Publicar la solución

Puede publicar la solución mediante Asistente para publicación o Diseñador de proyectos.En este procedimiento, utilizará Diseñador de proyectos porque proporciona el conjunto completo de opciones de publicación.Vea Asistente para publicación (Desarrollo de Office en Visual Studio).

Para publicar la solución

  1. En Explorador de soluciones, elija el nodo que se llama para el proyecto.

  2. En la barra de menú, elija proyecto, ProjectName propiedades.

  3. En Diseñador de proyectos, elija la ficha publicar, en la siguiente ilustración.

    Pestaña Publicar del Diseñador de proyectos

  4. En el cuadro de la Ubicación de la carpeta de publicación (sitio Web, FTP server, o ruta de acceso), escriba la ruta de la carpeta donde desea Diseñador de proyectos para copiar los archivos de la solución.

    Puede especificar los siguientes tipos de rutas.

    • Una ruta de acceso local (por ejemplo, C: \FolderName\FolderName).

    • UNA dirección URL (por ejemplo, https://www.contoso.com/mySolution/).

    • Una ruta de (UNC) de convención de nomenclatura uniforme a una carpeta en la red (por ejemplo, \\ServerName\FolderName).

    • Una ruta de acceso relativa (por ejemplo, PublishFolder \, que es la carpeta en la que el proyecto se publica de forma predeterminada).

  5. En el cuadro Dirección URL de la carpeta de instalación, escriba la ruta de acceso completa de la ubicación donde los usuarios finales encontrarán la solución.

    Si no conoce la ubicación todavía, no especifique algo en este campo.De forma predeterminada, ClickOnce busca actualizaciones en la carpeta en la que los usuarios instalan la solución.

  6. Elija el botón Requisitos previos.

  7. En el cuadro de diálogo requisitos previos, asegúrese de que la casilla Crear programa de instalación para instalar los componentes necesarios está seleccionada.

  8. En la lista Elegir los requisitos previos que se van a instalar, active las casillas Windows Installer 4,5 y el paquete apropiado de .NET Framework.

    Por ejemplo, si la solución tiene como destino .NET Framework 4.5, active las casillas Windows Installer 4,5 y .NET Framework 4,5 de Microsoft .NET completo.

  9. Si la solución tiene como destino.NET Framework 4,5, también active la casilla Visual Studio 2010 Tools para Office Runtime.

    [!NOTA]

    De forma predeterminada, esta casilla no aparece.Para mostrar esta casilla, debe crear un paquete de arranque.Vea Crear un paquete de arranque para un complemento de Office 2013 VSTO con Visual Studio 2012.

  10. En Especificar la ubicación de instalación de los requisitos previos, elija una de las opciones que aparecen, y elija el botón Aceptar.

    En la siguiente tabla se describe cada una de las opciones.

    Opción

    Descripción

    Descargar los requisitos previos del sitio Web del proveedor de los componentes

    Se pedirá al usuario descargar e instalar estos requisitos previos.

    Descargar los requisitos previos desde la misma ubicación que mi aplicación

    El software que es requisito previo está instalado con la solución.Si elige esta opción, Visual Studio copia todos los paquetes de requisito previo a la ubicación de publicación para usted.Para que funcione esta opción, estos paquetes se deben encontrar en el equipo de desarrollo.

    Descargar requisitos previos de la siguiente ubicación

    Visual Studio copia todos los paquetes de requisito previo a la ubicación especificada y se instala con la solución.

    Vea Requisitos previos (Cuadro de diálogo).

  11. Elija el botón Actualizaciones, especifique la frecuencia con que se desea el complemento o personalización de cada usuario final para comprobar si hay actualizaciones, y elija el botón Aceptar.

    [!NOTA]

    Si está implementando desde un CD o una unidad extraíble, elija el botón de opción No comprobar nunca si hay actualizaciones.

    Para obtener información sobre cómo publicar una actualización, vea Publish an Update.

  12. Elija el botón opciones, revise las opciones en el cuadro de diálogo opciones, y elija el botón Aceptar.

  13. Elija el botón Publicar ahora.

    Visual Studio agrega las carpetas y los siguientes archivos a la carpeta de publicación especificada anteriormente en este procedimiento.

    • La carpeta Archivos de aplicación.

    • El programa de instalación.

    • Un manifiesto de implementación que señala al manifiesto de implementación de la versión más reciente.

    La carpeta Archivos de aplicación contiene una subcarpeta para cada versión publicar.Cada subcarpeta versión- concreta contiene los archivos siguientes.

    • Un manifiesto de aplicación.

    • Un manifiesto de implementación.

    • Ensamblados de personalización.

    La ilustración siguiente muestra la estructura de la carpeta de publicación de un complemento de Outlook.

    Estructura de carpetas de la carpeta de publicación

    [!NOTA]

    ClickOnce anexa la extensión .deploy a los ensamblados de modo que una instalación segura de internet information services (IIS) no bloquee los archivos debido a una extensión no segura.Al instalar la solución, ClickOnce quita la extensión .deploy.

  14. Copie los archivos de la solución en la ubicación de instalación especificada anteriormente en este procedimiento.

Decida cómo desea conceder confianza a la solución

Antes de que una solución pueda ejecutarse en equipos de usuario, o debe conceder confianza o los usuarios deben responder al mensaje relativo a la confianza cuando instala la solución.Para conceder confianza a la solución, firme los manifiestos utilizando un certificado que identifica conocido y un editor de confianza.Vea Confirmando la solución firmar la aplicación y los manifiestos de implementación.

Si está implementando una personalización de nivel de documento y desea que el documento en una carpeta en el equipo del usuario o para hacer el documento disponibles en un sitio de SharePoint, asegúrese de que Office confíe en la ubicación del documento.Vea Otorgar confianza a los documentos.

Los usuarios de Ayuda instalan la solución

Los usuarios pueden instalar la solución ejecutando el programa de instalación, abriendo el manifiesto de implementación, o en el caso de una personalización de nivel de documento, abriendo el documento directamente.Como procedimiento recomendado, los usuarios deben instalar la solución mediante el programa de instalación.Los otros dos enfoques no garantizan que el software que es requisito previo está instalado.Si los usuarios desean abrir el documento de la ubicación de instalación, debe agregarlo a la lista de ubicaciones de confianza en el Centro de confianza de la aplicación de Office.

Bb772100.collapse_all(es-es,VS.110).gifAl abrir el documento de una personalización de nivel de documento

Los usuarios pueden abrir el documento de una personalización de nivel de documento directamente desde la ubicación de instalación o copiar el documento en el equipo local y después abriendo la copia.

Como procedimiento recomendado, los usuarios deben abrir una copia del documento en sus equipos de modo que varios usuarios no intenten para abrir la misma copia al mismo tiempo.Para aplicar este ejercicio, puede configurar el programa de instalación para copiar el documento en los equipos de los usuarios.Vea Coloque el documento de una solución en el equipo del usuario final (las personalizaciones de nivel de documento solo).

Bb772100.collapse_all(es-es,VS.110).gifInstalar la solución abriendo el manifiesto de implementación de un sitio Web de IIS

Los usuarios pueden instalar una solución de Office abriendo el manifiesto de implementación web.Sin embargo, una instalación segura de internet information services (IIS) bloqueará los archivos que tienen la extensión .vsto.El tipo MIME se debe definir en IIS para implementar una solución de Office mediante IIS.

Para agregar el tipo MIME .vsto a IIS 6,0

  1. En el servidor que está ejecutando IIS 6,0, elija Inicio, Todos los programas, Herramientas administrativas, Administrador de (IIS) de IIS.

  2. Elija el nombre de equipo, la carpeta Sitios Web, o el sitio Web que está configurando.

  3. En la barra de menú, elija Acción, propiedades.

  4. En la pestaña Encabezados HTTP, elija el botón Tipos MIME.

  5. En la ventana Tipos MIME, elija el botón Nueva.

  6. En la ventana Tipo MIME, entre en .vsto como extensión, entra en application/x-ms-vsto como el tipo MIME, y después aplicar los nuevos valores.

    [!NOTA]

    Para que los cambios surtan efecto, debe reiniciar el Servicio de publicación World Wide Web o esperar hasta que el proceso de trabajo se recicle.Deberá vaciar la caché del disco del explorador y después intentarla para abrir el archivo .vsto de nuevo.

Para agregar el tipo MIME .vsto a IIS 7,0

  1. En el servidor que está ejecutando IIS 7,0, elija Inicio, Todos los programas, Accesorios.

  2. Abrir el menú contextual para Símbolo del sistema y, a continuación Ejecute como administrador.

  3. En el cuadro Abrir, escriba la ruta de acceso siguiente, y elija el botón Aceptar.

    %windir%\system32\inetsrv 
    
  4. Escriba el comando siguiente y, a continuación aplicar los nuevos valores.

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

    [!NOTA]

    Para que los cambios surtan efecto, debe reiniciar el Servicio de publicación World Wide Web, o debe esperar el proceso de trabajo para reciclar.Deberá vaciar la caché del disco del explorador y después intentarla para abrir el archivo .vsto de nuevo.

Coloque el documento de una solución en el equipo del usuario final (las personalizaciones de nivel de documento solo)

Puede copiar el documento de la solución en el equipo del usuario final para ellos creando una acción de la POST- implementación.De esta manera, el usuario no tiene que copiar manualmente el documento de la ubicación de instalación al equipo después de instalar la solución.Tendrá que crear una clase que defina la acción de la POST- implementación, compilación y publicar la solución, modifique el manifiesto de aplicación, y el re- firmar la aplicación y la implementación de manifiesto.

Los procedimientos siguientes se supone que el nombre de proyecto es ExcelWorkbook y que se publica la solución en el directorio de C:\publish en el equipo.

Bb772100.collapse_all(es-es,VS.110).gifCree una clase que defina la acción de la POST- implementación

  1. En la barra de menús, elija Archivo, Agregar y Nuevo proyecto.

  2. En el cuadro de diálogo Agregar nuevo proyecto, en el panel Plantillas instaladas, elija la carpeta Windows.

  3. En el panel Plantillas, elija la plantilla biblioteca de clases.

  4. En el campo Nombre, entre en FileCopyPDA, y elija el botón Aceptar.

  5. En Explorador de soluciones, elija el proyecto FileCopyPDA.

  6. En la barra de menús, seleccione Proyecto, Agregar referencia.

  7. En la pestaña .NET, agregue referencias a Microsoft.VisualStudio.Tools.Applications.Runtime y Microsoft.VisualStudio.Tools.Applications.ServerDocument.

  8. Cambie el nombre de la clase a FileCopyPDA, y después reemplace el contenido del archivo por el código.Este código realiza las tareas siguientes:

    • Copiar el documento en el escritorio del usuario.

    • Cambia la propiedad _AssemblyLocation de una ruta de acceso relativa a una ruta de acceso completa para el manifiesto de implementación.

    • Elimina el archivo si el usuario desinstala la solución.

    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(es-es,VS.110).gifCompile y publicar la solución

  1. En Explorador de soluciones, abra el menú contextual para el proyecto FileCopyPDA y, a continuación Compilación.

  2. Abrir el menú contextual para el proyecto ExcelWorkbook y, a continuación Compilación.

  3. Abrir el menú contextual para el proyecto ExcelWorkbook y, a continuación Agregar referencia.

  4. En el cuadro de diálogo Agregar referencia, elija la ficha Proyectos, elija FileCopyPDA, y elija el botón Aceptar.

  5. En Explorador de soluciones, elija el proyecto ExcelWorkbook.

  6. En la barra de menú, elija proyecto, Nueva carpeta.

  7. Escriba los datos, y elija la tecla ENTRAR.

  8. En Explorador de soluciones, elija la carpeta datos.

  9. En la barra de menú, elija proyecto, agregar elemento existente.

  10. En el cuadro de diálogo agregar elemento existente, vaya al directorio de salida del proyecto ExcelWorkbook, elija el archivo ExcelWorkbook.xlsx, y después elija el botón Add.

  11. En Explorador de soluciones elija el archivo ExcelWorkbook.xlsx.

  12. En la ventana propiedades, cambie la propiedad Acción de compilación a Contenido y la propiedad Copiar en el directorio de resultados a la Copia si es más reciente.

    Cuando haya completado estos pasos, el proyecto se parecerá a la siguiente ilustración.

    Estructura de proyecto de la acción posterior a la implementación.

  13. Publique el proyecto ExcelWorkbook.

Bb772100.collapse_all(es-es,VS.110).gifModifique el manifiesto de aplicación

  1. Abra el directorio de c:\publish mediante Explorador de archivos.

  2. Abra la carpeta de Archivos de aplicación, y abra la carpeta correspondiente a la versión publicada más reciente de la solución.

  3. Abra el archivo de ExcelWorkbook.dll.manifest en un editor de texto como Bloc de notas.

  4. Después del elemento de </vstav3:update>, agregue el código siguiente.Para el atributo de clase del elemento <vstav3:entryPoint>, emplee la sintaxis siguiente: nombreDeEspacioDeNombres.nombreDeClase.En el ejemplo siguiente, el espacio de nombres y los nombres de clase son iguales, por lo que el nombre resultante de punto de entrada es 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(es-es,VS.110).gifRe- firmar la aplicación y los manifiestos de implementación

  1. En la carpeta de %userprofile%\documents\visual %USERPROFILE%\Documents\Visual Studio 2012\Projects\ExcelWorkbook\ExcelWorkbook 2012\projects\excelworkbook\excelworkbook, copie el archivo de certificado de ExcelWorkbook_TemporaryKey.pfx, y péguelo en la carpeta de PublishFolder \application files\excelworkbookMostRecentPublishedVersion.

  2. Abra el símbolo del sistema de Visual Studio, y después cambie los directorios a la carpeta de c: \publish\application files\excelworkbookMostRecentPublishedVersion (por ejemplo, c: _1_0_0_4 de \publish\application files\excelworkbook).

  3. Firme el manifiesto de aplicación modificado ejecutando el comando siguiente:

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

    Aparece el mensaje "ExcelWorkbook.dll.manifest firmado correctamente".

  4. Cambie a c:\publish la carpeta y, a continuación actualizar y firmar el manifiesto de implementación ejecutando el comando siguiente:

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

    [!NOTA]

    En el ejemplo anterior, reemplace MostRecentVersionNumber con el número de versión de la versión recientemente publicada de la solución (por ejemplo, 1_0_0_4).

    Aparece el mensaje "ExcelWorkbook.vsto firmado correctamente".

  5. Copie el archivo ExcelWorkbook.vsto en el directorio de c: \publish\application files\excelworkbookMostRecentVersionNumber.

Coloque el documento de una solución en un servidor que ejecute SharePoint (las personalizaciones de nivel de documento solo)

Puede publicar la personalización de nivel de documento para los usuarios finales mediante SharePoint.Cuando los usuarios van al sitio de SharePoint y abra el documento, el runtime instalará automáticamente la solución desde la carpeta de red compartida al equipo local del usuario.Después de que la solución se instala localmente, la personalización funcionará aunque el documento se copia en otra parte, como el escritorio.

Para que el documento en un servidor que ejecuta SharePoint

  1. Agregue el documento de la solución a una biblioteca de documentos en un sitio de SharePoint.

  2. Siga los pasos para uno de los enfoques siguientes:

    • Utilice la herramienta configuración de Office para agregar el servidor que está ejecutando SharePoint al Centro de confianza de word o Excel en todos los equipos de los usuarios.

      Vea Directivas de seguridad y valores en Office 2010.

    • Asegúrese de que cada usuario realice los pasos siguientes.

      1. En el equipo local, abra word o excel, elija la ficha Archivo, y después elija el botón opciones.

      2. En el cuadro de diálogo del Centro de confianza, elija el botón Ubicaciones de confianza.

      3. Active la casilla Permita las ubicaciones de confianza en mi red (no recomendado), y después elija el botón Agregue la nueva ubicación.

      4. En el cuadro Ruta de acceso, escriba la dirección URL de la biblioteca de documentos de SharePoint que contiene el documento cargado (por ejemplo, http://SharePointServerName/TeamName/ProjectName/DocumentLibraryName).

        No agregue el nombre de la página Web predeterminada, como default.aspx o AllItems.aspx.

      5. Active la casilla Las subcarpetas de esta ubicación también se confirmarán, y después elija el botón Aceptar.

        Cuando abra los usuarios el documento desde el sitio de SharePoint, el documento se abre, y personalización está instalada.Los usuarios pueden copiar el documento en el escritorio.La personalización se ejecutará porque las propiedades en el punto del documento en la ubicación de red del documento.

Crear un instalador personalizado

Puede crear un instalador personalizado para la solución de Office, en lugar de utilizar el programa de instalación que se crea automáticamente cuando se publica la solución.Por ejemplo, podría utilizar un script de inicio de sesión para iniciar la instalación, o puede utilizar un archivo por lotes para instalar la solución sin la interacción del usuario.Funcionan mejor de estos escenarios si los requisitos previos ya están instalados en equipos de usuario final.

Como parte del proceso de instalación personalizada, llame a la herramienta de instalación para las soluciones de Office (VSTOInstaller.exe), que se instala en la siguiente ubicación de manera predeterminada:

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

Si la herramienta no está en esa ubicación, puede utilizar la clave del Registro de 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 para encontrar la ruta de acceso a esa herramienta.

Puede utilizar los siguientes parámetros con VSTOinstaller.exe.

Parámetro

Definición

/Install o /I

Instala la solución.Debe seguir esta opción con la ruta de acceso de un manifiesto de implementación.Puede especificar una ruta de acceso en el equipo local, un recurso compartido de archivos de (UNC) de la convención de nomenclatura de universal, o un sitio Web HTTP/HTTPS.Puede especificar una ruta de acceso local (C: \FolderName\PublishFolder), una ruta de acceso relativa (Publicar \), o una ubicación completa (\\ServerName\FolderName o https://ServerName/FolderName).

/Uninstall o /U

Desinstala la solución.Debe seguir esta opción con la ruta de acceso de un manifiesto de implementación.Puede especificar una ruta de acceso puede estar en el equipo local, un recurso compartido de archivos UNC, o un sitio Web HTTP/HTTPS.Puede especificar una ruta de acceso local (c: \FolderName\PublishFolder), una ruta de acceso relativa (Publicar \), o una ubicación completa (\\ServerName\FolderName o https://ServerName/FolderName).

/Silent o /S

Instale o desinstala sin solicitar al usuario una entrada o mostrar ningún mensaje.Si se requiere un mensaje relativo a la confianza, la personalización no se instala ni se actualiza.

/Help o /?

Muestra la información de Ayuda.

Cuando ejecute VSTOinstaller.exe, los códigos de error siguientes pueden aparecer.

Código de error

Definición

0

La solución se instala o desinstaló correctamente, o la Ayuda de VSTOInstaller.

-100

Una o más opciones de la línea de comandos no son válidas o se establecieron más de una vez.Para obtener más información, escriba “vstoinstaller/?” o vea Crear un instalador personalizado para una solución de Office ClickOnce.

-101

Una o más opciones de la línea de comandos no son válidas.Para obtener más información, escriba “vstoinstaller/?”.

-200

El URI del manifiesto de implementación no es válido.Para obtener más información, escriba “vstoinstaller/?”.

-201

No se pudo instalar la solución porque el manifiesto de implementación no es válido.Vea Manifiestos de implementación para soluciones de Office.

-202

No se pudo instalar la solución porque la sección de Visual Studio Tools para Office del manifiesto de aplicación no es válida.Vea Manifiestos de aplicación para soluciones de Office.

-203

No se pudo instalar la solución porque un error de descarga.Compruebe la ubicación del URI o de red del manifiesto de implementación, y después inténtelo de nuevo.

-300

No se pudo instalar la solución porque una excepción de seguridad.Vea Asegurar las soluciones de Office.

-400

No se pudo instalar la solución.

-401

No se pudo desinstalar la solución.

-500

Se ha cancelado la operación porque no se pudo instalar la solución o ser desinstalará o de implementación no pudo descargar.

Publicar una actualización

Para actualizar una solución, la publicación de nuevo mediante Diseñador de proyectos o Asistente para publicación, y después se copia la solución actualizada en la ubicación de instalación.Al copiar los archivos en la ubicación de instalación, asegúrese de que se sobrescriba los archivos anteriores.

La próxima vez que las comprobaciones de la solución una actualización, se encontrará y cargará la nueva versión automáticamente.

Cambie la ubicación de instalación de una solución

Puede agregar o cambiar la ruta de instalación una vez publicada una solución.Puede cambiar la ruta de instalación de uno o más de las siguientes razones:

  • El programa de instalación se compiló antes de que la ruta de instalación fuera conocido.

  • Los archivos de la solución se han copiado en otra ubicación.

  • El servidor que hospeda los archivos de instalación tienen un nombre o ubicación.

Para cambiar la ruta de instalación de una solución, debe actualizar el programa de instalación, y a los usuarios deben ejecutarlo.Para las personalizaciones de nivel de documento, los usuarios también deben actualizar una propiedad en el documento para señalar a la nueva ubicación.

[!NOTA]

Si no desea ordenar los usuarios actualizar sus propiedades de documento, pida a los usuarios obtengan documento actualizado de la ubicación de instalación.

Para cambiar la ruta de instalación en el programa de instalación

  1. Abra una ventana Símbolo del sistema, y después cambie los directorios a la carpeta de instalación.

  2. Ejecute el programa de instalación, e incluya el parámetro de /url, que toma la nueva ruta de instalación como una cadena.

    El ejemplo siguiente se muestra cómo cambiar la ruta de instalación a una ubicación en el sitio Web de Fabrikam, pero puede reemplazar a esa dirección URL a la ruta que desea:

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

    [!NOTA]

    Si aparece un mensaje y se indica que la firma del archivo ejecutable se ha invalidado, el certificado utilizado para firmar la solución ya no es válido, y el editor es desconocido.Como resultado, los usuarios deberán confirmar que confíen el origen de la solución antes de que puedan instalarla.

    [!NOTA]

    Para mostrar el valor actual de la dirección URL, ejecute setup.exe /url.

Para las personalizaciones de nivel de documento, los usuarios deben abrir el documento y después actualizar la propiedad de _AssemblyLocation.Los pasos siguientes describen cómo los usuarios pueden realizar esta tarea.

Para actualizar la propiedad _AssemblyLocation en un documento

  1. En la pestaña Archivo, elija Información, en la siguiente ilustración.

    Pestaña Información de Excel

  2. En la lista propiedades, elija Propiedades avanzadas, en la siguiente ilustración.

    Propiedades avanzadas de Excel.

  3. En la pestaña Personalizado en la lista propiedades, elija _AssemblyLocation, como muestra la siguiente ilustración.

    Propiedad AssemblyLocation.

    El cuadro Valor contiene el identificador del manifiesto de implementación.

  4. Delante del identificador, escriba la ruta de acceso completa del documento, seguido de una barra, con el formato Ruta de acceso |identificador (por ejemplo, File://ServerName/FolderName/FileName|74744e4b-e4d6-41eb-84f7-ad20346fe2d9.

    Para obtener más información sobre cómo dar formato a este identificador, vea Información general sobre propiedades personalizadas del documento.

  5. Elija el botón Aceptar, y después guarde y cierre el documento.

  6. Ejecute el programa de instalación sin el parámetro de /url para instalar la solución en la ubicación especificada.

Revertir una solución a una versión anterior

Cuando se revierte una solución, se revertiría a usuarios a una versión anterior de esa solución.

Para revertir una solución

  1. Abra la ubicación de instalación de la solución.

  2. En la carpeta de publicación de nivel superior, elimine el manifiesto de implementación (el archivo .vsto).

  3. Busque la subcarpeta para la versión a la que desea revertir.

  4. Copie el manifiesto de implementación de esa subcarpeta en la carpeta de publicación de nivel superior.

    Por ejemplo, para revertir una solución denominada OutlookAddIn1 desde la versión 1.0.0.1 a la versión 1.0.0.0, copie el archivo OutlookAddIn1.vsto desde la carpeta de OutlookAddIn1_1_0_0_0.Pegue el archivo en la carpeta de publicación de nivel superior, sobrescribiendo el manifiesto de implementación versión- concreto para OutlookAddIn1_1_0_0_1 que ya estaba allí.

    La ilustración siguiente muestra la estructura de carpetas de publicación en este ejemplo.

    Estructura de carpetas de la carpeta de publicación

    La próxima vez que abra que un usuario la aplicación o el documento personalizado, se detecta el cambio del manifiesto de implementación.La versión anterior de la solución de Office se ejecutará desde la caché de ClickOnce.

[!NOTA]

Los datos locales se guardan para una sola versión anterior de una solución.Si se ejecutan dos versiones posteriores, los datos locales no se conservan.Para obtener más información sobre los datos locales, vea Obtener acceso local o remoto a los datos en aplicaciones ClickOnce.

Vea también

Otros recursos

Implementar una solución de Office

Implementar una solución de Office mediante ClickOnce

Cómo: Publicar una solución de Office usando ClickOnce

Cómo: Instalar una solución de Office ClickOnce

Cómo: Publicar una solución de Office de nivel de documento en un servidor de SharePoint usando ClickOnce

Crear un instalador personalizado para una solución de Office ClickOnce