iStayHealthy File Format

From version 3.1.x for iPhone onwards, users will be able to import and export results directly from/to iStayHealthy.
In order to do this, iStayHealthy needs to use a file extension that is unique to the app.
iStayHealthy uses the isth file extension.

However, the data contained in the iStayHealthy file are standard text-based data using the eXtensible Mark-up Language format - otherwise known as XML.

XML files are structured text files, where data are organised in so-called elements. The structure of elements is tree-like. Each element may also have a number of attributes that describe the nature of the element.

The section below describes layout file. 

Every XML document starts with an XML header. In this case it is
<?xml version="1.0" encoding="UTF-8"?>

Supported Data Types

All data input for attributes listed below is in text format.
  • Integer values. E.g. 100
  • Float values. E.g. 20.8
  • Dates: please enter the date in the following format: <dd-MMM-yy HH:mm:ss>. Example: 01-Apr-12 14:00:00
  • Normal text
If attributes are required and no value can be added - leave the entry blank. E.g. 
<Result CD4="" .....

iStayHealthyRecord Element

Element Name: iStayHealthyRecord (required). 
Element Attributes: 
  • dbVersion - the database version of iStayHealthy (optional)
  • fromDevice - the device from which the data come (optional)
  • fromDate - last modified date, last date the file was generated (required)
  • UID - unique identifier (internal only - do not use)
Parent Element: None - is root element
Child Elements:
  • Results 
  • Medications
  • MissedMedications
  • OtherMedications
  • ClinicalContacts
  • IllnessesAndProcedures
  • HIVSideEffects
-----------------------------
Element Name: Results (optional)
Element Attributes: none 
Parent Element: iStayHealthyRecord
Child Elements: Result 

-----------------------------
Element Name: Result (required if Results is present)
Element Attributes:
  • CD4 - the count of CD4 cells as integer. If no values - leave empty. (required)
  • CD4Percent - the percentage of CD4/CD8 cells as float (e.g. 20.8).If no values - leave empty. (required)
  • ViralLoad - the count of HIV virus infected cells. Integer value. Values below 40 will be considered undetectable.If no values - leave empty. (required)
  • ResultsDate - the date the result was obtained. (required)
  • HepCViralLoad - the count of Hepatitis C virus infected cells. Integer value. Values below 40 will be considered as undetectable.If no values - leave empty. (optional)
  • Glucose - blood sugar level. Float value (optional)
  • LDL - low density cholesterol. Float value (optional)
  • HDL - high density cholesterol. Float value (optional)
  • Systole - part of blood pressure. Integer value (optional)
  • Diastole - part of blood pressure. Integer value (required if Systole is present - otherwise optional)
  • HeartRate - integer value (optional)
  • GUID - unique identifier (internal only - do not use)
Parent Element: Results
Child Elements: None

-----------------------------
Element Name: Medications (optional)
Element Attributes: none 
Parent Element: iStayHealthyRecord
Child Elements: Medication 
-----------------------------

Element Name: Medication (required if Medications is present)
Element Attributes:
  • StartDate - for start of treatment (required)
  • Name - the commercial name of the drug (required)
  • Drug - the drugs contained, separated by Comma (required)
  • MedicationForm - tablet, combination tablet, injection (optional)
  • EndDate - end of treatment (optional)
  • GUID - unique identifier (internal only - do not use)
Parent Element: Medications
Child Elements: None

-----------------------------
Element Name: MissedMedications (optional)
Element Attributes: None
Parent Element: iStayHealthyRecord
Child Elements: MissedMedication
-----------------------------
Element Name: MissedMedication
Element Attributes:
  • MissedDate - date when missed (required)
  • Name - the commercial name of the drug (required)
  • Drug - the drug content separated by commas (optional)
  • GUID - unique identifier (internal only - do not use)
Parent Element: MissedMedications
Child Elements: None

-----------------------------
Element Name: OtherMedications (optional)
Element Attributes: None
Parent Element: iStayHealthyRecord
Child Elements: OtherMedication
-----------------------------

Element Name: OtherMedication (required if OtherMedications is present)
Element Attributes:
  • StartDate - for start of treatment (required)
  • Name - the commercial name of the drug (required)
  • Drug - the drugs contained, separated by Comma (required)
  • Dose - integer value (required)
  • Unit - mg, g, dl or other (required)
  • MedicationForm - tablet, combination tablet, injection (optional)
  • EndDate - end of treatment (optional)
  • GUID - unique identifier (internal only - do not use)
Parent Element: OtherMedications
Child Elements: None

-----------------------------
Element Name: HIVSideEffects (optional)
Element Attributes: None
Parent Element: iStayHealthyRecord
Child Elements: SideEffects
-----------------------------

Element Name: SideEffects (required if HIVSideEffects is present)
Element Attributes:
  • SideEffectDate - date when encountered (required)
  • Name - the commercial name of the drug (required)
  • Drug - the drugs contained, separated by Comma (required)
  • SideEffect - text (required)
  • GUID - unique identifier (internal only - do not use)
Parent Element: HIVSideEffects
Child Elements: None

-----------------------------
Element Name: IllnessesAndProcedures (optional)
Element Attributes: None
Parent Element: iStayHealthyRecord
Child Elements: Procedures
-----------------------------

Element Name: Procedures (required if IllnessesAndProcedures is present)
Element Attributes:
  • Date - date of illness or procedure (required)
  • Illness - the illness as text. Leave blank if none (required)
  • Procedure - the procedure/surgery as text. Leave blank if none (required)
  • GUID - unique identifier (internal only - do not use)
Parent Element: IllnessesAndProcedures
Child Elements: None

-----------------------------
Element Name: ClinicalContacts (optional)
Element Attributes: None
Parent Element: iStayHealthyRecord
Child Elements: Contacts
-----------------------------

Element Name: Contacts (required if ClinicalContacts is present)
Element Attributes:
  • ClinicName - name of surgery/clinic or hospital (required)
  • ClinicID - patient ID for this clinic. Leave blank if none (required)
  • ClinicEmailAddress -  (optional)
  • ClinicWebSite - (optional)
  • ClinicContactNumber - the primary contact telephone number (required)
  • EmergencyContactNumber - primary emergency phone (optional)
  • EmergencyContactNumber2 - phone number for emergencies (optional)
  • ConsultantName - name of primary consultant doctor (optional)
  • ClinicNurseName - name of primary nurse/advisor (optional)
  • ClinicStreet - (optional)
  • ClinicPostcode - (optional)
  • ClinicCountry - (optional)
  • ClinicCity - (optional)
  • ResultsContactNumber - phone for getting results (optional)
  • AppointmentContactNumber - phone number for making appointments (optional)
  • InsuranceName - name of health care provider if private (optional)
  • InsuranceID - ID with provider (optional)
  • InsuranceContactNumber - phone contact number (optional)
  • InsuranceWebSite - (optional)
  • InsuranceAuthorisationCode - the code insurances provide when they agree with treatment (optional)
  • GUID - unique identifier (internal only - do not use)
Parent Element: ClinicalContacts
Child Elements: None

Comments