コンテキスト Outlook アドイン
コンテキスト アドインは、メッセージまたは予定のテキストに基づいてアクティブ化する Outlook アドインです。 コンテキスト アドインを使用すると、ユーザーはメッセージ自体を残さずにメッセージに関連するタスクを開始できるため、ユーザー エクスペリエンスが簡単でリッチになります。
重要
エンティティベースのコンテキスト Outlook アドインは、2024 年第 2 四半期に廃止される予定です。 この機能を廃止する作業は 5 月に開始され、6 月末まで継続されます。 6 月以降、コンテキスト アドインはメール アイテム内のエンティティを検出してタスクを実行できなくなります。 次の API も廃止されます。
- Office.context.mailbox.item.getEntities()
- Office.context.mailbox.item.getEntitiesByType(entityType)
- Office.context.mailbox.item.getFilteredEntitiesByName(name)
- Office.context.mailbox.item.getSelectedEntities()
中断の可能性を最小限に抑えるために、エンティティ ベースのコンテキスト アドインが廃止された後も、次の機能がサポートされます。
- オンライン会議アドインによってアクティブ化される [会議に参加 ] ボタンの代替実装が開発されています。 エンティティベースのコンテキスト アドインのサポートが終了すると、オンライン会議アドインは自動的に別の実装に移行して [ 会議に参加 ] ボタンをアクティブ化します。
- エンティティ ベースのコンテキスト アドインが廃止された後も、正規表現ルールは引き続きサポートされます。 代替ソリューションとして正規表現ルールを使用するように、コンテキスト アドインを更新することをお勧めします。 これらのルールを実装する方法のガイダンスについては、「 正規表現アクティブ化ルールを使用して Outlook アドインを表示する」を参照してください。
詳細については、「 エンティティ ベースのコンテキスト Outlook アドインの廃止」を参照してください。
コンテキスト アドインの例を次に示します。
- 住所を選択すると、その場所の地図が開きます。
- 文字列をクリックすると、会議提案アドインが開きます。
- 電話番号を選択すると、連絡先に追加されます。
コンテキスト アドインの作成方法
注:
コンテキスト Outlook アドインは、アドインで Microsoft 365 用の統合マニフェストを使用する場合はサポートされません。
コンテキスト アドインのマニフェストには、xsi:type
属性が DetectedEntity
に設定されている ExtensionPoint 要素が含まれている必要があります。 <ExtensionPoint> 要素内のアドインは、アクティブ化できるエンティティまたは正規表現を指定します。 エンティティを指定する場合、そのエンティティは Entities オブジェクトのどのプロパティであってもかまいません。
そのため、アドイン マニフェストには、ルールの種類 ItemHasKnownEntity または ItemHasRegularExpressionMatch が含まれている必要があります。 次の例は、電話番号であるエンティティが検出されたメッセージに対してアドインをアクティブ化するように指定する方法を示しています。
<ExtensionPoint xsi:type="DetectedEntity">
<Label resid="contextLabel" />
<!--If you opt to include RequestedHeight, it must be between 140px to 450px, inclusive.-->
<!--<RequestedHeight>360</RequestedHeight>-->
<SourceLocation resid="detectedEntityURL" />
<Rule xsi:type="RuleCollection" Mode="And">
<Rule xsi:type="ItemIs" ItemType="Message" />
<Rule xsi:type="ItemHasKnownEntity" EntityType="PhoneNumber" Highlight="all" />
</Rule>
</ExtensionPoint>
コンテキスト アドインをアカウントに関連付けると、強調表示された状態のエンティティまたは正規表現をユーザーがクリックするとコンテキスト アプリが自動的に起動します。 Outlook アドインでの正規表現について詳しくは、「正規表現アクティブ化ルールを使用して Outlook アドインを表示する」を参照してください。
コンテキスト アドインには、次のいくつかの制限があります。
- コンテキスト アドインを含めることができるのは読み取りアドインのみです (作成アドインは不可)。
- 強調表示されたエンティティの色は指定できません。
- 強調表示されていないエンティティは、コンテキスト アドインをカード内で起動することはありません。
強調表示されていないエンティティまたは正規表現はコンテキスト アドインを起動しないため、アドイン マニフェストには Highlight
属性が all
に設定された Rule
要素を少なくとも 1 つは含んでいる必要があります。
注:
エンティティ型と Url
エンティティ型はEmailAddress
強調表示をサポートしていないため、コンテキスト アドインを起動するために使用することはできません。 しかし、追加のアクティブ化条件として、RuleCollection
ルール型と組み合わせることは可能です。
コンテキスト アドインの起動方法
ユーザーは、既知のエンティティまたは開発者の正規表現のどちらかで、テキストを通じてコンテキスト アドインを起動します。 通常、ユーザーはエンティティが強調表示されていることでコンテキスト アドインを特定します。 以下の例は、メッセージ内で強調表示がどのように見えるかを示しています。 ここでは、エンティティ (住所) は青色で、下線は点線の青で表示されます。 ユーザーは、強調表示されているエンティティをクリックしてコンテキスト アドインを起動します。
1 つのメッセージ内に複数のエンティティまたはコンテキスト アドインが存在する場合、ユーザー操作の規則がいくつかあります。
- エンティティが複数ある場合、ユーザーは対象のアドインを起動するために異なるエンティティをクリックする必要があります。
- エンティティが複数のアドインをアクティブにする場合、各アドインは新しいタブを開きます。ユーザーはタブを切り替えて、アドイン間の変更をします。たとえば、名前とアドレスは、電話のアドインとマップをトリガーするかもしれません。
- 1 つの文字列に複数のアドインをアクティブにする複数のエンティティが含まれる場合、文字列全体が強調表示され、その文字列をクリックすると、その文字列に関連付けられているすべてのアドインが別々のタブに表示されます。 たとえば、レストランで会議を行う提案を説明する文字列によって、会議提案アドインとレストラン評価アドインをアクティブにできます。
コンテキスト アドインの表示方法
アクティブ化されたコンテキスト アドインは、カード (エンティティの近くに現れる別ウィンドウ) で表示されます。 通常、このカードはエンティティの下側に、できるだけ中央揃えになるように表示されます。 エンティティの下に十分なスペースがない場合、カードはその上に配置されます。
カードを閉じてアドインを終了するには、カードの外側で任意の場所をクリックします。
現在のコンテキスト アドイン
Outlook アドインを使用するユーザーには、既定で次のコンテキスト アドインがインストールされます。
- Bing 地図
- 会議の候補
関連項目
- Outlook アドイン: Contoso 社の注文番号 (正規表現の一致に基づいてアクティブ化されるコンテキスト アドインのサンプル)
- 初めて Outlook アドインを記述する
- 正規表現アクティブ化ルールを使用して Outlook アドインを表示する
- Entities オブジェクト
Office Add-ins
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示