Поделиться через

Руководство разработчика надстроек 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. Установите инструменты и создайте свою первую надстройку.

Теперь у вас есть общая картина, так что погрузитесь с одним из наших быстрых стартов. Для изучения платформы мы рекомендуем краткое руководство по PowerPoint для Visual Studio.

Шаг 3. Код

Вы не можете научиться водить машину, читая руководство владельца, поэтому начните писать код с помощью этого руководства по PowerPoint. Вы будете использовать библиотеку 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! Вот несколько предложений для дальнейшего изучения нашей документации: