Il ne s’agit pas ici d’expliquer comment faire une colonne personnalisée mais uniquement de discuter des interactions entres champs dans les écrans de saisie SharePoint..

Le cas le plus typique et le plus souvent demandé est la cascading dropdown. Il existe sur internet une solution gratuite que nous avons-nous même utilisé jusqu’au jour où il m’a été demandé de lui ajouter des caractéristiques plus avancées (parents multiples, choix multiples)

J’avais alors le choix soit de partir de cette classe, soit de partir sur une nouvelle conception. Vous l’aurez compris, c’est cette deuxième solution que j’ai choisi. Pourquoi, d’une part il n’était pas aisé d’inclure les nouvelles caractéristiques dans le concept existant. D’autre part, je n’ai jamais aimé le principe d’avoir une colonne parent également personnalisée. Toutefois, pour partie, les deux solutions sont basées sur le même concept. L’idée de base est d’abonner le contrôle de la colonne personnnalisée à un événement du contrôle de rendu d’une autre colonne, personnalisée ou non. Pour mon cas concret, je suis parti sur l’élément « SelectedIndexChange » mais le principe fonctionne sur n’importe quel événement. Evidemment l’événement choisi va déterminer les types de contrôles qui pourront être connectés.

Comme vous le voyez dans le code ci-dessus, il est nécessaire d’activer l’AutoPostBack pour permettre une interaction immédiate. L’élément intéressant dans ce code est l’appel à getParentControl. Cette méthode permet de retrouver un parent sur base du nom du champ et de son type de rendu. Dans mon cas, je cherche spécifiquement une dropdown.

Détaillons maintenant ce code:

La recherche du control de rendu se fait en deux phases, la recherche du champ, ensuite la recherche du control proprement dit. Cette double recherche est nécessaire car aucun élément objectif ne permet de retrouver directement le contrôle au sein de la page. Par contre SharePoint génère non pas uniquement le contrôle de rendu mais toute une hiérarchie de contrôles pour effectuer le rendu des champs et un des niveaux identifie la colonne. La méthode « findField » recherche ce niveau.

Il s’agit d’une méthode récursive qui va parcourir l’arborescence à la recherche d’un élément qui hérite de « BaseFieldControl » et dont le nom correspond à la colonne recherchée. Une fois cet élément trouvé, il devient alors possible de rechercher l’élément de rendu souhaité. N’oubliez pas que le rendu peut être assuré par plusieurs contrôles. La recherche ne peut donc se faire que sur le type.

« findControl » fonctionne de manière identique à « findField ». La seule différence réside dans le type recherché. Il serait d’ailleurs possible de n’utiliser qu’une seule méthode qui prendrait le type en paramètre.

Maintenant, que vous êtes capable de vous connecter à n’importe quel événement de n’importe quelle colonne, il est possible de réaliser une colonne personnalisée capable de réaliser pratiquement n’importe quelle action dynamique telle que cascading drop down, validation dynamique complexe (la colonne personnalisée devenant un gestionnaire d’erreur), un provider pour lire des données externes en relation avec la valeur d’un champ,…

Tout les développeurs SharePoint même débutants connaissent l’obligation de faire un dispose après avoir instancié un objet de type SPSite ou SPWeb.

ou la syntaxe plus commune

Dans de nombreux cas, vous ne devrez pas instancier votre objet mais vous le récupérez dans le contexte.

Dans ce cas, et fort logiquement, il ne faut pas faire de Dispose de l’objet.

Quand est-il si vous récupérez l’objet depuis une collection de type SPWebCollection ? Par exemple la propriété Webs d’un objet SPWeb ou AllWebs d’un objet SPSite.

Malgré le fait qu’il s’agisse d’une référence, la référence porte vers une collection dont les membres ne sont instanciés qu’à la demande. Ce qui est facile à comprendre si on imagine le nombre d’objets de type SPWeb qui serait potentiellement nécessaire d’instancier en même temps. Un dispose s’impose donc.

Ce qui est d’autant plus valable pour un parcours d’une collection

En espérant que ce petit résumé vous aura été utile.

En fait, les objets de type « Document » contiennent une collection nommée ContentTypeProperties. Cette collection contient les propriétés SharePoint.

En C#, le code pour assigner la propriété est alors:

MetaProperty prop = doc.ContentTypeProperties.GetItemByInternalName(« myInternalFieldName »);
if (prop != null) prop.value = « new value »;

Et c’est tout.

doc est un objet de type Word Document .
MetaProperty fait partie de Microsoft.Office.Core

Connecter une propriété SharePoint avec un content control dans un document Word est simple à réaliser, il suffit juste d’ajouter la propriété depuis le menu champ de Quick Part. Dans certains scénari, le lien peut être brisé.

Par exemple, si vous déplacez ou copiez le document d’un site vers un aute, le lien entre la colonne et le champ dans Word est généralement cassé. Dans ce cas, changer la valeur dans l’info panel de Word ne change plus la valeur dans le document même. Pourquoi ?

En interne, dans un fichier xml de votre document (docx), vous pourez trouver une ligne similaire à l’exemple ci-dessous.

L’espace de nom defini est un guid qui référence un object spécific de SharePoint ou le document a été créé.

La solution pour résoudre ce problème est de choisir vous même un espace de nom. Pour ce faire, ajoutez la propriété SourceId dans la définition de votre colonne.

Maintenant, le document peut être déplaçé ou copié sans que le lien ne soit perdu.

subst g: c:\windows\assembly\gac_msil

Une fois les pdb copiés, vous devez, toujours sur le serveur, démarrer le “Visual Studio 2005 remote debugging monitor”.

Dans l’option “Tools” du menu, vous devez donner les permissions à l’utilisateur que exécute Visual Studio sur la machine locale.

Pour retrouver le nom du serveur à utiliser dans Visual Studio, cliquez sur “Options”

Maintenant, vous pouvez aller dans Visual Studio sur votre machine locale.
Ouvrez le fichier ou le projet que vous voulez déboguer.
Cliquez sur “Attach to process”, utilisez le nom du serveur précédemment trouvé dans le champ « qualifier ».
Attachez le processus w3wp.exe. Si vous avez plus d’un processus, attachez les tous pour être sur d’avoir le bon ou recherchez le pid de votre processus en utilisant la commande IISApp sur le serveur.

Maintenant, vous pouvez déboguer.

PS: Je tiens à remercier Wilke Jansoone pour les informations fournies.