Fonctions avancées : modification des exports tabulés paramétrables

= A savoir avant de commencer =

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

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

12

Les grilles de saisie dans Flora,s'appuient donc sur deux notions extrèmement puissantes : **les blocs répétables et les champs multivalués**

13

14

== //Comprendre les blocs répétables et les champs multivalués// ==

15

16

Ces deux notions sont fondamentales en informatique muséologique. Elles permettent de s'affranchir des limites techniques imposées par les bases de données traditionnelles (tables de jointures).

17

Historiquement on appelait cela des bases de données XML, aujourd'hui (entre informaticiens) on parlerait plutôt de NoSql

18

19

Ces notions sont fonctionnellement très puissantes en saisie, mais elles imposent quelques rêgles** quand on veut remettre les données "à plat"** pour des affichages, des impressions, des exports.

20

21

(% class="box infomessage" %)

22

(((

23

Ces rêgles peuvent paraitre "exotiques" quand on a l'habitude de manipuler un tableur ou une base de donnée SQL. Cet article wiki a donc pour but d'expliciter tout ce qui peut etre exploité pour une **"remise à plat sans perte de sens" **de données muséologiques dans un tableur en lignes / colonnes

)))

//Exemple ~://

[[image:1698219762510-708.png]]

29

30

31

(% class="wikigeneratedid" %)

32

__**Dans un export CSV pour excel ou calc,:**__

33

34

* Par défaut **les champs multivaluées seront concaténés avec un séparateur virgule+espace entre chaque valeur.**.. donc ça marche tout seul

35

** Exemple : si je demande à exporter juste le champ Auteuir-Exécutant, dans une colonne je récupererai les 4 auteurs ci dessus, séparés par virgule+espace, mais sans savoir de quel "type" ils dépendent

36

* Par contre, pour les blocs répétables, comme il n'est pas possible de générer un nombre de colonnes variables dans l'export, en général **on concaténera les champs d'un même blocs, puis les différentes occurences d'un même bloc dans une seule et unique Colonne**

37

** Exemple : si je demande à exporter Le bloc "Création-exécution" dans une colonne ,je devrai paramétrer le mode de concaténation des différents champs qu'il contient, aisni que le mode de concaténation de chaque occurence de bloc. de facto j'aurai besoin de pouvoir paramétrer des séparateurs, ajouter des libellés de champs....bref "formater" la conaténation des blocs

38

39

= Paramètres généraux d'un modele etp =

40

41

dans l'entête du fichier etp les paramétres suivants pourront etre défini

**<table**

**name="MUS_STRATIGRAPHIE"**

46

//nom interne de la table à exporter//

47

48

**charset="ISO-8859-1" **

49

//jeu de caractere du fichier résultat

50

Attention, il est préférable de conserver ce paramétre car les publications réalisées sont ensuiote déclarées avec un type mime et une extension CSV, de manière a étre ouvertes automatiquement dans Excel par un double clic sur le nom de fichier//

51

52

**separator="\t"**

53

//Le séparateur tabulation est préférable car il est certain qu'il n'a pas été saisi dans une des notices exportées, la publication génére **donc un fichier CSV mais dont les sépareurs de colonnes sont des tabulations**//

54

55

**compressChar=" ; "**

56

//caracteres utilisé lors de concaténation automatiques de données dans des blocs répétables//

57

58

**newLine="\r\n"**

59

//caracteres délimitant les changement d'enregistrement \r=chr(13) |n=chr(10)//

60

61

**multiValueSeparator=', '**

62

//caracteres utiliser pour concaténer les données des champs multivaluées virgule+espace//

63

64

**valueDelimiter='"'>**

65

//ne pas modifier, permet d'englober les contenus de colonne contenant des \n ou des apsotrophes pour éviter und écalage à l'oiuverture du fichier csv publié//

//Exemple ~://

[[image:1698143160183-538.png||class="img-thumbnail"]]

70

71

72

= Export d'un champ =

73

74

Les exemples ci aprés sont issus de l'export CSV de la table Stratigraphie, mais sont transposables dans toutes les tables de Flora

75

76

== Formatage automatique selon le mode de saisie ==

77

78

Par défaut, Flora mettra en forme l'export des champs en fonction de leur mode de saisie de la manière suivante

79

80

=== Champs texte libre sur une seule ligne ===

