Runtime 要素

  • [アーティクル]

さまざまなコンポーネントがすべて同じランタイムで実行されるように、共有 JavaScript ランタイムを使用するようにアドインを構成します。 Runtimes 要素の子。

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

次の VersionOverrides スキーマでのみ有効です:

  • 作業ウィンドウ 1.0
  • メール 1.1

詳細については、「 アドインのみのマニフェストでのバージョンのオーバーライド」を参照してください。

次の要件セットに関連付けられています:

重要

共有 JavaScript ランタイムの場合、この要素を使用すると、リボン、作業ウィンドウ、およびその他のサポートされているコンポーネントが同じランタイムを使用できるようになります。 ただし、SharedRuntime 要件セットは一部の Office アプリケーションでのみ使用できます。 詳細については、「共有ランタイム要件セット」を参照してください。

Outlook

イベント ベースのアクティブ化機能と統合スパム レポート機能では、同じランタイムを使用する必要があることに注意してください。 Outlook では、複数のランタイムは現在サポートされていません。

構文

<Runtimes>
    <Runtime resid="ContosoAddin.Url" lifetime="long" />
</Runtimes>

含まれる場所

子要素

要素 必須 説明
Override いいえ Outlook: Windows 上の Outlook で LaunchEvent 拡張ポイント と ReportPhishingCommandSurface 拡張ポイント (プレビュー) ハンドラーに必要な JavaScript ファイルの URL の場所を指定します。 重要: 現時点では、 <Override> 要素を定義できるのは 1 つだけであり、 javascript型である必要があります。

属性

属性 必須 説明
resid はい アドインの HTML ページの URL の場所を指定します。 residは 32 文字以内であり、Resources 要素のUrl要素のid属性と一致する必要があります。
一生 いいえ lifetimeの既定値はshortであり、指定する必要はありません。 Outlook イベント ベースのアクティブ化アドインとスパムレポート アドインでは、 short 値のみが使用されます。 Excel アドインで共有ランタイムを使用する場合は、値を明示的に long に設定します。

lifetime 属性

省略可能。 アドインの実行が許可される時間の長さを表します。

使用可能な値

short：デフォルト。 Outlook イベント ベースのアクティブ化アドインとスパム レポート アドインにのみ使用されます。アドインがアクティブ化されると、プラットフォームで指定された最大時間実行されます。 現時点では、約 5 分です。 これは、Outlook でサポートされている唯一の値です。

long: 共有 JavaScript ランタイムを構成する場合にのみ使用されます。 アドインは、ドキュメントを開いて無期限に実行できます。 たとえば、ユーザーが作業ウィンドウを閉じても、作業ウィンドウ コードは引き続き実行されます。 これは、共有ランタイムでサポートされている唯一の値です。

関連項目