Office.Diagnostics interface

Obtém um objeto para identificar se os tokens de chamada de retorno dos Serviços Web exchange (EWS) são suportados numa organização.

ews: Ews;

Valor da propriedade

Comentários

[ Conjunto de API: Pré-visualização da caixa de correio ]

Nível mínimo de permissão: ler item

Modo Outlook aplicável: Compose ou Leitura

Importante:

• A ews propriedade está disponível para pré-visualização no Outlook na Web e no Windows (novo e clássico (Versão 2510, Compilação 19328.20000 e posterior)).

• Os tokens de identidade de utilizador e os tokens de chamada de retorno legados Exchange Online já não são suportados e estão desativados em todos os inquilinos do Microsoft 365. Se um suplemento do Outlook exigir acesso delegado ou identidade de utilizador, recomendamos que utilize a MSAL (Biblioteca de Autenticação da Microsoft) e a autenticação de aplicações aninhadas (NAA). Os tokens de identidade de utilizador do Exchange ainda são suportados no Exchange no local. Para obter mais informações, veja FAQ sobre autenticação de aplicações aninhadas.

Exemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/99-preview-apis/get-token-status.yaml

Office.context.mailbox.diagnostics.ews.getTokenStatusAsync({ isRest: false }, (result) => {
  if (result.status === Office.AsyncResultStatus.Failed) {
    console.log(result.error.message);
    return;
  }
  const status = result.value;
  switch (status) {
    case Office.MailboxEnums.TokenStatus.Enabled:
      console.log("EWS callback tokens are enabled.");
      break;
    case Office.MailboxEnums.TokenStatus.Disabled:
      console.log("EWS callback tokens are disabled.");
      break;
    case Office.MailboxEnums.TokenStatus.Removed:
      console.log(
        "The organization has an Exchange Online environment. Legacy Exchange tokens are no longer supported.",
      );
      break;
  }
});

Obtém uma cadeia que representa o tipo de cliente do Outlook.

A cadeia pode ser um dos seguintes valores: Outlook, , newOutlookWindowsOutlookWebApp, ou OutlookIOSOutlookAndroid.

hostName: string;

Valor da propriedade

Comentários

[ Conjunto de API: Caixa de Correio 1.1 ]

Nível mínimo de permissão: ler item

Modo Outlook aplicável: Compose ou Leitura

Importante: o Outlook valor é devolvido para o Outlook no Windows (clássico) e no Mac. newOutlookWindows é devolvido para o novo Outlook no Windows.

Obtém uma cadeia que representa a versão do cliente outlook ou do Exchange Server (por exemplo, "15.0.468.0").

Se o suplemento de correio estiver a ser executado no Outlook no Windows (clássico), no Mac ou em dispositivos móveis, a hostVersion propriedade devolve a versão do cliente Outlook. No Outlook na Web e no novo Outlook no Windows, a propriedade devolve a versão do Exchange Server.

hostVersion: string;

Valor da propriedade

Comentários

[ Conjunto de API: Caixa de Correio 1.1 ]

Nível mínimo de permissão: ler item

Modo Outlook aplicável: Compose ou Leitura

Obtém uma cadeia que representa a vista atual de Outlook na Web.

A cadeia devolvida pode ser um dos seguintes valores: OneColumn, TwoColumnsou ThreeColumns.

Se a aplicação não estiver Outlook na Web, aceder a esta propriedade resultará em indefinido.

Outlook na Web tem três vistas que correspondem à largura do ecrã e da janela e o número de colunas que podem ser apresentadas:

• OneColumn , que é apresentado quando o ecrã é estreito. Outlook na Web utiliza este esquema de coluna única em todo o ecrã de um smartphone.

• TwoColumns , que é apresentado quando o ecrã é mais largo. Outlook na Web utiliza esta vista na maioria dos tablets.

• ThreeColumns , que é apresentado quando o ecrã é largo. Por exemplo, Outlook na Web utiliza esta vista numa janela de ecrã inteiro num computador de secretária.

OWAView: MailboxEnums.OWAView | "OneColumn" | "TwoColumns" | "ThreeColumns";

Valor da propriedade

Comentários

[ Conjunto de API: Caixa de Correio 1.1 ]

Nível mínimo de permissão: ler item

Modo Outlook aplicável: Compose ou Leitura