🌐 English · Deutsch · Español · Nederlands · 简体中文

Modèle de données et édition

Gramps Connect fonctionne avec le même modèle d'objets que Gramps lui-même. Il y a dix types de fiches, chacun avec sa propre vue de liste, son propre champ de recherche consultable (texte simple par défaut, ou GOQL via une case à cocher), et son propre endpoint REST sur gramps-web-api :

Type	Vue de liste	Endpoint de requête
Person	Individus	/api/people/query/
Family	Familles	/api/families/query/
Event	Événements	/api/events/query/
Place	Lieux	/api/places/query/
Repository	Dépôts	/api/repositories/query/
Source	Sources	/api/sources/query/
Citation	Citations	/api/citations/query/
Media	Media	/api/media/query/
Note	Notes	/api/notes/query/
Tag	Étiquettes	/api/tags/query/

Puisqu'un arbre peut circuler librement entre Gramps Desktop, gramps-web, et Gramps Connect (voir Aperçu), ce sont exactement les types de fiches et les champs que Gramps XML et GEDCOM portent déjà — Gramps Connect n'en ajoute ni n'en retire aucun.

Parcourir

Choisir une fiche dans une liste, et tout ce qui s'y rapporte — événements, famille, photos, notes, sources — apparaît à côté. Cliquer sur l'un d'eux ouvre ses propres détails en dessous, tandis que la liste et la sélection d'origine restent où elles étaient, quelle que soit la profondeur atteinte (voir Recherche et filtres).

Éditer

Formulaires d'édition complets

Cliquer sur le bouton d'édition d'un enregistrement ouvre son formulaire d'édition complet, pour les informations propres de l'enregistrement (un nom, une date, une description) ou ses liens avec d'autres enregistrements : par exemple la relation exacte d'un enfant avec ses parents.

Liens rapides avec « + » et « − »

Pour les petits changements du quotidien, les boutons « + » et « − » sont un raccourci : rattacher une citation, une photo ou une personne existante sans ouvrir de formulaire complet, ou en retirer une déjà liée. Ils ne changent que ce à quoi un enregistrement est relié, pas ses propres informations.

