Implementar personalizaciones de nivel de documento (2003 System)

Actualización: noviembre 2007

La implementación de una personalización de nivel de documento para Microsoft Office Word 2003 o Microsoft Office Excel 2003 generalmente implica trabajar con cuatro archivos:

• El archivo de Word o Excel (plantilla, documento o libro) en que trabaja el usuario final.

• El ensamblado que contiene el código personalizado compilado y cualquier ensamblado dependiente, por ejemplo, recursos, satélites o bibliotecas auxiliares.

• El manifiesto de implementación (cuando corresponde).

• El manifiesto de aplicación (cuando corresponde).

Cuando implemente la solución, tenga en cuenta las siguientes instrucciones básicas:

• Los usuarios deben tener instalado .NET Framework. Para obtener más información, vea Redistribuir.NET Framework y Trabajar con varias versiones de .NET Framework.

• Los usuarios deben tener instalado el motor en tiempo de ejecución de Visual Studio Tools para Office. Para obtener más información, vea Cómo: Preparar equipos de usuarios finales para ejecutar soluciones de Office (2003 System).

• Todos los usuarios finales al menos deben tener acceso de lectura al documento de Office y al ensamblado.

• Tanto el documento como el ensamblado deben tener plena confianza para que funcione la solución de Word o de Excel. Si el documento está almacenado en el equipo del usuario, normalmente se concede plena confianza al documento de forma automática. Sin embargo, un ensamblado en el equipo del usuario no recibe automáticamente plena confianza. Para obtener más información, vea Seguridad en las soluciones de Office (2003 System).

Para implementar la solución, se copia el documento y el ensamblado y, opcionalmente, el manifiesto de aplicación e implementación en la ubicación de implementación. Para obtener más información sobre estos tipos de implementación, vea Modelos de implementación (2003 System).

Visual Studio Tools para Office incluye el Asistente para publicación, que crea los manifiestos de aplicación e implementación y copia automáticamente todos los archivos en la ubicación de implementación. Sin embargo, también puede realizar manualmente estos pasos. Para obtener más información, vea Cómo: Implementar soluciones de Office (2003 System) y Cómo: Implementar archivos de soluciones mediante el Asistente para publicación (2003 System).

Asistente para publicación

El comando Publicar del menú de acceso directo del proyecto del Explorador de soluciones inicia el Asistente para publicación. Se identifica la ubicación de la carpeta en que desea publicar la solución y el asistente copia el documento y el manifiesto de implementación en la carpeta. Para obtener más información, vea Cómo: Implementar archivos de soluciones mediante el Asistente para publicación (2003 System).

El asistente también copia los ensamblados y un manifiesto de aplicación actualizado en una subcarpeta de la carpeta de implementación principal. La subcarpeta contiene un número de versión. Si la opción Incrementar revisión automáticamente con cada lanzamiento está activada en el panel Publicar del Diseñador de proyectos, se creará una nueva subcarpeta cada vez que publique la solución. Las versiones anteriores siguen estando disponibles. Los manifiestos de aplicación e implementación se aseguran de que la solución siempre utilice el ensamblado actual. Para obtener más información, vea Manifiestos de implementación y aplicación en soluciones de Office, Cómo: Implementar archivos de soluciones mediante el Asistente para publicación (2003 System), Página Publicar, Diseñador de proyectos (2003 System) y Asistente para publicación (2003 System).

Actualizar ensamblados implementados (control de versiones)

Si implementa una solución denominada ExcelWorkbook1 en la carpeta C:\DeployFolder, la estructura de archivos tendrá la apariencia siguiente:

C:\DeployFolder

Esta carpeta contiene los dos archivos y subcarpeta siguientes:

• El libro (ExcelWorkbook1.xls).

• El manifiesto de implementación (ExcelWorkbook1.application).

  C:\DeployFolder\ExcelApplication1_1.0.0.0

  Esta carpeta contiene los siguientes archivos:

  • Los ensamblados.

  • El manifiesto de aplicación (ExcelWorkbook1.dll.manifest).

  • Una copia del libro.

  • Una copia del manifiesto de implementación.

Si actualiza el ensamblado y vuelve a publicar la solución, la estructura de directorios tendrá la apariencia siguiente:

C:\DeployFolder

Esta carpeta contiene los dos archivos y subcarpetas siguientes:

• El libro (con un manifiesto de aplicación incrustado actualizado).

• El manifiesto de implementación (actualizado para indicar el manifiesto de aplicación en C:\DeployFolder\ExcelWorkbook1_1.0.0.1).

  C:\DeployFolder\ExcelWorkbook1_1.0.0.0

  Esta carpeta contiene los siguientes archivos:

  • Los ensamblados originales.

  • El manifiesto de aplicación original.

  • El libro original.

  • El manifiesto de implementación original.

  C:\DeployFolder\ExcelWorkbook1_1.0.0.1

  Esta carpeta contiene los siguientes archivos:

  • Los ensamblados actualizados.

  • El manifiesto de aplicación actualizado.

  • Una copia del libro actualizado.

  • Una copia del manifiesto de implementación actualizado.

