Freigeben über

Runtime-Element

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:: Dokument, E-Mail, Präsentation, Aufgabenbereich, Arbeitsmappe

Nur in den folgenden VersionOverrides-Schemas gültig:

  • Aufgabenbereich 1.0
  • Mail 1.1

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

Diesen Anforderungssätzen zugeordnet:

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.
  • 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 Aktivieren von Add-Ins mit Ereignissen.
  • Für die integrierte Spamberichterstattung 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.

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

Untergeordnete Elemente

Element Erforderlich Beschreibung
Override Nein Gibt den URL-Speicherort der JavaScript-Datei an, die Office unter Windows für launchEvent-Erweiterungspunkt und ReportPhishingCommandSurface-Erweiterungspunkthandler benötigt. Wichtig: Derzeit können Sie nur ein <Override-Element> definieren, das vom Typ javascriptsein 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 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:Vorgabe. Wird nur für ereignisbasierte 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 bei der ereignisbasierten Aktivierung 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.

Siehe auch

  • Last updated on