Guided Walkthrough Tutorial

[mark name="CONTENTS" memo="CONTENTS"]
[link memo="1. INTRODUCTION" mark="1. INTRODUCTION "]
.. [link memo="1.a. Start" mark="1.a. Start"]
.. [link memo="1.b. Warnings" mark="1.b. Warnings"]
.. [link memo="1.c. Privacy" mark="1.c. Privacy"]
.. [link memo="1.d. Mission" mark="1.d. Mission"]
[link memo="2. USE CASES" mark="2. USE CASES "]
.. [link memo="2.a. Clinical Visit Documentation" mark="2.a. Clinical Visit Documentation"]
.. [link memo="2.b. Clinical Decision Making" mark="2.b. Clinical Decision Making"]
.. [link memo="2.c. Clinical Chart Review" mark="2.c. Clinical Chart Review"]
[link memo="3. FEATURES FOR REGISTERED USERS" mark="3. FEATURES FOR REGISTERED USERS "]
.. [link memo="3.a. Registration" mark="3.a. Registration"]
.. [link memo="3.b. My SOAPnote Page" mark="3.b. My SOAPnote Page"]
.. [link memo="3.c. My Favorites Page" mark="3.c. My Favorites Page"]
.. [link memo="3.d. Scratchpad" mark="3.d. Scratchpad"]
[link memo="4. CREATING AND MODIFYING SOAPNOTES" mark="4. CREATING AND MODIFYING SOAPNOTES"]
.. [link memo="4.a. Make Your Own" mark="4.a. Make Your Own"]
.. [link memo="4.b. Opening SOAPnotes (for Editing)" mark="4.b. Opening SOAPnotes (for Editing)"]
.. [link memo="4.c. Saving SOAPnotes" mark="4.c. Saving SOAPnotes"]
[link memo="5. BASIC SOAPNOTE FIELDS" mark="5. BASIC SOAPNOTE FIELDS"]
.. [link memo="5.a. Suggestions for Getting Started" mark="5.a. Suggestions for Getting Started"]
.. [link memo="5.b. Boilerplate" mark="5.b. Boilerplate"]
.. [link memo="5.c. Text Boxes" mark="5.c. Text Boxes"]
.. [link memo="5.d. Text Areas" mark="5.d. Text Areas"]
.... [link memo="5.d.1. Text Areas with Lots of Default Text - Alternative Code" mark="5.d.1. Text Areas with Lots of Default Text - Alternative Code"]
.... [link memo="5.d.2. Fillable Text Areas" mark="5.d.2. Fillable Text Areas"]
.. [link memo="5.e. Dates" mark="5.e. Dates"]
.. [link memo="5.f. Radio Buttons" mark="5.f. Radio Buttons"]
.. [link memo="5.g. Check Boxes" mark="5.g. Check Boxes"]
.. [link memo="5.h. Checklists" mark="5.h. Checklists"]
.. [link memo="5.i. Drop Down (Select) Boxes" mark="5.i. Drop Down (Select) Boxes"]
.. [link memo="5.j. Comments" mark="5.j. Comments"]
.. [link memo="5.k. Links" mark="5.k. Links"]
.. [link memo="5.l. Marks" mark="5.l. Marks"]
[link memo="6. ADVANCED SOAPNOTE FIELDS" mark="6. ADVANCED SOAPNOTE FIELDS"]
.. [link memo="6.a. Prepopulated Text" mark="6.a. Prepopulated Text"]
.. [link memo="6.b. Reserved Variables" mark="6.b. Reserved Variables"]
.. [link memo="6.c. Recalling Variables" mark="6.c. Recalling Variables"]
.. [link memo="6.d. Adding Conditions" mark="6.d. Adding Conditions"]
.. [link memo="6.e. Performing Calculations" mark="6.e. Performing Calculations"]
.... [link memo="6.e.1. Calculations - Simple Computations" mark="6.e.1. Calculations - Simple Computations"]
.... [link memo="6.e.2. Calculations - Interpreted Results" mark="6.e.2. Calculations - Interpreted Results"]
[link memo="7. USEFUL TOOLS AND FEATURES" mark="7. USEFUL TOOLS AND FEATURES"]
.. [link memo="7.a. The SOAPnote Helper Tool" mark="7.a. The SOAPnote Helper Tool"]
.. [link memo="7.b. Quick Fill Buttons" mark="7.b. Quick Fill Buttons"]
.. [link memo="7.c. Hacks and Tricks" mark="7.c. Hacks and Tricks"]
.. [link memo="7.d. All Samples" mark="7.d. All Samples"]
[link memo="8. VIDEO TUTORIALS" mark="8. VIDEO TUTORIALS"]
.. [link memo="8.a. Video Tutorial – Copy, Modify, and Save a SOAPnote" mark="8.a. Video Tutorial – Copy, Modify, and Save a SOAPnote"]