//Exemple ~://

[[image:1698221408368-344.png||data-xwiki-image-style-alignment="center" class="img-thumbnail"]]

85

86

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

87

88

**<field name='TYPE_UE' label='Type Unité d_enregistrement '/> **

89

90

(% class="box warningmessage" %)

91

(((

92

//Attention ne pas mettre d'apostrophe ou guillemets à l'interieur d'un contenu de la balise label (cela génére une erreur bloquante à la publication)//

93

)))

94

95

* **name :** nom interne du champ dans la table Flora

96

* **label : **intitulé qu'aura la colonne dans le fichier csv

97

98

[[image:1698233535559-410.png||data-xwiki-image-style-alignment="center" class="img-thumbnail"]]

99

100

=== Champs texte libre multiligne (avec retours à la ligne) ===

101

102

[[image:1698220705279-359.png||data-xwiki-image-style-alignment="center" class="img-thumbnail"]]

103

104

**<field name='PRECISION_UE' label='Précisions UE '/> **aura pour résultat

105

106

[[image:1698220966238-507.png||data-xwiki-image-style-alignment="center" class="img-thumbnail"]]

107

108

=== Champs multivalués liés à des listes, thésaurus ou table d'autorité ===

109

110

[[image:1698220773700-234.png||data-xwiki-image-style-alignment="center" class="img-thumbnail"]]

111

112

**<field name='INTERPRETATION' label='Interpretation'/> **aura pour résultat

113

114

[[image:1698221043701-405.png||data-xwiki-image-style-alignment="center" class="img-thumbnail"]]

115

116

(% class="box infomessage" %)

117

(((

118

Par défaut Flora exporte la valeur "affichée" du champ. c'est à dire le même contenu textuel que ce qui s'affiche dans les vues.

119

Il est possible de demander l'export de la valeur "interne" du champ (code pour les listes, unique_key pour les tables d'autorité, recordId pour les thésaurus), dans ce cas il faut spécifier display=''false' dans le champs field

120

<field name='INTERPRETATION' label='Interpretation '** display='false"/> **

)))

== Formatages personnalisés sur un champ ==

125

126

* **dataBefore :** separateur avant la donnee du champ, répété en cas de multivaluation (Chaine vide si non defini)

127

* **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)

128

* **dataAfter : **separateur apres la donnee du champ répété en cas de multivaluation (Chaine vide si non defini)

129

130

**Exemple : <field name='INTERPRETATION' label='Interpretation' dataBefore="texte avant : " dataAfter=" (texte aprés)" dataMultiValueSeparator=" ; "/>**

131

132

[[image:1698221647528-156.png||data-xwiki-image-style-alignment="center" class="img-thumbnail"]]

133

134

(% class="box infomessage" %)

135

(((

136

**Truc et astuce : **utiliser des retours lignes comme séparateur **avec \n **peut améliorer la lisibilité des données dans le tableur

137

)))

138

139

**<field name='INTERPRETATION' label='Interpretation' dataBefore="texte avant : " dataAfter=" (texte aprés)" dataMultiValueSeparator="\n"/>**

140

141

[[image:1698221798735-336.png||data-xwiki-image-style-alignment="center" class="img-thumbnail"]]

142

143

== Exporter une valeur constante ==

144

145

Toutes les lignes auront la même valeur dans la colonne

146

147

**<constant name="C1" label="Constante1" dataDefValue="myConstante1" />**

148

149

[[image:1698229509017-535.png||data-xwiki-image-style-alignment="center" class="img-thumbnail"]]

150

151

== Exporter un ou plusieurs champs d'une table d'autorité liée ==

152

153

(% class="wikigeneratedid" %)

154

