Crear el primer complemento de panel de tareas de PowerPoint

  • Artículo
  • Tiempo de lectura: 9 minutos

Este artículo le guiará a través del proceso de creación de un complemento de panel de tareas de PowerPoint.

Crear el complemento

Puede crear un complemento de Office con el generador de Yeoman para complementos de Office o Visual Studio. El generador Yeoman crea un proyecto de Node.js que se puede administrar con Visual Studio Code u otro editor, mientras que Visual Studio crea una solución de Visual Studio. Seleccione la pestaña del que le gustaría usar y, después, siga las instrucciones para crear el complemento y probarlo localmente.

Requisitos previos

Nota:

Si no está familiarizado con Node.js o npm, debe empezar por configurar el entorno de desarrollo.

  • Node.js (la última versión de LTS).

  • La versión más reciente de Yeoman y Generador de Yeoman para complementos de Office. Para instalar estas herramientas globalmente, ejecute el siguiente comando desde el símbolo del sistema.

    npm install -g yo generator-office

    Nota:

    Incluso si ya ha instalado el generador Yeoman, recomendamos que actualice el paquete de la versión más reciente desde npm.

Creación del proyecto de complemento

Ejecute el siguiente comando para crear un proyecto de complemento con el generador Yeoman.

yo office

Nota:

Cuando ejecute el comando yo office, es posible que reciba mensajes sobre las directivas de recopilación de datos de Yeoman y las herramientas de la CLI de complementos de Office. Use la información adecuada que se proporciona para responder a los mensajes.

Cuando se le pida, proporcione la siguiente información para crear el proyecto de complemento.

  • Elija un tipo de proyecto:Office Add-in Task Pane project
  • Elija un tipo de script:Javascript
  • ¿Cómo desea asignarle el nombre al complemento?My Office Add-in
  • ¿Qué aplicación cliente de Office le gustaría admitir?PowerPoint

Captura de pantalla que muestra las preguntas y respuestas del generador Yeoman en una interfaz de línea de comandos.

Después de completar el asistente, el generador creará el proyecto e instalará componentes auxiliares de Node.

Sugerencia

Se pueden pasar por alto las instrucciones de los pasos siguientes que el generador de Yeoman ofrece después de que se haya creado el proyecto de complemento. Las instrucciones paso a paso de este artículo le dan toda la información que necesitará para completar este tutorial.

Explorar el proyecto

El proyecto de complemento que ha creado con el generador Yeoman contiene código de ejemplo para un complemento de panel de tareas básico. Si quiere explorar los componentes del proyecto de complemento, abra el proyecto en el editor de código y revise los archivos que se enumeran a continuación. Cuando esté listo para probar el complemento, vaya a la sección siguiente.

  • El archivo ./manifest.xml en el directorio raíz del proyecto define la configuración y las funciones del complemento. Para obtener más información sobre el archivo manifest.xml, vea manifiesto XML de complementos de Office.
  • El archivo ./src/taskpane/taskpane.html contiene el marcado HTML para el panel de tareas.
  • El archivo ./src/taskpane/taskpane.css contiene la CSS que se aplica al contenido en el panel de tareas.
  • El archivo ./src/taskpane/taskpane.js contiene el código de la API de JavaScript de Office que facilita la interacción entre el panel de tareas y la aplicación cliente de Office.

Pruébelo

  1. Navegue hasta la carpeta raíz del proyecto.

    cd "My Office Add-in"

  2. Complete los pasos siguientes para iniciar el servidor web local y transferir localmente el complemento.

    Nota:

    Los complementos de Office deben usar HTTPS y no HTTP, incluso cuando está desarrollando. Si le pedirá que instale un certificado después de ejecutar uno de los siguientes comandos, acepte la solicitud para instalar el certificado que proporciona el generador Yeoman. Es posible que también deba ejecutar el símbolo del sistema o el terminal como administrador para que se realicen los cambios.

    Sugerencia

    Si está probando el complemento en Mac, ejecute el siguiente comando antes de continuar. Al ejecutar este comando, se iniciará el servidor web local.

    npm run dev-server

    • Para probar el complemento en PowerPoint, ejecute el siguiente comando en el directorio raíz del proyecto. Se iniciará el servidor web local (si todavía no está en ejecución) y se abrirá PowerPoint con el complemento cargado.

      npm start

    • Para probar el complemento en PowerPoint en un explorador, ejecute el siguiente comando en el directorio raíz del proyecto. Al ejecutar este comando, se iniciará el servidor web local. Reemplace "{url}" por la dirección URL de un documento de PowerPoint en OneDrive o en una biblioteca de SharePoint para 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

      Nota:

      Si va a desarrollar en un Equipo Mac, incluya entre {url} comillas simples. No haga esto en Windows.

      Si el complemento no se carga localmente en el documento, desinstalándolo manualmente siguiendo las instrucciones de Instalación local manual de complementos en Office en la Web.

  3. En PowerPoint, inserte una nueva diapositiva en blanco, seleccione la pestaña Inicio y, después, haga clic en el botón Mostrar panel de tareas de la cinta de opciones para abrir el panel de tareas del complemento.

    Captura de pantalla de PowerPoint con el botón Mostrar panel de tareas resaltado.

  4. En la parte inferior del panel de tareas seleccione el vínculo Ejecutar para insertar el texto «Hola, mundo» en la diapositiva actual.

    Captura de pantalla de PowerPoint con una imagen de un perro y el texto «Hola, mundo» mostrados en la diapositiva.

Pasos siguientes

Enhorabuena, ha creado correctamente un complemento de panel de tareas de PowerPoint. Ahora, obtenga más información sobre las funciones de un complemento de PowerPoint y cree un complemento más complejo siguiendo este tutorial de complementos de PowerPoint.

Consulte también