Aller au contenu
Modifié par Nicolas Schreiber le 2026/01/12 15:46
Depuis la version 12.1
modifié par Nicolas Schreiber
sur 2026/01/06 14:31
Commentaire de modification : Il n'y a aucun commentaire pour cette version
À la version 2.2
modifié par Nicolas Schreiber
sur 2025/07/23 10:47
Commentaire de modification : Update document after refactoring.

Résumé

Détails

Propriétés de la Page
Titre
... ... @@ -1,1 +1,1 @@
1 -Fonctions avancées : modification des exports tabulés paramétrables
1 +Fonctions avancées : paramétrage des exports tabulés paramétrables
Contenu
... ... @@ -2,10 +2,11 @@
2 2  {{toc/}}
3 3  {{/box}}
4 4  
5 +page en cours de construction
5 5  
6 6  = A savoir avant de commencer =
7 7  
8 -L'export de données muséologiques vers un tableur (format csv ou excel natif) met en évidence la particularité de leur organisation technique.
9 +L'export de données muséologiques vers un tableur met en évidence la particularité de leur organisation technique.
9 9  
10 10  Pour pouvoir répondre aux exigence scientifiques de leur description, il n'est pas possible d'utiliser des grilles de saisie de type tableur, avec juste des lignes et des colonnes, il faudrait un nombre inifini de colonnes.
11 11  
... ... @@ -539,7 +539,7 @@
539 539  
540 540   <field name='ETAT_MODIFIE_LE'  label='Réalisé le/> 
541 541   <field name='ETAT_MODIFIE_PAR'  label='Réalisé par/> 
542 -**<linked_field name='EMPLACEMENT' label='Emplacement théorique'>**
543 + **<linked_field name='EMPLACEMENT' label='Emplacement théorique'>**
543 543   <field name='LABEL_PARENT' label='Empl. référence hiéra' display='true'/>
544 544   </linked_field>
545 545  
... ... @@ -613,7 +613,8 @@
613 613  ** <linked_field name='BIEN' label='Bien'>
614 614  **~ <field name='DISPLAY' label='Bien' display='true'/>
615 615   </linked_field>
616 -\\</reference>**
617 +
618 +</reference>**
617 617  
618 618  **<reference source='musee' table='MUS_JOIN_COLIS_MOUV'**
619 619   groupDataType         = "subGroup"
... ... @@ -621,145 +621,68 @@
621 621   subGroupDataBefore    = ""
622 622   subGroupDataSeparator = ", "
623 623   subGroupDataAfter     = "" >
624 -**<linked_field name='MOUVEMENT_BIEN' label='Bien'>**
626 + **<linked_field name='MOUVEMENT_BIEN' label='Bien'>**
625 625   <field name='DISPLAY' label='Bien' display='true'/>
626 626   </linked_field>
627 627  </reference>
628 628  
629 629  
630 -= Exporter des images (uniquement en format de sortie excel natif) =
632 += Autres paramétrages =
631 631  
632 -== Première image uniquement ==
634 +== Conversions de dates et datations ==
633 633  
634 -Toutes les options de séparateurs, textes avant et aprés, fonctionnent. tous les cghampsd e IDOCS sont exportables
636 +**dataDateFormatDisplay**='yyyy-MM-dd'
635 635  
636 -C'est l'option **subGroupDataIndex **qui permet de choisir l'image à exporter (premiere, deuxieme, troisieme...)
638 +dataDateFormatDisplay='yyyy'
637 637  
638 -**Attention au choix de la résolution. **
639 -//résolution=LOW// (imagette) sera suffisant pour excel. Si vous prenez MEDIUM ou HIGH le poids du fichier excel risque d'etre éxagéréent conséquent, ce qui compliquera la manipulation du document final
640 -ne mettez pas une //dimImageXYInPixels// supérieurs à192, cela va ralentir le traitement et détérirore la qualité de l'imagette (192 est sa dimension par défaut dasn Flora)
640 +.....
641 641  
642 +//Cela fonctionne pour les champs dates, time et datation//
642 642  
643 -**<linked_records_document_records** name="PHOTO_INV"
644 - inputRecordFilter=""
645 - linkedRecordFilter=""
644 +time <field name='CREATE_DATE'  label='Saisi le' dataDateFormatDisplay='yyyy-MM-dd'/>
646 646  
647 - groupDataType=""
648 - documentTypes="Document-Photo"
649 - subGroupDataFilter="(IDOC_ACCESSIBILITY = 1)"
650 - subGroupDataMultMaxi=""
651 - **subGroupDataIndex="1">**
652 - <!~-~- champ de la table IDOCS ~-~->
653 - <field name="LABEL" label="Photo 1 : "/>
646 +date <field name='ETAT_MODIFIE_LE'  label='Etat modifié le ' dataDateFormatDisplay='yyyy-MM-dd'/>
654 654  
655 - <!~-~- Imagette ~-~->
656 - <photo_document_file name="_PHOTO_1"
657 - label="Photo 1"
658 - inputRecordFilter=""
659 - documentTypes="Document-Photo"
648 +datation <field name='DATATION_BIEN_DEBUT' dataDateFormatDisplay='yyyy' /> Pour l'instant les dates Avant Jésus-Christ ne sont pas mentionnées comme telmes quand on applique cette conversion
660 660  
661 -*
662 -** resolution="LOW"
663 - dimImageXYInPixels="192"**/>
664 - </linked_records_document_records>**
650 +(% class="box infomessage" %)
651 +(((
652 +Attention Excel applique ensuite ses propres automates de formatage à l'ouverture du fichier
653 +)))
665 665  
666 -== Plusieurs images ==
655 +== valeur par défaut ==
667 667  
668 -=== sur plusieurs colonnes ===
657 +**dataDefValue**="maValeurtextuelle"
669 669  
670 -Il est recommandé de positionner autant de colonnes que d'images à exporter, d'indiquer dans chque colonne le numéro de l'image (premiers, deuxieme, troisieme...) et de les positionner à la fin du tableau cara certaines colonnes seront forcéemnt vides
659 +si le field, linked_field, concat, group_feld est vide, c'est cette valeur qui sera exportée
671 671  
672 -Pour cela il suffit de dupliquer le bloc ci dessus et de choisir le bon **subGroupDataIndex="?" **dans chaque colonne
661 +//Exemple : utilisé dans l'export e-recolnat pour avoir par défaut la colonne langue = FR sans devoir la saisir dans toutes les notices. si le champ Langue de  notice est non vide il écrasera la dataDefValue//
673 673  
674 -Pour ne pas compliquer la lecture du fichier excel il est préférable de ne pas exporter le nom du fichier à chaque fois
663 +== Données textuelles ajoutées en multilangue ==
675 675  
676 -Exemple avec 4 images
665 +Flora gére des fichiers de mots clés pour la traduction des labels textuels dans les différentes languies (dans les fichiers *.properties)
677 677  
678 -<linked_records_document_records name="PHOTO_INV"
679 - documentTypes="Document-Photo"
680 - subGroupDataFilter="(IDOC_ACCESSIBILITY = 1)"
681 - **subGroupDataIndex="1"**>
667 +[[image:1698311785574-970.png||height="133" width="841"]]
682 682  
683 -**~
684 - **<photo_document_file name="**_PHOTO1**"
685 - label="**Photo1**"
686 - documentTypes="Document-Photo"
687 - resolution="LOW"
688 - dimImageXYInPixels="192"/>
689 - </linked_records_document_records>
669 +ces mots clés peuvent etre utilisés dans toutes les valeurs textuelles posées dans les tags
690 690  
691 -<linked_records_document_records name="PHOTO_INV"
692 - documentTypes="Document-Photo"
693 - subGroupDataFilter="(IDOC_ACCESSIBILITY = 1)"
694 - **subGroupDataIndex="2"**>
671 +//Exemple//
695 695  
696 -**~
697 - **<photo_document_file name="**_PHOTO2**"
698 - label="**Photo2**"
699 - documentTypes="Document-Photo"
700 - resolution="LOW"
701 - dimImageXYInPixels="192"/>
702 - </linked_records_document_records>
673 +<field name='TYPE_UE'  label='Type Unité d_enregistrement ' dataBefore='**${menu.label.inventory} **: '/>
703 703  
704 -<linked_records_document_records name="PHOTO_INV"
705 - documentTypes="Document-Photo"
706 - subGroupDataFilter="(IDOC_ACCESSIBILITY = 1)"
707 - **subGroupDataIndex="3"**>
675 +[[image:1698311964289-353.png||data-xwiki-image-style-alignment="center" class="img-thumbnail"]]
708 708  
709 -**~
710 - **<photo_document_file name="**_PHOTO3**"
711 - label="**Photo3**"
712 - documentTypes="Document-Photo"
713 - resolution="LOW"
714 - dimImageXYInPixels="192"/>
715 - </linked_records_document_records>
716 716  
717 -<linked_records_document_records name="PHOTO_INV"
718 - documentTypes="Document-Photo"
719 - subGroupDataFilter="(IDOC_ACCESSIBILITY = 1)"
720 - **subGroupDataIndex="4"**>
678 +== Export des liens ark vers les images ==
721 721  
722 -**~
723 - **<photo_document_file name="**_PHOTO4**"
724 - label="**Photo4**"
725 - documentTypes="Document-Photo"
726 - resolution="LOW"
727 - dimImageXYInPixels="192"/>
728 - </linked_records_document_records>
680 +Il est toujorus délicat d'incorporer les images en tant que telles dans une colonne excel ou calc car cela rend enuite le fichier difficile à manipuler, et dans le cas de calc elels ne suivent pas les tris réalisés sur le tableau ce qui rend les onnées incohérentes
729 729  
730 -=== sur plusieurs lignes ===
682 +de plus sur de gros volumes cela peut générer des fichiers de trop grande taille, surtout si on intégre les images originales au liue de se contenter des imagettes
731 731  
732 -Avec les options ci dessous déclarés dans un seul bloc
684 +Nous avons donc choisi de publier les images dans les tablmeurs vai des liens ark
733 733  
734 - <linked_records_document_records name="PHOTO_INV"
735 - documentTypes="Document-Photo"
736 - subGroupDataFilter="(IDOC_ACCESSIBILITY = 1)"
686 +la colonne devra donc etre paramétrée ainsi
737 737  
738 -*
739 -** subGroupDataMultMaxi="4"
740 - subGroupDataIndex="">
741 -
742 - **<photo_document_file name="_PHOTO"
743 - label="Photo"
744 - documentTypes="Document-Photo"
745 - resolution="LOW"
746 - dimImageXYInPixels="192"/>
747 - </linked_records_document_records>**
748 -
749 -Flora générera une seule colonne pour les images, et ajoutera ensuite autant de lignes (vides) que nécésssaire pour poistionner au maximum les 3 Images suivantes (total 4 images exportées=
750 -
751 -Cette disposition complique un peu la manipulation et la lecture des données dans excel à cause des lignes vides
752 -
753 -== (% id="cke_bm_1281128S" style="display:none" %) (%%)Export des liens ark vers les images ==
754 -
755 -Il est parfois délicat d'incorporer les images en tant que telles dans une colonne excel  car cela rend enuite le fichier difficile à manipule
756 -
757 -De plus sur de gros volumes cela peut générer des fichiers de trop grande taille, surtout si on intégre les images originales au liue de se contenter des imagettes
758 -
759 -Il st donc possible de publier les images via des liens ark
760 -
761 -la colonne devra  etre paramétrée ainsi
762 -
763 763  **name="PHOTO_INV" **=nom du champ contenant le lien vers la phototheque (si l'export concerne MUS_PHOTO on indiquera UNIQUE_KEY)
764 764  
765 765  **subGroupDataMultMaxi="1" **Nombre de notices photos lues**, **il est recommandé de ne mettre qu'un seul lien ark car de facto le lien sera automatiquemenrt clicable dans excel (aprés avoir cliqué dans la cellule)
... ... @@ -781,7 +781,8 @@
781 781   subGroupdataMultiValueSeparator="|"
782 782   subGroupDataMultMaxi="1"
783 783   >
784 -\\ <class_extractor
709 +
710 + <class_extractor
785 785   extractorClassName="com.ezida.services.musee.extractor.MusPhotoArkExtractor"
786 786   name="PHOTO_INV_ARK"
787 787   label=""
... ... @@ -798,73 +798,22 @@
798 798  
799 799  résultat obtenu.. avec un clic sur le lien ark exporté
800 800  
801 -[[image:1698400681257-169.png]]
727 +[[image:1698400681257-169.png||data-xwiki-image-style-alignment="center" class="img-thumbnail"]]
802 802  
803 803  
804 -= Autres paramétrages =
730 +Avec Excel vous pouvez utiliser ce lien ark pour intégrer l'image dans la cellule si vous le souhaitez, mais ce n'est pas automatique. le plus simple est de procéder par copie d'écran partielle
805 805  
806 -== Conversions de dates et datations ==
732 +* Touche Impr Ecran de votre ordinateur,
733 +* selection de la zone image à copier,
734 +* puis Edition/coller dans la cellule de votre choix
807 807  
808 -**dataDateFormatDisplay**='yyyy-MM-dd'
736 +SI aprés avoir appuyé sur Impr Ecran vous ne pouvez pas selectionner une zone à l'écran, utilisez un outil de capture. dans le présent arcticle nous avons utilisé le freeware Screenpresso
809 809  
810 -dataDateFormatDisplay='yyyy'
738 +//Note ! La ligne excel ne s'agrandit pas toute seule, à vous de le faire pour garder une bonne lisibilité. Dans Excel, si vous triez les lignes, les images ainsi collées vont suivre (mais pas dans calc de Libre office)//
811 811  
812 -.....
740 +[[image:1698401052018-622.png]]
813 813  
814 -//Cela fonctionne pour les champs dates, time et datation//
815 815  
816 -time <field name='CREATE_DATE'  label='Saisi le' dataDateFormatDisplay='yyyy-MM-dd'/>
817 817  
818 -date <field name='ETAT_MODIFIE_LE'  label='Etat modifié le ' dataDateFormatDisplay='yyyy-MM-dd'/>
819 819  
820 -datation <field name='DATATION_BIEN_DEBUT' dataDateFormatDisplay='yyyy' /> Pour l'instant les dates Avant Jésus-Christ ne sont pas mentionnées comme telmes quand on applique cette conversion
821 -
822 -(% class="box infomessage" %)
823 -(((
824 -Attention Excel applique ensuite ses propres automates de formatage à l'ouverture du fichier
825 -)))
826 -
827 -== valeur par défaut ==
828 -
829 -**dataDefValue**="maValeurtextuelle"
830 -
831 -si le field, linked_field, concat, group_feld est vide, c'est cette valeur qui sera exportée
832 -
833 -//Exemple : utilisé dans l'export e-recolnat pour avoir par défaut la colonne langue = FR sans devoir la saisir dans toutes les notices. si le champ Langue de  notice est non vide il écrasera la dataDefValue//
834 -
835 -== Données textuelles ajoutées en multilangue ==
836 -
837 -Flora gére des fichiers de mots clés pour la traduction des labels textuels dans les différentes languies (dans les fichiers *.properties)
838 -
839 -[[image:1698311785574-970.png||height="133" width="841"]]
840 -
841 -ces mots clés peuvent etre utilisés dans toutes les valeurs textuelles posées dans les tags
842 -
843 -//Exemple//
844 -
845 -<field name='TYPE_UE'  label='Type Unité d_enregistrement ' dataBefore='**${menu.label.inventory} **: '/>
846 -
847 -[[image:1698311964289-353.png||data-xwiki-image-style-alignment="center" class="img-thumbnail"]]
848 -
849 -
850 -
851 -== Conversion données d'un champ en majuscules ==
852 -
853 -<field name='TITRE'  label='Titre' dataIsToMajus="true"/>
854 -
855 -== Masquer un contenu de champ en fonction d'un menu (champs sensibles) ==
856 -
857 -ci dessous si le uiser n'a pas le menu musee_menu_masque_champs_sensibles il pourra voir le champ
858 -
859 -<field name='TITRE'  label='Titre' dataIsToMajus="true" inputRecordFilter="('{user.hasMenu.musee_menu_masque_champs_sensibles}' = 'false')"/>
860 -
861 -== Ajouter le label du champ dans le contenu exporté ==
862 -
863 -<field name='TITRE'  label='Titre' dataBefore='{fieldLabel} :  ' />
864 -
865 -== exporter Des infos de paramétrage de champ ==
866 -
867 -fieldInfoName pouura prendre les 3 options label, linkTable, linkSource
868 -
869 -<field_desc_info name="_collec_liee" fieldName="COLLEC_LIEE"
870 - fieldInfoName="linkTable"/>
745 +