Elemento de tiempo de ejecución

Configura el complemento para usar un tiempo de ejecución de JavaScript compartido de modo que se ejecuten varios componentes en el mismo tiempo de ejecución. Elemento secundario del elemento Runtimes .

Tipo de complemento: Documento, Correo, Presentación, Panel de tareas, Libro

Válido solo en estos esquemas VersionOverrides:

  • Panel de tareas 1.0
  • Correo 1.1

Para obtener más información, vea Invalidaciones de versión en el manifiesto de solo complemento.

Asociados a estos conjuntos de requisitos:

Importante

  • Para el tiempo de ejecución de JavaScript compartido, este elemento habilita la cinta, el panel de tareas y otros componentes compatibles para usar el mismo tiempo de ejecución. Sin embargo, el conjunto de requisitos de SharedRuntime solo está disponible en algunas aplicaciones de Office. Para obtener más información, vea Conjuntos de requisitos de runtime compartido.
  • Para la activación basada en eventos, este elemento permite que el complemento se ejecute al redactar un nuevo elemento, por ejemplo. Para obtener clientes compatibles y otra información, vea Activar complementos con eventos.
  • Para los informes de correo no deseado integrados, este elemento permite que el complemento procese los mensajes no solicitados. Para obtener más información sobre cómo implementar la característica de informes integrados de correo no deseado en el complemento, vea Implementar un complemento integrado de informes de correo no deseado.

Ten en cuenta que la activación basada en eventos y los informes de correo no deseado integrados deben usar el mismo tiempo de ejecución. Actualmente, no se admiten varios entornos de ejecución en Outlook.

Sintaxis

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

Forma parte de

Elementos secundarios

Elemento Obligatorio Descripción
Override No Especifica la ubicación de la dirección URL del archivo JavaScript que Office en Windows requiere para los controladores de puntos de extensión LaunchEvent y ReportPhishingCommandSurface . Importante: En la actualidad, solo puede definir un <elemento de Invalidación> y debe ser de tipo javascript.

Atributos

Atributo Obligatorio Descripción
resid Especifica la ubicación de la dirección URL de la página HTML del complemento. No resid puede tener más de 32 caracteres y debe coincidir con un atributo de un idUrl elemento del Resources elemento.

Importante: Al especificar un LaunchEvent punto de extensión o un ReportPhishingCustomization elemento en su manifiesto, asegúrese de que el resid atributo del elemento sourceLocation> secundario< coincida con el resid<valor del elemento Runtime>. Por ejemplo, si el tiempo de ejecución se define como <Runtime resid="WebViewRuntime.Url">, especifique <SourceLocation resid="WebViewRuntime.Url"/>.
de duración No El valor predeterminado para lifetime es short y no es necesario especificarlo. Los complementos de activación basada en eventos e informes de correo no deseado solo usan el short valor. Si desea usar un tiempo de ejecución compartido en un complemento de Excel, establezca explícitamente el valor en long.

Atributo de duración

Opcional. Representa el período de tiempo que el complemento puede ejecutarse.

Valores disponibles

short: Valor predeterminado. Solo se usa para la activación basada en eventos y los complementos de informes de spam. Una vez activado el complemento, se ejecutará durante una cantidad máxima de tiempo según lo especificado por la plataforma. Actualmente, eso es alrededor de 5 minutos. Este es el único valor admitido con la activación basada en eventos.

long: solo se usa al configurar un entorno de tiempo de ejecución de JavaScript compartido. El complemento puede iniciarse cuando se abre un documento y ejecutarse de forma indefinida. Por ejemplo, el código del panel de tareas seguirá ejecutándose incluso cuando el usuario cierre el panel de tareas. Este es el único valor que admite el tiempo de ejecución compartido.

Vea también