par défaut, les champs liés à des table d'autorité s'exportent avec la concaténation standard des champs de la table liée (dans Flora on appelle ça le digest de la table, il est défini dans le fichierconf/local/musee/db/A.musee.xml digest ou link-digest s'il est défini).

155

De facto, tout se retrouve dans une seule et même colonne

156

157

(% class="wikigeneratedid" %)

158

**Exemple avec le champ qui lie la Table Stratigraphie à la Table Opération**

159

160

(% class="box infomessage" %)

161

(((

162

pour la table Opération le link-digest est composé des champs suivants

)))

(% class="wikigeneratedid" %)

167

A minima, l'export sera réalisé ainsi, avec le champ DISPLAY_OPERATION qui n'est pas répété ni multivalué. c'est un champ caché de Flora qui ne contient que la première de toutes les opérations potentiellement liées à la notice stratigraphie

168

169

(% class="wikigeneratedid" %)

170

**<field name='DISPLAY_OPERATION' label='Opération1'/> **

171

172

(% class="wikigeneratedid" %)

173

[[image:1698222516214-545.png]]

174

175

(% class="wikigeneratedid" %)

176

il est donc possible "d'éclater" les champs de la table liée par colonne via le **linked_field. **Chaque champ exportée de la table liée sera positionné dans un colonne dédiée. de cette manière on n'est p^lus bridé par le digest ou le link-digest

177

178

(% class="wikigeneratedid" %)

179

**<linked_field name='DISPLAY_OPERATION'>

</linked_field>**

(% class="wikigeneratedid" %)

185

[[image:1698222350876-551.png]]

186

187

188

SI on utilise le champ OPERATION (dans le bloc découverte de la grille de saisie), IL est possible d'y saisir plusieurs Opérations liées

189

Dans ce cas, le découpage sera respecté dans chacune des colonnes, mais il ny' aura toujours que 2 colonnes

190

191

**<linked_field name='OPERATION'>

</linked_field>**

[[image:1698222944107-105.png]]

197

198

199

(% class="box infomessage" %)

200

(((

201

**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 ?

202

**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**

203

204

[[image:1698226080684-439.png||data-xwiki-image-style-alignment="center" height="478" width="1071"]]

205

206

**Rappel : **

207

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//

208

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//

209

210

211

[[image:1698226465622-838.png||data-xwiki-image-style-alignment="center" height="285" width="966"]]

212

213

214

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

215

Mais il faut retenir que le paramétrage par défaut des exports etp gére tout cela de manière transparente avec des réglages par défaut qui rendent les données lisibles à minima

216

)))

217

218

= Concaténation libre de champs dans une seule colonne =

219

220

Dans de nombreux cas il sera nécéssaire de regrouper différents champs de la table dans une seule et même colonne

221

222

//Exemple : concaténer tous les champs de Données intrinsèque d'une notice Stratigraphie dans une seule colonne//

223

224

[[image:1698234060502-846.png||data-xwiki-image-style-alignment="center"]]

225

226

De facto il sera judicieux

227

228

* de ne pas perdre les libellés de champs (on les indiquera dans **dataBefore**)

229

* 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**)

230

231

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

236

237

**<concat name="donnees_descr_intr label="Données descriptives intrinsèques">**

**</concat>**

[[image:1698234916860-664.png]]

247

248

== Ajout de données avant - aprés ==

249

250

Cette "boite" concat est vue comme un "groupe" de données. a ce titre il est possible de lui adjoindre les paramètres suivants

251

252

* **groupDataBefore **: donnee avant le groupe

253

* **groupDataAfter **: donnee apres le groupe

254

255

**<concat name="donnees_descr_intr label="Données descriptives intrinsèques"**

256

257

**~ groupDataBefore="texte avant le groupe\n"**

258

259

**~ groupDataAfter="\ntexte aprés le groupe"**

**>**

**</concat>**

//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//

270

271

[[image:1698235351939-869.png]]

272

273

== Ajout de données par défaut entre les champs de la concat ==

274

275

Dans l'exemple ci-aprés, on a positionnés les séparateurs de champs dans chacun des champs avec le DataJoinSeparator

276

277

on pourrait aussi définir une valeur par défaut pour tous les champs du groupe, le **subGroupDataSeparator** ce qui simplifie le paramétrage

278

279

<concat name="donnees_descr_intr" label="Données descriptives intrinsèques"

280

groupDataBefore="texte avant le groupe\n"

281

groupDataAfter="\ntexte aprés le groupe"

282

283

**subGroupDataSeparator=" - champ suivant - "**

284

285

**~ >

286

**<field name='TEXTURE' dataBefore='Texture '/>

<field name='DESCRIPTION_INTRINSEQUE' **dataJoinSeparator="\n"/>**

291

**</concat>**

292

293

//**A noter : **comme on a conservé un DataJoinSeparator sur le dernier champ (car on voulait un retour ligne dans ce cas),le subGoupDAtaSeparator ne s'y applique pas car ce n'est qu'une valeur par dfaut//

