Partager via

Élément Runtime

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 : Document, Courrier, Présentation, Volet Office, Classeur

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 :

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é.
  • 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, consultez Activer des compléments avec des événements.
  • Pour les rapports de courrier indésirable intégrés, 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 intégré de création de rapports de courrier indésirable.

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

Éléments enfants

Élément Obligatoire Description
Override Non Spécifie l’emplacement URL du fichier JavaScript requis par Office sur Windows pour les gestionnaires de points d’extension LaunchEvent et reportPhishingCommandSurface . 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 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

Facultatif. 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 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 avec l’activation basée sur les événements.

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é.

Voir aussi

  • Last updated on