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

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

См. Script Lab в действии в этом поминутном видео на YouTube. Предварительный просмотр видео Script Lab, работающих в Excel, Word и PowerPoint.

Что такое Script Lab?

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

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

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

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

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

Образцы.

Код и стиль

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

Совет

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

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

Фрагменты кода, которые вы открываете в Script Lab, по умолчанию сохраняются в кэше браузера. Чтобы навсегда сохранить фрагмент кода, можно экспортировать его в gist GitHub. Можно создать секретный gist, чтобы сохранить фрагмент кода только для собственного использования, или создать общедоступный gist, если вы планируете поделиться этим фрагментом кода с другими пользователями.

Возможности общего доступа.

Импорт фрагментов кода

Можно импортировать фрагмент кода в Script Lab, указав URL-адрес общедоступного gist GitHub, в котором хранится YAML этого фрагмента кода, или вставить полный код YAML этого фрагмента кода. Эта функция может оказаться полезной в случае, если кто-то другой поделился с вами своим фрагментом кода, опубликовав его в gist GitHub или предоставив YAML этого фрагмента кода.

Возможность импорта фрагментов кода.

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

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

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

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

  • Outlook в Windows*

  • Outlook для Mac

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

    Примечание.

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

Подробнее см. в соответствующей записи блога.

Важно!

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

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

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

См. также