item (conjunto de requisitos de buzón 1.8)

  • Artículo

Office.context.mailbox.item

item se usa para acceder al mensaje, la convocatoria de reunión o la cita seleccionados actualmente. Puede determinar el tipo del elemento mediante la itemType propiedad .

Requisitos
Requirement Valor
Versión del conjunto de requisitos mínimos del buzón 1.1
Nivel de permisos mínimo Restringido
Modo de Outlook válido Organizador de citas, Asistente de cita,
Redacción de mensajes o Lectura de mensajes

Importante

Android e iOS: hay limitaciones sobre cuándo se activan los complementos y qué API están disponibles. Para obtener más información, consulte Agregar compatibilidad móvil a un complemento de Outlook.

Propiedades

Propiedad Mínimo
nivel de permisos		 Detalles por modo Tipo devuelto Mínimo
conjunto de requisitos
datos adjuntos leer elemento Asistente de cita Matriz.<AttachmentDetails> 1.1
Leer mensaje Matriz.<AttachmentDetails> 1.1
cco leer elemento Redactar mensaje Destinatarios 1.1
body leer elemento Organizador de citas Cuerpo 1.1
Asistente de cita Cuerpo 1.1
Redactar mensaje Cuerpo 1.1
Leer mensaje Cuerpo 1.1
categories leer elemento Organizador de citas Categories 1.8
Asistente de cita Categories 1.8
Redactar mensaje Categories 1.8
Leer mensaje Categories 1.8
cc leer elemento Redactar mensaje Destinatarios 1.1
Leer mensaje Matriz.<EmailAddressDetails> 1.1
conversationId leer elemento Redactar mensaje Cadena 1.1
Leer mensaje Cadena 1.1
dateTimeCreated leer elemento Asistente de cita Fecha 1.1
Leer mensaje Fecha 1.1
dateTimeModified leer elemento Asistente de cita Fecha 1.1
Leer mensaje Fecha 1.1
end leer elemento Organizador de citas Time 1.1
Asistente de cita Fecha 1.1
Leer mensaje
(Convocatoria de reunión)		 Fecha 1.1
enhancedLocation leer elemento Organizador de citas EnhancedLocation 1.8
Asistente de cita EnhancedLocation 1.8
from elemento de lectura y escritura Redactar mensaje From 1.7
leer elemento Leer mensaje EmailAddressDetails 1.1
internetHeaders leer elemento Redactar mensaje InternetHeaders 1.8
internetMessageId leer elemento Leer mensaje Cadena 1.1
itemClass leer elemento Asistente de cita Cadena 1.1
Leer mensaje Cadena 1.1
Itemid leer elemento Asistente de cita Cadena 1.1
Leer mensaje Cadena 1.1
itemType leer elemento Organizador de citas MailboxEnums.ItemType 1.1
Asistente de cita MailboxEnums.ItemType 1.1
Redactar mensaje MailboxEnums.ItemType 1.1
Leer mensaje MailboxEnums.ItemType 1.1
ubicación leer elemento Organizador de citas Ubicación 1.1
Asistente de cita Cadena 1.1
Leer mensaje
(Convocatoria de reunión)		 Cadena 1.1
normalizedSubject leer elemento Asistente de cita Cadena 1.1
Leer mensaje Cadena 1.1
notificationMessages leer elemento Organizador de citas NotificationMessages 1.3
Asistente de cita NotificationMessages 1.3
Redactar mensaje NotificationMessages 1.3
Leer mensaje NotificationMessages 1.3
optionalAttendees leer elemento Organizador de citas Destinatarios 1.1
Asistente de cita Matriz.<EmailAddressDetails> 1.1
organizer elemento de lectura y escritura Organizador de citas Organizador 1.7
leer elemento Asistente de cita EmailAddressDetails 1.1
recurrence leer elemento Organizador de citas Periodicidad 1.7
Asistente de cita Periodicidad 1.7
Leer mensaje
(Convocatoria de reunión)		 Periodicidad 1.7
requiredAttendees leer elemento Organizador de citas Destinatarios 1.1
Asistente de cita Matriz.<EmailAddressDetails> 1.1
sender leer elemento Leer mensaje EmailAddressDetails 1.1
seriesId leer elemento Organizador de citas Cadena 1.7
Asistente de cita Cadena 1.7
Redactar mensaje Cadena 1.7
Leer mensaje Cadena 1.7
start leer elemento Organizador de citas Time 1.1
Asistente de cita Fecha 1.1
Leer mensaje
(Convocatoria de reunión)		 Fecha 1.1
subject leer elemento Organizador de citas Asunto 1.1
Asistente de cita Cadena 1.1
Redactar mensaje Asunto 1.1
Leer mensaje Cadena 1.1
a leer elemento Redactar mensaje Destinatarios 1.1
Leer mensaje Matriz.<EmailAddressDetails> 1.1

Métodos

