Fase de un complemento de Office en Microsoft Azure con Visual Studio

El complemento de Office más sencillo se compone de un archivo de manifiesto y una página HTML. El archivo de manifiesto describe las características del complemento, como su nombre, en qué clientes de escritorio de Office se puede ejecutar y la dirección URL de la página HTML del complemento. La página HTML se encuentra en una aplicación web con la que interactúan los usuarios y ejecutan el complemento en una aplicación cliente de Office. La aplicación web de un complemento de Office se puede hospedar en cualquier plataforma de hospedaje web, incluida Azure.

En este artículo se describe cómo implementar una aplicación web de complemento en Azure y transferir localmente el complemento para probarlo en una aplicación cliente de Office.

Requisitos previos

1. Instale Visual Studio 2022 y elija incluir la carga de trabajo desarrollo de Azure .

   Nota:

   Si ya ha instalado Visual Studio 2022, use el Instalador de Visual Studio para asegurarse de que la carga de trabajo de desarrollo de Azure está instalada.

2. Instalar Office.

   Nota:

   Si todavía no tiene Office, puede registrarse para obtener una prueba gratuita de 1 mes.

3. Obtener una suscripción de Azure.

   Nota:

   Si aún no tiene una suscripción de Azure, puede obtenerla como parte de la suscripción a Visual Studio o registrarse para obtener una prueba gratuita.

Paso 1: Crear una carpeta compartida para hospedar el archivo de manifiesto del complemento

1. Abra el Explorador de archivos en el equipo de desarrollo.

2. Haga clic con el botón derecho (o mantenga presionada) la unidad C:\ y, a continuación, elija Nueva>carpeta.

3. Asígnele a la nueva carpeta el nombre AddinManifests.

4. Haga clic con el botón derecho (o seleccione y mantenga presionado) la carpeta AddinManifests y, a continuación, elija Compartir con>personas específicas.

5. En Uso compartido de archivos, elija la flecha desplegable y elija Todos>Agregar>Compartir.

Paso 2: Agregar el archivo compartido al catálogo de complementos de confianza

1. Inicie Word y cree un documento.

   Nota:

   Aunque en este ejemplo se usa Word, puede usar cualquier aplicación de Office que admita complementos de Office como Excel, PowerPoint o Project.

2. Seleccione Archivo>Opciones.

3. En el cuadro de diálogo Opciones de Word, elija Centro de confianza y luego, Configuración del Centro de confianza.

4. En el cuadro de diálogo Centro de confianza, elija Catálogos de complementos de confianza. Escriba la ruta de acceso de convención de nomenclatura universal (UNC) para el recurso compartido de archivos que creó anteriormente como dirección URL del catálogo (por ejemplo, \\YourMachineName\AddinManifests) y, a continuación, elija Agregar catálogo.

5. Active la casilla Mostrar en el menú.

   Nota:

   Al almacenar un archivo de manifiesto de complemento en un recurso compartido que se especifica como un catálogo de complementos web de confianza, el complemento aparece en Carpeta compartida en el cuadro de diálogo Complementos de Office que se inicia desdeComplementos> de inicio>Obtener complementos.

6. Cierre Word.

Paso 3: Crear un complemento de Office en Visual Studio

1. Inicie Visual Studio como administrador.

2. Seleccione Crear un nuevo proyecto.

3. Utilizando el cuadro de búsqueda, escribacomplemento.

4. Seleccione Complemento web de Word como tipo de proyecto y después Siguiente para aceptar la configuración predeterminada.

Visual Studio crea un complemento básico de Word que podrá publicar tal como está, sin realizar ningún cambio en su proyecto web. Para crear un complemento para una aplicación de Office diferente, como Excel, repita los pasos y elija un tipo de proyecto con la aplicación de Office deseada.

Paso 4: Publicación de la aplicación web de complemento de Office en Azure

1. Con el proyecto de complemento abierto en Visual Studio, haga clic con el botón derecho (o seleccione y mantenga presionado) el proyecto web y, a continuación, elija Publicar.

2. Siga las instrucciones de Publicación de la aplicación web. Omita las secciones de artículo que preceden a Publicar la aplicación web, pero asegúrese de que el botón de Visual Studio está seleccionado en la parte superior de la página.

   Visual Studio publica el proyecto web del complemento de Office en la aplicación web de Azure. Cuando Visual Studio termina de publicar el proyecto web, el explorador se abre y muestra una página web con el texto "La aplicación web se está ejecutando y esperando el contenido". Esta es la página predeterminada actual de la aplicación web.

3. Copie la dirección URL raíz (por ejemplo: https://YourDomain.azurewebsites.net); la necesitará al editar el archivo de manifiesto del complemento más adelante en este artículo.

Paso 5: Edición e implementación del archivo de manifiesto del complemento

1. En Visual Studio, con el complemento de Office de ejemplo abierto en el Explorador de soluciones, expanda la solución para que aparezcan ambos proyectos.

2. Expanda el proyecto de complemento de Office (por ejemplo, WordWebAddIn), haga clic con el botón derecho (o mantenga presionada) la carpeta del manifiesto y, a continuación, elija Abrir. Se abre el archivo de manifiesto del complemento.

3. En el archivo de manifiesto, busque y reemplace todas las instancias de "~remoteAppUrl" por la dirección URL raíz de la aplicación web del complemento en Azure. Esta es la dirección URL que copió anteriormente después de publicar la aplicación web del complemento en Azure (por ejemplo: https://YourDomain.azurewebsites.net).

4. Seleccione Archivo y luego Guardar todo. A continuación, copie el archivo de manifiesto del complemento (por ejemplo, WordWebAddIn.xml).

5. Con el programa Explorador de archivos, busque el recurso de archivo compartido de la red que creó en el Paso 1: Crear una carpeta compartida y pegue el archivo de manifiesto en la carpeta.

Paso 6: Insertar y ejecutar el complemento en la aplicación cliente de Office

1. Inicie Word y cree un documento.

2. SeleccioneComplementos de inicio> y, a continuación, seleccione Obtener complementos.

3. En el cuadro de diálogo Complementos de Office, seleccione CARPETA COMPARTIDA. Word busca la carpeta que se incluyó en la lista como catálogo de complementos de confianza (en Paso 2: Agregar el recurso compartido al catálogo de complementos de confianza) y muestra los complementos en el cuadro de diálogo. Debe verse un icono del complemento de ejemplo.

4. Elija el icono del complemento y luego Agregar. Se agrega un botón Mostrar panel de tareas para el complemento a la cinta de opciones.

5. En la cinta de opciones de la pestaña Inicio, elija el botón Mostrar panel de tareas. El complemento se abre en un panel de tareas a la derecha del documento actual.

6. Compruebe que el complemento funciona seleccionando algún texto del documento y eligiendo el botón Resaltar en el panel de tareas.

Implementar actualizaciones

Implementará las actualizaciones en la aplicación web de la misma manera que se describió anteriormente. Los cambios en el manifiesto requieren redistribuir el manifiesto a los usuarios. El proceso para hacerlo depende del método de publicación. Para obtener más información sobre cómo actualizar el complemento, vea Mantener el complemento de Office.

Ver también

• Publicar el complemento de Office
• Publicar el complemento con Visual Studio