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

Наборы обязательных элементов — именованные группы элементов API. Надстройки Office с помощью наборов обязательных элементов, указанных в манифесте, или проверки в среде выполнения определяют, поддерживает ли приложение Office необходимые API. Дополнительные сведения см. в статье Версии Office и наборы обязательных элементов.Requirement sets are named groups of API members. Office Add-ins use requirement sets specified in the manifest or use a runtime check to determine whether an Office application supports APIs that an add-in needs. For more information, see Office versions and requirement sets.

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

Надстройки Excel работают в нескольких версиях Office, включая Office 2016 или более поздние версии для Windows, а также Office в Интернете, Office для Mac и Office для iPad.Excel add-ins run across multiple versions of Office, including Office 2016 or later on Windows, and Office on the web, Mac, and iPad. В приведенной ниже таблице перечислены наборы обязательных элементов для Excel, клиентские приложения Office, которые поддерживают все наборы обязательных инструментов, а также номера сборок или версий для этих приложений.The following table lists the Excel requirement sets, the Office client applications that support each requirement set, and the build versions or number for those applications.

Примечание

Чтобы использовать API в любом из нумерованных наборов обязательных элементов или ExcelApiOnline, следует ссылаться на рабочую библиотеку в сети CDN https://appsforoffice.microsoft.com/lib/1/hosted/office.js.To use APIs in any of the numbered requirement sets or ExcelApiOnline, you should reference the production library on the CDN: https://appsforoffice.microsoft.com/lib/1/hosted/office.js.

Сведения об использовании API предварительных версий см. в статье Предварительные версии API JavaScript для Excel.For information about using preview APIs, see the Excel JavaScript preview APIs article.

Набор обязательных элементовRequirement set Office для WindowsOffice on Windows
(подключено к подписке на Microsoft 365)(connected to a Microsoft 365 subscription)
Office для iPadOffice on iPad
(подключено к подписке на Microsoft 365)(connected to a Microsoft 365 subscription)
Office для MacOffice on Mac
(подключено к подписке на Microsoft 365)(connected to a Microsoft 365 subscription)
Office в ИнтернетеOffice on the web
Предварительная версияPreview Применяйте последнюю версию Office для использования предварительных версий API (может потребоваться присоединение к программе предварительной оценки Office)Please use the latest Office version to try preview APIs (you may need to join the Office Insider program)
ExcelApiOnlineExcelApiOnline Н/ДN/A Н/ДN/A Н/ДN/A Последние (см. набор обязательных элементов, стр.)Latest (see requirement set page)
ExcelApi 1.12ExcelApi 1.12 Версия 2008 (сборка 13127.20408) или более поздняяVersion 2008 (Build 13127.20408) or later 16.40 или более поздняя16.40 or later 16.40 или более поздняя16.40 or later Сентябрь 2020 г.September 2020
ExcelApi 1.11ExcelApi 1.11 Версия 2002 (сборка 12527.20470) или более поздняяVersion 2002 (Build 12527.20470) or later 16.35 или более поздняя16.35 or later 16.33 или более поздняя16.33 or later Май 2020 г.May 2020
ExcelApi 1.10ExcelApi 1.10 Версия 1907 (сборка 11929.20306) или более поздняяVersion 1907 (Build 11929.20306) or later 16.0 или более поздняя16.0 or later 16.30 или более поздняя версия16.30 or later Октябрь 2019 г.October 2019
ExcelApi 1.9ExcelApi 1.9 Версия 1903 (сборка 11425.20204) или более поздняяVersion 1903 (Build 11425.20204) or later 16.0 или более поздняя16.0 or later 16.24 или более поздняя версия16.24 or later Май 2019 г.May 2019
ExcelApi 1.8ExcelApi 1.8 Версия 1808 (сборка 10730.20102) или более поздняяVersion 1808 (Build 10730.20102) or later 16.0 или более поздняя16.0 or later 16.17 или более поздняя16.17 or later Сентябрь 2018 г.September 2018
ExcelApi 1.7ExcelApi 1.7 Версия 1801 (сборка 9001.2171) или более поздняяVersion 1801 (Build 9001.2171) or later 16.0 или более поздняя16.0 or later 16.9 или более поздняя16.9 or later Апрель 2018 г.April 2018
ExcelApi 1.6ExcelApi 1.6 Версия 1704 (сборка 8201.2001) или более поздняяVersion 1704 (Build 8201.2001) or later 15.0 или более поздняя15.0 or later Версия 15.36 или более поздняя15.36 or later Апрель 2017 г.April 2017
ExcelApi 1.5ExcelApi 1.5 Версия 1703 (сборка 8067.2070) или более поздняяVersion 1703 (Build 8067.2070) or later 15.0 или более поздняя15.0 or later Версия 15.36 или более поздняя15.36 or later Март 2017 г.March 2017
ExcelApi 1.4ExcelApi 1.4 Версия 1701 (сборка 7870.2024) или более поздняяVersion 1701 (Build 7870.2024) or later 15.0 или более поздняя15.0 or later Версия 15.36 или более поздняя15.36 or later Январь 2017 г.January 2017
ExcelApi 1.3ExcelApi 1.3 Версия 1608 (сборка 7369.2055) или вышеVersion 1608 (Build 7369.2055) or later 15.0 или более поздняя15.0 or later 15.27 или более поздняя15.27 or later Сентябрь 2016 г.September 2016
ExcelApi 1.2ExcelApi 1.2 Версия 1601 (сборка 6741.2088) или вышеVersion 1601 (Build 6741.2088) or later 15.0 или более поздняя15.0 or later 15.22 или более поздняя15.22 or later Январь 2016 г.January 2016
ExcelApi 1.1ExcelApi 1.1 Версия 1509 (сборка 4266.1001) или более поздняяVersion 1509 (Build 4266.1001) or later 15.0 или более поздняя15.0 or later 15.20 или более поздняя15.20 or later Январь 2016 г.January 2016