Método Mínimo
nivel de permisos		 Detalles por modo Mínimo
conjunto de requisitos
addFileAttachmentAsync(uri, attachmentName, [options], [callback]) elemento de lectura y escritura Organizador de citas 1.1
Redactar mensaje 1.1
addFileAttachmentFromBase64Async(base64File, attachmentName, [options], [callback]) elemento de lectura y escritura Organizador de citas 1.8
Redactar mensaje 1.8
addHandlerAsync(eventType, handler, [options], [callback]) leer elemento Organizador de citas 1.7
Asistente de cita 1.7
Redactar mensaje 1.7
Leer mensaje 1.7
addItemAttachmentAsync(itemId, attachmentName, [options], [callback]) elemento de lectura y escritura Organizador de citas 1.1
Redactar mensaje 1.1
close() Restringido Organizador de citas 1.3
Redactar mensaje 1.3
displayReplyAllForm(formData) leer elemento Asistente de cita 1.1
Leer mensaje 1.1
displayReplyForm(formData) leer elemento Asistente de cita 1.1
Leer mensaje 1.1
getAllInternetHeadersAsync([options], [callback]) leer elemento Leer mensaje 1.8
getAttachmentContentAsync(attachmentId, [options], [callback]) leer elemento Organizador de citas 1.8
Asistente de cita 1.8
Redactar mensaje 1.8
Leer mensaje 1.8
getAttachmentsAsync([options], [callback]) leer elemento Organizador de citas 1.8
Redactar mensaje 1.8
getEntities() leer elemento Asistente de cita 1.1
Leer mensaje 1.1
getEntitiesByType(entityType) Restringido Asistente de cita 1.1
Leer mensaje 1.1
getFilteredEntitiesByName(name) leer elemento Asistente de cita 1.1
Leer mensaje 1.1
getInitializationContextAsync([options], [callback]) leer elemento Organizador de citas 1.8
Asistente de cita 1.8
Redactar mensaje 1.8
Leer mensaje 1.8
getItemIdAsync([options], callback) leer elemento Organizador de citas 1.8
Redactar mensaje 1.8
getRegExMatches() leer elemento Asistente de cita 1.1
Leer mensaje 1.1
getRegExMatchesByName(name) leer elemento Asistente de cita 1.1
Leer mensaje 1.1
getSelectedDataAsync(coercionType, [options], callback) leer elemento Organizador de citas 1.2
Redactar mensaje 1.2
getSelectedEntities() leer elemento Asistente de cita 1.6
Leer mensaje 1.6
getSelectedRegExMatches() leer elemento Asistente de cita 1.6
Leer mensaje 1.6
getSharedPropertiesAsync([options], callback) leer elemento Organizador de citas 1.8
Asistente de cita 1.8
Redactar mensaje 1.8
Leer mensaje 1.8
loadCustomPropertiesAsync(callback, [userContext]) leer elemento Organizador de citas 1.1
Asistente de cita 1.1
Redactar mensaje 1.1
Leer mensaje 1.1
removeAttachmentAsync(attachmentId, [options], [callback]) elemento de lectura y escritura Organizador de citas 1.1
Redactar mensaje 1.1
removeHandlerAsync(eventType, [options], [callback]) leer elemento Organizador de citas 1.7
Asistente de cita 1.7
Redactar mensaje 1.7
Leer mensaje 1.7
saveAsync([options], callback) elemento de lectura y escritura Organizador de citas 1.3
Redactar mensaje 1.3
setSelectedDataAsync(data, [options], callback) elemento de lectura y escritura Organizador de citas 1.2
Redactar mensaje 1.2

Eventos

Puede suscribirse y cancelar la suscripción a los siguientes eventos mediante addHandlerAsync y removeHandlerAsync respectivamente.

Importante

Los eventos solo están disponibles con la implementación del panel de tareas.

Evento Descripción Mínimo
conjunto de requisitos
AppointmentTimeChanged La fecha o hora de la cita o serie seleccionada ha cambiado. 1.7
AttachmentsChanged Se ha agregado o quitado datos adjuntos del elemento. 1.8
EnhancedLocationsChanged La ubicación de la cita seleccionada ha cambiado. 1.8
RecipientsChanged La lista de destinatarios del elemento seleccionado o la ubicación de la cita ha cambiado. 1.7
RecurrenceChanged El patrón de periodicidad de la serie seleccionada ha cambiado. 1.7

Ejemplo

En el siguiente ejemplo de código de JavaScript, se muestra cómo tener acceso a la propiedad subject del elemento actual en Outlook.

// The initialize function is required for all apps.
Office.initialize = function () {
  // Checks for the DOM to load using the jQuery ready method.
  $(document).ready(function () {
    // After the DOM is loaded, app-specific code can run.
    const item = Office.context.mailbox.item;
    const subject = item.subject;
    // Continue with processing the subject of the current item,
    // which can be a message or appointment.
  });
};