Partager via

Office.Urls interface

  • Référence
Paquet:
office

Fournit les URL des environnements d’exécution utilisés par un complément.

Remarques

[ Ensemble d’API : Boîte aux lettres 1.14 ]

Niveau d’autorisation minimal : restreint

Mode Outlook applicable : Rédiger ou Lire

Propriétés

javascriptRuntimeUrl

Obtient l’URL du runtime JavaScript d’un complément.

Détails de la propriété

javascriptRuntimeUrl

Obtient l’URL du runtime JavaScript d’un complément.

javascriptRuntimeUrl: string;

Valeur de propriété

string

Remarques

[ Ensemble d’API : Boîte aux lettres 1.14 ]

Niveau d’autorisation minimal : restreint

Mode Outlook applicable : Rédiger ou Lire

Important:

  • L’URL retournée pointe vers l’emplacement du fichier JavaScript utilisé par Outlook sur Windows classique pour gérer l’activation basée sur les événements et les rapports de courrier indésirable intégrés. Pour en savoir plus sur ces fonctionnalités, voir Configurer votre complément Outlook pour l’activation basée sur les événements et Implémenter un complément de création de rapports de courrier indésirable intégré.

  • Dans Outlook sur le web et outlook sur Windows, cette API n’est pas prise en charge dans les compléments qui implémentent un volet Office. Sur ces clients, l’API n’est prise en charge que dans les compléments qui implémentent l’activation basée sur les événements ou la création de rapports de courrier indésirable intégrés.

  • Si votre complément utilise le manifeste XML, l’URL retournée correspond à la resid valeur de l’élément RuntimeOverride de type javascript. Pour plus d’informations, consultez Override element for Runtime.

  • Si votre complément utilise le manifeste unifié pour Microsoft 365, l’URL retournée correspond à la valeur de la script propriété dans l’objet « extensions.runtimes.code ».

Exemples

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