Элемент AppDomain

Указывает дополнительный домен, которому Office должен доверять, в дополнение к домену, указанному в элементе SourceLocation. Указание домена имеет следующие последствия:

  • Он позволяет открывать страницы, маршруты или другие ресурсы в домене непосредственно в корневой области задач надстройки на классических платформах Office. (Указание домена в домене< приложения> не требуется для Office в Интернете или для открытия ресурса в IFrame, а также не требуется для открытия ресурса в диалоговом окне, открытом с помощью API диалога.)
  • Он позволяет страницам в домене выполнять Office.js вызовы API из IFrames в надстройке.

Тип надстройки: контентные и почтовые надстройки, надстройки области задач

Синтаксис

<AppDomain>string</AppDomain>

Важно!

  1. Значение <элемента AppDomain> должно включать протокол (например, <AppDomain>https://myappdomain.com</AppDomain>), а протокол должен иметь значение http или https.
  2. Если для домена есть явный порт, добавьте его (например,<AppDomain>https://myappdomain.com:9999</AppDomain> ).
  3. Если поддомен должен быть доверенным, включите его (например,<AppDomain>https://mysubdomain.myappdomain.com</AppDomain> ). Поддомен mysubdomain.mydomain.com и mydomain.com являются разными доменами. Если оба должны быть доверенными, то оба должны находиться в отдельных <элементах AppDomain> .
  4. Перечисление того же домена, что и тот, который указан в элементе SourceLocation , не оказывает влияния и может вводить в заблуждение. В частности, при разработке в localhostне требуется создавать <элемент AppDomain> для localhost.
  5. Не включайте сегменты URL-адреса за доменом. Например, не включайте полный URL-адрес страницы.
  6. Не помещайте в значение закрывающая косая черта "/".
  7. Подстановочные знаки, такие как *, не допускаются в <значениях AppDomain> . Однако для надстроек, работающих только в Office в Windows, существует способ назначить дополнительные доверенные домены подстановочными знаками. См. раздел Доверенные домены с подстановочными знаками.

Содержится в

Замечания

Дополнительные сведения см. в статье XML-манифест надстроек Office.