[mark name="1. INTRODUCTION"]
[mark name="1.a. Start" memo="1.a. Start"]
There are hundreds of calculators, note templates, and checklists.

The output is unformatted plain text so you can paste it into your Electronic Health Record (or anywhere else you need to put it). Click on the button “Calculate Result” to see the output. Then click “Copy to Clipboard” so grab the text. Now you can paste it where you need it.

Search from the home page or browse these pages (Note: links open new pages)
[link url="//www.soapnote.org/category/featured/" memo="Featured SOAPnotes"] - a small curated list
[link url="//www.soapnote.org/timeline/" memo="Timeline"] - all of them listed chronologically
[link url="//www.soapnote.org/index/" memo="Index"] - content categories

[link mark="CONTENTS" memo="CONTENTS"]

[mark name="1.b. Warnings" memo="1.b. Warnings"]
Features and content on the site may be updated, modified, removed, or deleted without notice.
- Users are *STRONGLY* advised to save their personal content to secure locations.
- No content from the site should be construed as recommendations or advice for providers or patients.
- The site is intended for educational purposes.
- Because anyone can post on the site, there is no guarantee about the accuracy of the content of the site. Users should personally verify the content of the pages they use.
- This site will not work as an electronic health record and is not intended to be used as an electronic health record. Attempts to use the site as an electronic health record or to store protected health information will result in deletion of the information and termination of the user account.
- Comments are subject to moderation and deletion.

[link mark="CONTENTS" memo="CONTENTS"]

[mark name="1.c. Privacy" memo="1.c. Privacy"]
The Privacy Policy for the site is [link url="//www.soapnote.org/privacy-policy/" memo="here (opens new page)"].

[link mark="CONTENTS" memo="CONTENTS"]

[mark name="1.d. Mission" memo="1.d. Mission"]
Since 2008, the SOAPnote Project has been a sandbox to make, test, and share forms, calculators, and decision tools. The site is offered free of charge without any guarantee, either explicit or implicit.

[link mark="CONTENTS" memo="CONTENTS"]

[mark name="2. USE CASES" memo="2. USE CASES"]
[mark name="2.a. Clinical Visit Documentation" memo="2.a. Clinical Visit Documentation"]
All of the tools at [link url="https://www.soapnote.org" memo="soapnote.org"] are capable of generating plain text that can be inserted into any electronic health record (EHR).

There are many, many pages of partial and complete visit templates. The most frequently visited page at the site is at [link url="https://www.soapnote.org/general/general-adult-physical-exams/" memo="this page"]

Once the desired output is produced, it can be copied or saved for future use.

[link mark="CONTENTS" memo="CONTENTS"]

[mark name="2.b. Clinical Decision Making" memo="2.b. Clinical Decision Making"]
Another important use of the tools at [link url="https://www.soapnote.org" memo="soapnote.org"] is assistance with clinical decision making. Physicians use decision tools every day in practice. Documentation of use of clinical decision tools helps support diagnostic and treatment plans.

There are hundreds of clinical decision tools at the site.
An important tool that is often used is the Pulmonary Embolism Rule Out Criteria Score at [link url="https://www.soapnote.org/blood-lymph/perc/" memo="this page"]

After input of clinical factors, an interpretation is provided in the output.

This output may be inserted into a note and can also be saved for future use or research. This information is not tracked by the SOAPnote Project.

[link mark="CONTENTS" memo="CONTENTS"]

[mark name="2.c. Clinical Chart Review" memo="2.c. Clinical Chart Review"]
Another use of the tools at [link url="https://www.soapnote.org" memo="soapnote.org"] is chart review. This is a process that can consume a lot of time and paper and is often frustrating to physicians.

To streamline the process, physicians can develop chart review forms for their office.

They may copy the forms available at [link url="https://www.soapnote.org/tag/chart-review/" memo="www.soapnote.org/tag/chart-review"], share their form with their staff, and then have their staff send the reviews back to them electronically. This eliminates at least some of the paper process.

Once the reviews are performed and submitted, they can be downloaded as a "comma-separated value" (CSV) file and imported into a spreadsheet program for tracking and analysis. As with other data, this information is not tracked by the SOAPnote Project.

Under the output, the user can click 'Send to Mark Morgan MD' and the output will be sent. For this feature, users need to make or copy their own chart review form so that they can receive submissions.

