Office.PhoneNumber interface

アイテム内の識別される電話番号を表します。 閲覧モードのみ。

電子メール メッセージで見つかった電話番号を含むオブジェクトのPhoneNumber配列は、選択した項目で メソッドをphoneNumbers呼び出getEntitiesしたときに返される オブジェクトの Entities プロパティで返されます。

注釈

最小アクセス許可レベル: アイテムの読み取り

適用される Outlook モード: 読み取り

重要: エンティティベースのコンテキスト Outlook アドインは、2024 年第 2 四半期に廃止される予定です。 この機能を廃止する作業は 5 月に開始され、6 月末まで継続されます。 6 月以降、コンテキスト アドインはメール アイテム内のエンティティを検出してタスクを実行できなくなります。 次の API も廃止されます。

  • Office.context.mailbox.item.getEntities - Office.context.mailbox.item.getEntitiesByType - Office.context.mailbox.item.getFilteredEntitiesByName - Office.context.mailbox.item.getSelectedEntities

中断の可能性を最小限に抑えるために、エンティティ ベースのコンテキスト アドインが廃止された後も、次の機能がサポートされます。

  • オンライン会議アドインによってアクティブ化される [会議に参加 ] ボタンの代替実装が開発されています。 エンティティベースのコンテキスト アドインのサポートが終了すると、オンライン会議アドインは自動的に別の実装に移行して [ 会議に参加 ] ボタンをアクティブ化します。

  • エンティティ ベースのコンテキスト アドインが廃止された後も、正規表現ルールは引き続きサポートされます。 代替ソリューションとして正規表現ルールを使用するように、コンテキスト アドインを更新することをお勧めします。 これらのルールを実装する方法のガイダンスについては、「 正規表現アクティブ化ルールを使用して Outlook アドインを表示する」を参照してください。

詳細については、「 エンティティ ベースのコンテキスト Outlook アドインの廃止」を参照してください。

const item = Office.context.mailbox.item;
// Get an array of strings that represent phone numbers in the current item's body.
const phoneNumbers = item.getEntitiesByType(Office.MailboxEnums.EntityType.PhoneNumber);
console.log("There are " + phoneNumbers.length + " phone numbers.")
phoneNumbers.forEach(function (phoneNumber) {
    console.log("Phone number: " + JSON.stringify(phoneNumber.phoneString));
    console.log("Type: " + JSON.stringify(phoneNumber.type));
    console.log("Source text: " + JSON.stringify(phoneNumber.originalPhoneString));
});

プロパティ

originalPhoneString

アイテム内の電話番号として識別されたテキストを取得します。

phoneString

電話番号を含む文字列を取得します。 この文字列には電話番号の数字のみが含まれており、かっこやハイフンなどの文字が元のアイテムに存在する場合は除外されます。

type

電話番号の種類を識別する文字列を取得します。Home、Work、Mobile、Unspecified です。

プロパティの詳細

originalPhoneString

アイテム内の電話番号として識別されたテキストを取得します。

originalPhoneString: string;

プロパティ値

string

phoneString

電話番号を含む文字列を取得します。 この文字列には電話番号の数字のみが含まれており、かっこやハイフンなどの文字が元のアイテムに存在する場合は除外されます。

phoneString: string;

プロパティ値

string

type

電話番号の種類を識別する文字列を取得します。Home、Work、Mobile、Unspecified です。

type: string;

プロパティ値

string