FreeDiams est pensé comme un "module" externe. Ce "module" peut étre utilisé par un grand nombre de logiciel propriétaires ou non. A l'heure actuel, MedinTux et GNUMed sont configurables pour utiliser ce logiciel comme prescripteur.
Pour interfacer un logiciel avec FreeDiams, il suffit de renseigner les paramètres de la ligne de commande et d'utiliser les fichiers d'échange.
Les paramètres suivants sont disponibles :
Not yet documented :
Examples :
freediams --exhange-in="/home/me/exchang-in.xml" --exchange="/home/me/exchange.exc"
freediams.exe --exhange-in="c:\Files\exchang-in.xml" --exchange="c:\Files\exchange.exc"
FreeDiams.app/Contents/MacOs/FreeDiams --exhange-in="/home/me/exchang-in.xml" --exchange="/home/me/exchange.exc"
Tous les fichiers sont encodés en UTF-8.
Au lieu d'utiliser la ligne de commande pour renseigner les différents paramètres à utiliser dans FreeDiams, les EMR peuvent utiliser un fichier d'échange encodé en XML.
Lorsqu'un fichier d'échange entrant est spécifié les données qu'ils incluent remplaceront les données passés en ligne de commande. Une utilisation mixte est toujours possible : une partie des données sont transmises par la ligne de commande, l'autre par le fichier d'échange entrant.
La structure de ce fichier doit répondre aux exigences ci-dessous.
<FreeDiams_In version="0.4.0"> <ConfigFile value="/path/to/the/requiered/configFile.ini"/> <OutFile value="/path/to/the/requiered/exchange_File.txt" format="xml html html_xml"/> <DrugsDatabase uid="FREEDIAMS_DRUGS_DATABASE_UID"/> <EMR name="NameOfTheCallingEMR" uid="SessionUIDWillBeReturnedInOutputFile"/> <Patient> <Identity name="Name Of Patient" secondname="" surname="James" uid="EMR Patient's UID" dob="yyyy/MM/dd" gender="M or F or H"/> <Creatinine value="12" unit="mg/l or mmol/l"/> <Weight value="70" unit="kg or lbs" /> <Height value="170" unit="cm or "/> <InnAllergies value="inn1;inn2;inn3"/> <ATCAllergies value="ATC1;ATC2;ATC3"/> <DrugsUidAllergies value="7655668;876769;656789"/> <ICD10 value="J11.0;A22;Z23"/> </Patient> <Ui editmode="select-only or prescriber" blockPatientDatas="0/1"/> </FreeDiams_In>
Lorsqu'un fichier d'échange est notifié, FreeDiams essaie de lire le contenu de ce fichier et d'y récupérer les données de la prescription.
A la fermeture de l'application, la prescription est sauvegardée dans le d'échange sous format XML. Voir Format du fichier de sauvegarde.
Lorsque le paramètre --medintux est notifié dans la ligne de commande, le format du fichier d'échange est spécifique à MedinTux.
Le contenu du fichier d'échange de sortie est un mélange d'HTML et de XML.
Jusqu'à la version v0.4.0, le fichier est structuré de la sorte.
<html> ... <body> <a href="FreeDiamsEncodedPrescription:base64FreeDiamsXmlencoded"> ... (full HTML prescription) </a> </body> </html>
Pour les versions à partir de la 0.4.0 :
<html> ... <meta name="FreeDiams" content="FreeDiamsEncodedPrescription:base64FreeDiamsXmlencoded"/> <body> ... (full HTML prescription) </body> </html>
Certaines actions nécessitent l'activation de paramètres de la ligne de commande.
Pour aider au déboggage de l'application lorsque celle-ci semble ralentie : --chrono aide à trouver le ralentissement.
Pour les rédacteurs de posologies standard, --transmit-dosage permet de transmettre leurs posologies au comité scientifique chargé de les valider.