Modifications pour le document Fonctions avancées : modification des exports tabulés paramétrables

Modifié par Nicolas Schreiber le 2026/01/12 15:46

Gérer
- Copier
Actions
- Exporter
- Aperçu avant impression
Affichage

From 16.1 to 17.1

Depuis la version 1.1

modifié par admin admin
sur 2025/04/16 12:28

Commentaire de modification : Imported from XAR

À la version 16.1

modifié par Nicolas Schreiber
sur 2026/01/12 15:12

Commentaire de modification : Il n'y a aucun commentaire pour cette version

Source
Rendu

Résumé

Propriétés de la Page (4 modifications, 0 ajouts, 0 suppressions)
Pièces jointes (0 modifications, 5 ajouts, 0 suppressions)

Détails

Propriétés de la Page

Titre

@@ -1,1 +1,1 @@
--Fonctions avancées : paramétrage des exports tabulés paramétrables
++Fonctions avancées : modification des exports tabulés paramétrables

Parent

@@ -1,1 +1,1 @@
--2_Administration.Menus Administration - Paramétrage.Modèles.WebHome
++2_Administration.Administration fonctionnelle.Gérer les modèles ETP.WebHome

Auteur du document

@@ -1,1 +1,1 @@
--XWiki.admin
++XWiki.NSR

Contenu

@@ -2,11 +2,10 @@
  {{toc/}}
  {{/box}}
--page en cours de construction
  = A savoir avant de commencer =
--L'export de données muséologiques vers un tableur met en évidence la particularité de leur organisation technique.
++L'export de données muséologiques vers un tableur (format csv ou excel natif) met en évidence la particularité de leur organisation technique.
  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.
@@ -82,8 +82,7 @@
  //Exemple ~://
--(% style="text-align:center" %)
--[[image:1698221408368-344.png||class="img-thumbnail"]]
++[[image:1698221408368-344.png||data-xwiki-image-style-alignment="center" class="img-thumbnail"]]
  La ligne ci dessous génèrera une colonne dont le titre sera égal au label et les contenus alimentés par le champs cité dans name
@@ -97,28 +97,23 @@
  * **name :** nom interne du champ dans la table Flora
  * **label : **intitulé qu'aura la colonne dans le fichier csv
--(% style="text-align:center" %)
--[[image:1698233535559-410.png||class="img-thumbnail"]]
++[[image:1698233535559-410.png||data-xwiki-image-style-alignment="center" class="img-thumbnail"]]
  === Champs texte libre multiligne (avec retours à la ligne) ===
--(% style="text-align:center" %)
--[[image:1698220705279-359.png||class="img-thumbnail"]]
++[[image:1698220705279-359.png||data-xwiki-image-style-alignment="center" class="img-thumbnail"]]
  **<field name='PRECISION_UE'  label='Précisions UE '/> **aura pour résultat
--(% style="text-align:center" %)
--[[image:1698220966238-507.png||class="img-thumbnail"]]
++[[image:1698220966238-507.png||data-xwiki-image-style-alignment="center" class="img-thumbnail"]]
  === Champs multivalués liés à des listes, thésaurus ou table d'autorité ===
--(% style="text-align:center" %)
--[[image:1698220773700-234.png||class="img-thumbnail"]]
++[[image:1698220773700-234.png||data-xwiki-image-style-alignment="center" class="img-thumbnail"]]
  **<field name='INTERPRETATION'  label='Interpretation'/> **aura pour résultat
