Наборы обязательных элементов API JavaScript для Excel

  • Статья

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

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

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

Примечание.

Чтобы использовать API в любом из нумерованных наборов обязательных элементов или ExcelApiOnline, следует ссылаться на рабочую библиотеку в сети доставки содержимого (CDN) Office.js.

Сведения об использовании API предварительных версий см. в статье Предварительные версии API JavaScript для Excel.

Набор обязательных элементов Office для Windows
— подписка На Microsoft 365
— розничная версия Office 2016 с бессрочным сроком использования		 Office для Windows
(корпоративный бессрочный)		 Office для Mac Office для iPad Office в Интернете
Предварительная версия Используйте последнюю версию Office, чтобы попробовать предварительные версии API (возможно, вам потребуется присоединиться к программе предварительной оценки Microsoft 365).
ExcelApiOnline Неприменимо Неприменимо Неприменимо Неприменимо Последние (см. набор обязательных элементов, стр.)
ExcelApi 1.17 Версия 2302 (сборка 16130.20332) Недоступно 16.70 16.70 Поддерживается
ExcelApi 1.16 Версия 2208 (сборка 15601.20148) Недоступно 16.64 16.66 Поддерживается
ExcelApi 1.15 Версия 2202 (сборка 14931.20132) Недоступно 16.58 16.59 Поддерживается
ExcelApi 1.14 Версия 2108 (сборка 14326.20508) Office 2021: версия 2108 (сборка 14326.20508) 16.52 16.53 Поддерживается
ExcelApi 1.13 Версия 2102 (сборка 13801.20738) Office 2021: версия 2102 (сборка 13801.20738) 16.50 16.50 Поддерживается
ExcelApi 1.12 Версия 2008 (сборка 13127.20408) Office 2021: версия 2008 (сборка 13127.20408) 16.40 16.40 Поддерживается
ExcelApi 1.11 Версия 2002 (сборка 12527.20470) Office 2021: версия 2002 (сборка 12527.20470) 16.33 16.35 Поддерживается
ExcelApi 1.10 Версия 1907 (сборка 11929.20306) Office 2021: Версия 1907 (сборка 11929.20306) 16.30 16.0 Поддерживается
ExcelApi 1.9 Версия 1903 (сборка 11425.20204) Office 2021: версия 1903 (сборка 11425.20204) 16.24 16.0 Поддерживается
ExcelApi 1.8 Версия 1808 (сборка 10730.20102) Office 2021: версия 1808 (сборка 10730.20102) 16.17 16.0 Поддерживается
ExcelApi 1.7 Версия 1801 (сборка 9001.2171) Office 2019: версия 1801 (сборка 9001.2171) 16.9 16.0 Поддерживается
ExcelApi 1.6 Версия 1704 (сборка 8201.2001) Office 2019: версия 1704 (сборка 8201.2001) 15.36 15.0 Поддерживается
ExcelApi 1.5 Версия 1703 (сборка 8067.2070) Office 2019: версия 1703 (сборка 8067.2070) 15.36 15.0 Поддерживается
ExcelApi 1.4 Версия 1701 (сборка 7870.2024) Office 2019: версия 1701 (сборка 7870.2024) 15.36 15.0 Поддерживается
ExcelApi 1.3 Версия 1608 (сборка 7369.2055) Office 2019: версия 1608 (сборка 7369.2055) 15.27 15.0 Поддерживается
ExcelApi 1.2 Версия 1601 (сборка 6741.2088) Office 2019: версия 1601 (сборка 6741.2088) 15.22 15.0 Поддерживается
ExcelApi 1.1 Версия 1509 (сборка 4266.1001) Office 2016: версия 1509 (сборка 4266.1001) 15.20 15.0 Поддерживается

Номера версий и сборок Office

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

Использование наборов обязательных элементов Excel в среде выполнения и в манифесте

Примечание.

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

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

Проверка поддержки наборов обязательных элементов в среде выполнения

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

if (Office.context.requirements.isSetSupported('ExcelApi', '1.3')) {
  // Perform actions.
}
else {
  // Provide alternate flow/logic.
}

Определение поддержки наборов обязательных элементов в манифесте

С помощью элемента Requirements в манифесте надстройки можно указать минимальные наборы обязательных элементов и/или методы API, необходимые надстройке для активации. Если приложение или платформа Office не поддерживает наборы обязательных элементов или методы API, указанные в элементе манифеста Requirements, надстройка не будет работать в этом приложении или на этой платформе и не будет отображать список надстроек, показанный в разделе Мои надстройки. Если вашей надстройке для полной функциональности необходим определенный набор обязательных элементов, но она может быть полезна пользователям даже на тех платформах, которые не поддерживают этот набор, мы рекомендуем проверить поддержку обязательных элементов в среде выполнения как описано выше, а не прописывать поддержку набора обязательных элементов в манифесте.

В следующем примере кода показан элемент Requirements в манифесте надстройки, где указано, что надстройка должна загружаться во всех клиентских приложениях Office, поддерживающих набор обязательных элементов ExcelApi версии 1.3 или выше.

<Requirements>
   <Sets DefaultMinVersion="1.3">
      <Set Name="ExcelApi" MinVersion="1.3"/>
   </Sets>
</Requirements>

См. также