Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Script Lab es una herramienta gratuita para que cualquier persona aprenda a desarrollar complementos de Office. Script Lab le permite codificar y ejecutar las API de JavaScript de Office junto con el documento en Excel, Outlook, PowerPoint y Word. Use esta práctica herramienta para crear prototipos y comprobar la funcionalidad que desea en su propio complemento.
Mira a Script Lab en acción en este video de YouTube de un minuto.
¿Qué es un laboratorio de scripts?
Script Lab es un complemento para la creación de prototipos. Usa la API de JavaScript de Office en Excel, Outlook, PowerPoint y Word y se encuentra en un panel de tareas dentro de su documento, hoja de cálculo o correo electrónico. Tiene un editor de código habilitado para IntelliSense, construido en el mismo marco que usa Visual Studio Code. A través de Script Lab, tiene acceso a una biblioteca de muestras. Pruebe características rápidamente o use estos ejemplos como punto de partida para su propio código. Incluso puede probar las próximas API de Script Lab que aún están en versión preliminar.
Nota:
Script Lab no está relacionado con los scripts de Office. Scripts de Office es una herramienta para la automatización de Excel por parte del usuario final. Use Scripts de Office si desea soluciones rápidas y reutilizables que no necesiten integraciones con los servicios web.
Características principales
Script Lab ofrece una serie de características que le ayudarán a crear prototipos de funcionalidades de complementos y a explorar la API de JavaScript de Office.
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. Ejecute los ejemplos para ver instantáneamente el resultado en el panel de tareas o documento, examine los ejemplos para aprender cómo funciona la API e incluso use ejemplos para crear prototipos de su propio complemento.
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. Personalice el marcado HTML y CSS para experimentar con la colocación y el estilo de los elementos a medida que crea prototipos de diseño del panel de tareas para su propio complemento.
API de versión preliminar
Para llamar a las API de versión preliminar dentro de un fragmento, debes actualizar las bibliotecas del fragmento para usar la red de entrega de contenido beta (CDN) (https://officeapis.public.onecdn.static.microsoft/beta/office.js) y las definiciones de tipo de @types/office-js-previewversión preliminar. Además, algunas API de versión preliminar solo son accesibles si se ha registrado en el programa Microsoft 365 Insider y está ejecutando una compilación de Office de Insider.
Guardar y compartir fragmentos de código
De forma predeterminada, los fragmentos de código que abre en Script Lab se guardan en la memoria caché del explorador o en el almacenamiento local. Para guardar un fragmento de código de forma permanente, seleccione Copiar y pegar el contenido del portapapeles resultante en un nuevo archivo .yml. Use esta opción para compartir fragmentos de código con compañeros o proporcionar código para sitios de la comunidad, como Stack Overflow.
Para importar un fragmento en Script Lab, selecciona Importar en el menú y pega el YAML completo del fragmento. Si ha guardado el YAML como un gist de GitHub, puede pegar un enlace al gist en su lugar.
Clientes compatibles
El laboratorio de scripts es compatible con Excel, Word y PowerPoint en los siguientes clientes.
- Office en la web
- Office en Windows
- Office en Mac
El laboratorio de scripts para Outlook está disponible en los siguientes clientes.
- Outlook en la web al usar los exploradores Chrome, Microsoft Edge o Safari
- Outlook en Windows
- Outlook en Mac
Limitaciones
Script Lab está diseñado para que juegues con pequeñas muestras de código. Por lo general, un fragmento debe tener como máximo unos cientos de líneas y unos pocos miles de caracteres.
El fragmento de código puede usar datos codificados. Una pequeña cantidad de datos (por ejemplo, unos pocos cientos de caracteres) está bien para codificar de forma rígida en Script Lab. Sin embargo, para fragmentos de datos más grandes, se recomienda almacenarlos externamente y luego cargarlos en tiempo de ejecución con un comando como fetch.
Mantenga los fragmentos pequeños y los datos codificados de forma rígida, ya que almacenar varios fragmentos de código grandes podría exceder el almacenamiento de Script Lab y causar problemas al cargar Script Lab.
Pasos siguientes
Una vez que haya creado un prototipo de su código en Script Lab, conviértalo en un complemento real con los pasos de Crear un complemento de Office independiente a partir del código de Script Lab.
Problemas
Si encuentra un problema o tiene comentarios para nosotros, háganoslo saber.
- ¿Cuál es el problema de este artículo? Consulte la sección "Comentarios sobre los complementos de Office" al final de este artículo.
- ¿Tiene problemas con un ejemplo de código de Script Lab? Abra una nueva incidencia en el repositorio de GitHub office-js-snippets.
- ¿Algún comentario o problema con la herramienta Script Lab? Abra una nueva incidencia en el repositorio de GitHub de office-js.
Vea también
Colaborar con nosotros en GitHub
El origen de este contenido se puede encontrar en GitHub, donde también puede crear y revisar problemas y solicitudes de incorporación de cambios. Para más información, consulte nuestra guía para colaboradores.