Testing WSI with Noah System and the Sample BES. How to use the HIMSA Sample BES Functionality

Testing WSI with Noah System and the Sample BES. How to use the HIMSA Sample BES Functionality

Purpose of this document:  To see if WSI was setup correctly and working.  Also, to show the functionality implemented in the HIMSA Sample BES.

Prerequisites:

*NOTE: All the steps below are done on the same machine.  There is no networking of 2 computers for this.  The purpose of this document is to see if WSI was installed correctly, licensed correctly and it works correctly. This document also shows the functionality of the HIMSA Sample BES.

1.)    The most current version of Noah has been installed and licensed.

2.)    Sample BES has been downloaded from himsa website.

3.)    WSI installer has been run

4.)    WSI license has been installed.

 

Section 1: Is WSI Working?

1.)    Open the HIMSA Sample BES.  By default, unless you have changed it, the “NoahLocation” field should have your local computer name.  If not, you will need to change this.  My local computer is called “IsleRoyale1.”  So, this field has the correct name in my example.

image-20260212-190209.png

1.)    Open Noah System

2.)    Create a new patient record in Noah System

image-20260212-190254.png

1.)    Select “OK” to create the new patient record in Noah System.

2.)    Now Switch back to the HIMSA Sample BES.  You may need to wait 30 seconds.  You should see the data import successfully into the Sample BES.  In the picture below I have highlighted in yellow the successful import.

image-20260212-190320.png

1.)    Now if I select the entry, see the picture below.  It is highlighted blue to indicate I have selected it.  I now right click on the entry and select “Copy XML to clipboard.”

2.)    The xml is below.

<?xml version="1.0" encoding="utf-8"?> <NOAHDataExchange xmlns="http://www.himsa.com/XMLWrapper/XMLWrapper"> <NoahDataExchangeProtocol> <NoahSiteID>ISLEROYALE1</NoahSiteID> <NoahUserID>ABC</NoahUserID> <BusinessSystemUserID>WSI</BusinessSystemUserID> <TransmissionID>0</TransmissionID> <pt:Patients xmlns:pt="http://www.himsa.com/PatientExport/PatientExport"> <pt:Patient> <pt:PatientGUID>{547edb69-ab2e-4bae-bf64-768baf79a788}</pt:PatientGUID> <pt:FirstName>WSI TEST</pt:FirstName> <pt:LastName>WSI Test</pt:LastName> <pt:ActivePatient>true</pt:ActivePatient> <pt:Gender>NotRecorded</pt:Gender> <pt:UserId>ABC</pt:UserId> <pt:CreateDate>2021-12-13T12:26:20</pt:CreateDate> <pt:BackEndSystemPatientId>Noah-547edb69-ab2e-4bae-bf64-768baf79a788</pt:BackEndSystemPatientId> <pt:Actions /> </pt:Patient> </pt:Patients> </NoahDataExchangeProtocol> </NOAHDataExchange>

8.)    IF YOU DO NOT SEE Steps 1-5 STOP.  THERE IS NO POINT IN YOU CONTINUING BECAUSE YOUR WSI DOES NOT WORK. This could be for multiple reasons; WSI installation was done incorrectly and\or your wsi license is invalid.

9.)    Copy the xml into Note pad.

 

10.)     Update the last name to be “WSI TEST 2”

<pt:LastName>WSI Test 2</pt:LastName>

 

11.) Now update the BESPID.  You will need to change this to something unique.  Please see the SDK for more detail on BESPIDs.

<pt:BackEndSystemPatientId>ABCD</pt:BackEndSystemPatientId>

 

12.) The updated xml is below.

<?xml version="1.0" encoding="utf-8"?> <NOAHDataExchange xmlns="http://www.himsa.com/XMLWrapper/XMLWrapper"> <NoahDataExchangeProtocol> <NoahSiteID>ISLEROYALE1</NoahSiteID> <NoahUserID>ABC</NoahUserID> <BusinessSystemUserID>WSI</BusinessSystemUserID> <TransmissionID>0</TransmissionID> <pt:Patients xmlns:pt="http://www.himsa.com/PatientExport/PatientExport"> <pt:Patient> <pt:PatientGUID>{547edb69-ab2e-4bae-bf64-768baf79a788}</pt:PatientGUID> <pt:FirstName>WSI TEST</pt:FirstName> <pt:LastName>WSI Test 2</pt:LastName> <pt:ActivePatient>true</pt:ActivePatient> <pt:Gender>NotRecorded</pt:Gender> <pt:UserId>ABC</pt:UserId> <pt:CreateDate>2021-12-13T12:26:20</pt:CreateDate> <pt:BackEndSystemPatientId>ABCD</pt:BackEndSystemPatientId> <pt:Actions /> </pt:Patient> </pt:Patients> </NoahDataExchangeProtocol> </NOAHDataExchange>

