Office.Urls interface
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
javascript |
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 apenas do suplemento, o URL devolvido corresponde ao
resid
valor do elemento RuntimeOverride do tipojavascript
. 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]}`);