XML-Elemente für „capabilities“
Die Tabellen in diesem Thema beschreiben untergeordnete Elemente des Funktions-XML und sind nach den bereichen gruppiert, die sie unterstützen. Der Standardwert jedes capabilities-Elements ist false. Wenn das Element nicht in der Capabilities-XML angegeben ist, die von der ISocialProvider::GetCapabilities-Methode zurückgegeben wird, ist der Wert des Elements gleich false.
Eine Übersicht über die Xml-Funktionen finden Sie unter XML für Funktionen. Ein Beispiel für Funktionen-XML finden Sie unter Capabilities XML Example. Eine vollständige Definition des XML-Schemas des Microsoft Outlook-Anbieters für soziale Netzwerke (OSC), einschließlich der erforderlichen oder optionalen Elemente, finden Sie unter XML-Schema des Outlook Connector-Anbieters für soziale Netzwerke.
Funktionen zur Unterstützung von Freunden
Die folgende Tabelle enthält Elemente, die für jede Form der Synchronisierung von Freunden oder Nicht-Freunden gelten.
| Element | Beschreibung |
|---|---|
|
doNotFollowPerson |
Gibt an, ob der Anbieter den ISocialSession::UnFollowPerson-Methodenaufruf unterstützt. followPerson und doNotFollowPerson sind unabhängige Features eines OSC-Anbieters. Ein OSC-Anbieter kann angeben, dass er in der Lage ist, eine Person als Freund hinzuzufügen (einstellung followPerson auf true) oder eine Person als Freund in einem Konto eines sozialen Netzwerks zu entfernen (einstellung doNotFollowPerson auf true). Im Allgemeinen bedeutet die Fähigkeit zu folgen nicht, nicht aufhören zu können. followPerson ist eine Funktion und darf nicht als Aktion interpretiert werden, um einer bestimmten Person oder jeder Person im Konto des sozialen Netzwerks zu folgen. followPerson ist true , bedeutet nicht, dass doNotFollowPersonfalse ist. |
|
followPerson |
Gibt an, ob der Anbieter den ISocialSession::FollowPerson-Methodenaufruf unterstützt. Die OSC überprüft followPerson , wenn cacheFriendstrue ist (zwischengespeicherte Synchronisierung von Freunden), dynamicContactsLookupist true (On-Demand-Synchronisierung von Freunden und Nicht-Freunden), oder sowohl cacheFriends als auch dynamicContactsLookup sind true (Hybridsynchronisierung von Freunden und Nicht-Freunden). Wenn der Anbieter followPerson auf true festgelegt hat, zeigt osC im bereich Personen einen Netzwerkbadge für Personen an, denen der Benutzer folgt, und aktiviert den Befehl on <NetworkName> im Menü Hinzufügen (+) im bereich Personen. Wenn der Anbieter followPerson auf false festlegt, wird das Netzwerkbadge nicht angezeigt, und der <On NetworkName-Befehl> ist ausgeblendet. |
|
getFriends |
Gibt an, ob der Anbieter den Methodenaufruf ISocialPerson::GetFriendsAndColleagues oder ISocialSession2::GetPeopleDetails unterstützt. Wenn der Anbieter getFriends auf true festlegt, verwendet das OSC den Wert von cacheFriends oder dynamicContactsLookup , um zu bestimmen, ob das soziale Netzwerk das Speichern von Freunden als Outlook-Kontaktelemente oder im Arbeitsspeicher zulässt. Wenn der Anbieter getFriends als false festlegt, unterstützt das soziale Netzwerk keine Freunde und die Methoden ISocialPerson::GetFriendsAndColleagues und ISocialSession2::GetPeopleDetails , und das OSC ignoriert die Werte von cacheFriends und dynamicContactsLookup. |
Die folgenden Elemente gelten nur für die zwischengespeicherte Synchronisierung von Freunden oder die Hybridsynchronisierung von Freunden und Nicht-Freunden. Weitere Informationen zum Synchronisieren von Freunden finden Sie unter Synchronisieren von Freunden und Aktivitäten.
| Element | Beschreibung |
|---|---|
|
cacheFriends |
Gibt an, ob der OSC-Anbieter das Speichern von Freunden als Outlook-Kontaktelemente zulässt. Der OSC überprüft cacheFriends nur, wenn getFriendstrue ist. Wenn der Anbieter cacheFriends auf true festlegt, synchronisiert der OSC Freunde durch Zwischenspeichern und erstellt einen netzwerkspezifischen Kontaktordner im Standardspeicher des Benutzers für Freundeskontakte. Der Name des netzwerkspezifischen Kontaktordners ist der Wert der Eigenschaft ISocialProvider::SocialNetworkName . Wenn der Anbieter cacheFriends auf false festlegt, erstellt das OSC keinen netzwerkspezifischen Kontaktordner für Freundeskontakte, um Freunde zu speichern. |
|
contactSyncRestartInterval |
Bestimmt das Wiederholungsintervall in Minuten zwischen den Versuchen, die Informationen von Freunden aus dem sozialen Netzwerk zu synchronisieren, wenn ein Synchronisierungsfehler auftritt. Die OSC verwendet dieses Element nur, wenn der OSC-Anbieter die zwischengespeicherte Synchronisierung oder hybride Synchronisierung von Freunden mit einem social network-spezifischen Kontaktordner unterstützt (cacheFriends ist true). Das Standardmäßige Wiederholungsintervall beträgt 30 Minuten, es sei denn, der Standardwert wird durch den ContactSyncRestartInterval Schlüssel unter HKEY_CURRENT_USER\Software\Microsoft\Office\Outlook\SocialConnectorüberschrieben. Wenn der Anbieter contactSyncRestartInterval festlegt, überschreibt der Anbieterwert das standardwiegende Wiederholungsintervall von 30 Minuten oder den Registrierungsschlüsselwert. Weitere Informationen zum Synchronisieren von Informationen zu Freunden und Nicht-Freunden bei Bedarf finden Sie unter Synchronisieren von Freunden und Aktivitäten. |
Die folgenden Elemente gelten nur für die bedarfsgesteuerte Synchronisierung oder hybride Synchronisierung von Freunden und Nicht-Freunden.
| Element | Beschreibung |
|---|---|
|
dynamicContactsLookup |
Gibt an, ob der OSC-Anbieter den ISocialSession2::GetPeopleDetails-Aufruf für die bedarfsgesteuerte Synchronisierung von Freunden und Nicht-Freunden unterstützt. Der OSC überprüft dynamicContactsLookup nur, wenn getFriendstrue ist. Die Standardeinstellung für dynamicContactsLookup ist false. Wenn der OSC-Anbieter dynamicContactsLookup als true und getFriends als true angibt, ruft der OSC ISocialSession2::GetPeopleDetails jedes Mal auf, wenn der Personen Bereich aktualisiert wird. Der Personen Bereich wird aktualisiert, wenn der Benutzer einen anderen Benutzer im Personen Bereich oder ein anderes Element im Outlook-Explorer-Fenster auswählt oder ein Outlook-Inspektorfenster öffnet. Die Suche nach dynamischen Kontakten stellt sicher, dass der Benutzer immer die neuesten Benutzerbilder und Profilinformationen im Personen-Bereich sieht, erhöht jedoch die Anzahl der Anrufe vom Anbieter an das soziale Netzwerk. Wenn der Anbieter dynamicContactsLookup auf false festlegt, ruft das OSC ISocialSession2::GetPeopleDetails nicht auf, um den Personen Bereich zu aktualisieren. |
|
showOnDemandContactsWhenMinimized |
Gibt an, ob das OSC eine bedarfsgesteuerte Synchronisierung für Freunde und Nicht-Freunde durchführen soll, wenn der Personen Bereich minimiert wird. |
Funktionen zur Unterstützung von Aktivitäten
Das folgende Element gilt für jede Form der Synchronisierung von Aktivitäten, die vom OSC-Anbieter unterstützt werden.
| Element | Beschreibung |
|---|---|
|
getActivities |
Gibt an, ob der Anbieter die ISocialSession2::GetActivitiesEx - oder ISocialPerson::GetActivities-Methodenaufrufe unterstützt. Wenn der Anbieter getActivities auf true festlegt, verwendet der OSC den Wert von cacheActivities oder dynamicActivitiesLookupEx , um zu bestimmen, ob die Website des sozialen Netzwerks das Speichern von Aktivitäten als Outlook-RSS-Elemente oder als In-Memory-Aktivitäten zulässt. Wenn der Anbieter getActivities auf false festlegt, unterstützt das soziale Netzwerk keine Aktivitäten und die Methoden ISocialSession2::GetActivitiesEx und ISocialPerson::GetActivities , und das OSC ignoriert die Werte von cacheActivities und dynamicActivitiesLookupEx. |
Das folgende Element gilt nur für die zwischengespeicherte Synchronisierung oder hybride Synchronisierung von Aktivitäten.
| Element | Beschreibung |
|---|---|
|
cacheActivities |
Ab Outlook Connector 2013 für soziale Netzwerke ignoriert das OSC dieses Element, da Anbieter Aktivitäten nicht mehr synchronisieren können, indem sie in einem ausgeblendeten Ordner im Speicher des Benutzers zwischengespeichert werden. Wenn der Anbieter Aktivitäten unterstützt, muss der Anbieter bedarfsgesteuerte Synchronisierungsaktivitäten unterstützen. Der Anbieter legt cacheActivities auf false und dynamicActivitesLookupEx auf true fest. Der OSC synchronisiert Aktivitäten bei Bedarf und speichert Aktivitäten im Arbeitsspeicher zwischen. Der Arbeitsspeichercache für Aktivitäten wird in einem Intervall von 30 Minuten aktualisiert. |
Die folgenden Elemente gelten nur für die bedarfsgesteuerte Synchronisierung oder hybride Synchronisierung von Aktivitäten.
| Element | Beschreibung |
|---|---|
|
dynamicActivitiesLookup |
In OSC 1.1 veraltet. Ab OSC 1.1 ruft das OSC ISocialSession::GetActivities nicht mehr auf und ignoriert den Wert von dynamicActivitiesLookup. Um die Suche nach bedarfsgesteuerten Aktivitäten zu unterstützen, legen Sie cacheActivities auf false und getActivities und dynamicActivitiesLookupEx auf true fest, und das OSC ruft ISocialSession2::GetActivitiesEx auf. |
|
dynamicActivitiesLookupEx |
Gibt an, ob der OSC-Anbieter den ISocialSession2::GetActivitiesEx-Aufruf für die bedarfsgesteuerte Synchronisierung von Aktivitäten unterstützt. Wenn der OSC-Anbieter die Synchronisierung von bedarfsgesteuerten Aktivitäten unterstützt, legt er getActivities und dynamicActivitiesLookupEx auf true und cacheActivities auf false fest. Der OSC ruft ISocialSession2::GetActivitiesEx jedes Mal auf, wenn der Personen Bereich aktualisiert wird. Der Personen Bereich wird aktualisiert, wenn der Benutzer das ausgewählte Element im Outlook-Explorer-Fenster ändert oder ein Outlook-Inspektorfenster öffnet. Die Suche nach dynamischen Aktivitäten stellt sicher, dass der Benutzer immer die neuesten Aktivitäten im Personen Bereich sieht, erhöht jedoch die Anzahl der Anrufe vom Anbieter an das soziale Netzwerk. Wenn der Anbieter dynamicActivitiesLookupEx auf false festlegt, ruft das OSC ISocialSession2::GetActivitiesEx nicht für Personen auf, die im Personen Bereich angezeigt werden. |
|
showOnDemandActivitiesWhenMinimized |
Gibt an, ob die OSC eine bedarfsgesteuerte Synchronisierung für Aktivitäten durchführen soll, wenn der Personen Bereich minimiert ist. |
Allgemeine Funktionen zur Unterstützung der bedarfsgesteuerten oder hybriden Synchronisierung von Freunden, Nicht-Freunden und Aktivitäten
| Element | Beschreibung |
|---|---|
|
hashFunction |
Gibt die Hashfunktion an, die der OSC-Anbieter unterstützt. Um personenbezogene Informationen von Benutzern zu schützen, die sich nicht im sozialen Netzwerk oder der Branchenanwendung des Anbieters befinden, übergibt das OSC E-Mail-Adressen mit Hash an ISocialSession2::GetPeopleDetails und ISocialSession2::GetActivitiesEx. Wenn dynamicContactsLookup auf true oder dynamicActivitiesLookupEx auf true festgelegt ist, muss der Anbieter hashFunction auf einen der zulässigen Werte festlegen: SHA1, MD5 oder CRC32MD5. Wenn hashFunction fehlt oder einen falschen Wert angibt, gibt osc einen Fehler zurück.
SHA1 ist internet Engineering Task Force (IETF) US Secure Hash Algorithm 1 definiert von [RFC3174]. Der SHA1-Hashwert der E-Mail-Adresse melissa@contoso.com ist bb81577b567262a21a4df5f6e335c1250acd7b50beispielsweise .
MD5 ist die Internet Engineering Task Force (IETF) MD5 Message-Digest Algorithmus, der von [RFC1321] definiert wird. Der MD5-Hashwert der E-Mail-Adresse melissa@contoso.com ist c8c39e61ca1662477b39b83d7b0a0615beispielsweise .
CRC32MD5 ist eine Kombination aus CRC32 und MD5 , die wie folgt definiert sind:Normalisieren Sie die E-Mail-Adresse, indem Sie führende und nachfolgende Leerzeichen entfernen und alle Zeichen in Kleinbuchstaben konvertieren. Berechnen Sie den CRC32-Wert für die normalisierte E-Mail-Adresse, und verwenden Sie die dezimale ganzzahlige Darstellung dieses Werts. Wenn Ihre Implementierung ganze Zahlen mit Vorzeichen zurückgibt, müssen Sie die ganze Zahl mit Vorzeichen in eine ganze Zahl ohne Vorzeichen konvertieren. Berechnen Sie den MD5-Wert für die normalisierte E-Mail-Adresse, und verwenden Sie die hexadierte Darstellung dieses Werts (mit Kleinbuchstaben für A bis F). Kombinieren Sie diese beiden Werte mit einem Unterstrich. Der CRC32MD5 Hashwert der E-Mail-Adresse melissa@contoso.com lautet 2149665315_c8c39e61ca1662477b39b83d7b0a0615beispielsweise . |
Funktionen zur Unterstützung der Authentifizierung und Kontokonfiguration
| Element | Beschreibung |
|---|---|
|
allowChangesToAutoConfigure |
Gibt an, ob das soziale Netzwerk es dem Benutzer ermöglicht, einstellungen für die automatische Konfiguration zu ändern, z. B. die Angabe einer anderen URL für die Anmeldung. |
|
createAccountUrl |
Wenn der Anbieter hideHyperlinks auf false festlegt und der Benutzer im Dialogfeld Kontokonfiguration auf Hier klicken klickt, um ein Konto zu erstellen, wird die durch createAccountUrl angegebene URL im Standardbrowser geöffnet. |
|
displayUrl |
Gibt an, ob das OSC das Textfeld URL-Adresse für das soziale Netzwerk im Dialogfeld kontokonfiguration anzeigen soll. |
|
forgotPasswordUrl |
Wenn der Anbieter hideHyperlinks auf false festlegt und der Benutzer im Dialogfeld Kontokonfiguration auf Kennwort vergessen? klickt, wird die durch forgotPasswordUrl angegebene URL im Standardbrowser geöffnet. |
|
hideHyperlinks |
Gibt an, ob die OSC die Links Hier klicken, um ein Konto zu erstellen und Kennwort vergessen? im Dialogfeld Kontokonfiguration ausblenden soll. OSC 1.0 ignoriert diese Einstellung, und die Hyperlinks sind immer ausgeblendet. OSC 1.1 beobachtet den Wert dieser Einstellung. |
|
hideRememberMyPassword |
Gibt an, ob das OSC das Kontrollkästchen Kennwort speichern im Dialogfeld kontokonfiguration ausblenden soll. Wenn der Anbieter hideRemberMyPassword auf true festlegt, verhält sich das OSC so, als wäre das Kontrollkästchen Kennwort speichern deaktiviert, und das Kennwort wird nicht gespeichert. Wenn der Anbieter hideRemberMyPassword auf false festlegt, zeigt osC das Kontrollkästchen Kennwort speichern im Dialogfeld Kontokonfiguration an. |
|
supportsAutoConfigure |
Gibt an, ob das OSC die GetAutoConfiguredSession-Funktion auf der ISocialProvider-Schnittstelle aufrufen soll, um eine automatische Konfiguration zu versuchen und sich für den Benutzer beim sozialen Netzwerk anzumelden. |
|
useLogonCached |
Gibt an, ob der OSC-Anbieter den ISocialSession2::LogonCached-Aufruf zur Anmeldung mit zwischengespeicherten Anmeldeinformationen unterstützt. Wenn der Anbieter useLogonCached auf true festlegt, ignoriert der OSC die Einstellung für useLogonWebAuth , und die OSC ruft ISocialSession2::LogonCached für die Authentifizierung auf. Wenn der Anbieter dynamicActivitiesLookupEx als false festlegt, ruft der OSC ISocialSession2::LogonCached nicht zur Authentifizierung auf. |
|
useLogonWebAuth |
Gibt an, ob die OSC die formularbasierte Authentifizierung und die ISocialSession::LogonWeb-Methode verwenden soll. Wenn der Anbieter useLogonWebAuth als false festlegt, verwendet der OSC die Standardauthentifizierung und ruft die ISocialSession::Logon-Methode auf. Wenn der Anbieter useLogonWebAuth auf true festlegt, verwendet der OSC die formularbasierte Authentifizierung und ruft ISocialSession::LogonWeb auf. |
Abhängig von der Vom Anbieter in der ISocialProvider::GetCapabilities-Methode zurückgegebenen Funktionen-XML ändert sich das Dialogfeld für die Kontokonfiguration. Abbildung 1 zeigt z. B. das Dialogfeld für die Kontokonfiguration für ein TestProvider-Beispiel.
Abbildung 1: TestProvider-Beispiel im Dialogfeld "Kontokonfiguration"
