Наборы обязательных элементов API JavaScript для OneNoteOneNote 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 host supports APIs that an add-in needs. For more information, see Office versions and requirement sets.

В приведенной ниже таблице перечислены наборы обязательных элементов для OneNote, ведущие приложения Office, которые их поддерживают, а также версии сборок или даты выхода.The following table lists the OneNote requirement sets, the Office host applications that support those requirement sets, and the build versions or availability date.

Набор обязательных элементовRequirement set Office в ИнтернетеOffice on the web
OneNoteApi 1.1OneNoteApi 1.1 Сентябрь 2016 г.September 2016

Наборы обязательных элементов общего API для OfficeOffice Common API requirement sets

Сведения о наборах обязательных элементов общего API см. в статье Наборы обязательных элементов общего API для Office.For information about Common API requirement sets, see Office Common API requirement sets.

API JavaScript для OneNote 1.1OneNote JavaScript API 1.1

API JavaScript для OneNote 1.1 — первая версия этого API.OneNote JavaScript API 1.1 is the first version of the API. Дополнительные сведения об этом API см. в статье Обзор создания кода с помощью API JavaScript для OneNote.For details about the API, see the OneNote JavaScript API programming overview.

Проверка поддержки требований в среде выполненияRuntime requirement support check

В среде выполнения надстройки могут проверять, поддерживает ли конкретный узел набор обязательных элементов API, выполнив следующие действия.At runtime, add-ins can check if a particular host supports an API requirement set by doing the following.

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

Проверка поддержки обязательных элементов в манифестеManifest-based requirement support check

Используйте Requirements элемент в манифесте надстройки, чтобы указать критические наборы требований или элементы API, которые должна использовать надстройка.Use the Requirements element in the add-in manifest to specify critical requirement sets or API members that your add-in must use. Если ведущее приложение или платформа Office не поддерживает наборы требований или элементы API, указанные в Requirements элементе, надстройка не будет запускаться на этом узле или платформе и не будет отображаться в папке "Мои надстройки".If the Office host or platform doesn't support the requirement sets or API members specified in the Requirements element, the add-in won't run in that host or platform, and won't display in My Add-ins.

Ниже показана надстройка, которая загружается во всех ведущих приложениях Office, поддерживающих набор обязательных элементов OneNoteApi версии 1.1.The following code example shows an add-in that loads in all Office host applications that support the OneNoteApi requirement set, version 1.1.

<Requirements>
   <Sets DefaultMinVersion="1.1">
      <Set Name="OneNoteApi" MinVersion="1.1"/>
   </Sets>
</Requirements>

Наборы обязательных элементов общего API для OfficeOffice Common API requirement sets

Сведения о наборах обязательных элементов общего API см. в статье Наборы обязательных элементов общего API для Office.For information about Common API requirement sets, see Office Common API requirement sets.

См. такжеSee also