The output can be viewed and can be downloaded as a CSV file. CSV files can be viewed in Microsoft Excel, Google Sheets, or any other spreadsheet program.

[link mark="CONTENTS" memo="CONTENTS"]

[mark name="3. FEATURES FOR REGISTERED USERS" memo="3. FEATURES FOR REGISTERED USERS"]
[mark name="3.a. Registration" memo="3.a. Registration"]
It’s free to set up your account. There are no fees to use any of the features on the site.
Start at the [link url="//www.soapnote.org/register/" memo="registration page"].
You will receive an email to activate your account (click on the link in the email).
You will then receive another email to set your password (click on the link in that email).
Then you can change your password and you’re ready to go.

[link mark="CONTENTS" memo="CONTENTS"]

[mark name="3.b. My SOAPnote Page" memo="3.b. My SOAPnote Page"]
You can save favorite tools and make your own checklists, calculators, and notes. You can keep them private or share them. All of your stuff is at [link url="//my.soapnote.org" memo="my.soapnote.org"] whenever you need it.

[link mark="CONTENTS" memo="CONTENTS"]

[mark name="3.c. My Favorites Page" memo="3.c. My Favorites Page"]
You can save favorite tools and make your own checklists, calculators, and notes. You can keep them private or share them. All of your stuff is at [link url="//my.soapnote.org" memo="my.soapnote.org"] whenever you need it.

[link mark="CONTENTS" memo="CONTENTS"]

[mark name="3.d. Scratchpad" memo="3.d. Scratchpad"]
You can save the output from any SOAPnote to the Scratchpad. It has a large, but limited amount of space to store text. It includes the URL for the web page where the text was generated as well as the date and time it was generated. Once 30 kB of date has been exceeded older work will be lost, so it is important to save your work elsewhere (your EHR or some other safe location).

You must be logged in to use the Scratchpad.

To add text to the Scratchpad, every SOAPnote has a button below the output box. If you scroll down to the bottom of this page, you'll see it is the "Add to Scratchpad" button and it is to the right of the "Copy to Clipboard" button.

Your Scratchpad page is at [link url="//www.soapnote.org/scratchpad/" memo="www.soapnote.org/scratchpad"]. At this page, you can save (as a text file), copy, and delete the text in the Scratchpad.

[link mark="CONTENTS" memo="CONTENTS"]

[mark name="4. CREATING AND MODIFYING SOAPNOTES" memo="4. CREATING AND MODIFYING SOAPNOTES"]
[mark name="4.a. Make Your Own" memo="4.a. Make Your Own"]
There is one place to go to make and edit forms, checklists, and calculators. To get here, you choose "Create" at the Main Menus at the top of any page on the site. Just like with almost any other page at the site, you can toggle between the functional Form and the Markup by clicking on “View” up and to the right of this page.

When you’re logged in, you can save the stuff you make and edit at this page. You can just start typing or you can paste some text into the “Form Content” box. You can use the buttons at the right side to insert form elements quickly. Or you can load up other text with the “Open” menu (up and to the left on this page).

[link mark="CONTENTS" memo="CONTENTS"]

[mark name="4.b. Opening SOAPnotes (for Editing)" memo="4.b. Opening SOAPnotes (for Editing)"]
This page can get text from lots of different places. You can then edit it and save it for yourself. Click on “Open” up and to the left on this page to see the available options.

You can choose from:
Text File - This will load up any plain text (*.txt) file.
Personal - Here you can see and open any of the files you’ve already saved on the site
Favorite - Here you can open your favorites. This is good if you like something but want to modify it for your own needs.
Featured - Here you can open and load up one of the curated pages from the site. You won’t be able to change them if they’re not yours, but you can always make a copy and work on them that way.
Public - This is everything on the site that’s been shared.

[link mark="CONTENTS" memo="CONTENTS"]

[mark name="4.c. Saving SOAPnotes" memo="4.c. Saving SOAPnotes"]
This is the page where you do your creative work with SOAPnotes. Saving your work frequently is strongly recommended. You may also backup your SOAPnotes offline. The menu for saving SOAPnotes changes depending on whether you are viewing the working Form or editing the Markup. You can toggle between these by clicking on “View” in the upper right.

If you’re in the Form View OR the Markup View, you can save the text as your own SOAPnote by clicking on “Save” and then “Personal”. It’ll ask for a Title, Category, and Tags. If you click “Private” it will only be viewable by you. Otherwise, it will be publicly shared. You can make your public SOAPnote pages private or vice versa by opening and clicking or un-clicking the “Private” box and then saving it again.

