Compartir a través de

Office.Urls interface

  • Referencia
Paquete:
office

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: Redacción o lectura

Propiedades

javascriptRuntimeUrl

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: Redacción 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 en el nuevo Outlook en Windows, esta API no se admite en los 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 tipo javascript. 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]}`);