13.) Now close your Noah System

14.) Navigate back to the Sample BES

15.) Select the clear button to clear out the window.  This is simply being done to make this tutorial easier to follow.  You don’t have to do this to make the next steps work. 

image-20260212-190825.png

16.) Select the “Export To Noah” button

image-20260212-190856.png

17.) The ExportForm screen will appear.  Copy the xml you just updated from Note and paste it into the “Xml data” section of the window.  Please see the picture below.

image-20260212-190926.png

18.) Select the “OK” button on the “ExportForm” to send the data.  Now you will see in the Sample BES an Export.  Please see picture below.  As you can see my export was successful, the entry wasn’t highlighted in red to indicate a failed export.

image-20260212-191005.png

19.) Now launch Noah System

20.) Run a search in the patient browser for the patient, “WSI Test 2.” In the picture below you will see that I ran the search and the query returned the newly created patient with the last name “WSI Test 2.”

image-20260212-191045.png

Section 2: Sending Audiometric Data from Noah System to the Sample BES and then from the Sample BES to Noah System.

1.)    In Noah System select the patient you created in the section above.

2.)    Create an audiogram for this patient and save the audiogram to Noah. 

3.)    Navigate back to the HIMSA Sample BES

4.)    The audiogram data will appear in the Sample BES

image-20260212-191129.png

5.) Right click and select “Copy XML to clipboard.”

6.) Open Notepad and paste in the XML

7.) The XML should look something like this. 

<?xml version="1.0" encoding="utf-8"?> <NOAHDataExchange xmlns="http://www.himsa.com/XMLWrapper/XMLWrapper"> <NoahDataExchangeProtocol> <NoahSiteID>WIN11TESTA1</NoahSiteID> <NoahUserID>ABC</NoahUserID> <BusinessSystemUserID>WSI</BusinessSystemUserID> <TransmissionID>0</TransmissionID> <pt:Patients xmlns:pt="http://www.himsa.com/PatientExport/PatientExport"> <pt:Patient> <pt:PatientGUID>{1719366f-4a16-4ddc-9db9-d2760f9e2e49}</pt:PatientGUID> <pt:FirstName>wsi test 2</pt:FirstName> <pt:LastName>wsi test 2</pt:LastName> <pt:ActivePatient>true</pt:ActivePatient> <pt:Gender>NotRecorded</pt:Gender> <pt:UserId>ABC</pt:UserId> <pt:CreateDate>2022-02-15T12:20:22</pt:CreateDate> <pt:BackEndSystemPatientId>ABCD</pt:BackEndSystemPatientId> <pt:Actions> <pt:Action> <pt:TypeOfData>Audiogram</pt:TypeOfData> <pt:Description>New Audiogram</pt:Description> <pt:ActionDate>2022-02-15T12:25:54</pt:ActionDate> <pt:LastModifiedDate>2022-02-15T12:25:54</pt:LastModifiedDate> <pt:UserId>ABC</pt:UserId> <pt:PublicData> <HIMSAAudiometricStandard xmlns="http://www.himsa.com/Measurement/Audiogram" Version="500"> <ToneThresholdAudiogram> <AudMeasurementConditions> <StimulusSignalType>PureTone</StimulusSignalType> <MaskingSignalType>NoSignalApplied</MaskingSignalType> <StimulusSignalOutput>InsertPhoneRight</StimulusSignalOutput> <MaskingSignalOutput>NoSignalOutput</MaskingSignalOutput> <StimulusdBWeighting>HL</StimulusdBWeighting> <MaskingdBWeighting>HL</MaskingdBWeighting> <StimulusPresentationType>Continuous</StimulusPresentationType> <MaskingPresentationType>Continuous</MaskingPresentationType> <HearingInstrument_1_Condition>UnAided</HearingInstrument_1_Condition> </AudMeasurementConditions> <TonePoints> <StimulusFrequency>250</StimulusFrequency> <StimulusLevel>40.0</StimulusLevel> <TonePointStatus>Normal</TonePointStatus> </TonePoints> <TonePoints> <StimulusFrequency>750</StimulusFrequency> <StimulusLevel>70.0</StimulusLevel> <TonePointStatus>Normal</TonePointStatus> </TonePoints> <TonePoints> <StimulusFrequency>6000</StimulusFrequency> <StimulusLevel>65.0</StimulusLevel> <TonePointStatus>Normal</TonePointStatus> </TonePoints> </ToneThresholdAudiogram> <ToneThresholdAudiogram> <AudMeasurementConditions> <StimulusSignalType>PureTone</StimulusSignalType> <MaskingSignalType>NoSignalApplied</MaskingSignalType> <StimulusSignalOutput>InsertPhoneLeft</StimulusSignalOutput> <MaskingSignalOutput>NoSignalOutput</MaskingSignalOutput> <StimulusdBWeighting>HL</StimulusdBWeighting> <MaskingdBWeighting>HL</MaskingdBWeighting> <StimulusPresentationType>Continuous</StimulusPresentationType> <MaskingPresentationType>Continuous</MaskingPresentationType> <HearingInstrument_1_Condition>UnAided</HearingInstrument_1_Condition> </AudMeasurementConditions> <TonePoints> <StimulusFrequency>250</StimulusFrequency> <StimulusLevel>40.0</StimulusLevel> <TonePointStatus>Normal</TonePointStatus> </TonePoints> <TonePoints> <StimulusFrequency>750</StimulusFrequency> <StimulusLevel>70.0</StimulusLevel> <TonePointStatus>Normal</TonePointStatus> </TonePoints> <TonePoints> <StimulusFrequency>6000</StimulusFrequency> <StimulusLevel>65.0</StimulusLevel> <TonePointStatus>Normal</TonePointStatus> </TonePoints> </ToneThresholdAudiogram> <FrequenciesUsedForToneAverage> <LeftEar1>500</LeftEar1> <LeftEar1>1000</LeftEar1> <LeftEar1>2000</LeftEar1> <RightEar1>500</RightEar1> <RightEar1>1000</RightEar1> <RightEar1>2000</RightEar1> </FrequenciesUsedForToneAverage> </HIMSAAudiometricStandard> </pt:PublicData> <pt:ActionGroup>2022-02-15T12:25:51</pt:ActionGroup> <pt:DeviceType>0</pt:DeviceType> </pt:Action> </pt:Actions> </pt:Patient> </pt:Patients> </NoahDataExchangeProtocol> </NOAHDataExchange>