Le « + » de chaque section se trouve juste à côté de son titre (survolez-le pour voir ce qu'il ajoute, par exemple « Ajouter un enfant »), si bien qu'un enregistrement aux sections presque vides reste compact. Les étiquettes sont aussi affichées sur la ligne de leur titre, à côté de leur propre « + ».

Ce qui est entièrement modifiable aujourd'hui

Les enregistrements Personne et Famille sont les plus complets, avec une exception notable : les ordonnances SDJ sont entièrement en lecture seule, sans modification, ajout ni détachement.

Ce qui est partiellement modifiable, par type

Lieu

Lieux englobants depuis Wikidata

La hiérarchie des lieux englobants d'un lieu peut être remplie par une recherche sur Wikidata : cherchez par nom, confirmez une correspondance, et la chaîne ville/comté/État/pays est créée ou reliée, chaque niveau avec ses propres coordonnées. Il n'existe toujours aucun moyen d'ajouter, de retirer ou de réordonner à la main un lieu englobant, indépendamment de Wikidata.

Types de lieu

Le champ Type de chaque niveau est aussi déduit de Wikidata, d'après une table d'environ 2700 classes de divisions administratives et d'habitats couvrant la plupart des pays (pas seulement le schéma américain ville/comté/État/pays). Une classe non reconnue laisse le Type vide sur l'écran de confirmation, à remplir à la main.

Titres des lieux recherchés

Chaque niveau créé par la recherche reçoit son propre nom et un titre écrit dans le format de lieu actif de l'arbre. Voir Cartes pour la façon dont les noms, les titres et leurs langues sont choisis.

Ajouter un nouveau lieu

L'éditeur d'un tout nouveau lieu demande d'abord s'il faut l'ajouter manuellement ou depuis Wikidata, au lieu d'afficher la recherche comme un champ de plus parmi les champs manuels. Un lieu déjà enregistré qu'on modifie à nouveau garde la recherche sous forme de simple bouton d'enrichissement.

Contours depuis Wikidata

La même recherche peut aussi récupérer un contour sur Wikidata (une case à cocher sur l'écran de confirmation, activée par défaut), pour chaque niveau nouvellement créé et pour le lieu ajouté. La carte montre alors la vraie frontière du lieu au lieu d'une simple épingle à ses coordonnées.

Le contour est rattaché de la même façon qu'une forme dessinée à la main sur la carte, il peut donc ensuite être modifié ou retiré depuis la vue Médias comme n'importe quelle autre pièce jointe. Il est coloré selon le type du lieu et son ID Wikidata, pour que les lieux n'aient pas tous le même remplissage. Les niveaux de la hiérarchie qui existaient déjà, ou qui ont été réutilisés, n'en reçoivent pas.

Noms de lieu datés

Le nom propre (principal) d'un lieu peut porter une date et une langue, avec le même éditeur de date que les événements et les citations. C'est ce que lit la visibilité par date des superpositions de carte (voir Cartes).

Ce qui manque encore

• Noms alternatifs : la liste alt_names d'un lieu est affichée en lecture seule, sans moyen d'ajouter, de modifier ou de retirer des entrées. Chaque entrée est un nom avec sa propre date et sa propre langue, par exemple pour consigner un ancien nom et l'époque où il s'appliquait.
• Emplacements historiques.
• Code.

Note

Manquent : la mise en forme du texte et les liens (les notes sont du texte brut uniquement), et l'indicateur de format (Fluide/Formaté).

Média

Ce qui est modifiable

La description, la date et la confidentialité se modifient avec un bouton Modifier. Le fichier lui-même, son type et sa somme de contrôle restent tels que le serveur les a tirés du téléversement. Les attributs, citations, notes et étiquettes se modifient avec les mêmes sections d'enregistrements liés que tous les autres types d'enregistrement.

Afficher les fichiers dans le navigateur

Les photos s'ouvrent en taille réelle au clic. Un élément Médias (ou Sortie) dont le fichier est un PDF, une vidéo, un son, un SVG ou un format de type texte (HTML, JSON, texte brut, CSV, GEDCOM, KML/XML, ...) a à la place un bouton Afficher, qui ouvre le fichier dans le navigateur au lieu d'obliger à le télécharger.

Les aperçus HTML sont affichés de façon isolée (sans scripts), pour que la mise en forme d'un rapport généré s'affiche sans jamais rien y exécuter. Les ressources liées par un chemin relatif ne se chargent toutefois pas, puisque seul ce fichier est disponible, pas un dossier de fichiers voisins.

Fusionner les enregistrements en double

Tous les types d'enregistrement sauf Étiquette peuvent être fusionnés : sélectionnez deux enregistrements du même type (ctrl/cmd+clic dans une liste), puis Fusionner.

Quel enregistrement est conservé

Choisissez celui qui est conservé. Ses propres champs définitoires (nom, titre, date, etc., selon le type) sont gardés et ceux de l'autre écartés, tandis que ce qui a la forme d'une liste, comme les notes, citations, médias et attributs, est combiné à partir des deux.

Références à l'enregistrement fusionné

Toutes les autres références à l'enregistrement qui n'est pas conservé sont redirigées vers celui qui l'est, avant sa suppression.

Familles aux parents différents

Famille est le seul type dont les deux enregistrements peuvent diverger sur un parent. Dans ce cas, on vous demande, par rôle (père/mère), quel côté garder.

Fusionner des étiquettes

Gramps ne sait pas fusionner des étiquettes, l'application s'en charge donc elle-même : tout ce qui porte l'étiquette écartée reçoit celle qui est conservée, puis l'étiquette écartée est supprimée.

Voir l'historique des modifications

Chaque enregistrement a un bouton Historique à côté de ses liens Carte/Chronologie/Graphe. Il ouvre le journal des modifications de cet enregistrement (qui a fait chacune, quand, et s'il s'agissait d'un ajout, d'une modification ou d'une suppression), du plus récent au plus ancien, page par page.

Cliquez sur une entrée pour voir exactement ce qui a changé : une comparaison avant/après champ par champ, pas seulement le fait que quelque chose a changé.

C'est le complément a posteriori de la synchronisation en direct (voir Architecture), qui ne montre les modifications qu'à leur arrivée. Les deux lisent le même journal de transactions de gramps-web-api.

Pas encore d'annulation

Revenir sur un changement veut dire remodifier l'enregistrement à la main. Voir Feuille de route et limitations connues pour l'état d'avancement.

Lacunes transversales

Les champs GrampsType sont surtout du texte libre

Le type de relation d'une famille, et le propre type d'Attribut/URL, ont une vraie liste déroulante avec autocomplétion d'après la liste des valeurs connues de Gramps. Les autres champs GrampsType se modifient comme du texte brut, simplement sans cette autocomplétion ni validation pour l'instant.

Les modifications simultanées sont détectées, pas fusionnées

Si un enregistrement a changé sur le serveur après que vous avez ouvert son formulaire (par quelqu'un d'autre, ou dans un autre de vos onglets), l'enregistrement est refusé avec une erreur au lieu d'écraser en silence l'autre modification. Il n'existe toujours aucun moyen de voir ce qui a changé ou de fusionner les deux modifications ; il faut rouvrir le formulaire et refaire la vôtre.

Voir Feuille de route et limitations connues pour l'état d'avancement de ces points.