Activation du Developer Dashboard

Description du Developer Dashboard

Le Developer Dashboard est une nouvelle fonctionnalité introduite par Microsoft dans SharePoint 2010. Son objectif est d’aider le développeur à déboguer ses pages, à diagnostiquer l’origine de lenteur, etc.

Le Developer Dashboard propose trois niveaux d’affichage :

On : toujours visible
Off : toujours masqué
OnDemand: s’ouvre/se ferme à la demande

Le Developer Dashboard peut également être restreint aux utilisateurs en appliquant un masque de permission (du type SPBasePermissions). La plupart du temps on mettra FullMask, car c’est très orienté développeur (qui a la plupart du temps tous les droits sur le poste de développement).

Plus de détails sur la page MSDN Using the Developer Dashboard.

Activer le Developer Dashboard

Plusieurs possibilités s’offrent à vous pour activer le Developer Dashboard : Continue reading

Rating 5.00 out of 5

[?]

SharePoint Developer Toolbox: présentation du projet

This entry is part 1 of 1 in the series SharePoint Developer Toolbox

Après quelque mois de non activité dans ce blog, me revoilà 🙂 Il faut que mes priorités avait un peu changé (ma belle et mes petits bouts).

Je redémarre cette année 2012 en préparant un petit projet utile aux développeurs : SharePoint Developer Toolbox.

L’objectif de ce projet est double :

fournir à la communauté des outils/extensions orienté développement
explorer certains concepts à des fins didactiques.

D’ailleurs vous verrez que ce projet est souvent du genre à “donner du lard aux cochons”. Sur un poste de développement, on peut se permettre de bidouiller des fichiers, patcher des web.configs, etc. Je choisis toutefois une approche ultra clean, histoire de savoir comment faire pour des sujets plus rigoureux que des outils de développements.

Le projet est open-source, et hébergé sur github: Hand.SharePoint.DeveloperToolbox.

Je vous invite à forker le projet et ajouter/modifier ce qui vous semble pertinent (vive Github!).

D’autres posts vont suivrent, qui mettront le focus sur les fonctionnalités au fur et à mesure de leur apparition.

Rating 5.00 out of 5

[?]

SharePoint : RunWithElevatedPrivileges, attention à la portée des variables

Lorsque votre code SharePoint doit exécuter des actions pour lesquelles l’utilisateur n’a pas les droits, vous pouvez utiliser la méthode SPSecurity.RunWithElevatedPrivileges. Cette dernière attend un delegate en argument. Le delegate est alors appelé sans restriction d’autorisation, au lieu de brider les appels aux autorisations de l’utilisateur connecté. Bien entendu à utiliser avec précaution, pensez à bien verrouiller la portée de votre code.

Toutefois, l’utilisation de cette méthode peut amener quelques surprise. Par exemple, j’ai sur un de mes site SharePoint un groupe dont l’option “Qui peut consulter l’appartenance au groupe?” est positionnée sur “Membres du groupe”. Ainsi, un utilisateur non administrateur ne peut consulter les membres de ce groupe. Si dans votre code, vous devez découvrir les membres de ce groupe (on peut imaginer un scénario ou on a un groupe de personne responsable d’une étape de workflow, sans que les utilisateurs les connaissent), vous écrirez naturellement le code suivant : Continue reading

Rating 3.50 out of 5

[?]

SharePoint : changement rapide du port d’administration centrale

Lors de l’installation (en mode graphique), le port de l’administration centrale est définit de manière aléatoire. Vous pouvez le changer si vous choisissez l’installation “Serveur Web frontal” ou “Complète”. En mode “autonome”, il n’est tout simplement pas possible de le choisir au moment de l’installation.

Personnellement, entre mes machines de développement, mes machines de production au bureau, les environnements clients (dev, pré-prod, prod, etc.), j’ai choisi d’uniformiser le numéro de port pour l’administration centrale.

Il est possible très simplement et très rapidement de changer ce port. Voici la procédure. Je rappelle qu’il ne faut bien évidement pas changer le port dans IIs sous peine de délier la configuration connue par SharePoint et la configuration réelle (message à passer à vos clients… tous les admins chez les clients ne sont pas au fait de cette règle).

Bref, voici les commandes magiques pour opérer : Continue reading

Rating 5.00 out of 5

[?]

Wiki SharePoint 2010: liens entrants toujours visibles

Pour un site Wiki qui fonctionne avec SharePoint 2010, j’ai eu besoin d’afficher sur toutes les pages les liens entrants, sans avoir besoin d’aller dans le ruban->page->afficher les liens entrants.

