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

Существует множество версий Office на нескольких платформах, и они не поддерживают все API в библиотеке Office JavaScript (Office.js). Не всегда можно указать версию Office, с которой должны работать пользователи. Чтобы справиться с этой ситуацией, мы предоставляем систему под названием "наборы требований" или "возможности", которая поможет вам определить, поддерживает ли приложение Office необходимые возможности в надстройке Office. Набор обязательных элементов — это именованной группы членов API. Некоторые примеры: , BindingEvents, ExcelApi 1.5AddinCommands, и WordApi 1.3.

Примечание.

  • Office работает на различных платформах, в том числе Windows, в браузере, на компьютерах Mac и на iPad.
  • Office доступен по подписке на Microsoft 365 или бессрочной лицензии. Бессрочная версия доступна по соглашению о корпоративном лицензировании или розничной продаже.

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

Office для Windows

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

Макет раздела

Примечание.

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

Office для Mac

Чтобы определить версию Office для Mac, следуйте указаниям в разделе Сведения об Office: какую версию Office я использую?.

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

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

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

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

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

Приложения Office с api-интерфейсами для конкретных приложений (Excel, OneNote, PowerPoint и Word) также имеют явные наборы требований для конкретных приложений. Например, первым набором обязательных элементов для API Excel был ExcelApi 1.1, а для API Word — WordApi 1.1. В Outlook также есть наборы требований для конкретных приложений, несмотря на то, что у него нет архитектуры API для конкретного приложения, как в Excel, OneNote, PowerPoint и Word. Существуют определенные подмножества общих API, которые используются только в Outlook. Они группируются в наборы требований с именем Mailbox, например Mailbox 1.1.

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

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

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

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

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

См. также

  • Last updated on