Элемент AppDomain

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

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

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

Синтаксис

<AppDomain>string</AppDomain>

Важно!

  1. Значение <элемента AppDomain> должно включать протокол (например, <AppDomain>https://myappdomain.com</AppDomain>), а протокол должен иметь значение or 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> . Но если вы реализуете API диалоговых окон в надстройке, работающей в Outlook в Интернете или в новом Outlook для Windows, необходимо создать <элемент AppDomain> для localhost.
  5. Не включайте сегменты URL-адреса за пределами домена. Например, не включайте полный URL-адрес страницы.
  6. Не ставьте закрывающую косую черту "/" для значения.
  7. Подстановочные знаки, например *, не допускаются в <значениях AppDomain> ; однако для надстроек, работающих только в Office в Windows, можно назначить дополнительные доверенные домены с помощью подстановочных знаков. См. Доверенные домены с подстановочными знаками.

Содержится в

Примечания

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

  • Last updated on