You are on page 1of 25

So you want to write a report… 


Part 1: Setting up a sitecore development 
environment from scratch 
If you already know how to do this, go ahead and skip to Part 2 (once it’s out).   

Prerequisites and First Instance 

First, go ahead and make sure a compatible edition of MongoDb is installed. I’m running 
3.0.3 so take that as you will. 
If you install from the mongo installer, you may want to enable mongodb as a windows 
service.  The following command line will do so: 
○ mongod.exe --install --verbose --logpath "C:\Logs\Mongo\Log.txt"
--serviceName "Mongo 3.0.3 (27017)" --serviceDisplayName "Mongo
3.0.3 (27017)" --serviceDescription "Mongo 3.0.3 (27017)"
--dbpath "D:\Data\MongoDb"
Also Visual Studio 
And SQL Server 
And Sitecore Rocks 
I’d Recommend TDS by Hedgehog, but this’ll work without it. You just won’t be able to 
version and sync and all that jazz. 
For using the SIM tool (described shortly) you’ll need to change the user that the sql 
server service is running under. Open the services.msc management console. Then 
open the properties of the sql server service. Goto the Log On tab and change the Log 
on as account to “Local System account” 


Download the latest Sitecore Instance Manager Tool (SIM.Tool) 
Set Up your folders for using SIM 
○ Websites/SIM – The folder where your installed instances of sitecore will be


 repos. and licenses   ○ Repos – Where to put your zips of Sitecore for install   .○ Sitecore – The base folder for your tools.

1.○ SIM.4 – Your installation folder for SIM     .

 Under Security Logins.   ● I’m gonna assume you’re a Developer. Add the “NT AUTHORITY\NETWORK SERVICE” user and  set them to the following server roles:   . So  I’m not too concerned about environment security more than it works. setting up a local development environment. and you won’t be  hacked from the outside.  So… open up SSMS and select the instance you’ll be working  on.

● So now open up SIM and make sure your configuration matches that from above.   .

● Alright now install an instance:   ● ● ● As a note.  When you try to browse to your new sitecore site. Alright! Now let’s get things started.  Go to your WEBSITES\SIM\<instance>\Website\App_Config folder and modify the  ConnectionString. Feel free to update it further if you want a  prettier URL. if you did anything other than the default install for MongoDb. And then.  Change all the Integrated_Security=False items to True. update appropriately. you’ll get a login failed for user ‘’. we’ll be collecting user feedback for each page we  visit (Modified Contact Facet). How well do our visitors like our page?   .  Actually. For this  demonstration (which starts in part 2).   ● Now your site will come up all pretty. we’ll be SPEAKing about the Experience  Analytics of the matter. I would recommend it. this will modify your hosts file.config file.  Also.

The Visual Studio Project    ● Start a new ASP.NET Web Application (Opening Visual Studio as an ADMINISTRATOR)      .

  ● ● Go ahead and take a copy of your web.  But that’s not my business. And after that  Open up the properties on your project.5  . Don’t go hosting it in Azure or testing it.  unless you roll that way.config from the sitecore instance and place it in  your new project.● Start a new Empty project with references. Switch the Framework to 4.

  .  Remove any packages related to Razor. Let’s double check our NuGet packages. and we’ll add references as we need  them that are compatible with our Sitecore instance. Everything will still compile.   ● ● And fill it in with something we can test:   Okay.● Go ahead and add a Views folder to the project then add a new view. etc. Don’t worry. Visual studio has a habit of including the  MVC packages when we add a MVC object.  MVC.

● Now Right­Click on your project and select publish.   ● ● Select Custom  Enter a Name    .

● Set the publish method to File System and the Target Location to the instance you setup  earlier.   .

● Set the Configuration to Debug. And for the love of all things Content Managed. ● Now Publish!!            . DON’T  select the delete option.

Setting up Sitecore to Render our MVC View  The Desktop and Databases  ● Bring up your site (​ http://mongoreportdemo/sitecore/​ ) and if all went well you should be  at the dashboard.  (Strictly speaking this step is skippable. but if you’ve never worked  with sitecore you’ll be missing an important lesson.  ● Go to the Desktop.)        .

  If you  want to learn more about what each of these databases do. You’ll need another article.● In the bottom right­hand corner of the desktop is an icon. Master.  Also. ● If you like.  Now for the beginner’s lesson in sitecore.  that’s not covered here. there’s a  reporting database hanging out in SQL Server too. What is covered…    . and Web are the defaults to start with. Click it. Core. go ahead and select the “Show Database Name” that way you know which  one you’re working on.  Sitecore uses multiple  databases. but you don’t need to select it.

● Click on the sitecore start button. And select Content Editor ● Now. the content editor is available from Launchpad; but selecting which database  you’re working from isn’t. There’s the lesson. Okay.  Let’s name it Sample  .  Go to  sitecore­>Layout­>Layouts and right­click to insert new layout. content editor…      Getting Ready for MVC  ● You’re going to have to add a new Layout for MVC Pages.

  Website­>layouts.  Create!  .   ● Then place it under the base Layouts folder.MVC Layout. then finally select the location.


 Rename the actual file here as  well.   .     ● Open the file system and go to your website instance.cshtml.aspx to .● Now under the Data settings in our new layout. Update the link from .

dtd">  <html lang="en" xml:lang="en" xmlns="http://www.WebViewPage  @using Sitecore.  Adding our Demo Launch Rendering  ● ● Under sitecore­>Layout­>Renderings go ahead and right­click insert a new folder for our  stuff. new { DisableWebEdit = true })  </title>      <meta http­equiv="Content­Type" content="text/html; charset=UTF­8" />      <link href="/­transitional.● Let’s add this new file to our Visual Studio project so we can modify it and publish it  when we want.Field("title".     The File should have the following contents:  @inherits System. DemoLaunch  .Sitecore().css" rel="stylesheet" />    </head>    <body>      <div id="MainPanel">@Html.0 Transitional//EN"  "http://www.w3.Mvc.  I also like creating folder for different types of">    <head>      <title>  @Html.  Under our new folder right­click insert a new View Rendering and name it after our view  we created. So under MongoReportDemo go ahead and create a View Renderings  folder. I called it MongoReportDemo.Placeholder("main")</div>    </body>  </html>    So go ahead and publish again to make sure the layout file is correct.Mvc;   @{    Layout = null;  }  <!DOCTYPE html PUBLIC "­//W3C//DTD XHTML 1.Sitecore().w3.Web.

    .  ●  ​ Then fill in the path under the Data section.

  .● Go to the sitecore­>Content section and insert from template.

 select Sample MVC Layout.    ● ● Under the Default Section Click on Edit  Under Layout. then Details to bring up the Layout  Details. select PRESENTATION.● Then from the Ribbon.   .

 Select your DemoLaunch Rendering. add a new Control.   .● Then under Controls. and add  it to the “main” placeholder.

● Now when you open ​ http://mongoreportdemo/DemoLaunch​  you should be greeted with     If you made it this far. we’ll be exploring the  configuration of facets and they are stored in MongoDB/xDB. congratulations!  You’ve completed part 1. and now have a local  development instance tied to your Visual Studio project.    . In part 2.