Runtime-Element

Artikel
11/08/2023

Konfiguriert Ihr Add-In für die Verwendung einer freigegebenen JavaScript-Runtime, sodass verschiedene Komponenten alle in derselben Runtime ausgeführt werden. Untergeordnetes Element des Runtimes-Elements .

Add-In-Typ: Aufgabenbereich, E-Mail

Nur in den folgenden VersionOverrides-Schemas gültig:

Aufgabenbereich 1.0
Mail 1.1

Weitere Informationen finden Sie unter Versionsüberschreibungen im Manifest.

Diesen Anforderungssätzen zugeordnet:

SharedRuntime 1.1 (Nur bei Verwendung in einem Aufgabenbereich-Add-In.)
Postfach 1.10 und höher (bei Verwendung in einem Outlook-Add-In, das die ereignisbasierte Aktivierung implementiert.)
Postfachvorschau (bei Verwendung in einem Outlook-Add-In, das das Feature für die integrierte Spamberichterstattung (Vorschau) implementiert.)

Wichtig

Für die freigegebene JavaScript-Runtime ermöglicht dieses Element dem Menüband, dem Aufgabenbereich und anderen unterstützten Komponenten die Verwendung derselben Runtime. Der SharedRuntime-Anforderungssatz ist jedoch nur in einigen Office-Anwendungen verfügbar. Weitere Informationen finden Sie unter Gemeinsame Laufzeitanforderungsgruppen.

Outlook

Für die ereignisbasierte Aktivierung ermöglicht dieses Element die Ausführung Ihres Add-Ins beispielsweise beim Verfassen eines neuen Elements. Unterstützte Clients und andere Informationen finden Sie unter Konfigurieren Ihres Outlook-Add-Ins für die ereignisbasierte Aktivierung.
Für die integrierte Spamberichterstattung (Vorschau) ermöglicht dieses Element Ihrem Add-In die Verarbeitung unerwünschter Nachrichten. Weitere Informationen zum Implementieren der integrierten Spamberichterstattungsfunktion in Ihrem Add-In finden Sie unter Implementieren eines integrierten Spamberichts-Add-Ins (Vorschau).

Beachten Sie, dass die funktionen für die ereignisbasierte Aktivierung und die integrierte Spamberichterstattung dieselbe Laufzeit verwenden müssen. Mehrere Runtimes werden in Outlook derzeit nicht unterstützt.

Syntax

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

Enthalten in

Laufzeiten

Untergeordnete Elemente

Element	Erforderlich	Beschreibung
Override	Nein	Outlook: Gibt den URL-Speicherort der JavaScript-Datei an, die Outlook unter Windows für launchEvent-Erweiterungspunkt - und ReportPhishingCommandSurface-Erweiterungspunkthandler (Vorschau) benötigt. Wichtig: Derzeit können Sie nur ein <Override-Element> definieren, das vom Typ `javascript`sein muss.

Attribute

Attribut	Erforderlich	Beschreibung
resid	Ja	Gibt den URL-Speicherort der HTML-Seite für Ihr Add-In an. der `resid` darf nicht mehr als 32 Zeichen lang sein und muss mit einem `id` Attribut eines `Url` Elements im `Resources` -Element übereinstimmen.
Lebensdauer	Nein	Der Standardwert für `lifetime` ist `short` und muss nicht angegeben werden. Ereignisbasierte Outlook-Aktivierungs- und Spamberichts-Add-Ins verwenden nur den `short` Wert. Wenn Sie eine freigegebene Runtime in einem Excel-Add-In verwenden möchten, legen Sie den Wert explizit auf fest `long`.

Lifetime-Attribut

Optional. Stellt die Dauer dar, für die das Add-In ausgeführt werden darf.

Verfügbare Werte

short:Standard. Wird nur für ereignisbasierte Outlook-Aktivierungs- und Spamberichts-Add-Ins verwendet. Nachdem das Add-In aktiviert wurde, wird es für einen von der Plattform angegebenen Zeitraum ausgeführt. Derzeit sind das etwa 5 Minuten. Dies ist der einzige Wert, der von Outlook unterstützt wird.

long: Wird nur beim Konfigurieren einer freigegebenen JavaScript-Runtime verwendet. Das Add-In kann beim Öffnen des Dokuments beginnen und unbegrenzt ausgeführt werden. Beispielsweise wird der Aufgabenbereichscode weiterhin ausgeführt, auch wenn der Benutzer den Aufgabenbereich schließt. Dies ist der einzige Wert, der von der freigegebenen Runtime unterstützt wird.