Runtimeelement

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

Add-In-Typ: Dokument, E-Mail, Präsentation, Aufgabenbereich, Arbeitsmappe

Nur in diesen VersionOverrides-Schemas gültig:

  • Aufgabenbereich 1.0
  • Mail 1.1

Weitere Informationen finden Sie unter Versionsüberschreibungen im Nur-Add-In-Manifest.

Diesen Anforderungssätzen zugeordnet:

Wichtig

  • Für die freigegebene JavaScript-Laufzeit ermöglicht dieses Element dem Menüband, dem Aufgabenbereich und anderen unterstützten Komponenten, dieselbe Laufzeit zu verwenden. Der SharedRuntime-Anforderungssatz ist jedoch nur in einigen Office-Anwendungen verfügbar. Weitere Informationen finden Sie unter Gemeinsame Laufzeitanforderungsgruppen.
  • Bei der ereignisbasierten Aktivierung ermöglicht dieses Element die Ausführung des Add-Ins z. B. beim Verfassen eines neuen Elements. Weitere Informationen zu unterstützten Clients finden Sie unter Aktivieren von Add-Ins mit Ereignissen.
  • Für das integrierte Spam-Reporting ermöglicht dieses Element Ihrem Add-In die Verarbeitung unerwünschter Nachrichten. Weitere Informationen zum Implementieren der integrierten Spamberichtsfunktion in Ihrem Add-In finden Sie unter Implementieren eines integrierten Add-In für die Spamberichterstattung.

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

Syntax

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

Enthalten in

Untergeordnete Elemente

Element Erforderlich Beschreibung
Override Nein Gibt den URL-Speicherort der JavaScript-Datei an, die Office unter Windows für die Erweiterungspunkthandler "LaunchEvent " und "ReportPhishingCommandSurface" benötigt. Wichtig: Derzeit können Sie nur ein <Override-Element> definieren und es muss vom Typ javascript.

Attribute

Attribut Erforderlich Beschreibung
resid Ja Gibt den URL-Speicherort der HTML-Seite für Ihr Add-In an. Sie resid dürfen nicht länger als 32 Zeichen sein und müssen mit einem id Attribut eines Url Elements in dem Resources Element übereinstimmen.

Wichtig: Wenn Sie einen LaunchEvent Erweiterungspunkt oder ein ReportPhishingCustomization Element in Ihrem Manifest angeben, stellen Sie sicher, dass das resid Attribut des untergeordneten <SourceLocation-Elements> mit dem resid Wert des <Runtime-Elements> übereinstimmt. Wenn Ihre Laufzeit beispielsweise als <Runtime resid="WebViewRuntime.Url">definiert ist, geben Sie <SourceLocation resid="WebViewRuntime.Url"/>an.
Lebensdauer Nein Der Standardwert für lifetime ist short und muss nicht angegeben werden. Ereignisbasierte Aktivierungs- und Spam-Berichts-Add-Ins verwenden nur den short Wert. Wenn Sie eine freigegebene Laufzeit in einem Excel-Add-In verwenden möchten, setzen Sie den Wert explizit auf long.

Lebensdauer-Attribut

Optional. Gibt an, wie lange das Add-In ausgeführt werden darf.

Verfügbare Werte

short: Standardeinstellung. Wird nur für ereignisbasierte Aktivierungs- und Spamberichterstellungs-Add-Ins verwendet. Nachdem das Add-In aktiviert wurde, wird es maximal so lange ausgeführt, wie von der Plattform festgelegt. Derzeit sind das etwa 5 Minuten. Dies ist der einzige Wert, der bei der ereignisbasierten Aktivierung unterstützt wird.

long: Wird nur beim Konfigurieren einer freigegebenen JavaScript-Laufzeit verwendet. Das Add-In kann beim Öffnen des Dokuments gestartet und unbegrenzt ausgeführt werden. So wird beispielsweise Aufgabenbereichscode auch dann weiter ausgeführt, wenn der Benutzer den Aufgabenbereich geschlossen hat. Dies ist der einzige Wert, der von der freigegebenen Laufzeit unterstützt wird.

Siehe auch

  • Last updated on