Connection à un gestionnaire de dossiers externe

This page is up-to-date.

Utilisation de la ligne de commande

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.

Paramètres de la ligne de commande

Dans la plupart des cas, il est recommandé de transmettre les données à FreeDiams en utilisant le fichier d'échange entrant plutôt que d'utiliser la ligne de commande (cf infra).

Vous pouvez à tous moment vérifier les paramètres transmis (par la ligne de commande ou par le fichier entrant) grâce au dialogue À propos/Application/Ligne de commande.

Paramètres concernant l'interface utilisateur de FreeDiams

  • –version , -version , -v : affiche la version actuelle de FreeDiams.
  • –selection-only : Démarre FreeDiams en mode de sélection seulement.
  • –chrono : Chronomètres diverses fonctions du testeur d'interactions (proposé à des fins de déboggage)
  • –blockpatientdatas : Empêcher la modification des données patients dès l'ouverture
  • –drugsdb-uid : Identifiant unique spéficique à FreeDiams pour la base de données thérapeutiques à utiliser à l'ouverture

Paramètres pour les fichiers d'échange

  • –medintux : définit une utilisation spécifique à MedinTux.
  • –exchange-in=”/path/to/xml/exchange-in.xml” : définit le fichier d'échange entrant.
  • –exchange-out=”/path/to/file.xch” : définit le fichier que FreeDiams va écrire, selon de propre droits de chemin d'accès.
  • –exchange-format=“xml html html_xml” : format du fichier d'échange de sortie (choisir un format)

Paramètres utiles pour les gestionnaires de dossiers médicaux externes

  • –emr-name : nom du gestionnaire de dossiers médicaux appelant (sera inclus dans le file d'échange sortant sans modification)
  • –emr-uid : session UID du gestionnaire externe (sera inclus dans le fichier d'échange sortant sans modifications)

Paramètres utilisés pour transmettre les données patient

  • Identité :
    • –patientuid : UID du patient (sera inclus dans le file d'échange sortant sans modification)
    • –patientname=“xx xx xx” : définit le nom du patient.
    • –patientfirstname=“xx xx” : définit le prénom du patient.
    • –gender=M : définit le sexe (peut-être égal à 'M' pour Masculin, 'F' Feminin, 'H' Hermaphrodisme)
    • –dateofbirth=“yyyy/MM/dd” : définit la data de naissance du patient
  • Données physiologiques :
    • –weight=“dd” : définit le poids du patient (en kg)
    • –weight-unit : Unité de mesure du poids : Kg/lbs
    • –height=“ddd” : définit la taille du patient
    • –height-unit : Unité de mesure de la taille : cm/inches
    • –crcl=“dd.d” : définit la clairance de la créatinine du patient
    • –crcl-unit : Unité de mesure de la clearance de créatinine
    • –creatinine=“dd” : définit la créatininémie du patient (en mg/l)
    • –creatinine-unit : Unité de mesure de la créatinine :(mg/l or mmol/l)
  • Précautions à la prescription : (allergies et intolérances médicamenteuses connues)
    • Allergies :
      • –drugs-uid-allergies : Liste des UID des médicaments pour lesquels une allergie est connue (séparer les valeurs par un point virgule)
      • –atc-allergies : liste des codes ATC pour lesquels une allergie est connue (séparer les valeurs par un point virgule)
      • –inn-allergies : Liste des libellés DCI pour lesquels une allergie est connue (séparer les valeurs par un point virgule - les libellés doivent ceux de la table ATC connue de FreeDiams)
    • Intolérances :
      • –drugs-uid-intolerances : Liste des UID des médicaments pour lesquels une intolérance est connue (séparer les valeurs par un point virgule)
      • –inn-intolerances : Liste des libellés DCI pour lesquels une intolerance est connue (séparer les valeurs par un point virgule - les libellés doivent ceux de la table ATC connue de FreeDiams)
      • -atc-intolerances : liste des codes ATC pour lesquels une intolerance est connue (séparer les valeurs par un point virgule)

Paramètres utiles pour les participants au projet FreeMedForms

  • –transmit-dosage = réservé aux membres du comité scientifique. Permet de transmettre tous les protocoles enregistrés au serveur de données.

Examples

  • Linux/*BSD :
  freediams --exchange-in="/home/me/exchange-in.xml"
  • Win :
  freediams.exe --exchange-in="c:\Files\exchangein.xml"
  • Mac (don't forget the bundle) :
  FreeDiams.app/Contents/MacOs/FreeDiams --exchange-in="/Users/me/exchange-in.xml"

Les fichiers d'échange de données

Le fichier d'échange entrant

Tous les fichiers sont encodés en UTF-8.
Il est préférable d'utiliser les fichiers d'échanges à la ligne de commande pour renseigner les différents paramètres à utiliser dans FreeDiams.
Lorsqu'un fichier d'échange entrant est spécifié les données qu'ils incluent remplacent 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.

Structuration XML du fichier d'échange entrant

<FreeDiams_In version="0.5.0">
  <ConfigFile value="/absolute/file/specification/to/the/required/configFile.ini"/>
  <ExchangeOut value="/absolute/file/specification/to/the/required/exchange_File.txt" format="xml html html_xml"/>
  <DrugsDatabase uid="FREEDIAMS_DRUGS_DATABASE_UID"/>
  <EMR name="NameWillBeShownInTheMainWindowTitle" uid="SessionUIDWillBeReturnedInOutputFile"/>
  <Patient>
    <Identity lastnames="Family or equivalent name e.g. Kirk"
              firstnames="James Tiberius"
              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"/>
 
    <InnIntolerances value="inn1;inn2;inn3"/>
    <ATCIntolerances value="ATC1;ATC2;ATC3"/>
    <DrugsUidIntolerances value="7655668;876769;656789"/>
 
    <ICD10 value="J11.0;A22;Z23"/>
 
  </Patient>
  <Ui editmode="select-only or prescriber" blockPatientDatas="0/1"/>
</FreeDiams_In>

FreeDiams will “read-only” this XML file for patient and allergy/intolerance data. If an “ExchangeOut” file is specified, FreeDiams will read it only for prescription data (ignoring patient data). On close, FreeDiams will write the currently edited prescription to the “ExchangeOut” file, so that EMR can retreive information.

Please note the difference between relative and absolute path.

  • absolute path starts with '/' or 'X:\\'
  • relative path starts with './' or '../'

The relative path are calculated from the application's binary. They should be different for each OS:

  • under Linux, the binary is installed in /usr/bin
  • under MacOs, binary is inside the Bundle /Path/To/Application.app/Contents/MacOs
  • under Windows, binary is installed in C:\\Path\\To\FreeDiams

It is recommended to use absolute full path inside the XML exhange-in file, so that the calls to FreeDiams will be fully multi-OS.

When passing ATC codes for allergies or intolerances, you can pass Class ATC Codes which are less than 7 char length.

2010/09/27 12:09

Valeurs par défaut

  • –exchange-format = html_xml
  • Ui = prescriber
  • BlockPatientDatas = 0
  • ConfigFile = the default one (in your home path)

Le fichier d'échange sortant

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, sans intervention de l'utilisateur (inutile de sauvegarder avant de quitter l'application).
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.

Format de fichier

Format: html_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>

Format: xml

Le code XML correspond à celui décrit dans le chapitre suivant.