Изучение API JavaScript для Office с помощью Script Lab

Script Lab — это бесплатный инструмент, позволяющий всем научиться разрабатывать надстройки Office. Script Lab позволяет создавать код и запускать API JavaScript Office вместе с документом в Excel, Outlook, PowerPoint и Word. Используйте это удобное средство для создания прототипов и проверки нужных функций в вашей надстройке.

Скачать Script Lab для Excel, PowerPoint и Word

Получение Script Lab для Outlook

Посмотрите, как работает Script Lab, в этом минутном видео YouTube. Ознакомительное видео, демонстрирующее работу Script Lab в Excel, Word и PowerPoint.

Что такое Script Lab?

Script Lab — это надстройка для создания прототипов надстроек. Он использует API JavaScript Office в Excel, Outlook, PowerPoint, Word и находится в области задач в документе, электронной таблице или электронной почте. Он содержит редактор кода с поддержкой IntelliSense, построенный на той же платформе, что и Visual Studio Code. Через Script Lab вы получаете доступ к библиотеке образцов. Быстро опробуйте новые функции или используйте эти примеры в качестве отправной точки для создания собственного кода. Вы даже можете попробовать предстоящие API в Script Lab, которые все еще находятся в предварительной версии.

Примечание.

Script Lab не связан со сценариями Office. Office Scripts — это средство автоматизации конечных пользователей в Excel. Используйте сценарии Office, если вам нужны быстрые, многократно используемые решения, не требующие интеграции с веб-службами.

Основные возможности

Script Lab предлагает ряд функций, которые помогут вам создать прототип функций надстроек и изучить Office JavaScript API.

Изучите примеры

Встроенные примеры фрагментов кода, демонстрирующие выполнение задач с помощью API, помогут быстро начать работу. Запускайте примеры, чтобы мгновенно увидеть результат в области задач или документе, изучайте примеры, чтобы узнать, как работает API, и даже используйте примеры для создания прототипа собственной надстройки.

Образцы.

Код и стиль

В дополнение к коду JavaScript или TypeScript, который вызывает API JS для Office, каждый фрагмент также содержит разметку HTML, определяющую содержимое области задач, и таблицы стилей CSS, определяющие внешний вид области задач. Настройте разметку HTML и CSS, чтобы экспериментировать с размещением и стилем элементов при создании прототипа дизайна области задач для собственной надстройки.

Предварительные версии API

Чтобы вызывать предварительные API во фрагменте, необходимо обновить библиотеки фрагмента, чтобы использовать сеть доставки содержимого бета-версии (CDN) (https://officeapis.public.onecdn.static.microsoft/beta/office.js) и определения типов предварительного просмотра @types/office-js-preview. Кроме того, некоторые предварительные версии API доступны только в том случае, если вы зарегистрировались в программе предварительной оценки Microsoft 365 и используете сборку Office для предварительной оценки.

Сохранение фрагментов кода и общий доступ к ним

По умолчанию фрагменты, открываемые в Script Lab, сохраняются в кэше браузера или локальном хранилище. Чтобы сохранить фрагмент навсегда, выберите Скопируйте полученное содержимое буфера обмена и вставьте его в новый файл .yml. Используйте его, чтобы поделиться фрагментами с коллегами или предоставить код для сайтов сообществ, таких как Stack Overflow.

Чтобы импортировать фрагмент в Script Lab, выберите "Импорт" в меню и вставьте полный YAML для фрагмента. Если вы сохранили YAML как gist GitHub, вместо этого вы можете вставить ссылку на gist.

Поддерживаемые клиенты

Script Lab поддерживается для Excel, Word и PowerPoint в следующих клиентах.

  • Office в Интернете
  • Office для Windows
  • Office для Mac

Приложение Script Lab для Outlook доступно в следующих клиентах.

  • Outlook в Интернете при использовании браузеров Chrome, Microsoft EDGE или Safari
  • Outlook для Windows
  • Outlook для Mac

Ограничения

Script Lab позволяет играть с небольшими примерами кода. Как правило, фрагмент должен состоять не более чем из нескольких сотен строк и нескольких тысяч символов.

Ваш фрагмент может использовать жестко закодированные данные. Небольшой объем данных (скажем, несколько сотен символов) можно жестко кодировать в Script Lab. Однако для больших фрагментов данных рекомендуется хранить их внешне, а затем загружать их во время выполнения с помощью команды, например fetch.

Сохраняйте небольшие фрагменты и жестко закодированные данные, так как хранение нескольких больших фрагментов может превысить размер хранилища Script Lab и вызвать проблемы при загрузке Script Lab.

Дальнейшие действия

Скачать Script Lab для Excel, PowerPoint и Word

Получение Script Lab для Outlook

Создав прототип кода в Script Lab, превратите его в настоящую надстройку, выполнив действия, описанные в статье Создание отдельной надстройки Office на основе кода Script Lab.

Проблемы

Если вы нашли проблему или хотите оставить отзыв, сообщите нам об этом!

  • Проблема в этой статье? См. раздел "Отзывы о надстройках Office" в конце этой статьи.
  • Возникли проблемы с примером кода Script Lab? Откройте новую проблему в репозитории GitHub office-js-snippets.
  • У вас есть отзыв или проблема со средством Script Lab? Откройте новую проблему в репозитории Office-js GitHub.

См. также

  • Last updated on