Office.NotificationMessages interface

Pacote:: outlook

O objeto NotificationMessages é retornado como a propriedade notificationMessages de um item.

Comentários

[ Conjunto de API: Caixa de Correio 1.3 ]

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

Modo Outlook aplicável: Compose ou Leitura

Importante: para saber mais sobre os diferentes tipos de mensagens de notificação que pode implementar, consulte Criar notificações para o seu suplemento do Outlook.

Métodos

addAsync(key, JSONmessage, options, callback)	Adiciona uma notificação a um item.
addAsync(key, JSONmessage, callback)	Adiciona uma notificação a um item.
getAllAsync(options, callback)	Retorna todas as chaves e mensagens de um item.
getAllAsync(callback)	Retorna todas as chaves e mensagens de um item.
removeAsync(key, options, callback)	Obtém uma mensagem de notificação de um item.
removeAsync(key, callback)	Obtém uma mensagem de notificação de um item.
replaceAsync(key, JSONmessage, options, callback)	Substitui uma mensagem de notificação que tenha uma determinada chave com outra mensagem. Se uma mensagem de notificação com a chave especificada não existir, `replaceAsync` adicionará a notificação.
replaceAsync(key, JSONmessage, callback)	Substitui uma mensagem de notificação que tenha uma determinada chave com outra mensagem. Se uma mensagem de notificação com a chave especificada não existir, `replaceAsync` adicionará a notificação.

Detalhes do método

addAsync(key, JSONmessage, options, callback)

Adiciona uma notificação a um item.

addAsync(key: string, JSONmessage: NotificationMessageDetails, options: Office.AsyncContextOptions, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;

Parâmetros

key: string

Uma chave especificada pelo desenvolvedor usada para fazer referência a essa mensagem de notificação. Os desenvolvedores podem usá-la para modificar esta mensagem mais tarde. Ela não pode ter mais de 32 caracteres.

JSONmessage: Office.NotificationMessageDetails

Um objeto JSON que contém a mensagem de notificação a ser adicionada ao item. Contém um NotificationMessageDetails objeto.

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<void>) => void

Opcional. Quando o método for concluído, a função transmitida no callback parâmetro é chamada com um único parâmetro do tipo Office.AsyncResult.

Retornos

void

Comentários

[ Conjunto de API: Caixa de Correio 1.3 ]

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

Modo Outlook aplicável: Compose ou Leitura

Importante:

No Outlook na Web, no Windows (novo e clássico) e no Mac, pode definir um máximo de cinco notificações por mensagem. Definir mais devolve um NumberOfNotificationMessagesExceeded erro. No Outlook para Android e no iOS, só pode definir uma notificação por mensagem. Definir uma notificação adicional substitui a anterior.
Só é permitida uma notificação do tipo InsightMessage por suplemento. Tentar adicionar mais irá gerar um erro.
No Outlook na Web moderno e no novo Outlook no Windows, só pode adicionar uma InsightMessage notificação no modo Compose.
No Outlook para Android e no iOS, apenas são suportados os ProgressIndicatortipos de notificação , InformationalMessagee ErrorMessage .
No modo de composição, enquanto o estilo de cada tipo de notificação varia em outros clientes do Outlook, as notificações no Outlook para Android e no iOS utilizam o mesmo estilo. A mensagem de notificação tem sempre um prefixo com um ícone informativo.
O addAsync método não é suportado numa mensagem atualmente carregada com o loadItemByIdAsync método . Para obter mais informações, consulte Ativar o seu suplemento do Outlook em várias mensagens.

Exemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/35-notifications/add-getall-remove.yaml

// Adds a progress indicator to the mail item.
const id = (document.getElementById("notificationId") as HTMLInputElement).value;
const details =
  {
    type: Office.MailboxEnums.ItemNotificationMessageType.ProgressIndicator,
    message: "Progress indicator with id = " + id
  };
Office.context.mailbox.item.notificationMessages.addAsync(id, details, (result) => {
  if (result.status === Office.AsyncResultStatus.Failed) {
    console.log(`Failed to add progress notification with id = ${id}. Try using a different ID.`);
    return;
  }
  console.log(`Added progress notification with id = ${id}.`);
});

...

// Adds an informational notification to the mail item.
const id = (document.getElementById("notificationId") as HTMLInputElement).value;
const details =
  {
    type: Office.MailboxEnums.ItemNotificationMessageType.InformationalMessage,
    message: "Non-persistent informational notification message with id = " + id,
    icon: "PG.Icon.16",
    persistent: false
  };
Office.context.mailbox.item.notificationMessages.addAsync(id, details, (result) => {
  if (result.status === Office.AsyncResultStatus.Failed) {
    console.log(`Failed to add informational notification with id = ${id}. Try using a different ID.`);
    return;
  }
  console.log(`Added informational notification with id = ${id}.`);
});

...

