vendredi 20 février 2009

[SharePoint 2007] Récuperer un SPUser à partir de la valeur d'un colonne de type Personne

Pour le développement d'un workflow SharePoint, j'avais besoin de créer dynamiquement une tâche et de l'assigner à un utilisateur sélectionné, via une colonne de type Personne, lors de la création de l'élément qui déclenche mon workflow.

Et là problème: la valeur que je récupère de ma colonne est une chaîne de caractères du type "18;#NOM, Prénom" (l'id du SPUser et le display name).

Or pour assigner ma tâche, j'ai besoin de lui spécifier le login name de l'utilisateur, c'est à dire "DOMAIN\username".

C'est un problème que j'avais déjà rencontré lors du développement d'event handlers.

Voici un petit bout de code qui permet de récupérer l'objet SPUser à partir de la valeur stockée dans une colonne de type Personne:

string columnName = "Nom de ma colonne";
string columnValue = workflowProperties.Item[columnName].ToString();
SPFieldUser userField = (SPFieldUser)workflowProperties.List.Fields.GetField(columnName);
SPFieldUserValue fieldValue = (SPFieldUserValue)userField.GetFieldValue(columnValue);
SPUser user = fieldValue.User;


Ici, je récupère l'objet SPList concernée et la valeur de ma colonne via mes WorkflowProperties, mais dans le cas d'un Event Handler, je les aurai récupérés via les SPItemEventProperties.

Ensuite, avec mon SPUser, je peux récupérer toutes les infos dont j'ai besoin, notamment le LoginName.

mardi 17 février 2009

[SharePoint 2007] Requêtes XPath sur les noeud XML retournés par les WebServices SharePoint

Il peut être très utile dans certains cas de communiquer avec SharePoint en utilisant ses WebServices, depuis une machine en dehors de la ferme par exemple.

Ceux-ci sont relativement simples d'utilisation lorsque vous êtes habitués à utiliser des WebServices et l'essentiel du modèle objet est exposé:
  • Administration
  • Alerts
  • Authentication
  • Copy
  • Document Workspace
  • Forms
  • Imaging
  • List Data Retrieval
  • Lists
  • Meetings
  • People
  • Permissions
  • SharePoint Directory Management
  • Site Data
  • Sites
  • Search
  • Users and Groups
  • Versions
  • Views
  • Web Part Pages
  • Webs
La référence est disponible sur MSDN: http://msdn.microsoft.com/en-us/library/cc752745.aspx

Voici un exemple d'instanciation du WebService Users and Groups:

UserGroup wsUserGroup = new UserGroup();
wsUserGroup.Credentials = System.Net.CredentialCache.DefaultCredentials;
wsUserGroup.Url = mySiteUrl + "/_vti_bin/UserGroup.asmx";


Mais attention ! Les méthodes retournent toutes des objets XmlNode qui sont dépendants de namespace URI.
Donc pour éviter de galérer avec des SelectSingleNode qui retourne null, il est nécessaire de rajouter des préfixes à vos requêtes XPath:

Exemple avec la méthode GetGroupCollectionFromSite() de mon WebService précédemment instancié qui me retourne un XmlNode du type:

<GetGroupCollectionFromSite xmlns=
"http://schemas.microsoft.com/sharepoint/soap/directory/">
<Groups>
<Group ID="3" Name="Group1" Description="Description" OwnerID="1"
OwnerIsUser="False" />
<Group ID="15" Name="Group2" Description="Description"
OwnerID="12" OwnerIsUser="True" />
<Group ID="16" Name="Group3" Description="Description"
OwnerID="7" OwnerIsUser="False" />
</Groups>
</GetGroupCollectionFromSite>


Voici donc une méthode qui déclare toutes les URI utilisées par SharePoint avec des préfixes choisis arbitrairement qui seront utilisés par nos requêtes XPath:

private XmlNodeList RunXPathQuery(XmlNode XmlNodeToQuery, string XPathQuery)
{
// load the complete XML node and all its child nodes into a XML document
XmlDocument Document = new XmlDocument();
Document.LoadXml(XmlNodeToQuery.OuterXml);

// all the possible namespaces used by SharePoint and a randomly choosen prefix
const string SharePointNamespacePrefix = "sp";
const string SharePointNamespaceURI = "http://schemas.microsoft.com/sharepoint/soap/";
const string ListItemsNamespacePrefix = "z";
const string ListItemsNamespaceURI = "#RowsetSchema";
const string PictureLibrariesNamespacePrefix = "y";
const string PictureLibrariesNamespaceURI = "http://schemas.microsoft.com/sharepoint/soap/ois/";
const string WebPartsNamespacePrefix = "w";
const string WebPartsNamespaceURI = "http://schemas.microsoft.com/WebPart/v2";
const string DirectoryNamespacePrefix = "d";
const string DirectoryNamespaceURI = "http://schemas.microsoft.com/sharepoint/soap/directory/";

// now associate with the xmlns namespaces (part of all XML nodes returned
// from SharePoint) a namespace prefix which we can then use in the queries
XmlNamespaceManager NamespaceMngr = new XmlNamespaceManager(Document.NameTable);
NamespaceMngr.AddNamespace(SharePointNamespacePrefix, SharePointNamespaceURI);
NamespaceMngr.AddNamespace(ListItemsNamespacePrefix, ListItemsNamespaceURI);
NamespaceMngr.AddNamespace(PictureLibrariesNamespacePrefix, PictureLibrariesNamespaceURI);
NamespaceMngr.AddNamespace(WebPartsNamespacePrefix, WebPartsNamespaceURI);
NamespaceMngr.AddNamespace(DirectoryNamespacePrefix, DirectoryNamespaceURI);

// run the XPath query and return the result nodes
return Document.SelectNodes(XPathQuery, NamespaceMngr);
}


Je serai donc capable d'executer des requêtes XPath sur mon noeud de la maniere suivante:

XmlNode myNode = wsUserGroup.GetGroupCollectionFromSite();
XmlNodeList myGroupList = RunXPathQuery(myNode, "/d:Groups/d:Group[@ID='16']");
Cet exemple de requête XPath me retourne les noeuds dont l'attribut ID est égale à 16.

Références:
Talk to SharePoint Through its Web Services

vendredi 13 février 2009

[SharePoint 2007] WebPart de sondage




Voici une page sur laquelle vous pouvez télécharger une WebPart permettant d'afficher le formulaire et les résultats d'un sondage.

Cette WebPart se branche sur une liste de type "Enquête" et affiche dans une seule et même zone le questionnaire ou les résultats si l'utilisateur courant a déjà répondu.

Les résultats peuvent être affichés en barre ou en camembert, et sont générés en PNG avec la librairie GDI+ de System.Drawing.

Tout cela est disponible en Setup ou avec les sources C# donc facilement "customizable".

http://darrenjohnstone.net/2008/02/17/sharepoint-quick-surveys/

vendredi 23 janvier 2009

[SharePoint 2007] Le point sur les diverses limitations

Au cours de mes expériences d’intégration de SharePoint en entreprise, j’ai entendu pas mal de sons de cloche différents sur les diverses limitations réelles ou recommandées : nombres de documents par liste, taille de la base de contenu, etc.

Voici quelques éléments pour faire le point:

Tout d’abord, la taille des bases de contenu :

Il n’y a aucune limitation liée à SharePoint, cela dépend juste de la version de SQL Server utilisée :

  • Avec SQL Server 2005 Express, vous avez une limitation dans la taille des bases de 4Go, et 2Go avec la version précédente : MSDE.
  • Avec SQL Server 2005, il n’y a aucune limite à part l’espace disponible sur le disque et les éventuelles contraintes imposées par les DBAs.
Dans la plupart des cas, pour conserver des performances correctes, Microsoft recommande de ne pas dépasser les 100Go pour une base de contenu, comme l'indique ce document publié par l'équipe SharePoint: Performance recommendations for storage planning and monitoring

Pour ce qui concerne les composants SharePoint, voici un article sur technet qui fixe les limites à ne pas dépasser pour garder des performances acceptables, il n’y a aucune limite technique qui soit gravée dans le marbre:

http://technet.microsoft.com/en-us/library/cc262787.aspx

jeudi 22 janvier 2009

[SharePoint 2007] Utiliser l'API pour lister les Web App et les collections de sites d'une ferme

Voici un petit bout de code permettant de lister les Web App d'une ferme, puis pour chaque WebApp, les collections de sites. N'oubliez pas de référencer le namespace Microsoft.SharePoint.Administration.

SPFarm farm = SPFarm.Local;

SPWebService service = farm.Services.GetValue<SPWebService>("");

foreach (SPWebApplication webApp in service.WebApplications)

{

foreach (SPSite site in webApp.Sites)

{

//ici traitement pour chaque collection de site

}

}