Freigeben über

Office.Urls interface

  • Referenz
Paket:
office

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

Hinweise

[ API-Satz: Postfach 1.14 ]

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

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

javascriptRuntimeUrl: string;

Eigenschaftswert

string

Hinweise

[ API-Satz: Postfach 1.14 ]

Mindestberechtigungsstufe: eingeschränkt

Anwendbarer Outlook-Modus: Verfassen 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 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 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 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]}`);