// Adds a persistent information notification to the mail item.
const id = (document.getElementById("notificationId") as HTMLInputElement).value;
const details =
  {
    type: Office.MailboxEnums.ItemNotificationMessageType.InformationalMessage,
    message: "Persistent informational notification message with id = " + id,
    icon: "PG.Icon.16",
    persistent: true
  };
Office.context.mailbox.item.notificationMessages.addAsync(id, details, (result) => {
  if (result.status === Office.AsyncResultStatus.Failed) {
    console.log(`Failed to add persistent informational notification with id = ${id}. Try using a different ID.`);
    return;
  }
  console.log(`Added persistent informational notification with id = ${id}.`);
});

...

// Adds an error notification to the mail item.
const id = (document.getElementById("notificationId") as HTMLInputElement).value;
const details =
  {
    type: Office.MailboxEnums.ItemNotificationMessageType.ErrorMessage,
    message: "Error notification message with id = " + id
  };
Office.context.mailbox.item.notificationMessages.addAsync(id, details, (result) => {
  if (result.status === Office.AsyncResultStatus.Failed) {
    console.log(`Failed to add error notification with id = ${id}. Try using a different ID.`);
    return;
  }
  console.log(`Added error notification with id = ${id}.`);
});

addAsync(key, JSONmessage, callback)

Adiciona uma notificação a um item.

