Обзор платформы надстроек Office

Используйте платформу надстроек Office для создания решений, которые расширяют возможности приложений Office и взаимодействуют с содержимым документов Office. С помощью надстроек Office вы можете использовать знакомые веб-технологии, такие как HTML, CSS и JavaScript, чтобы расширить возможности Outlook, Excel, Word, PowerPoint, OneNote и Project и взаимодействовать с ними. Решение может работать в Office на нескольких платформах, включая Windows, Mac, iPad и в браузере.

Платформу надстроек Office можно использовать для следующих целей:

• Добавление новых функциональных возможностей для клиентов Office . Перенос внешних данных в Office, автоматизация документов Office, предоставление функциональных возможностей от Майкрософт и других клиентов Office и многое другое. Например, используйте Microsoft API Graph для подключения к данным, которые повысят производительность.

• Создание пользовательских агентов Copilot, которые считывают и записывают документы, открытые в приложениях Office (предварительная версия) — позволяет пользователям использовать естественный язык для доступа к функциям надстройки.

• Создание оснащенных различными функциями интерактивных объектов, которые можно внедрить в документы Office. Внедряйте карты, диаграммы и интерактивные визуализации, которые пользователи могут добавлять в свои электронные таблицы Excel и презентации PowerPoint.

Компоненты надстройки Office

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

Пакет приложения

Пакет приложения для Microsoft 365 представляет собой ZIP-файл, содержащий файл манифеста, два значка приложения и, возможно, дополнительные файлы конфигурации или локализации. Логика приложения и хранилище данных размещаются в другом месте и получают доступ к ведущему приложению Microsoft 365 по протоколу HTTPS. Вы отправите пакет приложения администратору для публикации в организации или в Центр партнеров для публикации в Microsoft Marketplace.

Подробные сведения о пакете приложения см. в статье Пакет приложения для Microsoft 365.

Манифест

Манифест задает параметры и возможности надстройки, например:

• Отображаемое имя, описание, идентификатор, версию и языковой стандарт по умолчанию надстройки.

• Способ интеграции надстройки с Office.

• Как надстройка интегрируется с Copilot (предварительная версия).

• Уровень разрешений и требования для доступа к данным для надстройки.

Подробный обзор манифеста см. в статье Надстройки Office с манифестом унифицированного приложения для Microsoft 365.

Веб-приложение

Самая простая надстройка Office состоит из статической HTML-страницы, которая отображается внутри приложения Office, но не взаимодействует ни с документом Office, ни с любым другим интернет-ресурсом. Однако для создания интерфейса, который взаимодействует с документами Office или позволяет пользователю взаимодействовать с интернет-ресурсами из клиентского приложения Office, можно использовать любые технологии, как на стороне клиента, так и на стороне сервера, поддерживаемые поставщиком услуг размещения (например, ASP.NET, PHP или Node.js). Для взаимодействия с клиентами и документами Office используйте API JavaScript Office.js.

Расширение возможностей и взаимодействие с клиентами Office

В клиентском приложении Office надстройки Office могут выполнять следующие задачи:

• Расширение функциональных возможностей

• Выполнение инструкций по естественному языку от Copilot (предварительная версия)

• Создание новых объектов (только для Excel или PowerPoint)

Расширение функциональных возможностей Office

Вы можете добавить новые функции в приложения Office с помощью следующих функций:

• Пользовательские кнопки ленты и команды меню (в совокупности называются командами надстройки).

• Вставляемые области задач с элементом управления webview, который может выполнять практически все действия веб-страницы в браузере.

• Обработчики событий, реагирующие на события в документе Office или приложении Office.

Настраиваемый пользовательский интерфейс, области задач и обработчики событий указываются в манифесте надстройки.  

Настраиваемые кнопки и команды меню

Вы можете добавлять настраиваемые кнопки и пункты меню на ленту в Office в Интернете и в Windows. Это упрощает пользователям доступ к надстройке непосредственно из приложения Office. Пользовательские кнопки и элементы меню могут запускать различные действия, например отображение области задач с пользовательским HTML или выполнение функции JavaScript.

