SHD / MC Checker

MC715428 | Retirement of entities in Outlook for contextual add-ins



MC715428 | Retirement of entities in Outlook for contextual add-ins

Classification planForChange
Last Updated 02/13/2024 01:30:29
Start Time 02/13/2024 01:29:55
End Time 07/29/2024 07:00:00
Message Content

We’re making some changes to the way Outlook supports contextual add-ins. Contextual add-ins activate based on the content of an email message or a meeting request. Currently, Outlook supports two methods for activating contextual add-ins: entity stamping and regular expression (regex) matching.

Entity stamping is a process where Outlook identifies and highlights certain types of data in a message, such as addresses, phone numbers, meeting suggestions, and task suggestions. When a user clicks on a highlighted entity, Outlook shows a list of add-ins that are relevant to that entity.

Regex matching is a process where Outlook matches the content of a message against a set of regular expressions provided by the add-in developer. When a match is found, Outlook provides a control that can launch the add-in.

[When this will happen:]

We will begin rolling this out in mid-May 2024 and expect to complete by mid-June 2024.

[How this will affect your organization:]

We’re retiring entity stamping and will stop highlighting entities in Outlook. This means that add-ins that rely on entity stamping will no longer activate when highlighted entities are selected. Add-ins that rely on entity stamping, such as Bing Maps, Action Items, and Suggested Meetings, will also be retired. However, we will continue to support regex matching in add-ins and the Join Meeting button in online meeting add-ins.

If you have any add-ins that use entity stamping, you’ll need to update them to use regex matching or the Join Meeting button prior to this change happening. Otherwise, your add-ins won’t activate in Outlook and may lose functionality.

As part of this retirement, the following APIs will stop working for add-ins:

  • getEntities()
  • getEntitiesByType(entityType) 
  • getFilteredEntitiesByName(name) 
  • getSelectedEntities() 

[What you need to do to prepare:]

To learn how to update your add-ins, see Use regular expression activation rules to show an Outlook add-in and Create an Outlook add-in for an online-meeting provider. For more details on the announcement, see Retirement of entity-based contextual Outlook add-ins.

Machine Translation

Outlook がコンテキスト アドインをサポートする方法にいくつかの変更を加えています。コンテキスト アドインは、電子メール メッセージまたは会議出席依頼の内容に基づいてアクティブ化されます。現在、Outlook では、コンテキスト アドインをアクティブ化するために、エンティティ スタンプと正規表現 (regex) 照合の 2 つの方法がサポートされています。

エンティティ スタンプは、Outlook がメッセージ内の特定の種類のデータ (住所、電話番号、会議の提案、タスクの提案など) を識別して強調表示するプロセスです。強調表示されたエンティティをユーザーがクリックすると、Outlook には、そのエンティティに関連するアドインの一覧が表示されます。

正規表現の照合は、Outlook がメッセージの内容をアドイン開発者から提供された一連の正規表現と照合するプロセスです。一致するものが見つかった場合、Outlook にはアドインを起動できるコントロールが用意されています。

[これがいつ起こるか:]

2024 年 5 月中旬にロールアウトを開始し、2024 年 6 月中旬までに完了する予定です。

[これが組織に及ぼす影響:]

エンティティのスタンプを廃止し、Outlook でのエンティティの強調表示を停止します。つまり、エンティティのスタンプに依存するアドインは、強調表示されたエンティティが選択されたときにアクティブ化されなくなります。エンティティのスタンプに依存するアドイン (Bing Maps、アクション アイテム、提案された会議など) も廃止されます。ただし、アドインでの正規表現の一致と、オンライン会議アドインの [会議に参加] ボタンは引き続きサポートされます。

エンティティ スタンプを使用するアドインがある場合は、この変更が行われる前に、正規表現の一致または [会議に参加] ボタンを使用するようにアドインを更新する必要があります。そうしないと、アドインが Outlook でアクティブ化されず、機能が失われる可能性があります。

この廃止の一環として、次の API はアドインで機能しなくなります。

  • getEntities()を呼び出します
  • getEntitiesByType(エンティティタイプ) 
  • getFilteredEntitiesByName(名前) 
  • getSelectedEntities()を呼び出し ます。

[準備に必要なこと:]

アドインを更新する方法については、「 正規表現のアクティブ化ルールを使用して Outlook アドインを表示する」および「 オンライン会議プロバイダーの Outlook アドインを作成する 」を参照してください。発表の詳細については、「 エンティティ ベースのコンテキスト Outlook アドインの廃止」を参照してください。