Code source wiki de Importer des photos par lot

Modifié par Joséphine Ducruet le 2025/10/31 11:54

Afficher les derniers auteurs
1 **~ (% class="mark small" %)Version 4.2 et ultérieures(%%)**
2
3 |(% style="width:840px" %)(((
4 (% class="box" %)
5 (((
6 L’import par lot est la méthode la plus efficace pour intégrer de grands ensembles d’images dans Flora, par exemple lors de campagnes de numérisation.
7 Il permet en une seule opération de :
8
9 * créer les notices photothèque,
10 * associer automatiquement chaque photo à sa notice,
11 * et, si besoin, lier les photos aux notices de biens.
12
13 Vous trouverez dans cette page les étapes pour préparer le fichier d’import, déposer les images, lancer l’import et gérer les éventuelles erreurs.
14 )))
15
16 (((
17 = Objectifs =
18
19 L’import par lot de photos dans Flora permet d’intégrer rapidement des campagnes de numérisation ou des ensembles d’images existants dans la photothèque.
20 Chaque import combine deux éléments :
21
22 * **les fichiers image** (jpeg, tiff, etc.), déposés dans un dossier accessible au serveur Flora,
23 * **un fichier d’import au format tableur**, qui décrit les images et contient les informations de lien éventuelles avec les notices de biens.
24
25 Ce mécanisme garantit la pérennité des fichiers dans la GED de Flora, sans dépendance vis-à-vis de leur emplacement d’origine.
26
27 L’import a trois effets principaux :
28
29 1. **Créer les notices de la photothèque** pour chaque image,
30 1. **Associer automatiquement chaque fichier image à sa notice photothèque**,
31 1. **Lier les notices photos aux notices de biens** lorsque les numéros d’inventaire sont renseignés.
32
33 L’import de photos dans Flora ne s’effectue pas en une seule action : il suit un **enchaînement d’étapes successives**.
34 Chaque phase est importante car elle assure la création des notices photothèque, l’association des images et, si besoin, leur lien avec les notices de biens.
35
36 [[Etapes d'un import par lot de photos>>image:1756301632152-321.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
37
38 = Préparer les données =
39
40 Avant tout import, les informations descriptives des images doivent être préparées dans un fichier Excel (ou LibreOffice).
41 Ce tableau servira de base pour créer les notices photothèque, associer automatiquement les images et, si besoin, établir les liens avec les notices de biens.
42
43 (% class="box warningmessage" %)
44 (((
45 **Attention aux gros volumes** : si vous devez traiter plusieurs milliers d’images, il est recommandé de fractionner le traitement par lots de **1000 notices maximum**.
46 En effet, les opérations de génération des imagettes et des images plein écran peuvent prendre plusieurs secondes par fichier, ce qui ralentit considérablement le processus d’import.
47 )))
48
49 == Télécharger le modèle d'import ==
50
51 1. **Télécharger le modèle Excel** depuis la page d’accueil de l’interface d’import Flora.
52
53 Deux modèles sont proposés : un pour les images standard (JPEG), un pour les images haute définition (TIFF).
54
55 La procédure est identique pour les deux modèles, à une différence près. Lorsque vous sélectionnez le fichier d’import **« Imports d’images très haute def (avec tuilage) »**, une colonne spécifique du fichier indique à Flora qu’il faut **procéder au tuilage des images importées**.
56
57 [[Lien pour télécharger le modèle d'import d'images standards>>image:1744033618928-690.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
58
59
60 (% start="2" %)
61 1. **Débloquer les macros** si nécessaire :
62 11. Clic droit sur le fichier téléchargé → //Propriétés// → cocher //Débloquer//.
63 11. Ouvrir ensuite le fichier et activer la modification et le contenu.
64
65 [[Accéder aux propriétés du fichier>>image:1756302376310-999.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
66
67
68 [[Débloquer les macros>>image:1756302425959-667.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
69
70
71 [[Activer les macros>>image:1756302477552-167.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
72
73 == Renseigner le modèle d'import ==
74
75 Une fois le modèle Excel téléchargé et débloqué, il faut le **compléter avec les informations communes au lot de photos**.
76 Ces données servent de paramètres généraux pour l’import : elles indiquent à Flora où trouver les images, quel est leur format, et quelles informations appliquer à l’ensemble du lot (photographe, date de prise de vue…).
77
78 [[Informations communes au lot de photos>>image:1756303456246-598.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
79
80
81 * **Dossier temporaire vu par votre poste de travail**
82 ** C’est **l’emplacement sur votre ordinateur où se trouvent les images à importer**.
83 ** Utilisé pour générer automatiquement la liste des images à importer.
84 * **Nom du photographe**
85 ** Peut être renseigné directement ici si toutes les photos du lot ont le même photographe.
86 ** Ce champ sera automatiquement recopié dans chaque notice photo lors de l’import.
87 * **Date de prise de vue**
88 ** À renseigner si la date est identique pour toutes les photos du lot.
89 ** Formats acceptés : JJ/MM/AAAA ou AAAAMMJJ.
90 * **Dossier temporaire vu par le serveur Flora**
91 ** Il s’agit du **répertoire du serveur dans lequel Flora va rechercher les images au moment de l’import**.
92 ** **À partir de la (% class="mark small" %)version 4.5.60(%%)**, le chemin d’accès peut être **récupéré directement depuis la page d’accueil des imports**, ce qui évite toute erreur de saisie.
93 ** Pour les versions postérieures, reportez-vous au **cahier de paramétrage** fourni lors de l’installation.
94 * **Filtrer sur extension de fichier**
95 ** Permet de préciser quel type de fichiers doit être pris en compte lors de l’import (par défaut les .jpg, mais peut être adapté.
96
97 À partir de la version (% class="mark small" %)**4.7 de Flora**(%%), il est également possible de renseigner directement dans le **fichier Excel d’import** les informations liées aux **droits des photos** (mention des droits, titulaire des droits, licence accordée).
98
99 (% class="box infomessage" %)
100 (((
101 **Astuce : récupérer le chemin d’un dossier**
102
103 1. Ouvrez l’explorateur de fichiers de votre ordinateur.
104 1. Naviguez jusqu’au dossier où sont stockées vos images.
105 1. Cliquez dans la barre d’adresse du dossier → le chemin complet apparaît.
106 1. Copiez ce chemin (Ctrl+C).
107 1. Collez-le (Ctrl+V) dans le champ **« Dossier temporaire vu par votre poste de travail »** du fichier Excel (champ vert).
108
109 [[Chemin d'un dossier>>image:1756303345398-716.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
110 )))
111
112 == Générer la liste des images à importer ==
113
114 Grâce aux **macros intégrées au fichier Excel**, il n’est pas nécessaire de saisir manuellement les informations techniques des photos.
115 Lorsque vous cliquez sur le bouton //« Générer la liste des images à importer »//, le document va automatiquement parcourir le dossier temporaire indiqué et **récupérer toutes les métadonnées utiles** (nom de fichier, chemin d’accès, poids, résolution, etc.).
116
117 Un message confirme ensuite le nombre de fichiers traités.
118
119 Ces informations peuvent être **complétées ou modifiées** si besoin (par exemple ajouter ou corriger le nom du photographe, ou un titre plus précis).
120
121 (% class="box warningmessage" %)
122 (((
123 **Important :** il ne faut jamais modifier les colonnes générées automatiquement **NOM_ORIGINAL et CHEMIN_ORIGINAL**, car elles servent à l’identification unique des images par Flora.
124 )))
125
126 [[Bouton générer la liste des images à importer>>image:1756303746029-665.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
127
128 == Renseigner les liens avec les biens (option) ==
129
130 Dans le fichier d’import, les colonnes **Préfixe** et **Numéro d’inventaire du bien pour lien** permettent d’indiquer à Flora à quel bien doit être rattachée chaque photo.
131
132 Vous pouvez **lier plusieurs photos à un même bien** en répétant le même couple //Préfixe + Numéro d’inventaire// sur plusieurs lignes (chaque ligne correspondant à une photo différente).
133
134 En revanche, **une photo ne peut pas être rattachée à plusieurs biens** : chaque ligne ne doit contenir qu’un seul couple //Préfixe + Numéro d’inventaire//.
135
136 (% class="box warningmessage" %)
137 (((
138 **Point de vigilance** : le couple //Préfixe + Numéro d’inventaire// est **obligatoire** pour que Flora identifie correctement le bien.
139 Soyez attentif aux erreurs possibles :
140
141 * fautes de frappe,
142 * espaces indésirables lors des copier-coller,
143 * formats incohérents avec la base.
144
145 **Ces anomalies empêchent la création du lien entre la photo et le bien.**
146 )))
147
148 [[Exemple de champs renseignés pour lien avec les biens>>image:1756304207678-600.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
149
150 == Enregistrer le fichier d’import au format requis ==
151
152 Avant de lancer l’import, le fichier Excel doit être **converti en fichier texte tabulé (.txt)**, seul format accepté par Flora.
153 Cette opération se fait directement depuis le modèle d’import :
154
155 1. Cliquez sur le bouton **« Enregistrer le fichier en texte/tabulation pour import Flora »**.
156 1. Cette action déclenche une **macro** qui transforme automatiquement votre tableau Excel en fichier .txt compatible.
157 1. Le fichier texte est créé **dans le même dossier que le fichier Excel d’origine**.
158
159 Ce format pivot garantit la compatibilité avec Flora et supprime les lignes d’aide pour ne conserver que les données nécessaires à l’import.
160
161 [[Enregistrer le fichier en texte/tabulation pour import Flora>>image:1756304505640-498.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
162
163 = Importer les images sur le serveur Flora =
164
165 (% class="box infomessage" %)
166 (((
167 == Importer les fichiers photos : interface ou FTP ? ==
168
169 |=Critère|=**Via l’interface Flora**|=**Via FTP (File Transfer Protocol)**
170 |**Accès**|Directement depuis Flora, dans **Outils > Imports**|Depuis un logiciel FTP (ex. //FileZilla//) ou un accès serveur
171 |**Simplicité**|Très simple, utilisable par tous les profils utilisateurs|Requiert des identifiants de connexion et un minimum de connaissances techniques
172 |**Volume conseillé**|Petits et moyens lots (quelques dizaines à centaines de fichiers)|Gros volumes (plusieurs milliers de fichiers)
173 |**Vitesse de transfert**|Dépend de la connexion et du navigateur → peut être lent pour de gros lots|Optimisé pour le transfert massif, plus rapide et plus stable
174 |**Nettoyage du dossier temporaire**|Doit être fait **image par image** depuis Flora, donc fastidieux|Plus souple : fonctionne comme un explorateur de fichiers → on peut supprimer, déplacer ou renommer en masse
175 |**Usage recommandé**|Pour des dépôts ponctuels ou tests|Pour des campagnes de numérisation ou imports massifs
176 )))
177
178 == Via l'interface ==
179
180 En plus du fichier d’import .txt, il faut que **les images elles-mêmes** soient disponibles dans Flora.
181 L’import des fichiers photos peut se faire directement depuis l’interface, sans passer par un accès serveur ou FTP.
182
183 1. (((
184 Accédez au menu **Outils > Imports**.
185 )))
186 1. (((
187 Se placer sur le répertoire **Images et documents**
188 )))
189 1. (((
190 Cliquez sur le bouton **« + »** pour ouvrir une fenêtre de sélection.
191 )))
192 1. (((
193 Cliquez de nouveaux sur le **« + »** et parcourez votre ordinateur pour sélectionnez les fichiers images (vous pouvez sélectionner plusieurs fichiers en même temps).
194 )))
195 1. **Lancer le transfert **: les images sélectionnées sont alors **chargées dans un dossier temporaire d’import** de Flora.
196
197 À ce stade, les images sont bien présentes dans Flora et prêtes à être associées aux notices lors de l’exécution de l’import.
198
199 [[Accéder à la fenêtre de sélection>>image:1756306956116-237.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
200
201 [[Sélectionner des images>>image:1756307103826-588.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
202
203 [[Lancer le transfert>>image:1756307034100-859.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
204
205 [[Images importées>>image:1756307174791-596.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
206
207 == Via un File Transfer Protocol (FTP) ==
208
209 (% class="box warningmessage" %)
210 (((
211 **Ce protocole FTP est destiné aux clients hébergés par Flora Software.**
212 Pour les clients en **installation locale (non hébergés)**, il revient à l’établissement de **mettre en place sa propre procédure de dépôt des fichiers photos** sur son serveur.
213 )))
214
215 (% class="box infomessage" %)
216 (((
217 **FTP (File Transfer Protocol)** est un protocole standard d’échange de fichiers entre un ordinateur et un serveur, via Internet ou un réseau local.Il permet de **déposer, télécharger, supprimer ou organiser des fichiers** dans un répertoire distant, un peu comme on le ferait dans l’explorateur de fichiers de son poste.Dans Flora, le FTP est utilisé pour :
218
219 * transférer rapidement de gros volumes d’images vers le serveur,
220 * organiser ou nettoyer le dossier temporaire d’import plus facilement qu’avec l’interface,
221 * garantir que les fichiers sont disponibles pour l’import automatique.
222
223 Pour les clients hébergés, **Flora Software recommande l’utilisation de FileZilla**, une application gratuite et en téléchargement libre sur internet, afin de faciliter les transferts et la gestion des fichiers.
224 )))
225
226 1. Ouvrez FileZilla.
227 1. (((
228 En haut de l’écran, saisissez :
229
230 * **Hôte** (adresse du serveur),
231 * **Nom d'utilisateur**,
232 * **Mot de passe**,
233 * **Port**.
234 )))
235
236 Les informations de connexion FTP (hôte, identifiant, mot de passe et port) vous sont transmises dans le **cahier de paramétrage Flora**.
237
238 (% start="3" %)
239 1. Cliquez sur **Connexion rapide**.
240 1. Si la connexion réussit, la fenêtre de droite affichera l’arborescence du **serveur Flora**, et la fenêtre de gauche celle de votre **ordinateur local**.
241 1. (((
242 Dans la partie droite (serveur Flora), ouvrez le dossier prévu pour l’import des images :
243
244 * (((
245 import_prod (pour un import en base de production)
246 )))
247 * (((
248 import_test (pour un import en base de test).
249 )))
250 )))
251 1. Dans la partie gauche (ordinateur), localisez le dossier contenant vos photos.
252 1. Sélectionnez les fichiers.
253 1. Faites un **clic droit puis Téléverser**
254 1. Vérifiez que tous vos fichiers sont bien transférés : ils doivent apparaître dans le dossier serveur.
255
256 (% class="box infomessage" %)
257 (((
258 **Astuce **: Une fois l’import terminé dans Flora, vous pouvez **supprimer les fichiers du dossier temporaire** directement depuis FileZilla (clic droit > Supprimer), ce qui est beaucoup plus pratique qu’image par image depuis l’interface Flora.
259 )))
260
261 [[Interface de FileZilla>>image:1756307744085-395.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
262
263 [[Téléverser sur FileZilla>>image:1756307907139-563.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
264
265 [[Photos téléversées>>image:1756307951698-244.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
266
267 = Charger le fichier de données dans Flora =
268
269 1. (((
270 Accédez au menu **Outils > Imports**.
271 )))
272 1. (((
273 Se placer sur le répertoire **Fichiers textes**
274 )))
275 1. (((
276 Cliquez sur le bouton **« + »** pour ouvrir une fenêtre de sélection.
277 )))
278 1. (((
279 Cliquez de nouveaux sur le **« + »** et parcourez votre ordinateur pour sélectionnez le **fichier txt** contenant les données à importer.
280 )))
281 1. **Lancer le transfert **: le fichier s’affiche désormais dans la liste des fichiers prêts à être importés.
282
283 [[Accès à la fenêtre de sélection>>image:1756369740012-892.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
284
285
286 [[Sélectionner le fichier>>image:1756369814341-466.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
287
288
289 [[Lancer le transfert>>image:1756369899919-659.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
290
291
292 [[Fichier importé>>image:1756369953642-252.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
293
294 = Exécuter l'import =
295
296 == Lancer l'action ==
297
298 * **Sélectionnez** dans l’interface le fichier à importer.
299 * **Choisissez** la table de destination : //MUS_PHOTO (Photothèque)//.
300 * **Définissez** le type d’action : //Importer des notices avec ou sans images//.
301 * **Cliquez** sur //Lancer l’action.//
302
303 [[Lancer l'action>>image:1756370290084-939.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
304
305
306 (% class="box successmessage" %)
307 (((
308 Dans la zone **« Fichier à importer »**, vous pouvez visualiser directement le contenu du fichier .txt que vous avez chargé.
309 Cela permet de :
310
311 * vérifier que les colonnes attendues sont bien présentes,
312 * contrôler rapidement les valeurs (noms de fichiers, chemins, titres, photographe, dates…),
313 * détecter d’éventuelles erreurs avant de lancer l’import (ex. faute dans un numéro d’inventaire, format de date incorrect).
314
315 [[Visualisation du contenu du fichier>>image:1756370532581-706.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
316 )))
317
318 == Convertir le fichier texte tabulé en xml ==
319
320 La première étape de l’import consiste à **transformer le fichier texte tabulé (.txt) en fichier XML** compréhensible par Flora.
321
322 Pour cela :
323
324 1. Cliquez sur le bouton **« Conversion en XML »** (icône en forme d'engrenage).
325 1. Attendez la fin du traitement : le fichier XML est alors généré automatiquement à partir de votre fichier texte.
326
327 Dans la zone **Résultat de la conversion XML**, vous devez voir apparaître le chemin du fichier généré et la mention **« Opération terminée »**.
328 Cela confirme que la conversion s’est déroulée correctement et que vous pouvez passer à l’étape suivante.
329
330 [[Convertir en xml>>image:1744034532792-113.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
331
332
333 [[Résultat de la conversion>>image:1756370816186-619.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
334
335 == Importer en base de données ==
336
337 Une fois le fichier .xml généré sans erreur, vous pouvez passer à l’étape suivante : **l’import dans la base de données Flora.**
338
339 Concrètement, cette étape provoque :
340
341 * **la création des notices photothèque** dans la table MUS_PHOTO,
342 * **l’association automatique de chaque image à sa notice photo**.
343
344 Pour cela :
345
346 1. Cliquez sur le bouton **« Importer en base de données »** (icône en forme d'engrenage, comme pour la conversion).
347 1. Confirmez le lancement de la tâche.
348 1. Patientez : le temps de traitement dépend du nombre d’images et des données associées.
349 1. À la fin de l’opération, Flora confirme que les notices et les fichiers ont été créés dans la base.
350
351 (% class="box successmessage" %)
352 (((
353 **À vérifier dans le message de fin :**
354
355 * (((
356 Le système indique :
357
358 * **le nombre de photos créées** → correspond au nombre de lignes de votre fichier Excel (les notices photothèque),
359 * **le nombre de documents créés** → correspond aux fichiers images effectivement associés aux notices.
360 )))
361 * Ces deux nombres doivent être **identiques** pour confirmer que l’import a bien fonctionné.
362 * Si vous avez renseigné un **photographe qui n’existait pas encore dans Flora**, une notice //Personne// sera également créée automatiquement.
363 )))
364
365 [[Importer en base de données>>image:1756371324078-831.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
366
367 [[Confirmer le lancement de la tâche>>image:1744034587392-704.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
368
369 [[Vérification des notices créées>>image:1756371701144-272.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
370
371
372 (% class="box warningmessage" %)
373 (((
374 **Attention**
375
376 * Ne lancez pas l’étape suivante tant que l’import en base n’est pas **totalement terminé**.
377 * Vérifiez qu’aucune **erreur n’est affichée** dans la zone de résultat avant de poursuivre.
378 * Le temps de traitement peut être **long pour de gros volumes d’images** : prévoyez plusieurs minutes si vous importez plusieurs centaines de fichiers.(((
379 [[Vérification de l'absence d'erreurs>>image:1756371222612-384.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
380 )))
381 )))
382
383 == Lier les notices photos aux biens (option) ==
384
385 Après l’import en base de données, il est possible de demander à Flora de créer automatiquement les **liens entre les notices photos et les notices de biens**.
386 Cette étape est optionnelle : elle ne fonctionne que si vous avez renseigné le couple **Préfixe + Numéro d’inventaire** dans le fichier d’import.
387
388 Pour cela :
389
390 1. (((
391 Choisissez dans quel champ de la notice bien vous souhaitez que la photo soit affichée :
392
393 * **PHOTO_INV** → photo de consultation (s’affiche en premier dans l’onglet //Photos// de la notice bien).
394 * **PHOTO_DOC** → photo documentaire (après les photos de consultation).
395 * **PHOTO_AUTRE** → autre photo (accessible via un lien cliquable, mais non affichée dans l’onglet principal).
396 )))
397 1. (((
398 Définissez si vous souhaitez **forcer le lien en premier** :
399
400 * **Oui** → la photo importée s’ajoute **en première position**, même si des images étaient déjà liées au bien.
401 * **Non** → la photo importée est ajoutée après les images déjà existantes.
402 )))
403 1. Cliquez sur **Lier les notices **(icône en forme d'engrenage).
404 1. Confirmer le lancement de la tâche
405 1. À la fin de l’étape, Flora indique clairement si les notices photos ont bien été liées aux notices de biens.
406
407 (% class="box successmessage" %)
408 (((
409 **À vérifier dans le message de fin :**
410
411 * Le **nombre de notices photos traitées** doit correspondre au nombre de lignes de votre fichier d’import Excel.
412 * Le message doit indiquer que les **liens ont été générés avec succès**.
413 * Vérifiez qu’il n’y a **aucun message d’erreur** dans le résultat de l’opération.
414 )))
415
416 [[Choix du champ de lien>>image:1744034643830-367.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
417
418
419 [[Confirmer le lancement de la tâche>>image:1744034722560-114.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
420
421
422 [[Liens générés avec succès>>image:1756372430463-827.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
423
424 == Passer directement à la création des liens photos - biens ==
425
426 Dans certains cas, les **notices photos existent déjà dans Flora avec leurs images associées** (par exemple si elles ont été créées manuellement ou lors d’un import précédent).
427 Dans ce scénario, il n’est pas nécessaire d'effectuer la conversion du fichier en xml et d'importer en base de données.
428
429 Procédure :
430
431 1. Ouvrez le menu **Outils > Imports > Fichiers textes**.
432 1. Sélectionnez directement le fichier d’import .txt contenant les colonnes **Préfixe** et **Numéro d’inventaire** des biens.
433 1. Choisissez la table **MUS_PHOTO (Photothèque)**.
434 1. Dans le type d’action, sélectionnez **« Importer des nouvelles notices avec ou sans images » **et** lancer l'action.**
435 1. Cliquer sur **« Passer directement aux liens sur les biens ».**
436 1. (((
437 Choisissez dans quel champ de la notice bien vous souhaitez que la photo soit affichée :
438
439 * **PHOTO_INV** → photo de consultation (s’affiche en premier dans l’onglet //Photos// de la notice bien).
440 * **PHOTO_DOC** → photo documentaire (après les photos de consultation).
441 * **PHOTO_AUTRE** → autre photo (accessible via un lien cliquable, mais non affichée dans l’onglet principal).
442 )))
443 1. (((
444 Définissez si vous souhaitez **forcer le lien en premier** :
445
446 * **Oui** → la photo importée s’ajoute **en première position**, même si des images étaient déjà liées au bien.
447 * **Non** → la photo importée est ajoutée après les images déjà existantes.
448 )))
449 1. Cliquez sur **Lier les notices **(icône en forme d'engrenage).
450 1. Confirmer le lancement de la tâche
451 1. À la fin de l’étape, Flora indique clairement si les notices photos ont bien été liées aux notices de biens.
452
453 (% class="box successmessage" %)
454 (((
455 **À vérifier dans le message de fin :**
456
457 * Le **nombre de notices photos traitées** doit correspondre au nombre de lignes de votre fichier d’import Excel.
458 * Le message doit indiquer que les **liens ont été générés avec succès**.
459 * Vérifiez qu’il n’y a **aucun message d’erreur** dans le résultat de l’opération.
460 )))
461
462 [[Passer directement aux liens avec les biens>>image:1756374889100-712.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
463
464 = Erreurs courantes et solutions =
465
466 == Fichier non trouvé ==
467
468 * **Symptômes** : la notice photothèque est créée mais sans image.
469 * (((
470 **Causes possibles** :
471
472 * chemin d’accès incorrect dans le fichier d’import,
473 * photo absente du dossier temporaire du serveur,
474 * faute de frappe ou extension de fichier mal renseignée (.jpg au lieu de .jpeg).
475 )))
476 * (((
477 **Correction** :
478
479 * Vérifier que le fichier est bien présent dans le dossier d’import (import_prod ou import_test),
480 * Contrôler le chemin indiqué dans le fichier Excel,
481 * **Supprimer les notices photothèque sans photo** créées par erreur avant de relancer l’import (sinon Flora détectera un doublon),
482 * Relancer l’import après correction.
483 )))
484
485 [[Message d'erreur Fichier non trouvé>>image:1756372900925-771.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
486
487 == Doublon de notice ==
488
489 * **Symptômes** : Flora bloque l’import car la notice photo existe déjà.
490 * **Causes possibles** : la même image a déjà été importée auparavant.
491 * (((
492 **Correction** :
493
494 * Supprimer la notice en doublon si elle est inutile,
495 * Ou modifier le fichier d’import pour éviter de recharger la même image.
496 )))
497
498 [[Message d'erreur Doublon notice>>image:1756373051864-131.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
499
500 == Bien non trouvé ==
501
502 * **Symptômes** : la notice photo est créée, mais aucun lien n’est établi avec le bien.
503 * (((
504 **Causes possibles** :
505
506 * erreur dans le **préfixe** ou le **numéro d’inventaire** (faute de frappe, espace indésirable, format incorrect),
507 * bien inexistant dans Flora.
508 )))
509 * (((
510 **Correction** :
511
512 * Vérifier et corriger le couple //Préfixe + Numéro d’inventaire// dans le fichier Excel,
513 * S’assurer que le bien existe dans la base Flora,
514 * Relancer uniquement l’étape de **liaison photos ↔ biens**.
515 )))
516
517 [[Message d'erreur Bien non trouvé>>image:1756373128568-766.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
518
519 == Repérer les anomalies via la recherche experte ==
520
521 En cas d’anomalie, Flora propose d’utiliser une **recherche experte sur le champ “Code de transfert”** dans la photothèque.
522 Cela permet d’identifier rapidement les notices en erreur et de les corriger.
523
524 Procédure :
525
526 1. Ouvrez la **recherche experte** dans Flora.
527 1. Dans la table **Photothèque (MUS_PHOTO)**, ciblez le champ **Code de transfert**.
528 1. (((
529 Selon le type d’erreur rencontré, saisissez l’une des valeurs suivantes :
530
531 * (((
532 **lien bien non effectué car aucune image importée** → permet de retrouver toutes les notices photo créées **sans fichier image**.
533
534 * **Action** : supprimez ces notices avant de relancer l’import.
535 )))
536 * (((
537 **lien bien non effectué car notice bien inexistante** → permet de retrouver les notices photo dont le **bien n’existe pas** dans la base.
538
539 * **Action** : corrigez le couple //Préfixe + Numéro d’inventaire// dans le fichier d’import, ou créez la notice bien manquante, puis relancez l’étape de liaison.
540 )))
541 )))
542 1. Exécutez la recherche pour afficher la liste des notices en erreur.
543 1. Traitez les notices concernées selon le cas, puis relancez l’import ou uniquement l’étape de liaison photos ↔ biens.
544
545 [[Exemple de recherche pour repérer des anomalies>>image:1744036056886-415.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
546
547 == Consulter l'historique des logs ==
548
549 Flora enregistre un **historique détaillé des imports**.
550 Ces fichiers permettent de contrôler le déroulement des opérations et d’identifier les anomalies.
551
552 **Où les trouver ?**
553
554 * Rendez-vous dans **Outils > Imports > Logs d’import**.
555 * (((
556 Vous y trouverez plusieurs répertoires correspondant aux imports effectués :
557
558 * **MUS_PHOTO** → pour les imports de photos,
559 )))
560 * (((
561 Chaque import génère plusieurs fichiers de suivi, parmi lesquels :
562
563 * import.double.xml → liste des notices en **doublon**,
564 * import.err.xml → liste des **erreurs bloquantes**,
565 * import.list.xml → la **liste complète des notices traitées**,
566 * import.record.xml → le détail notice par notice,
567 * log_link_MUS_PHOTO → suivi spécifique des **liens créés entre photos et biens**.
568 )))
569
570 [[Exemple de consultation de l'historique des logs>>image:1744036750079-126.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
571
572 = Gérer le stockage et la sauvegarde des images originales =
573
574 Lors d’un import, les images sont d’abord déposées dans un **dossier temporaire du serveur Flora**.
575 Cependant, il faut garder en tête plusieurs points essentiels :
576
577 * **Flora recopie systématiquement** toutes les images dans son propre espace de stockage documentaire, afin de garantir la pérennité des liens et d’éviter toute perte de fichier.
578 * Il est possible de **conserver les fichiers originaux**, souvent issus de campagnes de numérisation, dans une arborescence interne dédiée.
579 * En pratique, il est recommandé, en accord avec votre service informatique, de donner au serveur Flora un **accès direct à ce partage de fichiers**, afin d’y prélever les images pour l’import. Cela évite le passage par un simple dossier temporaire et simplifie les opérations.
580
581 Les modèles tableur utilisés pour préparer les imports peuvent ainsi travailler directement sur les **chemins de cette arborescence partagée**, ce qui sécurise et fiabilise la procédure.
582
583 **Cas particulier des images Haute Définition**
584
585 * (((
586 Flora ne stocke que deux versions :
587
588 * une version **tuilée** de l’image originale pour la consultation fluide dans le navigateur,
589 * une version **JPEG de consultation**.
590 )))
591 * Les **fichiers originaux (TIFF)** doivent donc impérativement être conservés par le musée dans son arborescence partagée.
592 * Étant donné la taille de ces fichiers (plusieurs téraoctets pour des campagnes de numérisation), l’usage d’un **NAS** (serveur de stockage dédié à bas coût) est fortement recommandé pour archiver durablement les images.
593
594 = Mettre à jour des notices photos existantes =
595
596 Il peut arriver que des **notices photos existent déjà dans Flora** mais qu’elles ne soient pas liées à leurs images.
597 Dans ce cas, il est possible de **réinjecter uniquement les images manquantes** sans recréer de nouvelles notices.
598
599 (% class="box warningmessage" %)
600 (((
601 **Attention – réservé aux profils initiés**
602 Cette procédure est sensible :
603
604 * Une erreur peut entraîner une **perte de données en masse** (remplacement ou écrasement de notices).
605 * En cas d’erreur grave, il faudra procéder à une **restauration de la sauvegarde de la veille**, ce qui nécessite une **prestation spécifique** de la part de Flora Software.
606
607 Pour cette raison, ce type d’opération doit être réservé à des **utilisateurs expérimentés** et validé avec le service informatique.
608 )))
609
610 == Exporter les notices concernées ==
611
612 1. Faites un export **ETP** des notices photos à corriger avec tous les champs.
613 1. (((
614 L’export contient de nombreuses colonnes, mais seules 3 sont nécessaires :
615
616 * **Clé unique** → identifiant interne Flora,
617 * **Nom du fichier de consultation** → nom de l’image (ex. 2001-1-1.jpg),
618 * **Chemin d’accès du fichier de consultation** → chemin serveur de l’image.
619 )))
620
621 [[Effectuer un export ETP>>image:1758547923627-232.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
622
623 == Nettoyer le fichier exporté ==
624
625 1. Supprimez toutes les colonnes inutiles pour ne garder que les 3 champs cités ci-dessus.
626 1. Remplacez les intitulés de colonnes par leurs **noms informatiques exacts** (ceux attendus par Flora lors d’un import).
627 1. (((
628 **Enregistrer le fichier**(% style="background-color:transparent" %) fichier au format **texte tabulé (.txt)**.
629 )))
630
631 [[Exemple de fichier Excel nettoyé>>image:1758548202342-138.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
632
633
634 [[Exemple du fichier en format texte tabulé .txt>>image:1758548298831-672.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
635
636 == Lancer l’import en mode mise à jour ==
637
638 1. Suivez le **schéma classique d’import** (comme pour un import de photos normal).
639 1. À l’étape **Exécuter l’import**, choisissez l’action :
640 **« Mettre à jour des notices existantes (par unique_key) »**. Cela indique à Flora de retrouver chaque notice grâce à sa **Clé unique** et de compléter uniquement les image manquantes.
641
642 [[Choix de l'action Mettre à jour des notices existantes>>image:1758548402732-690.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
643 )))
644 )))|(% style="width:300px" %)(((
645 (% class="box" %)
646 (((
647 **Sommaire**
648
649 {{toc depth="2" numbered="true"/}}
650 )))
651
652 (% class="box" %)
653 (((
654 **Aller plus loin**
655
656 * [[Photothèque>>doc:1_Fonctionnalités.5\.C\. Saisie.Saisir dans les tables documentaires.Photothèque.WebHome]]
657 * [[Gérer les médias et les documents associés>>doc:1_Fonctionnalités.Gérer les médias et les documents associés.WebHome]]
658 * [[Gérer les fichiers photos>>doc:1_Fonctionnalités.Gérer les médias et les documents associés.C\. Visualiser.WebHome]]
659 )))
660
661 (% class="box" %)
662 (((
663 **Icônes principales**
664
665 * [[image:1756383752119-839.png||height="24" width="24"]] : Ajouter des fichiers
666
667
668
669 * [[image:1756383691673-996.png]] : Transférer des fichiers
670
671
672
673 * [[image:1756383516326-603.png||height="25" width="25"]] : Lancer l'action
674
675
676
677 * [[image:1756383597755-244.png]] : Lancer les différentes étapes de l'import
678
679
680
681 * [[image:1756383572809-499.png]] : Passer directement aux liens avec les biens
682 )))
683 )))