Элемент Runtime

Статья
10/23/2024

Настраивает надстройку для использования общей среды выполнения JavaScript, чтобы все различные компоненты запускались в одной среде выполнения. Дочерний элемент элемента Runtimes .

Тип надстройки: Область задач, почта

Допустимо только в следующих схемах VersionOverrides:

Область задач 1.0
Почта 1.1

Дополнительные сведения см. в разделе Переопределения версий в манифесте только надстройки.

Связаны с этими наборами требований:

SharedRuntime 1.1 (только при использовании в надстройке области задач).)
Почтовый ящик 1.10 и более поздних версий (при использовании в надстройке Outlook, которая реализует активацию на основе событий.)
Предварительная версия почтового ящика (при использовании в надстройке Outlook, которая реализует встроенную функцию создания отчетов о нежелательной почте (предварительная версия ).)

Важно!

Для общей среды выполнения JavaScript этот элемент позволяет ленте, области задач и другим поддерживаемым компонентам использовать ту же среду выполнения. Однако набор требований SharedRuntime доступен только в некоторых приложениях Office. Дополнительные сведения см. в статье Наборы обязательных элементов общей среды выполнения.

Outlook

Для активации на основе событий этот элемент позволяет надстройке запускаться при создании нового элемента, например. Сведения о поддерживаемых клиентах и других сведениях см. в разделе Настройка надстройки Outlook для активации на основе событий.
Для интегрированных отчетов о нежелательной почте (предварительная версия) этот элемент позволяет надстройке обрабатывать нежелательные сообщения. Дополнительные сведения о том, как реализовать встроенную функцию создания отчетов о нежелательной почте в надстройке, см. в статье Реализация интегрированной надстройки для создания отчетов о нежелательной почте (предварительная версия).

Обратите внимание, что функции активации на основе событий и интегрированные функции создания отчетов о нежелательной почте должны использовать одну и ту же среду выполнения. Несколько сред выполнения в настоящее время не поддерживаются в Outlook.

Синтаксис

<Runtimes>
    <Runtime resid="ContosoAddin.Url" lifetime="long" />
</Runtimes>

Содержится в

Среды выполнения

Дочерние элементы

Элемент	Обязательный	Описание
Override	Нет	Outlook: указывает URL-адрес файла JavaScript, который требуется Outlook в Windows для обработчиков точки расширения LaunchEvent и ReportPhishingCommandSurface (предварительная версия). Важно! В настоящее время можно определить только один <элемент Override> , который должен иметь тип `javascript`.

Атрибуты

Атрибут	Обязательный	Описание
resid	Да	Указывает URL-адрес HTML-страницы надстройки. Объект `resid` может содержать не более 32 символов и должен соответствовать `id` атрибуту `Url` элемента в элементе `Resources` .
продолжительность жизни	Нет	Значение по умолчанию для `lifetime` — и `short` не требуется указывать. Надстройки для активации на основе событий Outlook и создания отчетов о нежелательной `short` почте используют только значение. Если вы хотите использовать общую среду выполнения в надстройке Excel, явно задайте значение `long`.

атрибут lifetime

Необязательный параметр. Представляет продолжительность выполнения надстройки.

Доступные значения

short:По умолчанию. Используется только для надстроек активации на основе событий Outlook и создания отчетов о спаме. После активации надстройки она будет выполняться в течение максимального количества времени, указанного платформой. В настоящее время это около 5 минут. Это единственное значение, поддерживаемое Outlook.

long: используется только при настройке общей среды выполнения JavaScript. Надстройка может запускаться при открытии документа и запускаться неограниченное время. Например, код области задач будет продолжать выполняться, даже когда пользователь закрывает область задач. Это единственное значение, поддерживаемое общей средой выполнения.

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