Руководство разработчика надстроек VSTO по веб-надстройкам Office

  • Статья

Итак, вы создали несколько надстроек VSTO для приложений Office, работающих в Windows, и теперь вы изучаете новый способ расширения Office, который будет работать в Windows, Mac и версии веб-браузера набора Office: Веб-надстройки Office.

Важно!

Надстройки COM и VSTO не поддерживаются в новой предварительной версии Outlook для Windows . Эти надстройки по-прежнему поддерживаются в классическом классическом клиенте Outlook для Windows. Дополнительные сведения см. в статье Разработка надстроек Outlook для новых приложений Outlook в Windows (предварительная версия).

Ваше понимание объектных моделей в Excel, Word и других приложениях Office очень поможет, так как объектные модели в веб-надстройках Office используют похожие шаблоны. Но вы столкнетесь с некоторыми препятствиями:

  • Вы будете работать с другим языком (JavaScript или TypeScript) вместо C# или Visual Basic .NET. (Существует также способ, описанный далее, для повторного использования существующего кода в веб-надстройке.)
  • Развертывание веб-надстроек Office отличается от развертывания надстроек VSTO.
  • Веб-надстройки Office — это веб-приложения, которые выполняются в упрощенном элементе управления webview, встроенном в приложение Office, поэтому необходимо получить базовое представление о веб-приложениях и их размещении на веб-серверах или в облачных учетных записях.

По этим причинам большая часть этой статьи дублирует руководство по расширениям Office для начинающих. Мы добавили некоторые учебные ресурсы, которые помогут разработчикам надстроек VSTO использовать свой опыт, а также помочь им повторно использовать существующий код.

Шаг 0. Необходимые условия

  • Веб-надстройки Office (другое название — надстройки Office) по сути являются веб-приложениями, внедренными в Office. Таким образом, сначала необходимо иметь базовое представление о веб-приложениях и их размещении в Интернете. Об этом доступно огромное количество информации в Интернете, книгах и онлайн-курсах. Если у вас нет знаний о веб-приложениях, можно начать поиск по запросу "Что такое веб-приложение?" в поисковой системе.
  • Основным языком программирования, используемым при создании надстроек Office, является JavaScript или TypeScript. Если вы не знакомы с этими языками, но у вас есть опыт работы с VBA, VB.NET, C#, возможно, вам будет проще изучать TypeScript. Опять же, есть много информации об этих языках в Интернете, книгах и онлайн-курсах.

Шаг 1. Начните с основ

Мы знаем, что вам не терпится начать программирование, но есть некоторые вещи о надстройках Office, которые вы должны прочитать, прежде чем открывать свою IDE или редактор кода.

  • Обзор платформы надстроек Office: узнайте, что такое надстройки Office Web и чем они отличаются от более старых способов расширения Office, таких как надстройки VSTO.
  • Разработка надстроек Office. Ознакомьтесь с обзором разработки и жизненного цикла надстроек Office, включая инструменты, создание пользовательского интерфейса надстройки и использование API-интерфейсов JavaScript для взаимодействия с документом Office.

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

Шаг 2. Установите инструменты и создайте свою первую надстройку.

Теперь у вас есть общая картина, так что погрузитесь с одним из наших быстрых стартов. В целях изучения платформы мы рекомендуем быстрый запуск Excel. Существует версия, основанная на Visual Studio, и другая версия, основанная на Node.js и Visual Studio Code. Если вы переходите с надстроек VSTO, скорее всего, вам будет удобнее работать с версией Visual Studio.

Шаг 3. Код

Вы не можете научиться водить, читая руководство пользователя, поэтому начните программировать с этого учебника Excel. Вы будете использовать библиотеку Office JavaScript и немного XML в манифесте надстроек. Нет необходимости запоминать что-либо, потому что на следующем шаге будет представлен их дополнительный обзор.

Шаг 4. Знакомство с библиотекой JavaScript

Получите общую картину библиотеки JavaScript для Office с помощью учебника Общие сведения об API JavaScript для Office из учебного курса Microsoft Learn.

Затем изучите API JavaScript для Office с помощью средства Script Lab — песочницы для запуска и изучения API.

Специальный ресурс для разработчиков надстроек VSTO

Это отличный момент для знакомства с примером надстройки JavaScript SalesTracker для Excel. Она была создана для выделения похожих элементов и различий между надстройками VSTO и веб-надстройками Office, а в файле сведений примера указываются важные моменты сравнения.

Шаг 5. Знакомство с манифестом

Получите представление о целях манифеста веб-надстройки и общие сведения о его XML-разметке или JSON в манифесте надстроек Office.

Шаг 6 (только для разработчиков VSTO). Повторное использование кода VSTO

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

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

Поздравляем с окончанием схемы обучения разработчиков надстроек VSTO для веб-надстроек Office! Вот несколько предложений для дальнейшего изучения нашей документации: