Compartilhar via

Office.SensitivityLabelsCatalog interface

  • Referência
Pacote:
outlook

Fornece métodos para verificar o estado do catálogo de etiquetas de confidencialidade no Outlook e obter todas as etiquetas de confidencialidade disponíveis se o catálogo estiver ativado.

Comentários

[ Conjunto de API: Caixa de Correio 1.13 ]

Nível mínimo de permissão: item de leitura/escrita

Modo Outlook aplicável: Compor

Importante: para utilizar a funcionalidade de etiqueta de confidencialidade no seu suplemento, tem de ter uma subscrição do Microsoft 365 E5.

Para saber mais sobre como gerir etiquetas de confidencialidade no seu suplemento, consulte Gerir a etiqueta de confidencialidade da sua mensagem ou compromisso no modo de composição.

Métodos

getAsync(options, callback)

Obtém todas as etiquetas de confidencialidade que estão ativadas no Outlook.
getAsync(callback)

Obtém todas as etiquetas de confidencialidade que estão ativadas no Outlook.
getIsEnabledAsync(options, callback)

Verifica se o catálogo de etiquetas de confidencialidade está ativado no Outlook.
getIsEnabledAsync(callback)

Verifica se o catálogo de etiquetas de confidencialidade está ativado no Outlook.

Detalhes do método

getAsync(options, callback)

Obtém todas as etiquetas de confidencialidade que estão ativadas no Outlook.

getAsync(options: Office.AsyncContextOptions, callback: (asyncResult: Office.AsyncResult<SensitivityLabelDetails[]>) => void): void;

Parâmetros

options
Office.AsyncContextOptions

Um literal de objeto que contém uma ou mais das seguintes propriedades: asyncContext: os programadores podem fornecer qualquer objeto a que pretendam aceder na função de chamada de retorno.

callback

(asyncResult: Office.AsyncResult<Office.SensitivityLabelDetails[]>) => void

Quando o método for concluído, a função transmitida no callback parâmetro é chamada com um único parâmetro, asyncResult, que é um Office.AsyncResult objeto. As etiquetas de confidencialidade disponíveis e as respetivas propriedades são devolvidas na asyncResult.value propriedade .

Retornos

void

Comentários

[ Conjunto de API: Caixa de Correio 1.13 ]

Nível mínimo de permissão: item de leitura/escrita

Modo Outlook aplicável: Compor

Importante: para utilizar a funcionalidade de etiqueta de confidencialidade no seu suplemento, tem de ter uma subscrição do Microsoft 365 E5.

Recomendado: para determinar se o catálogo de etiquetas de confidencialidade está ativado no Outlook, chame getIsEnabledAsync antes de utilizar getAsync.

Para saber mais sobre como gerir etiquetas de confidencialidade no seu suplemento, consulte Gerir a etiqueta de confidencialidade da sua mensagem ou compromisso no modo de composição.

getAsync(callback)

Obtém todas as etiquetas de confidencialidade que estão ativadas no Outlook.

getAsync(callback: (asyncResult: Office.AsyncResult<SensitivityLabelDetails[]>) => void): void;

Parâmetros

callback

(asyncResult: Office.AsyncResult<Office.SensitivityLabelDetails[]>) => void

Quando o método for concluído, a função transmitida no callback parâmetro é chamada com um único parâmetro, asyncResult, que é um Office.AsyncResult objeto. As etiquetas de confidencialidade disponíveis e as respetivas propriedades são devolvidas na asyncResult.value propriedade .

Retornos

void

Comentários

[ Conjunto de API: Caixa de Correio 1.13 ]

Nível mínimo de permissão: item de leitura/escrita

Modo Outlook aplicável: Compor

Importante: para utilizar a funcionalidade de etiqueta de confidencialidade no seu suplemento, tem de ter uma subscrição do Microsoft 365 E5.

Recomendado: para determinar se o catálogo de etiquetas de confidencialidade está ativado no Outlook, chame getIsEnabledAsync antes de utilizar getAsync.

Para saber mais sobre como gerir etiquetas de confidencialidade no seu suplemento, consulte Gerir a etiqueta de confidencialidade da sua mensagem ou compromisso no modo de composição.

Exemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/60-sensitivity-label/sensitivity-labels-catalog.yaml

// This snippet gets all available sensitivity labels from the catalog.
Office.context.sensitivityLabelsCatalog.getIsEnabledAsync((asyncResult) => {
  if (asyncResult.status === Office.AsyncResultStatus.Succeeded && asyncResult.value == true) {
    Office.context.sensitivityLabelsCatalog.getAsync((asyncResult) => {
      if (asyncResult.status === Office.AsyncResultStatus.Succeeded) {
        const catalog = asyncResult.value;
        console.log("Sensitivity Labels Catalog:");
        console.log(JSON.stringify(catalog));
      } else {
        console.log("Action failed with error: " + asyncResult.error.message);
      }
    });
  } else {
    console.log("Action failed with error: " + asyncResult.error.message);
  }
});

getIsEnabledAsync(options, callback)

Verifica se o catálogo de etiquetas de confidencialidade está ativado no Outlook.

getIsEnabledAsync(options: Office.AsyncContextOptions, callback: (asyncResult: Office.AsyncResult<boolean>) => void): void;

Parâmetros

options
Office.AsyncContextOptions

Um literal de objeto que contém uma ou mais das seguintes propriedades: asyncContext: os programadores podem fornecer qualquer objeto a que pretendam aceder na função de chamada de retorno.

callback

(asyncResult: Office.AsyncResult<boolean>) => void

Quando o método for concluído, a função transmitida no callback parâmetro é chamada com um único parâmetro, asyncResult, que é um Office.AsyncResult objeto. O estado do catálogo de etiquetas de confidencialidade é devolvido na asyncResult.value propriedade .

Retornos

void

Comentários

[ Conjunto de API: Caixa de Correio 1.13 ]

Nível mínimo de permissão: item de leitura/escrita

Modo Outlook aplicável: Compor

Importante: o catálogo de etiquetas de confidencialidade é configurado pelo administrador de uma organização. Para obter mais informações, veja Introdução às etiquetas de confidencialidade.

Importante: para utilizar a funcionalidade de etiqueta de confidencialidade no seu suplemento, tem de ter uma subscrição do Microsoft 365 E5.

Para saber mais sobre como gerir etiquetas de confidencialidade no seu suplemento, consulte Gerir a etiqueta de confidencialidade da sua mensagem ou compromisso no modo de composição.

getIsEnabledAsync(callback)

Verifica se o catálogo de etiquetas de confidencialidade está ativado no Outlook.

getIsEnabledAsync(callback: (asyncResult: Office.AsyncResult<boolean>) => void): void;

Parâmetros

callback

(asyncResult: Office.AsyncResult<boolean>) => void

Quando o método for concluído, a função transmitida no callback parâmetro é chamada com um único parâmetro, asyncResult, que é um Office.AsyncResult objeto. O estado do catálogo de etiquetas de confidencialidade é devolvido na asyncResult.value propriedade .

Retornos

void

Comentários

[ Conjunto de API: Caixa de Correio 1.13 ]

Nível mínimo de permissão: item de leitura/escrita

Modo Outlook aplicável: Compor

Importante: o catálogo de etiquetas de confidencialidade é configurado pelo administrador de uma organização. Para obter mais informações, veja Introdução às etiquetas de confidencialidade.

Importante: para utilizar a funcionalidade de etiqueta de confidencialidade no seu suplemento, tem de ter uma subscrição do Microsoft 365 E5.

Para saber mais sobre como gerir etiquetas de confidencialidade no seu suplemento, consulte Gerir a etiqueta de confidencialidade da sua mensagem ou compromisso no modo de composição.

Exemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/60-sensitivity-label/sensitivity-labels-catalog.yaml

// This snippet determines if the sensitivity labels catalog is enabled on the current mailbox.
Office.context.sensitivityLabelsCatalog.getIsEnabledAsync((asyncResult) => {
  if (asyncResult.status === Office.AsyncResultStatus.Succeeded) {
    console.log(asyncResult.value);
  } else {
    console.log("Action failed with error: " + asyncResult.error.message);
  }
});