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));
});
プロパティ
original |
アイテム内の電話番号として識別されたテキストを取得します。 |
phone |
電話番号を含む文字列を取得します。 この文字列には電話番号の数字のみが含まれており、かっこやハイフンなどの文字が元のアイテムに存在する場合は除外されます。 |
type | 電話番号の種類を識別する文字列を取得します。Home、Work、Mobile、Unspecified です。 |
プロパティの詳細
originalPhoneString
アイテム内の電話番号として識別されたテキストを取得します。
originalPhoneString: string;
プロパティ値
string
phoneString
電話番号を含む文字列を取得します。 この文字列には電話番号の数字のみが含まれており、かっこやハイフンなどの文字が元のアイテムに存在する場合は除外されます。
phoneString: string;
プロパティ値
string
type
電話番号の種類を識別する文字列を取得します。Home、Work、Mobile、Unspecified です。
type: string;
プロパティ値
string
Office Add-ins
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示