item (conjunto de requisitos de buzón 1.6)

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
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
from	leer elemento	Leer mensaje	EmailAddressDetails	1.1
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	leer elemento	Asistente de cita	EmailAddressDetails	1.1
requiredAttendees	leer elemento	Organizador de citas	Destinatarios	1.1
		Asistente de cita	Matriz.<EmailAddressDetails>	1.1
sender	leer elemento	Leer mensaje	EmailAddressDetails	1.1
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
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
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
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
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
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

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