La solution la plus simple que j’ai trouvée est de modifier la page de disposition EnterpriseWiki.aspx avec SharePoint Designer (la modification ne sera valable que sur ce site Wiki).

Ajoutez ce bloc de code, au dessus du menu “Catégories” (par exemple):

<div class="ewiki-slink">
    <div>
        <b>
            <SharePoint:EncodedLiteral runat="server" text="<%$Resources:wss,incoming_links%>" EncodeMethod='HtmlEncode'/>
        </b>
        <div>
            <SharePoint:FormComponent TemplateName="BackLinksDisplay" ControlMode="Display" runat="server"/>
        </div>
    </div>
    <div>
        <b>
            <SharePoint:EncodedLiteral runat="server" text="<%$Resources:cms,enterwiki_pagerating%>" EncodeMethod="HtmlEncode"/>
        </b>
    <div>
        <SharePointPortalControls:AverageRatingFieldControl FieldName="5a14d1ab-1513-48c7-97b3-657a5ba6c742" runat="server"/>
    </div>
</div>

<div>

<b>

<SharePoint:EncodedLiteral runat="server" text="<%$Resources:wss,incoming_links%>" EncodeMethod='HtmlEncode'/>

</b>

<div>

<SharePoint:FormComponent TemplateName="BackLinksDisplay" ControlMode="Display" runat="server"/>

</div>

<div>

<b>

<SharePoint:EncodedLiteral runat="server" text="<%$Resources:cms,enterwiki_pagerating%>" EncodeMethod="HtmlEncode"/>

</b>

<div>

<SharePointPortalControls:AverageRatingFieldControl FieldName="5a14d1ab-1513-48c7-97b3-657a5ba6c742" runat="server"/>

</div>

Ce bloc est issu directement du fichier BackLinks.aspx situé dans le dossier Layouts. Le premier contrôle affiche le libellé “Les pages suivantes mènent à cette page :” (dans la langue de l’utilisateur) et le second est le contrôle qui affiche les liens entrant.

Le résultat est alors le suivant :

Backlinks wiki toujours visibles

A noter que la page d’accueil, par défaut, utilise la disposition “Page de projet de base”. Les backlinks n’apparaitrons pas si vous conservez cette disposition, à moins de répéter la manœuvre pour ce fichier.

<div class=”ewiki-slink”>
<div>
<b>
<SharePoint:EncodedLiteral runat=”server” text=”<%$Resources:wss,incoming_links%>” EncodeMethod=’HtmlEncode’/>
</b>
<div>
<SharePoint:FormComponent TemplateName=”BackLinksDisplay” ControlMode=”Display” runat=”server”/>
</div>
</div>
<div>
<b>
<SharePoint:EncodedLiteral runat=”server” text=”<%$Resources:cms,enterwiki_pagerating%>” EncodeMethod=”HtmlEncode”/></b>
<div>
<SharePointPortalControls:AverageRatingFieldControl FieldName=”5a14d1ab-1513-48c7-97b3-657a5ba6c742″ runat=”server”/></div>
</div>

Rating 2.50 out of 5

[?]

SharePoint 2010: Console PowerShell à distance

Beaucoup d’opérations de maintenance avec SharePoint 2010 s’effectuent depuis une console PowerShell. Voici la marche à suivre pour créer une console PowerShell sur votre Poste, plutôt que d’avoir à vous connecter sur le serveur. Continue reading

Rating 3.50 out of 5

[?]

Concours de développement Windows Phone 7 organisé par Microsoft

Microsoft organise un concours de développement autour de la plateforme Windows Phone 7 afin de promouvoir cette dernière.

Les gagnants pourront présenter leur application à un jury composé notamment de Steve Ballmer himself.

Plusieurs téléphones seront également mis en jeu pour les participants les plus productifs.

Toutes les infos sur cette page : Compétition Windows Phone 7.

A vos claviers !

Rating 4.33 out of 5

[?]

SharePoint : AllowUnsafeUpdate simplifié

Voici une petite classe d’extension qui permet d’avoir une gestion plus simple de la propriété AllowUnsafeUpdate de la classe SPWeb :

using System;
using Microsoft.SharePoint;

namespace Hand.Net.SharePoint.Extensions {
	public static class SPWebExtensions {
		public static IDisposable CreateUnsafeCodeAllowedBlock(this SPWeb web) {
			return new UnsafeCodeBlock(web);
		}

		private class UnsafeCodeBlock: IDisposable {
			private SPWeb m_Web;
			private bool m_AllowUnsafeUpdateBackup;
			public UnsafeCodeBlock(SPWeb web) {
				this.m_Web = web;
				this.m_AllowUnsafeUpdateBackup = web.AllowUnsafeUpdates;
				this.m_Web.AllowUnsafeUpdates = true;
				this.m_Web.Update();
			}

