fr:manuals:freemedforms:xmlforms:general
Keywords: fr:freemedforms,fr:usermanual,needupdate
Date: 2012-03-11T10:21:11+0100

freemedforms, usermanual, needupdate

# 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 fait 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

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 :

- drugs.xml pour le formulaire de la page médicament
- 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.

## Structure XML

Chaque fichiers 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 perdrez les données préalablement enregistré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.
  - Le séparateur d'espace peut être :: , :, ., .. ou __.
  - Pour améliorer les performances des scripts, veillez à ce 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).