294

295

//**résultat obtenu :** Nous avons mis en rouge le subGoupDataSeparator pour bien comprendre qu'il s'applique "à chaque champ", mais pas à chaque valeur d'un champ multivalué.

296

Dans notre jargon technique on dira que le field dans un concat est un sous-groupoe//

297

298

[[image:1698235881598-485.png]]

299

300

(% class="box infomessage" %)

301

(((

302

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.

303

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

304

)))

305

306

= Export des champs d'un bloc répétable =

307

308

Tout ce qui est décrit ci dessus sera exploitable dans les exports de bloc répétable.Un export de bloc répétable pourra contenir des fields, des linked_field, des concats, des constantes

309

310

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

311

312

On peut se representer cela comme une boucle d'éxécution qui tournera tant qu'il existe encore un bloc répété à exporter

313

314

//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)//

315

316

[[image:1768226297481-108.png]]

317

318

== groupDataType~=group ==

319

320

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.

321

322

Dans le cas des groupDataType=group, les subGroup sont regroupés dans une seule "variable"

323

324

il sera possible de définir les data de concaténation ci dessous

325

326

**groupDataBefore**=" données en début de groupe"

327

328

*

329

** subGroupDataBefore **= "données en début de chaque sous-group"

330

**subGroupDataSeparator ** = "données entre chaque champ du sous-groupe"**

331

** subGroupDataAfter** = "\données à la fin de chaque sous-groupe"

332

\\ **groupDataSubGroupSeparator**=" donnée insérée entre chaque subgroup"**

333

334

**groupDataAfter**="données en fin de groupe

335

336

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

337

\\rappel : un sous-groupe correspond dans le MCD, un bloc répétable est un bloc type="set" posé dans un bloc type="selection"

338

339

[[image:1768223007353-115.png]]

340

341

Exemple avec juste deux retours lignes entre chaque sous-groupe

342

343

**~ <group_field name="INTERVENANT"

344

groupDataType = "group"

345

label = "Intervenants-group"

346

groupDataSubGroupSeparator = "\n\n"

347

\\> **

348

349

**~ <field name='PERSONNE_INTERVENANT' label='Intervenant'/>

</group_field>**

et génerera la colonne ci dessous

355

356

[[image:1768226409578-347.png||class="img-thumbnail"]]

357

358

(% class="box infomessage" %)

359

(((

360

Les labels des field dans un group_field de type group ne sont pas exportés, nous les conservons pour que le fichier etp soit plus lisible car on ne connait pas toujours les noms internes de champs (name)

361

Dans ce cas, les "Sous groupe" seront alimentés via une boucle tournant sur chaque occurence de bloc, générant au final une seule colonne

362

)))

363

364

La nouveauté ici c'est le **groupDataSubGroupSeparator **qui permet de définir le séparateur qui s'exporte **entre chaque sous-groupe** (deux sauts de ligne \n dans le cas présent)

365

366

(% class="box infomessage" %)

367

(((

368

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

369

)))

370

371

== groupDataType~=subGroup ==

372

373

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

374

375

**subGroupDataBefore **= "données en début de chaque sous-group"

376

**subGroupDataSeparator ** = "données entre chaque champ du sous-groupe"

377

**subGroupDataAfter** = "\données à la fin de chaque sous-groupe"

378

379

Chaque sous-groupe sera ensuite "posé" dans la colonne avec le compressChar=" ; " définit dans l'entête du format

380

381

<group_field name="INTERVENANT"

382

**~ groupDataType ** = **"subGroup"**

383

label = "Intervenants - uibgroup"

384

385

subGroupDataBefore = "intervenant : "

386

subGroupDataAfter = "\n"

~>

</group_field>

[[image:1768226447728-811.png||class="img-thumbnail"]]

396

397

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

398

399

= sans groupDataType =

400

401

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.

402

De facto on perd la lisibilité du bloc

403

404

<group_field name="INTERVENANT"

405

label = "Intervenants - sans groupDataType"

~>

</group_field>

[[image:1768227008672-422.png]]

414

415

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

416

417

== Extraire un nombre défini de bloc chacun dans sa colonne ==

418

419

Dans certains cas il peut etre interessant d'éclater les blocs et les champs d'un bloc dans des colonnes séparées

420

421