Esta estructura se repetirá cada vez que actualice el ensamblado. Si actualiza el documento o el libro para que ya no sea compatible con el ensamblado existente, debe implementar la solución en una nueva carpeta de implementación.

Utilizar MSBuild en el símbolo del sistema

Puede utilizar MSBuild en el símbolo de sistema para publicar su solución. Cuando utiliza MSBuild en el símbolo del sistema, puede publicar sus archivos de solución en una ubicación y modificar simultáneamente el manifiesto de aplicación incrustado en el libro o documento para que señale a un manifiesto de implementación almacenado en una ubicación diferente. Si desea ejecutar MSBuild en el símbolo del sistema para publicar su solución, utilice la sintaxis siguiente.

msbuild.exe /target:Publish /property:UpdateUrl=<update location> /property:PublishDir=<publish location> <project file>

Por ejemplo, si desea publicar un proyecto de C# denominado ExcelWorkbook1 en la carpeta compartida \\PublishServer\PublishFolder, pero en el futuro espera mover el manifiesto de implementación, el manifiesto de aplicación externo y el ensamblado a la carpeta compartida \\DeploymentServer\DeploymentFolder, debe ejecutar el siguiente comando.

msbuild.exe /target:Publish /property:PublishDir=\\PublishServer\PublishFolder\ /property:UpdateUrl=\\DeploymentServer\DeploymentFolder\ C:\ExcelWorkbook1\ExcelWorkbook1.csproj

Para obtener más información sobre el uso de MSBuild en el símbolo del sistema, vea Generar aplicaciones ClickOnce desde la línea de comandos.

Manifiestos de aplicación e implementación

Los manifiestos de aplicación e implementación se utilizan para permitir que un documento se actualice con el último ensamblado. Para obtener más información, vea Manifiestos de implementación y aplicación en soluciones de Office.

Actualizar manifiestos de implementación

Puede cambiar el manifiesto de implementación de una solución varias veces durante el período de duración de la solución. Existen dos razones principales por las cuales debería actualizar el manifiesto de implementación:

• Se implementa una nueva versión del ensamblado de solución. Para obtener más información, vea Cómo: Actualizar los archivos de ensamblado implementados (2003 System).

• Se cambia la ubicación del ensamblado de solución. Para obtener más información, vea Cómo: Cambiar la ubicación de las personalizaciones de nivel de documento (2003 System).

Actualizar manifiestos de aplicación

Es posible que nunca tenga que actualizar directamente un manifiesto de aplicación existente que esté en uso en una solución. Normalmente, se crea un nuevo manifiesto de aplicación y se utiliza el manifiesto de implementación para cargar el nuevo manifiesto de aplicación en la solución. Sin embargo, existen dos razones principales por las cuales es posible que desee actualizar un manifiesto de aplicación directamente en un documento:

• El manifiesto de implementación y los ensamblados se han desplazado a un nuevo servidor porque el servidor original está fuera de servicio. En este caso, debe cambiar las rutas de acceso a esos elementos en el manifiesto de aplicación. Para obtener más información, vea Cómo: Cambiar la ubicación de las personalizaciones de nivel de documento (2003 System).

• Desea quitar el manifiesto de aplicación del documento. Por ejemplo, es posible que desee archivar el documento, y no desee que éste ejecute código y posiblemente cambie, o es posible que desee enviar el documento completo del grupo de trabajo sin ninguna referencia al código. Para obtener más información, vea Cómo: Quitar extensiones de código administrado de documentos (2003 System).

Implementación de soluciones de Microsoft Office localizadas

La mayoría de los aspectos de la implementación de versiones localizadas de soluciones de Visual Studio Tools para Office son los mismos que se encuentran cuando se implementan otros tipos de soluciones con Visual Studio. Sin embargo, existen algunas consideraciones adicionales con respecto a crear y distribuir versiones localizadas de soluciones de Visual Studio Tools para Office. Para obtener más información, vea Globalización y localización de las soluciones de Office, Cómo: Adaptar soluciones de Office y Implementación y localización.

Vea también

Tareas

Cómo: Preparar equipos de usuarios finales para ejecutar soluciones de Office (2003 System)

Cómo: Implementar soluciones de Office (2003 System)

Conceptos

Implementar soluciones de Office (2003 System)

Implementar complementos de nivel de aplicación (2003 System)

Modelos de implementación (2003 System)

Modelo sin conexión para soluciones de Office (2003 System)

Implementación segura (2003 System)

Otros recursos

Implementar aplicaciones y componentes