Office.PhoneNumber interface

Paket:

outlook

Stellt eine in einem Element erkannte Telefonnummer dar. Nur im Lesemodus.

Ein Array mir PhoneNumber-Objekten mit den Telefonnummern in einer E-Mail-Nachricht wird in der Eigenschaft phoneNumbers des Entities-Objekts zurückgegeben, das wiederum zurückgegeben wird, wenn Sie die Methode getEntitiess für das ausgewählte Element aufrufen.

Hinweise

Mindestberechtigungsstufe: Element lesen

Anwendbarer Outlook-Modus: Lesen

Wichtig: Entitätsbasierte kontextbezogene Outlook-Add-Ins werden im 2. Quartal 2024 eingestellt. Die Arbeiten zur Einstellung dieses Features beginnen im Mai und werden bis Ende Juni fortgesetzt. Nach Juni können Kontext-Add-Ins keine Entitäten mehr in E-Mail-Elementen erkennen, um Aufgaben für sie auszuführen. Die folgenden APIs werden ebenfalls eingestellt.

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

Um potenzielle Unterbrechungen zu minimieren, werden die folgenden Elemente weiterhin unterstützt, nachdem entitätsbasierte Kontext-Add-Ins eingestellt wurden.

• Eine alternative Implementierung der Schaltfläche " An Besprechung teilnehmen ", die von Onlinebesprechungs-Add-Ins aktiviert wird, wird entwickelt. Sobald die Unterstützung für entitätsbasierte Kontext-Add-Ins endet, werden Onlinebesprechungs-Add-Ins automatisch zur alternativen Implementierung übergehen, um die Schaltfläche An Besprechung teilnehmen zu aktivieren.

• Regeln für reguläre Ausdrücke werden weiterhin unterstützt, nachdem entitätsbasierte Kontext-Add-Ins eingestellt wurden. Es wird empfohlen, Ihr Kontext-Add-In zu aktualisieren, um Regeln für reguläre Ausdrücke als alternative Lösung zu verwenden. Anleitungen zum Implementieren dieser Regeln finden Sie unter Verwenden von Aktivierungsregeln für reguläre Ausdrücke zum Anzeigen eines Outlook-Add-Ins.

Weitere Informationen finden Sie unter Außerbetriebnahme entitätsbasierter kontextbezogener Outlook-Add-Ins.

Beispiele

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));
});

Eigenschaften

originalPhoneString	Ruft den Text ab, der in einem Element als Telefonnummer identifiziert wurde.
phoneString	Ruft eine Zeichenfolge mit einer Telefonnummer ab. Diese Zeichenfolge enthält nur die Ziffern der Telefonnummer und schließt Zeichen wie z. B. Klammern und Bindestriche aus, wenn diese im ursprüngliche Element enthalten sind.
type	Ruft eine Zeichenfolge ab, die den Typ der Telefonnummer angibt: Home, Work, Mobile, Unspecified.

Details zur Eigenschaft

originalPhoneString

Ruft den Text ab, der in einem Element als Telefonnummer identifiziert wurde.

originalPhoneString: string;

Eigenschaftswert

string

phoneString

Ruft eine Zeichenfolge mit einer Telefonnummer ab. Diese Zeichenfolge enthält nur die Ziffern der Telefonnummer und schließt Zeichen wie z. B. Klammern und Bindestriche aus, wenn diese im ursprüngliche Element enthalten sind.

phoneString: string;

Eigenschaftswert

string

type

Ruft eine Zeichenfolge ab, die den Typ der Telefonnummer angibt: Home, Work, Mobile, Unspecified.

type: string;

Eigenschaftswert

string