Office.Contact interface

  • Referenz
Paket:
outlook

Stellt die Details zu einem Kontakt dar (ähnlich wie bei einem physischen Kontakt oder Karte), die aus dem Text des Elements extrahiert wurden. Nur im Lesemodus.

Die Liste der Kontakte, die aus dem Textkörper einer E-Mail-Nachricht oder eines Termins extrahiert wurden, wird in der contacts -Eigenschaft des Entities-Objekts zurückgegeben, das von der - oder getEntitiesByType -getEntitiesMethode des aktuellen Elements zurückgegeben wird.

Hinweise

Mindestberechtigungsstufe: eingeschränkt

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 contacts in the current item's body.
const contacts = item.getEntitiesByType(Office.MailboxEnums.EntityType.Contact);
console.log("There are " + contacts.length + " contacts.")
contacts.forEach(function (contact) {
    console.log("Person name: " + JSON.stringify(contact.personName));
    console.log("Business name: " + JSON.stringify(contact.businessName));
    console.log("Addresses: " + JSON.stringify(contact.addresses));
    console.log("Phone numbers: " + JSON.stringify(contact.phoneNumbers));
    console.log("Email addresses: " + JSON.stringify(contact.emailAddresses));
    console.log("Urls: " + JSON.stringify(contact.urls));
});

/* Example email that includes contact details of sender, John Smith:
Hi there,
I have received the package.

Thanks.
John Smith
Account Manager
Contoso Corporation
1 Contoso Way, Redmond, WA 98052
john.smith@contoso.com
111-111-1111
https://contoso.com/john.smith
*/

Eigenschaften

addresses

Ein Array aus Zeichenfolgen mit der Postadresse und der Anschrift des Kontakts. Nullwerte zulassend.
businessName

Eine Zeichenfolge mit dem Namen des Unternehmens, das dem Kontakt zugeordnet ist. Nullwerte zulassend.
emailAddresses

Ein Array aus Zeichenfolgen mit den SMTP-E-Mail-Adressen des Kontakts. Nullwerte zulassend.
personName

Eine Zeichenfolge mit dem Namen der Person, die dem Kontakt zugeordnet ist. Nullwerte zulassend.
phoneNumbers

Ein Array mit einem PhoneNumber-Objekt für jede Telefonnummer des Kontakts. Nullwerte zulassend.
urls

Ein Array aus Zeichenfolgen mit den Internet-URLs des Kontakts. Nullwerte zulassend.

Details zur Eigenschaft

addresses

Ein Array aus Zeichenfolgen mit der Postadresse und der Anschrift des Kontakts. Nullwerte zulassend.

addresses: string[];

Eigenschaftswert

string[]

businessName

Eine Zeichenfolge mit dem Namen des Unternehmens, das dem Kontakt zugeordnet ist. Nullwerte zulassend.

businessName: string;

Eigenschaftswert

string

emailAddresses

Ein Array aus Zeichenfolgen mit den SMTP-E-Mail-Adressen des Kontakts. Nullwerte zulassend.

emailAddresses: string[];

Eigenschaftswert

string[]

personName

Eine Zeichenfolge mit dem Namen der Person, die dem Kontakt zugeordnet ist. Nullwerte zulassend.

personName: string;

Eigenschaftswert

string

phoneNumbers

Ein Array mit einem PhoneNumber-Objekt für jede Telefonnummer des Kontakts. Nullwerte zulassend.

phoneNumbers: PhoneNumber[];

Eigenschaftswert

Office.PhoneNumber[]

urls

Ein Array aus Zeichenfolgen mit den Internet-URLs des Kontakts. Nullwerte zulassend.

urls: string[];

Eigenschaftswert

string[]