Élément Runtime

Article
09/19/2024

Configure votre complément pour utiliser un runtime JavaScript partagé afin que les différents composants s’exécutent tous dans le même runtime. Enfant de l’élément Runtimes .

Type de complément : Volet Office, Courrier

Valide uniquement dans les schémas VersionOverrides suivants :

Volet De tâches 1.0
Courrier 1.1

Pour plus d’informations, consultez Remplacements de version dans le manifeste du complément uniquement.

Associé à ces ensembles de conditions requises :

SharedRuntime 1.1 (uniquement lorsqu’il est utilisé dans un complément du volet Office.)
Boîte aux lettres 1.10 et versions ultérieures (lorsqu’elle est utilisée dans un complément Outlook qui implémente l’activation basée sur les événements.)
Aperçu de la boîte aux lettres (lorsqu’il est utilisé dans un complément Outlook qui implémente la fonctionnalité intégrée de création de rapports de courrier indésirable (préversion). )

Importante

Pour le runtime JavaScript partagé, cet élément permet au ruban, au volet Office et aux autres composants pris en charge d’utiliser le même runtime. Toutefois, l’ensemble de conditions requises SharedRuntime n’est disponible que dans certaines applications Office. Pour plus d’informations, consultez Ensembles de conditions requises pour le runtime partagé.

Outlook

Pour l’activation basée sur les événements, cet élément permet à votre complément de s’exécuter lors de la composition d’un nouvel élément, par exemple. Pour connaître les clients pris en charge et d’autres informations, voir Configurer votre complément Outlook pour l’activation basée sur les événements.
Pour les rapports de courrier indésirable intégrés (préversion), cet élément permet à votre complément de traiter les messages non sollicités. Pour en savoir plus sur la façon d’implémenter la fonctionnalité de rapport de courrier indésirable intégrée dans votre complément, consultez Implémenter un complément de création de rapports de courrier indésirable intégré (préversion) .

Notez que les fonctionnalités d’activation basée sur les événements et de création de rapports de courrier indésirable intégrées doivent utiliser le même runtime. Les runtimes multiples ne sont actuellement pas pris en charge dans Outlook.

Syntaxe

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

Contenu dans

Runtimes

Éléments enfants

Élément	Obligatoire	Description
Override	Non	Outlook : spécifie l’emplacement URL du fichier JavaScript requis par Outlook sur Windows pour les gestionnaires de point d’extension LaunchEvent et de point d’extension ReportPhishingCommandSurface (préversion). Important : À l’heure actuelle, vous ne pouvez définir qu’un <seul élément Override> et doit être de type `javascript`.

Attributs

Attribut	Obligatoire	Description
resid	Oui	Spécifie l’emplacement DE l’URL de la page HTML de votre complément. Ne `resid` peut pas comporter plus de 32 caractères et doit correspondre à un `id` attribut d’un `Url` élément dans l’élément `Resources` .
vie	Non	La valeur par défaut pour `lifetime` est `short` et n’a pas besoin d’être spécifiée. Les compléments d’activation basée sur les événements et de création de rapports de courrier indésirable Outlook utilisent uniquement la `short` valeur . Si vous souhaitez utiliser un runtime partagé dans un complément Excel, définissez explicitement la valeur sur `long`.

attribut lifetime

Optional. Représente la durée pendant laquelle le complément est autorisé à s’exécuter.

Valeurs disponibles

short:Faire défaut. Utilisé uniquement pour l’activation basée sur les événements Outlook et les compléments de création de rapports de courrier indésirable. Une fois le complément activé, il s’exécute pendant une durée maximale spécifiée par la plateforme. Actuellement, c’est environ 5 minutes. Il s’agit de la seule valeur prise en charge par Outlook.

long: utilisé uniquement lors de la configuration d’un runtime JavaScript partagé. Le complément peut démarrer à l’ouverture du document et s’exécuter indéfiniment. Par exemple, le code du volet Office continue de s’exécuter même lorsque l’utilisateur ferme le volet Office. Il s’agit de la seule valeur prise en charge par le runtime partagé.

Partager via