Примечание

Бессрочные версии Office поддерживают следующие наборы обязательных элементов:Perpetual versions of Office support requirement sets as follows:

  • Office 2019 поддерживает ExcelApi 1.8 и более ранние версии.Office 2019 supports ExcelApi 1.8 and earlier.
  • Office 2016 поддерживает только набор обязательных элементов ExcelApi 1.1.Office 2016 only supports the ExcelApi 1.1 requirement set.

Номера версий и сборок OfficeOffice versions and build numbers

Дополнительные сведения о номерах версий и сборок Office см. в следующих статьях:For more information about Office versions and build numbers, see:

Использование наборов обязательных элементов Excel в среде выполнения и в манифестеHow to use Excel requirement sets at runtime and in the manifest

Примечание

В этом разделе предполагается, что вы знакомы с общими сведениями о наборах обязательных элементов, изложенными в статьях Версии и наборы обязательных элементов Office и Указание приложений и обязательных элементов API Office.This section assumes that you are familiar with the overview of requirement sets at Office versions and requirement sets and Specify Office applications and API requirements.

Наборы требований — это именованные группы элементов API.Requirement sets are named groups of API members. Надстройка Office может выполнить проверку в среде выполнения или использовать указанные в манифесте наборы обязательных элементов, чтобы определить, поддерживает ли приложение Office необходимые надстройке API.An Office Add-in can perform a runtime check or use requirement sets specified in the manifest to determine whether an Office application supports the APIs that the add-in needs.

Проверка поддержки наборов обязательных элементов в среде выполненияChecking for requirement set support at runtime

В следующем примере кода показано, как определить, поддерживает ли приложение Office, в котором запускается надстройка, указанный набор обязательных элементов API.The following code sample shows how to determine whether the Office application where the add-in is running supports the specified API requirement set.

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

Определение поддержки наборов обязательных элементов в манифестеDefining requirement set support in the manifest

С помощью элемента Requirements в манифесте надстройки можно указать минимальные наборы обязательных элементов и/или методы API, необходимые надстройке для активации.You can use the Requirements element in the add-in manifest to specify the minimal requirement sets and/or API methods that your add-in requires to activate. Если приложение или платформа Office не поддерживает наборы обязательных элементов или методы API, указанные в элементе манифеста Requirements, надстройка не будет работать в этом приложении или на этой платформе и не будет отображать список надстроек, показанный в разделе Мои надстройки. Если вашей надстройке для полной функциональности необходим определенный набор обязательных элементов, но она может быть полезна пользователям даже на тех платформах, которые не поддерживают этот набор, мы рекомендуем проверить поддержку обязательных элементов в среде выполнения как описано выше, а не прописывать поддержку набора обязательных элементов в манифесте.If the Office application or platform doesn't support the requirement sets or API methods that are specified in the Requirements element of the manifest, the add-in won't run in that application or platform, and it won't display in the list of add-ins that are shown in My Add-ins. If your add-in requires a specific requirement set for full functionality, but it can provide value even to users on platforms that do not support the requirement set, we recommend that you check for requirement support at runtime as described above, instead of defining requirement set support in the manifest.

В следующем примере кода показан элемент Requirements в манифесте надстройки, где указано, что надстройка должна загружаться во всех клиентских приложениях Office, поддерживающих набор обязательных элементов ExcelApi версии 1.3 или выше.The following code sample shows the Requirements element in an add-in manifest which specifies that the add-in should load in all Office client applications that support ExcelApi requirement set version 1.3 or greater.

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

См. такжеSee also