Freigeben über

XML für „friends“

  • Artikel

Das Friends-Element im XML-Schema des Microsoft Outlook Connector-Anbieters für soziale Netzwerke (OSC) ermöglicht es einem OSC-Anbieter, Informationen für eine Liste von Personen anzugeben, die einem Outlook-Benutzer im sozialen Netzwerk zugeordnet sind. Wenn der OSC-Anbieter die zwischengespeicherte Synchronisierung unterstützt, enthält diese Personenliste nur Freunde des Outlook-Benutzers im sozialen Netzwerk. Wenn das OSC die bedarfsgesteuerte oder hybride Synchronisierung unterstützt, kann diese Liste sowohl Freunde als auch Nicht-Freunde des Outlook-Benutzers enthalten.

Jede Person in der Liste wird als Personenelement im XML-Schema dargestellt, das Details wie Vorname, Nachname und E-Mail-Adressen unterstützt. OSC-Anbieter verwenden die Elemente "Freunde " und " Person ", unabhängig davon, wie der OSC Die Informationen von Freunden aus dem sozialen Netzwerk synchronisiert. Beachten Sie, dass die untergeordneten Elemente von Person einigen der Eigenschaften eines Outlook-Kontakts ähneln. Dies erleichtert das Speichern von Freunden in einem Outlook-Kontaktordner, der für das soziale Netzwerk spezifisch ist, wenn das soziale Netzwerk die zwischengespeicherte oder hybride Synchronisierung von Freunden mit einem Outlook-Kontaktordner unterstützt.

Beispielszenarien

Die folgenden Beispielszenarien zeigen die AUFRUFE der OSC-Anbietererweiterungs-API, die ein OSC-Anbieter implementiert und der OSC durchführt, um Friend-Informationen abzurufen. Informationen werden in XML-Zeichenfolgen ausgedrückt, die dem XML-Schema des OSC-Anbieters entsprechen.

Ein Beispiel für FRIENDS-XML finden Sie unter Friends XML-Beispiel. Weitere Informationen zum Synchronisieren von Informationen zu Freunden finden Sie unter Synchronisieren von Freunden und Aktivitäten.

Szenario 1: Abrufen einer Liste von Freunden

Szenario 1: OSC ruft eine Liste von Freunden sowie ein ISocialPerson-Objekt und ein Bild für jeden Freund ab:

  1. Ein OSC-Anbieter, der das Anzeigen von Freunden von der Website des sozialen Netzwerks unterstützt und dem OSC das Zwischenspeichern von Freundinformationen ermöglicht, weist darauf hin, dass der OSC die Elemente getFriends und cacheFriends verwendet, die untergeordnete Elemente des Capabilities-Elements sind.

  2. Der OSC-Anbieter implementiert auch die Methoden ISocialProvider::GetCapabilities, ISocialSession::GetPerson, ISocialPerson::GetFriendsAndColleagues und ISocialPerson::GetPicture .

  3. Der OSC ruft ISocialProvider::GetCapabilities auf, um den Wert der folgenden Elemente zu überprüfen: getFriends , um zu überprüfen, ob der OSC-Anbieter das Anzeigen von Freunden aus dem sozialen Netzwerk unterstützt, und cacheFriends , um zu überprüfen, ob der Anbieter das Zwischenspeichern von Freunden unterstützt.

  4. Das OSC ruft ISocialSession::GetPerson auf, um ein ISocialPerson-Objekt für den Outlook-Benutzer abzurufen.

  5. Das OSC ruft ISocialPerson::GetFriendsAndColleagues auf, um die Freundesliste des Outlook-Benutzers abzurufen, die in der personCollection-Parameterzeichenfolge zurückgegeben wird. Die personCollection-Zeichenfolge entspricht der XML-Schemadefinition für das friends-Element im XML-Schema.

  6. Für jeden Freund in der personCollection-XML-Zeichenfolge ruft osC den Wert des userID-Elements ab, um ISocialSession::GetPerson aufzurufen, um ein ISocialPerson-Objekt für diesen Freund abzurufen.

  7. Für jeden Freund in der personCollection-XML-Zeichenfolge ruft das OSC ISocialPerson::GetPicture auf, um eine Bildressource für diesen Freund abzurufen.

    Der OSC kann weitere Aufrufe an das ISocialPerson-Objekt senden, um Aktivitäten und Details (z. B. E-Mail-Adressen) für diesen Freund abzurufen.

Szenario 2: Synchronisieren von Freunden

Szenario 2– OSC synchronisiert Freunde dynamisch:

  1. Ein OSC-Anbieter, der die bedarfsgesteuerte Synchronisierung von Freunden und Nicht-Freunden unterstützt, gibt an, dass mit dem OSC mithilfe der Elemente getFriends und dynamicContactsLookup . Der OSC-Anbieter legt auch das hashFunction-Element fest. Alle drei Elemente sind untergeordnete Elemente von Funktionen.

  2. Der OSC-Anbieter implementiert auch die ISocialSession2::GetPeopleDetails-Methode .

  3. Der OSC ruft ISocialProvider::GetCapabilities auf, um die Werte von getFriends und dynamicContactsLookup zu überprüfen, um sicherzustellen, dass der OSC-Anbieter Freunde und die bedarfsgesteuerte Synchronisierung von Freunden und Nicht-Freunden unterstützt. Der OSC notiert auch den Wert von hashFunction , der vom OSC-Anbieter unterstützt wird.

  4. Für jeden Benutzer, der im bereich Personen angezeigt wird, erfasst das OSC die E-Mail-Adresse des Benutzers und verschlüsselt sie mithilfe der in hashFunction angegebenen Hashfunktion. Dadurch wird eine XML-Zeichenfolge erstellt, die der XML-Schemadefinition für das hashedAddresses-Element entspricht.

  5. Der OSC ruft ISocialSession2::GetPeopleDetails auf und stellt diese XML-Zeichenfolge von Hashadressen als personAddresses-Parameter bereit, um dynamisch aktualisierte Details für Personen im personsCollection-Parameter abzurufen. Die personsCollection-Parameterzeichenfolge entspricht der XML-Schemadefinition für das friends-Element im XML-Schema.

