Изучение 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 — это средство автоматизации конечных пользователей в Excel. Используйте сценарии Office, если вам нужны быстрые и многократно используемые решения, которые не нуждаются в интеграции с веб-службами.

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

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

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

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

Образцы.

Код и стиль

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

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

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

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

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

Чтобы импортировать фрагмент в Script Lab, выберите Импорт в меню и вставьте полный yaml для этого фрагмента.

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

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

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

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

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

    Примечание.

    Начиная с версии 115 для браузеров на основе Chromium, таких как Chrome и Edge, выполняется тестирование секционирования хранилища, чтобы предотвратить отслеживание между сайтами по боковому каналу (см. также политики браузера Microsoft Edge). Это изменение предотвращает запуск фрагментов Script Lab в Outlook в Интернете. Чтобы обойти эту проблему, перейдите в раздел chrome://flags или edge://flags в браузере, а затем установите для флага Секционирование стороннего хранилища (#third-party-storage-partitioning) значение Отключено.

  • Outlook в Windows*

  • Outlook для Mac

Важно!

* Script Lab больше не работает с сочетаниями платформы и версии Office, которые используют веб-представление Trident (интернет-Обозреватель) для размещения надстроек. Сюда входят бессрочные версии Office до Office 2019. Дополнительные сведения см. в статье Браузеры и элементы управления webview, используемые надстройками Office.

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

Получение Script Lab для Excel, PowerPoint и Word

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

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

См. также