Office.Urls interface
Proporciona las direcciones URL de los entornos en tiempo de ejecución que usa un complemento.
Comentarios
[ Conjunto de API: Buzón 1.14 ]
Nivel mínimo de permiso: restringido
Modo de Outlook aplicable: Compose o lectura
Propiedades
javascript |
Obtiene la dirección URL del entorno de ejecución de JavaScript de un complemento. |
Detalles de las propiedades
javascriptRuntimeUrl
Obtiene la dirección URL del entorno de ejecución de JavaScript de un complemento.
javascriptRuntimeUrl: string;
Valor de propiedad
string
Comentarios
[ Conjunto de API: Buzón 1.14 ]
Nivel mínimo de permiso: restringido
Modo de Outlook aplicable: Compose o lectura
Importante:
La dirección URL devuelta apunta a la ubicación del archivo JavaScript que outlook clásico en Windows usa para controlar la activación basada en eventos y los informes integrados de correo no deseado. Para obtener más información sobre estas características, vea Configurar el complemento de Outlook para la activación basada en eventos e Implementar un complemento integrado de informes de correo no deseado.
En Outlook en la Web y nueva Outlook en Windows, esta API no se admite en complementos que implementan un panel de tareas. En estos clientes, la API solo se admite en complementos que implementan la activación basada en eventos o informes de correo no deseado integrados.
Si el complemento usa el manifiesto de solo complemento, la dirección URL devuelta coincide con el
resid
valor del elemento RuntimeOverride del tipojavascript
. Para obtener más información, consulte Override element for Runtime (Invalidar elemento para runtime).Si el complemento usa el manifiesto unificado para Microsoft 365, la dirección URL devuelta coincide con el valor de la
script
propiedad en el objeto "extensions.runtimes.code".
Ejemplos
// 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]}`);