If you’re on the Markup View, you can save the text file to your computer. Again, I recommend doing this often as you are editing so you don’t lose your work if something happens to your connection or there’s some other problem.

[link mark="CONTENTS" memo="CONTENTS"]

[mark name="5. BASIC SOAPNOTE FIELDS" mark="5. BASIC SOAPNOTE FIELDS"]
[mark name="5.a. Suggestions for Getting Started" name="5.a. Suggestions for Getting Started"]
To save you time, there are a few suggestions that I have before you dive in.
- Have a plan - making a Soapnote is like a reverse engineering process. Start with good clinical documentation and work backwards.
- Start small - try a few small templates before you try to put together the grand unifying medical calculator.
- Revise the wheel, don't reinvent it - there's probably already something similar to what you're trying to do - find it, copy it, and customize it for your needs.
- Save your work early and often.
- Complex isn't always better. Forms affect efficiency. There probably is a sweet spot for the proportions of user input versus boilerplate. My opinion is that lots of clicking, selecting, and checking takes my hands off the keyboard and slows me down. I really hate lots of checkboxes, especially if I going back and forth between selecting and typing text. Clicking is great for patients filling out forms and for nicely formatted calculators, but it's horrible for a provider trying to get through a visit.
- You can post a simple boilerplate SOAPnote in a matter of moments. You can always come back to it later and pepper it with SOAPnote Tags to make it more interactive.

[link mark="CONTENTS" memo="CONTENTS"]

[mark name="5.b. Boilerplate" memo="5.b. Boilerplate"]
[link url="https://soapnote.org/sample/boilerplate-2/" memo="Open this as new page"]
This is simply text entered into a form. Nothing interactive or customized here. Sometimes simple is better.

Note for example below: To switch views between the Active Form and Markup Code, click on "View" in the upper right of this page. Then choose "Form" to see the Active Form or choose "Markup" to reveal the Markup Code. For this one, both views of the Latin text below are the same. As you go on through the tutorial, you'll get to see more features in action.

Example:
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec turpis metus, blandit feugiat suscipit nec, ullamcorper vel risus. Maecenas ut risus elit, vel varius odio. Fusce et sem nec lacus venenatis faucibus. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Morbi nulla lacus, tincidunt vitae dignissim sed, dapibus ut dui. Proin tincidunt justo quis diam ultrices rhoncus. Sed sodales vestibulum felis id dictum. Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. Proin pharetra tincidunt erat, pharetra gravida est ultricies non. Suspendisse ac lacinia odio. Aliquam nunc lorem, ornare vel sollicitudin non, vehicula vitae orci. Fusce sollicitudin dui varius magna dictum eget imperdiet dolor euismod. Vestibulum ante ipsum primis in faucibus orci luctus et ultrices posuere cubilia Curae; Class aptent taciti sociosqu ad litora torquent per conubia nostra, per inceptos himenaeos.

[link mark="CONTENTS" memo="CONTENTS"]

[mark name="5.c. Text Boxes" memo="5.c. Text Boxes"]
[link url="https://soapnote.org/sample/text-boxes/" memo="Open this as new page"]
This displays a small text box for entry of a few words.
Optional parameters are name, memo, default, and size
Note for examples below: To switch views between the Active Form and Markup Code, click on "View" in the upper right of this page. Then choose "Form" to see the Active Form or choose "Markup" to reveal the Markup Code.

Example 1 - Basic Text Box
[text]

Example 2 - Text Box with Default Text
[text name="text1" default="sample text"]

Example 3 - Larger Text Box
[text default="sample text 2" size=100]

[link mark="CONTENTS" memo="CONTENTS"]

[mark name="5.d. Text Areas" memo="5.d. Text Areas"]
[link url="https://soapnote.org/sample/text-areas/" memo="Open this as new page"]
This displays a larger text box for entry of a few words.
Optional parameters are name, memo, cols, rows, fillable, and default

Note for examples below: To switch views between the Active Form and Markup Code, click on "View" in the upper right of this page. Then choose "Form" to see the Active Form or choose "Markup" to reveal the Markup Code.

Example 1 - Basic Text Area
[textarea name="variable_1"]

Example 2 - Text Area with Default Text
[textarea name="variable_2" memo="sample text area" default="enter text here"]

[mark name="5.d.1. Text Areas with Lots of Default Text" memo="5.d.1. Text Areas with Lots of Default Text"]
[link url="//www.soapnote.org/sample/text-areas-multiple-lines/" memo="Open this as new page"]
You can have a Text Area with multiple lines of text if you separate each line with '\n'.
You can have a Text Area with indented lines if you put '\t' before the line.