--(% style="text-align:center" %)
--[[image:1698221043701-405.png||class="img-thumbnail"]]
++[[image:1698221043701-405.png||data-xwiki-image-style-alignment="center" class="img-thumbnail"]]
  (% class="box infomessage" %)
  (((
@@ -134,10 +134,9 @@
  * **dataMultiValueSeparator : **separateur de champ multivalue (Si non defini c'est celui qui est defini dans l'attribut   multiValueSeparator du tag 'table', ou si non defini c'est '/' slash par defaut)
  * **dataAfter : **separateur apres la donnee du champ répété en cas de multivaluation   (Chaine vide si non defini)
--**Exemple : <field name='INTERPRETATION'  label='Interpretation'  dataBefore="texte avant " dataAfter=" texte aprés" dataMultiValueSeparator=" ; "/>**
++**Exemple : <field name='INTERPRETATION'  label='Interpretation'  dataBefore="texte avant : " dataAfter=" (texte aprés)" dataMultiValueSeparator=" ; "/>**
--(% style="text-align:center" %)
--[[image:1698221647528-156.png||class="img-thumbnail"]]
++[[image:1698221647528-156.png||data-xwiki-image-style-alignment="center" class="img-thumbnail"]]
  (% class="box infomessage" %)
  (((
@@ -146,8 +146,7 @@
  **<field name='INTERPRETATION'  label='Interpretation'  dataBefore="texte avant : " dataAfter=" (texte aprés)" dataMultiValueSeparator="\n"/>**
--(% style="text-align:center" %)
--[[image:1698221798735-336.png||class="img-thumbnail"]]
++[[image:1698221798735-336.png||data-xwiki-image-style-alignment="center" class="img-thumbnail"]]
  == Exporter une valeur constante ==
@@ -155,8 +155,7 @@
  **<constant name="C1" label="Constante1"  dataDefValue="myConstante1" />**
--(% style="text-align:center" %)
--[[image:1698229509017-535.png||class="img-thumbnail"]]
++[[image:1698229509017-535.png||data-xwiki-image-style-alignment="center" class="img-thumbnail"]]
  == Exporter un ou plusieurs champs d'une table d'autorité liée ==
@@ -211,8 +211,7 @@
  **Question : **pourquoi y a t'il parfois des virgule et des points virgules entre chaque valeur de la colonne Type opération.. d'ou viennent ces points virgules ?
  **Réponse : **en fait L**e champ Opération(s) dans la table Stratigraphie n'est pas multivalué mais il est positionné dans un bloc répétable**
--(% style="text-align:center" %)
--[[image:1698226080684-439.png||height="478" width="1071"]]
++[[image:1698226080684-439.png||data-xwiki-image-style-alignment="center" height="478" width="1071"]]
  **Rappel : **
  Dans les paramétrages généraux du fichier etp on a défini **compressChar=" ; " **//caracteres utilisés lors de concaténation automatiques de données dans des blocs répétables. c'est donc lui qui est utilisé dans le cas présent . les points virgules marquent donc les séparations de blocs répétables//
@@ -219,8 +219,7 @@
  Et on a aussi défini **multiValueSeparator=', ' **//caracteres utiliser pour concaténer les données des champs multivaluées virgule+espace c'est donc lui qui est utilisé dans le cas présent pour lexport du champ TYpe Opération de la table Opération..champ qui est multivaléu dans ladite table//
--(% style="text-align:center" %)
--[[image:1698226465622-838.png||height="285" width="966"]]
++[[image:1698226465622-838.png||data-xwiki-image-style-alignment="center" height="285" width="966"]]
  Cet exemple illustre la complexité de manipulation des données muséologique car les blocs répétables et champs multivalués y sont légion
@@ -233,8 +233,7 @@
  //Exemple : concaténer tous les champs de Données intrinsèque d'une notice Stratigraphie dans une seule colonne//
--(% style="text-align:center" %)
--[[image:1698234060502-846.png]]
++[[image:1698234060502-846.png||data-xwiki-image-style-alignment="center"]]
  De facto il sera judicieux
@@ -241,6 +241,8 @@
  * de ne pas perdre les libellés de champs (on les indiquera dans **dataBefore**)
  * de n'avoir des séparateurs de champs que si un au moins des champs précédents est non vide...sinon le contenu de la colonne commencera par un séparateur (on les indiquera dans **dataJoinSeparator**)
++La concat peut etre vue comme une "variable" que l'on va pouboir utiliser à sa guise
++
  == A minima ==
  on va donc créer une "boite" qui va assembler les données de la colonne en concaténant les champs cités
@@ -258,7 +258,7 @@
  == Ajout de données avant - aprés ==
--Cette "boite" concat est vue comme un "groupe" de données. a ce titre il est possible de lui adjoindre les paramétres suivants
++Cette "boite" concat est vue comme un "groupe" de données. a ce titre il est possible de lui adjoindre les paramètres suivants
  * **groupDataBefore **: donnee avant le groupe
  * **groupDataAfter **: donnee apres le groupe
@@ -277,11 +277,11 @@
     <field name='DESCRIPTION_INTRINSEQUE'  dataJoinSeparator="\n"/>
  **</concat>**
--//A noter les \n qui se transforment en retour à la ligne dans la colonne et le datajoinSeparator qui poermet de choisir si on veut un point virgule ou un retour ligne entre chaque champs//
++//A noter les \n qui se transforment en retour à la ligne dans la colonne et le datajoinSeparator qui permet de choisir si on veut un point virgule ou un retour ligne entre chaque champs//
  [[image:1698235351939-869.png]]
--== Ajout de données par défaut entre les champs du groupe ==
++== Ajout de données par défaut entre les champs de la concat ==
  Dans l'exemple ci-aprés, on a positionnés les séparateurs de champs dans chacun des champs avec le DataJoinSeparator
@@ -310,7 +310,8 @@
  (% class="box infomessage" %)
  (((
--les notions de subGroupDataBefore et subGroupDataAfter peuvent aussi etre paramétrées mais n'ont pas grand intéret dans les concat, elles seront plutôt utilisées dans le cas des blocs répétables
++Les notions de subGroupDataBefore et subGroupDataAfter peuvent aussi etre paramétrées mais n'ont pas grand intéret dans les concat, elles seront plutôt utilisées dans le cas des blocs répétables.
++Les concat ont donc un comportement trés similiare aux groupes de groupDataType = "group", à la différence qu'on peut y mettre n'importe quel champ dedans
  )))
  = Export des champs d'un bloc répétable =
@@ -319,21 +319,40 @@
  Globalement il ressemblera beaucoup à un concat, à la différence prés qu'un concat ne se joue qu'une seule fois, alors que le bloc de champs se jouera dans l'export autant de fois qu'il y a de groupe saisis dans la notice courante
--(% class="box infomessage" %)
--(((
  On peut se representer cela comme une boucle d'éxécution qui tournera tant qu'il existe encore un bloc répété à exporter
--)))
  //Exemple avec un bloc de champ répétable contenant 3 champs avec une saisie lacunaire (il est rare que tous les champs soient remplis dans un bloc)//
--(% style="text-align:center" %)
--[[image:1698249410427-526.png||class="img-thumbnail"]]
++[[image:1768226297481-108.png]]
--le paramétrage de l'export sera défini tel que :
++== groupDataType~=group ==
++On va boucler sur les blocs répétables en concaténant les champs qu'il contient, et chaque bloc sera concaténé au précédent (avec groupDataSubgroupSeparator). chaque "bloc" est vu comme un subGroup.
++
++Dans le cas des groupDataType=group, les subGroup sont regroupés dans une seule "variable"
++
++il sera possible de définir les data de concaténation ci dessous
++
++         **groupDataBefore**=" données en début de groupe"
++
++*
++** subGroupDataBefore **= "données en début de chaque sous-group"
++                     **subGroupDataSeparator **     = "données entre chaque champ du sous-groupe"**
++** subGroupDataAfter** = "\données à la fin de chaque sous-groupe"
++\\         **groupDataSubGroupSeparator**=" donnée insérée entre chaque subgroup"**
++
++         **groupDataAfter**="données en fin de groupe
++
++Cela permet donc un formatage plus fin car ion eput agir à tous les niveaux de la concatenation, notemment le **groupDataSubGroupSeparator **qui permet de gérér les séparateur entre les sous-groupes
++\\rappel : un sous-groupe correspond dans le MCD, un bloc répétable est un bloc type="set" posé dans un bloc type="selection"
++
++[[image:1768223007353-115.png]]
++
++Exemple avec juste deux retours lignes entre chaque sous-groupe
++
  **~ <group_field name="INTERVENANT"
           groupDataType              = "group"
--         label                      = "Intervenants"
++         label                      = "Intervenants-group"
           groupDataSubGroupSeparator = "\n\n"
  \\>  **
@@ -344,8 +344,7 @@
  et génerera la colonne ci dessous
--(% style="text-align:center" %)
--[[image:1698249964685-586.png||class="img-thumbnail"]]
++[[image:1768226409578-347.png||class="img-thumbnail"]]
  (% class="box infomessage" %)
  (((
@@ -360,11 +360,22 @@
  Un sous-groupe est un ensemble de champs qui appartiennent a la même entite :  au meme bloc de champs (type=set), a la même notice liée ou a la même notice qui référence la notice courante
  )))
--Il est possible de choisir un** type= "sous groupe"**
++== groupDataType~=subGroup ==
++le fonctionnement est différent, car il n'y a pas "une seule variable" concaténant tous les sous-groupes, mais autant de "sous-variables" que de blocs. On ne peut donc poser que les séparateurs suivants
++
++**subGroupDataBefore **= "données en début de chaque sous-group"
++     **subGroupDataSeparator **     = "données entre chaque champ du sous-groupe"
++**subGroupDataAfter** = "\données à la fin de chaque sous-groupe"
++
++Chaque sous-groupe sera ensuite "posé" dans la colonne avec le compressChar=" ; " définit dans l'entête du format
++
   <group_field name="INTERVENANT"
--**groupDataType   **           = **"SubGroup"**
--         label                      = "Intervenants"
++**~         groupDataType   **           = **"subGroup"**
++         label                      = "Intervenants - uibgroup"
++
++         subGroupDataBefore = "intervenant : "
++         subGroupDataAfter = "\n"
  ~>
      <field name='PERSONNE_INTERVENANT'  label='Intervenant'/>
@@ -372,16 +372,29 @@
      <field name='PRECISION_INTERVENANT'  label='Précisions intervenant ' dataJoinSeparator="\n"/>
  </group_field>
--(% class="wikigeneratedid" %)
--Dans ce cas chaque élément du groupe générera sa propre colonne, donc ce n'est pas trés différent d'avoir positionné ces 3 champs directement dans le template etp, sans tenir compte du group_field, ou bien directement dans un concat, mais avec la contrainte de ne pouvoir y inclure que des champs du bloc répétable courant
++[[image:1768226447728-811.png||class="img-thumbnail"]]
--A noter que pour les type=SUbGroup le label du group_field est ignoré et que ce sont les labels de chaque élément qui sont pris en compte dans les intitulé de colonne
++le groupDataType="subgroup" est donc peu utilisé, sauf dans les exports au format xml car ils permettent de conserver la répétabilité des blocs, et donc de répéter les noeux dans le format xml de sortie
--(% style="text-align:center" %)
--[[image:1698308536947-443.png||class="img-thumbnail"]]
++= sans groupDataType =
++SI on ne précise pas de groupDataType le moteur les considère comme ue arbre xml complet avec un noeud pour chaque sous-groupe et un noeud pour chaque champ. ça ne peut pas vraiment se matérialiser dans un export colonné, donc dans ce cas les données sont exportées "champ" par "champ", chaque champ étant regroupé dans une colonne avec le compressChar=" ; " définit dans l'entête du format.
++De facto on perd la lisibilité du bloc
++<group_field name="INTERVENANT"
++         label                      = "Intervenants - sans groupDataType"
++~>
++
++    <field name='PERSONNE_INTERVENANT'  />
++    <field name='FONCTION_INTERVENANT'   dataBefore=" (" dataAfter=")"/>
++    <field name='PRECISION_INTERVENANT'  dataJoinSeparator="\n"/>
++</group_field>
++
++[[image:1768227008672-422.png]]
++
++les groupes sans groupDAtaTYpe seront essentiellement utilisés dans les exports OAI:LIDO pour ocnserver les imbrications de champs et blocs dans le format xml de sortie
++
  == Paramétrages complémentaires pour les blocs répétables ==
  il est possible d'inclure aussi dans un group_field
@@ -421,8 +421,7 @@
          <field name='PRECISION_INTERVENANT'  label='Précisions intervenant ' dataJoinSeparator="\n"/>
  </group_field>
--(% style="text-align:center" %)
--[[image:1698310122900-966.png||class="img-thumbnail"]]
++[[image:1698310122900-966.png||data-xwiki-image-style-alignment="center" class="img-thumbnail"]]
  == Filtre sur les données du groupe ==
@@ -453,8 +453,7 @@
  Seul le bloc n° 2 est exporté
--(% style="text-align:center" %)
--[[image:1698310843667-475.png||class="img-thumbnail"]]
++[[image:1698310843667-475.png||data-xwiki-image-style-alignment="center" class="img-thumbnail"]]
  === Masquer des champs dans un sous-groupe ===
@@ -477,8 +477,7 @@
  dans le lLoc n° 2  le cchamp PRECISIONS_INTERVENANT n'est pas exporté
--(% style="text-align:center" %)
--[[image:1698311103593-686.png||class="img-thumbnail"]]
++[[image:1698311103593-686.png||data-xwiki-image-style-alignment="center" class="img-thumbnail"]]
  === Limiter le nombre de sous-groupe exportés ===
@@ -523,8 +523,7 @@
      <field name='ELEMENT_PRECISION'  dataJoinSeparator="\n" />
   </group_field>
--(% style="text-align:center" %)
--[[image:1719328382500-862.png||class="img-thumbnail"]]
++[[image:1719328382500-862.png||data-xwiki-image-style-alignment="center" class="img-thumbnail"]]
  = Export des via des liens par héritage (référence) =
@@ -546,8 +546,7 @@
  <?xml version="1.0" encoding="ISO-8859-1"?>
  <export-conf>
   <table name="MUS_BIEN" charset="ISO-8859-1" separator="\t"** compressChar="\n" **newLine="\r\n" multiValueSeparator=', ' valueDelimiter='"'>
--
--<field name='UNIQUE_KEY'  label='Unique Key'/>
++\\<field name='UNIQUE_KEY'  label='Unique Key'/>
  <field name='MUSEE'  label='Préfixe'/>
  <field name='NUM_INVENTAIRE'  label='Numéro D'inventaire'/>
@@ -560,7 +560,7 @@
        <field name='ETAT_MODIFIE_LE'  label='Réalisé le/>
        <field name='ETAT_MODIFIE_PAR'  label='Réalisé par/>
--  **<linked_field name='EMPLACEMENT' label='Emplacement théorique'>**
++**<linked_field name='EMPLACEMENT' label='Emplacement théorique'>**
                <field name='LABEL_PARENT' label='Empl. référence hiéra' display='true'/>
           </linked_field>
@@ -590,8 +590,7 @@
           <field name='210a' label='712a-Nom' display='true'/>
           <field name='210b' label='712a-Subdivision' display='true'/>
        </linked_field>
--
--      <reference source='system' table='ICOMM_ITEM'
++\\      <reference source='system' table='ICOMM_ITEM'
           groupDataType         = "subGroup"
           label                 = "Exemplaires"
           subGroupDataBefore    = "{ "
@@ -613,8 +613,7 @@
  <?xml version="1.0" encoding="ISO-8859-1"?>
  <export-conf>
   <table name="MUS_COLIS" charset="ISO-8859-1" separator="\t" **compressChar="\n"** newLine="\r\n" multiValueSeparator=', ' valueDelimiter='"'>
--
--<field name='ETAT_MODIFIE_LE'  label='Etat modifié le'/>
++\\<field name='ETAT_MODIFIE_LE'  label='Etat modifié le'/>
  <field name='ETAT_AVANCE_COLIS'  label='Etat d_avancement'/>
  <field name='UNIQUE_KEY'  label='Numéro de Code'/>
@@ -632,12 +632,11 @@
           subGroupDataSeparator = ", "
           subGroupDataAfter     = "" >
--*
++*
  ** <linked_field name='BIEN' label='Bien'>
  **~            <field name='DISPLAY' label='Bien' display='true'/>
           </linked_field>
--
--</reference>**
++\\</reference>**
  **<reference source='musee' table='MUS_JOIN_COLIS_MOUV'**
           groupDataType         = "subGroup"
@@ -645,69 +645,144 @@
           subGroupDataBefore    = ""
           subGroupDataSeparator = ", "
           subGroupDataAfter     = "" >
--     **<linked_field name='MOUVEMENT_BIEN' label='Bien'>**
++**<linked_field name='MOUVEMENT_BIEN' label='Bien'>**
              <field name='DISPLAY' label='Bien' display='true'/>
           </linked_field>
  </reference>
--= Autres paramétrages =
++= Exporter des images (uniquement en format de sortie excel natif) =
--== Conversions de dates et datations ==
++== Première image uniquement ==
--**dataDateFormatDisplay**='yyyy-MM-dd'
++Toutes les options de séparateurs, textes avant et aprés, fonctionnent. tous les cghampsd e IDOCS sont exportables
--dataDateFormatDisplay='yyyy'
++C'est l'option **subGroupDataIndex **qui permet de choisir l'image à exporter (premiere, deuxieme, troisieme...)
--.....
++**Attention au choix de la résolution. **
++//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
++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)
--//Cela fonctionne pour les champs dates, time et datation//
--time <field name='CREATE_DATE'  label='Saisi le' dataDateFormatDisplay='yyyy-MM-dd'/>
++**<linked_records_document_records** name="PHOTO_INV"
++                                         inputRecordFilter=""
++                                         linkedRecordFilter=""
--date <field name='ETAT_MODIFIE_LE'  label='Etat modifié le ' dataDateFormatDisplay='yyyy-MM-dd'/>
++                                         groupDataType=""
++                                         documentTypes="Document-Photo"
++                                         subGroupDataFilter="(IDOC_ACCESSIBILITY = 1)"
++                                         subGroupDataMultMaxi=""
++                            **subGroupDataIndex="1">**
++            <!~-~- champ de la table IDOCS ~-~->
++            <field name="LABEL" label="Photo 1 : "/>
--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
++            <!~-~- Imagette ~-~->
++            <photo_document_file name="_PHOTO_1"
++                                 label="Photo 1"
++                                 inputRecordFilter=""
++                                 documentTypes="Document-Photo"
--(% class="box infomessage" %)
--(((
--Attention Excel applique ensuite ses propres automates de formatage à l'ouverture du fichier
--)))
++*
++** resolution="LOW"
++                                 dimImageXYInPixels="192"**/>
++ </linked_records_document_records>**
--== valeur par défaut ==
++== Plusieurs images ==
--**dataDefValue**="maValeurtextuelle"
++=== sur plusieurs colonnes ===
--si le field, linked_field, concat, group_feld est vide, c'est cette valeur qui sera exportée
++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
--//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//
++Pour cela il suffit de dupliquer le bloc ci dessus et de choisir le bon **subGroupDataIndex="?" **dans chaque colonne
--== Données textuelles ajoutées en multilangue ==
++Pour ne pas compliquer la lecture du fichier excel il est préférable de ne pas exporter le nom du fichier à chaque fois
--Flora gére des fichiers de mots clés pour la traduction des labels textuels dans les différentes languies (dans les fichiers *.properties)
++Exemple avec 4 images
--[[image:1698311785574-970.png||height="133" width="841"]]
++<linked_records_document_records name="PHOTO_INV"
++                                         documentTypes="Document-Photo"
++                                         subGroupDataFilter="(IDOC_ACCESSIBILITY = 1)"
++                             **subGroupDataIndex="1"**>
--ces mots clés peuvent etre utilisés dans toutes les valeurs textuelles posées dans les tags
++**~
++            **<photo_document_file name="**_PHOTO1**"
++                                 label="**Photo1**"
++                                 documentTypes="Document-Photo"
++                                 resolution="LOW"
++                                 dimImageXYInPixels="192"/>
++ </linked_records_document_records>
--//Exemple//
++<linked_records_document_records name="PHOTO_INV"
++                                         documentTypes="Document-Photo"
++                                         subGroupDataFilter="(IDOC_ACCESSIBILITY = 1)"
++                             **subGroupDataIndex="2"**>
--<field name='TYPE_UE'  label='Type Unité d_enregistrement ' dataBefore='**${menu.label.inventory} **: '/>
++**~
++            **<photo_document_file name="**_PHOTO2**"
++                                 label="**Photo2**"
++                                 documentTypes="Document-Photo"
++                                 resolution="LOW"
++                                 dimImageXYInPixels="192"/>
++ </linked_records_document_records>
--(% style="text-align:center" %)
--[[image:1698311964289-353.png||class="img-thumbnail"]]
++<linked_records_document_records name="PHOTO_INV"
++                                         documentTypes="Document-Photo"
++                                         subGroupDataFilter="(IDOC_ACCESSIBILITY = 1)"
++                             **subGroupDataIndex="3"**>
++**~
++            **<photo_document_file name="**_PHOTO3**"
++                                 label="**Photo3**"
++                                 documentTypes="Document-Photo"
++                                 resolution="LOW"
++                                 dimImageXYInPixels="192"/>
++ </linked_records_document_records>
--== Export des liens ark vers les images ==
++<linked_records_document_records name="PHOTO_INV"
++                                         documentTypes="Document-Photo"
++                                         subGroupDataFilter="(IDOC_ACCESSIBILITY = 1)"
++                             **subGroupDataIndex="4"**>
--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
++**~
++            **<photo_document_file name="**_PHOTO4**"
++                                 label="**Photo4**"
++                                 documentTypes="Document-Photo"
++                                 resolution="LOW"
++                                 dimImageXYInPixels="192"/>
++ </linked_records_document_records>
--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
++=== sur plusieurs lignes ===
--Nous avons donc choisi de publier les images dans les tablmeurs vai des liens ark
++Avec les options ci dessous déclarés dans un seul bloc
--la colonne devra donc etre paramétrée ainsi
++ <linked_records_document_records name="PHOTO_INV"
++                                         documentTypes="Document-Photo"
++                                         subGroupDataFilter="(IDOC_ACCESSIBILITY = 1)"
++*
++**    subGroupDataMultMaxi="4"
++                                         subGroupDataIndex="">
++\\ **<photo_document_file name="_PHOTO"
++                                 label="Photo"
++                                 documentTypes="Document-Photo"
++                                 resolution="LOW"
++                                 dimImageXYInPixels="192"/>
++ </linked_records_document_records>**
++
++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=
++
++Cette disposition complique un peu la manipulation et la lecture des données dans excel à cause des lignes vides
++
++== (% id="cke_bm_1281128S" style="display:none" %) (%%)Export des liens ark vers les images ==
++
++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
++
++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
++
++Il st donc possible de publier les images via des liens ark
++
++la colonne devra  etre paramétrée ainsi
++
  **name="PHOTO_INV" **=nom du champ contenant le lien vers la phototheque (si l'export concerne MUS_PHOTO on indiquera UNIQUE_KEY)
  **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)
@@ -729,8 +729,7 @@
                subGroupdataMultiValueSeparator="|"
                subGroupDataMultMaxi="1"
               >
--
--    <class_extractor
++\\    <class_extractor
              extractorClassName="com.ezida.services.musee.extractor.MusPhotoArkExtractor"
              name="PHOTO_INV_ARK"
              label=""
@@ -747,23 +747,73 @@
  résultat obtenu.. avec un clic sur le lien ark exporté
--(% style="text-align:center" %)
--[[image:1698400681257-169.png||class="img-thumbnail"]]
++[[image:1698400681257-169.png]]
--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
++= Autres paramétrages =
--* Touche Impr Ecran de votre ordinateur,
--* selection de la zone image à copier,
--* puis Edition/coller dans la cellule de votre choix
++== Conversions de dates et datations ==
--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
++**dataDateFormatDisplay**='yyyy-MM-dd'
--//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)//
++dataDateFormatDisplay='yyyy'
--[[image:1698401052018-622.png]]
++.....
++//Cela fonctionne pour les champs dates, time et datation//
++time <field name='CREATE_DATE'  label='Saisi le' dataDateFormatDisplay='yyyy-MM-dd'/>
++date <field name='ETAT_MODIFIE_LE'  label='Etat modifié le ' dataDateFormatDisplay='yyyy-MM-dd'/>
--
++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
++
++(% class="box infomessage" %)
++(((
++Attention Excel applique ensuite ses propres automates de formatage à l'ouverture du fichier
++)))
++
++== valeur par défaut ==
++
++**dataDefValue**="maValeurtextuelle"
++
++si le field, linked_field, concat, group_feld est vide, c'est cette valeur qui sera exportée
++
++//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//
++
++== Données textuelles ajoutées en multilangue ==
++
++Flora gére des fichiers de mots clés pour la traduction des labels textuels dans les différentes languies (dans les fichiers *.properties)
++
++[[image:1698311785574-970.png||height="133" width="841"]]
++
++ces mots clés peuvent etre utilisés dans toutes les valeurs textuelles posées dans les tags
++
++//Exemple//
++
++<field name='TYPE_UE'  label='Type Unité d_enregistrement ' dataBefore='**${menu.label.inventory} **: '/>
++
++[[image:1698311964289-353.png||data-xwiki-image-style-alignment="center" class="img-thumbnail"]]
++
++
++
++== Conversion données d'un champ en majuscules ==
++
++<field name='TITRE'  label='Titre' dataIsToMajus="true"/>
++
++== Masquer un contenu de champ en fonction d'un menu (champs sensibles) ==
++
++ci dessous si le uiser n'a pas le menu musee_menu_masque_champs_sensibles il pourra voir le champ
++
++<field name='TITRE'  label='Titre' dataIsToMajus="true" inputRecordFilter="('{user.hasMenu.musee_menu_masque_champs_sensibles}' = 'false')"/>
++
++== Ajouter le label du champ dans le contenu exporté ==
++
++<field name='TITRE'  label='Titre' dataBefore='{fieldLabel} :  ' />
++
++== Exporter des infos de paramétrage de champ ==
++
++fieldInfoName pouura prendre les 3 options label, linkTable, linkSource
++
++<field_desc_info name="_collec_liee" fieldName="COLLEC_LIEE"
++                    fieldInfoName="linkTable"/>

1768223007353-115.png

Auteur

...	...	@@ -1,0 +1,1 @@
	1	+XWiki.NSR

Taille

...	...	@@ -1,0 +1,1 @@
	1	+300.9 KB

Contenu

1768226297481-108.png

Auteur

...	...	@@ -1,0 +1,1 @@
	1	+XWiki.NSR

Taille

...	...	@@ -1,0 +1,1 @@
	1	+47.9 KB

Contenu

1768226409578-347.png

Auteur

...	...	@@ -1,0 +1,1 @@
	1	+XWiki.NSR

Taille

...	...	@@ -1,0 +1,1 @@
	1	+9.9 KB

Contenu

1768226447728-811.png

Auteur

...	...	@@ -1,0 +1,1 @@
	1	+XWiki.NSR

Taille

...	...	@@ -1,0 +1,1 @@
	1	+11.6 KB

Contenu

1768227008672-422.png

Auteur

...	...	@@ -1,0 +1,1 @@
	1	+XWiki.NSR

Taille

...	...	@@ -1,0 +1,1 @@
	1	+14.0 KB

Contenu

Modifications pour le document Fonctions avancées : modification des exports tabulés paramétrables

Résumé

Détails

Rechercher

Navigation