AppDomain 要素

  • [アーティクル]

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

  • これにより、ドメイン内のページ、ルート、またはその他のリソースを、デスクトップ Office プラットフォーム上のアドインのルート作業ウィンドウで直接開きます。 (<AppDomain でドメインを指定する>は、Web 上の Office や IFrame でリソースを開く必要はありません。また、Dialog API で開かれたダイアログでリソースを開く必要もありません)。
  • これにより、ドメイン内のページは、アドイン内の IFrames から 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.com と mydomain.com は異なるドメインです。 両方を信頼する必要がある場合は、両方とも個別の<AppDomain>要素に存在する必要があります。
  4. SourceLocation 要素で指定されたものと同じドメインを一覧表示しても効果がなく、誤解を招く可能性があります。 特に、localhostで開発する場合は、localhostの<AppDomain> 要素を作成する必要はありません。
  5. ドメインを超える URL のセグメントは含めないでください。 たとえば、ページの完全な URL は含めないでください。
  6. 値にスラッシュ "/" を付 けないでください 。
  7. *などのワイルドカードは、<AppDomain> 値では許可されません。ただし、Office on Windows でのみ実行されているアドインの場合は、ワイルドカードを使用して追加の信頼されたドメインを指定する方法があります。 ワイルドカードの信頼されたドメインに関するページを参照してください。

含まれる場所

注釈

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