Compartilhar via

contexto (conjunto de requisitos da caixa de correio 1.13)

  • Artigo

Office.context

O Office.context fornece interfaces compartilhadas que são usadas por suplementos em todos os aplicativos do Office. Esta listagem documenta apenas as interfaces usados pelos suplementos do Outlook. Para uma listagem completa do namespace Office.context, veja a referência Office.context na API Comum.

Requisitos
Requisito Valor
Versão do conjunto de requisitos mínimos da caixa de correio 1.1
Modo do Outlook aplicável Escrever ou Ler

Propriedades

Propriedade Modos Tipo de retorno Minimum
conjunto de requisitos
Auth Escrever
Read		 Auth IdentityAPI 1.3
contentLanguage Escrever
Read		 Cadeia de caracteres 1.1
diagnóstico Escrever
Read		 ContextInformation 1.5
displayLanguage Escrever
Read		 Cadeia de caracteres 1.1
Host Escrever
Read		 HostType 1.5
mailbox Escrever
Read		 Caixa de Correio 1.1
Plataforma Escrever
Read		 PlatformType 1.5
Requisitos Escrever
Read		 RequirementSetSupport 1.1
roamingSettings Escrever
Read		 RoamingSettings 1.1
sensitivityLabelsCatalog Escrever SensitivityLabelsCatalog 1.13
ui Escrever
Read		 UI 1.1

Detalhes da propriedade

auth: Auth

Dá suporte ao SSO (logon único) fornecendo um método que permite que o aplicativo do Office obtenha um token de acesso ao aplicativo Web do suplemento. Indiretamente, isso também habilita o suplemento para acessar os dados do Microsoft Graph do usuário sem exigir que o usuário se conecte uma segunda vez.

Tipo
Requisitos
Requisito Valor
Versão do conjunto de requisitos mínimos da caixa de correio 1.10
Modo do Outlook aplicável Escrever ou Ler
Exemplo
Office.context.auth.getAccessTokenAsync(function(result) {
    if (result.status === "succeeded") {
        var token = result.value;
        // ...
    } else {
        console.log("Error obtaining token", result.error);
    }
});

contentLanguage: String

Obtém a localidade (idioma) especificada pelo usuário para edição do item.

O contentLanguage valor reflete a configuração atual de Linguagem de Edição especificada com Linguagem de Opções > de Arquivo > no aplicativo cliente do Office.

Tipo
  • String
Requisitos
Requisito Valor
Versão do conjunto de requisitos mínimos da caixa de correio 1.1
Modo do Outlook aplicável Escrever ou Ler
Exemplo
function sayHelloWithContentLanguage() {
  var myContentLanguage = Office.context.contentLanguage;
  switch (myContentLanguage) {
    case 'en-US':
      write('Hello!');
      break;
    case 'en-NZ':
      write('G\'day mate!');
      break;
  }
}

// Function that writes to a div with id='message' on the page.
function write(message){
  document.getElementById('message').innerText += message;
}

diagnóstico: ContextInformation

Obtém informações sobre o ambiente em que o suplemento está em execução.

Observação

Para todos os conjuntos de requisitos da caixa de correio, você também pode usar a propriedade Office.context.mailbox.diagnóstico para obter informações semelhantes.

Tipo
Requisitos
Requisito Valor
Versão do conjunto de requisitos mínimos da caixa de correio 1,5
Modo do Outlook aplicável Escrever ou Ler
Exemplo
var contextInfo = Office.context.diagnostics;
console.log("Office application: " + contextInfo.host);
console.log("Office version: " + contextInfo.version);
console.log("Platform: " + contextInfo.platform);

displayLanguage: String

Obtém a localidade (idioma) no formato de marca de linguagem RFC 1766 especificado pelo usuário para a interface do usuário do aplicativo cliente do Office.

O displayLanguage valor reflete a configuração atual da Linguagem de Exibição especificada comLinguagemde Opções> de Arquivo> no aplicativo cliente do Office.

Tipo
  • String
Requisitos
Requisito Valor
Versão do conjunto de requisitos mínimos da caixa de correio 1.1
Modo do Outlook aplicável Escrever ou Ler
Exemplo
function sayHelloWithDisplayLanguage() {
  var myDisplayLanguage = Office.context.displayLanguage;
  switch (myDisplayLanguage) {
    case 'en-US':
      write('Hello!');
      break;
    case 'en-NZ':
      write('G\'day mate!');
      break;
  }
}

// Function that writes to a div with id='message' on the page.
function write(message){
  document.getElementById('message').innerText += message;
}

host: HostType

Obtém o aplicativo do Office que está hospedando o suplemento.

Observação

Como alternativa, você pode usar a propriedade Office.context.diagnóstico para obter o host. Para todos os conjuntos de requisitos da caixa de correio, você também pode usar a propriedade Office.context.mailbox.diagnóstico para obter informações semelhantes.

Tipo
Requisitos
Requisito Valor
Versão do conjunto de requisitos mínimos da caixa de correio 1,5
Modo do Outlook aplicável Escrever ou Ler
Exemplo
console.log(JSON.stringify(Office.context.host));

plataforma: PlatformType

Fornece a plataforma na qual o suplemento está em execução.

Observação

Como alternativa, você pode usar a propriedade Office.context.diagnóstico para obter a plataforma. Para todos os conjuntos de requisitos da caixa de correio, você também pode usar a propriedade Office.context.mailbox.diagnóstico para obter informações semelhantes.

Tipo
Requisitos
Requisito Valor
Versão do conjunto de requisitos mínimos da caixa de correio 1,5
Modo do Outlook aplicável Escrever ou Ler
Exemplo
console.log(JSON.stringify(Office.context.platform));

requisitos: RequirementSetSupport

Fornece um método para determinar quais conjuntos de requisitos têm suporte no aplicativo e na plataforma atuais.

Tipo
Requisitos
Requisito Valor
Versão do conjunto de requisitos mínimos da caixa de correio 1.1
Modo do Outlook aplicável Escrever ou Ler
Exemplo
console.log(JSON.stringify(Office.context.requirements.isSetSupported("mailbox", "1.1")));

roamingSettings: RoamingSettings

Obtém um objeto que representa as configurações personalizadas ou o estado de um suplemento de email do Outlook salvos na caixa de correio do usuário.

O RoamingSettings objeto permite armazenar e acessar dados de um suplemento de email armazenado na caixa de correio de um usuário, de modo que esteja disponível para esse suplemento quando ele estiver em execução de qualquer cliente do Outlook usado para acessar essa caixa de correio.

Tipo
Requisitos
Requisito Valor
Versão do conjunto de requisitos mínimos da caixa de correio 1.1
Nível de permissão mínimo Restrito
Modo do Outlook aplicável Escrever ou Ler

sensitivityLabelsCatalog: SensitivityLabelsCatalog

Obtém o objeto para marcar o status do catálogo de rótulos de confidencialidade no Outlook e recuperar todos os rótulos de confidencialidade disponíveis se o catálogo estiver habilitado.

Tipo
Requisitos
Requisito Valor
Versão do conjunto de requisitos mínimos da caixa de correio 1.13
Nível de permissão mínimo item de leitura/gravação
Modo do Outlook aplicável Escrever

interface do usuário: interface do usuário

Fornece objetos e métodos que você pode usar para criar e manipular componentes da interface do usuário, como caixas de diálogo, em seus Suplementos do Office.

Tipo
Requisitos
Requisito Valor
Versão do conjunto de requisitos mínimos da caixa de correio 1.1
Modo do Outlook aplicável Escrever ou Ler