Thursday, February 26, 2009

Bug on XML Site definition

On a Onet.xml Site definition, we wanted to set the RowLimit (http://msdn.microsoft.com/fr-fr/library/ms428643.aspx) for announcement list. So we set :

<View List="$Resources:core,lists_Folder;/$Resources:core,announce_Folder;"
BaseViewID="0"
WebPartZoneID
="Left">
<RowLimit Paged="TRUE">5</RowLimit>
</View>


but, it didn't work...WTF??

How sweet it is when you try to use a "standard" attribute and when you realize that...Gasp It hasn't been implemented By MS (That was the real answer that they gave us!)

We have spent a few days on this bug, so I just blog it hoping that the one who is looking for solution find it!! There is no solutions but creating a feature that will replace the announcementList feature. This feature that you can call "CustomeAnnouncementList" will be a copy/Paste of the basic Anouncement List feature amended (in the element.xml file) with the rowlimit attribute inside. Then you have to activate this feature on all sites. Bingo! Of course, if you don't want to see 2 anouncement list in your available lists, you will also have to deactivate the old feature.

Cheers & Good luck

Wednesday, February 25, 2009

Dynamically creat a SPView with checkbox that will be display in a dynamically created ListViewe

Hi,

My problem was this one :

"I need to display on a specific page the default view of a list, BUT beside each items of this list must be displayed a checkbox in order to be able to select items on this list"
huuu....
The solution I chose was to recreate a clone of the defaultview that will never be displayed to the users but that will be selected as SPView of the ListView I create on my page.
Here we go...

1/ My Page takes in parameter the ID of the list I'm working on, i call the parameter "List":
Guid ListId = new Guid(this.Page.Request["List"]);
2/ Then whenever I reach the page, i check whether the view already exists, if not i create it cloning the default view and adding to it a checbox field. If the clone of the actual defaultview exists i just use it! Easy! In my code below, the listview object is called Select_List




bool creatingView = false;
SPView newView = null;
SPSecurity.RunWithElevatedPrivileges(delegate()
{
using (SPSite Mysite = new SPSite(siteID))
{
SPWeb MyWeb = Mysite.OpenWeb(webID);
MyWeb.AllowUnsafeUpdates = true;
SPList MyList = MyWeb.Lists[ListId];
foreach (SPView view in MyList.Views)
{
if (view.Title.Equals(MyList.DefaultView.Title+ "_CloneForSelect"))
{
newView = view;
}
}
if (newView == null)
{
if (!MyList.Fields.ContainsField("Select"))
{
MyList.Fields.AddFieldAsXml("<Field Type=\"Computed\" ReadOnly=\"TRUE\" Name=\"ListItemSelection\" DisplayName=\"Select\" Sortable=\"FALSE\" Filterable=\"FALSE\" EnableLookup=\"FALSE\" SourceID=\"http://schemas.microsoft.com/sharepoint/v3\" StaticName=\"ListItemSelection\">" +"<FieldRefs> <FieldRef Name=\"ID\" /> </FieldRefs>" + "<DisplayPattern> <HTML><![CDATA[<input id=\"chk_select]]></HTML><Column Name=\"ID\" HTMLEncode=\"TRUE\" /><HTML><![CDATA[\" name=\"chk_select\" type=\"checkbox\" ]]></HTML>" + "<HTML><![CDATA[LItemId=\"]]></HTML>" + "<Column Name=\"ID\" HTMLEncode=\"TRUE\" />" + "<HTML><![CDATA[\"/> ]]></HTML>" + "</DisplayPattern></Field>");
}
SPFieldComputed fieldComp = (SPFieldComputed)MyList.Fields["Select"];
newView = MyList.DefaultView.Clone(MyList.DefaultView.Title + "_CloneForSelect", 1000, true, false);
newView.Hidden = true;
newView.Scope = SPViewScope.FilesOnly;
newView.ViewFields.Add(fieldComp);
newView.Update();
creatingView = true;
}
MyWeb.Dispose();
}
});
if (!creatingView)
{
Select_List.ViewId = newView.ID.ToString();
}
else
{
Response.Write("");
}
Select_List.ListId = this.Page.Request["List"];
Now, let me explain the code a little bit.

1/ How to create a column Checkbox in a list?

It's quite tricky cause you must create the column using a CAML definition.


 if (!MyList.Fields.ContainsField("Select"))
{
MyList.Fields.AddFieldAsXml("<Field Type=\"Computed\" ReadOnly=\"TRUE\" Name=\"ListItemSelection\" DisplayName=\"Select\" Sortable=\"FALSE\" Filterable=\"FALSE\" EnableLookup=\"FALSE\" SourceID=\"http://schemas.microsoft.com/sharepoint/v3\" StaticName=\"ListItemSelection\">" +"<FieldRefs> <FieldRef Name=\"ID\" /> </FieldRefs>" +
"<DisplayPattern> <HTML><![CDATA[<input id=\"chk_select]]></HTML><Column Name=\"ID\" HTMLEncode=\"TRUE\" /><HTML><![CDATA[\"
name=\"chk_select\" type=\"checkbox\" ]]></HTML>"
+
"<HTML><![CDATA[LItemId=\"]]></HTML>" +
"<Column Name=\"ID\" HTMLEncode=\"TRUE\" />" +
"<HTML><![CDATA[\"/> ]]></HTML>" + "</DisplayPattern></Field>");
}
Sorry for the "+" but it's for my code lisibility! In fact you just create a field where the display is an HTML input component !!
2/ OK, but now, i have the display How do I get my checkboxes values after postback ?
Well, let's continue to be tricky!! I just create two Hidden field on my page

<asp:HiddenField runat="server" id="listSrv_items" />
<asp:HiddenField runat="server" id="checked_ids" />
And on my validation button i fill it before validation using a JS function called fill_ids


<asp:Button ID="Btn_valid" OnClientClick="fill_ids();" OnClick="Btn_valid_Click" runat="server"/>
The js function simply puts inside the listSrv_Items the ids of each item in the list, and checked_ids will finally contain the list of items ids that are checked.

here we go for the js that i manually add to the page in the render method:


protected override void Render(HtmlTextWriter writer)
{
this.ClientScript.RegisterClientScriptBlock(this.GetType(), "MyScript", @"
<script>
function fill_ids()
{
var items= document.getElementById('"
+ listSrv_items.ClientID + @"').value;
var checkedIds= document.getElementById('"
+ checked_ids.ClientID + @"');
checkedIds.value='';
var SParray = items.split(';');
for (ix=0; ix< SParray.length-1; ix++)
{
var item = document.getElementById("
"chk_select""+SParray[ix])
if (item!=null && item.checked)
{
checkedIds.value += SParray[ix] + ';';
}
}
if (checkedIds.value.length>0)
checkedIds.value = checkedIds.value.substr(0,checkedIds.value.length-1);
}
</script>"
);
listSrv_items.Value = "";
foreach (SPListItem item in _rootList.Items)
{
listSrv_items.Value += item.ID + ";";
}
}
Now my field checked_Ids will contain the ids of my checked items so in my Btn_valid_Click; i just have to use it to do anything I want! That's it!

Get SPList.ID From URL

I often face a problem : I have an URL, and I would like to get the list pointed by this URL. So I wanted a function that could return me this ID whenever I was passing an URL to it!

Some Regexp, some recursivity and here we are :



public SPList getListFromUrl(string url)
{
try
{
if (!url.EndsWith("/")) url = url + "/";
//match list
Regex listExpReg = new Regex("(?.+)\\/Sites\\/(?.+)\\/Lists\\/(?.+)\\/.*", RegexOptions.IgnoreCase);
if (listExpReg.IsMatch(url))
{
Match siteMatch = listExpReg.Match(url);
String racine = siteMatch.Groups["Racine"].Value;
String siteToFind = siteMatch.Groups["Sites"].Value;
String listeToFind = siteMatch.Groups["LName"].Value;
String[] splitedSiteList = siteToFind.Split('/');
SPSite rootsite = new SPSite(racine + "/Sites/" + splitedSiteList[0]);
if (rootsite != null)
{
using (SPWeb webNavigated = rootsite.RootWeb)
{
foreach (string s in splitedSiteList)
{
if (s != splitedSiteList[0])
{
SPWeb TempWeb = webNavigated.Webs[s];
webNavigated = TempWeb;
TempWeb.Dispose();
}
}
SPList listsearched = webNavigated.GetList(url);
_destinationWeb = webNavigated;
rootsite.Dispose();
}
return listsearched;
}
else
{
return null;
}
}
else
return null;
}
catch (Exception exc)
{
//BUUUUUUUUP
}
}
The function basically return null if the URL passed is not a list URL, and return the list ID whenever you pass an URL to it. It also works when you pass the url containing some allitems.aspx after the name of the list...
Try it!
Hope it helps

Tuesday, February 24, 2009

Rebrand SharePoint Error using HTTPModule and add this HttpModule to SharePoint web.config

I have found on several website a part of the answer...

But I have never really found a full answer. I'm gonna try to give a full one!

First, be aware, that there are many ways to catch the SharePoint errors, but to my knowledge, only this one is fully supporter by Microsoft, cause it uses an HTTPModule which is a supported way of working!

1/ Create your HTTPModule
The class you are about to create inherits System.Web.IHttpModule

During the Init of the module, add an event handler that will listen to the Error. It should be something like



public void Init(HttpApplication Context)
{
Context.Error += new EventHandler(Application_Error);
}

And now declare your event handler function:



public void Application_Error(object sender, EventArgs e)
{
HttpContext Context = HttpContext.Current;
Exception MyExc;
for (MyExc= Context.Server.GetLastError();
exception.InnerException != null;
exception = exception.InnerException) { }
String errorCode = DateTime.Now.ToString("ddMMyyyy-HHmmfff");
String errorMessage = MyExc.Message.ToString();
String errorStackTrace = MyExc.StackTrace.ToString();
HttpContext.Current.Server.ClearError();
HttpContext.Current.Response.Clear();
HttpContext.Current.Application.Clear();
HttpContext.Current.Application.Add("LastException", MyExc);
HttpContext.Current.Application.Add("ErrorMessage", errorMessage);
HttpContext.Current.Application.Add("ErrorCode", errorCode);
HttpContext.Current.Application.Add("ErrorStackTrace", errorStackTrace);
((System.Web.HttpApplication)(sender)).Response.Redirect("/_layouts/ErrorBranding/MyErrorHandler.aspx");
}

I was basically doing it differently, using an arrey of AllErrors, but it didn't give always the good exception, so I used a part of the code created by Anupam Ranku on his blog http://www.codeproject.com/KB/sharepoint/Handling_Error_Centrally.aspx.
From him, I took the fact that using


for (MyExc= Context.Server.GetLastError();exception.InnerException != null;exception = exception.InnerException) { }
I was directly going to the first innerexception. Simple and efficient !!!

2/ Create an Error page
On the Page_Load of this page, just verify that the last exception exists


if (!Page.IsPostBack)
{
if (HttpContext.Current.Application.Get("LastException") != null)
{
//your handler
}
}

In this page, you can use your already defined
HttpContext.Current.Application.Get("errorCode");
HttpContext.Current.Application.Get(
"errorMessage");
HttpContext.Current.Application.Get(
"errorStackTrace");

Design your page the way you want it to be!

3/ Modify your web.config
For this, let's assume that you have created a feature, and you have already a classe inheriting
SPFeatureReceiver.


So of course you have already created your 4 overidden functions (
FeatureActivated,
FeatureDeactivating,
FeatureInstalled,
FeatureUninstalling
)


The FeatureActivated method will be launched after activation of the feature (smart name for a method that do so!!!), so what you want to do is to add your http module to the web.config (Carreful: it must be added to ALL the web servers of your farm), to do this let's use this :


private string _OWNER = "FTErrorBranding";
private string httpModuleValue = "MyNamespace.MyClass, MyAssembly, Version=1.0.0.0, Culture=neutral, PublicKeyToken=bce1c40c0905a9da";
public override void FeatureActivated(SPFeatureReceiverProperties properties)
{
try
{
SPWebApplication webApp = properties.Feature.Parent as SPWebApplication;
webApp.WebConfigModifications.Clear();
AddNewHttpModule(webApp.WebConfigModifications, "ErrorCustomization", httpModuleValue);
webApp.Update();
webApp.Farm.Services.GetValue().ApplyWebConfigModifications();
}
catch (Exception ex)
{
throw new Exception(ex.Message);
}
}
What is this AddNewHttpModule function?? Calmos papillons! it's coming!

private void AddNewHttpModule(Collection allModifications, string name, string value)
{
SPWebConfigModification modification = new SPWebConfigModification(string.Format
("add[@name='{0}']", name), "configuration/system.web/httpModules");
modification.Type = SPWebConfigModification.SPWebConfigModificationType.EnsureChildNode;
modification.Owner = _OWNER;
modification.Value = string.Format(CultureInfo.InvariantCulture, string.Format("", name, value));
if (allModifications.Contains(modification))
{
allModifications.Remove(modification);
}
allModifications.Add(modification);
}
So this method basically add to the web.config the HttpModule you just created... BUT... one last thing but not the least... This SPWebConfigModification is something really interesting...with one limit, it only add the Modification at the end of the list and for error handling, the httpmodule you enter must be put at the beginning of the httpmodule section of the web.config.... So far, I didn't manage to do it programmatically....so manually, i have to go inside each web.config to cut/paste the new line... (sigh)....

To conclude, See the image of my VS project, in order to understand the wya the project is built (I'm addicted to WSPBuilder!)












4/ Addendum -April 2009 - Catch WebParts Error

So far, the feature worked almost perfectly. I only add one issue with Webpart errors. SharePoint, on the error page sometime add a link to go to the Webpart management page. The HttpModule can't see the difference between those kind of errors and others...(until now) !!

I have added a function in the httpModule that recognize whether an exception has been thrown from a webpart or not... here it is!

private bool IsWebPartOnExceptionStack(Exception e)
{
StackTrace trace = new StackTrace(e);
int index = 0;
while (index <>
{
Type declaringType = trace.GetFrame(index).GetMethod().DeclaringType;
if (!typeof(WebPart).IsAssignableFrom(declaringType))
{
index++;
continue;
}
else
return true;
}
}
}

At the end of the Application_Error method, just add a new Application variable :
HttpContext.Current.Application.Add("ISWPError", IsWebPartOnExceptionStack(exception));

In your error page, you just have to add a if then else, to manage this case.