Elemento Runtime

Artículo
11/08/2023

Configura el complemento para que use un entorno de ejecución de JavaScript compartido para que todos los componentes se ejecuten en el mismo tiempo de ejecución. Elemento secundario del elemento Runtimes .

Tipo de complemento: Panel de tareas, Correo

Solo es válido 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.

Asociado a estos conjuntos de requisitos:

SharedRuntime 1.1 (solo cuando se usa en un complemento de panel de tareas).
Buzón 1.10 y versiones posteriores (cuando se usa en un complemento de Outlook que implementa la activación basada en eventos).
Vista previa del buzón (cuando se usa en un complemento de Outlook que implementa la característica integrada de informes de correo no deseado (versión preliminar ).

Importante

Para el entorno de ejecución de JavaScript compartido, este elemento permite que la cinta de opciones, el panel de tareas y otros componentes admitidos usen el mismo tiempo de ejecución. Sin embargo, el conjunto de requisitos SharedRuntime solo está disponible en algunas aplicaciones de Office. Para obtener más información, vea Conjuntos de requisitos de runtime compartido.

Outlook

Para la activación basada en eventos, este elemento permite que el complemento se ejecute al redactar un nuevo elemento, por ejemplo. Para ver los clientes admitidos y otra información, consulte Configuración del complemento de Outlook para la activación basada en eventos.
En el caso de los informes de correo no deseado integrados (versión preliminar), este elemento permite que el complemento procese mensajes no solicitados. Para obtener más información sobre cómo implementar la característica integrada de informes de correo no deseado en el complemento, consulte Implementación de un complemento integrado de informes de correo no deseado (versión preliminar).

Tenga en cuenta que la activación basada en eventos y las características integradas de informes de correo no deseado 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

Runtimes

Elementos secundarios

Elemento	Obligatorio	Descripción
Override	No	Outlook: especifica la ubicación de dirección URL del archivo JavaScript que Outlook en Windows requiere para los controladores de punto de extensión LaunchEvent y punto de extensión ReportPhishingCommandSurface (versión preliminar). Importante: En la actualidad, solo se puede definir un <elemento Override> y debe ser de tipo `javascript`.

Atributos

Atributo	Obligatorio	Descripción
resid	Sí	Especifica la ubicación de dirección URL de la página HTML del complemento. `resid` no puede tener más de 32 caracteres y debe coincidir con un `id` atributo de un `Url` elemento del `Resources` elemento .
Vida	No	El valor predeterminado para `lifetime` es `short` y no es necesario especificar. Los complementos de activación basada en eventos y informes de correo no deseado de Outlook usan solo el `short` valor . Si desea usar un entorno de ejecución compartido en un complemento de Excel, establezca explícitamente el valor `long`en .

atributo lifetime

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

Valores disponibles

short:Predeterminado. Solo se usa para la activación basada en eventos de Outlook y los complementos de informes de correo no deseado. Una vez activado el complemento, se ejecutará durante un período máximo de tiempo según lo especificado por la plataforma. Actualmente, eso es alrededor de 5 minutos. Este es el único valor admitido por Outlook.

long: solo se usa al configurar un entorno de ejecución de JavaScript compartido. El complemento puede iniciarse en el documento abierto y ejecutarse indefinidamente. 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 admitido por el entorno de ejecución compartido.

Share via