ランタイム要素

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

アドインの種類:: ドキュメント、メール、プレゼンテーション、作業ウィンドウ、ブック

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

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

重要

共有 JavaScript ランタイムの場合、この要素を使用すると、リボン、作業ウィンドウ、およびその他のサポートされているコンポーネントが同じランタイムを使用できます。ただし、SharedRuntime 要件セットは、一部の Office アプリケーションでのみ使用できます。詳細については、「共有ランタイム要件セット」を参照してください。
イベントベースのアクティブ化の場合、この要素を使用すると、新しいアイテムの作成時などにアドインを実行できます。サポートされているクライアントとその他の情報については、「イベントによるアドインのアクティブ化」を参照してください。
統合されたスパム報告の場合、この要素によってアドインは迷惑メッセージの処理を許可します。アドインに統合されたスパム報告機能を実装する方法の詳細については、「統合されたスパム報告アドインを実装する」を参照してください。

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

構文

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

要素	必須	説明
Override	不要	Windows 上の Office が LaunchEvent 拡張ポイントおよび ReportPhishingCommandSurface 拡張ポイントハンドラーに必要な JavaScript ファイルの URL の場所を指定します。重要: 現時点では、1 つの <オーバーライド> 要素のみを定義でき、その要素は `javascript` 型である必要があります。

属性	必須	説明
resid	はい	アドインの HTML ページの URL の場所を指定します。 `resid`は 32 文字以内で、`Resources` 要素の `Url` 要素の `id` 属性と一致する必要があります。重要: マニフェストで`LaunchEvent`拡張点または `ReportPhishingCustomization` 要素を指定する場合は、子 <SourceLocation> 要素の `resid` 属性が <Runtime> 要素の`resid`値と一致することを確認してください。たとえば、ランタイムが `<Runtime resid="WebViewRuntime.Url">` として定義されている場合は、 `<SourceLocation resid="WebViewRuntime.Url"/>` を指定します。
有効期間	不要	`lifetime` の既定値は `short` で、指定する必要はありません。イベントベースのライセンス認証およびスパム報告アドインでは、 `short` 値のみが使用されます。 Excel アドインで共有ランタイムを使用する場合は、明示的に値を `long` に設定します。

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

short: 既定値。イベントベースのライセンス認証およびスパム報告アドインにのみ使用されます。アドインがアクティブ化された後は、プラットフォームで指定された最大時間だけ実行されます。現在、これは約 5 分です。これは、イベントベースのアクティベーションでサポートされている唯一の値です。

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

このページはお役に立ちましたか?