Personen und Kontakte in EWS in Exchange
Erfahren Sie mehr über Personas, den einheitlichen Kontaktspeicher und das Arbeiten mit Kontakten mithilfe der EWS Managed API oder EWS in Exchange.
Kontakte sind Elemente in Exchange, die Informationen zu einer Einzelperson, Gruppe oder Organisation speichern. Kontakte können Namen und E-Mail-Adressen und andere Informationen enthalten, einschließlich Chatadressen, physische Adressen, Geburtstage, Familieninformationen und ein Foto oder Bild, das den Kontakt darstellt.
Kontaktinformationen werden an einem von zwei Orten gespeichert:
Active Directory Domain Services (AD DS), wenn sich der Kontakt innerhalb der Organisation befindet.
Der Ordner Kontakte oder ein anderer Ordner im Postfach eines Benutzers, wenn sich der Kontakt außerhalb der Organisation befindet.
Mehrere Kontaktelemente können eine einzelne Person darstellen. Exchange verwendet Personas, um diese verschiedenen Kontaktelemente zusammenzubringen. Eine Persona ist eine Aggregation von Kontaktinformationen für dieselbe Person aus verschiedenen Quellen. Zusätzlich zu den Kontaktinformationen in Exchange können Personas auch aus Informationen im Empfängercache für das Postfach, einem ausgeblendeten Ordner für Chatkontakte namens QuickContacts und aus Datenquellen von Drittanbietern aggregiert werden. Mit dem einheitlichen Kontaktspeicher in Exchange können Chatclients diese Aggregation verwenden. Der einzige Unterschied besteht darin, dass der Einheitliche Kontaktspeicher keine Informationen aus AD DS aggregiert, wie in Abbildung 1 dargestellt.
Abbildung 1: Kontaktinformationsquellen für Personas und für den einheitlichen Kontaktspeicher
Tabelle 1. Verwaltete EWS-API-Methoden und EWS-Vorgänge für die Arbeit mit Kontakten
| Aktion | Verwenden dieser verwalteten EWS-API-Methode | Zu verwendender EWS-Vorgang |
|---|---|---|
| Erstellen eines neuen Kontakts |
Instanziieren eines neuen Contact-Objekts und Verwenden von Contact.Save |
CreateItem |
| Kopieren eines Kontakts |
Contact.Copy |
CopyItem |
| Verschieben eines Kontakts |
Contact.Move |
MoveItem |
| Aktualisieren eines vorhandenen Kontakts |
Contact.Bind und Contact.Update |
UpdateItem |
| Löschen eines Kontakts |
Contact.Bind und Contact.Delete |
DeleteItem |
| Suchen nach einem Kontakt |
ExchangeService.FindItems |
FindItem |
| Suchen nach Personen |
Nicht zutreffend |
FindPeople |
| Erweitern einer Verteilergruppe |
ExchangeService.ExpandGroup |
ExpandDL |
| Auflösen eines mehrdeutigen Namens |
ExchangeService.ResolveName |
ResolveNames |
| Persona abrufen |
Nicht zutreffend |
GetPersona |
| Arbeiten mit Kontaktfotos |
Contact.SetContactPicture, Contact.GetContactPictureAttachment oder Contact.RemoveContactPicture |
GetUserPhoto oder GetAttachment |
Personas
Bis vor kurzem wurden Kontakte in der Regel an einem einzigen Ort gespeichert– in der Regel auf einem E-Mail-Client. Heutzutage wird es immer häufiger, Kontakte an vielen verschiedenen Orten zu speichern, z. B. auf einem Telefon, auf einer Website eines sozialen Netzwerks, in einem Kontaktordner in einem Exchange-Postfach oder im Verzeichnisdienst einer Organisation. Mit der Verbreitung von Kontaktinformationen ist es möglich, dass mehrere Kontakte, die dieselbe Person darstellen, unterschiedliche Informationen enthalten; Beispielsweise kann ein Kontakt eine geschäftliche Telefonnummer und ein anderer eine persönliche Telefonnummer enthalten, oder ein Kontakt, der in einem Kontaktordner gespeichert ist, hat möglicherweise einen anderen Namen als der Kontakt für dieselbe Person, die auf Ihrem Telefon gespeichert ist.
In Exchange Online Exchange Online als Teil von Office 365 und lokalen Versionen von Exchange ab Exchange 2013 werden Kontakte aus verschiedenen Quellen, die dieselbe Person darstellen, miteinander verknüpft, ähnlich wie E-Mail-Nachrichten in Unterhaltungen mithilfe einer allgemeinen Link-ID aggregiert werden. Wenn aggregierte Kontaktinformationen von einem Exchange-Server zurückgegeben werden, enthält sie einen Satz von Attributen für jeden Kontakt, z. B. einen Quellordner, einen Anzeigenamen, eine ID und eine Quell-ID. Die Summe der zurückgegebenen Eigenschaften und Attribute wird als Persona bezeichnet, und die zurückgegebenen Eigenschaften werden als Form der Persona bezeichnet.
Da die Informationen, aus denen eine Persona besteht, nicht an einem einzigen Speicherort gespeichert werden und sich diese Informationen jederzeit ändern können, wird eine Persona nur erstellt, wenn Sie eine Anforderung an einen Exchange-Server senden. Sie verwenden den EWS-Vorgang FindPeople , um eine Persona-Suchanforderung zu erstellen. Ihre Anforderung kann eine Sortierreihenfolge enthalten und nach einer Abfragezeichenfolge gefiltert werden, damit Sie die richtige Persona finden können, indem Sie die Ergebnisse sortieren und filtern. Beispielsweise können Sie den Anzeigenamen und eine Gruppe aller E-Mail-Adressen, die einem bestimmten Kontakt zugeordnet sind, aus dem Ordner Kontakte, einem Hotmail-Konto, einem LinkedIn-Konto und dem Verzeichnisdienst eines Unternehmens abrufen, oder Sie können eine Gruppe aller Personas mit Chatadressen abrufen. Die Verknüpfung von Kontakten mit Personas erfolgt automatisch basierend auf einem Algorithmus, der eine Beziehung zwischen Kontakten erkennt, die auf verschiedenen Geräten gespeichert sind.
Hinweis
Die verwaltete EWS-API implementiert diese Funktion nicht.
Tabelle 2. EWS-Vorgänge für die Arbeit mit Personas
| Name des Vorgangs | Beschreibung |
|---|---|
| FindPeople |
Gibt alle verfügbaren Personas aus einem angegebenen Kontaktordner zurück oder ruft Kontakte ab, die einer angegebenen Abfragezeichenfolge entsprechen. |
| GetPersona |
Gibt einen Satz von Eigenschaften zurück, die einer bestimmten Persona zugeordnet sind, z. B. alle Chatadressen oder Anzeigenamen für eine angegebene Persona-ID. |
Sie können die Vorgänge GetPersona und FindPeople verwenden, um Kontaktinformationen effizient aus mehreren Quellen abzurufen. Da alle Elemente, die sich auf eine Persona beziehen, einer Link-ID zugeordnet sind, können Sie diese Vorgänge in einer Vielzahl von Anwendungen verwenden, die Kontaktdaten verwenden. Im Folgenden finden Sie einige Beispiele:
Eine Mobiltelefon-App, die den GetPersona-Vorgang verwendet, wenn ein Benutzer einen Kontakt anruft, und dann zusätzliche Telefonnummern anbietet, die sie anrufen können, wenn niemand antworte.
Eine Anwendung, die den FindPeople-Vorgang verwendet, um Posteingangsnachrichten nach E-Mail-Adressen zu überprüfen, um festzustellen, ob sie in einer vorhandenen Persona gefunden werden. Adressen, die nicht bereits einer Persona zugeordnet sind, können verwendet werden, um Vertriebsleads zu erstellen oder alle aktuellen Kommunikationen mit der persona dargestellten Person aufzulisten.
Eine Mail-App für Outlook , die unterschiedliche Anreden anbietet, je nachdem, ob die Korrespondenz formal oder informell ist. Formale Anreden werden von den Anzeigenamen des Verzeichnisdiensts bereitgestellt, und informelle Anreden stammen aus dem Anzeigenamen, der aus Sozialen Netzwerken stammt.
Einheitlicher Kontaktspeicher
Personas sind nicht nur auf einen E-Mail-Client beschränkt. Wenn Sie einen Chatclient entwickeln, stellen Sie sich möglicherweise eine oder alle der folgenden Fragen:
Wie kann ich Lync-Clientanwendungen mit einem Standardsatz von Chatkontaktelementen bereitstellen?
Gewusst wie Chatkontakt- und Gruppenlisten verwalten?
Gewusst wie den benutzerdefinierten Lync-Clientzugriff auf Chatkontakte und Chatgruppen verwalten?
Der Einheitliche Kontaktspeicher arbeitet im Hintergrund in Exchange, um Kontaktdaten aus Exchange und anderen Quellen in einer einzelnen Entität oder Persona zu aggregieren. Obwohl die EWS-Vorgänge, die Sie für den Zugriff auf den einheitlichen Kontaktspeicher verwenden, spezifisch für Chatkontakte sind, können Sie den einheitlichen Kontaktspeicher in Exchange verwenden, um mit Personas in allen Arten von Anwendungen zu arbeiten. Beachten Sie, dass der Einheitliche Kontaktspeicher nicht auf Die Kontaktdaten von AD DS zugreifen kann.
Chatkontakte werden in einem ausgeblendeten Ordner namens QuickContacts gespeichert. Sie können die Vorgänge AddNewImContactToGroup und AddImContactToGroup verwenden, um Kontakte zu Gruppen hinzuzufügen, die in diesem ausgeblendeten Ordner gespeichert sind. Und da Sie den einheitlichen Kontaktspeicher zum Gruppieren von Chatkontakten verwenden können, können Sie einfacher auf Kontaktgruppen zugreifen und diese aktualisieren.
Hinweis
Die verwaltete EWS-API implementiert diese Funktion nicht.
Tabelle 3. EWS-Vorgänge für den Zugriff auf den einheitlichen Kontaktspeicher
| Name des Vorgangs | Beschreibung |
|---|---|
| AddNewImContactToGroup |
Fügt einer Chatgruppe einen neuen Chatkontakt mit maximal 1.000 Kontakten hinzu. |
| AddImContactToGroup |
Fügt einer Chatgruppe einen vorhandenen Chatkontakt mit maximal 1000 Kontakten hinzu. |
| AddImGroup |
Fügt eine neue Chatgruppe mit maximal 64 Gruppen hinzu. |
| AddDistributionGroupToImList |
Fügt einer Chatgruppe bis zu maximal 64 Gruppen eine neue Verteilergruppe hinzu. |
| GetImItemList |
Ruft eine Liste von Chatgruppen und Chatkontaktpersonas ab. |
| GetImItems |
Ruft Informationen zu bestimmten Chatgruppen und Chatkontaktpersonas ab. |
| RemoveContactFromImList |
Entfernt einen Kontakt aus einer Chatgruppe. |
| RemoveImContactFromGroup |
Entfernt einen Chatkontakt aus einer Chatgruppe. |
| RemoveDistributionGroupFromImList |
Entfernt eine Verteilergruppe aus einer Chatgruppe. |
| RemoveImGroup |
Entfernt eine Chatgruppe. |
| SetImGroup |
Ändert den Anzeigenamen einer Chatgruppe. |
Inhalt dieses Abschnitts
Verarbeiten von Kontakten in Batches mithilfe von EWS in Exchange
Auflösen von mehrdeutigen Namen mithilfe der EWS Exchange 2013
Siehe auch
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für