Версии Office и наборы обязательных элементовOffice versions and requirement sets

Не все версии Office поддерживают все API в API JavaScript для Office (Office.js). Не всегда можно указать версию Office, с которой должны работать пользователи. Для таких ситуаций существуют наборы обязательных элементов, которые помогают определить, поддерживает ли ведущее приложение Office необходимые надстройке возможности.There are many versions of Office on several platforms, and they don't all support every API in Office JavaScript API (Office.js). You may not always have control over the version of Office your users have installed. To handle this situation, we provide a system called requirement sets to help you determine whether an Office host supports the capabilities you need in your Office Add-in.

Примечание

  • Office работает на различных платформах, в том числе Windows, в браузере, на компьютерах Mac и на iPad.Office runs across multiple platforms, including Windows, in a browser, Mac, and iPad.
  • Примеры ведущих приложений Office — Excel, Word, PowerPoint, Outlook, OneNote и другие продукты.Examples of Office hosts are Office Products: Excel, Word, PowerPoint, Outlook, OneNote, and so forth.
  • Набор обязательных элементов — это именованная группа элементов API, например, ExcelApi 1.5, WordApi 1.3 и т. д.A requirement set is a named group of API members e.g., ExcelApi 1.5, WordApi 1.3, and so on.

Как узнать, какая версия Office используетсяHow to check your Office version

Чтобы определить используемую версию Office, в приложении Office откройте меню Файл и выберите Учетная запись. Версия Office будет указана в разделе Сведения о продукте. Например, на следующем снимке экрана указана версия Office 1802 (сборка 9026.1000):To identify the Office version that you're using, from within an Office application, select the File menu, and then choose Account. The version of Office will appear in the Product Information section. For example, the following screenshot indicates Office Version 1802 (Build 9026.1000):

Проверка версии Office

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

Используя наборы обязательных элементов API, надстройки Office могут определять, поддерживает ли ведущее приложение Office необходимые элементы API. Поддержка набора обязательных элементов зависит от ведущего приложения Office и его версии (см. предыдущий раздел).Office Add-ins can use API requirement sets to determine whether the Office host supports the API members that it need to use. Requirement set support varies by Office host and the Office host version (see previous section).

У некоторых ведущих приложений Office есть собственные наборы обязательных элементов API. Например, первым набором обязательных элементов для API Excel был ExcelApi 1.1, а для API Word — WordApi 1.1. Со временем для обеспечения дополнительной функциональности API были добавлены новые наборы обязательных элементов (ExcelApi и WordApi).Some Office hosts have their own API requirement sets. For example, the first requirement set for the Excel API was ExcelApi 1.1 and the first requirement set for the Word API was WordApi 1.1. Since then, multiple new ExcelApi requirement sets and WordApi requirement sets have been added to provide additional API functionality.

Кроме того, к общему API были добавлены другие функции, такие как команды надстроек (расширение ленты) и возможность запуска диалоговых окон (API диалоговых окон).In addition, other functionality such as add-in commands (ribbon extensibility) and the ability to launch dialog boxes (Dialog API) were added to the Common API. Наборы обязательных элементов для команд надстроек и API диалоговых окон — это наборы API, общие для всех ведущих приложений Office.Add-in commands and Dialog API requirement sets are examples of API sets that the various Office hosts share in common.

Надстройка может использовать API только в наборах обязательных элементов, поддерживаемых версией ведущего приложения Office, в которой она работает. Чтобы узнать, какие наборы обязательных элементов доступны для конкретной версии ведущего приложения Office, просмотрите следующие статьи:An add-in can only use APIs in requirement sets that are supported by the version of Office host where the add-in is running. To know exactly which requirement sets are available for a specific Office host version, refer to the following host-specific requirement set articles:

Некоторые наборы обязательных элементов содержат API, которые могут использоваться любым ведущим приложением Office. Информацию об этих наборах обязательных элементов см. в следующих статьях:Some requirement sets contain APIs that can be used by any Office host. For information about these requirement sets, refer to the following articles:

Номер версии набора обязательных элементов, например "1.1" в ExcelApi 1.1, указывается относительно ведущего приложения Office. Номер версии набора обязательных элементов (например, ExcelApi 1.1) не соответствует номеру версии Office.js или наборам обязательных элементов для других ведущих приложений Office (например, Word, Outlook и т. д.). Наборы обязательных элементов для разных ведущих приложений Office выпускаются с разной скоростью и интервалом. Например, набор обязательных элементов ExcelApi 1.5 был выпущен до набора обязательных элементов WordApi 1.3.The version number of a requirement set, such as the "1.1" in ExcelApi 1.1, is relative to the Office host. The version number of a given requirement set (e.g., ExcelApi 1.1) does not correspond to the version number of Office.js or to requirement sets for other Office hosts (e.g., Word, Outlook, etc.). Requirement sets for the different Office hosts are released at different speeds and times. For example, ExcelApi 1.5 was released before the WordApi 1.3 requirement set.

Библиотека API JavaScript для Office (Office.js) включает все доступные наборы обязательных элементов.The JavaScript API for Office library (Office.js) includes all requirement sets that are currently available. Наборы обязательных элементов ExcelApi 1.3 и WordApi 1.3 существуют, но набора обязательных элементов Office.js 1.3 нет.While there is such a thing as requirement sets ExcelApi 1.3 and WordApi 1.3, there is no Office.js 1.3 requirement set. Доступ к последней версии Office.js осуществляется через единую конечную точку Office, интегрированную в сеть доставки содержимого (CDN).The latest release of Office.js is maintained as a single Office endpoint delivered via the content delivery network (CDN). Дополнительные сведения о CDN Office.js, в том числе об управлении версиями и обратной совместимостью, см. в статье Общие сведения об интерфейсе API JavaScript для Office.For more details around the Office.js CDN, including how versioning and backward compatibility is handled, see Understanding the JavaScript API for Office.

Указание ведущих приложений Office и наборов обязательных элементовSpecify Office hosts and requirement sets

Указать необходимые надстройке ведущие приложения Office и наборы обязательных элементов можно разными способами. Подробные сведения см. в статье Указание ведущих приложений Office и обязательных элементов API.There are various ways to specify which Office hosts and requirement sets are required by an add-in. For detailed information, see Specify Office hosts and API requirements

См. такжеSee also