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

Статья
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
дисплей	чтение и запись элемента	Чтение сообщения	Display	Предварительный просмотр
end	чтение элемента	Организатор встреч	Time	1.1
		Участник встречи	Date	1.1
		Чтение сообщения (Приглашение на собрание)	Date	1.1
enhancedLocation	чтение элемента	Организатор встреч	EnhancedLocation	1.8
		Участник встречи	EnhancedLocation	1.8
from	чтение и запись элемента	Создание сообщения	From	1.7
	чтение элемента	Чтение сообщения	EmailAddressDetails	1.1
inReplyTo	чтение элемента	Создание сообщения	String	1.14
internetHeaders	чтение элемента	Создание сообщения	InternetHeaders	1.8
internetMessageId	чтение элемента	Чтение сообщения	String	1.1
isAllDayEvent	чтение элемента	Организатор встреч	IsAllDayEvent	Предварительный просмотр
		Участник встречи	Логический	Предварительный просмотр
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
sensitivity	чтение элемента	Организатор встреч	Sensitivity	1.14
		Участник встречи	MailboxEnums.AppointmentSensitivityType	1.14
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
closeAsync([options], [callback])	чтение и запись элемента	Создание сообщения	1.14
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
getAsFileAsync([options], обратный вызов)	чтение элемента	Чтение сообщения	1.14
getAttachmentContentAsync(attachmentId, [options], [callback])	чтение элемента	Организатор встреч	1.8
		Участник встречи	1.8
		Создание сообщения	1.8
		Чтение сообщения	1.8
getAttachmentsAsync([options], [callback])	чтение элемента	Организатор встреч	1.8
		Создание сообщения	1.8
getComposeTypeAsync([options], обратный вызов)	чтение элемента	Создание сообщения	1.10
getConversationIndexAsync([options], обратный вызов)	чтение элемента	Создание сообщения	1.14
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
getItemClassAsync([options], обратный вызов)	чтение элемента	Создание сообщения	1.14
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
`SpamReporting`	В Outlook поступило незапрошенное сообщение. Доступно только с помощью команды функции.	1.14

Пример

В примере кода JavaScript, приведенном ниже, показано, как получить доступ к свойству subject текущего элемента в 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.
  });
};

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