Service Manager Portal Source Code Released!

Service Manager Portal Source Code Released!

  • Comments 63
  • Likes

The feedback on the self-service portal has consistently been that it needs to be more customizable.  That is by far the #1 feedback item on SCSM 2010.  The types of desired customizations typically fall into these categories:

  • change the text shown in a label
  • hide buttons or web parts
  • change the style (colors, fonts, etc.)
  • change the layout
  • show more or less information
  • add additional capabilities
  • add languages or allow users to choose which language the portal is displayed in

Most of these things ideally would be configurable options on the web parts and there would be some sort of administrative UI which allowed you to change these things.  Making things like that configurable via an admin experience requires significant development and test time which unfortunately we didn’t have in the 2010 product development cycle.  That is what we are shooting for in the vNext version (currently code named “R2”) of the SCSM portal that we are super excited to show you at the Microsoft Management Summit for the first time.  The vNext portal will be based on SharePoint 2010 (any version including Foundation).  It will be made up of web parts.  You can change the text shown on labels, change fonts, change the style, change the layout, etc. using standard SharePoint administrative experiences and tools.  It will be relatively easy to add new content to the portal by creating web parts that use the SDK and plugging them into the SharePoint site.  You will also be able to add languages or change display strings by modifying the string resource files.  We will let the user choose which language they want to display the console in.  The portal will be a single SharePoint site instead of an analyst portal and an end user portal, but the user experience will be role based so people only see what they need to see.  In short, it will be what we all wished the SCSM 2010 portal could have been.

In the meantime, we know that the lack of customizability of the portal is a pain point for customers right now.  Many of the modifications that customers want to be able to do are relatively trivial to make if you had the source code and a little bit of know how.  To help customers achieve their goals for a customized self-service portal in the near term, we are releasing the source code to the portal today.  Not everybody has Visual Studio and a developer on hand to make these customizations, but a lot of our customers do.  Some of our SCSM administrators, consultants, and SI partners are even developers at heart and are excited about the possibility of making the self-service portal do what they want it to do.  We realize this isn’t ideal to have to modify code to get what you want, but it is better than not being able to modify it all!  Hopefully this will suffice while we are busy building the new portal.

But we also have another fun surprise!  We are also including a newly styled portal in this download that you can deploy with copy/paste of some files.  The new site looks like this:

image

It is styled to look similar to the SharePoint 2010 default site template:

image

Looks a lot better huh?!

This updated version of the portal is also intended to show you some of the possibilities for customizing the portal.  The updated version of the portal has the following modifications:

  • style changes – modified CSS stylesheets
  • when you click in the knowledge search textbox the text actually clears instead of staying there

image (new) vs. (old) image

  • you can update incidents from the portal!

image

  • The “where am I at?” highlighting has been removed so that it doesn’t show step 1 highlighted when you are on step 2.  Do we really think people are going to get lost in a three step wizard?

image

  • I’ve added a new Request New User option and associated web part to show how you can extend the self-service portal to gather inputs that are directly mapped to an automated activity that can drive a workflow.

image

image

Results in a new change request being created with an automated activity that looks like this:

image

image

When the automated activity kicks in it will create a new user in Active Directory using PowerShell:

image

image

I’ve commented most of the code where I have made modifications with “PORTALMOD” so you can search through the code base and easily see all of the modifications that I made.

So – to recap, this new release includes:

  • The source code of the portals that ship with the product
  • A updated version of the portal with the bug fixes and features described above
  • The modified source code for the updated version of the portal
  • A document describing in detail how to modify, build, and deploy the portal

I’ve also attached the MP to this blog post that is need to make the new user provisioning scenario go.  Please don’t use this in production though!  I have spent minimal time testing it as it is just an example of what you could do.  To deploy it you just need to import the MP .xml file and put the workflow .dll file in the C:\Program Files\Microsoft System Center\Service Manager 2010 directory.

I also want to discuss what the roadmap is for the portal.  The SCSM 2010 SP1 portal is an ASP.Net web site that hosts web parts.  Those web parts can be put on a SharePoint site.  The results are not great but you can do it and it can be made to look good now that you have the source code.  So, in that sense what we have done for the SCSM 2010 and what we are doing for the SCSM vNext portal are similar, the only difference being that in vNext we will require SharePoint as the hosting framework for the web parts.  So – in theory you could port your web parts that you develop today to run on the vNext portal since it is all just SharePoint and web parts.  The only little detail there is that the web parts you create today using the source code provided will use a different way of accessing the data than the vNext portal will.  We are still sorting out the details of that and whether or not you could mix/match 2010 web parts with vNext web parts on the same SharePoint server, but I think we’ll be able to make it work.

