Stssync-Protokoll
Letzte Änderung: Mittwoch, 20. Oktober 2010
Gilt für: SharePoint Foundation 2010
Mit dem stssync-Protokoll können Sie eine Ereignisliste oder eine Kontaktliste hinzufügen, die auf einer Microsoft SharePoint Foundation-Website von Microsoft Outlook oder für eine Anwendung eines Drittanbieters vorhanden ist, die das Protokoll unterstützt.
stssync://sts/?ver=version&type=folder-type&cmd=command-name&base-url=sts-url&guid=the-guid&site-name=site-friendly-name&list-name=list-friendly-name&list-url=list-url&user-id=uid
version |
Erforderlich. Die Version der Anwendung im Format x.y. Für Outlook sollte der Wert dieses Parameters beispielsweise 1.0 sein. Die Werte x und y dürfen nur Zahlen enthalten. x darf nicht mit einer Null beginnen, und y muss entweder Null oder eine andere Abfolge von Ziffern sein, die nicht mit einer Null beginnt. .gif "Hinweis") Hinweis
x und y dürfen beide maximal zwei Ziffern enthalten. Andernfalls gilt die URL in Outlook als falsch formatiert. Dieser Parameter kann von der Clientanwendung eines Drittanbieters verwendet werden, bei der Konstruktion der URL muss der Parameter jedoch einen Wert enthalten, andernfalls wird die URL als falsch formatiert behandelt.
|
folder-type |
Erforderlich. Kann calendar oder contacts sein, abhängig vom Typ der SharePoint-Liste, die Outlook oder der Anwendung eines Drittanbieters hinzugefügt wird. Bei diesem Parameter wird die Groß-/Kleinschreibung nicht beachtet. |
command-name |
Erforderlich. Der Befehlsname, den Outlook oder die Anwendung eines Drittanbieters verstehen. Geben Sie add-folder an, um Outlook einen Ordner hinzuzufügen. Weitere Befehle können Outlook zu einem späteren Zeitpunkt hinzugefügt werden. |
sts-url |
Erforderlich. Die URL zur SharePoint-Website, die hinzugefügt wird. Sie sollte nicht mit einem Schrägstrich (/) enden. |
the-guid |
Erforderlich. Die GUID, mit der bei gleichzeitiger Verwendung des sts-url-Parameters eine SharePoint-Liste eindeutig identifiziert wird. Von Outlook wird dieser Parameter im folgenden Format erwartet: "{"+ 8 Hexadezimalzeichen + "-" + 4 Hexadezimalzeichen + "-" + 4 Hexadezimalzeichen + "-" + 12 Hexadezimalzeichen + "}". Falls dieser Parameter in einem anderen Format vorliegt, gilt die URL für Outlook als falsch formatiert, und es wird ein Fehler zurückgegeben. |
site-friendly-name |
Erforderlich. Der Anzeigename der Website mit der hinzugefügten Liste. Outlook verwendet diesen Parameter zum Erstellen des Ordnernamens. |
list-friendly-name |
Erforderlich. Der Anzeigename der hinzugefügten Liste. Outlook verwendet diesen Parameter zum Erstellen des Ordnernamens. |
list-url |
Erforderlich. Eine Zeichenfolge, die dem sts-url-Parameter zum Erstellen der vollständigen URL für die Liste hinzugefügt wird. Sie sollte mit einem Schrägstrich (/) beginnen. |
uid |
Optional. Eine Zahl größer als Null mit weniger als acht Ziffern. Stellt einen Benutzer auf der SharePoint-Website eindeutig dar. |
Hinweise
Verwenden von Escapezeichen für Sonderzeichen: Falls eines der Zeichen "&", "\", "[", "]" oder "|" Teil des Werts der Parameter sts-url, site-friendly-name, list-friendly-name oder list-url ist, muss den Zeichen ein senkrechter Strich "|" voranstehen. Der Anzeigename einer Liste Dan [Wilson] - Business\Personal Contacts wird zu Dan |[Wilson|] - Business|\Personal Contacts.
Die Parameter sts-url, site-friendly-name, list-friendly-name und list-url können Unicode-Zeichen enthalten. Die Unicode-Zeichen müssen jedoch in Klammern "[ ]" gesetzt sein, und es muss sich um die Darstellung von 4-stelligen Hexadezimalzeichen der Unicode-Zeichen handeln.
Wenn Sie den Client eines Drittanbieters implementieren möchten, der das stssync-Protokoll zum Hinzufügen und Synchronisieren von Ereignis- und Kontaktlisten verwendet, die auf einer SharePoint-Website vorhanden sind, müssen Sie in der Regel ein ActiveX-Steuerelement mit dem Namen StssyncHandler implementieren und Unterstützung für das stssync-Protokoll bereitstellen. Der Client eines Drittanbieters muss in der Regel die URL decodieren und die Kontakt- oder Ereignisliste auf der SharePoint-Website synchronisieren können. Sie können den Microsoft.SharePoint-Namespace oder die von SharePoint Foundation offen gelegten Webdienste zum Durchführen dieser Aufgabe verwenden. Zudem müssen Sie das stssync-Protokoll in der Registrierung mit dem Namen der ausführbaren Datei der Anwendung registrieren. Wenn Sie das Windows-Betriebssystem mit Windows Internet Explorer 5.0 oder höher ausführen, können Sie das folgende Codebeispiel verwenden. Kopieren Sie den Code in eine REG-Datei, und ersetzen Sie <Path to exe> durch den Pfad zur ausführbaren Datei der Anwendung, die Ereignisse und Kontakte mit SharePoint Foundation synchronisieren soll. Doppelklicken Sie dann auf die REG-Datei, um das stssync-Protokoll auf dem Computer zu registrieren.
Windows Registry Editor Version 5.00 [HKEY_CLASSES_ROOT\stssync] @="URL:Add SharePoint Folder" "URL Protocol"="" [HKEY_CLASSES_ROOT\stssync\shell] @="open" [HKEY_CLASSES_ROOT\stssync\shell\open] @="" [HKEY_CLASSES_ROOT\stssync\shell\open\command] @="<Path to exe> \"%1\""Informationen zum StssyncHandler-Steuerelement, das auf dem Clientcomputer während des Setups von Microsoft Office installiert wird, finden Sie unter StssyncHandler-Steuerelement.
Beispiel
stssync://sts/?ver=1.0&type=calendar&cmd=
add-folder&base-url=http%3A%2F%2Fspserver1&list-url=
%2FLists%2FEvts%2FAllItems%2Easpx&guid=
%7BAA7D945C%2DE5C3%2D4854%2DB631%2D10A98E711E2B%7D&site-
name=Share|%7CPoint%20|%5BSite|%5D&list-name=Ev[00E900F1]ts
Diese URL gehört einer Liste mit dem Namen Evéñts auf einer Website mit dem Namen Share|Point [Site] mit der Website-URL http://spserver1 und der Listen-URL http://spserver1/Lists/Evts/AllItems.aspx. Beachten Sie die Verwendung des senkrechten Strichs als Escapezeichen für die Zeichen "|", "[" und "]" und die hexadezimale Darstellung der beiden Unicode-Zeichen im Listennamen.