C'est possible avec le subGroupDataIndex mais il fauit prévoir le nombre de colonnes maximum

422

423

Veiller aussi à l'unicité des name en indisuant le nom du bloc dans le fieldName

424

425

<group_field name="INTERVENANT1" fieldName="INTERVENANT"

426

label = "Intervenants - groupe 1"

427

subGroupDataIndex ='1'

~>

</group_field>

<group_field name="INTERVENANT2" fieldName="INTERVENANT"

436

label = "Intervenants - groupe 2"

437

subGroupDataIndex = '2'

~>

</group_field>

<group_field name="INTERVENANT3" fieldName="INTERVENANT"

446

label = "Intervenants - groupe 3"

447

subGroupDataIndex ='3'

~>

</group_field>

[[image:1768228264778-201.png]]

457

458

== Générer autant de lignes que de blocs répétables ==

459

460

Cette option est utilisée dans l'export e-recolnat pour générer une ligne d'export pour chaque bloc identification d'un specimen (FLO-4677)

461

462

On définit le nom du bloc concernée (un seul par export) dans l'entéte du fichier via recordFromGroupFieldName

463

464

[[image:1768228658052-477.png]]

465

466

[[image:1768228710793-297.png]]

467

468

469

== Paramétrages complémentaires pour les blocs répétables ==

470

471

il est possible d'inclure aussi dans un group_field

472

473

* une concaténation formalisée des champs du bloc répétable courant via le tag concat

474

* des champs des notices liées a un des champs du bloc via le tag 'linked_field'

475

* des notices qui référencent la notice courante : tag 'reference' pour les liens parent/enfants. ce tag est étudié plus loin dans l'article

=== Exemple global ===

480

481

<group_field name="INTERVENANT"

482

groupDataType = "group"

483

label = "Intervenants"

484

groupDataBefore = "groupDataBefore"

485

groupDataSubGroupSeparator = "\ngroupDataSubGroupSeparator"

486

subGroupDataBefore = "\nsubGroupDataBefore"

487

subGroupDataSeparator = "\nsubGroupDataSeparator\n"

488

subGroupDataAfter = "\nsubGroupDataAfter"

489

groupDataAfter = "\ngroupDataAfter"

~>

</group_field>

[[image:1768229192168-268.png||class="img-thumbnail"]]

499

500

== Filtre sur les données du groupe ==

501

502

D'un certaine manière un bloc répétable peut être considéré comme une table liée embarquée dans la notice courante

503

504

Il sera donc possible de filtrer les occurences d'un bloc répatable en fonction du contenu d'un ou de plusieurs de ces champs avec une syntaxe de type Sql [NOM_DU_CHAMP] opérateur [VALEUR]. De facto seuls les blocs répondant à cette condition seront exportés , les autres seront ignorés

505

506

=== Masquer des sous-groupes ===

507

508

//Exemple : je voudrais n'exporter que les blocs Intervenants dont le champ Fonction est rempli//

509

510

<**group_field **name="INTERVENANT"

511

groupDataType = "**group**"

512

label = "Intervenants"

513

**subGroupDataFilter **= "(FONCTION_INTERVENANT != null)"

514

groupDataBefore = "- texte avant le groupe -\n"

515

groupDataSubGroupSeparator = "\n{séparateur par défaut entre les sous groupe}\n"

516

groupDataAfter = "\n-texte aprés le groupe"

517

subGroupDataBefore = "- texte avant le sousgroupe - "

518

subGroupDataSeparator = " {séparateur par défaut dans le sous groupe} "

519

subGroupDataAfter = " - texte aprés avant le sousgroupe -"

\\>

</group_field>

Seul le bloc n° 2 est exporté

528

529

[[image:1698310843667-475.png||data-xwiki-image-style-alignment="center" class="img-thumbnail"]]

530

531

=== Masquer des champs dans un sous-groupe ===

532

533

//Exemple : je voudrais n'exporter que les blocs Intervenants dont le champ Fonction est rempli//

534

535

<group_field name="INTERVENANT"

536

groupDataType = "**group**"

537

label = "Intervenants"

538

groupDataBefore = "- texte avant le groupe -\n"

539

groupDataSubGroupSeparator = "\n{séparateur par défaut entre les sous groupe}\n"

540

groupDataAfter = "\n-texte aprés le groupe"

541

subGroupDataBefore = "- texte avant le sousgroupe - "

