Compartilhar via

Office.Urls interface

  • Referência
Pacote:
office

Fornece os URLs dos ambientes de runtime utilizados por um suplemento.

Comentários

[ Conjunto de API: Caixa de Correio 1.14 ]

Nível mínimo de permissão: restrito

Modo Outlook aplicável: Compor ou Ler

Propriedades

javascriptRuntimeUrl

Obtém o URL do runtime javaScript de um suplemento.

Detalhes da propriedade

javascriptRuntimeUrl

Obtém o URL do runtime javaScript de um suplemento.

javascriptRuntimeUrl: string;

Valor da propriedade

string

Comentários

[ Conjunto de API: Caixa de Correio 1.14 ]

Nível mínimo de permissão: restrito

Modo Outlook aplicável: Compor ou Ler

Importante:

  • O URL que devolveu aponta para a localização do ficheiro JavaScript que o Outlook clássico no Windows utiliza para processar a ativação baseada em eventos e os relatórios de spam integrados. Para saber mais sobre estas funcionalidades, consulte Configurar o seu suplemento do Outlook para ativação baseada em eventos e Implementar um suplemento integrado de relatórios de spam.

  • No Outlook na Web e no novo Outlook no Windows, esta API não é suportada em suplementos que implementam um painel de tarefas. Nestes clientes, a API só é suportada em suplementos que implementam a ativação baseada em eventos ou relatórios de spam integrados.

  • Se o suplemento utilizar o manifesto XML, o URL devolvido corresponde ao resid valor do elemento RuntimeOverride do tipo javascript. Para saber mais, veja Substituir elemento para Runtime.

  • Se o suplemento utilizar o manifesto unificado para o Microsoft 365, o URL devolvido corresponde ao valor da script propriedade no objeto "extensions.runtimes.code".

Exemplos

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