Общие сведения о надстройках Excel

Статья
04/07/2023

Надстройка Excel позволяет расширить функциональные возможности приложений Excel на нескольких платформах, включая Windows, Mac, iPad и в браузере. Используйте надстройки в книге Excel, чтобы:

взаимодействовать с объектами Excel, считывать и записывать данные Excel;
расширять возможности с помощью области задач или области содержимого;
добавлять настраиваемые кнопки ленты или элементы контекстного меню;
добавлять пользовательские функции;
расширять возможности взаимодействия с помощью диалогового окна.

В качестве основы используется платформа надстроек Office, предоставляющая API JavaScript для Office.js, с помощью которых можно создавать и запускать надстройки Excel. Используя платформу надстроек Office для создания надстройки Excel, вы получаете следующие преимущества.

Кроссплатформенная поддержка. Надстройки Excel работают в Office в Интернете, Office для Windows, Office для Mac и Office для iPad.
Централизованное развертывание. Администраторы могут легко и быстро развертывать надстройки Excel для пользователей в организации.
Использование стандартных веб-технологий. Создавайте надстройки Excel, используя знакомые веб-технологии — HTML, CSS и JavaScript.
Распространение через AppSource. Представьте свою надстройку Excel широкой аудитории, опубликовав ее в AppSource.

Примечание.

Надстройки Excel отличаются от надстроек COM и VSTO, которые являются более ранними решениями интеграции Office, которые работают только в Office в Windows. В отличие от надстроек COM, надстройкам Excel не требуется устанавливать код на устройстве пользователя или в Excel.

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

Надстройка Excel включает два основных компонента: веб-приложение и файл конфигурации, называемый файлом манифеста.

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

создавать, читать, обновлять и удалять данные в книге (листы, диапазоны, таблицы, диаграммы, именованные элементы и т. д.);
выполнять авторизацию пользователя в веб-службе с помощью стандартного потока OAuth 2.0;
отправлять запросы к API Microsoft Graph или другому API.

Веб-приложение может размещаться на любом веб-сервере, а для его создания можно использовать как клиентские платформы (например, Angular, React, jQuery), так и серверные технологии (например, ASP.NET, Node.js, PHP).

Манифест — это файл конфигурации, который определяет, как надстройка интегрируется с клиентами Office, указывая параметры и возможности, такие как:

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

Чтобы пользователи могли устанавливать и использовать надстройку Excel, необходимо опубликовать ее манифест в AppSource или каталоге надстроек. Дополнительные сведения о публикации в AppSource см. в статье Публикация решений в AppSource и в Office.

Возможности надстройки Excel

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

Команды надстроек

Команды надстроек — это элементы, которые расширяют пользовательский интерфейс Excel и выполняют действия в надстройке. С помощью команд надстроек можно добавить кнопку на ленту или пункт в контекстное меню в Excel. Когда пользователи выбирают команду надстройки, выполняется действие, например запуск кода JavaScript или отображение страницы надстройки на панели задач.

Команды надстроек в Excel.

Дополнительные сведения о возможностях команд и поддерживаемых платформах, а также рекомендации по разработке команд надстроек см. в статье Команды надстроек для Excel, Word и PowerPoint.

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

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

Надстройка области задач в Excel.

Дополнительные сведения об областях задач см. в статье Области задач в надстройках Office. Пример реализации области задач в Excel: Тенденции расходов банка WoodGrove на JS.

Пользовательские функции

Пользовательские функции позволяют разработчикам добавлять новые функции в Excel путем определения этих функций в JavaScript как части надстройки. Пользователи в Excel могут получить доступ к пользовательским функциям так же, как и к любой встроенной функции в Excel, например SUM().

Анимированное изображение, показывающее конечного пользователя, который вводит пользовательскую функцию MYFUNCTION.SPHEREVOLUME в ячейку листа Excel.

Дополнительные сведения о пользовательских функциях см. в статье Создание пользовательских функций в Excel.

Диалоговые окна

Диалоговые окна — это поверхности, которые накладываются на активное окно приложения Excel. Например, с помощью диалоговых окон можно отображать страницы входа, которые невозможно открыть непосредственно в области задач, запрашивать подтверждение действий пользователем и размещать видео, которые могут не помещаться в области задач. Чтобы открывать диалоговые окна в надстройке Excel, используйте API диалоговых окон.

Диалоговое окно надстройки в Excel.

Дополнительные сведения о диалоговых окнах и API диалоговых окон см. в статье Использование API диалоговых окон в надстройках Office.

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

Контентные надстройки — это поверхности, которые можно внедрять непосредственно в документы Excel. С помощью контентных надстроек можно внедрять в лист многофункциональные веб-объекты, например диаграммы, визуализации данных и файлы мультимедиа, или предоставлять пользователям доступ к элементам управления интерфейса, выполняющим код для изменения документа Excel или отображения данных из источника. Используйте контентные надстройки, когда требуется внедрить функции непосредственно в документ.

Контентная надстройка в Excel.

Дополнительные сведения о контентных надстройках см. в статье Контентные надстройки Office. Пример контентной надстройки Excel: Humongous Insurance на сайте GitHub.

API JavaScript для взаимодействия с содержимым книги

Надстройка Excel взаимодействует с объектами в Excel с помощью API JavaScript для Office, включающего две объектных модели JavaScript:

API JavaScript для Excel. Появившийся в Office 2016 API JavaScript для Excel предоставляет строго типизированные объекты, с помощью которых можно получать доступ к листам, диапазонам, таблицам, диаграммам и другим объектам.
Общие API. Появившиеся в Office 2013 общие API позволяют получать доступ к таким компонентам, как пользовательский интерфейс, диалоговые окна и параметры клиентов, общие для нескольких типов приложений Office. Ограниченная функциональность взаимодействия Excel в Общем API была заменена API JavaScript для Excel.

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

Приступите к созданию своей первой надстройки Excel. Затем ознакомьтесь с основными понятиями, связанными с созданием надстроек Excel.

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