8.) Change one of the points.  I have changed my point from 70 to 120.

image-20260212-191324.png

9.) You may need to change the bespid.  I don’t need to, as you can see in the picture below I already changed the bespid because this is a patient record I sent from the sample bes to Noah System in section 1.

image-20260212-191408.png

10.) Close Noah System

11.) Copy the xml from Notepad, select “Export 2 Noah” from the sample bes and paste in the xml.

12.) Now select OK on the “Export 2 Noah” screen to send the xml from the sample BES to Noah System.

13.) Open Noah System.  Select the patient record that you used for this section.  In the session list you will see the new action. It will say “Business System” for the action description.  In my picture below you can see the new audiogram is the second action in the list.  Use Noah 4 Aud to look at your audiogram to verify this is the audiogram you sent from the HIMSA Sample BES to Noah System.

image-20260212-191520.png

14.) Audiometric data is successfully being sent from Noah System to the HIMSA Sample BES.  The data is also being sent successfully from the HIMSA Sample BES to Noah System.

 

Section 3:  Features of the HIMSA Sample BES do?

 

A.)   This Calls for an Image.

1.) Select the data sent from Noah System to the HIMSA Sample BES. 

image-20260212-191707.png

2.) Right click on the data and select “This calls for an image.”

3.) After you select “This calls for an image” the screen below will appear.  Select “OK” on it.

image-20260212-191749.png

4.) After a few moments you will see the audiogram appear on the lower right corner of the HIMSA Sample BES.  Please see picture below.

image-20260212-191937.png

B.)  Start Noah Button

1.)    This button does just what it says, starts Noah.  Select the “Start Noah” button.

image-20260212-192015.png

C.) Start Noah Set Patient

1.)    Select the Start Noah Set Patient” button. You will see a screen asking for a BESPID.  I entered in the bespid from one of my patients above. 

image-20260212-192102.png

2.) Select “OK” on the “Business System Patient ID” box.

3.) The Noah Security screen will appear.  Select “OK”

image-20260212-192156.png

4.) Noah System will open and the correct patient will be selected.

image-20260212-192227.png

5.) If you switch back to the Sample BES, you will see the event to open Noah and select a patient.

image-20260212-192304.png

 

D.) Set Patient in Noah

1.)  No patient is selected in in Noah System

image-20260212-192344.png

2.) Switch to the HIMSA Sample BES and select “Set Patient in Noah.” You will need to enter in a BESPID.  As you can see I am using the BESPID for one of my patients I created in the first section of this document.  Select “OK” on the

