Erweitern des "Verbinden mit"-Steuerelements
Letzte Änderung: Samstag, 1. Mai 2010
Gilt für: SharePoint Foundation 2010
Das Menüelement Connect To… ist erweiterbar, sodass es von einem Client verwendet werden kann.
Wie wird eine Verbindung mit dem Connect To-Menüelement hergestellt? Erstellen Sie ein ActiveX-Steuerelement, und informieren Sie das Menü über dessen Vorhandensein.
Erweitern des Menüelements "Verbinden mit"
Zwei Schritte müssen von Clientanwendungen ausgeführt werden, damit das Menüelement angezeigt wird:
Registrieren des Stssync-Protokoll-Protokollhandlers. Mit dem stssync-Protokoll können Sie eine Ereignisliste oder eine Kontaktliste hinzufügen, die auf einer SharePoint Foundation-Website von Office Outlook 2003, Office Outlook 2007 oder einer Anwendung eines Drittanbieters vorhanden ist, der das Protokoll unterstützt.
Installieren eines ActiveX-Steuerelements, das den Anwendungsnamen und einen Symboldateinamen zurückgibt.
Das ActiveX-Steuerelement muss die ProgIDSharePoint.Stssynchandler.3 besitzen und die folgenden Methoden implementieren:
HRESULT GetStssyncAppNameForType([in] BSTR pbstrType, [out, retval] BSTR *pbstrAppName);
HRESULT GetStssyncIconName([out, retval] BSTR *pbstrIconName);
Bevor das Menüelement angezeigt wird, ruft SharePoint Foundation die GetStssyncAppNameForType()-Methode im ActiveX-Steuerelement auf und übergibt den Synchronisierungstyp der aktuellen Liste. Jede Liste besitzt einen Standardsynchronisierungstyp (auf den im Objektmodell unter SPList.SyncType zugegriffen wird), der auf dem Basistyp, der Basisvorlage und der Einstellung basiert, ob Inhaltstypen zulässig sind. Dieser Typ kann als ein Attribut der Listenvorlagendefinition in einem Feature außer Kraft gesetzt werden.
In der Regel vergleicht das ActiveX-Steuerelement den Synchronisierungstyp mit einer Liste der unterstützten Typen und gibt den Namen der Anwendung zurück, in der das Menüelement angezeigt wird. Oder es wird NULL zurückgegeben, wenn der Typ nicht unterstützt wird. Dann wird das Menüelement nicht angezeigt.
Falls ein nicht leerer Anwendungsname zurückgegeben wird, ruft SharePoint Foundation anschließend die GetStssyncIconName()-Methode des Steuerelements auf, um den Dateinamen eines Symbols abzurufen, das im Menüelement angezeigt werden soll. Der zurückgegebene Dateiname wird im Kontextmenü für Dokumentbibliotheksordner verwendet, während das Präfix menu dem Dateinamen hinzugefügt wird, um das Bild abzurufen, das im Menüelement auf der Symbolleiste verwendet wird. Daher sollten Clients zwei Bilder im Bildpfad jedes SharePoint Foundation-Front-End-Webservers installieren. Ein Beispiel: wenn der Dateiname sample lautet, würden die Namen sample.gif und menusample.gif verwendet.
Falls der Browser keine Unterstützung für ActiveX bietet, wird das Menü Verbinden mit… mit einem Standardsymbol angezeigt und es kann vorausgesetzt werden, dass das stssync-Protokoll unterstützt wird.
Wenn auf die Schaltfläche geklickt wird, wird der Browser von JavaScript an eine stssync://-URL mit den richtigen Kontextparametern weitergeleitet. Die URL ist wie folgt formatiert:
stssync://sts/?ver=1.1&type=Type&cmd=add-folder&base-url=WebUrl&list-url=ListUrl&guid=ListId&site-name=SiteName&list-name=ListName
Typ |
Synchronisierungstyp für diese Liste |
|---|---|
ListId |
Listen-ID, ausgedrückt als GUID. |
ListName |
Titel der Liste. Maximal 20 Zeichen. |
ListUrl |
Eine webrelative codierte URL (beginnend und endend mit /) zur Liste. |
SiteName |
Titel der Website, auf der sich die Liste befindet. Maximal 20 Zeichen. |
ViewUrl |
Eine webrelative codierte URL (beginnend mit /) zur Standardansichtsseite der Liste. |
WebUrl |
Eine absolute codierte URL zur Website, auf der sich die Liste befindet. |
Von Dokumentbibliotheken können zwei weitere Parameter am Ende des stssync://-URLs hinzufügt werden, wenn ein Ordner synchronisiert wird:
&folder-url=FolderUrl&folder-id=FolderId
FolderUrl Eine webrelative, nicht codierte URL (beginnend mit /) zum Kontextordner
FolderId Die Element-ID (eine ganze Zahl) des Kontextordners
Siehe auch
Konzepte
GetListItemChangesSinceToken und Synchronisieren von Anwendungen
Weitere Ressourcen
Planen der Browserunterstützung (SharePoint Foundation 2010)