AppDomain-Element

Gibt eine zusätzliche Domäne an, der Office vertrauen sollte, zusätzlich zu der im SourceLocation-Element angegebenen. Die Angabe einer Domäne hat folgende Auswirkungen:

  • Damit können Seiten, Routen oder andere Ressourcen in der Domäne direkt im Stammaufgabenbereich des Add-Ins auf Office-Desktopplattformen geöffnet werden. (Die Angabe einer Domäne in einer <AppDomain> ist weder für Office im Web noch zum Öffnen einer Ressource in einem IFrame erforderlich, und es ist auch nicht erforderlich, um eine Ressource in einem Dialogfeld zu öffnen, das mit der Dialog-API geöffnet wird.)
  • Es ermöglicht Seiten in der Domäne, Office.js API-Aufrufe von IFrames innerhalb des Add-Ins zu tätigen.

Add-In-Typ: Inhalt, Aufgabenbereich, E-Mail

Syntax

<AppDomain>string</AppDomain>

Wichtig

  1. Der Wert des <AppDomain-Elements> muss das Protokoll enthalten (z. B <AppDomain>https://myappdomain.com</AppDomain>. ), und das Protokoll muss entweder http oder httpssein.
  2. Wenn ein expliziter Port für die Domäne vorhanden ist, schließen Sie ihn ein (z. B<AppDomain>https://myappdomain.com:9999</AppDomain>.).
  3. Wenn eine Unterdomäne vertrauenswürdig sein muss, schließen Sie sie ein (zum Beispiel).<AppDomain>https://mysubdomain.myappdomain.com</AppDomain> Die Subdomäne mysubdomain.mydomain.com und mydomain.com sind unterschiedliche Domänen. Wenn beide vertrauenswürdig sein müssen, müssen sich beide in separaten <AppDomain-Elementen> befinden.
  4. Das Auflisten derselben Domäne wie die im SourceLocation-Element angegebene hat keine Auswirkung und kann irreführend sein. Wenn Sie auf localhostentwickeln, müssen Sie normalerweise kein AppDomain-Element<> dafür erstellen. Wenn Sie die Dialog-API jedoch in einem Add-In implementieren, das auf Outlook im Web oder dem neuen Outlook unter Windows ausgeführt wird, müssen Sie ein <AppDomain-Element> für localhosterstellen.
  5. Schließen Sie keine Segmente einer URL ein, die über die Domäne hinausgehen. Fügen Sie beispielsweise nicht die vollständige URL einer Seite ein.
  6. Setzen Sie keinen schließenden Schrägstrich ("/") auf den Wert.
  7. Platzhalter, z. B *. , sind in <AppDomain-Werten> nicht zulässig. Für Add-Ins, die nur in Office unter Windows ausgeführt werden, gibt es jedoch eine Möglichkeit, zusätzliche vertrauenswürdige Domänen mit Platzhaltern festzulegen. Siehe Vertrauenswürdige Platzhalterdomänen.

Enthalten in

Hinweise

Weitere Informationen finden Sie unter Office-Add-Ins mit einem Nur-Add-In-Manifest.

  • Last updated on