5. Using the client¶
5.1. Menus¶
CamCOPS begins at its main menu: 
CamCOPS: Cambridge
Cognitive and Psychiatric Assessment Kit.
At any menu except the top menu, touch 
(at the top left) to return to
the previous menu.
5.2. Locking¶
The icon at the top right of the menus displays the lock status. Touch the icon to change the lock status. When operating in Clinician Mode, the icon can appear as:
Locked. When CamCOPS has a patient selected, and is locked, you
can give it to the patient, and the patient won’t be able to see details from
any other patients. If no patient is selected, and CamCOPS is locked, no tasks
or patients are visible except anonymous tasks (see below).
Unlocked. When CamCOPS is unlocked, you can change the patient,
and see tasks from all patients when no patient is selected.
Privileged. This mode is for administration, and allows full
configuration of CamCOPS. You can enter privileged mode from the
Settings menu.
When operating in Single User Mode, locking the app will require the patient to enter their CAMCOPS APP PASSWORD before they can continue using it.
5.3. Patients (Clinician Mode only)¶
When viewing a menu, near the top of the screen, you’ll always see the current patient’s details or a message saying No patient selected.
Touch 
Choose patient to choose (or add, or edit)
a patient. At the Choose patient screen:
Touch a patient row to select/deselect that patient.
The currently selected patient, if any, will be shown in blue.
Touch
to add a patient.
When a patient is selected, you can also:
Touch
to mark the patient as finished (see “Uploading” below).Touch
to edit the patient’s details.Touch
to delete the patient.
In the list of patients:
- indicates that the patient has been marked as finished (see
“Uploading” below).
indicates that the patient’s details are insufficient to be
uploaded (as determined by the server’s ID policy).
indicates that the patient’s details are sufficient to be uploaded,
but insufficient to be finalized and removed from the tablet (as determined
by the server’s ID policy).
When editing a patient:
The descriptions of the ID numbers (e.g. “NHS number”, “Hospital BlahBlah number”) are determined by your server.
Touch
to save.Touch
to cancel.
5.4. Tasks (Clinician Mode only)¶
From the main menu, you can go to the 
Patient
summary. This shows all tasks on the tablet for the current patient. You can
also browse the menu to find specific tasks. If you have trouble finding one,
try 
Search all tasks.
At any task menu, task summaries are displayed.
Choose
Task information for a page of background
information about the task.Choose
Task status to view the task’s status within
CamCOPS, such as whether your server is offering a fully functional copy or a
skeleton task (according to institutional permissions).Touch
to create a new instance of the task, for the current patient.Touch a task row to select/deselect a task. (The currently selected task, if any, will be shown with a coloured background.)
- indicates (for an anonymous task only; see below) that the task
has been marked as finished.
When a task is selected:
Touch
to view the task, either as a quick summary, or as a proper
facsimile.Touch
to edit the task.Touch
to delete the task.For anonymous tasks, touch
to mark the task as finished.
5.5. Anonymous tasks¶
Some tasks are anonymous; they are not associated with any patient. (An example is the anonymous GMC patient satisfaction questionnaire.)
5.6. Test subjects (Clinician Mode only)¶
You may want to experiment with the non-anonymous tasks. A suggested way is to define a fake patient with an invalid ID number, or perhaps a few such patients of different sexes. For example, you could tell everyone in your institution that FAKEPATIENT, JANE (mystudyid# 99999, female) and FAKEPATIENT, JOHN (mystudyid# 99998, male) are your test patients. Everyone can then feel free to play with those identities, but not to create others. However, you may be prohibited from doing this in a clinical environment, in which case you could set up a second training group in your database. (The disadvantage of that is the need for users, or their administrator, to select the proper group after training.)
5.7. Questionnaire-style tasks¶
Some tasks use an custom user interface, but many use a standard questionnaire style with one or more pages.
The page colour tells you whom the page is primarily for:
white for patients;
pale yellow for clinicians;
a pale yellow header with a white page where the clinician needs to show the patient the page and then mark the responses;
lavender for configuration menus;
… and grey for the CamCOPS main menus.
When entering information, make the yellow disappear. Information is
required if you see things in yellow, like this:
Enter some text. You will not be
able to move on to the next page while required information is missing.
To navigate within a questionnaire, use the (back) and 
(next)
icons at the top right to navigate the pages. At the final page, touch 
to finish. To abort, touch (at the top left).
Note
Aborting discards your changes when editing configuration information, but does not discard changes made to tasks. All changes made to task information are immediate and persistent.
Some widgets have special properties:
Some widgets can’t display the lack of a value well (e.g. date/time pickers; sliders). They show the symbol
when information
is missing but mandatory. If appears, you need
to set a value, even if it looks like one is already set! Widgets may show
when information is missing but optional.
Occasionally, widgets may offer the delete button to wipe their
contents.For date/time fields, touch
(if shown) to set the date/time to
now.For sounds, touch
and 
to start and stop the
sound, respectively. (The symbol indicates whether or not the sound is
currently playing.) Some sound players offer a volume dial as well.For photos, touch
to take a photo (using your device’s camera
interface), and 
to rotate the photo.
You can also delete the photo with .For sketches, touch
to reset to the starting state.For countdowns, touch the , , and buttons as required. If your device’s volume is turned up, the device will go bong when the countdown elapses.
For diagnostic codes, you can browse the tree (and touch ‘leaves’ and sometimes branches to select a diagnosis), or press
to switch to a
search view, where you can type in a fragment of a diagnosis or its code.
Press 
to return to the tree view.
See the Demonstration questionnaire on the Help menu
for a tutorial.
When viewing a read-only facsimile of a questionnaire-style task:
The symbol
appears to indicate the read-only status.Touch
to jump directly to a specific page. (This button will
sometimes be available during editing, but will not then allow you to jump
beyond the last seen or first incomplete page.)
5.8. Uploading¶
Choose 
Upload data to server from the main menu.
In Single User Mode uploading should happen
automatically when you complete or abort a task. If there was
a problem with the automatic upload (e.g. due to no internet connection) the app
will reattempt the upload when you return to the main menu from another screen,
provided 10 minutes has elapsed since the last attempt. You can also use this option
to reattempt the upload manually.
The rest of this section applies to Clinician Mode.
It will only work if:
You have chosen the server in .
You have set your username (and, optionally, password) in .
The tablet has previously been registered with the server ().
There are three upload methods:
COPY. This copies unfinished patients to the server. It moves finished patients (that is, the data for finished patients is copied to the server, then deleted from the tablet), and finished anonymous tasks.
MOVE. This moves all patients and their data. (If some patients do not meet the server’s finalizing criteria, as above, then you can’t MOVE until you fix this.)
MOVE, KEEPING PATIENTS. This moves all patients’ data, and erases all task data from the tablet, but it keeps the basic patient details, so you can add more tasks for these patients later.
Please MOVE whenever possible; this reduces the amount of patient-identifiable information stored on this device.
You should see a message of success when the upload is complete.
5.9. Seeing what you’ve uploaded¶
Use any web browser (on a computer or tablet) to browse to your CamCOPS server. See the web interface instructions for more detail.
5.10. Help (Clinician Mode only)¶
The Help menu includes, amongst other things:
links to this documentation;
a demonstration task, to try out all the user interface elements;
the CamCOPS app version number.
5.11. Single user mode¶
Single User Mode is designed for a patient using the app at home on their own tablet. It is used in conjunction with task schedules.
When you start the app for the first time, you will be prompted to enter the web address of the CamCOPS server and the unique access key for your patient. These should have been given to you by the clinician or researcher associated with the study you are participating in. If you are using CamCOPS on a phone or tablet, you may have been emailed a web address (beginning http://camcops.org/ or camcops://camcops.org/) that you can use to register your patient with the server without having to enter these details. You will need to have the email on the same phone or tablet where the CamCOPS app is installed and open the link from that email.
On the main menu you will see a list of tasks that you need to complete
and the date by which you need to complete them. You can start a task by
selecting it from the list. When you complete or abort a task
and your tablet is connected to the internet, the app will upload your responses
automatically to the server. The app then marks the task as completed. If you
have completed all due tasks and there are tasks scheduled for future dates,
the app will display the date when the next task will be available.
If the app could not upload the tasks to the server, you can tell the app to try
again. Choose Upload data to server from the main menu.
You can select a number of other, less frequently used options by selecting :
will fetch any updates to your task schedules from the server.
will allow you to re-run the patient registration process. WARNING: any records not yet uploaded to the server will be lost.
Note that anonymous tasks are not associated with a patient when uploaded to the server. If the database on the app is deleted and you re-register, we have no way of knowing if the anonymous task has been completed or not so it will always appear as incomplete.
There are a couple of other options from . These are intended to aid debugging so you should not need to use these in normal operation.