Office.Urls interface

  • Referenz
Paket:
office

Hinweis

Diese API wird als Vorschau für Entwickler bereitgestellt. Je nachdem, welches Feedback wir dazu erhalten, werden möglicherweise Änderungen vorgenommen. Verwenden Sie diese API nicht in einer Produktionsumgebung.

Stellt die URLs der Laufzeitumgebungen bereit, die von einem Add-In verwendet werden.

Hinweise

[ API-Satz: Postfachvorschau ]

Mindestberechtigungsstufe: eingeschränkt

Anwendbarer Outlook-Modus: Verfassen oder Lesen

Eigenschaften

javascriptRuntimeUrl

Ruft die URL der JavaScript-Runtime eines Add-Ins ab.

Details zur Eigenschaft

javascriptRuntimeUrl

Hinweis

Diese API wird als Vorschau für Entwickler bereitgestellt. Je nachdem, welches Feedback wir dazu erhalten, werden möglicherweise Änderungen vorgenommen. Verwenden Sie diese API nicht in einer Produktionsumgebung.

Ruft die URL der JavaScript-Runtime eines Add-Ins ab.

javascriptRuntimeUrl: string;

Eigenschaftswert

string

Hinweise

[ API-Satz: Postfachvorschau ]

Mindestberechtigungsstufe: eingeschränkt

Anwendbarer Outlook-Modus: Verfassen oder Lesen

Wichtig:

  • Diese Eigenschaft befindet sich derzeit in Outlook unter Windows in der Vorschauphase. Zum Testen in Ihrem Add-In müssen Sie Version 2401 (Build 17228.20000) oder höher installieren. Nehmen Sie dann am Microsoft 365 Insider-Programm teil, und wählen Sie die Option Betakanal aus, um auf Office-Beta-Builds zuzugreifen.

  • Die zurückgegebene URL verweist auf den Speicherort der JavaScript-Datei, die Outlook unter Windows zum Verarbeiten der ereignisbasierten Aktivierung und der integrierten Spamberichterstattung verwendet. Weitere Informationen zu diesen Features finden Sie unter Konfigurieren Ihres Outlook-Add-Ins für die ereignisbasierte Aktivierung und Implementieren eines integrierten Spamberichts-Add-Ins (Vorschau).

  • Wenn Ihr Add-In das XML-Manifest verwendet, entspricht die zurückgegebene URL dem resid Wert des RuntimeOverride-Elements vom Typ javascript. Weitere Informationen finden Sie unter Override-Element für Runtime.

  • Wenn Ihr Add-In das einheitliche Manifest für Microsoft 365 (Entwicklervorschau) verwendet, entspricht die zurückgegebene URL dem Wert der script Eigenschaft im "code"-Objekt.

Beispiele

// Get the value of the first parameter of the JavaScript runtime URL.
// For example, if the URL is https://wwww.contoso.com/training?key1=value1&key2=value2,
// the following function logs "First parameter value: value1" to the console.
const url = Office.context.urls.javascriptRuntimeUrl;
const regex = /=([^&]+)/;
console.log(`First parameter value: ${url.match(regex)[1]}`);