Note for examples below: To switch views between the Active Form and Markup Code, click on "View" in the upper right of this page. Then choose "Form" to see the Active Form or choose "Markup" to reveal the Markup Code.

Example 1:
[textarea name="variable_1" memo="multiple lines of default text" default="line 1\nline 2\nline 3\nline 4"]

Example 2:
[textarea name="variable_2" memo="multiple lines of default text with indent" default="sample text\nsample2\n\tindented\nback again"]

[link mark="CONTENTS" memo="CONTENTS"]

[mark name="5.d.2. Fillable Text Areas" memo="5.d.2. Fillable Text Areas"]
[link url="https://soapnote.org/sample/fillable-text-areas/" memo="Open this as new page"]
This is an optional feature of Text Areas.
When this is enabled, this feature allows you to hop between every six asterisks in the Text Area to make your edits. You can hop by clicking on the "Fillable" button or by pressing CTRL plus the left or right arrow. The fillable text can just be 6 (six) asterisks or all the text between two sets of 3 (three) asterisks.

Note for example below: To switch views between the Active Form and Markup Code, click on "View" in the upper right of this page. Then choose "Form" to see the Active Form or choose "Markup" to reveal the Markup Code.

Example 1:
[textarea name="variable_1" memo="sample text area" default="enter ***text*** here or here****** or ******" fillable="true"]

Example 2:
[textarea fillable="true" default="item 1\nitem 2\n***item 3***\n******item 4\nitem 5******\n***item 6\n\titem 7***"]

[link mark="CONTENTS" memo="CONTENTS"]

[mark name="5.e. Dates" memo="5.e. Dates"]
[link url="https://soapnote.org/sample/dates/" memo="Open this as new page"]
The Date Tag displays a box for entering dates. A calendar pops up when you click on it (you can also type in the date).
Optional parameters are name, memo, and default

Note for examples below: To switch views between the Active Form and Markup Code, click on "View" in the upper right of this page. Then choose "Form" to see the Active Form or choose "Markup" to reveal the Markup Code.

Example 1:
[date name="date1"]

Example 2:
[date name="date2" default="today"]

[link mark="CONTENTS" memo="CONTENTS"]

[mark name="5.f. Radio Buttons" memo="5.f. Radio Buttons"]
[link url="https://soapnote.org/sample/radio-buttons-2/" memo="Open this as new page"]
The Radio Tag displays buttons where only one item can be selected. In the output, each choice displays with '+' (for selected) or '-' (not selected) next to each item.

The only required parameter is value.
The only optional parameter is name.

Note for example below: To switch views between the Active Form and Markup Code, click on "View" in the upper right of this page. Then choose "Form" to see the Active Form or choose "Markup" to reveal the Markup Code.

Example:
Employment type: 
[radio value="Full Time|Part Time|Unemployed"]

[link mark="CONTENTS" memo="CONTENTS"]

[mark name="5.g. Check Boxes" memo="5.g. Check Boxes"]
[link url="https://soapnote.org/sample/check-boxes-2/" memo="Open this as new page"]
The Checkbox Tag displays boxes where more than one item can be selected. In the output, only selected items display.

The only required parameter is value.
Optional parameters are name and memo.

Note for examples below: To switch views between the Active Form and Markup Code, click on "View" in the upper right of this page. Then choose "Form" to see the Active Form or choose "Markup" to reveal the Markup Code.

Example 1:
[checkbox value="option A|option B|option C"]
Example 2:
[checkbox name="cb1" value="upper extremity|lower extremity|neck|back|knee"]

[link mark="CONTENTS" memo="CONTENTS"]

[mark name="5.h. Checklists" memo="5.h. Checklists"]
[link url="https://soapnote.org/sample/checklists/" memo="Open this as new page"]
The Checklist Tag displays boxes where more than one item can be selected. In the output, all choices display with '+' (for selected) or '-' (not selected) next to each item.
The only required parameter is value.
Optional parameters are name and memo.

Note for example below: To switch views between the Active Form and Markup Code, click on "View" in the upper right of this page. Then choose "Form" to see the Active Form or choose "Markup" to reveal the Markup Code.

Example:
[checklist value="option A|option B|option C"]

[link mark="CONTENTS" memo="CONTENTS"]

[mark name="5.i. Drop Down (Select) Boxes" memo="5.i. Drop Down (Select) Boxes"]
[link url="https://soapnote.org/sample/drop-down-2/" memo="Open this as new page"]
The Select Tag displays a drop down box where only one item can be selected.
The only required parameter is value.
The optional parameters are name and memo.

