Примечание
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
В этой статье описывается реализация общих папок (также известных как делегированный доступ) и сценариев общего почтового ящика в надстройке Outlook, включая разрешения, поддерживаемые API JavaScript для Office.
Примечание.
Поддержка общих папок появилась в наборе требований 1.8, а поддержка общих почтовых ящиков появилась в наборе требований 1.13. Сведения о поддержке клиентов для этих функций см. в разделе Поддерживаемые клиенты и платформы.
Поддерживаемые клиенты и платформы
В следующей таблице показаны поддерживаемые сочетания клиента и сервера для этой функции, включая минимальное требуемое накопительное обновление, если применимо.
Клиент | Exchange Online. | Локальная среда Exchange 2019 (Накопительный пакет обновления 1 или более поздней версии) |
Локальная среда Exchange 2016 (Накопительный пакет обновления 6 или более поздней версии) |
---|---|---|---|
Веб-браузер (современный пользовательский интерфейс Outlook) | Поддерживается | Неприменимо | Неприменимо |
Веб-браузер (классический пользовательский интерфейс Outlook) | Неприменимо |
|
|
новый Outlook в Windows | Поддерживается | Неприменимо | Неприменимо |
Windows (классическая версия) Общие папки: версия 1910 (сборка 12130.20272) или более поздняя Общие почтовые ящики: версия 2304 (сборка 16327.20248) или более поздняя |
Поддерживается | Поддержанный* | Поддержанный* |
Mac Версия 16.47 или более поздняя |
Поддерживается | Поддерживается | Поддерживается |
Android | Неприменимо | Неприменимо | Неприменимо |
iOS | Неприменимо | Неприменимо | Неприменимо |
Примечание.
* Поддержка этой функции в локальной среде Exchange доступна, начиная с классической версии Outlook для Windows версии 2206 (сборка 15330.20000) для текущего канала и версии 2207 (сборка 15427.20000) для канала Monthly Enterprise.
Поддерживаемые настройки
В следующих разделах описаны конфигурации общих почтовых ящиков и общих папок, которые поддерживают использование надстроек. API-интерфейсы компонентов могут работать не так, как ожидалось в других конфигурациях. Выберите платформу, которую вы хотите узнать, как настроить.
Общие папки
Владелец почтового ящика должен сначала предоставить доступ делегату.
Чтобы предоставить доступ к управлению собраниями и ответами на собрания от имени владельца почтового ящика, см. раздел Делегирование календаря в Outlook в Интернете.
Чтобы предоставить доступ к управлению папкой "Входящие" и календарем от имени владельца почтового ящика, необходимо настроить доступ с помощью одного из следующих параметров.
Владелец почтового ящика может настроить доступ через классический Outlook в Windows. Дополнительные сведения см. в статье Разрешение другим пользователям управлять почтой и календарем.
Администратор может настроить доступ через Центр администрирования Microsoft 365. Дополнительные сведения см. в статье Предоставление разрешений на почтовый ящик другому пользователю Microsoft 365.
Администратор может настроить доступ через Центр администрирования Exchange. Дополнительные сведения см. в статье Управление разрешениями для получателей.
После предоставления доступа делегат должен выполнить инструкции, описанные в разделе Доступ к почтовому ящику другого пользователя.
В новом Outlook в Windows по умолчанию общие почтовые ящики, автоматически сопоставленные администратором, добавляются как общие папки. Это означает, что, хотя пользователь может читать и отправлять сообщения из общего почтового ящика, он не может управлять параметрами почтового ящика. Чтобы управлять параметрами, пользователь должен повысить уровень общего почтового ящика до полной учетной записи. Дополнительные сведения см. в статье Управление параметрами общего почтового ящика в новом Outlook.
Общие почтовые ящики
Общий почтовый ящик позволяет группе пользователей легко отслеживать и отправлять сообщения и приглашения на собрания с помощью общего адреса электронной почты.
В Outlook в Интернете общий почтовый ящик можно открыть на той же панели, что и основной почтовый ящик пользователя, или в отдельной вкладке или окне браузера. Инструкции см. в статье Открытие и использование общего почтового ящика в Outlook в Интернете.
В новом Outlook в Windows доступ к общему почтовому ящику осуществляется из области папок клиента. Общий почтовый ящик может быть автоматически добавлен администратором или вручную пользователем. Почтовые ящики, которые добавляются вручную, автоматически настраиваются как полные учетные записи в клиенте Outlook, чтобы пользователи могли управлять параметрами почтового ящика. И наоборот, по умолчанию общие почтовые ящики, добавленные администратором, настраиваются как общие папки. Если пользователь хочет управлять параметрами почтового ящика, он должен повысить уровень общей папки до полной учетной записи клиента. Дополнительные сведения см. в статье Управление параметрами общего почтового ящика в новом Outlook.
Настройка манифеста
Чтобы реализовать сценарии общих папок и общих почтовых ящиков в надстройке, необходимо сначала настроить поддержку функции в манифесте. Разметка зависит от типа манифеста, используемого надстройкой.
Примечание.
Реализация сценариев общих папок и общих почтовых ящиков с унифицированным манифестом для Microsoft 365 в настоящее время поддерживается только в классической версии Outlook в Windows. Для других поддерживаемых платформ используйте манифест только надстройки.
Добавьте дополнительный объект в "authorization.permissions.resourceSpecific"
массив. Присвойте свойству "name"
значение , "Mailbox.SharedFolder"
а свойству "type"
— значение "Delegated"
.
"authorization": {
"permissions": {
"resourceSpecific": [
...
{
"name": "Mailbox.SharedFolder",
"type": "Delegated"
},
]
}
},
Определение общего доступа к папке или почтовому ящику
Перед выполнением операций в общей папке или общем почтовом ящике необходимо сначала определить, является ли текущая папка или почтовый ящик общим. Чтобы определить это, вызовите Office.context.mailbox.item.getSharedPropertiesAsync для сообщения или встречи в режиме создания или чтения. Если элемент находится в общей папке или общем почтовом ящике, метод возвращает объект SharedProperties , предоставляющий разрешения пользователя, адрес электронной почты владельца, базовый URL-адрес REST API и расположение целевого почтового ящика.
Примечание.
В Outlook в Интернете и в Windows (новая и классическая версия) в зависимости от способа доступа к общей папке или почтовому ящику getSharedPropertiesAsync
метод может требовать выполнения определенных условий в режиме Compose сообщений. Дополнительные сведения см. в разделе "Режим Compose сообщений" статьи Ограничения.
В следующем примере вызывается getSharedPropertiesAsync
метод для идентификации владельца почтового ящика и разрешений делегата или пользователя общего почтового ящика.
Office.context.mailbox.item.getSharedPropertiesAsync((result) => {
if (result.status === Office.AsyncResultStatus.Failed) {
console.error("The current folder or mailbox isn't shared.");
return;
}
const sharedProperties = result.value;
console.log(`Owner: ${sharedProperties.owner}`);
console.log(`Permissions: ${sharedProperties.delegatePermissions} `);
});
Поддерживаемые разрешения
В следующей таблице описаны разрешения, которые getSharedPropertiesAsync
поддерживаются для делегатов и пользователей общих почтовых ящиков.
Разрешение | Значение | Описание |
---|---|---|
Чтение | 1 (000001) | Может читать элементы. |
Запись | 2 (000010) | Может создавать элементы. |
DeleteOwn | 4 (000100) | Может удалять только созданные элементы. |
DeleteAll | 8 (001000) | Может удалять любые элементы. |
EditOwn | 16 (010000) | Может изменять только созданные элементы. |
Изменитьвсе | 32 (100000) | Может изменять любые элементы. |
Примечание.
В настоящее время API поддерживает получение существующих разрешений, но не настройку разрешений.
Перечисление DelegatePermissions , возвращаемое свойством delegatePermissions , реализуется с помощью битовой маски для указания разрешений. Каждая позиция в битовой маске представляет определенное разрешение, и если для нее задано значение 1
, пользователь имеет соответствующее разрешение. Например, если второй бит справа — 1
, то пользователь имеет разрешение на запись .
Выполнение операции в качестве пользователя делегата или общего почтового ящика
После того как вы определили, что текущий почтовый элемент находится в общей папке или общем почтовом ящике, надстройка может выполнить необходимые операции с элементом в общей среде. Чтобы выполнить операции с элементом в общем контексте, необходимо сначала настроить разрешение надстройки в манифесте. Затем используйте Microsoft Graph для завершения операций.
Примечание.
Веб-службы Exchange (EWS) не поддерживаются в сценариях с общими папками и общими почтовыми ящиками.
В сценариях делегирования или общего доступа делегат может получить категории из списка Outlook master, но не может добавлять или удалять категории из списка.
Настройка разрешений надстройки
Чтобы использовать службы Microsoft Graph, надстройка должна настроить разрешение на чтение и запись почтового ящика в манифесте. Разметка зависит от типа манифеста, используемого надстройкой.
-
Унифицированный манифест для Microsoft 365: задайте
"name"
для свойства объекта в массиве"authorization.permissions.resourceSpecific"
значение"Mailbox.ReadWrite.User"
. - Манифест только надстройки. Задайте для элемента Permissions значение ReadWriteMailbox.
Использование Microsoft Graph
Чтобы реализовать сценарии использования общих папок и общих почтовых ящиков, используйте Microsoft Graph для доступа к дополнительным сведениям и ресурсам почтового ящика. Например, с помощью Microsoft Graph можно получить содержимое сообщения Outlook, присоединенного к сообщению в почтовом ящике, в котором пользователь имеет делегированный доступ. Инструкции по использованию Microsoft Graph см. в статье Обзор Microsoft Graph и API почты Outlook в Microsoft Graph.
Совет
Чтобы получить доступ к API Microsoft Graph из надстройки, используйте MSAL.js проверку подлинности вложенного приложения (NAA). Дополнительные сведения см. в статье Включение единого входа в надстройке Office с помощью проверки подлинности вложенного приложения (предварительная версия).
Поддержка надстроек в сценариях с общими папками и общими почтовыми ящиками
Доступность надстроек в общей папке или общем почтовом ящике зависит от сценария и клиента Outlook.
Совет
Дополнительные сведения о том, где надстройки выполняются и не активируются в целом, см. в разделе Элементы почтовых ящиков, доступные для надстроек , на странице обзора надстроек Outlook.
Надстройки в сценариях с общими папками
В следующей таблице описывается доступность надстроек в сценариях с общими папками.
Сценарий | Доступность надстройки |
---|---|
Папка "Входящие" предоставляется делегату | Надстройки доступны делегату в режиме чтения сообщений. |
Папка Черновики предоставляется делегату | Надстройки доступны делегату в режиме создания сообщений. |
(Только новый Outlook в Windows) Общий почтовый ящик автоматически сопоставляется администратором и пользователь не повышает его до полной учетной записи. | Ознакомьтесь с поведением, описанным в столбце "Веб: та же вкладка или окно, Windows (новая версия): нерекомендационный почтовый ящик, Windows (классическая версия) и Mac" статьи Надстройки в сценариях с общим почтовым ящиком. |
Календарь предоставляется делегату явным образом (может быть не предоставлен общий доступ ко всему почтовому ящику) | Надстройки доступны делегату в режимах чтения и создания встреч. |
Календарь предоставляется группе пользователей с разными правами доступа (например, делает его редактируемым для определенного списка рассылки или всей организации). | Надстройки доступны пользователям с косвенными или неявными разрешениями в режимах чтения и создания встреч. |
Надстройки в сценариях с общим почтовым ящиком
В следующей таблице описана доступность надстроек в сценариях общих почтовых ящиков в разных клиентах Outlook. Обратите внимание, что поведение в Outlook в Интернете может отличаться в зависимости от того, открывается ли общий почтовый ящик на той же панели, что и основной почтовый ящик пользователя, или в отдельной вкладке или окне с помощью параметра Открыть другой почтовый ящик. Аналогичным образом поведение в новом Outlook для Windows также может отличаться в зависимости от того, был ли общий почтовый ящик добавлен или повышен как полная учетная запись клиента.
Сценарий | Применимые клиенты Outlook
|
Применимые клиенты Outlook
|
---|---|---|
Надстройка, установленная пользователем | Пользователи не могут устанавливать надстройки в общем почтовом ящике. Надстройки, установленные пользователем, добавляются в основной почтовый ящик пользователя. | Пользователи не могут устанавливать надстройки в общем почтовом ящике. Встроенное хранилище Microsoft 365 и Copilot не отображается на ленте почтового ящика. |
Надстройка, установленная администратором | Администраторы не должны развертывать надстройки в общем почтовом ящике. Вместо этого они должны развернуть надстройку в основном почтовом ящике пользователя. Затем пользователь может использовать надстройку в общем почтовом ящике при условии, что надстройка соответствует определенным требованиям (см. следующие сценарии доступности надстроек в режимах чтения и создания). | Это же ограничение и рекомендация применяются на других платформах (см. предыдущий столбец). |
Надстройка, используемая в режиме чтения | Манифест надстройки должен быть настроен для поддержки сценариев общих почтовых ящиков. Дополнительные сведения см. в разделе Настройка манифеста. Надстройка должна быть установлена в основном почтовом ящике пользователя пользователем или администратором. | Такая же конфигурация манифеста и поведение применяются на других платформах (см. предыдущий столбец). |
Надстройка, используемая в режиме создания | В Outlook в Интернете (почтовый ящик, открытый в том же окне) и в Windows (новые и классические), надстройки, установленные в основном почтовом ящике пользователя, поддерживают режим создания, доступны для использования. Манифест надстройки не требует дополнительной настройки для поддержки сценариев общих почтовых ящиков. Однако в Outlook на Mac манифест надстройки необходимо настроить для поддержки сценариев общих почтовых ящиков. Дополнительные сведения см. в разделе Настройка манифеста. |
Манифест надстройки должен быть настроен для поддержки сценариев общих почтовых ящиков. Дополнительные сведения см. в разделе Настройка манифеста. Надстройка должна быть установлена в основном почтовом ящике пользователя пользователем или администратором. |
Шаблоны, созданные с помощью надстройки "Мои шаблоны" | Это относится только к Outlook в Интернете и Windows (новой и классической), так как надстройка "Мои шаблоны" не поддерживается в общих почтовых ящиках в Outlook на Mac. Созданные шаблоны сохраняются в основном почтовом ящике создателя. Хотя создатель может использовать эти шаблоны как в основном, так и в общем почтовом ящике, другие пользователи, имеющие доступ к общему почтовому ящику, не могут получить доступ к этим шаблонам. Дополнительные сведения см. в разделе Создание шаблона сообщения электронной почты. |
Созданные шаблоны сохраняются в общем почтовом ящике. Любой пользователь с доступом к общему почтовому ящику может изменять или использовать эти шаблоны, если он открывает почтовый ящик с помощью команды Открыть другой почтовый ящик в Outlook в Интернете или если почтовый ящик повышен до полной учетной записи в новом Outlook в Windows. Доступ к этим общим шаблонам не может получить никто, включая создателя шаблонов, с других платформ. Сюда входят Outlook в Интернете, если общий почтовый ящик открыт на той же вкладке, что и основной почтовый ящик пользователя, и новый Outlook в Windows, если общий почтовый ящик не был повышен до полной учетной записи. И наоборот, доступ к шаблонам, созданным на других платформах, невозможно получить из общего почтового ящика, открытого с помощью параметра Открыть другой почтовый ящик или из общего почтового ящика с повышенным повышением уровня. Дополнительные сведения см. в разделе Создание шаблона сообщения электронной почты. |
Надстройки по умолчанию в Outlook | В Outlook в Интернете и в Windows (новые и классические) надстройки Outlook по умолчанию доступны для использования в общем почтовом ящике. Надстройки Outlook по умолчанию могут включать в себя "Мои шаблоны", "Отменить подписку" и Элементы действий. Обратите внимание, что некоторые надстройки по умолчанию могут не отображаться в вашей организации. В Outlook для Mac надстройки по умолчанию недоступны в общем почтовом ящике. |
Надстройки по умолчанию доступны в общем почтовом ящике. |
Ограничения
В зависимости от сценариев надстройки существует несколько ограничений, которые следует учитывать при обработке общих папок или общих почтовых ящиков.
Режим Compose сообщений
В режиме Compose сообщений getSharedPropertiesAsync не поддерживается в Outlook в Интернете или Windows (новой и классической версии), если не выполнены следующие условия.
Делегирование доступа или общие папки
- Владелец почтового ящика запускает сообщение. Это может быть новое сообщение, ответ или пересылка.
- Они сохраняют сообщение, а затем перемещают его из собственной папки Черновики в папку, к которой предоставлен общий доступ делегату.
- Делегат открывает черновик из общей папки, а затем продолжает создание.
Общий почтовый ящик открыт на той же панели, что и основной почтовый ящик пользователя (веб-, классическая версия Windows) или общий почтовый ящик, который не был повышен до полной учетной записи (новая windows)
- Пользователь общего почтового ящика запускает сообщение. Это может быть новое сообщение, ответ или пересылка.
- Они сохраняют сообщение, а затем перемещают его из собственной папки Черновики в папку в общем почтовом ящике.
- Другой пользователь общего почтового ящика открывает черновик из общего почтового ящика, а затем продолжает создавать.
Примечание.
Метод
getSharedPropertiesAsync
поддерживается на следующих платформах без дополнительных условий.- Outlook в Интернете, когда общий почтовый ящик открывается в отдельной вкладке или окне с помощью параметра Открыть другой почтовый ящик.
- новый Outlook в Windows, когда общий почтовый ящик повышен до полной учетной записи.
После выполнения этих условий сообщение становится доступным в общем контексте, и надстройки, поддерживающие эти общие сценарии, могут получить общие свойства элемента. После отправки сообщения оно обычно находится в папке Отправленные личного почтового ящика отправителя.
Пользователь или общий почтовый ящик, скрытый из списка адресов
Если администратор спрятал адрес пользователя или общий почтовый ящик из списка адресов, например глобального списка адресов (GAL), затронутые почтовые элементы открываются в отчете Office.context.mailbox.item
почтового ящика как null. Например, если пользователь открывает почтовый элемент в общем почтовом ящике, который скрыт от глобального списка адресов, Office.context.mailbox.item
то этот почтовый элемент имеет значение NULL.
Синхронизация между клиентами общих папок
Обновления делегата в почтовом ящике владельца обычно синхронизируются между почтовыми ящиками немедленно. Однако если для задания расширенного свойства элемента использовались операции Microsoft Graph, синхронизация таких изменений может занять некоторое время. Чтобы избежать задержки, рекомендуется использовать объект CustomProperties и связанные API. Дополнительные сведения см. на вкладке "Пользовательские свойства" раздела Получение и настройка метаданных в надстройке Outlook.
См. также
Office Add-ins