Welcome to TechNet Blogs Sign in | Join | Help

Documenting Your Task Sequences Automagically

Often times, after creating an MDT or SCCM task sequence, you need to document it for yourself or your customers. Usually, this involves creating a table with the groups and steps, extracting their descriptions, identifying conditions and denoting the step actions and variables and then having format it all nicely and with indents denoting hierarchy. All of this information is usually already in the XML of the task sequence and all you're really doing is formatting. You can automatically format XML documents by using an XSL transform with the right logic. In order to do this:

1. Copy the attached file at the bottom of the post to the same folder as your task sequence.

2. Open your task sequence in your favourite text editor.

3. After the first line which should look something like this:

<?xml version="1.0"?> or <?xml version="1.0" encoding="utf-8"?>

enter the following as the second line:

<?xml-stylesheet type="text/xsl" href="tsDocumentorv1.xsl"?>

4. Save your task sequence file and open it in Internet Explorer. Presto! The XSL takes care of formatting, indents and sizing.

Your Task Sequence should look like this:

image

You can even change the styles of groups and steps easily.

1. Open up the tsDocumentorv1.xsl file

2. Edit the following section:

<STYLE TYPE="text/css">
  TD.group { background-color:teal;color:white }
  TD.step { background-color:beige }
</STYLE>

Change the colours or any other css properties you choose!

The XSL should work with task sequences created with BDD 2007, MDT 2008 and SCCM 2007.

Please try it out and post comments.

This post was contributed by Aly Shivji a consultant with Microsoft Services - U.S. East Region. Credit to Michael Murgolo for initial idea and effort.

Published Sunday, August 17, 2008 6:53 AM by DeploymentGuys
Attachment(s): tsDocumentorv1.xsl

Comment Notification

If you would like to receive an email when updates are made to this post, please register here

Subscribe to this post's comments using RSS

Comments

# re: Documenting Your Task Sequences Automagically

Sunday, August 17, 2008 10:19 AM by Dimo

Hi,

I have a question regarding the resolution of Win PE during deployment.

I want to be set to 800x600, default is 1024x768.

In my templates under program files all .xml files are set to 800x600 and the first PE screen again comes to 1024.

I'm lost on this one.

Thank you.

# re: Documenting Your Task Sequences Automagically

Tuesday, August 19, 2008 8:57 AM by Jonathan

Great job!!!

Works fine for me :)

Much faster to document then typing it manually...

Only note : I have a task sequence that runs USMT capture state with SCCM that didn't had a group. I had to add a group so it could display all the information. Otherwise, it was empty.

# re: Documenting Your Task Sequences Automagically

Wednesday, August 20, 2008 2:59 AM by Helmer

It works great!!

# re: Documenting Your Task Sequences Automagically

Friday, August 29, 2008 11:56 AM by DeploymentGuys

Jonathan,

Thanks for the feedback. It looks like you are right, if there is a task that is outside of any group it won't be documented. I'll fix that in v1.1

# re: Documenting Your Task Sequences Automagically

Monday, September 08, 2008 3:37 PM by Josh

Thanks for the great tip - exactly what I've been looking for.

One question - when you mention "Copy the attached file at the bottom of the post to the same folder as your task sequence."  Where is this folder located?

# re: Documenting Your Task Sequences Automagically

Thursday, September 18, 2008 11:22 AM by Aly Shivji

You will have to right click on the task sequence to export it to a file. Put the file in the same folder as this file and follow the instructions and you should have a documented task sequence.

# re: Documenting Your Task Sequences Automagically

Tuesday, February 17, 2009 10:55 AM by Jonathan

Hi!

Thanks again for that tool.. I found out another thing that could be upgraded in future version...

If you have multiple condition for a task to run, it will only display the first one.

If by any chance that could be a minor modification and I could use it quickly, that would really help document my gigantic task sequence (lol)...

thanks!!

Jonathan

# re: Documenting Your Task Sequences Automagically

Saturday, February 21, 2009 6:12 PM by DeploymentGuys

Thanks Jonathan for the feedback. An updated version (v2) has been posted in a separate post with this and other bug fixes

Please try it out and feel free to comment.

Leave a Comment

(required) 
required 
(required) 

  
Enter Code Here: Required
 
Page view tracker