3.) “Business System Patient ID box.”

image-20260212-192437.png

4.) Switch Back to Noah System and you will see the patient has been selected.

image-20260212-192518.png

E.) Get Bespid From Patient

1.) Select the “Get Bespid From Patient” button.  A box will appear asking you for the patient’s first name and last name.  As you can see in the picture below I have entered in the patient name for a patient I created in the first section.  Select “OK” on the First Name Last Name box.

image-20260212-192612.png

2.) The Noah System Security screen will appear, I have Noah System closed.  I select “OK” to continue

image-20260212-192647.png

3.) Go back to the Sample BES.  You will see a message has appeared and it is marked red.  In many cases this means there is an error.  However, in this case it is simply to draw your attention to the bespid.  You will see “ABCD,” the bespid, in the message.

image-20260212-192723.png

F.) Get Full Patient Record

1.) Select the “Get Full Patient Record” button.  You will see a box appear asking for a bespid.  I have entered in “ABCD” Select “OK” on the “Business System Patient ID” button.

image-20260212-192805.png

2.) You will see a message appear in the HIMSA Sample BES message box.

image-20260212-192840.png

3.) Select the entry.  Right click on it and select “View Data.”  You will see the full patient record including the actions.

image-20260212-192917.png

G.) Set Full Patient Record

1.) This is basically an import full patient.  Almost like an import with a nhax file.  In this case it is taking the full patient saved in xml and importing it into Noah System.

2.) Repeat the steps 1 and 2 from F, the section right above this one. Now right click on the data in the sample BES window and select “copy xml to clipboard.”

3.) Paste this xml into Notepad.  Save this notepad with the .xml extension to your desktop.

4.) Now go into Noah System.  Delete the patient record. You are going to be importing from the Sample BES.

5.) Back on the sample BES select “Set Full Patient Record.” Path to your xml created in step 3.  Select it and select the “Open” button.

image-20260212-193020.png

6.) Open Noah System.  The patient record you deleted will appear in the patient list with its data.

image-20260212-193058.png

H.) XML 2 Image

1.) Close the sample BES

2.) Open the Sample BES.  The point of this is so no audiogram is shown in the lower right corner of the HIMSA Sample BES.

3.) Repeat steps 1-5 from section 2

4.) Save the notepad as an xml file to your desktop.

5.) Now select the “XML 2 Image” button.

6.) Path to your audiogram xml file select it and select “Open.”

image-20260212-193500.png

7.) You will see the XML 2 Image options screen.  Select OK

image-20260212-193536.png

8.) The audiogram will appear in the lower right corner of the HIMSA Sample BES.

image-20260212-193615.png

I.) Export To Noah

This button has already been covered in sections 1 and 2.

 

J.) Update Patient

1.) This simply changes the Bespid.  Select the “Patient Update” button. Enter in the current Bespid in the first field.  Now enter in the new bespid.  Select “OK”

image-20260212-193723.png

2.) Now go to the sample BES.  Select BESQuery button.  We will cover the BESQuery button more in another section.  When the Besquery screen appears simply select “OK”.  You will see all the audiometric data appear in the HIMSA Sample BES.  Find the one with the patient record with the newly changed Bespid.  This might take a few attempts at right click “View data” to find the correct one. 

image-20260212-193756.png

 

K.) Noah Location Field and Update button

1.) This is if you want to point the HIMSA Sample BES to look at a different Noah System installation that has WSI enabled.  You change the name in the NoahLocation field and select the “Update” button.

image-20260212-193833.png

L.) BesQuery

1.) This feature can be used to query different types of actions in Noah System.

2.) Select the “BesQuery” button.  In the picture below you can see all the data types that can be queried.  You can also change the date to do point in time filters to help with your query too.  I did not do this for this example.  What you see for dates are the default dates.   I have selected audiogram and I selected “DoQuery” button.

image-20260212-193924.png

3.) All the audiograms found in Noah System are shown in the HIMSA Sample BES.

image-20260212-194016.png

M.) Misc

1.) This gets the status of a job. 

image-20260212-194103.png

2.) In the picture above I selected the “misc” button.  I then selected one of the strings in the message area and then selected “Status.” I was shown the Status reply message.  I then selected the “Request it” button.  This is for changing the WSI Conformance levels.  See WSIConformanceLevel.txt that is in the zip with the sample BES.

 

N.) Clear

1.) The “Clear” button, I use it a lot.  I find the Sample BES gets to full of messages.  In the picture below I haven’t selected Clear yet.

image-20260212-194211.png

2.) Now I have selected “Clear.”  The Sample BES screen is cleared out.

image-20260212-194246.png