Note for examples below: To switch views between the Active Form and Markup Code, click on "View" in the upper right of this page. Then choose "Form" to see the Active Form or choose "Markup" to reveal the Markup Code.

Example 1:
[select value="choice A|choice B|choice C"]

Also, numeric values (for calculations) can be set by using the 'equals sign' in the name parameter. This comes in handy with calculations (later in this tutorial).
Example 2:
[select name="letters" value="choice A=1|choice B=2|choice C=3"]

[link mark="CONTENTS" memo="CONTENTS"]

[mark name="5.j. Comments" memo="5.j. Comments"]
[link url="https://soapnote.org/sample/comments/" memo="Open this as new page"]
Comments do not show up in output but do display in the form.
The only required parameter is memo - it is the text that is displayed in the form (but not the result).
Note for example below: To switch views between the Active Form and Markup Code, click on "View" in the upper right of this page. Then choose "Form" to see the Active Form or choose "Markup" to reveal the Markup Code.

Example:
[comment memo="Text that will not show up in output"] Click on "Calculate Result" to see the output.

[link mark="CONTENTS" memo="CONTENTS"]

[mark name="5.k. Links" memo="5.k. Links"]
[link url="https://soapnote.org/sample/links/" memo="Open this as new page"]
Link Tags can take you to other web pages or to locations within the current form. They are a huge part of this tutorial, so you've probably seen these tags for a while now.

