Freigeben über

AppDomain-Element

  • Artikel

Gibt eine zusätzliche Domäne an, der Office vertrauen soll, zusätzlich zur im SourceLocation-Element angegebenen Domäne. Das Angeben einer Domäne hat folgende Auswirkungen:

  • Dadurch können Seiten, Routen oder andere Ressourcen in der Domäne direkt im Stammaufgabenbereich des Add-Ins auf Office-Desktopplattformen geöffnet werden. (Das Angeben einer Domäne in einer <AppDomain> ist für Office im Web oder zum Öffnen einer Ressource in einem IFrame weder erforderlich noch zum Öffnen einer Ressource in einem Dialogfeld, das mit der Dialog-API geöffnet wird.)
  • Dadurch können Seiten in der Domäne Office.js API-Aufrufe von IFrames innerhalb des Add-Ins ausführen.

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

Syntax

<AppDomain>string</AppDomain>

Wichtig

  1. Der Wert des <AppDomain-Elements> muss das Protokoll (z. B. ) enthalten, <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 (z. B. ).<AppDomain>https://mysubdomain.myappdomain.com</AppDomain> Die Unterdomä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> enthalten.
  4. Das Auflisten derselben Domäne wie die im SourceLocation-Element angegebene hat keine Auswirkung und kann irreführend sein. Insbesondere wenn Sie unter localhostentwickeln, müssen Sie kein AppDomain-Element> für<localhosterstellen.
  5. Schließen Sie keine Segmente einer URL nach der Domäne ein. Schließen Sie beispielsweise nicht die vollständige URL einer Seite ein.
  6. Setzen Sie keinen schließende Schrägstrich (/) auf den Wert.
  7. Wildcards wie *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 Wildcards festzulegen. Weitere Informationen finden Sie unter Vertrauenswürdige Domänen mit Wildcards.

Enthalten in

Hinweise

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