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.

¿Le parece bien hasta ahora? Eche un vistazo a este vídeo de un minuto para ver el funcionamiento del laboratorio de scripts.

Vídeo en versión preliminar que muestra Script Lab 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.

Muestras.

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 red de entrega de contenido (CDN) beta (https://appsforoffice.microsoft.com/lib/beta/hosted/office.js) y las definiciones de los 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.

  • Office en Windows*
  • Office 2016 o posterior en Mac
  • Office en la web

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

  • Outlook en Windows*
  • 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 versión de Office que usan Internet Explorer para hospedar complementos. Esto incluye versiones perpetuas 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