542

subGroupDataSeparator = " {séparateur par défaut dans le sous groupe} "

543

subGroupDataAfter = " - texte aprés avant le sousgroupe -"

544

\\>

545

\\ <field name='PERSONNE_INTERVENANT' label='Intervenant'/>

</group_field>

dans le lLoc n° 2 le cchamp PRECISIONS_INTERVENANT n'est pas exporté

551

552

[[image:1698311103593-686.png||data-xwiki-image-style-alignment="center" class="img-thumbnail"]]

553

554

=== Limiter le nombre de sous-groupe exportés ===

555

556

(% class="wikigeneratedid" %)

557

**subGroupDataMultMaxi**="1" fera en sorte que seul le premier bloc sera exporté

558

559

(% class="wikigeneratedid" %)

560

**subGroupDataMultMaxi**="4" fera en sorte que seuls les 4 premiers blocs seront exportés

561

562

== Imbrication de groupes ==

563

564

Il n'y a pas de limite au nombre de niveaux imbriqués, il est donc possible de "suivre" la strucre hiérarchique d'un bloc répétable

565

566

Exemple avec les lots archéo

567

568

<group_field name="LOT_ELEMENT"

569

groupDataType = "group"

570

label = "Archéo - lot"

571

groupDataSubGroupSeparator = "\n\n"

572

subGroupDataSeparator = ""

>

<group_field name="LOT_DENOMBREMENT"

580

groupDataType = "group"

581

label = "Element - lot"

582

groupDataBefore ="\n"

583

groupDataSubGroupSeparator = " ; "

584

subGroupDataSeparator = ""

>

</group_field>

</group_field>

[[image:1719328382500-862.png||data-xwiki-image-style-alignment="center" class="img-thumbnail"]]

598

599

= Export des via des liens par héritage (référence) =

600

601

Des notices qui référencent la notice courante : tag 'reference'

602

603

Actuellement ce tag s'appuie sur l'index Q des liens inverses entre table (sans précision du champ qui établit le lien).

604

605

ON ne pourra donc pas l'utiliser pour faire remonter la liste des notices filles liées à une notice méré car dans MUS_BIEN plusieurs champs sont liés à MUS_BIEN

606

607

(% class="box infomessage" %)

608

(((

609

A noter c'est **compressChar **en entete qui est utilisé comme séparateur de notices liées

610

)))

611

612

il permettra par exemple de

613

614

== lister les notices récolement ou constat d'état liées à un bien dans un export des biens ==

615

616

<?xml version="1.0" encoding="ISO-8859-1"?>

617

<export-conf>

618

619

\\<field name='UNIQUE_KEY' label='Unique Key'/>

**<reference source='musee' table='MUS_RECOLEMENT'**

624

groupDataType = "subGroup"

625

label = "Récolements et localisations"

626

subGroupDataBefore = ""

627

subGroupDataSeparator = ", "

628

subGroupDataAfter = "" >

**<linked_field name='EMPLACEMENT' label='Emplacement théorique'>**

</linked_field>

**~ <linked_field name='EMPLACEMENT_NOUVEAU' label='Emplacement nouveau'>**

</linked_field>

</reference>

Il serait théoriquement possible de filtrer récolement

643

644

**subGroupDataFilter **= "(ETAT_AVANCE_RECOL != '6')"

et relocalisations

**subGroupDataFilter **= "(ETAT_AVANCE_RECOL = '6')"

649

650

== lister les notices exemplaires liées à une notice bib ==

651

652

<?xml version="1.0" encoding="ISO-8859-1"?>

<export-conf>

....

<linked_field name='712a'>

</linked_field>

\\ <reference source='system' table='ICOMM_ITEM'

663

groupDataType = "subGroup"

664

label = "Exemplaires"

665

subGroupDataBefore = "{ "

666

subGroupDataSeparator = ", "

667

subGroupDataAfter = "}" >

</reference>

== lister les biens liés à un colis ==

675

676

(% class="box infomessage" %)

677

(((

678

A noter : le tag reference peut imbrique des linked_field, ce qui permet de remonter jusqu'à MUS_BIEN en passant par MUS_JOIN_COLIS

679

)))

680

681

<?xml version="1.0" encoding="ISO-8859-1"?>

682

<export-conf>

683

684

