Transferir localmente complementos de Office en Office en la web para pruebas

Cuando se descarga localmente un complemento, se puede instalar el complemento sin colocarlo primero en el catálogo de complementos. Esto resulta útil al probar y desarrollar el complemento porque puede ver cómo aparecerá y funcionará el complemento.

Al cargar localmente un complemento, el manifiesto del complemento se almacena en el almacenamiento local del explorador, por lo que si borra la memoria caché del explorador o cambia a otro explorador, tendrá que volver a cargar localmente el complemento.

La instalación local varía entre aplicaciones host (por ejemplo, Excel).

Nota

La instalación local como se describe en este artículo se admite en Excel, OneNote, PowerPoint y Word. Para transferir de forma local un complemento de Outlook, consulte Transferir localmente complementos de Outlook para pruebas.

Transferencia local de un complemento de Office en Office en la web

Este proceso es compatible solo Excel, OneNote, PowerPoint y Word. Para otras aplicaciones host, vea las instrucciones de instalación local manual en la sección siguiente. En este proyecto de ejemplo se supone que se usa un proyecto creado con el generador de Yeoman paraOffice complementos .

  1. Abra Office en la Web. Con la opción Crear, cree un documento en Excel, OneNote, PowerPoint, o Word. En este nuevo documento, seleccione Compartir en la cinta de opciones, seleccione Copiar vínculo y copie la dirección URL.

  2. En el directorio raíz de los archivos de proyecto de yo office, abra el archivo package.json. Dentro de la sección config de este archivo, cree una "document" propiedad. Pegue la dirección URL que copió como valor de la "document" propiedad. Por ejemplo, el tuyo tendrá un aspecto parecido a este:

      "config": {
        "document": "<YOUR URL>",
        ...
      }
    

    Sugerencia

    Si va a crear un complemento que no usa nuestro generador de Yeoman, puede agregar parámetros de consulta a la dirección URL del documento anexando lo siguiente a la dirección URL existente.

    • El puerto del servidor de desarrollo, como &wdaddindevserverport=3000 .
    • El nombre del archivo de manifiesto, como &wdaddinmanifestfile=manifest1.xml .
    • Guid del manifiesto, como &wdaddinmanifestguid=05c2e1c9-3e1d-406e-9a91-e9ac64854143 .

    Si usa el generador de Yeoman, no es necesario agregar esta información, ya que las herramientas de Yeoman anexan esta información automáticamente. Tenga en cuenta que en ambos casos, sin embargo, solo puede cargar manifiestos desde localhost.

  3. En la línea de comandos que comienza en el directorio raíz del proyecto, ejecute el siguiente comando. Reemplace "{url}" por la dirección URL de un documento Office en su OneDrive o una biblioteca SharePoint a la que tenga permisos.

    npm run start:web -- --document {url}
    

    Estos son algunos ejemplos.

    • npm run start:web -- --document https://contoso.sharepoint.com/:t:/g/EZGxP7ksiE5DuxvY638G798BpuhwluxCMfF1WZQj3VYhYQ?e=F4QM1R
    • npm run start:web -- --document https://1drv.ms/x/s!jkcH7spkM4EGgcZUgqthk4IK3NOypVw?e=Z6G1qp
    • npm run start:web -- --document https://contoso-my.sharepoint-df.com/:t:/p/user/EQda453DNTpFnl1bFPhOVR0BwlrzetbXvnaRYii2lDr_oQ?e=RSccmNP

    Si el complemento no se descarga localmente en el documento, siga manualmente las instrucciones de Sideload Office Add-ins in Office en la Web manual .

  4. La primera vez que use este método para descargar localmente un complemento en la web, verá un cuadro de diálogo que le pedirá que habilite el modo de desarrollador. Active la casilla habilitar el modo de desarrollador ahora y seleccione Aceptar.

  5. Verá un segundo cuadro de diálogo en el que se le pregunta si desea registrar un Office de complemento desde el equipo. Debe seleccionar .

  6. El complemento está instalado. Si es un comando de complemento, debería aparecer en la cinta de opciones o en el menú contextual. Si se trata de un complemento de panel de tareas, debería aparecer el panel de tareas.

Instalación local de Office complemento de Office en la Web manualmente

