AppDomain 要素

SourceLocation 要素で指定されたドメインに加えて、Office で信頼する必要がある追加のドメインを指定します。 ドメインを指定すると、次のような効果があります。

  • これにより、ドメイン内のページ、ルート、またはその他のリソースを、デスクトップ Office プラットフォーム上のアドインのルート作業ウィンドウで直接開くことができます。 (<AppDomain> にドメインを指定することは、Office on the web または IFrame でリソースを開くために必要ではなく、ダイアログ API で開くダイアログでリソースを開くためにも必要ありません。)
  • これにより、ドメイン内のページでアドイン内の IFrame から Office.js API 呼び出しを実行できます。

アドインの種類: コンテンツ、作業ウィンドウ、メール

構文

<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.commydomain.com は異なるドメインです。 両方を信頼する必要がある場合は、両方が別々の <AppDomain> 要素内に存在する必要があります。
  4. SourceLocation 要素で指定されているものと同じドメインを一覧表示しても効果はなく、誤解を招く可能性があります。 localhost で開発する場合、通常は <AppDomain> 要素を作成する必要はありません。 ただし、Outlook on the web または新しい Outlook on Windows で実行されるアドインにダイアログ API を実装する場合は、localhost 用の <AppDomain> 要素を作成する必要があります。
  5. ドメインを超えた URL のセグメントを含めないでください。 たとえば、ページの完全な URL を含めないでください。
  6. 値に終了スラッシュ "/" を付け ないでください
  7. * などのワイルドカードは、<AppDomain> 値では使用できません。ただし、Windows 上の Office でのみ実行されるアドインの場合は、ワイルドカードを使用して信頼できるドメインを追加で指定する方法があります。 ワイルドカード信頼済みドメインを参照してください。

含まれる場所

注釈

詳細については、「 アドインのみのマニフェストを使用した Office アドイン」を参照してください。