Admin: Note Assist Batch Audit

Using Note Assist Batch Audits you can run existing patient notes through a Note Assist audit to identify gaps in required information. This powerful feature helps you quickly spot documentation issues and determine which clinicians may benefit from targeted coaching.

Information from batch audits is not saved in nVoq Administrator and does not count towards Note Assist usage.


Run a Batch Audit

  1. You can run a batch file of narratives from your EMR against a Note Assist audit to see if existing narratives match audit categories.
    Information from batch audits is not saved in nVoq.Administrator and does not count towards Note Assist usage.
    1. Do a bulk export of patient narratives from your EHR -OR- create your own audit file using our template.

    2. Prepare exported data for the batch audit:
      1. Pull out any narratives you do not want to include in the batch audit.
        1. In Microsoft Excel, select the entire spreadsheet by clicking on the arrow in the top left corner of the spreadsheet (between the A column and the 1 row).
        2. Click the filter button to add filter menus to the heading columns.
        3. On the column that displays the narrative type, click the arrow next to the heading to open the sort window. 
        4. In the sort window, uncheck the box next to any narratives you do not want to include in the audit.
        5. With only the narratives you selected and the entire spreadsheet still selected, click Crtl+C on your keyboard (to copy selected narratives), and Ctrl+N (to create a new spreadsheet), and Ctrl+V (to paste copied data into the new spreadsheet). This new spreadsheet is your upload file for the batch audit.
        6. Name your new file and save it in a HIPAA-compliant location. This may be the hard drive on your computer. Do not save it to a shared network folder.
      2. Ensure that your file has the three required headers/columns:
        1. Your file must include - in any order - three columns: Narrative Date, Narrative, and Name:
          1. The Narrative Date column includes the date that the narrative was created. The header name is not case-sensitive, and other header names, such as "narrative signed date" may also be accepted. The information in this column needs to be a date, but many formats of date (including dates with time and milliseconds) are accepted.
          2. The Narrative column includes the actual patient narrative text. The header name is not case-sensitive, and other header names, such as "narrative text" may also be accepted.
          3. The Name column includes the name of the clinician who created the narrative. The header name is not case-sensitive, and other header names, such as "worker" may also be accepted. The clinician name does not need to have a corresponding nVoq account.
        2. Your file can have additional columns. These will be ignored by the system, but will still appear in the output file.
        3. Save your file.
      3. Eliminate any hidden formulas that may be in your file from the extraction process from your EHR to prevent errors during processing.
        1. Select the first column that has no data.
        2. With the column selected, press Ctrl+Shift+Right-Arrow key on your keyboard.
        3. Press Delete on your keyboard to delete all of the columns that may have hidden data.
        4. Select the first row that has no data.
        5. With the row selected, press Ctrl+Shift+Down-Arrow key on your keyboard.
        6. Press Delete on your keyboard to delete all of the rows that may have hidden data.
        7. Save your file.
      4. Make sure all the remaining narrative fields actually have data in them. (You may have some rows with empty narrative cells.)
        1. Type the word "BLANK" in each empty narrative field to show that noting was recorded by the clinician and to ensure you do not receive the "missing value" error from nVoq Administrator. (A speed method is to sort the narrative column A to Z and then review the last few rows of your spreadsheet to see whether there are are any blank narrative fields. Type BLANK in the first empty field, then select that cell and the rest of the empty narrative cells, and use Ctrl+D to fill down.)
        2. Save your file.

    3. Run the audit in nVoq Administrator: 
      1. Go to the Note Assist page and click on the Audits tab (it should be selected by default).

      2. Click the actions menu next to the audit you want to run a batch file against and select Run Batch Audit.
        NoteAssist-batch-audit-run-batch-audit-1OR Double click on the audit to open the Edit Note Assist Audit page, then click the Run Batch Audit iconToolbar-RunBatchAudit-iconin the blue toolbar.
        NoteAssist-batch-audit-run-batch-audit-2

      3. On the Note Assist Batch Audits page, click on the Choose a file link in the dotted line box and navigate to your saved file, OR drag your file from an open directory into the dotted line box. 
        1. The maximum file size is 6MB.
        2. Run the audit against one file at a time.
        3. Only the first sheet in the file will be included in the audit run; any additional sheets will be ignored.
          NoteAssist-batch-audit-choose-file

      4. The system will check the file for missing required columns, column names, or data, and to make sure it does not exceed the maximum file size.
        1. If no issues exist, go to step 5.
        2. If information is missing or the file is too large that information will be presented below the file box. Click the X next to the file name to remove it from the page, fix the errors in the file, and then try the upload again.
          NoteAssist-batch-audit-file-issues

      5. When your file looks good, click the Run button.NoteAssist-batch-audit-run

    4. When processing is complete your output file is downloaded automatically to your local Downloads folder. 
      • The output file name is the same as the original file name prepended with the current date
      • If the file was unable to run you will see a red popup notification explaining why the batch request was unable to run, and that information is also available in the notifications list.
        NoteAssist-batch-audit-unable-to-run-error

