Muséum national d'Histoire naturelle (MNHN)
7210
http://www.mnhn.fr
http://www.enseignementsup-recherche.gouv.fr/
http://www.developpement-durable.gouv.fr/
Bienvenue, (invité) Mes Préférences
Taxonomina - Doc technique Classifications

Revenir à la page d'accueil :


Application "Classifications" - Documentation technique#

1. Les données#

Les classifications référencées dans la base de données sont appelées via la vue CLASSIF_STORE.

(voir la page La base de données pour plus de détails).

2. Organisation des répertoires et des fichiers#

2.1 Côté serveur#

L’organisation du code est la même que pour les applications "Species", "Genera"et "Families".

Les classes d’objets sont instanciées dans autant de fichiers que de fonctionnalités (Tableau 1).

2.2 Côté client#

Le code côté client est structuré par le framework ExtJS (voir la documentation ExtJS sur http://docs.sencha.com/extjs/4.2.3/#!/guide pour plus de détails) de la même manière que dans les applications espèces, genres et familles. Les fichiers ainsi que leurs descriptions sont listés dans le Tableau 2.

3. Organisation des classes et méthodes #

3.1 Côté serveur#

  • Les méthodes contenues dans common.control.class.php récupèrent les POSTs et GETs envoyés par le client. Elles retournent un tableau PHP.
  • Les méthodes contenues dans common.data.class.php envoient les requêtes SQL. Elles retournent un tableau PHP.
  • Les méthodes contenues dans common.view.class.php encodent les tableaux PHP des résultats SQL en JSON.

Les méthodes ainsi que leurs descriptions sont listées dans le Tableau 3.

Note : Toutes les méthodes de la vue contenues dans common.view.class.php encodent un JSON à partir des méthodes portant le même nom, contenues dans common.data.class.php.

3.2 Côté client#

Toutes les méthodes de contrôle sont dans le fichier MainController.js sauf celles avec un astérisque qui sont dans le fichier codeNomenController.js (Tableau 4). Les méthodes sont toutes appelées par la méthode control du MainController. Cette méthode pointe vers l’élément HTML (avec son id en général) et déclenche un événement ( "#id" : {event: this.method}).

Exemple : "#homeBtn" : {click: this.homeNav}.

4. Diagrammes des objets JS et des méthodes, par fonctionnalité#






Tableau 1. Liste des noms de fichiers côté serveur, chemins ainsi que leurs descriptions.

Nom du fichier Chemin Description
dispatch.php back_end/common/ Inclut un "control", "data" et "view". Prend en paramètre GET[‘file’] un nom de fichier; e. g., dispatch.php?file=login pour appeler : login.control.php, login.data.php, login.view.php
common.control.class.phpback_end/common/control/classes/Contient les classes qui récupèrent les données envoyées par le client (POST, GET, etc) et les traitements éventuels.
common.data.class.phpback_end/common/data/classes/Contient les classes qui envoient les requêtes SQL.
common.view.class.phpback_end/common/view/classes/Contient les classes qui génèrent du JSON à partir des résultats des requêtes SQL
login.control.phpback_end/common/view/Reçoit le POST email et mot de passe pour l’identification du contributeur
login.data.phpback_end/common/data/Envoie la requête SQL avec les paramètres récupérés dans login.control.php
login.view.phpback_end/common/view/Récupère le résultat de la requête SQL dans login.data.php et l’encode en JSON
register.control.phpback_end/common/control/Reçoit les POSTs du formulaire d’inscription d’un nouveau contributeur
register.data.phpback_end/common/data/Envoie la requête SQL d’insertion d’un nouveau contributeur
register.view.phpback_end/common/view/Récupère le résultat de la requête d’insertion et affiche un message de succès ou d’echec
last_added_classif.control.phpback_end/common/control/Récupère le POST l'identifiant du contributeur
last_added_classif.data.phpback_end/common/data/Envoie la reqète SQL pour sélectionner les dernières classifications entrées par le contributeur
last_added_classif.view.phpback_end/common/view/Encode les résultats de la requête SQL en JSON
classif_store.control.phpback_end/common/control/Récupère le POST du ou des paramètres envoyés par le client (e. g., champ autocomplétion recherche auteurs de classification)
classif_store.data.phpback_end/common/data/Envoie la requête SQL de sélection de classifications avec les paramètres récupérés
classif_store.view.phpback_end/common/view/Récupère le résultat de la requête de sélection et l’encode en JSON.
create_classif_ref.control.phpback_end/common/control/Reçoit les POSTs du formulaire d’insertion d’une nouvelle classification.
create_classif_ref.data.phpback_end/common/data/Envoie la requête SQL d’insertion d’une nouvelle classification. Envoie une requête de sélection de la nouvelle entrée.
create_classif_ref.view.phpback_end/common/view/Récupère le résultat de la requête de sélection et l’encode en JSON.
modify_classif_ref.control.phpback_end/common/control/Reçoit les POSTs du formulaire de modification d’une référence de classification.
modify_classif_ref.data.phpback_end/common/data/Envoie la requête SQL de mise à jour de la référence de classification. Envoie une requête de sélection de la classification mise à jour.
modify_classif_ref.view.phpback_end/common/view/Récupère le résultat de la requête de sélection et l’encode en JSON.




Tableau 2. Liste des noms de fichiers côté client, chemins ainsi que leurs descriptions.

Nom du fichier Chemin Description
MainController.jsapp/controller/Contient les fonctions qui gèrent les événements et les requêtes AJAX.
codeNomenController.jsapp/controller/Contient les les fonctions qui gèrent les événements et les requêtes AJAX pour l’application de règles de nomenclature.
classif.jsapp/model/Spécifie les champs envoyés par la base de données, et qui concernent les classifications.
LastAddedClassif.jsapp/store/Appelle une liste des dernières classifications ajoutées par un utilisateur.
currentClassifStore.jsapp/store/Appelle les données concernant la classification sélectionnée.
ClassifSearch.jsapp/store/Appelle une liste de classifications suivant un paramètre POST. Utilisé surtout pour la recherche par autocomplétion.
allRanks.jsapp/store/Appelle tous les rangs.
MainView.jsapp/view/Affiche les éléments généraux de l’application (logo, bannière, topmenu, etc).
defaultHome.js Affiche les éléments généraux de l’application quand il n’y a pas de contributeur identifié.
connectedHome.jsapp/view/Affiche les éléments généraux de l’application quand un contributeur est identifié.
createClassifWindow.jsapp/view/Affiche le formulaire d’ajout d’une nouvelle classification.
myAccountView.jsAffiche les informations du compte contributeur.
modifyAccountWindow.jsapp/view/Affiche le formulaire de modification du compte contributeur.
modifyClassifRefmWindow.jsapp/view/Affiche le formulaire de modification d'une classification.
classifView.jsapp/view/Affiche tous les éléments qui constituent une fiche classification.
viewPDFWindow.jsapp/view/Affiche la fenêtre d’affichage des publications numérisées dans BHL (iFrame)
dataAccess.jsapp/localisation/Contient les chemins vers les fichiers côté serveur.
defaultEnglish.jsapp/localisation/Index des labels des champs (en anglais)




Tableau 3. liste des méthodes côté serveur avec la classe et le fichier contenant ainsi que leurs descriptions.

Méthode Classe Localisation Description
loginContributorControlcommon.control.class.phpReçoit les paramètres suivants en POST : email, password . Retourne un tableau PHP incluant les valeurs des POSTs.
registerContributorControlcommon.control.class.phpReçoit les paramètres suivants en POST : title, forename, surname, email, pass, pass_confirm, job_title, institution, institution_address. Retourne un tableau PHP incluant les valeurs des POSTs.
autoCompleteStoreClassifControlcommon.control.class.php Reçoit les paramètres suivants en GET (champs autocomplétion) : comboFilter (string des caractères entrés), start, limit. Retourne un tableau PHP incluant les valeurs des GETs.
insertNewClassifRefClassifControlcommon.control.class.phpReçoit les paramètres en POSTs. Retourne un tableau PHP incluant les valeurs des POSTs.
updateClassifRefClassifControlcommon.control.class.phpReçoit les paramètres en POSTs. Retourne un tableau PHP incluant les valeurs des POSTs.
loginContributorDatacommon.data.class.phpEnvoie une requête SQL select à la table CONTRIBUTOR. Prend les paramètres retournés par ContributorControl -> login. Retourne un tableau PHP contenant les données du compte contributeur.
lastAddedClassifClassifDatacommon.data.class.phpEnvoie une requête SQL select à la vue CLASSIF_STORE. Prend comme paramètre $_SESSION["CONTRIBUTOR"]. Retourne un tableau PHP contenant les dernières entrées de noms scientifiques.
classifStoreClassifDatacommon.data.class.php Envoie une requête SQL à la vue CLASSIF_STORE. Retourne un tableau PHP contenant les données sur les classifications correspondants aux caractères entrés dans le champ d’autocomplétion.
insertNewClassifRefCreateClassifDatacommon.data.class.php Envoie une requête SQL insert à la table CLASSIF_REF. Retourne un tableau PHP contenant les données de la classification nouvellement entrées.
updateClassifRefCreateClassifDatacommon.data.class.phpEnvoie une requête SQL update à la table CLASSIF_REF. Retourne un tableau PHP contenant les données de la classification en cours.




Tableau 4. liste des méthodes côté client avec leurs descriptions.

MéthodeDescription
homeNavCharge la page d’accueil
loginSubmitEnvoie les données du formulaire d’identification
createAccountSubmitEnvoie les données du formulaire de création de compte
signOutDéconnexion du contributeur
showMyAccountAffiche les informations du compte contributeur
openAccountModifyWindowOuvre la fenêtre formulaire de modification du compte contributeur
submitAccountModificationEnvoie les données du formulaire de modification du compte contributeur
viewPDFWindowOuvre une iFrame biodiversitylibrary.org de la page de création du nom scientifique
openModifyClassifWindowOuvre la fenêtre formulaire de modification d’une référence de classification.
displayClassifAffiche la page de la classification sélectionnée
createClassifSubmitEnvoie les données du formulaire d’ajout d'une classification
modifyClassifSubmitEnvoie les données du formulaire de modification d’une classification.

Ajouter un attachement

Pour publier un nouvel attachement à cette page, veuillez utiliser la boite suivante pour atteindre le fichier, puis cliquez sur “Télécharger”.
« Cette page (révision-9) a été modifiée pour la dernière fois le 19-déc.-2014 09:27 par berkani