Freigeben über


Office.Contact interface

Warnung

Diese API ist nun veraltet.

Use regular expression rules instead.

Stellt die Details zu einem Kontakt (ähnlich wie auf einem physischen Kontakt oder einer Visitenkarte) dar, 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.

Warnung: Entitätsbasierte kontextbezogene Outlook-Add-Ins werden jetzt eingestellt. Regeln für reguläre Ausdrücke werden jedoch weiterhin unterstützt. Es wird empfohlen, Ihr Kontext-Add-In zu aktualisieren, um Regeln für reguläre Ausdrücke als alternative Lösung zu verwenden. Eine Anleitung zum Implementieren dieser Regeln finden Sie unter Kontextbezogene Outlook-Add-Ins.

Hinweise

Mindestberechtigungsstufe: eingeschränkt

Anwendbarer Outlook-Modus: Lesen

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.

Warnung: Entitätsbasierte kontextbezogene Outlook-Add-Ins werden jetzt eingestellt. Regeln für reguläre Ausdrücke werden jedoch weiterhin unterstützt. Es wird empfohlen, Ihr Kontext-Add-In zu aktualisieren, um Regeln für reguläre Ausdrücke als alternative Lösung zu verwenden. Eine Anleitung zum Implementieren dieser Regeln finden Sie unter Kontextbezogene Outlook-Add-Ins.

businessName

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

Warnung: Entitätsbasierte kontextbezogene Outlook-Add-Ins werden jetzt eingestellt. Regeln für reguläre Ausdrücke werden jedoch weiterhin unterstützt. Es wird empfohlen, Ihr Kontext-Add-In zu aktualisieren, um Regeln für reguläre Ausdrücke als alternative Lösung zu verwenden. Eine Anleitung zum Implementieren dieser Regeln finden Sie unter Kontextbezogene Outlook-Add-Ins.

emailAddresses

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

Warnung: Entitätsbasierte kontextbezogene Outlook-Add-Ins werden jetzt eingestellt. Regeln für reguläre Ausdrücke werden jedoch weiterhin unterstützt. Es wird empfohlen, Ihr Kontext-Add-In zu aktualisieren, um Regeln für reguläre Ausdrücke als alternative Lösung zu verwenden. Eine Anleitung zum Implementieren dieser Regeln finden Sie unter Kontextbezogene Outlook-Add-Ins.

personName

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

Warnung: Entitätsbasierte kontextbezogene Outlook-Add-Ins werden jetzt eingestellt. Regeln für reguläre Ausdrücke werden jedoch weiterhin unterstützt. Es wird empfohlen, Ihr Kontext-Add-In zu aktualisieren, um Regeln für reguläre Ausdrücke als alternative Lösung zu verwenden. Eine Anleitung zum Implementieren dieser Regeln finden Sie unter Kontextbezogene Outlook-Add-Ins.

phoneNumbers

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

Warnung: Entitätsbasierte kontextbezogene Outlook-Add-Ins werden jetzt eingestellt. Regeln für reguläre Ausdrücke werden jedoch weiterhin unterstützt. Es wird empfohlen, Ihr Kontext-Add-In zu aktualisieren, um Regeln für reguläre Ausdrücke als alternative Lösung zu verwenden. Eine Anleitung zum Implementieren dieser Regeln finden Sie unter Kontextbezogene Outlook-Add-Ins.

urls

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

Warnung: Entitätsbasierte kontextbezogene Outlook-Add-Ins werden jetzt eingestellt. Regeln für reguläre Ausdrücke werden jedoch weiterhin unterstützt. Es wird empfohlen, Ihr Kontext-Add-In zu aktualisieren, um Regeln für reguläre Ausdrücke als alternative Lösung zu verwenden. Eine Anleitung zum Implementieren dieser Regeln finden Sie unter Kontextbezogene Outlook-Add-Ins.

Details zur Eigenschaft

addresses

Warnung

Diese API ist nun veraltet.

Use regular expression rules instead.

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

Warnung: Entitätsbasierte kontextbezogene Outlook-Add-Ins werden jetzt eingestellt. Regeln für reguläre Ausdrücke werden jedoch weiterhin unterstützt. Es wird empfohlen, Ihr Kontext-Add-In zu aktualisieren, um Regeln für reguläre Ausdrücke als alternative Lösung zu verwenden. Eine Anleitung zum Implementieren dieser Regeln finden Sie unter Kontextbezogene Outlook-Add-Ins.

addresses: string[];

Eigenschaftswert

string[]

businessName

Warnung

Diese API ist nun veraltet.

Use regular expression rules instead.

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

Warnung: Entitätsbasierte kontextbezogene Outlook-Add-Ins werden jetzt eingestellt. Regeln für reguläre Ausdrücke werden jedoch weiterhin unterstützt. Es wird empfohlen, Ihr Kontext-Add-In zu aktualisieren, um Regeln für reguläre Ausdrücke als alternative Lösung zu verwenden. Eine Anleitung zum Implementieren dieser Regeln finden Sie unter Kontextbezogene Outlook-Add-Ins.

businessName: string;

Eigenschaftswert

string

emailAddresses

Warnung

Diese API ist nun veraltet.

Use regular expression rules instead.

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

Warnung: Entitätsbasierte kontextbezogene Outlook-Add-Ins werden jetzt eingestellt. Regeln für reguläre Ausdrücke werden jedoch weiterhin unterstützt. Es wird empfohlen, Ihr Kontext-Add-In zu aktualisieren, um Regeln für reguläre Ausdrücke als alternative Lösung zu verwenden. Eine Anleitung zum Implementieren dieser Regeln finden Sie unter Kontextbezogene Outlook-Add-Ins.

emailAddresses: string[];

Eigenschaftswert

string[]

personName

Warnung

Diese API ist nun veraltet.

Use regular expression rules instead.

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

Warnung: Entitätsbasierte kontextbezogene Outlook-Add-Ins werden jetzt eingestellt. Regeln für reguläre Ausdrücke werden jedoch weiterhin unterstützt. Es wird empfohlen, Ihr Kontext-Add-In zu aktualisieren, um Regeln für reguläre Ausdrücke als alternative Lösung zu verwenden. Eine Anleitung zum Implementieren dieser Regeln finden Sie unter Kontextbezogene Outlook-Add-Ins.

personName: string;

Eigenschaftswert

string

phoneNumbers

Warnung

Diese API ist nun veraltet.

Use regular expression rules instead.

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

Warnung: Entitätsbasierte kontextbezogene Outlook-Add-Ins werden jetzt eingestellt. Regeln für reguläre Ausdrücke werden jedoch weiterhin unterstützt. Es wird empfohlen, Ihr Kontext-Add-In zu aktualisieren, um Regeln für reguläre Ausdrücke als alternative Lösung zu verwenden. Eine Anleitung zum Implementieren dieser Regeln finden Sie unter Kontextbezogene Outlook-Add-Ins.

phoneNumbers: PhoneNumber[];

Eigenschaftswert

urls

Warnung

Diese API ist nun veraltet.

Use regular expression rules instead.

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

Warnung: Entitätsbasierte kontextbezogene Outlook-Add-Ins werden jetzt eingestellt. Regeln für reguläre Ausdrücke werden jedoch weiterhin unterstützt. Es wird empfohlen, Ihr Kontext-Add-In zu aktualisieren, um Regeln für reguläre Ausdrücke als alternative Lösung zu verwenden. Eine Anleitung zum Implementieren dieser Regeln finden Sie unter Kontextbezogene Outlook-Add-Ins.

urls: string[];

Eigenschaftswert

string[]