Версии Office и наборы обязательных элементов

  • Статья

Не все версии Office поддерживают все API в API JavaScript для Office (Office.js). Office 2013 в Windows — самая ранняя версия Office, которая поддерживала надстройки Office. Вы не всегда можете контролировать версию Office, установленную пользователями. Чтобы справиться с этой ситуацией, мы предоставляем системные наборы требований, которые помогут вам определить, поддерживает ли приложение Office необходимые возможности в надстройке Office.

Примечание.

  • Office работает на различных платформах, в том числе Windows, в браузере, на компьютерах Mac и на iPad.
  • Примерами приложений Office являются продукты Office: Excel, Word, PowerPoint, Outlook, OneNote и т. д.
  • Office доступен по подписке на Microsoft 365 или бессрочной лицензии. Бессрочная версия доступна по соглашению о корпоративном лицензировании или розничной продаже.
  • Набор обязательных элементов — это именованной группы членов API, ExcelApi 1.5например , WordApi 1.3и т. д.

Как узнать, какая версия Office используется

Чтобы определить используемую версию Office, в приложении Office откройте меню Файл и выберите Учетная запись. Версия Office отображается в разделе Сведения о продукте . Например, на следующем снимку экрана показана версия Office 1802 (сборка 9026.1000).

Проверка версии Office.

Примечание.

Если ваша версия Office отличается от этой, см . статью Какая версия Outlook у меня есть? или Сведения о Office: какую версию Office я использую? чтобы узнать, как получить эту информацию для вашей версии.

Развертывание

Развертывание надстройки может повлиять на доступность надстройки на различных платформах и клиентах. Дополнительные сведения о вариантах развертывания см. в статье Развертывание и публикация надстроек Office.

Доступность наборов обязательных элементов для Office

Надстройки Office могут использовать наборы требований API, чтобы определить, поддерживает ли приложение Office необходимые члены API. Поддержка набора требований зависит от приложения Office и версии приложения Office (см. предыдущий раздел Как проверка версию Office).

Некоторые приложения Office имеют собственные наборы требований к API. Например, первым набором обязательных элементов для API Excel был ExcelApi 1.1, а для API Word — WordApi 1.1. Со временем для обеспечения дополнительной функциональности API были добавлены новые наборы обязательных элементов (ExcelApi и WordApi).

Кроме того, к общему API были добавлены другие функции, такие как команды надстроек (расширение ленты) и возможность запуска диалоговых окон (API диалоговых окон). Команды надстроек и наборы обязательных наборов API Dialog — это примеры наборов API, общих для различных приложений Office.

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

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

Номер версии набора требований, например "1.1" в ExcelApi 1.1, относится к приложению Office. Номер версии заданного набора требований (например, ExcelApi 1.1) не соответствует номеру версии Office.js или наборам требований для других приложений Office (например, Word, Outlook и т. д.). Наборы требований для различных приложений Office выпускаются по разным тарифам. Например, набор обязательных элементов ExcelApi 1.5 был выпущен до набора обязательных элементов WordApi 1.3.

Библиотека API JavaScript для Office (Office.js) включает все доступные наборы обязательных элементов. Наборы обязательных элементов ExcelApi 1.3 и WordApi 1.3 существуют, но набора обязательных элементов Office.js 1.3 нет. Доступ к последней версии Office.js осуществляется через единую конечную точку Office, интегрированную в сеть доставки содержимого (CDN). Дополнительные сведения о CDN Office.js, в том числе об управлении версиями и обратной совместимости, см. в статье Общие сведения об интерфейсе API JavaScript для Office.

Указание приложений Office и наборов обязательных элементов

Существует несколько способов указать, какие приложения Office и наборы требований требуются надстройке. Подробные сведения см. в разделе Указание приложений Office и требований к API.

См. также