Office.Urls interface

Paquet:

office

Notes

Cet API est fourni en tant qu’aperçu pour les développeurs et peut être modifié en fonction des commentaires que nous avons reçus. N’utilisez pas cet API dans un environnement de production.

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

Remarques

[ Ensemble d’API : préversion de boîte aux lettres ]

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

Notes

Cet API est fourni en tant qu’aperçu pour les développeurs et peut être modifié en fonction des commentaires que nous avons reçus. N’utilisez pas cet API dans un environnement de production.

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

javascriptRuntimeUrl: string;

Valeur de propriété

string

Remarques

[ Ensemble d’API : préversion de boîte aux lettres ]

Niveau d’autorisation minimal : restreint

Mode Outlook applicable : Rédiger ou Lire

Important:

• Cette propriété est actuellement en préversion dans Outlook sur Windows. Pour le tester dans votre complément, vous devez installer la version 2401 (build 17228.20000) ou une version ultérieure. Ensuite, rejoignez le programme Microsoft 365 Insider et sélectionnez l’option Canal bêta pour accéder aux builds bêta d’Office.

• L’URL retournée pointe vers l’emplacement du fichier JavaScript utilisé par Outlook sur Windows pour gérer l’activation basée sur les événements et les rapports de courrier indésirable intégré. Pour en savoir plus sur ces fonctionnalités, consultez 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é (préversion) .

• 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 (préversion pour les développeurs), l’URL retournée correspond à la valeur de la script propriété dans l’objet « 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]}`);