Office.Contact interface
Stellt die Details zu einem Kontakt dar (ähnlich wie bei einem physischen Kontakt oder einer geschäftlichen Karte), die aus dem Text des Elements extrahiert wurden. Nur im Lesemodus.
Die Liste der Kontakte, die aus dem Text einer E-Mail-Nachricht oder eines Termins extrahiert wurden, wird in der contacts Eigenschaft des Entities-Objekts zurückgegeben, das von der getEntities OR-Methode getEntitiesByType 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 kontextbezogenes 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 Kontextbezogene Outlook-Add-Ins.
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 dauern bis Ende Juni. Nach Juni können kontextbezogene 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, wird Folgendes weiterhin unterstützt, nachdem entitätsbasierte kontextbezogene Add-Ins eingestellt wurden.
Eine alternative Implementierung der Schaltfläche "An Besprechung teilnehmen ", die durch Online-Besprechungs-Add-Ins aktiviert wird, ist in der Entwicklung. Sobald die Unterstützung für entitätsbasierte kontextbezogene Add-Ins endet, wechseln Onlinebesprechungs-Add-Ins automatisch zur alternativen Implementierung, um die Schaltfläche "An Besprechung teilnehmen " zu aktivieren.
Regeln für reguläre Ausdrücke werden weiterhin unterstützt, nachdem entitätsbasierte kontextbezogene Add-Ins eingestellt wurden. Es wird empfohlen, Ihr kontextbezogenes 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 Kontextbezogene Outlook-Add-Ins.
Weitere Informationen finden Sie unter Einstellung von entitätsbasierten, kontextbezogenen Outlook-Add-Ins.
Verwendet von
- Office.AppointmentRead: getEntitiesByType, getFilteredEntitiesByName
- Office.Entities: Kontakte
- Office.MessageRead: getEntitiesByType, getFilteredEntitiesByName
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 kontextbezogenes 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 Kontextbezogene Outlook-Add-Ins. |
| business |
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 kontextbezogenes 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 Kontextbezogene Outlook-Add-Ins. |
| email |
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 kontextbezogenes 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 Kontextbezogene Outlook-Add-Ins. |
| person |
Eine Zeichenfolge mit dem Namen der Person, die dem Kontakt zugeordnet ist. Lässt NULL-Werte zu. 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 kontextbezogenes 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 Kontextbezogene Outlook-Add-Ins. |
| phone |
Ein Array mit einem 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 kontextbezogenes 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 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 kontextbezogenes 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 Kontextbezogene Outlook-Add-Ins. |
Details zur Eigenschaft
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 kontextbezogenes 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 Kontextbezogene Outlook-Add-Ins.
addresses: string[];Eigenschaftswert
string[]
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 kontextbezogenes 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 Kontextbezogene Outlook-Add-Ins.
businessName: string;Eigenschaftswert
string
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 kontextbezogenes 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 Kontextbezogene Outlook-Add-Ins.
emailAddresses: string[];Eigenschaftswert
string[]
personName
Eine Zeichenfolge mit dem Namen der Person, die dem Kontakt zugeordnet ist. Lässt NULL-Werte zu.
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 kontextbezogenes 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 Kontextbezogene Outlook-Add-Ins.
personName: string;Eigenschaftswert
string
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 kontextbezogenes 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 Kontextbezogene Outlook-Add-Ins.
phoneNumbers: PhoneNumber[];Eigenschaftswert
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 kontextbezogenes 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 Kontextbezogene Outlook-Add-Ins.
urls: string[];Eigenschaftswert
string[]