Области задач

Для работы с решением пользователи могут использовать не только команды надстройки, но и области задач. В Excel, Word и PowerPoint пользователи запускают надстройки области задач с помощью кнопки Главная>надстройки. В Outlook пользователи запускают надстройки области задач с помощью кнопки надстройки или кнопки Все приложения на ленте.

Расширение возможностей Outlook

Пользователи могут запускать надстройки Outlook, когда просматривают, отвечают или создают сообщения электронной почты, приглашения на собрания, ответы на собрания, отмены собраний или встречи. Надстройки Outlook могут выполнять следующие задачи:

• Расширение ленты приложения Office.
• Отображается контекстно рядом с элементом Outlook при его просмотре или создании.
• Выполнение задачи при возникновении определенного события, например при создании пользователем сообщения.

Обзор надстроек Outlook см. в статье Общие сведения о надстройках Outlook.

Выполнение инструкций Copilot (предварительная версия)

Вы можете создать настраиваемые агенты Copilot, которые позволяют пользователям читать и записывать документы Office с помощью инструкций на естественном языке, введенных в чате Copilot. Дополнительные сведения см. в статье Объединение агентов Copilot с надстройками Office (предварительная версия).

Создание новых объектов в документах Office

Вы можете внедрять веб-объекты, называемые контентными надстройками, в документы Excel и PowerPoint. Благодаря контентным надстройкам можно интегрировать мультимедиа (например, видеопроигрыватель YouTube или галерею рисунков), полнофункциональные веб-визуализации данных и другое внешнее содержимое.

API JavaScript для Office

API JavaScript для Office содержат объекты и элементы для создания надстроек и взаимодействия с содержимым Office и веб-службами. Существует общая объектная модель, которую совместно используют Excel, Outlook, Word, PowerPoint, OneNote и Project. Существуют также более обширные объектные модели приложений для Excel, OneNote, PowerPoint и Word. Эти API предоставляют доступ к известным объектам, таким как абзацы и книги, что упрощает создание надстройки для определенного приложения.

Примеры кода

Узнайте, как создать простую надстройку Office с манифестом, веб-страницей HTML и логотипом. Следующие примеры помогут вам приступить к работе с приложением Office, которое вас интересует.

• Надстройка Excel "Hello world"
• Надстройка Outlook "Hello world"
• Надстройка PowerPoint "Hello world"
• Надстройка Word "Hello world"
• Создание диаграмм анализа данных в Excel с помощью агента Copilot

Чем надстройки Office отличаются от надстроек COM и VSTO?

Надстройки COM и VSTO — это более ранние решения для интеграции Office, которые работают только в Office в Windows. В отличие от надстроек COM и VSTO надстройки Office являются веб-надстройками: приложение (например, Excel) считывает манифест надстройки и подключает настраиваемые кнопки ленты и команды меню надстройки в пользовательском интерфейсе. При необходимости он загружает код JavaScript и HTML надстройки, который выполняется в контексте браузера или элемента управления webview в песочнице.

Преимущества надстроек Office над надстройками, созданными с помощью VBA, модели COM или VSTO.

• Кроссплатформенная поддержка: надстройки Office выполняются в Office в Интернете, Windows, Mac и iPad.

• Поддержка приложений для Microsoft 365. Надстройки Office можно упаковыть с другими расширениями Microsoft 365, такими как приложения Teams и агенты Copilot, для развертывания в виде единого блока.

• Централизованное развертывание и распространение. Администраторы могут централизованно развертывать надстройки Office в организации.

• Простой доступ через Microsoft Marketplace. Вы можете сделать решение доступным для широкой аудитории, отправив его в Microsoft Marketplace.

• На основе стандартной веб-технологии. Для создания надстроек Office можно использовать любую библиотеку.

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

Дополнительные вводные сведения о разработке надстроек Office см. в статье Разработка надстроек Office.

См. также

• Основные принципы надстроек Office
• Разработка надстроек Office
• Проектирование надстроек Office
• Тестирование и отладка надстроек Office
• Публикация надстроек Office
• Сведения о программе для разработчиков Microsoft 365