Элемент Runtime

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

Тип надстройки: Документ, Почта, Презентация, Область задач, Книга

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

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

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

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

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

Важно!

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

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

Синтаксис

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

Содержится в

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

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

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

Атрибуты

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

атрибут lifetime

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

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

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

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

См. также

• Среды выполнения
• Среды выполнения в надстройках Office
• Настройка надстройки Office для использования общей среды выполнения JavaScript
• Активация надстроек с помощью событий
• Реализация интегрированной надстройки отчетов о нежелательной почты