Extension de la connexion pour le contrôle

Dernière modification : samedi 1 mai 2010

S’applique à : SharePoint Foundation 2010

L'élément de menu « Connect To… » est extensible afin que n'importe quel client puisse l'utiliser.

Comment vous connecter à l'élément de menu Connect To ? Créez votre contrôle ActiveX, puis indiquez au menu qu'il est là.

Extension de l'élément de menu Connexion

Les applications clientes doivent exécuter deux étapes pour afficher l'élément de menu :

1. Inscrire le gestionnaire de protocole Stssync, protocole. Le protocole stssync vous permet d'ajouter une liste d'événements ou une liste de contacts qui existe sur un site SharePoint Foundation à Microsoft Office Outlook 2003, Office Outlook 2007 ou une application tierce qui prend en charge le protocole.

2. Installer un contrôle ActiveX qui retourne le nom de l'application et un nom de fichier icône.

Le contrôle ActiveX doit avoir un ProgID de SharePoint.Stssynchandler.3 et doit implémenter les méthodes suivantes :

HRESULT GetStssyncAppNameForType([in] BSTR pbstrType,  [out, retval] BSTR *pbstrAppName);
HRESULT GetStssyncIconName([out, retval] BSTR *pbstrIconName);

Avant d'afficher l'élément de menu, SharePoint Foundation appelle la méthode GetStssyncAppNameForType() dans le contrôle ActiveX et transmet le type de synchronisation de la liste active. Chaque liste possède un type de synchronisation par défaut (accessible dans le modèle objet à SPList.SyncType) selon son type de base, son modèle de base et si elle autorise les types de contenu. Ce type peut être remplacé sous la forme d'un attribut de la définition du modèle de liste dans une fonctionnalité.

En général, le contrôle ActiveX vérifie le type de synchronisation par rapport à une liste de types pris en charge et retourne le nom de l'application où l'élément de menu s'affiche, ou retourne la valeur NULL si le type n'est pas pris en charge ; dans ce cas, l'élément de menu n'est pas affiché.

Si un nom d'application non NULL est retourné, SharePoint Foundation appelle alors la méthode GetStssyncIconName() du contrôle pour obtenir le nom de fichier d'une icône à afficher dans l'élément de menu. Le nom de fichier retourné est utilisé dans le menu contextuel pour les dossiers de bibliothèque de documents, tandis que le préfixe « menu » est ajouté au nom de fichier pour obtenir l'image qui est utilisée dans l'élément de menu de la barre d'outils. Par conséquent, les clients doivent installer deux images dans le chemin d'accès des images de chaque serveur frontal Web SharePoint Foundation. Par exemple, si le nom de fichier est « sample », les noms seront sample.gif et menusample.gif.

Si le navigateur ne prend pas en charge ActiveX, le menu « Connexion…» est affiché avec une icône par défaut et vous pouvez supposer que le protocole stssync est pris en charge.

Lorsqu'un clic est effectué sur le bouton, JavaScript redirige le navigateur vers une URL stssync:// avec les paramètres de contexte corrects. L'URL est mise en forme comme suit :

stssync://sts/?ver=1.1&type=Type&cmd=add-folder&base-url=WebUrl&list-url=ListUrl&guid=ListId&site-name=SiteName&list-name=ListName

Type	Type de synchronisation pour cette liste
ListId	Identificateur de liste, exprimé sous la forme d'un GUID.
ListName	Titre de la liste ; la longueur maximale est de 20 caractères.
ListUrl	URL chiffrée relative du site Web (commençant et se terminant par /) pour la liste.
SiteName	Titre du site Web où se trouve la liste ; la longueur maximale est de 20 caractères.
ViewUrl	URL chiffrée relative du site Web (commençant par /) vers la page d'affichage par défaut de la liste.
WebUrl	URL absolue chiffrée vers le site Web où se trouve la liste.

Les bibliothèques de documents peuvent ajouter deux paramètres à la fin de l'URL stssync:// lors de la synchronisation d'un dossier :

&folder-url=FolderUrl&folder-id=FolderId

FolderUrl URL déchiffrée relative du site Web (commençant par /) vers le dossier de contexte

FolderId ID d'élément (entier) du dossier de contexte

Voir aussi

Concepts

GetListItemChangesSinceToken et synchronisation des applications

Autres ressources

Planifier la prise en charge des navigateurs (SharePoint Foundation 2010)