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

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

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

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

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

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

• Номера версий и сборок выпусков канала обновления для клиентов Microsoft 365
• Какая у меня версия Office;

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

Наборы требований — это именованные группы элементов 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>

См. также

• Справочная документация по API JavaScript для Excel
• Манифест надстроек Office