Office.EmailAddressDetails interface

Paquete:

outlook

Proporciona las propiedades de correo electrónico del remitente o los destinatarios especificados de un mensaje de correo o una cita.

Comentarios

Nivel mínimo de permisos: Leer elemento

Modo de Outlook aplicable: Componer o leer

Usada por

• Office.AppointmentForm: optionalAttendees, requiredAttendees
• Office.AppointmentRead: optionalAttendees, organizer, requiredAttendees
• Office.From: getAsync
• Office.LoadedMessageRead: cc, from, sender, to
• Office.MessageForm: bccRecipients, ccRecipients, toRecipients
• Office.MessageRead: cc, from, sender, to
• Office.Organizer: getAsync
• Office.Recipients: addAsync, getAsync, setAsync

Propiedades

appointmentResponse	Obtiene la respuesta que ha devuelto un asistente de una cita. Esta propiedad se aplica solo a un asistente de una cita, como se ha representado en la propiedad optionalAttendees o requiredAttendees. Esta propiedad devuelve un valor indefinido en otros escenarios.
displayName	Obtiene el nombre para mostrar asociado a una dirección de correo electrónico.
emailAddress	Obtiene la dirección de correo electrónico SMTP.
recipientType	Obtiene el tipo de dirección de correo electrónico de un destinatario.

Detalles de las propiedades

appointmentResponse

Obtiene la respuesta que ha devuelto un asistente de una cita. Esta propiedad se aplica solo a un asistente de una cita, como se ha representado en la propiedad optionalAttendees o requiredAttendees. Esta propiedad devuelve un valor indefinido en otros escenarios.

appointmentResponse: MailboxEnums.ResponseType | string;

Valor de propiedad

Office.MailboxEnums.ResponseType | string

Ejemplos

// 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

Obtiene el nombre para mostrar asociado a una dirección de correo electrónico.

displayName: string;

Valor de propiedad

string

Ejemplos

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

emailAddress

Obtiene la dirección de correo electrónico SMTP.

emailAddress: string;

Valor de propiedad

string

Ejemplos

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

recipientType

Obtiene el tipo de dirección de correo electrónico de un destinatario.

recipientType: MailboxEnums.RecipientType | string;

Valor de propiedad

Office.MailboxEnums.RecipientType | string

Comentarios

Importante:

• Los métodos Office.context.mailbox.item.from.getAsync y Office.context.mailbox.item.organizer.getAsync no devuelven un recipientType valor de propiedad. El remitente del correo electrónico o el organizador de la cita es siempre un usuario cuya dirección de correo electrónico se encuentra en el servidor de Exchange.

• Al redactar un elemento de correo, al cambiar a una cuenta de remitente que está en un dominio diferente al de la cuenta del remitente seleccionada anteriormente, el valor de la recipientType propiedad para los destinatarios existentes no se actualiza y seguirá basándose en el dominio de la cuenta seleccionada previamente. Para obtener los tipos de destinatarios correctos después de cambiar de cuenta, primero debe quitar los destinatarios existentes y luego agregarlos de nuevo al elemento correo.

Ejemplos

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);
});