\\<field name='ETAT_MODIFIE_LE' label='Etat modifié le'/>

<linked_field name='LOCATION_REFERENCE' label='Emplacement de référence'>

689

690

</linked_field>

691

<linked_field name='LOCATION_CURRENT' label='Localisation actuelle '>

</linked_field>

**<reference source='musee' table='MUS_JOIN_COLIS'**

696

groupDataType = "subGroup"

697

label = "Biens liés"

698

subGroupDataBefore = ""

699

subGroupDataSeparator = ", "

700

subGroupDataAfter = "" >

701

702

*

703

** <linked_field name='BIEN' label='Bien'>

704

**~ <field name='DISPLAY' label='Bien' display='true'/>

</linked_field>

\\</reference>**

**<reference source='musee' table='MUS_JOIN_COLIS_MOUV'**

709

groupDataType = "subGroup"

710

label = "Biens en mvmnt liés"

711

subGroupDataBefore = ""

712

subGroupDataSeparator = ", "

713

subGroupDataAfter = "" >

714

**<linked_field name='MOUVEMENT_BIEN' label='Bien'>**

</linked_field>

</reference>

= Exporter des images (uniquement en format de sortie excel natif) =

721

722

== Première image uniquement ==

723

724

Toutes les options de séparateurs, textes avant et aprés, fonctionnent. tous les cghampsd e IDOCS sont exportables

725

726

C'est l'option **subGroupDataIndex **qui permet de choisir l'image à exporter (premiere, deuxieme, troisieme...)

727

728

**Attention au choix de la résolution. **

729

//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

730

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)

731

732

733

**<linked_records_document_records** name="PHOTO_INV"

734

inputRecordFilter=""

735

linkedRecordFilter=""

736

737

groupDataType=""

738

documentTypes="Document-Photo"

739

subGroupDataFilter="(IDOC_ACCESSIBILITY = 1)"

740

subGroupDataMultMaxi=""

741

**subGroupDataIndex="1">**

742

<!~-~- champ de la table IDOCS ~-~->

743

744

745

<!~-~- Imagette ~-~->

746

<photo_document_file name="_PHOTO_1"

747

label="Photo 1"

748

inputRecordFilter=""

749

documentTypes="Document-Photo"

*

** resolution="LOW"

dimImageXYInPixels="192"**/>

754

</linked_records_document_records>**

755

756

== Plusieurs images ==

757

758

=== sur plusieurs colonnes ===

759

760

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

761

762

Pour cela il suffit de dupliquer le bloc ci dessus et de choisir le bon **subGroupDataIndex="?" **dans chaque colonne

763

764

Pour ne pas compliquer la lecture du fichier excel il est préférable de ne pas exporter le nom du fichier à chaque fois

765

766

Exemple avec 4 images

767

768

<linked_records_document_records name="PHOTO_INV"

769

documentTypes="Document-Photo"

770

subGroupDataFilter="(IDOC_ACCESSIBILITY = 1)"

771

**subGroupDataIndex="1"**>

772

773

**~

774

**<photo_document_file name="**_PHOTO1**"

775

label="**Photo1**"

776

documentTypes="Document-Photo"

777

resolution="LOW"

778

dimImageXYInPixels="192"/>

779

</linked_records_document_records>

780

781

<linked_records_document_records name="PHOTO_INV"

782

documentTypes="Document-Photo"

783

subGroupDataFilter="(IDOC_ACCESSIBILITY = 1)"

784

**subGroupDataIndex="2"**>

785

786

**~

787

**<photo_document_file name="**_PHOTO2**"

788

label="**Photo2**"

789

documentTypes="Document-Photo"

790

resolution="LOW"

791

dimImageXYInPixels="192"/>

792

</linked_records_document_records>

793

794

<linked_records_document_records name="PHOTO_INV"

795

documentTypes="Document-Photo"

796

subGroupDataFilter="(IDOC_ACCESSIBILITY = 1)"

797

**subGroupDataIndex="3"**>

798

799

**~

800

**<photo_document_file name="**_PHOTO3**"

801

label="**Photo3**"

802

documentTypes="Document-Photo"

803

resolution="LOW"

804

dimImageXYInPixels="192"/>

805

</linked_records_document_records>

806

807

<linked_records_document_records name="PHOTO_INV"

808

documentTypes="Document-Photo"

809

