Элемент AppDomain
Указывает дополнительный домен, которому Office должен доверять, в дополнение к домену, указанному в элементе SourceLocation. Указание домена имеет следующие последствия:
- Он позволяет открывать страницы, маршруты или другие ресурсы в домене непосредственно в корневой области задач надстройки на классических платформах Office. (Указание домена в <AppDomain> не требуется для Office в Интернете или для открытия ресурса в IFrame, а также не требуется для открытия ресурса в диалоговом окне, открытом с помощью API диалогового окна.)
- Он позволяет страницам в домене выполнять Office.js вызовы API из IFrames в надстройке.
Тип надстройки: контентные и почтовые надстройки, надстройки области задач
Синтаксис
<AppDomain>string</AppDomain>
Важно!
- Значение <элемента AppDomain> должно включать протокол (например,
<AppDomain>https://myappdomain.com</AppDomain>
), а протокол должен иметь значениеhttp
илиhttps
. - Если для домена есть явный порт, добавьте его (например,
<AppDomain>https://myappdomain.com:9999</AppDomain>
). - Если поддомен должен быть доверенным, включите его (например,
<AppDomain>https://mysubdomain.myappdomain.com</AppDomain>
). Поддоменmysubdomain.mydomain.com
иmydomain.com
являются разными доменами. Если оба должны быть доверенными, то оба должны находиться в отдельных <элементах AppDomain> . - Перечисление того же домена, что и тот, который указан в элементе SourceLocation , не оказывает влияния и может вводить в заблуждение. В частности, при разработке в
localhost
не требуется создавать <элемент AppDomain> дляlocalhost
. - Не включайте сегменты URL-адреса за доменом. Например, не включайте полный URL-адрес страницы.
- Не помещайте в значение закрывающая косая черта "/".
- Подстановочные знаки, такие как
*
, не допускаются в <значениях AppDomain> . Однако для надстроек, работающих только в Office в Windows, существует способ назначить дополнительные доверенные домены подстановочными знаками. См. раздел Доверенные домены с подстановочными знаками.
Содержится в
Замечания
Дополнительные сведения см. в статье Надстройки Office с манифестом только надстройки.
Совместная работа с нами на GitHub
Источник этого содержимого можно найти на GitHub, где также можно создавать и просматривать проблемы и запросы на вытягивание. Дополнительные сведения см. в нашем руководстве для участников.
Office Add-ins