			#region IDisposable Members

			public void Dispose() {
				if (!m_AllowUnsafeUpdateBackup) {
					m_Web.AllowUnsafeUpdates = false;
					m_Web.Update();
				}
			}

			#endregion
		}
	}
}

using System;

using Microsoft.SharePoint;

namespace Hand.Net.SharePoint.Extensions {

public static class SPWebExtensions {

public static IDisposable CreateUnsafeCodeAllowedBlock(this SPWeb web) {

return new UnsafeCodeBlock(web);

}

private class UnsafeCodeBlock: IDisposable {

private SPWeb m_Web;

private bool m_AllowUnsafeUpdateBackup;

public UnsafeCodeBlock(SPWeb web) {

this.m_Web = web;

this.m_AllowUnsafeUpdateBackup = web.AllowUnsafeUpdates;

this.m_Web.AllowUnsafeUpdates = true;

this.m_Web.Update();

}

#region IDisposable Members

public void Dispose() {

if (!m_AllowUnsafeUpdateBackup) {

m_Web.AllowUnsafeUpdates = false;

m_Web.Update();

}

#endregion

}

L’idée est de détourner l’utilisation de l’interface IDisposable pour pouvoir utiliser un bloc “using” :

var web = SPContext.Current.Web;

using(web.CreateUnsafeCodeAllowedBlock())
{
	// opérations nécessitant des mises à jour &quot;unsafe&quot;
}

var web = SPContext.Current.Web;

using(web.CreateUnsafeCodeAllowedBlock())

{

// opérations nécessitant des mises à jour "unsafe"

}

Trois avantages à ce pattern :

c’est plus lisible qu’une succession d’appels à la propriété AllowUnsafeUpdate et à la méthode Update()
en cas d’exception, la méthode Dispose est garantie d’être appelée… on s’épargne un Finnaly
le code gère l’état avant appel de la propriété AllowUnsafeUpdate en la sauvegardant.

On pourrait aussi imaginer l’utilisation d’une méthode qui reçoit un délégué, mais je trouve qu’est c’est un petit peu lourd à appeler par rapport au using.

Rating 3.00 out of 5

[?]

SharePoint : ajouter un webpart depuis une feature ?

Pour un de mes clients, j’ai été confronté à la difficulté suivante : comment, depuis une feature, instancier un web part sur la page d’accueil ?

En effet, un de mes features fournit web part spécifique, et je souhaite, à l’activation de la feature, qu’un exemplaire de ce dernier soit disponible sur la page d’accueil.

Tout aurait été simple si je déployait un nouvelle page. En effet, lorsque vous déployez une page, vous le faite via un module. Et dans un module, vous définissez un fichier à déployer :

<Module Name="Dashboard"
 SetupPath="sitetemplates\sts"
 Url="">
    <File Url="Dashboard.aspx"
          Path="default.aspx"
          Type="Ghostable">
        <AllUsersWebPart WebPartOrder="1"
 WebPartZoneID="Right">
            <![CDATA[
<WebPart xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/WebPart/v2">
 <Title>Besoin d'aide ?</Title>
 <FrameType>Standard</FrameType>
 <Assembly>Microsoft.SharePoint, Version=12.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c</Assembly>
 <TypeName>Microsoft.SharePoint.WebPartPages.ContentEditorWebPart</TypeName>
 <ContentLink xmlns="http://schemas.microsoft.com/WebPart/v2/ContentEditor" />

<Content xmlns="http://schemas.microsoft.com/WebPart/v2/ContentEditor">
exemple de contenu </Content>
 <PartStorage xmlns="http://schemas.microsoft.com/WebPart/v2/ContentEditor" />
 </WebPart>
 ]]>
        </AllUsersWebPart>

