fortypoundhead.com

Keep clean with SOAP notes

Posted On 2014-11-14 by dwirch
Keywords:
Tags: Blog Tip General 
Views: 1556


When I was a young IT professional, a more senior professional introduced me to SOAP notes for helping document and manage my my tickets. More than 25 years later, I still use this method, with great effect.

SOAP notes originally got their start in the health care field, and the notes were used by providers to create a patients chart. There are four parts to a SOAP note: Subjective, Objective, Assessment, and Plan.

These parts are very helpful in creating a record of what the patient is complaining about (Subjective), what the provider has observed about repeatable and traceable facts (such as vital signs or lab results) (Objective), the providers diagnosis (Assessment), and treatments and/or procedures to be performed (Plan). Note that the plan can include diagnostics to be performed as well.

I'm sure you can see how this method can be easily used to great effect in an technology support enuvironment. Let's walk through a sample of a tech-style SOAP note, and pretend SuzyUser is calling the helpdesk because she is unable to connect to a particular application. A SOAP note documentation set written by the help desk agent (TechDude) might look like this:


Subjective

User (SuzyUser) has called stating that she is unable to login to AppX. She states that she has rebooted her local computer, but is still unable to login.

Objective

I (TechDude) asked the user to attempt login to AppX. Witnessed error code [Invalid Username or Password].

Verified error message by checking log mechanism on AppX.

Asessment

User (SuzyUser) needs to enter a correct username and password combination in order to successfully login to AppX.

Plan

  1. Ensure that SuzyUser is using the correct username and password combination.
  2. If SuzyUser has forgotten the correct username and/or password, reset password, following password guidelines.
  3. After password reset, SuzyUser to attempt login again with correct username and password combination.
  4. Observe results:
    1. If successful, close ticket as resolved.
    2. If not successful, forward ticket to tier 2 support, attaching pertinent AppX log file excerpt.

In this sample, the tech professional documented the problem from the user point of view, noted the observations of the problem in a repeatable manner, diagnosed the problem, and documented both a primary and secondary plan of action. While this example is admittedly a simple one, we've now got a completely documented case, which can be used to solve or troubleshoot future issues of the same type. And we all know that documentation is a good thing, right ?

You may or may not use a method similar to this. What method do you use for documenting problems?


About the Author

dwirch has posted a total of 173 articles.

You can find more information from dwirch by visiting http://www.derekwirch.com.


Comments On This Post

No comments on this post yet!


Do you have a thought relating to this post? You can post your comment here. If you have an unrelated question, you can use the Q&A section to ask it.

Or you can drop a note to the administrators if you're not sure where you should post.


Your IP address is:54.198.233.27

Before you can post, you need to prove you are human. If you log in, this test goes away.



Recent Forum Posts

Fold Code Manager into main KB?
VB6Boy posted on July 22, 2017 at about 14:42 in Site News

Fold Code Manager into main KB?
dwirch posted on July 22, 2017 at about 14:41 in Site News

Fold Code Manager into main KB?
dwirch posted on July 21, 2017 at about 22:46 in Site News

Fold Code Manager into main KB?
dwirch posted on July 20, 2017 at about 7:55 in Site News

Job Spammer: Sam Mallon
dwirch posted on July 18, 2017 at about 18:36 in Spammers

When setting up a certificate authority ...
dwirch posted on July 13, 2017 at about 9:07 in General