CodeClimber

Orchard Harvest Conference in Europe: 13-14 June in Amsterdam

Simone Chiaretta — Wed, 29 May 2013 14:27:45 GMT

In the same week of the Umbarco CodeGarden in Copenhagen, the Orchard CMS project is having its first pan-European Orchard Harvest Conference 2013. June 13 - 14th, 2013 (Thursday - Friday).

The event will be held in Amsterdam, Netherlands at the wonderful Tobacco Theater. We are very excited about this event and look forward to welcoming members of the Orchard Project open source community from across Europe as well as from around the globe.
For more information about the event:
Orchard Harvest - European Conference 2013

Orchard Harvest sessions are focusing on best practices, conversations with core contributors, module development, Web design, as well as several success stories with high volume Web sites and yes – social activities!

You can register on eventbrite.

Orchard is a free, open source, community-focused Content Management System built on the ASP.NET MVC platform already powering sites of many major brands and organizations. Originally created by Microsoft, it is now maintained by the Outercurve Foundation, a non-profit and IP-neutral open source software foundation.

If you haven’t tried Orchard already and would like to join its growing community of users, the current version 1.6 release may be downloaded at: http://www.orchardproject.net/download

Orchard also allows you to build custom modules. It is designed for extensibility with tools that allow developers and customizers to provide additional functionality through modules and themes. An ecosystem of add-ons is forming around Orchard, with over 500 modules and themes available on the gallery, and over 4,000,000 total downloads.

The critical mass of community support that’s forming behind the project has empowered contributors to build extensive new functionality. Version 1.7, which is due in June, introduces a streamlined media manager that integrates slideshows and the ability to easily upload and manage digital content. It will also feature a significant new workflow module to manage publishing tasks that is graphical editor, which is also extensible.

Tags: Orchard, CMS

Finally moved my blog to Azure Web Sites

Simone Chiaretta — Tue, 28 May 2013 09:45:46 GMT

Over the last few years I had to move my blog through different hosting providers, and when in March my last hosting, EpicWin Hosting, closed business with only one month of notice I decided that I had enough of small hosting providers run by people I know, so I decided to finally make the big step and move to Azure.

Unfortunately this happened during a moment in which my life is going through some big changes, and I didn’t have time and brain-power to put all my efforts into the migration, so you might have noticed that my blog was down between end of March (when the hosting closed) till last week.

The down was due to a strange problem with database access permissions on my SQL Server on Azure. Well… strange for me that used Azure for the first time, maybe it’s how SQL Server on Azure it’s supposed to work.

Another issue I had was with the mapping of domains to web sites, keeping both example.com and www.example.com pointing to same web site.

The SQL Server user permissions problem

The migration from the on-premise database to azure SQL Server went very smoothly: I installed the SQL Database Migration Wizard on my VM, setup firewall rules on Windows Azure, ran the wizard and all tables and data were moved to the newly created DB on Azure. For a step by step procedure, I recommend reading Migrating a SQL Server database to SQL Azure by Tim Heuer: it’s from last year, and many steps are not necessary any more, but it’s a good overview of the process.

The problem started when I tried accessing my blog: I was getting an user access error from the database, despite having configured the connection string correctly, and being able to access the database both via the online DB manager, and from my local Management Studio.

After some attempts, emails with some Azure MVPs, and lots of frustration I quitted the challenge and let the blog down for a few weeks. I went back to try and solve the problem last week, and finally solved the problem.

I had put in the connection string the username of the administrator account of the my server on Azure, which I though would have had access to all the DBs in the server, like the sa user does on a normal SQL Server. Unfortunately that was not the case: I had to create another server login, and a new user inside my database and grant him dbo rights. More information on SQL Azure user management can be found on MSDN: Managing Databases and Logins in Windows Azure SQL Database.

After that, the blog started running without any issue: no change in Subtext code or SPs. If it hadn’t been for that silly problem with the DB user, migration from on-premise to Azure WebSites would have been completed in less than 2hrs.

Mapping custom domains to windows azure web sites

Mapping a custom domain to an Azure website is pretty easy: just create a CNAME that points to mysite.azurewebsites.net and everything works fine.