Analyze Batch Audit Results

  1. Go to your Downloads folder to open the output file.
  2. The output file includes the Narrative, Narrative Date, and Name columns, any extra columns that were included in the file, a column for the Audit Name against which the batch was run, and a column for each category in the audit. Each category shows either TRUE (if the category was included in the Narrative text) or FALSE (if the category was missing from the Narrative text) for each narrative in the report.
  3. Click the Enable Edit button near the top of the Excel file.
  4. Rename the sheet that includes the results to "Audit Results."
    1. Double-click on the text on the tab.
    2. Type over the original tab name.
  5. Click on the New Sheet iconNoteAssistBatch-Excel-icon-AddSheetnear the sheet tab to create a second sheet and name it "Analysis."
  6. Copy the data from the Audit Results sheet to the Analysis sheet. This gives you a place to analyze the data without changing the formatting of the original results.
    1. Select the entire Audit Results sheet by clicking on the arrow in the top left corner of the spreadsheet (between the first column and first row).
    2. Press Ctrl+C on your keyboard to copy the selected data.
    3. Click the Analysis sheet tab.
    4. Place your cursor in the A1 box and press Ctrl+V to paste the audit results into the Analysis sheet.
  7. Make the category data numerical.
    1. Select all of the category columns.
    2. Press Ctrl+H on your keyboard to open the Find and Replace window.
    3. In the Find and Replace window, in the Find What box enter "false," and in the Replace With box enter zero ("0").
    4. Click the Replace All button.
    5. Still in the Find and Replace window, in the Find What box enter "true," and in the Replace With box enter one ("1").
    6. Click the Replace All button.
    7. Close the Find and Replace window.
  8. Add highlighting to category data cells to make it easier to differentiate the results.
    1. Select all of the category columns. (They may still be selected from the previous step.)
    2. In the Excel toolbar ribbon in the Styles section, click on the Conditional Formatting to open a menu.
    3. On the Conditional Formatting menu, click Highlight Cell Rules to open another menu.
    4. On the Highlight Cell Rules menu, click Text That Contains.
    5. In the Text That Contains window in the Format cells that contain the text box, enter 0 (zero) and in the with menu, select "Light Red Fill with Dark Red Text" (this may already be selected by default).
    6. Click the OK button.
    7. With category columns still selected, click Conditional Formatting to open a menu.
    8. On the Conditional Formatting menu, click Highlight Cell Rules to open another menu.
    9. On the Highlight Cell Rules menu, click Text That Contains.
    10. In the Text That Contains window in the Format cells that contain the text box, enter 1 (one) and in the with menu, select "Green Fill with Dark Green Text."
    11. Click the OK button.
  9. Calculate the total "score" for each narrative.
    1. In the first blank column header to the right, enter "Total"
    2. Select all of the numerical column results for the first narrative (Row B).
    3. Click the AutoSum button (in the Editing section of the ribbon toolbar).
    4. Double-click the lower right corner of the cell showing the sum. This will carry the AutoSum function down through the remaining rows.
  10. Put a filter on all of the data in the sheet so you can filter on anything as you analyze results.
    1. Select all columns with data.
    2. Click Sort & Filter (in the Editing section of the ribbon toolbar), and select Filter.
  11. Calculate the sums and percentages of each category that was met in the audit.
    1. Create a cell for Total Narratives Audited: In one cell type Total Narratives Audited, and in the cell next to it enter the total number of narratives that were audited. (The total number of narratives audited is one less than the total number of rows of data on your spreadsheet.)
    2. Below your Total Narratives Audited, add three columns titles: Category, Number of Narratives that Met Category, and Percentage of Narratives that Met Category.
    3. Below the Category column, enter (or copy and paste) the name of each category in a separate cell.
    4. Place your cursor in the first cell below the Number of Narratives that Met Category column heading and enter =SUM then add an opening parenthesis ((). Click on the letter of the column you want to sum. Finally add the closing parenthesis ()) to your formula, then press Enter on your keyboard. For example, =SUM(F:F) 
    5. Repeat the previous step for each category below the Number of Narratives that Met Category heading. 
    6. Place your cursor in the first cell below the Percentage of Narratives that Met Category column heading and enter equality sign (=) then click on the cell that includes the Number of Narratives that Met Category for that row. Enter a forward slash (/) and then click on the number of Total Narratives Audited and press Enter on your keyboard. For example, =Q3/Q1 
    7. With your cursor on the cell of the formula you just entered, click the % button (in the Number section of the ribbon toolbar) to change the result in that cell from a decimal to a percentage. 
    8. Repeat the previous two steps for each category below the Percentage of Narratives that Met Category heading.
  12. Create a chart of the data from the sums and percentages of each category met.
    1. Select the cells that include the data you just created below the Total Narratives Audited.
    2. Click the Quick Analysis icon that appears in the lower right corner of the selected cells.
    3. On the menu that opens, select Charts.
    4. Click More to open the Insert Chart window and see all of the charts you have available.
    5. In the Insert Chart window, select the chart you want to create. (In this example I have selected "Clustered Column")
    6. Drag the chart anywhere you want it on the sheet, and resize by dragging the chart area handles. 
    7. Add an appropriate chart title by double clicking on the Chart Title text, selecting it, and typing over it.
  13. Calculate the number of categories met, number of total narratives, and percentage of narratives by number of categories met.
    1. Create three column titles: Number of Categories Met, Total Narratives, and Percentage of Narratives by Number of Categories Met.
    2. Under the Number of Categories Met column enter the total number of categories in the first cell, then count down to 1 in each cell under that. For the final cell (below 1) type None.
    3. Select the first cell below Total Narratives and enter =COUNTIF and add an opening parenthesis ((). Click on the letter of Total column, add a comma (,) and then click on the cell that includes the first Number of Categories Met. Finally add the closing parenthesis ()). For example, =COUNTIF(N:N,P14)
    4. Repeat that process for each cell below to ensure the formula incorporates the cell to the left. When you get to the final cell next to "None," instead of selecting the cell to the left, type 0 (zero) in the formula. (For example, =COUNTIF(N:N,0) 
    5. To make sure the math is correct sum up the Total Narratives column and make sure you get the same as the Total Narratives Audited. You can do this quickly by selecting all of the total in the column you just created and clicking the AutoSum button (in the Editing section of the ribbon toolbar). It should be the same as the Total Narratives Audited.)
    6. Place your cursor in the first cell below the Percentage of Narratives by Number of Categories Met column heading and enter equality sign (=). Click on the cell that includes the Total Narratives number for that row, enter a forward slash (/) and then click on the cell that includes the Total Narratives Audited number and press Enter on your keyboard. For example, =Q3/Q1 With your cursor on the cell of the formula you just entered, click the % button (in the Number section of the ribbon toolbar) to change the result in that cell from a decimal to a percentage.
    7. Repeat the previous step for each of the number of categories met rows below the Percentage of Narratives by Number of Categories Met heading. (Copying and pasting the formula does not work here.)
    8. To make sure your math is correct use AutoSum again to sum the percentages you just added and make sure you get 100%.
  14. Create a chart of the data from number of categories met, number of total narratives, and percentage of narratives by number of categories met.
    1. Select the cells that include the data you just created (not counting the sums at the bottom).
    2. Click the Quick Analysis icon that appears in the lower right corner of the selected cells.
    3. On the menu that opens, select Charts.
    4. Click More to open the Insert Chart window and then click the All Charts tab in that window.
    5. In the Insert Chart window under the All Charts tab, select Pie, then click the OK button.
    6. Drag the chart anywhere you want it on the sheet, and resize by dragging the chart area handles. 
    7. Add an appropriate chart title by double clicking on the Chart Title text, selecting it, and typing over it.

Download the Batch Audit Template

On the Run Batch Audit page, use the Download audit template file link to create your own file.
NoteAssist-batch-audit-download-template

  • The template includes the required columns on the batch file: 
    • Narrative - The clinical note text that will be run against the selected audit.
    • Narrative Date - The date that the narrative was created.
    • Name - The name of the person who created the narrative. This name does not need to have a corresponding nVoq account.