Office.EmailAddressDetails interface

Fornece as propriedades de email do remetente ou dos destinatários especificados de um compromisso ou uma mensagem de email.

Comentários

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

Modo Outlook aplicável: Compose ou Leitura

Propriedades

appointmentResponse

Obtém a resposta que um participante retornou para um compromisso. Esta propriedade aplica-se apenas a um participante de um compromisso, conforme representado pelas propriedades optionalAttendees ou requiredAttendees. Esta propriedade devolve indefinida noutros cenários.

displayName

Obtém o nome de exibição associado a um endereço de email.

emailAddress

Obtém o endereço de email SMTP.

recipientType

Obtém o tipo do endereço de email de um destinatário.

Detalhes da propriedade

appointmentResponse

Obtém a resposta que um participante retornou para um compromisso. Esta propriedade aplica-se apenas a um participante de um compromisso, conforme representado pelas propriedades optionalAttendees ou requiredAttendees. Esta propriedade devolve indefinida noutros cenários.

appointmentResponse: MailboxEnums.ResponseType | string;

Valor da propriedade

Exemplos

// The following sample provides the responses from required attendees.
// Note that this sample needs the add-in to be in Appointment Read (Attendee) mode.
const requiredAttendees = Office.context.mailbox.item.requiredAttendees;
console.log("There are " + requiredAttendees.length + " required attendees.")
requiredAttendees.forEach(function (requiredAttendee) {
    console.log("Attendee " + requiredAttendee.displayName + ": " + requiredAttendee.appointmentResponse);
});

displayName

Obtém o nome de exibição associado a um endereço de email.

displayName: string;

Valor da propriedade

string

Exemplos

const organizerName = Office.context.mailbox.item.organizer.displayName;
console.log("Organizer: " + organizerName);

emailAddress

Obtém o endereço de email SMTP.

emailAddress: string;

Valor da propriedade

string

Exemplos

const organizerAddress = Office.context.mailbox.item.organizer.emailAddress;
console.log("Organizer's email address: " + organizerAddress);

recipientType

Obtém o tipo do endereço de email de um destinatário.

recipientType: MailboxEnums.RecipientType | string;

Valor da propriedade

Comentários

Importante:

  • Um recipientType valor de propriedade não é devolvido pelos métodos Office.context.mailbox.item.from.getAsync e Office.context.mailbox.item.organizer.getAsync . O remetente de e-mail ou organizador de compromissos é sempre um utilizador cujo endereço de e-mail está no servidor Exchange.

  • Ao compor um item de correio, quando muda para uma conta de remetente que está num domínio diferente do da conta de remetente selecionada anteriormente, o valor da recipientType propriedade para destinatários existentes não é atualizado e continuará a ser baseado no domínio da conta selecionada anteriormente. Para obter os tipos de destinatários corretos depois de mudar de conta, primeiro tem de remover os destinatários existentes e, em seguida, adicioná-los novamente ao item de correio.

Exemplos

const requiredAttendees = Office.context.mailbox.item.requiredAttendees;
console.log("There are " + requiredAttendees.length + " required attendees.")
requiredAttendees.forEach(function (requiredAttendee) {
    console.log("Attendee " + requiredAttendee.displayName + ": " + requiredAttendee.recipientType);
});