Using Indivo

Viewing, adding, and editing documents
Health documents stored within Indivo can be accessed from the menu on the left of the User Interface. The Personal submenu includes administrative documents like contact information, demographics, and appointments. The Health Profile submenu includes all self-reportable document types like problems, medications, allergies, and vitals. The Clinical Information submenu contains document types that will most likely come from hospitals, clinics, or laboratories like notes or lab tests. The Legal & Financial submenu includes insurance information, health care proxies, and advance directives. The Survey link lists surveys that have been sent to you, for example, as part of a research study. Finally, the Summary option will display a high-level summary of most of your health data.

Each document-type section first lists available documents in paged form. (A button to add an additional document will be available on this display if possible.) Clicking on a list item will open the document detail display. The detail display will give you the option of editing the document, if possible.

Sharing your record
You may share data in your record, or manage your existing shares, by clicking the Sharing option in the top menu. The Sharing section lists the other users with whom you've shared data, other users who have shared data with you, and a button for creating new shares.

Clicking on an item within the share list will deactivate that share. Clicking on a username to which you have access will connect you to that user's record. (Note that only the document types explicitly shared by that user will be visible to you.)

You may share data with others by clicking the button labeled "Share my health data with someone new." You are given the option of sharing with an existing Indivo user or with someone who doesn't yet have an Indivo account. To the prior, you must know the user's Indivo ID. To do the latter, you only need an e-mail address -- Indivo will send a personal invitation (an Indivite) to that address and provide instructions for creating a new Indivo account and linking it with yours.

Sending messages
Indivo allows users to send secure messages to one another that persist permanently within the health record. To send messages, both parties must have explicitly authorized each other to do so within the Sharing section. The message section is available by clicking the Messages link in the top menu -- there you will see any message in your Inbox, sorted by date. Unread messages appear in bold. To send a new message, click the button labeled "Send new message," then simply supply a recipient's Indivo ID -- not an e-mail address! -- a subject, and a message body. (If you receive an error when you click "send," you probably don't have authorization to send a message to the Indivo ID specified.)

Subscriptions
Indivo lets you import data from external sources in an automated fashion using "Subscriptions." The Subscriptions menu option (at the top of the UI) lists all available external sources to which you may subscribe. Consult someone at the external source for details on how to subscribe properly.

Coding with the Java Client API
The Java client API is a set of helper classes written to aid Java developers in sending requests to the Indivo Server and in utilizing the responses in a meaningful way.

The primary class in this set is the PingActionsClient class (will be renamed to IndivoActionsClient soon). Using this class, a developer can send requests to the server to perform the following actions:


 * Instantiating a client
 * Authenticate
 * Add a document
 * Update a document
 * Read document headers
 * Read a document
 * Create a record
 * Send a message
 * Query for a list of Indivo Ids