Lastly, I just want to make sure that everyone is clear on what this release is.  Think of it as a shortcut to developing your own custom portal using the Service Manager SDK.  We have effectively shown you how to do it and provided some sample code .  Whatever you create is like you created it from scratch.  If there is a bug in a modified portal then you won’t be able to call Microsoft support about it.  I hope that makes sense and seems fair.  If there is a bug in the SDK somewhere then of course you can call Microsoft support about it.  Of course we are here to help you on the forums and blog if you need some help getting started, have questions, or want to discuss a bug.

I’m really looking forward to seeing what people do with this.  We have had some internal groups here at Microsoft take this source code and do this already and it has worked out great.

Download the files from the Microsoft Download site here:

http://www.microsoft.com/downloads/en/details.aspx?FamilyID=65fbe0a3-1928-469f-b941-146d27aa6bac&displaylang=en

You can also download this from MSDN or TechNet if you are a subscriber - the release there is called the 'Service Manager Portal SDK'.

Big THANKS to Paresh (the Microsoft developer on the original portall that helped pull this together), the marketing team for funding the portal style update, and all the community beta testers that validated this release for us!

Enjoy!

Attachment: ProvisionNewUser-New.zip
Your comment has been posted.   Close
Thank you, your comment requires moderation so it may take a while to appear.   Close
Leave a Comment
  • Hi Travis - THIS IS GREAT!  We are selebrating this with coffie here at University of Southern Denmark...  

    This months best news :-)

    I will get back to you on what we make of it as soon as we get there..

  • Great news Travis!

    But, this we expected for a long time. In the meantime, as the project nears the end, we approached the end of the development of our own solutions for SCSM portal.

    This would be useful for future projects.

  • Travis, This is great. We are looking into starting a cutomization project based on this source code.

    Thanks again.

  • Travis, this is excellent, thanks to everyone involved, especially for providing the source code

  • Hi Travis,

    I've customised Microsoft.EnterpriseManagement.ServiceManager.WebParts so that the Reset Password and Software links are no longer visible which we've been wanting to do for ages, but now I can't get rid of the new "Request New User" link as my web development skills are quitelimited...

    Is there an easy way to remove it without causing exceptions?

    Thanks,

    Rob

  • @Rob -

    In HomePageTasks.cs search for the word 'PORTALMOD'.  You'll see the code that was added to display the Create New User option.  Just comment that out or delete it, build, and deploy.

  • @Travis, Gah, I failed to notice the contents of the Overrides region, sorry! Thanks for the pointer...

  • Veeery nice Travis! Finally able to customize it as we need it to be.

    Hope to see vNext soon... ;)

  • Hi Travis

    Forest I will say THANKS FOR THE SOURCE CODE :-)

    The only problem I have is that the HomePageTasks.cs is only in "EN" – my site is change ding Language.

  • Hi Travis

    Great job !

    I did some test without success...how can I get the new End User interface in another language like FR please ?

    Our customer will kill for sure me if I deploy the new interface in English LOL

    Thanks

  • @HuguesDePayns - Assuming by 'FR' you are referring to French, the console is already translated into French.  Any user that connects to the portal web site using a browser on a computer running in French will get the French language version of the portal.

  • @Travis - Thanks for your quick reply.

    I left a message on social.technet.microsoft.com/.../35907cb3-ca7e-4436-899f-f4c22c68d0da

    We have the portal in French with the portal from the SP1 but with the new portal it is in English only.

    I guess That we have an issue related with the common folder.

    Your help is welcomed :o)

    Thanks

  • Hi Travis.

    Great job..

    My site starts fine with being Danish in my case.

    But switching to englsk when used modules from the web parts

    example from HomePageTasks.cs (I do not use the new site. but the original site)

    In Home.aspx I have a warning example <SM_WebParts:HomePageTasks ID="HomePageTasksWebPart" runat="server" title=" "/> ---- Warning Element 'HomePageTasks' er ikke Known item. Det kan occures according der er compilation error in the Web site or the web.config file is missing. C:\Visual Studio 2010 \ Projects \ Portal Source ForDistribution \ End User Portal \ Home.aspx 186 42 End user portal

    Thanks. :-)

  • @Torben Andreasen

    Can you please check to see if you have a web.config or *.config file in your End User web site directroy?

  • @Travis

    In solution Explore under End user portal is there two files  under web.config – web.Debuf.config and web.Release.config

    There is another called web.enduser.config under end user portal.

    On the web portal is there one web.config file.