Explorar la API de JavaScript de Office con el laboratorio de scripts

Los complementos Laboratorio de scripts, y Laboratorio de scripts para Outlook que están disponibles de forma gratuita en AppSource, le permiten explorar la API de JavaScript para Office mientras trabaja en un programa de Office como Excel o Word. El Laboratorio de scripts es una herramienta muy útil que puede agregar al kit de herramientas de desarrollo al crear prototipos y comprobar la funcionalidad que desea tener en su propio complemento.

¿Qué es un laboratorio de scripts?

El Laboratorio de scripts es una herramienta destinada a cualquier persona que quiera aprender a desarrollar complementos de Office mediante la API de JavaScript para Office en Excel, Outlook, Word y PowerPoint. Proporciona IntelliSense, que le permite ver lo que está disponible, y se basa en el marco Mónaco, el mismo marco que Visual Studio Code usa. Por medio del laboratorio de scripts, puede acceder a una biblioteca de ejemplos para probar rápidamente las características o incluso usar un ejemplo como punto de partida para su propio código. También puede usar el laboratorio de scripts para probar las versiones preliminares de las API.

¿Qué le parece hasta ahora? Eche un vistazo a este vídeo de un minuto para ver el laboratorio de scripts en acción.

Vista previa del vídeo que muestra el laboratorio de scripts ejecutándose en Excel, Word y PowerPoint.

Características principales

El laboratorio de scripts ofrece varias características que le ayudarán a explorar la API de JavaScript de Office y a crear prototipos de la funcionalidad del complemento.

Explorar ejemplos

Empiece a trabajar rápidamente con una colección de fragmentos de código de ejemplo integrados que muestran cómo completar tareas con la API. Puede ejecutar los ejemplos para ver instantáneamente el resultado en el panel de tareas o en el documento, analizar los ejemplos para obtener información sobre cómo funciona la API e incluso usar ejemplos para crear prototipos de su propio complemento.

Ejemplos.

Código y estilo

Además del código de JavaScript o TypeScript que llama a la API de JavaScript de Office, cada fragmento de código contiene también el marcado HTML que define el contenido del panel de tareas y el estilo de CSS que define la apariencia del panel de tareas. Puede personalizar el marcado HTML y los estilos de CSS para experimentar con el estilo y la posición de los elementos a medida que crea prototipos de diseño del panel de tareas para su propio complemento.

Sugerencia

Para llamar a las API de vista previa en un fragmento de código, deberá actualizar las bibliotecas de fragmentos de código para usar la CDN beta (https://appsforoffice.microsoft.com/lib/beta/hosted/office.js) beta y las definiciones de tipos de versión preliminar @types/office-js-preview. Además, a algunas API en versión preliminar solo podrá acceder si se ha suscrito al programa Office Insider y está ejecutando una compilación de Insider de Office.

Guardar y compartir fragmentos de código

De forma predeterminada, los fragmentos de código que se abren en el laboratorio de scripts se guardan en la memoria caché del explorador. Para guardar un fragmento de código de forma permanente, puede exportarlo a un gist de GitHub. Cree un gist secreto si quiere guardar el fragmento de código exclusivamente para su uso personal y cree uno público si tiene previsto compartirlo con otros usuarios.

Opciones de uso compartido.

Importar fragmentos de código

Para importar un fragmento de código en el laboratorio de scripts, puede especificar la dirección URL del gist de GitHub público donde se almacena el fragmento de código YAML o pegar el YAML completo del fragmento de código. Esta característica puede resultar útil en los casos en que otra persona haya compartido con usted un fragmento de código publicándolo en un gist de GitHub o proporcionando el YAML del fragmento de código.

Opción de importación de fragmento de código.

Clientes compatibles

El laboratorio de scripts es compatible con Excel, Word y PowerPoint en los siguientes clientes.

  • Suscripción a Microsoft 365
  • Office 2016 o posterior en Mac
  • Office en la web

El laboratorio de scripts para Outlook está disponible en los siguientes clientes.

  • Suscripción a Microsoft 365
  • Outlook 2016 o posterior en Mac
  • Outlook en la web al usar los exploradores Chrome, Microsoft Edge o Safari

Para obtener más información sobre el Laboratorio de scripts para Outlook, vea la entrada de blog relacionada.

Importante

Script Lab ya no funciona con combinaciones de plataforma y las versiones de Office que usan Internet Explorer para alojar complementos. Esto incluye las versiones de compra de pago único de Office a través de Office 2019. Para más información, consulte Exploradores usados por complementos de Office.

Siguientes pasos

Para usar el laboratorio de scripts en Excel, Word o PowerPoint, instale el complemento Laboratorio de scripts desde AppSource.

Para usar el Laboratorio de scripts para Outlook, instale Laboratorio de scripts para complementos de Outlook desde AppSource.

Si lo desea, puede ayudar a ampliar la biblioteca de ejemplos del laboratorio de scripts contribuyendo con nuevos fragmentos de código en el repositorio de GitHub de office-js-snippets.

Cuando quiera crear su primer complemento de Office, pruebe el inicio rápido de Excel, Outlook, Word, OneNote, PowerPoint o Project.

Consulta también