addAsync(key: string, JSONmessage: NotificationMessageDetails, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;

Parâmetros

key: string

JSONmessage: Office.NotificationMessageDetails

Um objeto JSON que contém a mensagem de notificação a ser adicionada ao item. Contém um NotificationMessageDetails objeto.

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

Opcional. Quando o método for concluído, a função transmitida no callback parâmetro é chamada com um único parâmetro do tipo Office.AsyncResult.

Retornos

void

Comentários

[ Conjunto de API: Caixa de Correio 1.3 ]

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

Modo Outlook aplicável: Compose ou Leitura

Importante:

No Outlook na Web, no Windows (novo e clássico) e no Mac, pode definir um máximo de cinco notificações por mensagem. Definir mais devolve um NumberOfNotificationMessagesExceeded erro. No Outlook para Android e no iOS, só pode definir uma notificação por mensagem. Definir uma notificação adicional substitui a anterior.
Só é permitida uma notificação do tipo InsightMessage por suplemento. Tentar adicionar mais irá gerar um erro.
No Outlook na Web moderno e no novo Outlook no Windows, só pode adicionar uma InsightMessage notificação no modo Compose.
No Outlook para Android e no iOS, apenas são suportados os ProgressIndicatortipos de notificação , InformationalMessagee ErrorMessage .
No modo de composição, enquanto o estilo de cada tipo de notificação varia em outros clientes do Outlook, as notificações no Outlook para Android e no iOS utilizam o mesmo estilo. A mensagem de notificação tem sempre um prefixo com um ícone informativo.
O addAsync método não é suportado numa mensagem atualmente carregada com o loadItemByIdAsync método . Para obter mais informações, consulte Ativar o seu suplemento do Outlook em várias mensagens.

getAllAsync(options, callback)

Retorna todas as chaves e mensagens de um item.

getAllAsync(options: Office.AsyncContextOptions, callback?: (asyncResult: Office.AsyncResult<NotificationMessageDetails[]>) => 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.NotificationMessageDetails[]>) => void

Opcional. Quando o método for concluído, a função transmitida no callback parâmetro é chamada com um único parâmetro do tipo Office.AsyncResult. A value propriedade do resultado é uma matriz de NotificationMessageDetails objetos.

Retornos

void

Comentários

[ Conjunto de API: Caixa de Correio 1.3 ]

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

Modo Outlook aplicável: Compose ou Leitura

Exemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/35-notifications/add-getall-remove.yaml

// Gets all the notification messages and their keys for the current mail item.
Office.context.mailbox.item.notificationMessages.getAllAsync((asyncResult) => {
  if (asyncResult.status === Office.AsyncResultStatus.Failed) {
    console.log(asyncResult.error.message);
    return;
  }
  console.log(JSON.stringify(asyncResult.value));
});

getAllAsync(callback)

Retorna todas as chaves e mensagens de um item.

getAllAsync(callback?: (asyncResult: Office.AsyncResult<NotificationMessageDetails[]>) => void): void;

Parâmetros

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

Retornos

void

Comentários

[ Conjunto de API: Caixa de Correio 1.3 ]

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

Modo Outlook aplicável: Compose ou Leitura

removeAsync(key, options, callback)

Obtém uma mensagem de notificação de um item.

removeAsync(key: string, options: Office.AsyncContextOptions, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;

Parâmetros

key: string

A chave para a mensagem de notificação a remover.

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<void>) => void

Opcional. Quando o método for concluído, a função transmitida no callback parâmetro é chamada com um único parâmetro do tipo Office.AsyncResult.

Retornos

void

Comentários

[ Conjunto de API: Caixa de Correio 1.3 ]

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

Modo Outlook aplicável: Compose ou Leitura

Importante: o removeAsync método não é suportado numa mensagem atualmente carregada com o loadItemByIdAsync método . Para obter mais informações, consulte Ativar o seu suplemento do Outlook em várias mensagens.

Exemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/35-notifications/add-getall-remove.yaml

// Removes a notification message from the current mail item.
const id = (document.getElementById("notificationId") as HTMLInputElement).value;
Office.context.mailbox.item.notificationMessages.removeAsync(id, (result) => {
  if (result.status === Office.AsyncResultStatus.Failed) {
    console.log(`Failed to remove notification with id = ${id}. ${result.error.message}.`);
    return;
  }
  console.log(`Removed notification with id = ${id}.`);
});

removeAsync(key, callback)

Obtém uma mensagem de notificação de um item.

removeAsync(key: string, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;

Parâmetros

key: string

A chave para a mensagem de notificação a remover.

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

Opcional. Quando o método for concluído, a função transmitida no callback parâmetro é chamada com um único parâmetro do tipo Office.AsyncResult.

Retornos

void

Comentários

[ Conjunto de API: Caixa de Correio 1.3 ]

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

Modo Outlook aplicável: Compose ou Leitura

replaceAsync(key, JSONmessage, options, callback)

Substitui uma mensagem de notificação que tenha uma determinada chave com outra mensagem.

Se uma mensagem de notificação com a chave especificada não existir, replaceAsync adicionará a notificação.

replaceAsync(key: string, JSONmessage: NotificationMessageDetails, options: Office.AsyncContextOptions, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;

Parâmetros

key: string

A chave para a mensagem de notificação a substituir. Ela não pode ter mais de 32 caracteres.

JSONmessage: Office.NotificationMessageDetails

Um objeto JSON que contém a nova mensagem de notificação para substituir a mensagem existente. Contém um NotificationMessageDetails objeto.

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<void>) => void

Opcional. Quando o método for concluído, a função transmitida no callback parâmetro é chamada com um único parâmetro do tipo Office.AsyncResult.

Retornos

void

Comentários

[ Conjunto de API: Caixa de Correio 1.3 ]

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

Modo Outlook aplicável: Compose ou Leitura

Importante: o replaceAsync método não é suportado numa mensagem atualmente carregada com o loadItemByIdAsync método . Para obter mais informações, consulte Ativar o seu suplemento do Outlook em várias mensagens.

Exemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/35-notifications/add-getall-remove.yaml

// Replaces a notification message of a given key with another message.
const id = (document.getElementById("notificationId") as HTMLInputElement).value;
Office.context.mailbox.item.notificationMessages.replaceAsync(
  id,
  {
    type: Office.MailboxEnums.ItemNotificationMessageType.InformationalMessage,
    message: "Notification message with id = " + id + " has been replaced with an informational message.",
    icon: "icon2",
    persistent: false
  },
  (result) => {
    if (result.status === Office.AsyncResultStatus.Failed) {
      console.log(`Failed to replace notification with id = ${id}. ${result.error.message}.`);
      return;
    }
    console.log(`Replaced notification with id = ${id}.`);
  });

replaceAsync(key, JSONmessage, callback)

Substitui uma mensagem de notificação que tenha uma determinada chave com outra mensagem.

Se uma mensagem de notificação com a chave especificada não existir, replaceAsync adicionará a notificação.

replaceAsync(key: string, JSONmessage: NotificationMessageDetails, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;

Parâmetros

key: string

A chave para a mensagem de notificação a substituir. Ela não pode ter mais de 32 caracteres.

JSONmessage: Office.NotificationMessageDetails

Um objeto JSON que contém a nova mensagem de notificação para substituir a mensagem existente. Contém um NotificationMessageDetails objeto.

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

Opcional. Quando o método for concluído, a função transmitida no callback parâmetro é chamada com um único parâmetro do tipo Office.AsyncResult.

Retornos

void

Comentários

[ Conjunto de API: Caixa de Correio 1.3 ]

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

Modo Outlook aplicável: Compose ou Leitura

Comentários

Esta página foi útil?

Compartilhar via

Office.NotificationMessages interface

Comentários

Métodos

Detalhes do método

addAsync(key, JSONmessage, options, callback)

Parâmetros

Retornos

Comentários

Exemplos

addAsync(key, JSONmessage, callback)

Parâmetros

Retornos

Comentários

getAllAsync(options, callback)

Parâmetros

Retornos

Comentários

Exemplos

getAllAsync(callback)

Parâmetros

Retornos

Comentários

removeAsync(key, options, callback)

Parâmetros

Retornos

Comentários

Exemplos

removeAsync(key, callback)

Parâmetros

Retornos

Comentários

replaceAsync(key, JSONmessage, options, callback)

Parâmetros

Retornos

Comentários

Exemplos

replaceAsync(key, JSONmessage, callback)

Parâmetros

Retornos

Comentários

Comentários