www.example.com 21600 IN CNAME mysite.azurewebsites.net

But if you also want to configure the non-www things become more complicate, because you cannot just create a CNAME, but need to create an A record for your domain, and the azure management site wants to verify that you are the owner of the domain before letting you configure the custom domain name. Here is the procedure for setting up an A record:

first you need to create the CNAME that is used for verification, which has be to awverify followed by the domain you want to configure as A record. In the case of the non-www domain, it has to be:
awverify.example.com 21600 IN CNAME awverify.mysite.azurewebsites.net
After the DNS has propagated (you can check with http://www.digwebinterface.com/) you can go on and create the A record:
example.com 19473 IN A your.azure.IP.address
Then of course add the domain inside the custom domain section of your azure web site.

Before wrapping up, two notes that might confuse you at first:

your website has to be running as shared or reserved (free mode doesn't allow domain names, at least not during beta)
If you were used to the *.example.com notation to configure any hostname to point to the same IP address, remember that this won't work on as the azure portal checks for the specific CNAMEs

More information on how to manage custom domains on Azure web sites can be found again on the Azure documentation portal: Configuring a custom domain name for a Windows Azure web site.

Traffic and SEO problem after 2 months of down time

Unfortunately, the almost 2 months of down time, apart from the non blogging, also meant that my site disappeared from Google search results.

Here is the traffic profile of my blog, before and after the period of unavailability.

From more than 1500 pages a day, it went down to 200-300 pages a day, all coming from referrals on stackoverflow or forums, but with very little search results from Google. Let’s see how long it takes to go back to previous figures.

Performance and logging

Now I have to monitor the performance of the web site on Azure, and try to understand where all those peaks in CPU time and HTTP Errors come from.

Migrating to Azure Web Sites is easy

Despite the small issue with user access, I have to say that the migration to Azure Web Sites was kind of easy: it’s just like running on a normal hosting. Also no problem with the Lucene indexes, which are usually the most critical part of a Subtext installation on shared hosting environments.

A small request to all my readers: if you have more experience than me with Azure, could you please comment with some tips on how to monitor performance and errors on Azure better? Same if you have some tips on how to get back to being indexed by Google.

Tags: azure, websites, subtext, user access, Azure SQL Server

Deploying a MongoDB powered Node.js app on Windows Azure: my slides

Simone Chiaretta — Fri, 18 Jan 2013 14:23:10 GMT

A few days ago I attended the second event of the newly born Belgian Node.js User Group. The event was about deploying and testing node.js applications and has been hosted in Microsoft Belgium offices near Brussels, thanks to Tom Crombez (aka @artymoony) and Windows Azure.

There were 3 presentations:

Mine, about deploying a MongoDB powered Node.js app on Windows Azure: a walkthrough of the steps needed to deploy the app.
Then another talk on how to build your own “cloud-like” environment on Linux, using systemd. Talk by Ruben Vermeersch.
Finally Julien Biezemans, lead developer of cucumber.js, gave an introduction of BDD and cucumber.js

It was really a nice event, with good catering and good discussion (and for the first time almost 50/50 French speaking / Dutch speaking).

For those who are interested, you can see my presentation online: http://bitly.com/njug_be_azure.

The first step to test azure is of course to create an account. You can do it following that link: http://aka.ms/azurebenug

Tags: node.js, njugbe, presentation

Christmas present for you: Announcing Web.NET Conf 2013 in Paris

Simone Chiaretta — Tue, 25 Dec 2012 18:52:04 GMT

Together with the traditional Christmas and New Year wishes, I wanted to give all European developer a small Xmas present:

Web.NET Conference 2013 will be held in Paris, around the end of May

This year's edition is possible thanks to the help of Rui Carvalho, which already came to talk at last Web.NET Conference.

So, let's look forward to an amazing 2013!!

webnetconf, xmas

How to return a CSV file with ASP.NET MVC

Simone Chiaretta — Thu, 22 Nov 2012 10:48:00 GMT

Continuing with my series of posts inspired by the work done on the Web.NET Conference web site, after telling you why you should not use Boolean fields when modeling your objects, today I want to share with you an ActionResult I wrote to get a CSV from a generic list of object.

I needed to download the list of all attendees in csv format so that I could import them into Excel for doing various free-form analysis: I looked around the net to see if something was available but I found nothing, so I decided to write it myself and do it the most reusable way possible.

I’m not just going to give you the code, but I’d also try and comment the most important part of the class.

Extend ActionResult

Obviously, being used as result returned from an action, the class has to extend ActionResult, and in this case, since what I’m returning is a file, I’m extending FileResult: this provides all the standard file-related tasks, like setting the content type and setting the filename that will be suggested when saving it.

Constructor and declaration

The values for these two properties will be set in the ActionResult’s constructor:

public class CsvActionResult<T> : FileResult
{
    private readonly IList<T> _list;
    private readonly char _separator;

    public CsvActionResult(IList<T> list,
        string fileDownloadName, 
        char separator=',')
        : base("text/csv")
    {
        _list = list;
        FileDownloadName = fileDownloadName;
        _separator = separator;
    }
...

I’m also passing in an optional separator because in many countries the the separator for fields is not a comma, but a semi-column.

Override WriteFile

In order to extend FileResult, you also need to override the WriteFile method, which is the one responsible of getting the value of the file and sending it to the user. The standard implementation just takes a file from the disk and send it to the browser: in this case I have to write to the OutputStream directly the value of my list of objects.

protected override void WriteFile(HttpResponseBase response)
{
    var outputStream = response.OutputStream;
    using (var memoryStream = new MemoryStream())
    {
        WriteList(memoryStream);
        outputStream.Write(memoryStream.GetBuffer(), 0, (int)memoryStream.Length);
    }
}

Discovering the property names at runtime

The csv file needs to have the list of all the columns’ names so that Excel can give a name to it once imported: since the action results accepts any object I needed to find out the name of the property. This was easily done via reflection and passed to a function that writes it in the OutputStream of the response.

foreach (MemberInfo member in typeof(T).GetProperties())
{
    WriteValue(streamWriter, member.Name);
}

The write value method is an utility method that formats the value in the proper way and with the correct separator. I’ll show this later in the post.

Writing each object of the list

After having written the header, always via reflection I get the values of the properties, and write them in the OutputStream.

foreach (T line in _list)
{
    foreach (MemberInfo member in typeof(T).GetProperties())
    {
        WriteValue(streamWriter, GetPropertyValue(line, member.Name));
    }
    streamWriter.WriteLine();
}

If a property is of a complex type, and you still want to export it into the csv file, all you need to do is override the ToString method to format it into a string. Here is the GetPropertyValue method that does the actual work of retrieving the value from object.

public static string GetPropertyValue(object src, string propName)
{
    return src.GetType().GetProperty(propName).GetValue(src, null).ToString()??"";
}

Formatting the property value

Care must be given when writing the actual string otherwise Excel (or any other csv parser) will not be able to get the data correctly: the value must be enclosed in double quotes, and all double quotes inside the value must be escaped. And furthermore the separator has to be different based on the culture of the user, but to make it simple I take the value supplied during the instantiation of the action result.

private void WriteValue(StreamWriter writer, String value)
{
    writer.Write("\"");
    writer.Write(value.Replace("\"", "\"\""));
    writer.Write("\"" + _separator);
}

How to use it

Using the action result is pretty easy: you just create a new instance of the class, and pass it a IList of something. And then return the class in you action method.

public ActionResult CsvList()
{
    var model = CreateUserListViewModel();
    return new CsvActionResult<UserListViewModelItem>(model.Items, "UserExport.csv");
}

Get the complete code

You can get the complete code of the class on this gist. I’ll be creating a NuGet package with binaries and some enhancements soon.

Tags: actionresult , aspnetmvc , extensibility , CSV

Why you should never use a boolean field (use an Enum instead)

Simone Chiaretta — Mon, 19 Nov 2012 09:29:00 GMT

Over the last few months I worked, on my spare time, on a new web development project: the site for the Web.NET Conference. It was a refreshing experience, going back working on custom development on ASP.NET MVC 4 and all the latest bits of technology.

That gave me quite a few ideas for posts, so over the next weeks I'm going to blog about some of the bits and pieces of code that I think are worth sharing with the community, like ActionResults, HtmlHelpers together with my first real-coding experiences with RavenDb.

As first post I’m not focusing on something about a technology, but I want to tell why you should never model a data field as Boolean, and instead start directly with an Enum.

How the problem started

I'm going to tell you what happened during the development of the registration and payment parts of the Web.NET Conference.

I needed to keep track of whether someone has paid or not, so I started modeling that field as a simple boolean value, HasPaid. I also wanted to show them a different message depending on whether they paid or not, to remind them they had to pay in order to get the meal they ordered. To achieve that I checked the value of the HasPaid field: after a while I realized that also people that didn't order a meal had the HasPaid to false, as indeed they didn't pay because they didn't have to.
So in this confirmation screen I also checked whether the total of what they had to pay was different from 0. And it was still manageable.

After a while someone asked if they could pay at the registration desk as in their country PayPal was not operating: so I moved them manually to HasPaid=true and added in the note field that they will pay at the desk, so that their lunch and were taken into account.

Then again something else happened: someone that has already paid unregistered and left what he paid as donation for the conference. Now I needed to filter out their meals, their participation at the conference, but still keep their payment in the count of the donations received, unlike the ones that asked for a refund for which I need to filter out also the payment: this was becoming a nightmare to handle with the original HasPaid field.

On with the refactoring

One evening I sat down, and refactored the payment procedure and all reports to go from a simple boolean to an Enum with the following options:

Undefined
DidntPay (the original HasPaid=false)
NoNeedToPay (for those how didn't reserve a meal or gave no donation)
Paid (the original HasPaid=true)
PaysAtRegistration (for the guys who couldn't pay online)
Refunded (if someone cancels, and wants his money back)

And after the refactoring and making sure all reports and state transitions were using the new Enum, I also had to build a small script to convert all the data inside the RavenDb repository (and this is something interesting I’d probably write a blog post about).

Another example of the same problem

The same problem occurred with the registration status: it started with 2 booleans, IsRegistered and IsWaitlist, then expanded with HasCancelled and WasApprovedFromWaitList and all crazy combinations of boolean expressions to understand his real status, and then, in that very same refactoring session, it all became a more clear and easier with that Enum:

public enum RegistrationStatus
{
    Undefined,
    Confirmed,
    WaitingForPayment,
    Waitlist,
    Cancelled,
    Approved,
    ApprovalNotConfirmed
}

State Machine/Workflow

The benefit of this approach is that both registration and payment became two state machines, and it was much more easy to implement a very simple workflow with the possibility to set allowed and forbidden transition (for example, someone in waitlist couldn’t become “confirmed” without passing from the “approved” status), and action that needs to be done when a given state transition happens. Here is an example of what the transition rules look like: previously with the combination of booleans it was crazy, and very easy to make logical mistakes.

public static class RegistrationFlow
{
    public static void RegistrationStatusTransition(RegistrationStatus newStatus,
        Registration registration)
    {
        switch (newStatus)
        {
        ...
        case RegistrationStatus.WaitingForPayement:
            if(registration.RegistrationStatus!=RegistrationStatus.Undefined &&
            registration.RegistrationStatus!=RegistrationStatus.Approved)
                throw new ArgumentOutOfRangeException("newStatus",
                String.Format("{0} -> WaitingForPayement not allowed",
                registration.RegistrationStatus));
            if(registration.PaymentStatus==PaymentStatus.NoNeedToPay)
                registration.RegistrationStatus = RegistrationStatus.Confirmed;
            else
                registration.RegistrationStatus = RegistrationStatus.WaitingForPayement;
            break;
        case RegistrationStatus.Confirmed:
            if(registration.RegistrationStatus!=RegistrationStatus.Undefined &&
            registration.RegistrationStatus!=RegistrationStatus.WaitingForPayement &&
            registration.RegistrationStatus!=RegistrationStatus.Approved)
                throw new ArgumentOutOfRangeException("newStatus",
                String.Format("{0} -> Confirmed not allowed",
                registration.RegistrationStatus));

            registration.RegistrationStatus = RegistrationStatus.Confirmed;
            break;
        ...
        }
    }
}

Lesson Learned

When I tweeted about this while I was refactoring, someone told me: “Using a boolean is an antipattern”… well… now I experienced it myself.

From this experience, in the future, I’ll never use a Boolean field again, and always start with an Enum, especially with a Document database where migrating data is a bit more complex than with relational databases.

UPDATE: Given the comments received I’d like to clarify a bit my position. I’m not saying booleans are not to be used at all: booleans have value, just not when the the thing you are trying to model is a state and not just a real/physically boolean value.

Tags: webnetconf , boolean , enum , architecture

OpenROV at Node.js Conf Italy and Maker Italy

Simone Chiaretta — Tue, 13 Nov 2012 11:09:39 GMT

On the 11 of November I had the pleasure to present at the Node.js Conference Italy the work I’ve been doing with Dominik and a bunch of other guys in the San Francisco area on the “brain” of the robotic submarine called OpenROV.

On my way back from Brescia I stopped by at the first Italian Maker Faire, held in the big expo area of Milano Rho, where I wandered among stands full of flying drones, biped robots, 3D printers, FabLabs and electronics shops.

Together with web development, the makers and open hardware movement is something I’m getting interested in, and after few months dedicated totally to web development, this was a weekend totally devoted to these two new interests.

Slide and resource of my OpenROV presentation at Node.js Conference

During the 30 minutes presentation I went over the physical design of the OpenROV, the reasons why it has been build in the first place, and an overview of the architecture of the software that runs on the small board inside the robot itself.

I was the only one doing a presentation in JavaScript, using Reveal.js, which was shocking being it a conference on JavaScript: the slides are available both as JavaScript presentation but also published on Slideshare.

On my other blog about all things HW and makers I also wrote a blog post with a bit more of resources and a longer commentary of the event.

The Italian Maker Faire

On my way back home, after the Node.js conference hackathon, I spent a few hours wandering among the stands at Makers Italy: the maker movement is invading Italy too… finally!

Not only robots and drones, but also a lot of stands on digital fabrication tools (3D printers above everything) and of small makers’ founded companies making various items like custom skateboards, guitars, bags, jewelries and so on.

Not sure if that movement will bring innovation or it’s just yet another trend, but for the moment it seems like a lot of people are getting interested, building tools for makers, and it won’t be long before digital fabrication tools will land in every house. Already now, 3D printers are less expensive of a low level PC 10 years ago, and I guess they’ll reach the cost of an entry level laptop.

Again on my drones&rovs blog I wrote my impressions and a small review of the stands I found more interesting.

Tags: makersitaly, nodejs, openrov, conference

Web.NET Conference: find it on social media

Simone Chiaretta — Thu, 04 Oct 2012 16:27:55 GMT

Apart from the obvious twitter and facebook, the Web.NET Conference is using a few specific social networks. We are also on:

Geekli.st – A social network for “geeks”
OleaPark – A conference specific networking app
Lanyrd – A conference social directory

I’m going to explain a bit more what they are, and for we have decided to use them.

Geekli.st

Probably I should have added geekli.st in the first line of this post, next to twitter and facebook after the adjective “obvious”. If you are a developer you should at least know what it is, or already have a profile over there (if you don’t, you can join geekli.st). Basically it’s social network were developers can share their accomplishments, talk about what they are building and doing but always staying on “geek talk”. But it’s also becoming the new way of seeking and offering jobs.

Geekli.st is also one of the main sponsors of the conference (they also offered T-Shirt for everyone) and it might be that Christian Sanz, the CTO and co-founder of Geekli.st comes and give a presentation at the conference.

You can find the Web.NET Conference on Geekli.st at: https://geekli.st/WebNETConf

OleaPark

This Berlin-based French startup has built a new way for people attending conferences to connect one another: you go to the event page, you download the app (iPhone, Android and soon mobile site) and can see who is attending the conference, their profiles and if you see someone that can be a interesting person, you can contact him via the app. And on the day of the event people can checkin at the conference, and you can see how is there and start talking to them. To understand better, there is a video that explains everything on their site.

You can join the conference on OleaPark at: http://oleapark.com/events/4ff30c8f7c93dd14e5000002

Lanyrd

And finally the Web.NET Conference is also on Lanyrd. That is yet another way to see who is attending the conference, but also to see the history of each speaker and get a feeling of the type of audience that will be at the conference. And if you are someone that easily forget dates and times, you can add the conference’s schedule to your calendar.

Lanyrd also provides a nice mobile-optimized version of the agenda.

If you use Lanyrd, you can join the event at: http://lanyrd.com/2012/webnet12/

Twitter and Facebook

Even if “obvious” the conference is on twitter and facebook, so don’t forget to follow @webnetconf to get real-time info and updates on the conference, like the conference’s page on Facebook and join the FB event.

Tags: webnet12, conference, twitter, geeklist, social media

Web.NET European Conference: sold out in 2hrs and now the agenda is available

Simone Chiaretta — Thu, 27 Sep 2012 09:31:50 GMT

I have to say that lately all my spare time has been dedicated to the organization of the Web.NET Conference: I firmly believe that the future of web development will move away from the enterprise features and the needless over-engineering typical of the last decade. That’s why I’m putting so much effort in this conference. And I’m super happy of how it’s rolling out.

Registration: Sold out and waitlist is open

We opened registration the 18 of September, at midday, and by 2:30PM all the 120 places available have been given out: that means 120 seats in 2:30. The previous record for the other conference I organized was 120 seats in one day, and it was already a big accomplishment.

At the moment only the waitlist is open, and there are already 40 persons in it: from experience we usually recall 40 people from the waitlist (if people registered are nice and tell us if they planning on not coming anymore), so if you register quickly chances are you might take part in the conference anyway.

Agenda

I want to thank all the people that voted during the month of August as they really helped shape the conference: we have received 45 proposals from 30 speakers all of which where super interesting, and would have been really difficult for us to choose the 20 sessions for the agenda. Here is the beautiful design of the agenda, designed by the guys of GreenBubble, an Italian web agency that jumped both feet together with us on this project (click on the image to read the agenda):

There will be a lot of international speakers and they’ll talk about WebAPI, REST, OWIN, advanced JavaScript frameworks, and more: all topics strictly related to “simplicity” and lightweight approach in building web applications.

Now 3 more weeks and the conference will kickoff: it will be a busy period, but really looking forward to meeting in person everyone that made this possible: the speakers, the sponsors and the attendees.

Tags: webnet12, conference, future of web

Vote for the sessions you want to attend at the Web.NET Conference

Simone Chiaretta — Mon, 06 Aug 2012 12:48:13 GMT

Over the month of July, 29 speaker submitted 44 presentations' proposals. But we have only 19 slots, so even limiting to one session per speaker we will not be able to accept all the speakers that submitted a proposal.

Today we are opening the voting phase: till the beginning of September you’ll be able to vote for the 5 sessions you’d like to attend to at the Web.NET Conference on the 20 October.

Speakers are coming from all Europe (and beyond), like Pierre Spring from Switzerland, Niels Hartvig from Umbraco, Jakob Mattsson from Sweden, Maarten Balliauw, Kris van der Mast and Jef Claes from Belgium, Ayende from Israel, Christian Horsdal from Denmark (first proposal received), Robert Mühsig from Germany. Of course also a lot of Italian, like Roberto Messora, Raffaele Rialdi, Massimiliano Mantione (which is now working on the Chrome’s V8 Javascript compiler) and many more.

Which topics have been proposed?

Just to give you a taste of what has been proposed, here is a quick list of the topics:

ASP.NET Web API
NancyFx, OpenRASTA, FubuMVC
HTML5, CSS3, Responsive Design
Owin, SignalR
Backbone.js and Knockout.js
Django, Node.js, Sinatra
Orchard, Umbraco and Sharepoint
Azure and cloud computing in general
Javascript performance tips (from someone that builds the V8 compiler for Chrome)
and much more

To get the full list of speaker and topics, just go the Web.NET Conference web site, login with your Twitter or Facebook account, and vote for the 5 sessions you would like to attend.

The voting will stay open till beginning of September. And then we’ll open the registrations to the conference.

Tags: webnet12, conference, voting