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

Статья
11/13/2024

Наборы требований — это именованные группы элементов 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 в Интернете	Office для Windows Подписка на Microsoft 365 розничный бессрочный	Office для Windows корпоративный бессрочный	Office для Mac	Office для iPad
Предварительный просмотр	Используйте последнюю версию Office, чтобы попробовать предварительные версии API (возможно, вам потребуется присоединиться к программе предварительной оценки Microsoft 365).
ExcelApiOnline	Последние (см. набор обязательных элементов, стр.)	Неприменимо	Неприменимо	Неприменимо	Неприменимо
ExcelApi 1.17	Поддерживается	Версия 2302 (сборка 16130.20332)	Office 2024: версия 2302 (сборка 16130.20332)	Версия 16.70 (23021201)	Версия 16.70
ExcelApi 1.16	Поддерживается	Версия 2208 (сборка 15601.20148)	Office 2024: версия 2208 (сборка 15601.20148)	Версия 16.64 (22081401)	Версия 16.66
ExcelApi 1.15	Поддерживается	Версия 2202 (сборка 14931.20132)	Office 2024: версия 2202 (сборка 14931.20132)	Версия 16.58 (22021501)	Версия 16.59
ExcelApi 1.14	Поддерживается	Версия 2108 (сборка 14326.20508)	Office 2021: версия 2108 (сборка 14326.20508)	Версия 16.52 (21080801)	Версия 16.53
ExcelApi 1.13	Поддерживается	Версия 2102 (сборка 13801.20738)	Office 2021: версия 2102 (сборка 13801.20738)	Версия 16.50 (21061301)	Версия 16.50
ExcelApi 1.12	Поддерживается	Версия 2008 (сборка 13127.20408)	Office 2021: версия 2008 (сборка 13127.20408)	Версия 16.40 (20081000)	Версия 16.40
ExcelApi 1.11	Поддерживается	Версия 2002 (сборка 12527.20470)	Office 2021: версия 2002 (сборка 12527.20470)	Версия 16.33 (20011301)	Версия 16.35
ExcelApi 1.10	Поддерживается	Версия 1907 (сборка 11929.20306)	Office 2021: Версия 1907 (сборка 11929.20306)	Версия 16.30 (19101301)	Версия 16.0
ExcelApi 1.9	Поддерживается	Версия 1903 (сборка 11425.20204)	Office 2021: Версия 1903 (сборка 11425.20204)	Версия 16.24 (19041401)	Версия 16.0
ExcelApi 1.8	Поддерживается	Версия 1808 (сборка 10730.20102)	Office 2021: версия 1808 (сборка 10730.20102)	Версия 16.17 (18090901)	Версия 16.0
ExcelApi 1.7	Поддерживается	Версия 1801 (сборка 9001.2171)	Office 2019: версия 1801 (сборка 9001.2171)	Версия 16.9 (18011602)	Версия 16.0
ExcelApi 1.6	Поддерживается	Версия 1704 (сборка 8201.2001)	Office 2019: версия 1704 (сборка 8201.2001)	Версия 15.36 (17070200)	Версия 15.0
ExcelApi 1.5	Поддерживается	Версия 1703 (сборка 8067.2070)	Office 2019: версия 1703 (сборка 8067.2070)	Версия 15.36 (17070200)	Версия 15.0
ExcelApi 1.4	Поддерживается	Версия 1701 (сборка 7870.2024)	Office 2019: версия 1701 (сборка 7870.2024)	Версия 15.36 (17070200)	Версия 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>

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