Este método no usa la línea de comandos y se puede realizar mediante comandos solo dentro de la aplicación host (como Excel).

  1. Abra Office en la Web. Abra un documento en Excel, Word o PowerPoint. En la pestaña Insertar de la cinta de opciones de la sección Complementos, elija Office complementos.

  2. En el cuadro de diálogo Office Complementos, seleccione la pestaña MIS COMPLEMENTOS, elija Administrar mis complementos y, a continuación, Upload Mi complemento.

    El cuadro de diálogo Office complementos con una lista desplegable en la parte superior derecha que lee "Administrar mis complementos" y una lista desplegable debajo de él con la opción "Upload Mi complemento".

  3. Busque en el archivo de manifiesto de complementos y, después, seleccione Cargar.

    Cuadro de diálogo de carga del complemento con los botones para examinar, cargar y cancelar.

  4. Compruebe que el complemento está instalado. Por ejemplo, si es un comando de complemento, aparecerá en la cinta o en el menú contextual. Si es un complemento de panel de tareas, se mostrará el panel.

Nota

Para probar el complemento Office con Microsoft Edge con el WebView original (EdgeHTML), se requiere un paso de configuración adicional. En un Windows de comandos, ejecute la siguiente línea: npx office-addin-dev-settings appcontainer EdgeWebView --loopback --yes . Esto no es necesario cuando Office está usando el Chromium web perimetral basado en Chromium web2. Para más información, consulte Exploradores usados por complementos de Office.

Importante

La herramienta de configuración de office-addin-dev-settings no es compatible con Mac.

Instalación local de Office complemento

  1. Inicie sesión en su Microsoft 365 cuenta.

  2. Abra el panel Selector aplicación en el extremo izquierdo de la barra de herramientas y seleccione Excel , Word o PowerPoint y, a continuación, cree un nuevo documento.

  3. Los pasos de 3 a 6 son los mismos que en la sección anterior Transferencia local de un complemento de Office en Office en la web.

Transferencia local de un complemento con Visual Studio

Si está usando Visual Studio para desarrollar el complemento, el proceso de instalación local es similar a la instalación local manual en la web. La única diferencia es que tendrá que actualizar el valor del elemento SourceURL del manifiesto para incluir la dirección URL completa donde se implementa el complemento.

Nota

Aunque puede transferir localmente complementos de Visual Studio en Office en la web, no puede depurarlos desde Visual Studio. Para hacerlo, tendrá que usar las herramientas de depuración del explorador. Para obtener más información, vea Depurar complementos en Office en la web.

  1. En Visual Studio, haga que se muestre la ventana Propiedades seleccionando Vista > Ventana Propiedades.
  2. En el Explorador de soluciones, seleccione el proyecto web. Esto hará que se muestren las propiedades del proyecto en la ventana Propiedades.
  3. En la venta Propiedades, copie la URL de SSL.
  4. En el proyecto de complemento, copie el archivo XML de manifiesto. Asegúrese de que está editando el XML de origen. Para algunos tipos de proyecto, Visual Studio abrirá una vista visual del XML que no funcionará para el siguiente paso.
  5. Busque y reemplace todas las instancias de ~remoteAppUrl/ con la URL de SSL que acaba de copiar. Verá varios reemplazos según el tipo de proyecto y las nuevas URL serán similares a https://localhost:44300/Home.html.
  6. Guarde el archivo XML.
  7. Haga clic derecho en el proyecto web y elija Depurar > Iniciar nueva instancia. Esto ejecutará el proyecto web sin iniciar Office.
  8. En Office en la web, realice una transferencia local de los complementos con los pasos descritos anteriormente en Transferencia local de un complemento de Office en Office en la web.

Quitar un complemento de instalación local

Puede quitar un complemento cargado previamente borrando la memoria caché del explorador. Si realiza cambios en el manifiesto del complemento (por ejemplo, actualizar nombres de archivo de iconos o texto de comandos de complemento), es posible que tenga que borrar la memoria caché del explorador y, a continuación, volver a cargar el complemento mediante el manifiesto actualizado. Si lo hace, Office en la Web representará el complemento tal como se describe en el manifiesto actualizado.

Vea también