Différences

Ci-dessous, les différences entre deux révisions de la page.

--- td_histoire_numerique:descriptif_exercice_3 [2014/10/08 17:36]
Francesco Beretta [Structure du codage]
+++ td_histoire_numerique:descriptif_exercice_3 [2014/10/11 08:55]
Francesco Beretta [Choix du type d'objet]
@@ Ligne 1: / Ligne 1: @@
@@ Ligne 11: / Ligne 12: @@
-**Exercice pour la prochaine séance**, 13 octobre – à remettre au plus tard dimanche soir
+===== Exercice pour la prochaine séance =====
+Exercice pour la séance du 13 octobre – à remettre au plus tard dimanche soir
   - Créer une trentaine d'objets dans votre base personnelle, de différents types, et les associer entre eux (quelques explications sur le sens des associations sont données ci-dessous)
@@ Ligne 17: / Ligne 21: @@
   - Indexer un texte concernant votre sujet (vos notes, une transcription de sources, un article de dictionnaire, etc.) avec les clés des objets (= les identifiants préfixés par ObPe: ObPe1, ObPe2, etc.) selon l'un des deux procédés indiqués ci-dessous: si vous utilisez le traitement de texte, n'indexer qu'une dizaine d'objets; si vous utilisez XML, il n'y a pas de limite
   - Envoyez-moi le fichier de sauvegarde du schéma 'objets' et le texte indexé dans un dossier contenant les deux, comportant votre nom dans le nom de dossier et compressé (.zip). Dans windows 7, la compression se fait avec un click droit sur le dossier, puis Envoyer vers > Dossier compressé; dans MacOSX, click droit, puis Compresser
-=====Présentation du modèle conceptuel=====
+====== Création des objets ======
+=====Du modèle conceptuel à la base de données=====
+==== Le modèle conceptuel: la sémantique du système d'information ====
 Voici le {{:td_histoire_numerique:mcd_base_td_histoire_numerique.odg|fichier du MCD}} à télécharger.
+Le modèle conceptuel (MCD) est le fondement de la construction d'une base de données. Il indique les entités qui vont étre créées ainsi que leurs associations. Il indique donc en quelque sorte le sens, la //sémantique des données// qu'on va produire.\\
+Les entités représentent des classes d'objets, c'est-à-dire des ensembles d'objets qui partagent les mêmes propriétés. Le MCD liste donc également les propriété des entités et de leurs associations. \\
+Dans notre MCD, la partie concernant les objets dont s'occupe l'historien (c'est-à-dire les acteurs, les lieux, les ouvrages consultés, etc.) comporte deux entités: les objets eux-mêmes et les noms des objets. Ces entités sont reliées par deux associations: l'une entre les objets et leurs noms, l'autre entre deux objets (on appelle cette association réflexive car elle relie l'entité objet à elle-même). La cardinalité des associations, c'est-à-dire les numéros qui figurent sur les pattes des associations indiquent qu'un nom d'objet ne peut être relié qu'à un seul objet, alors qu'on objet peut avoir plusieurs noms. Quant aux associations entre objets, elles peuvent associer autant de paires d'objets qu'on veut: c'est une association de cardinalité maximale de 'n' à 'n', comme disent les spécialistes.\\
+Tous les objets, ainsi que leurs liens essentiels (un livre qui parle d'un personnage historique, une photo qui représente une personne avec ses caractéristiques, etc.) sont traités avec seulement deux entités et deux associations. Ce //modèle des données// est donc dit //générique// car il permet de tout traiter de manière simple et efficace.\\
+Un modèle générique requiert quelques paramètres qui spécifient quel est le type des objets (acteurs, acteurs collectifs, objets abstraits, etc.) ainsi que le type des associations qui subsistent entre les objets (documentation, classes, reproduction, etc.). Tel est le rôle de l'entité 'paramètre système' et de l'association 'associer parametres systeme' qui permettent le bon fonctionnement du système d'information.
+==== Les tables comme 'représentation informatique' du modèle ====
+A partir du modèle des données, on a créé les tables qui se trouvent dans le schéma 'objets' de la base de données, ainsi que dans le schéma 'parametres'.\\
+Un schéma est une sorte de dossier qui contient des tables, des fonctions, etc.\\
+Une table est un ensemble de cellules, organisées en lignes et en colonnes. Une cellule appartient toujours à la même ligne et à la même colonne et ne peut pas être déplacée (ce qui est en revanche le cas dans une feuille de calcul qui, précisément, n'est pas une table de stockage de données mais un outil de calcul).\\
+Dans une table, les lignes représentent les individus, c'est-à-dire les objets. Les colonnes représentent les propriétés des objets (les mêmes qu'on trouve dans le modèle conceptuel). Une cellule contient donc la valeur de la propriété pour l'individu représenté par la ligne. La table elle même représente informatiquement l'entité, la classe ou ensemble des individus.\\
+Le logiciel client pgAdminIII permet de visualiser directement les tables. Dans le schéma 'objets' on trouve les trois tables qui vont accueillir vos propres objets. Dans le schéma 'parametres' se trouvent les deux tables des paramètres. Il ne faut pas toucher aux données de ces dernières car, pour une question de cohérence, c'est moi qui définis leur contenu.\\
+L'**interface** du client Base (suite LibreOffice) permet une visualisation des tables et de leur contenu plus organique et facile à manipuler que d'accéder directement aux tables. Dans un même formulaire on voit apparaître des lignes et des cellules issues de plusieurs tables différentes: les objets, les noms, les associations entre objets et les valeurs des paramètres.\\
+Sur une fiche de formulaire on voit apparaître toutes les cellules issues de différentes talbes concernant le même objet. La clé de l'objet, la //primary key// (pk_objet), se situe généralement en haut du formulaire. Par convention, nous parlerons d'une **'pk'** pour la clé purement numérique (1, 2, 3, etc.), alors que nous appellerons **'clé'** (clé semi-sémantique) la clé avec préfixe (ObPe1, ObPe2, etc.) ajouté automatiquement par concaténation avec la clé numérique. Le préfixe indique que, dans ce cas, il s'agit d'un 'objet à usage personnel'. Il est ainsi distingué des objets de la base de données collaborative du [[http://symogih.org|projet SyMoGIH]] (cf. ci-dessous)
+===== Création des objets =====
+Avant de procéder il faut **vérifier que la base de données dont on dispose est à jour** tant au point de vue des paramètres et des autres tables que de l'interface.\\
+Les **fichiers à jour** à télécharger et les instructions se trouvent [[td_histoire_numerique:descriptif_exercice_2&#mise_a_jour_de_la_base_de_donnees_et_de_l_interface|ici]].
+==== Manipulation de l'interface ====
+La création d'un nouvel objet dans la base de données s'effectue grâce au formulaire 'objets_création' qu'on trouve dans la liste des formulaires et qu'on active par un double click.\\
+Il faut en premier lieu introduire une définition de l'objet en quelques mots, ou plus longue si souhaité. Cette opération est essentielle pour se souvenir plus tard quel est le sens exact de l'objet qu'on a créé. Elle est donc obligatoire. On ne peut pas crééer de nom de l'objet si on n'a pas créé une définition.\\
+On créé ensuite le nom de l'objet. Le nom créé avec ce formulaire sera le nom standard par défaut de l'objet. On pourra ensuite ajouter d'autres noms avec les autres formulaires des objets. Si l'objet est un livre ou un article d'archives on entre tout simplement comme nom la référence archivistique ou la référence bibliographique.\\
+Pour les acteurs, on peut choisir entre différents types de noms. Pour les autres objets, ce n'est pas la peine. On peut également choisir une langue pour le nom. Il suffit de la taper dans le champs de la langue, si elle n'existe pas encore, ou de la choisir parmi les langues existantes.\\
+On peut aussi mettre une date de début et/ou de fin pour l'utilisation d'un nom. Les dates doivent être au format ISO, par ex. 1566-03-07. Elles peuvent être tronquées : 1566 ou 1566-03. Si le nom termine tel jour, mois ou année (en fonction de la troncature de la date), le prochain nom doit commencer le jour, mois ou année suivante. Par ex. fin =  1566-03-07, début du prochain nom =  1566-03-08 ; fin =  1566-03, début du prochain nom  1566-04.\\
+Pour enregistrer une valeur que vous avez entrée, on peut se déplacer dans un autre champs ou clicquer en dehors des champs (c'est-à-dire des zones blanches qui font apparaître le contenu des cellules). On peut aussi appuyer sur le bouton 'Enregistrer l'enregistrement' (= les cellules du formulaire) qui se trouve en bas. Si le changements on été enregistrés, le bouton 'Enregistrer' est grisé. Si un changement attendu n'apparaît pas après enregistrement, il faut appuyer sur le bouton 'actualiser' pour rafraîchir le formulaire.\\
+Si on se déplace vers la prochaine fiche du formulaire on déclanche automatiquement l'enregistrement des valeurs modifiées. On se déplace entre les fiches avec les boutons en forme de fléche tout en bas. Il est toutefois nécessaire de se positionner dans un champs marqué par [P] = champs principal du formulaire.\\
+{{:td_histoire_numerique:bd_creation_objets.png?200|}}
+On renseigne ensuite la date de début et la date de fin d'existence d'un objet. Les dates sont partout au format ISO, par ex. 2014-10-02, et peuvent être tronquées, par ex.  2014-10 ou  2014.\\
+La date de début a un signification différente pour chaque type d'objets: date de naissance pour les acteur, date de création pour une institution, date de publication pour une référence bibliographique.\\
+La date de début doit être renseignée chaque fois qu'on le peut pour pouvoir trier et mieux reconnaître les objets. Si on ne connait pas une date précise on peut mettre un paramètre concernant la certitude de la date: elle est reconstituée si elle correspond à peu pres à la date exacte (différence de quelques jours, mois ou années en fonction de la troncature) sur la base d'éléments d'information dont on dispose et qu'on peut indiquer dans les notes; elle est postulée si on la fixe de manière arbitraire, en prenant en compte des éléments génériques (par ex. que telle personne devait avoir vingt ans lorsque elle fréquentait l'université en 1600, et que donc elle était née vers 1580).
+Dans le cas des objets de type acteur on peut leur attribuer un sexe (masculin, féminin ou indéterminé).\\
+Dans celui des objets de type lieu ou immeuble, on peut mettre des coordonnées géographiques décimales. Par ex. pour Lyon : (longitude = ) 4.833512 – (latitude = ) 45.767463. On peut retrouver les coordonnées d'un lieu grâce à Wikipedia ou à un gazetteer comme [[http://geonames.org/|Geonames]]
+==== Choix du type d'objet ====
+Il reste à choisir le type d'objet. Le système d'information que je vous mets à disposition et que je vous propose d'utiliser pour réaliser la collecte d'informations au cours de votre travail de master est une version simplifiée du modèle de données du projet SyMoGIH: [[http://symogih.org|Système modulaire de gestion de l'information historique]]. Sur le site du projet, trouverez de la documentation si vous voulez en savoir plus et, surtout, plein d'exemples en parcourant les objets dans le menu de gauche sur la page d'accueil du site.\\
+Les données issues de la base de donnée collaborative en ligne, dans laquelle se trouvent des données produites par une cinquantaine d'historiens et une dizaine de projets, nous serviront d'exemple et de référence.\\
+L'expérience du projet SyMoGIH, montre qu'il convient de répartir tous les objets dont s'occupe l'historien en une dizaine d'ensembles ou classes que nous allons identifier grâce à la propriété 'type' de l'entité 'objet historique'. Le type nous permet de savoir à quelle classe appartient un objet.\\
+Le site public du projet a une fonction d'illustration et ne présente donc pas tous les aspect de la base de données collaborative. Tous les types d'objets n'y sont donc pas représentés.\\
+Vous trouverez ici de suite quelques explications concernant le sens de chaque type et des exemples des objets qui relèvent des différentes classes.
+=== Bibliographie ===
+Les objets de ce type correspondent aux ouvrages, articles, etc. que vous trouvez dans la bibliographie. Leur nom est tout simplement la référence bibliographique.\\
+=== Objet concret (ou matériel) ===
+Les objets concrets (ou matériels) sont les objets uniques qui ont un existence individuelle et qu'on peut toucher, déplacer, etc. Par ex. la chaise sur laquelle vous êtes assis ou le livre que vous tenez entre vos mains. Le descriptif bibliographique du livre (qui comprend tous les exemplaires existants de ce livre) est un objet de type 'Bibliographie' tandis
+===== Navigation et recherche d'objets =====
+La navigation et la mise à jour des objets se fait grâce au formulaire principal des objets, appelé **'objets'**. On peut parcourir les objets un par un, et ouvrir la liste de tous les objets que contient la table –en utilisant le bouton en bas à droite.\\
+{{:td_histoire_numerique:bd_formulaire_objets.png?200|}}
+On peut appliquer de filtres, trier, chercher dans le texte, etc.: l'objet sélectionné dans la liste de la partie supérieur est celui qu'on voit sur la fiche – on peut donc naviguer facilement parmi les objets, chercher uniquement les acteurs, etc.
+==== Paramètres ====
+ATTENTION: ne pas toucher au contenu des tables du schéma 'paramètres' car elles permettent à votre base de données de fonctionner correctement et vous risquez de compromettre l'affichage de vos données (mais soyez rassurés, les données elles du schéma 'objets' ne seront pas compromises car elles sont stockées à part)
+===== Création des associations =====
 ====== Encodage de textes en XML – TEI ======
@@ Ligne 48: / Ligne 146: @@
-Mise en fonction de jEdit:
+Pour les instructions de mise en fonction de jEdit, voir [[td_histoire_numerique:jedit&#activation_de_l_editeur_jedit_pour_notre_projet|ici]]
-  * Dans le gestionnaire des plugins (Menu Plugins > Gestionnaires des plugins), vérifier si le plugin ProjectViewer est déjà installé (onglet Gestion), sinon l'ajouter (onglet Installation)
-  * Ajouter également le plugin SQL
-  * Ouvrir la fenêtre du ProjectViewer, dans le menu AllProjects créer un nouveau projet
-  * L'appeler td_histoire_numerique
-  * Comme 'root directory' = dossier racine chercher avec le bouton 'Choose' le dossier 'documents_tei' que vous venez de créer à partir du fichier dézippé, le sélectionner sans l'ouvrir et appuyer sur le bouton 'Parcourir'
-  * Valider, ce qui comporte l'ouverture de la boite de dialogue 'Inital import', ne rien changer dans le paramètres et clicquer sur 'Import'
-  * Le contenu du dossier sera visible dans la fenêtre des projets
-Paramétrage de jEdit
-  * Modification du menu contextuel
-    * Par click droit au milieu de la fenêtre du texte activer le menu contextuel et sélectionner personnaliser ce menu
-    * Clicquer sur le bouton '+' pour ajouter une nouvelle entrée
-    * Sélectionner plugin XML
-    * Ajouter les entrées: Indentation XML, Insertion XML (Afficher/Masquer), Editer la balise au curseur
-    * A l'aide des fléches vertes monter les trois éléments insérés dans la deuxième zone du menu
-    * Sélectionner Plugin: Sideclick-Parsers, ajouter xml (analyser xml) et le monter au début de la partie xml du menu contextuel
-  * Création des raccourcis
-    * Dans le menu Utilitaires > Options générales sélectionner Raccourcis
-    * Ajouter des raccourcis: Ctrl-i pour Indentation XML; ctrl-maj-i pour Insertion XML; ctrl-maj-a pour xml 'analyser XML)
-  * Modification de la largeur de la fenêtre
-    * Menu Utilitaires > options générales, dans l'entrée Edition activer le retour à la ligne 'soft'
-    * adapter la longueur de la ligne (80-100 caractères) en fonction de la largeur de son propre écran
-  * Dans l'entrée encodages, mettre l'encodage par défaut à UTF-8
-  * Docker les fenêtres des plugins (Sideclick, ProjectViewer, Insertion XML) dans la fenêtre de gauche: Otions globales, Ancrage
-  * Dans 'Zone de texte' modifier la taille de la police de l'éditeur si souhaité
-\\
 ===== Structure du codage =====

Wiki de l'ARHNAxe de recherche en histoire numériqueLARHRA UMR5190

Outils pour utilisateurs

Outils du site

Différences

Outils de la page

Wiki de l'ARHN

Axe de recherche en histoire numérique
LARHRA UMR5190