AppDomain, élément

Spécifie un domaine supplémentaire approuvé par Office, en plus de celui spécifié dans l’élément SourceLocation. La spécification d’un domaine a les effets suivants :

  • Il permet d’ouvrir des pages, des itinéraires ou d’autres ressources du domaine directement dans le volet Office racine du complément sur les plateformes Office de bureau. (La spécification d’un domaine dans un <AppDomain> n’est pas nécessaire pour Office sur le Web ou pour ouvrir une ressource dans un IFrame, ni pour ouvrir une ressource dans une boîte de dialogue ouverte avec l’API de boîte de dialogue.)
  • Il permet aux pages du domaine d’effectuer des appels d’API Office.js à partir d’IFrames dans le complément.

Type de complément : application de contenu, de volet Office, de messagerie

Syntaxe

<AppDomain>string</AppDomain>

Importante

  1. La valeur de l’élément <AppDomain> doit inclure le protocole (par exemple, <AppDomain>https://myappdomain.com</AppDomain>), et le protocole doit être soit http ou https.
  2. S’il existe un port explicite pour le domaine, incluez-le (par exemple,<AppDomain>https://myappdomain.com:9999</AppDomain>).
  3. Si un sous-domaine doit être approuvé, incluez-le (par exemple,<AppDomain>https://mysubdomain.myappdomain.com</AppDomain>). Le sous-domaine mysubdomain.mydomain.com et mydomain.com sont des domaines différents. Si les deux doivent être approuvés, ils doivent se trouver dans des éléments AppDomain> distincts<.
  4. L’inscription du même domaine que celui spécifié dans l’élément SourceLocation n’a aucun effet et peut être trompeuse. Lors du développement sur localhost, vous n’avez généralement pas besoin de créer un <élément AppDomain> pour celui-ci. Toutefois, si vous implémentez l’API Dialog dans un complément qui s’exécute sur Outlook sur le web ou la nouvelle version d’Outlook sur Windows, vous devez créer un <élément AppDomain> pour localhost.
  5. N’incluez aucun segment d’URL au-delà du domaine. Par exemple, n’incluez pas l’URL complète d’une page.
  6. N’appliquez pas de barre oblique fermante (/) sur la valeur.
  7. Les caractères génériques, tels que *, ne sont pas autorisés dans les <valeurs AppDomain> ; Toutefois, pour les compléments exécutés uniquement dans Office sur Windows, il existe un moyen de désigner d’autres domaines approuvés avec des caractères génériques. Consultez Domaines de confiance génériques.

Contenu dans

Remarques

Pour plus d’informations, voir Compléments Office avec un manifeste de complément uniquement.