Office.Urls interface

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

javascriptRuntimeUrl: string;

Eigenschaftswert

Hinweise

[ API-Satz: Postfach 1.14 ]

Mindestberechtigungsstufe: eingeschränkt

Anwendbarer Outlook-Modus: Compose oder Lesen

Wichtig:

• Die zurückgegebene URL verweist auf den Speicherort der JavaScript-Datei, die das klassische Outlook unter Windows für die ereignisbasierte Aktivierung und integrierte 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.

• In Outlook im Web und neuen Outlook unter Windows wird diese API in Add-Ins, die einen Aufgabenbereich implementieren, nicht unterstützt. Auf diesen Clients wird die API nur in Add-Ins unterstützt, die eine ereignisbasierte Aktivierung oder integrierte Spamberichterstattung implementieren.

• Wenn Ihr Add-In nur das Add-In-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 verwendet, entspricht die zurückgegebene URL dem Wert der script Eigenschaft im Objekt "extensions.runtimes.code".

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]}`);