Runtime 要素
さまざまなコンポーネントがすべて同じランタイムで実行されるように、共有 JavaScript ランタイムを使用するようにアドインを構成します。 Runtimes 要素の子。
アドインの種類: 作業ウィンドウ、メール
次の VersionOverrides スキーマでのみ有効です。
- 作業ウィンドウ 1.0
- メール 1.1
詳細については、「 マニフェストでのバージョンのオーバーライド」を参照してください。
次の要件セットに関連付けられています。
- SharedRuntime 1.1 (作業ウィンドウ アドインで使用されている場合のみ)。
- メールボックス 1.10 以降 ( イベント ベースのアクティブ化を実装する Outlook アドインで使用する場合)。
- メールボックス プレビュー ( 統合スパム レポート (プレビュー) 機能を実装する Outlook アドインで使用する場合)。
重要
共有 JavaScript ランタイムの場合、この要素を使用すると、リボン、作業ウィンドウ、およびその他のサポートされているコンポーネントが同じランタイムを使用できるようになります。 ただし、SharedRuntime 要件セットは一部の Office アプリケーションでのみ使用できます。 詳細については、「共有ランタイム要件セット」を参照してください。
Outlook
- イベント ベースのアクティブ化の場合、この要素を使用すると、たとえば、新しい項目を作成するときにアドインを実行できます。 サポートされているクライアントとその他の情報については、「 イベント ベースのアクティブ化のために 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 ランタイムを構成する場合にのみ使用されます。 アドインは、ドキュメントを開いて無期限に実行できます。 たとえば、ユーザーが作業ウィンドウを閉じても、作業ウィンドウ コードは引き続き実行されます。 これは、共有ランタイムでサポートされている唯一の値です。
関連項目
Office Add-ins
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示