Übergeordnete und untergeordnete Elemente

Im Folgenden sind die beiden Elemente der obersten Ebene im Freundesschema aufgeführt.

Element Beschreibung
Freunde
Stellt das Stammelement einer Liste von Personenelementen dar. ISocialPerson::GetFriendsAndColleagues, ISocialSession::FindPerson und ISocialSession2::GetPeopleDetails geben XML-Zeichenfolgen zurück, die der Schemadefinition des friends-Elements entsprechen.
Person
Stellt eine Person in einer Liste von Personenelementen dar. Die ISocialPerson::GetDetails-Methode gibt eine XML-Zeichenfolge zurück, die der Schemadefinition des person-Elements entspricht.

In der folgenden Tabelle wird jedes untergeordnete Element des Person-Elements im XML-Schema des OSC-Anbieters beschrieben.

Eine vollständige Definition des XML-Schemas des OSC-Anbieters, einschließlich der erforderlichen oder optionalen Elemente, finden Sie unter Xml-Schema des Outlook Connector-Anbieters für soziale Netzwerke.

Element Beschreibung
address
Physische Adresse der Person.
Jahrestag
Jahrestag für eine Veranstaltung für die Person.
askmeabout
Themen, die von Interesse oder Fachwissen der Person sind.
Geburtstag
Geburtsdatum der Person.
businessAddress
Physische Adresse des Arbeitsplatzes der Person.
businessCity
Ort für den Arbeitsplatz der Person.
businessCountryOrRegion
Land oder Region des Arbeitsplatzes der Person.
businessState
Bundesland oder Bundesland des Arbeitsplatzes.
businessZip
Postleitzahl des Arbeitsplatzes der Person.
Zelle
Mobiltelefonnummer für die Person.
Stadt
Ort der physischen Adresse der Person.
company
Name des Unternehmens, das der Person zugeordnet ist.
countryOrRegion
Land oder Region der physischen Adresse der Person.
Creationtime
Erstellungszeit des Profils der Person im sozialen Netzwerk.
emailAddress
Primäre E-Mail-Adresse der Person.
emailAddress2
Sekundäre E-Mail-Adresse der Person.
emailAddress3
Tertiäre E-Mail-Adresse der Person.
expirationTime
Der Zeitpunkt, zu dem die Profildaten der Person im sozialen Netzwerk ablaufen.
fileAs
Zeichenfolge, mit der die Person als Kontakt in einer Outlook-Kontaktdatei abgelegt werden soll.
firstName
Vorname oder Vorname der Person.
friendStatus
Friend status dieser Person mit dem angemeldeten Benutzer im sozialen Netzwerk. Muss einer der folgenden Werte sein: friend, nonfriend, pending, pendingin, pendingout.
Fullname
Vollständiger Name der Person.
Geschlecht
Geschlecht der Person. Muss einer der folgenden Werte sein: männlich, weiblich, nicht angegeben.
homePhone
Private Telefonnummer für die Person.
Index
Speicherort der gehashten Adresse der Person im Zeichenfolgenparameter personsAddresses , der an einen Aufruf der ISocialSession2::GetPeopleDetails-Methode übergeben wird. Es gibt auch den Personen-XML-Code der Person in der Zeichenfolge personsCollection an, die von GetPeopleDetails zurückgegeben wird.
Industrien
Branchen, in denen die Person beschäftigt ist.
interests
Interessen oder Hobbys der Person.
lastModificationTime
Zeitpunkt, zu dem das Profil der Person zuletzt im sozialen Netzwerk geändert wurde.
lastName
Nach- oder Nachname der Person.
location
Der Standort der Person.
Spitzname
Ein kürzerer Name oder ein erfundener Name der Person.
otherAddress
Alternative Adresse der Person.
otherCity
Der Ort der alternativen Adresse der Person.
otherCountryOrRegion
Land oder Region der alternativen Adresse der Person.
otherState
Bundesland oder Provinz der alternativen Adresse der Person.
otherZip
Postleitzahl der alternativen Adresse der Person.
Telefon
Telefonnummer des primären Kontakts für die Person.
pictureUrl
URL für ein Profilbild der Person.
Beziehung
Beziehung dieser Person mit dem angemeldeten Benutzer.
schools
Die Schulen, die die Person besucht oder besucht hat.
skills
Persönliche Fähigkeiten der Person.
state
Staat oder Provinz der physischen Adresse der Person.
title
Bezeichnung, die dem Namen der Person hinzugefügt wurde.
Userid
ID zur Identifizierung der Person im sozialen Netzwerk.
webProfilePage
Webseitenadresse, die ein Profil der Person enthält.
Website
Die Website der Person.
workPhone
Geschäftliche Telefonnummer für die Person.
Zip
Postleitzahl der physischen Adresse der Person.

Siehe auch