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

Office.context.mailbox.item

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

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

Важно!

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
Создание сообщения 1.1
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.8
Создание сообщения 1.8
Чтение сообщения 1.8
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.
  });
};