item (набор обязательных для почтового ящика 1.13)

Статья
11/19/2024

Office .context .mailbox.item

item используется для доступа к выбранному сообщению, приглашения на собрание или встречи. Тип элемента можно определить с помощью itemType свойства .

Требования

Требование	Значение
Версия минимального набора требований к почтовому ящику	1.1
Минимальный уровень разрешений	ограниченный
Применимый режим Outlook	Организатор встречи, участник встречи, Compose сообщения или Чтение сообщений

Важно!

Android и iOS. Существуют ограничения на то, когда надстройки активируются и какие API доступны. Дополнительные сведения см. в статье Добавление поддержки мобильных устройств в надстройку Outlook.

Свойства

Свойство	Minimum уровень разрешения	Сведения по режиму	Тип возвращаемых данных	Minimum набор обязательных требований
вложения	чтение элемента	Участник встречи	Массив.<AttachmentDetails>	1.1
		Чтение сообщения	Массив.<AttachmentDetails>	1.1
СК.	чтение элемента	Создание сообщения	Получатели	1.1
body	чтение элемента	Организатор встреч	Основной текст	1.1
		Участник встречи	Основной текст	1.1
		Создание сообщения	Основной текст	1.1
		Чтение сообщения	Основной текст	1.1
categories	чтение элемента	Организатор встреч	Categories	1.8
		Участник встречи	Categories	1.8
		Создание сообщения	Categories	1.8
		Чтение сообщения	Categories	1.8
копия;	чтение элемента	Создание сообщения	Получатели	1.1
		Чтение сообщения	Массив.<EmailAddressDetails>	1.1
conversationId	чтение элемента	Создание сообщения	String	1.1
		Чтение сообщения	String	1.1
dateTimeCreated	чтение элемента	Участник встречи	Date	1.1
		Чтение сообщения	Date	1.1
dateTimeModified	чтение элемента	Участник встречи	Date	1.1
		Чтение сообщения	Date	1.1
delayDeliveryTime	чтение элемента	Создание сообщения	DelayDeliveryTime	1.13
end	чтение элемента	Организатор встреч	Time	1.1
		Участник встречи	Date	1.1
		Чтение сообщения (Приглашение на собрание)	Date	1.1
enhancedLocation	чтение элемента	Организатор встреч	EnhancedLocation	1.8
		Участник встречи	EnhancedLocation	1.8
from	чтение и запись элемента	Создание сообщения	From	1.7
	чтение элемента	Чтение сообщения	EmailAddressDetails	1.1
internetHeaders	чтение элемента	Создание сообщения	InternetHeaders	1.8
internetMessageId	чтение элемента	Чтение сообщения	String	1.1
itemClass	чтение элемента	Участник встречи	String	1.1
		Чтение сообщения	String	1.1
itemId	чтение элемента	Участник встречи	String	1.1
		Чтение сообщения	String	1.1
itemType	чтение элемента	Организатор встреч	MailboxEnums.ItemType	1.1
		Участник встречи	MailboxEnums.ItemType	1.1
		Создание сообщения	MailboxEnums.ItemType	1.1
		Чтение сообщения	MailboxEnums.ItemType	1.1
расположение	чтение элемента	Организатор встреч	Location	1.1
		Участник встречи	String	1.1
		Чтение сообщения (Приглашение на собрание)	String	1.1
normalizedSubject	чтение элемента	Участник встречи	String	1.1
		Чтение сообщения	String	1.1
notificationMessages	чтение элемента	Организатор встреч	NotificationMessages	1.3
		Участник встречи	NotificationMessages	1.3
		Создание сообщения	NotificationMessages	1.3
		Чтение сообщения	NotificationMessages	1.3
optionalAttendees	чтение элемента	Организатор встреч	Получатели	1.1
		Участник встречи	Массив.<EmailAddressDetails>	1.1
organizer	чтение и запись элемента	Организатор встреч	Organizer	1.7
	чтение элемента	Участник встречи	EmailAddressDetails	1.1
recurrence	чтение элемента	Организатор встреч	Recurrence	1.7
		Участник встречи	Recurrence	1.7
		Чтение сообщения (Приглашение на собрание)	Recurrence	1.7
requiredAttendees	чтение элемента	Организатор встреч	Получатели	1.1
		Участник встречи	Массив.<EmailAddressDetails>	1.1
sender	чтение элемента	Чтение сообщения	EmailAddressDetails	1.1
sensitivityLabel	чтение и запись элемента	Организатор встреч	SensitivityLabel	1.13
		Создание сообщения	SensitivityLabel	1.13
seriesId	чтение элемента	Организатор встреч	String	1.7
		Участник встречи	String	1.7
		Создание сообщения	String	1.7
		Чтение сообщения	String	1.7
sessionData	чтение элемента	Организатор встреч	SessionData	1.11
		Создание сообщения	SessionData	1.11
start	чтение элемента	Организатор встреч	Time	1.1
		Участник встречи	Date	1.1
		Чтение сообщения (Приглашение на собрание)	Date	1.1
subject	чтение элемента	Организатор встреч	Тема	1.1
		Участник встречи	String	1.1
		Создание сообщения	Тема	1.1
		Чтение сообщения	String	1.1
на	чтение элемента	Создание сообщения	Получатели	1.1
		Чтение сообщения	Массив.<EmailAddressDetails>	1.1

Методы

Метод	Minimum уровень разрешения	Сведения по режиму	Minimum набор обязательных требований
addFileAttachmentAsync(uri, attachmentName, [options], [callback])	чтение и запись элемента	Организатор встреч	1.1 (классическая версия Windows, Mac) 1.8 (Интернет, новая Windows)
		Создание сообщения	1.1 (классическая версия Windows, Mac) 1.8 (Интернет, новая Windows)