    </File>
</Module>

<Module Name="Dashboard"

SetupPath="sitetemplates\sts"

Url="">

<File Url="Dashboard.aspx"

Path="default.aspx"

Type="Ghostable">

<AllUsersWebPart WebPartOrder="1"

WebPartZoneID="Right">

<![CDATA[

<Title>Besoin d'aide ?</Title>

<FrameType>Standard</FrameType>

<Assembly>Microsoft.SharePoint, Version=12.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c</Assembly>

<TypeName>Microsoft.SharePoint.WebPartPages.ContentEditorWebPart</TypeName>

exemple de contenu </Content>

</WebPart>

]]>

</AllUsersWebPart>

</File>

</Module>

Ici le noeud “AllUsersWebPart” permet d’ajouter un webpart à un page que vous êtes entrain de déployer. Comment faire alors pour une page existante, comme par exemple le fichier default.aspx ? Continue reading

Rating 3.50 out of 5

[?]

SharePoint : un web part qui ne s’affiche qu’avec certaines permissions ?

Voici un petit peu de code qui vous aidera à créer un WebPart qui ne s’affiche que si on dispose de certaines autorisations.

L’exemple typique est l’ajout d’un menu “gestionnaire” qui affiche certaines opérations/liens.

Ici, je vous montre un webpart qui permet d’afficher un lien vers un tableau de bord (dashboard.aspx) seulement si l’utilisateur connecté dispose de l’autorisation demandée :

using System;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;
using Microsoft.SharePoint;

namespace MyWebPartProject
{
 public class DashBoardLinkWebPart: Microsoft.SharePoint.WebPartPages.WebPart
 {
 protected HyperLink m_dashBoardLink;

 [WebBrowsable(true)]
 [WebDescription(&quot;Indique les permissions nécessaires pour afficher ce web part&quot;)]
 [WebDisplayName(&quot;Permissions requises&quot;)]
 [Personalizable(PersonalizationScope.Shared)]
 public SPBasePermissions RequiredPermissions { get; set; }

 protected override void OnLoad(EventArgs e)
 {
 var web = SPContext.Current.Web;
 // On détermine ici si on affiche le webpart ou non.
 this.Hidden = !web.DoesUserHavePermissions(RequiredPermissions);
 }
 protected override void CreateChildControls()
 {
 this.Controls.Add(m_dashBoardLink = new HyperLink());

 m_dashBoardLink.Text = &quot;Ouvrir le tableau de bord&quot;;
 m_dashBoardLink.NavigateUrl = SPContext.Current.Web.Url.TrimEnd('/') + &quot;/dashboard.aspx&quot;;
 }
 }
}

using System;

using System.Web.UI.WebControls;

using System.Web.UI.WebControls.WebParts;

using Microsoft.SharePoint;

namespace MyWebPartProject

{

public class DashBoardLinkWebPart: Microsoft.SharePoint.WebPartPages.WebPart

{

protected HyperLink m_dashBoardLink;

[WebBrowsable(true)]

[WebDescription("Indique les permissions nécessaires pour afficher ce web part")]

[WebDisplayName("Permissions requises")]

[Personalizable(PersonalizationScope.Shared)]

public SPBasePermissions RequiredPermissions { get; set; }

protected override void OnLoad(EventArgs e)

{

var web = SPContext.Current.Web;

// On détermine ici si on affiche le webpart ou non.

this.Hidden = !web.DoesUserHavePermissions(RequiredPermissions);

}

protected override void CreateChildControls()

{

this.Controls.Add(m_dashBoardLink = new HyperLink());

m_dashBoardLink.Text = "Ouvrir le tableau de bord";

m_dashBoardLink.NavigateUrl = SPContext.Current.Web.Url.TrimEnd('/') + "/dashboard.aspx";

}

L’astuce consiste à utiliser la propriété Hidden du WebPart plutôt que la propriété Visible. Si vous essayez de modifier cette dernière, vous aurez une erreur du genre :

[text]The Visible property cannot be set on Web Part XXXX. It can only be set on a standalone Web Part[/text]
Après déploiement du webpart, vous pouvez le poser sur une page de composant WebPart classique. Dans les propriétés de ce WebPart, dans la catégorie Divers, la sélection de l’autorisation nécessaire s’affiche :

Il suffit alors de sélectionner la permission requise pour afficher le web part.

Ce code est simpliste et ne sert qu’à montrer le principe. En production, on créera le webpart avec des règles métiers qui déterminent l’affichage, ou alors avec un ToolPart plus ergonomique, etc.

A noter que le webpart ici ne sécurise en rien la cible du lien… il ne fait qu’afficher ou non un lien !

Rating 3.00 out of 5

[?]

Have A Nice Day.Net

Have A Nice Day.Net

SharePoint, .Net, et autres questions existentielles

Author: Steve

Activation du Developer Dashboard

Description du Developer Dashboard

Activer le Developer Dashboard

SharePoint Developer Toolbox: présentation du projet

SharePoint : RunWithElevatedPrivileges, attention à la portée des variables

SharePoint : changement rapide du port d’administration centrale

Wiki SharePoint 2010: liens entrants toujours visibles

SharePoint 2010: Console PowerShell à distance

Concours de développement Windows Phone 7 organisé par Microsoft

SharePoint : AllowUnsafeUpdate simplifié

SharePoint : ajouter un webpart depuis une feature ?

SharePoint : un web part qui ne s’affiche qu’avec certaines permissions ?