Элемент среды выполнения

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

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

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

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

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

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

Важно!

  • Для общей среды выполнения 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 символов и должен соответствовать атрибуту idUrl элемента в элементе Resources .

Важно. При указании LaunchEvent точки расширения или ReportPhishingCustomization элемента в манифесте убедитесь, что resid атрибут дочернего <элемента SourceLocation> совпадает со resid значением <элемента среды выполнения> . Например, если среда выполнения определена как <Runtime resid="WebViewRuntime.Url">, укажите <SourceLocation resid="WebViewRuntime.Url"/>.
с учетом всей жизни Нет Значение по умолчанию для lifetime есть short и его не нужно указывать. Активация на основе событий и надстройки для отчетов о спаме используют только short значение. Если вы хотите использовать общую среду выполнения в надстройке Excel, явно установите значение в long.

атрибут времени существования

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

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

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

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

См. также

  • Last updated on