subGroupDataFilter="(IDOC_ACCESSIBILITY = 1)"

810

**subGroupDataIndex="4"**>

811

812

**~

813

**<photo_document_file name="**_PHOTO4**"

814

label="**Photo4**"

815

documentTypes="Document-Photo"

816

resolution="LOW"

817

dimImageXYInPixels="192"/>

818

</linked_records_document_records>

819

820

=== sur plusieurs lignes ===

821

822

Avec les options ci dessous déclarés dans un seul bloc

823

824

<linked_records_document_records name="PHOTO_INV"

825

documentTypes="Document-Photo"

826

subGroupDataFilter="(IDOC_ACCESSIBILITY = 1)"

827

828

*

829

** subGroupDataMultMaxi="4"

830

subGroupDataIndex="">

831

\\**<photo_document_file name="_PHOTO"

832

label="Photo"

833

documentTypes="Document-Photo"

834

resolution="LOW"

835

dimImageXYInPixels="192"/>

836

</linked_records_document_records>**

837

838

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=

839

840

Cette disposition complique un peu la manipulation et la lecture des données dans excel à cause des lignes vides

841

842

== (% id="cke_bm_1281128S" style="display:none" %) (%%)Export des liens ark vers les images ==

843

844

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

845

846

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

847

848

Il st donc possible de publier les images via des liens ark

849

850

la colonne devra etre paramétrée ainsi

851

852

**name="PHOTO_INV" **=nom du champ contenant le lien vers la phototheque (si l'export concerne MUS_PHOTO on indiquera UNIQUE_KEY)

853

854

**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)

855

856

**dataMultMaxi="1" **Nombre de fichiers images lus par notice photo, 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)

857

858

**dataBefore="${flora-url}/ark:**" reprendra automatiquement la racine de l'url de votre applucation flora. SI cette url est accessible par internet et que vous avecz activé le service ark sur votre application, la visualisation des uimages sera possible sur tout poste de travail connecté à internet

859

860

**dataAfter="/low" **renverra l'imagette,

861

862

* si on met** /medium **on aura un fichier de 800 pixels,

863

* si on met **/high** on aura l'image originale non redimensionnées (mais pas la THDEF)

864

865

<linked_field name="PHOTO_INV"

866

label="Image"

867

inputRecordFilter=""

868

groupDataType="group"

869

subGroupDataSeparator=" ~~ "

870

subGroupdataMultiValueSeparator="|"

871

subGroupDataMultMaxi="1"

872

>

873

\\ <class_extractor

874

extractorClassName="com.ezida.services.musee.extractor.MusPhotoArkExtractor"

name="PHOTO_INV_ARK"

label=""

inputRecordFilter=""

dataJoinSeparator="|"

880

dataMultiValueSeparator="|"

881

dataMultMaxi="1"

882

dataBefore="${flora-url}/ark:"

dataDefValue=""

dataAfter="/low"/>

</linked_field>

résultat obtenu.. avec un clic sur le lien ark exporté

889

890

[[image:1698400681257-169.png]]

891

892

893

= Autres paramétrages =

894

895

== Conversions de dates et datations ==

896

897

**dataDateFormatDisplay**='yyyy-MM-dd'

898

899

dataDateFormatDisplay='yyyy'

.....

//Cela fonctionne pour les champs dates, time et datation//

904

905

time <field name='CREATE_DATE' label='Saisi le' dataDateFormatDisplay='yyyy-MM-dd'/>

906

907

date <field name='ETAT_MODIFIE_LE' label='Etat modifié le ' dataDateFormatDisplay='yyyy-MM-dd'/>

908

909

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

910

911

(% class="box infomessage" %)

912

(((

913

Attention Excel applique ensuite ses propres automates de formatage à l'ouverture du fichier

914

)))

915

916

== valeur par défaut ==

917

918

**dataDefValue**="maValeurtextuelle"

919

920

si le field, linked_field, concat, group_feld est vide, c'est cette valeur qui sera exportée

921

922

//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//

923

924

== Données textuelles ajoutées en multilangue ==

925

926

Flora gére des fichiers de mots clés pour la traduction des labels textuels dans les différentes languies (dans les fichiers *.properties)

927

928

[[image:1698311785574-970.png||height="133" width="841"]]

929

930

ces mots clés peuvent etre utilisés dans toutes les valeurs textuelles posées dans les tags