addFileAttachmentFromBase64Async(base64File, attachmentName, [options], [callback])	чтение и запись элемента	Организатор встреч	1.8
		Создание сообщения	1.8
addHandlerAsync(eventType, handler, [options], [callback])	чтение элемента	Организатор встреч	1.7
		Участник встречи	1.7
		Создание сообщения	1.7
		Чтение сообщения	1.7
addItemAttachmentAsync(itemId, attachmentName, [options], [callback])	чтение и запись элемента	Организатор встреч	1.1
		Создание сообщения	1.1
close()	ограниченный	Организатор встреч	1.3
		Создание сообщения	1.3
disableClientSignatureAsync([options], [callback])	чтение и запись элемента	Организатор встреч	1.10
		Создание сообщения	1.10
displayReplyAllForm(formData)	чтение элемента	Участник встречи	1.1
		Чтение сообщения	1.1
displayReplyAllFormAsync(formData, [options], [callback])	чтение элемента	Участник встречи	1.9
		Чтение сообщения	1.9
displayReplyForm(formData)	чтение элемента	Участник встречи	1.1
		Чтение сообщения	1.1
displayReplyFormAsync(formData, [options], [callback])	чтение элемента	Участник встречи	1.9
		Чтение сообщения	1.9
getAllInternetHeadersAsync([options], [callback])	чтение элемента	Чтение сообщения	1.8
getAttachmentContentAsync(attachmentId, [options], [callback])	чтение элемента	Организатор встреч	1.8
		Участник встречи	1.8
		Создание сообщения	1.8
		Чтение сообщения	1.8
getAttachmentsAsync([options], [callback])	чтение элемента	Организатор встреч	1.8
		Создание сообщения	1.8
getComposeTypeAsync([options], обратный вызов)	чтение элемента	Создание сообщения	1.10
getEntities() (не рекомендуется)	чтение элемента	Участник встречи	1.1
		Чтение сообщения	1.1
getEntitiesByType(entityType) (не рекомендуется)	ограниченный	Участник встречи	1.1
		Чтение сообщения	1.1
getFilteredEntitiesByName(name) (не рекомендуется)	чтение элемента	Участник встречи	1.1
		Чтение сообщения	1.1
getInitializationContextAsync([options], [callback])	чтение элемента	Организатор встреч	1.8
		Участник встречи	1.8
		Создание сообщения	1.8
		Чтение сообщения	1.8
getItemIdAsync([options], обратный вызов)	чтение элемента	Организатор встреч	1.8
		Создание сообщения	1.8
getRegExMatches()	чтение элемента	Участник встречи	1.1
		Чтение сообщения	1.1
getRegExMatchesByName(name)	чтение элемента	Участник встречи	1.1
		Чтение сообщения	1.1
getSelectedDataAsync(coercionType, [options], обратный вызов)	чтение элемента	Организатор встреч	1.2
		Создание сообщения	1.2
getSelectedEntities() (не рекомендуется)	чтение элемента	Участник встречи	1.6
		Чтение сообщения	1.6
getSelectedRegExMatches()	чтение элемента	Участник встречи	1.6
		Чтение сообщения	1.6
getSharedPropertiesAsync([options], обратный вызов)	чтение элемента	Организатор встреч	1.8 (поддержка общих папок) 1.13 (поддержка общих почтовых ящиков)
		Участник встречи	1.8 (поддержка общих папок) 1.13 (поддержка общих почтовых ящиков)
		Создание сообщения	1.8 (поддержка общих папок) 1.13 (поддержка общих почтовых ящиков)
		Чтение сообщения	1.8 (поддержка общих папок) 1.13 (поддержка общих почтовых ящиков)
isClientSignatureEnabledAsync([options], обратный вызов)	чтение элемента	Организатор встреч	1.10
		Создание сообщения	1.10
loadCustomPropertiesAsync(callback, [userContext])	чтение элемента	Организатор встреч	1.1
		Участник встречи	1.1
		Создание сообщения	1.1
		Чтение сообщения	1.1
removeAttachmentAsync(attachmentId, [options], [callback])	чтение и запись элемента	Организатор встреч	1.1
		Создание сообщения	1.1
removeHandlerAsync(eventType, [options], [callback])	чтение элемента	Организатор встреч	1.7
		Участник встречи	1.7
		Создание сообщения	1.7
		Чтение сообщения	1.7
saveAsync([options], callback)	чтение и запись элемента	Организатор встреч	1.3
		Создание сообщения	1.3
setSelectedDataAsync(data, [options], callback)	чтение и запись элемента	Организатор встреч	1.2
		Создание сообщения	1.2

События

Вы можете подписаться на следующие события и отменить подписку с помощью addHandlerAsync и removeHandlerAsync соответственно.

Важно!

События доступны только в реализации области задач.

Событие	Описание	Minimum набор обязательных требований
`AppointmentTimeChanged`	Дата или время выбранной встречи или ряда изменились.	1.7
`AttachmentsChanged`	Вложение добавлено в элемент или удалено из него.	1.8
`EnhancedLocationsChanged`	Расположение выбранной встречи изменилось.	1.8
`InfobarClicked`	Действие выбрано в уведомлении.	1.10
`RecipientsChanged`	Список получателей выбранного элемента или расположения встречи изменился.	1.7
`RecurrenceChanged`	Шаблон повторения выбранного ряда изменился.	1.7
`SensitivityLabelChanged`	Метка конфиденциальности сообщения или встречи в режиме создания изменилась.	1.13

Пример

В примере кода JavaScript, приведенном ниже, показано, как получить доступ к свойству subject текущего элемента в Outlook.

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

Поделиться через