Outils pour utilisateurs

Outils du site


fr:manuals:freemedforms:xmlforms:general

Règles générales d'écriture pour les formulaires patient

Les formulaires patients sont des répertoires contenant différents fichiers XML. Chaque fichier y a une fonction precise et un nom fixe.

Ces formulaires peuvent être transmis d'un utilisateur de FreeMedForms à un autre grâce à un module spécifique.

Les mises à jour des formulaires se font de façon transparente pour les utilisateurs.

La base de données de FreeMedForms s'adaptera automatiquement au formulaire chargé.

Vous pouvez définir un formulaire général pour tous les patients puis agrémenter au besoin ce formulaire en ajoutant des sous-formulaires.

Structure du répertoire

  • Il est de bon conseil de toujours distribuer vos formulaires avec un langage “ de chute ” xx == tous les (autres) langages.
  • Structure du répertoire (les extensions des fichiers doivent être strictement respectées).
    • Racine (le nom de ce répertoire sera utilisé comme identifiant unique, vous devez donc veiller à ce que ce nom soit unique)
      • central.xml
      • pmhcategories.xml
      • ui
        • lang1 (iso 2chars - eg: fr xx de) xx=all (other) languages
          • file1.ui
          • file2.ui
        • lang2
          • file1.ui
          • file2.ui
      • scripts
        • lang1
          • script1.js
          • scrip2.js
        • lang2
          • script1.js
          • scrip2.js
      • html
        • lang
          • file1.html
          • file2.html
      • pdf
        • lang
          • file1.pdf
          • file2.pdf
  • Les fichiers suivants sont nécessaires au bon fonctionnement des formulaires :
    • description.xml : la description du formulaire
    • central.xml : partie centrale du formulaire 
    • et tous les fichiers inclus par ce formulaire xml
  • Vous pouvez compléter vos formulaires avec :
    • pmhcategories.xml pour définir les rubriques à afficher dans la page antécédents et leur contenu.
    • tous les fichiers inclus dans ces formulaires qui peuvent être soit inclus Dans l'archive soit intègrés dans les sous-formulaires.
Exemple d'arborescence

Structure XML

Chaque fichier du formulaire doit présenter l'entête ci-dessous :

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE FreeMedForms>

Votre code XML doit être systématiquement contenu dans un tag FreeMedForms :

 <FreeMedForms>
   [...]
 </FreeMedForms>

Nommage des formulaires et des items

  • Le nom que vous donnerez aux formulaires et surtout aux items sera primordial. En effet, la base de données utilisera ces noms pour stocker et récupérer les enregistrements.
    • Si deux éléments possèdent le même nom, le résultat est aléatoire.
    • Si vous modifiez le nom de l'item entre deux mises à jour, vous devez définir des fieldEquivalence pour éviter les pertes de données.
  • Nous recommandons l'utilisation d'espaces de nommage selon les règles suivantes :
    • Chaque formulaire possède son propre espace de nommage. Par exemple, le formulaire Médecine générale avec page médicaments possède l'espace de nommage général GP::Basic
    • L'espace de nommage général ne doit entrer en conflit avec aucun autre formulaire, sauf si vous souhaitez assurer des correspondances inter-formulaires.
    • Les séparateurs d'espace peuvent être:
::
,
.

Préférez

::
  • Pour améliorer les performances des scripts, veillez à ce que le nommage respecte une encapsulation correcte, par exemple:
    • ItemMaître = Spec::MyForm
    • SousItemGroup = Spec::MyForm::Group1
    • Item du groupe = Spec::MyForm::Group1::ElementPremier

Présentation des différents fichiers constituants le formulaire

central.xml

Contient le formulaire central, celui qui apparaît dans la page formulaire patient de FreeMedForms. Il peut contenir des formulaires imbriqués, chaque formulaire possédant sa branche dans l'arborescence des formulaires.

description.xml

Contient la description du formulaire avec :

  • sa date de création 
  • son numéro de version
  • le nom de ses auteurs, les sources bibliographiques utilisées
  • la licence d'utilisation
  • les éléments de classification

Le contenu de la description est détaillée dans une rubrique à part entière.

drugs.xml

Contient le(s) formulaire(s) à insérer dans la page Médicaments. Vous pouvez insérer des sous-formulaires si nécessaire.

pmhcategories.xml

Contient les informations nécessaires pour construire les rubriques de classification des antécédents. Chaque rubrique pouvant abriter :

  • le gestionnaire par défaut
  • un formulaire

Représentation de données patient

Les items de formulaire peuvent être :

  • des données dites inerte (comme l'adresse) ou
  • représenter des données patient (comme le pouls).

Il convient d'informer précisément le statut des items afin de permettre a FreeMedForms d'executer correctement les calculs automatiques concernant le patient (les alertes d'allergies médicamenteuses par exemple).

fr/manuals/freemedforms/xmlforms/general.txt · Dernière modification: 2015/06/17 12:46 par Jérôme Pinguet