Using the MIDP Visiting Nurse Application
with the Sun Wireless Toolkit

Introduction

This document describes the various menus in the MIDP Visting Nurse Sample using the Sun Wireless Toolkit Emulator.  We describe how to navigate through the demo, enter new records, synchronize the data.

This demo only updates the VNMEDICALRECORD table in RMS on the device.   The application is intended to have the other tables updated at the source (DB2 UDB, etc), as far as daily Schedule changes, patient's to be seen that day, etc.

Launching the Visiting Nurse Sample Application

After installing a web server as discussed in the Installation and User Guide, verify using the Mobile Device Administration Console which users you have defined.    Open the MDAC, click on Users, verify that you have nurse1 with a password of nurse1.   You might want to add nurse2 through 5 with same named passwords, in case you run our other JAD files (VNurse3.jad is for nurse3, etc.).

Click on Subscriptions in the left hand pane, then right click JDBCSUB 1, Click the Define Subscriptions button and verify that you have the following tables:

  1. DSYSAMPLE.VNMEDICALRECORD
  2. DSYSAMPLE.VNCONTACT
  3. DSYSAMPLE.VNPERSON
  4. DSYSAMPLE.VNSCHEDULE
If they are not present, select the Add button and use the new dialog window to Add them, then Close the window and Click OK until you are back to the MDAC.

Launch the MIDlet by executing
 

bin\run VNurse
or
bin\run VNurseDebug
 
Open the respective JAD file in an editor (lib\VNurse.jad or lib\VNurseDebug.jad) and verify that the Db2eSyncHost and Db2eSyncPort are set to the correct settings to reach your web server.   You might also verify that the Db2eSyncDeviceId does not conflict with any of the devices currently assigned to users in the MDAC.

This should bring you to the following screen:

You can use Enter, or click the Launch soft key (programmable) to run the MIDlet.
 

Sync Screen

This will bring you to the following screen:

Be sure that your web server is running   Since you have never performed a Sync operation, either type F1 or click the Sync button.

Errors are reported in 2 second Alert modal dialog boxes, so you might want to watch the phone.   Or if you run the VNurseDebug version there will be a lot of trace and you can check for exceptions.
 

Menu

In the Menu (type F2 or click Menu) there are several options.
 
 
  1. Reset Subs -- Reset (or clear) the Subscription Sets. This will restart from a new/never sync'ed state.
  2. Schedule -- To go to the Schedule page.   If you have not performed a Sync, there is no schedule and nothing will happen.
  3. Exit -- to quit this application.

Schedule Screen

Once a successful sync has been performed and all data has been refreshed from the DB2 Everyplace Sync Server to this device, you should see a screen representing the Nurse's schedule for the day

From this point, we can view various information about the various patients in today's schedule.    Use the arrow keys on the keyboard or on the emulator to position onto a different person.    Hit Enter or click the center button (inside the arrow keys) to select this patient.   You should see the radio button get the black dot, as Clay, Harris does in the above image.

Type F2 or click the Menu button and select Info.
 

Menu Options

  1. Info -- view patient information including medical records and contact (spouse, sister, etc) information
  2. Exit -- exit the application
And the left hand soft key has the Back button to return to the Schedule screen.
 

Person Information Screen

You should now be looking at a screen something like (depending on which patient you selected) this:

You can use the down arrow to scroll through their location information.

Select the Menu, click the down arrow to select Contacts, then click the center round button (or Enter).   This will take you to the Emergency Contacts screen.
 

Menu Options

  1. Records -- view, update, delete, add medical records for this patient
  2. Contacts -- view Emergency Contact information for this patient

Emergency Contacts Screen

You are presented with a list of people who could be contacted in the event of an emergency in this screen.   Again, use the arrows to position on a person, then click the center button to select.   Click the Info button to find out their phone or mobile phone number.

Select Back 2 times to return to the Schedule page.   Select Menu and this time go to Records.
 

Medical Record List

You will now be viewing a screen something like this:

This is a list of Date and Times of various medical records for this patient.   The visiting nurse will want to click Menu which will give these options:

These options allow the local copy of the VNMEDICALRECORD table to be modified, and later to by synchronized with the source database, which will replication the changes to the source.

View is rather straight forward, as is the Delete option.    Delete will only mark the record as deleted so that the delete can be sent to the source database, after which time the record is physically deleted from the local RMS store.

Add and Update are a little more involved, as the user must enter data in TextField boxes.  Select Add.
 

Add Menu Item

You will be presented with a screen like:

To enter a value in the box, click on the center button in the arrows, or Enter on your keyboard.  You may now type in the screen your value, then hit the center button or Enter.   You must now click the Save button again in order to update this value into the TextField box.

Scroll down to the other boxes and enter values and Save Save.   When you have entered all the values, you may hit Save to add this record to the VNMEDICALRECORD RMS table.

Each TextField defaults to the appropriate entry Mode, for examples Numbers only for the Pulse Rate.   This can be changed by clicking on the Mode button which cycles you throught UPPER CASE, lower case, and numeric.

As a convenience, all entries have default values, so when you first click Add, you can immediately click Save and the following entries will be added:
 

 bloodpres 99/99
 pulse 99
 temp 99
 weight 99
 comment no comment
with today's date.
 

Update of Vnmedicalrecord

Update behaves much like Add, except that the TextField's will have the initial value present which can then be modified.
 

Synchronizing the Changes Back to the Source Database

When all changes have been made, or when it is time to get today's new schedule, the nurse will go to the Sync page (by hitting Back to get out of the various screens) and click the Sync button.   This will replicate any changes made on the device to the source database.