Creating Toggles

Creating Toggles is an advanced functionality in SOAPware.

Before a user would create his/her own toggles the user should:

  1. Have an understanding of what a Toggle is and how it functions.
  2. Have a basic knowledge of SMARText including creating macros and pick lists.

*Note: Toggle SMARText Items are not EM Coder compatible.

Anatomy of the Finished Toggle

Anatomy of the Finished Toggle

The screen shot above depicts a finished toggle, and its components.

Step 1 - Create Structured Text Items

Step 1 - Create Structured Text Items

Toggles are created "from the ground up," meaning, the user is to first create each component prior to putting the toggle together as a whole.  

Structured Text SMARText items will be the components that will be used to "toggle" between, in the user's documentation.

  1. Click on Docutainers > SMARText Items or Click F10 on the keyboard.
  2. Click on the green plus within the SMARText Items Manager.
  3. Select Structured Text.
  4. Click Create.

SMARText Designer: Structured Item

SMARText Designer: Structured Item

For demonstration purposes, we will create a fruit toggle, that will allow us to report what fruits are our favorites, and what fruits we deny that we like.  

We are currently creating our individual fruits, which will serve as our structured text, or the components of our toggle.

  1. Give the item a description. *Structured items do not require or need a shortcut.
  2. Give the item keywords. (all keywords need to be separated by a comma and space and be sure to have a unifying keyword that will be used for quick retrieval of all a user's SMARText created items)
  3. In  the Item Settings box, under Text (Singular), type the word or words to be displayed in the documentation.
  4. Click Save.

Repeat steps 1-4 for each Structured Item.

Step 2 - Create an Item Cluster

Step 2 - Create an Item Cluster

An Item Cluster combines all our previously made Structured items into one SMARText item group, which eliminates individual dragging and dropping of each item.

  1. Click on Docutainers > SMARText Items or click F10 on the keyboard.
  2. Click on the green plus within the SMARText Items Manager.
  3. Click Custom and Click on the drop-down arrow.
  4. Click on the + (expander node) next to Generic.  Then click on the + next to Lists, and double-click on Item Cluster.
  5. Click Create.

 

SMARText Designer: Item Cluster

SMARText Designer: Item Cluster
  1. Give Item Cluster a description. *An Item Cluster does not require or need a shortcut.
  2. Give Item Cluster keywords.  (All keywords need to be separated by a comma and space and be sure to have a unifying keyword that will be used for quick retrieval of all a user's SMARText created items).
  3. Drag the SMARText Items Manager to the left side of the screen and the SMARText Designer to the right side of the screen.
  4. In the SMARText Items Manager, type in the unifying keyword of the structured items for quick retrieval.  In this case, our unifying keyword is, fruit.
  5. One at a time, click to highlight, then drag and drop each individual structured item into the Item Settings box within the SMARText Designer. The user will see a circle with a line through it-while holding a left-click of the mouse--until the user sees an arrow, meaning he/she is in the clear to release the left-click, and the structured item will be placed into the Item Cluster. Repeat step 5 until all structured items and placed within the Item Settings box within the SMARText Designer.
  6. Click Save.

Step 3 - Create a Toggle Multi-Sel List

Step 3 - Create a Toggle Multi-Sel List

It is time to create a Toggle Multi-Sel SMARText item for each header the user wants the structured items he/she previously built in this lesson, to toggle between while documenting.

For this example, we are going to create a toggle multi-sel list for "Reports favorite fruit as."  A user could also create another list for what the patient denies.  Users could even create lists for positive findings, as well as one for negative findings.  

  1. Click on Docutainers on the menu bar, and select SMARText Items.  Click on the green plus within the SMARText Items Manager.
  2. Click on the radio button next to Custom.
  3. Click on the drop-down arrow.
  4. Click on the + (expander node) next to Generic.  Then click on the + next to Lists, and double-click on Toggle Multi-Sel List.
  5. Click Create.

SMARText Designer: Toggle Multi-Sel List

SMARText Designer: Toggle Multi-Sel List
  1. Give the list a description. *A Toggle Multi-Sel List does not require or need a shortcut.
  2. Give the list keywords. (all keywords need to be separated by a comma and space and be sure to have a unifying keyword that will be used for quick retrieval of all a user's SMARText created items)
  3. Give the list a Display Header.  The header will be what displays within the documentation.
  4. Drag the SMARText Items Manager to the left side of the screen and the SMARText Designer to the right side of the screen.
  5. In the SMARText Items Manager, type in the unifying keyword of the item cluster we made previously, for quick retrieval.  In this case, our unifying keyword is, fruit.
  6. Click to highlight, then drag and drop the item cluster into the Item Settings box within the SMARText Designer. The user will see a circle with a line through it-while holding a left-click of the mouse--until the user sees an arrow, meaning he/she is in the clear to release the left-click, and the item cluster will be placed into the Toggle Multi-Sel list.
  7. Under "Remove this item via Removed Unused," select When Empty.
  8. Click Save.

Repeat steps 1-7 for the next Toggle Multi-Sel List-such as "denies favorite fruit as."

Step 4 - Create a SMARTips Toggle Multi-Sel List

Step 4 - Create a SMARTips Toggle Multi-Sel List

A SMARTips Toggle Multi-Sel list will always be the final multi-sel list created in this process.  The user will use SMARTips, as his/her display header, and this list will function as a holding place for all toggle items.

Unseen in the screen shot above...Click on Docutainers on the menu bar, and Select SMARText Items.  Click on the green plus within the SMARText Items Manager.

  1. Click on the radio button next to Custom.
  2. Click on the drop-down arrow.
  3. Click on the + (expander node) next to Generic.  Then click on the + next to Lists, and double-click on Toggle Multi-Sel List.
  4. Click Create.

SMARText Designer: SMARTips Toggle Multi-Sel List

SMARText Designer: SMARTips Toggle Multi-Sel List
  1. For the description of a SMARTips Toggle Multi-Sel list, use five + signs and the name of the Toggle Multi-Sel List.  For this example, we typed +++++ [space] Fruit. *A SMARTips Toggle Multi-Sel List does not require or need a shortcut.
  2. Give the list keywords. (all keywords need to be separated by a comma and space and be sure to have a unifying keyword that will be used for quick retrieval of all a user's SMARText created items)
  3. As the display header type, +++++.
  4. Drag the SMARText Items Manager to the left side of the screen and the SMARText Designer to the right side of the screen.
  5. In the SMARText Items Manager, type in the unifying keyword of the item cluster we made previously, for quick retrieval.  In this case, our unifying keyword is, fruit.
  6. Click to highlight, then drag and drop the item cluster into the Item Settings box within the SMARText Designer. The user will see a circle with a line through it-while holding a left-click of the mouse--until the user sees an arrow, meaning he/she is in the clear to release the left-click, and the item cluster will be placed into the Toggle Multi-Sel list.
  7. Under "Item Separators," click Separate with.  In the box to the right of "Separate with," indicate to separate with [space] [space] | [space] [space]
  8. Under "Remove this item via Removed Unused," select Always.
  9. Click Save.

Step 5 - Create the Main Toggle Multi-Sel List

Step 5 - Create the Main Toggle Multi-Sel List

We are now going to create the main toggle multi-sel list, which will house all of the previous multi-sel lists we made.

  1. Click on Docutainers on the menu bar, and Select SMARText Items.  Click on the green plus within the SMARText Items Manager.
  2. Click on the radio button next to Custom.
  3. Click on the drop-down arrow.
  4. Click on the + (expander node) next to Generic.  Then click on the + next to Lists, and double-click on Toggle Multi-Sel List.
  5. Click Create.

SMARText Designer: Main Multi-Sel List [Part 1]

SMARText Designer: Main Multi-Sel List [Part 1]
  1. This list WILL need a shortcut!
  2. Give the list a description.
  3. Give the list keywords. (all keywords need to be separated by a comma and space and be sure to have a unifying keyword that will be used for quick retrieval of all a user's SMARText created items)
  4. Give the list a display header.
  5. In the SMARText Items Manager, type in the unifying keyword of all the multi-sel lists we made previously, for quick retrieval.  In this case, our unifying keyword is, fruit.
  6. Click to highlight, then drag and drop each multi-sel list into the Item Settings box within the SMARText Designer. The user will see a circle with a line through it-while holding a left-click of the mouse--until the user sees an arrow, meaning he/she is in the clear to release the left-click, and the Toggle and SMARTips multi-sel lists, will be placed into the main Toggle Multi-Sel list.
  7. Under "Item Separators," click Separate Lines.
  8. Click Save.

Step 6 - Edit the Main Toggle Multi-Sel List

Step 6 - Edit the Main Toggle Multi-Sel List
  1. Click to highlight the main toggle multi-sel list.
  2. Click the edit button.

SMARText Designer: Main Multi-Sel List [Part 2]

SMARText Designer: Main Multi-Sel List [Part 2]
  1. Click on the main header (in our case, Fruit Options) within the large white box. This will bring up SMARText Quick Access.
  2. Select each toggle multi-sel list in SMARText Quick Access, in the order desired.  This will place each sub header within the large white box.

 

SMARText Designer: Main Multi-Sel List [Part 3]

SMARText Designer: Main Multi-Sel List [Part 3]
  1. Click on the SMARTips header within the large white box.  This will bring up the individual structured items within SMARText Quick Access.
  2. Select each structured item, under the SMARTips column within SMARText Quick Access.  The structured item will now be visible within the large white box within the SMARText Designer.
  3. Click Save.

Step 7 - Insert Main Toggle into SOAPnote

Step 7 - Insert Main Toggle into SOAPnote

It's time to insert the toggle into a SOAP Note!

Type your main toggle multi-sel list shortcut into the active header, then hit the F11 button on the keyboard to access the local database since this is the first time the toggle is being used.  (for future occasions of using the toggle, the user can just insert the shortcut and press the space bar)

How to Use the Toggle

How to Use the Toggle

Double-click on a structured item within the SMARTips header, and the item will be placed under the first toggle list. (in our case, Reports Favorite Fruit as:)

Double-click on a SMARTips structured item that has been placed in the first toggle list, to send the item to the second toggle list. (in our case, Denies Favorite Fruit as:)

Extra Tid Bit

Extra Tid Bit

Should a user place a structured item under one of the toggles in the documentation and desire to remove that item from one of the toggle lists, in order to place it back into the SMARTips list, follow the steps listed below.

  1. Click on the SMARTips header.
  2. Re-check the structured item under the SMARTips column within SMARText Quick Access.