XML für „activities“

  • Artikel

Dieses Thema enthält ein Beispielszenario, das die Aufrufe der Erweiterungs-API des Outlook-Connectors für soziale Netzwerke (OSC) zeigt, die von einem OSC-Anbieter implementiert werden und die OSC durchführt, um Aktivitätsinformationen abzurufen. Informationen werden in XML-Zeichenfolgen ausgedrückt, die dem XML-Schema des OSC-Anbieters entsprechen.

Das XML-Schema des OSC-Anbieters ermöglicht es einem OSC-Anbieter, Aktivitäten zu definieren. Aktivitätsinformationen können das soziale Netzwerk, aus dem die Aktivitätsfeedelemente stammen, Details zu jedem Aktivitätsfeedelement (z. B. Besitzer, Typ und Veröffentlichungsdatum der Aktivität) und die Vorlage zum Anzeigen der Aktivität umfassen. Um das Anzeigen von Aktivitäten im Personen Bereich oder der Visitenkarte zu unterstützen, muss der OSC-Anbieter eines sozialen Netzwerks die richtige Aktivitäts-XML implementieren und zurückgeben. Ein Beispiel für Aktivitätsfeed-XML finden Sie unter Beispiel für Aktivitätsfeed-XML. Weitere Informationen zum Synchronisieren von Aktivitäten von Freunden finden Sie unter Synchronisieren von Freunden und Aktivitäten. 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.

Im folgenden Szenario synchronisiert der OSC Dynamisch Aktivitäten für eine im Personen Bereich ausgewählte Person und ruft Details zu dieser Person ab:

  1. Ein OSC-Anbieter, der die bedarfsgesteuerte Synchronisierung von Aktivitäten unterstützt, gibt an, dass mit dem OSC mithilfe der Elemente getActivities und dynamicActivitiesLookupEx verwendet wird. Der OSC-Anbieter legt auch das hashFunction-Element fest. Alle drei Elemente sind untergeordnete Elemente von Funktionen.

  2. Der OSC-Anbieter implementiert die Methoden ISocialProvider::GetCapabilities und ISocialSession2::GetActivitiesEx .

  3. Der OSC ruft ISocialProvider::GetCapabilities auf, um den Wert von getActivities und dynamicActivitiesLookupEx zu überprüfen, um zu überprüfen, ob der OSC-Anbieter die bedarfsgesteuerte Synchronisierung von Aktivitäten unterstützt. Der OSC notiert auch den Wert des hashFunction-Elements , das vom OSC-Anbieter unterstützt wird.

  4. Der OSC aktualisiert den Personen Bereich oder die Visitenkarte, damit der Benutzer die neuesten Aktivitäten der ausgewählten Person anzeigen kann. Der OSC verschlüsselt die SMTP-Adresse der Person mithilfe der hash-Funktion, die im hashFunction-Element angegeben ist, und bildet eine XML-Zeichenfolge, die der XML-Schemadefinition für das hashedAddresses-Element entspricht.

  5. Der OSC ruft ISocialSession2::GetActivitiesEx auf und stellt diese XML-Zeichenfolge der hashed address als hashedAddresses-Parameter bereit, um eine aktuelle Auflistung von Aktivitäten für diese Person im activities-Parameter abzurufen. Die activities-Parameterzeichenfolge entspricht der XML-Schemadefinition des activityFeed-Elements .

  6. Basierend auf der XML-Schemadefinition für activityFeed analysiert der OSC die Aktivitätszeichenfolge weiter, um den Typ, das Veröffentlichungsdatum und andere Informationen zu den einzelnen Aktivitäten sowie die Anzeige der Aktivität zu ermitteln.

  7. Um Details zur ausgewählten Person abzurufen, ruft das OSC ISocialSession2::GetPeopleDetails auf und stellt die gleiche XML-Zeichenfolge von Hashadressen wie das Argument für den personsAddresses-Parameter bereit . Die Details zur Person werden im personsCollection-Parameter zurückgegeben. Diese Details können firstName, lastName und emailAddress enthalten. Der personsCollection-Parameter entspricht der XML-Schemadefinition für das Person-Element .

Weitere Informationen zum Angeben von XML für Aktivitäten finden Sie in den folgenden Themen dieses Abschnitts:

Siehe auch