Optional parameters are url, mark, and memo
"url" is the complete web address (including http://).
"mark" is used for internal links.
"memo" is the text to be displayed.

Note for example below: To switch views between the Active Form and Markup Code, click on "View" in the upper right of this page. Then choose "Form" to see the Active Form or choose "Markup" to reveal the Markup Code.

Example:
[link url="https://www.soapnote.org" memo="SOAPnote Home"]

[link mark="CONTENTS" memo="CONTENTS"]

[mark name="5.l. Marks" memo="5.l. Marks"]
[link url="https://soapnote.org/sample/marks/" memo="Open this as new page"]
A Mark Tag allows you to jump from one place in a form to another. It's like a placeholder or bookmark in the form. A Link Tag is needed to send the user to a Mark.

The required parameter is name.

Note for example below: To switch views between the Active Form and Markup Code, click on "View" in the upper right of this page. Then choose "Form" to see the Active Form or choose "Markup" to reveal the Markup Code.

Example:
[link memo="go to the mark" mark="mid-blah"]
blah
blah
blah
blah
blah blah blah
blah
blah
blah
blah
blah
blah
blah
[mark name="mid-blah"]
blah
blah
blah
blah
blah
blah
blah

[link mark="CONTENTS" memo="CONTENTS"]

[mark name="6. ADVANCED SOAPNOTE FIELDS" memo="6. ADVANCED SOAPNOTE FIELDS"]
[mark name="6.a. Prepopulated Text" memo="6.a. Prepopulated Text"]
[link url="https://soapnote.org/sample/prepopulated-text/ memo="Open this as new page"]
This is a great feature to help customize your forms. It draws from the optional demographic user information saved in your profile.

The Prepopulated Text Tags include: "organization", "address_line_1", "address_line_2", "city", "state", "postal_code", "phone", "fax", "website", and "email".

Additionally, there are three 'general-use' Prepopulated Text Tags that may be used however you wish. These are "blurb_1", "blurb_2", and "blurb_3".

Note for example below: To switch views between the Active Form and Markup Code, click on "View" in the upper right of this page. Then choose "Form" to see the Active Form or choose "Markup" to reveal the Markup Code.

Example (the only Prepopulated Text Tag that would work for most (logged on) users is the "email" tag):
My email address is: [email].

[link mark="CONTENTS" memo="CONTENTS"]

[mark name="6.b. Reserved Variables" memo="6.b. Reserved Variables"]
[link url="https://soapnote.org/sample/reserved-variables/" memo="Open this as new page"]
A variable can have any name that you choose. However, you may wish to name the variables for your forms using the Reserved Variable Names.

The purpose of Reserved Variables is that these will be used for exporting and retrieving form content.

The Reserved Variable Names are "variable_1", "variable_2", ... all the way to "variable_50".

Each SOAPnote that you make may use any or all of these variables.

[link mark="CONTENTS" memo="CONTENTS"]

[mark name="6.c. Recalling Variables" memo="6.c. Recalling Variables"]
[link url="https://soapnote.org/sample/recalling-variables/" memo="Open this as new page"]

Variables can display named variables from other parts entered above in a form. It displays in the output, not in the form.

There is only one parameter – ‘name’. Variable names can’t contain spaces.

Example:
Date of birth: [date name="variable_1"]
Here is the date of birth again: [var name="variable_1"]

[link mark="CONTENTS" memo="CONTENTS"]

[mark name="6.d. Adding Conditions" memo="6.d. Adding Conditions"]
[link url="https://soapnote.org/sample/adding-conditions/" memo="Open this as new page"]
This powerful feature involves an opening and a closing Conditional Tag - both are needed for it to work.
You can set conditions for showing or hiding of form elements. If the condition is met, everything between the opening and closing Conditional Tags will be shown. If it is not met, it will not be displayed on the form and will be ignored in the output.

An optional (but strongly recommended) parameter is "field". This is used to identify the variables you are going to be setting up to a condition. These forms will work if you don't identify a variable (or variables) with the "field" parameter, but they may go quite a bit more slowly. To identify multiple variables, separate the variable names with pipes "|".

Operators are required to evaluate the condition.
These are operators within an individual comparison:
isLess
isGreater
isLessOrEqual
isGreaterOrEqual
is
isNot

These are operators for combining multiple comparisons
&& is the "AND" operator
|| is the "OR" operator

Note for example below: To switch views between the Active Form and Markup Code, click on "View" in the upper right of this page. Then choose "Form" to see the Active Form or choose "Markup" to reveal the Markup Code.

Example:
Employment type: [radio name="job" value="Full Time|Part Time|Unemployed"]
[conditional field="job" condition="(job).is('Full Time')||(job).is('Part Time')"]Job title: [text name="job_title"][/conditional]

Another good example is [link url="//www.soapnote.org/sample/conditional-comparison/" memo="at this page"].

Please note that with these comparison operators, blank/empty fields would be considered as 0, so
(field1).isLess(5) will always be true if "field1" is blank. (Because 0 is less than 5)

[link mark="CONTENTS" memo="CONTENTS"]

[mark name="6.e. Performing Calculations" memo="6.e. Performing Calculations"]
[link url="https://soapnote.org/sample/performing-calculations/" memo="Open this as new page"]
You can perform calculations that manipulate variables.
This powerful feature of the site and can be used in two ways - computing numbers and interpreting results (ranges of numbers).
Parameters include value, memo, and show.
"value" has some special formatting which can be tricky.
"memo" is used to label the calculation or for some helper text.
"show" is useful for hiding a calculation performed earlier in a form that you don't want to reveal until further on down in the form (this seems esoteric but it does come up occasionally).

[link mark="CONTENTS" memo="CONTENTS"]

[mark name="6.e.1. Calculations - Simple Computations" memo="6.e.1. Calculations - Simple Computations"]
[link url="https://soapnote.org/sample/simple-computations-2/" memo="Open this as new page"]
Note for example below: To switch views between the Active Form and Markup Code, click on "View" in the upper right of this page. Then choose "Form" to see the Active Form or choose "Markup" to reveal the Markup Code.

In the example below, basic computations such as addition, subtraction, multiplication, and division is performed on numbers gathered with Text ([text]) input fields.

Example:
This calculator performs simple computations
[text name="A"] <-- A (enter a number)
[text name="B"] <-- B (enter a number)

A + B --> [calc value="score1=(A)+(B)" memo="addition"]
A - B --> [calc value="score2=(A)-(B)" memo="subtraction"]
A x B --> [calc value="score3=(A)*(B)" memo="multiplication"]
A / B --> [calc value="score4=(A)/(B)" memo="division"]
A raised to the power of B --> [calc value="score5=Math.pow((A),(B))" memo="exponent"]

You can see that the Calc Tag has a certain format to it.
"value" contains the entire computation in double quotes.
"score1" is a required name for the computation. In the sample, you see that value is set equal to "score1", "score2", "score3", "score4", and "score5". A new name is needed for each computation, but it can be more descriptive than "score1".
"A" refers to the name of the first Text Box Tag.
"B" refers to the name of the second Text Box Tag.
In between "A" and "B" is the operator (+, -, *, and /).
The result shows up in the result box after "Calculate Result" is pressed.
Here are [link url="//soapnote.org/sample/calculation/" memo="more sample calculators"].

[link mark="CONTENTS" memo="CONTENTS"]

[mark name="6.e.2. Calculations - Interpreted Results" memo="6.e.2. Calculations - Interpreted Results"]
[link url="https://www.soapnote.org/sample/interpreted-results/" memo="Open this as new page"]

Interpreted Results are a special type of calculation. A sample with an interpreted result is [link url="//www.soapnote.org/sample/interpreted-computation/" memo="HERE"].
This feature is valuable because it allows you to group ranges of results.

Note for example below: To switch views between the Active Form and Markup Code, click on "View" in the upper right of this page. Then choose "Form" to see the Active Form or choose "Markup" to reveal the Markup Code.

Example:
This calculator performs interpreted calculation
[text name="A"] <-- A (enter a number)
[text name="B"] <-- B (enter a number)

A + B –> [calc value="score2=(A)+(B);score2>1000?'Sum is greater than 1000':score2>100?'Sum is greater than 100 and less than or equal to 1000':score2>10?'Sum is greater than 10 and less than or equal to 100':score2>0?'Sum is greater than 0 and less than or equal to 10':'sum is 0 or less'" memo="interpretation"]

As you can see above, it has most of the same elements as a simple calculation. The interpretation information follows the calculation after a semicolon.
Since an interpretation is a separate calculation it must have a distinct name (score2).
The computation follows ((A)+(B)).
Semicolon separates the computation from the interpretation (;).
Ranges are then interpreted from highest to lowest, each is separated by a colon (:).
The highest value is score2>1000?. The output follows this in single quotes. Then a colon.
The next value is score2>100?. The output follows this in single quotes. Then a colon.
The next value is score2>10?. The output follows this in single quotes. Then a colon.
The lowest value is not specifically labeled like the others. The output alone is listed for everything lower than the range above it.
This is definitely best understood by looking at the example again it's [link url="//soapnote.org/sample/interpreted-computation/" memo="RIGHT HERE"].

[link mark="CONTENTS" memo="CONTENTS"]

[mark name="7. USEFUL TOOLS AND FEATURES" memo="7. USEFUL TOOLS AND FEATURES"]
[mark name="7.a. The SOAPnote Helper Tool" memo="7.a. The SOAPnote Helper Tool"]
The [link url="//soapnote.org/generator/" memo="Create Page"] has a 'Helper Tool' to assist with building SOAPnote forms and calculators.

You'll see a menu titled 'Tool' near the top of the screen. When you choose that, you'll activate the Helper Tool and can choose from different SOAPnote Tags to build. It's useful for double checking parameters and format of these tags.

[link mark="CONTENTS" memo="CONTENTS"]

[mark name="7.b. Quick Fill Buttons" memo="7.b. Quick Fill Buttons"]
The [link url="//soapnote.org/generator/" memo="Create Page"] has 'Quick Fill Buttons' to assist with building SOAPnote forms and calculators.

You'll see a series buttons at the left running vertically on the screen. When you click a button, it will insert a form field at the location of the cursor.

[link mark="CONTENTS" memo="CONTENTS"]

[mark name="7.c. Hacks and Tricks" memo="7.c. Hacks and Tricks"]
- [link memo="Text Areas" url="//soapnote.org/sample/text-areas"] with default text are the best way to showcase a good SOAP note and also serve as useful templates to other people.
- The Muskuloskeletal Exams page is actually several sets of Text Areas. By choosing an exam at the top [link memo="Select Box" url="//soapnote.org/sample/drop-down"], [link memo="Conditional" url="//soapnote.org/sample/conditional"] elements hide or reveal the proper Text Areas. See it [link url="//www.soapnote.org/musculoskeletal/musculoskeletal-exams/" memo="Here"].
- The default width for Text Areas is set to work with any device. Sometimes it seems to narrow for bigger forms, though. Setting the columns ('cols') parameter to 65 is a good compromise - It's the largest width that will still display well on most mobile devices and desktop computers. See it [link url="//www.soapnote.org/musculoskeletal/low-back-pain-exam/" memo="Here"]

[link mark="CONTENTS" memo="CONTENTS"]

[mark name="7.d. All Samples" memo="7.d. All Samples"]
[link url="https://www.soapnote.org/category/sample/" memo="View all Samples"]

[link mark="CONTENTS" memo="CONTENTS"]

[mark name="8. VIDEO TUTORIALS" memo="8. VIDEO TUTORIALS"]
[mark name="8.a. Video Tutorial – Copy, Modify, and Save a SOAPnote" memo="8.a. Video Tutorial – Copy, Modify, and Save a SOAPnote"]
[link url="https://soapnote.org/sample/video-copy-modify-save/" memo="View Video Tutorial"]

[link mark="CONTENTS" memo="CONTENTS"]

Please [link memo="let us know" url="https://www.soapnote.org/help/"] if you have any questions, comments, or suggestions (general or specific).