Skip to content

Commit a09a1f5

Browse files
author
Dominick Leppich
committed
Merge pull request 'Release v24.10' (#17) from release_24.10 into master
2 parents 203c07c + c4eeda9 commit a09a1f5

16 files changed

+275
-54
lines changed

‎Jenkinsfile

+19-1
Original file line numberDiff line numberDiff line change
@@ -27,6 +27,8 @@ pipeline {
2727
anyOf {
2828
branch 'master'
2929
branch 'release_*'
30+
branch 'hotfix_release_*'
31+
branch 'sonar_*'
3032
allOf {
3133
branch 'PR-*'
3234
expression { env.CHANGE_BRANCH.startsWith("release_") }
@@ -43,6 +45,7 @@ pipeline {
4345
anyOf {
4446
branch 'master'
4547
branch 'release_*'
48+
branch 'hotfix_release_*'
4649
allOf {
4750
branch 'PR-*'
4851
expression { env.CHANGE_BRANCH.startsWith("release_") }
@@ -53,12 +56,21 @@ pipeline {
5356
sh 'mvn clean verify -U -P release-build'
5457
}
5558
}
59+
stage('build-sonar') {
60+
when {
61+
branch 'sonar_*'
62+
}
63+
steps {
64+
sh 'mvn clean verify -U -P sonar-build'
65+
}
66+
}
5667
stage('sonarcloud') {
5768
when {
5869
allOf {
5970
anyOf {
6071
branch 'master'
6172
branch 'release_*'
73+
branch 'hotfix_release_*'
6274
branch 'sonar_*'
6375
allOf {
6476
branch 'PR-*'
@@ -83,6 +95,7 @@ pipeline {
8395
anyOf {
8496
branch 'master'
8597
branch 'develop'
98+
branch 'hotfix_release_*'
8699
}
87100
}
88101
steps {
@@ -95,7 +108,12 @@ pipeline {
95108
}
96109
}
97110
stage('tag release') {
98-
when { branch 'master' }
111+
when {
112+
anyOf {
113+
branch 'master'
114+
branch 'hotfix_release_*'
115+
}
116+
}
99117
steps {
100118
withCredentials([gitUsernamePassword(credentialsId: '93f7e7d3-8f74-4744-a785-518fc4d55314',
101119
gitToolName: 'git-tool')]) {

‎README.md

+18-19
Original file line numberDiff line numberDiff line change
@@ -1,40 +1,39 @@
1-
# Goobi workflow Plugin: plugin-workflow-projectexport
1+
# Goobi workflow Plugin: goobi-plugin-workflow-project-export
22

33
<img src="https://goobi.io/wp-content/uploads/logo_goobi_plugin.png" align="right" style="margin:0 0 20px 20px;" alt="Plugin for Goobi workflow" width="175" height="109">
44

5-
This is a workflow plugin for Goobi workflow to allow an export of an entire project. To use this a defined workflow step has to be finished and another workflow step will be finished after this export happened. The export creates an Excel file with hard coded metadata fields from the METS files as well as all images for all involved processes.
5+
This Workflow plugin for Goobi workflow allows to export an entire project. A defined workflow step has to be finished to allow the usage. After execution another workflow step will be finished. The export creates an Excel file with metadata images for all processes.
66

77
This is a plugin for Goobi workflow, the open source workflow tracking software for digitisation projects. More information about Goobi workflow is available under https://goobi.io. If you want to get in touch with the user community simply go to https://community.goobi.io.
88

99
## Plugin details
1010

1111
More information about the functionality of this plugin and the complete documentation can be found in the central documentation area at https://docs.goobi.io
1212

13-
Detail | Description
14-
--- | ---
15-
**Plugin identifier** | intranda_workflow_projectexport
16-
**Plugin type** | Workflow plugin
13+
Detail | Description
14+
--------------------------- | ----------------------
15+
**Plugin identifier** | intranda-workflow-projectexport
16+
**Plugin type** | workflow
1717
**Licence** | GPL 2.0 or newer
18-
**Documentation (German)** | https://docs.goobi.io/goobi-workflow-plugins-de/workflow/intranda_workflow_projectexport
19-
**Documentation (English)** | https://docs.goobi.io/goobi-workflow-plugins-en/workflow/intranda_workflow_projectexport
18+
**Documentation (German)** | https://docs.goobi.io/workflow-plugins/v/ger/workflow/goobi-plugin-workflow-project-export
19+
**Documentation (English)** | https://docs.goobi.io/workflow-plugins/v/eng/workflow/goobi-plugin-workflow-project-export
2020

2121
## Goobi details
2222

2323
Goobi workflow is an open source web application to manage small and large digitisation projects mostly in cultural heritage institutions all around the world. More information about Goobi can be found here:
2424

25-
Detail | Description
26-
--- | ---
27-
**Goobi web site** | https://www.goobi.io
28-
**Twitter** | https://twitter.com/goobi
29-
**Goobi community** | https://community.goobi.io
25+
Detail | Description
26+
--------------------------- | ---------------------------
27+
**Goobi web site** | https://www.goobi.io
28+
**Goobi community** | https://community.goobi.io
29+
**Goobi documentation** | https://docs.goobi.io
3030

3131
## Development
3232

3333
This plugin was developed by intranda. If you have any issues, feedback, question or if you are looking for more information about Goobi workflow, Goobi viewer and all our other developments that are used in digitisation projects please get in touch with us.
3434

35-
Contact | Details
36-
--- | ---
37-
**Company name** | intranda GmbH
38-
**Address** | Bertha-von-Suttner-Str. 9, 37085 Göttingen, Germany
39-
**Web site** | https://www.intranda.com
40-
**Twitter** | https://twitter.com/intranda
35+
Contact | Details
36+
--------------------------- | ----------------------------------------------------
37+
**Company name** | intranda GmbH
38+
**Address** | Bertha-von-Suttner-Str. 9, 37085 Göttingen, Germany
39+
**Web site** | https://www.intranda.com

‎docs/index_de.md

+86
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,86 @@
1+
---
2+
title: Projektexport als Ordner mit Bildern und Excel-Datei
3+
identifier: intranda_workflow_projectexport
4+
description: Dieses Workflow Plugin erlaubt einen Export eines gesamten Projektes in eine Verzeichnisstruktur mit einer Excel-Datei und den zugehörigen Bildern gemäß spezifischer Projektvorgaben
5+
published: true
6+
---
7+
## Einführung
8+
Dieses Workflow Plugin erlaubt einen sehr spezifischen Export eines gesamten Projektes. Hierfür prüft das Plugin zunächst, ob in allen Vorgängen des gewählten Projektes auch tatsächlich der konfigurierte Arbeitsschritt im Workflow bereits abgeschlossen wurde. Abhängig von dieser Prüfung erlaubt das Plugin anschließend einen Export aller Bilder eines definierten Bildverzeichnisses (z.B. die Master-Bilder) und einen Export definierter Metadaten innerhalb einer Excel-Datei. Der Aufbau der Excel-Datei ist dabei so, dass pro Bild die jeweiligen Metadaten redundant jeweils in einer eigenen Zeile aufgeführt sind.
9+
10+
Sollte die anfängliche Prüfung feststellen, dass der konfigurierte Arbeitsschritt im Workflow bereits für alle Vorgänge des Projekte abgeschlossen wurde, so wird der konfigurierte Export-Arbeitsschritt für alle Vorgänge des Projektes ebenfalls auf abgeschlossen gesetzt
11+
12+
13+
## Installation
14+
Zur Installation des Plugins müssen folgende beiden Dateien installiert werden:
15+
16+
```bash
17+
/opt/digiverso/goobi/plugins/workflow/plugin-intranda-workflow-projectexport-base.jar
18+
/opt/digiverso/goobi/plugins/GUI/plugin-intranda-workflow-projectexport-gui.jar
19+
```
20+
21+
Um zu konfigurieren, wie sich das Plugin verhalten soll, können verschiedene Werte in der Konfigurationsdatei angepasst werden. Die Konfigurationsdatei befindet sich üblicherweise hier:
22+
23+
```bash
24+
/opt/digiverso/goobi/config/plugin_intranda_workflow_projectexport.xml
25+
```
26+
27+
Der Inhalt dieser Konfigurationsdatei sieht wie folgt aus:
28+
29+
```xml
30+
<config_plugin>
31+
32+
<config>
33+
<!-- name of the project, can be repeated. Use * for any project -->
34+
<project>*</project>
35+
<!-- check if all proceses of the project have finished this task -->
36+
<finishedStepName>Metadata enrichment</finishedStepName>
37+
<!-- close this step after the export was successful -->
38+
<closeStepName>Export</closeStepName>
39+
<!-- define which image folder (master|media|jpeg|source|...) shall be used for the export -->
40+
<imageFolder>media</imageFolder>
41+
<!-- write the export into this directory -->
42+
<exportDirectory>/opt/digiverso/viewer/hotfolder</exportDirectory>
43+
<!-- define if the export result shall be provided as zip file download -->
44+
<allowZipDownload>true</allowZipDownload>
45+
</config>
46+
47+
</config_plugin>
48+
```
49+
50+
Für eine Nutzung dieses Plugins muss der Nutzer über die korrekte Rollenberechtigung verfügen.
51+
52+
![Ohne korrekte Berechtigung ist das Plugin nicht nutzbar](screen1_de.png)
53+
54+
Bitte weisen Sie daher der Gruppe die Rolle `Plugin_Goobi_ProjectExport` zu.
55+
56+
![Korrekt zugewiesene Rolle für die Nutzer](screen2_de.png)
57+
58+
59+
## Überblick und Funktionsweise
60+
Wenn das Plugin korrekt installiert und konfiguriert wurde, ist es innerhalb des Menüpunkts `Workflow` zu finden und kann von dort gestartet werden. Verfügt man über die notwendigen Rechte zur Verwendung des Plugins, so kann nun eine Auswahl aus den zur Verfügung stehenden Projekten erfolgen.
61+
62+
![Auswahl des Projektes](screen3_de.png)
63+
64+
Nach der Auswahl des gewünschten Projektes stehen je nach Konfiguration zwei Buttons zur Verfügung. Diese erlauben entweder die Ausführung des Exports in das gewünschte Zielverzeichnis oder den Download des gesamten Exportergebnisses als eine große zip-Datei.
65+
66+
![Aufbau des Verzeichnisses nach Durchführung des Exports](screen4.png)
67+
68+
Das Exportergebnis ist so aufgebaut, dass für jeden Vorgang ein Unterordner erzeugt wird innerhalb dessen sich die zugehörigen Bilder aus dem definierten Verzeichnnis befinden. Darüber hinaus wird ausserdem eine Excel-Datei erzeugt.
69+
70+
![Aufbau einer exportierten Exceldatei mit allen zugehörigen Metadaten pro Bild](screen5.png)
71+
72+
Innerhalb jeder Zeile dieser Excel-Datei befinden sich nun die jeweiligen Metadaten, die aus der METS-Datei gelesen wurden, wobei diese redundant für jedes Bild wiederholt aufgeführt werden.
73+
74+
75+
## Konfiguration
76+
Die Konfiguration des Plugins gestaltet sich wie folgt:
77+
78+
| Wert | Beschreibung |
79+
| :--- | :--- |
80+
| `config` | Der Block `config` kann beliebig oft vorkommen. Dadurch lassen sich mehrere individuelle Einstellungen für einzelne Projekte vornehmen. |
81+
| `project` | Definieren Sie mit diesem Parameter, für welches Projekt die Konfiguration greifen soll. Hier können die Namen der Projekte wiederholbar aufgeführt werden. |
82+
| `finishedStepName` | Mit diesem Parameter wird festgelegt, welcher Arbeitsschritt für alle Vorgänge des gewählten Projektes abgeschlossen sein soll, damit der Export-Arbeitsschritt abschließend für alle Vorgänge des Projektes ebenfalls nach Durchführung des Exports als abgeschlossen markiert wird. |
83+
| `closeStepName` | Hier kann festgelegt werden, wie der Name desjenigen Arbeitsschrittes lautet, der nach Durchführung des Exports abgeschlossen wird. |
84+
| `imageFolder` | Legen Sie hier fest, welches Verzeichnis für den Export verwendet werden soll. Typische Werte hierfür sind `master` oder `media`. |
85+
| `exportDirectory` | Für jeden Konfigurationsblock kann ein Zielverzeichnis für den Export festgelegt werden. Alle Exporte erfolgen innerhalb des hier festgelegten Ordners. |
86+
| `allowZipDownload` | Soll neben dem Export in das konfigurierte Verzeichnis ausserdem ein Download des gesamten Exports als eine Zip-Datei möglich sein, so kann dies hier aktiviert werden. |

‎docs/index_en.md

+87
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,87 @@
1+
---
2+
title: Project export as folder with images and Excel file
3+
identifier: intranda-workflow-projectexport
4+
description: This workflow plugin allows an export of an entire project into a directory structure with an Excel file and the associated images according to specific project specifications
5+
published: true
6+
---
7+
## Introduction
8+
This workflow plugin allows a very specific export of an entire project. For this purpose, the plugin first checks whether the configured step in the workflow has actually been completed in all processes of the selected project. Depending on this check, the plugin then allows an export of all images of a defined image directory (e.g. the master images) and an export of defined metadata within an Excel file. The structure of the Excel file is such that the respective metadata is redundantly listed in a separate line for each image.
9+
10+
If the initial check determines that the configured workflow step in the workflow has already been completed for all processes of the project, the configured export workflow step is also set to completed for all processes of the project.
11+
12+
13+
## Installation
14+
To install the plugin, the following two files must be installed:
15+
16+
```bash
17+
/opt/digiverso/goobi/plugins/workflow/plugin-intranda-workflow-projectexport-base.jar
18+
/opt/digiverso/goobi/plugins/GUI/plugin-intranda-workflow-projectexport-gui.jar
19+
```
20+
21+
To configure how the plugin should behave, various values can be adjusted in the configuration file. The configuration file is usually located here:
22+
23+
```bash
24+
/opt/digiverso/goobi/config/plugin_intranda_workflow_projectexport.xml
25+
```
26+
27+
The content of this configuration file looks like this:
28+
29+
```xml
30+
<config_plugin>
31+
32+
<config>
33+
<!-- name of the project, can be repeated. Use * for any project -->
34+
<project>*</project>
35+
<!-- check if all proceses of the project have finished this task -->
36+
<finishedStepName>Metadata enrichment</finishedStepName>
37+
<!-- close this step after the export was successful -->
38+
<closeStepName>Export</closeStepName>
39+
<!-- define which image folder (master|media|jpeg|source|...) shall be used for the export -->
40+
<imageFolder>media</imageFolder>
41+
<!-- write the export into this directory -->
42+
<exportDirectory>/opt/digiverso/viewer/hotfolder</exportDirectory>
43+
<!-- define if the export result shall be provided as zip file download -->
44+
<allowZipDownload>true</allowZipDownload>
45+
</config>
46+
47+
</config_plugin>
48+
```
49+
50+
To use this plugin, the user must have the correct role authorisation.
51+
52+
![Without correct authorisation the plugin cannot be used](screen1_en.png)
53+
54+
Therefore, please assign the role `Plugin_Goobi_ProjectExport` to the group.
55+
56+
![Correctly assigned role for the users](screen2_en.png)
57+
58+
59+
## Operation of the plug-in
60+
61+
If the plugin has been installed and configured correctly, it can be found within the menu item `Workflow` and can be started from there. If you have the necessary rights to use the plugin, you can now select from the available projects.
62+
63+
![Selection of the project](screen3_en.png)
64+
65+
After selecting the desired project, two buttons are available depending on the configuration. These allow either the execution of the export into the desired target directory or the download of the entire export result as a large zip file.
66+
67+
![Structure of the directory after executing the export](screen4.png)
68+
69+
The export result is structured in such a way that for each process a subfolder is created within which the corresponding images from the defined directory are located. In addition, an Excel file is created.
70+
71+
![Structure of an exported Excel file with all associated metadata per image](screen5.png)
72+
73+
Within each line of this Excel file there is now the respective metadata that was read from the METS file, whereby these are listed redundantly for each image repeatedly.
74+
75+
76+
## Configuration
77+
The configuration of the plug-in is as follows:
78+
79+
| Value | Description |
80+
| :--- | :--- |
81+
| `config` | The block `config` can occur any number of times. This allows several individual settings to be made for individual projects. |
82+
| `project` | Use this parameter to define for which project the configuration should take effect. The names of the projects can be listed here in a repeatable manner. |
83+
| `finishedStepName` | This parameter is used to define which workflow step is to be completed for all tasks of the selected project so that the export workflow step is also marked as completed for all processes of the project after the export has been carried out. |
84+
| `closeStepName` | Here you can specify the name of the workflow step that is closed after the export has been carried out. |
85+
| `imageFolder` | Specify here which directory is to be used for the export. Typical values for this are `master` or `media`. |
86+
| `exportDirectory` | A target directory for the export can be specified for each configuration block. All exports will take place within the folder specified here. |
87+
| `allowZipDownload` | If, in addition to exporting to the configured directory, it should also be possible to download the entire export as a zip file, this can be activated here. |

‎docs/screen1_de.png

837 KB
Loading

‎docs/screen1_en.png

827 KB
Loading

‎docs/screen2_de.png

1.16 MB
Loading

‎docs/screen2_en.png

1.1 MB
Loading

‎docs/screen3_de.png

843 KB
Loading

‎docs/screen3_en.png

835 KB
Loading

‎docs/screen4.png

965 KB
Loading

‎docs/screen5.png

3.02 MB
Loading

‎module-base/pom.xml

+1-1
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
<parent>
44
<groupId>io.goobi.workflow.plugin</groupId>
55
<artifactId>plugin-workflow-project-export</artifactId>
6-
<version>24.06</version>
6+
<version>24.10</version>
77
</parent>
88
<artifactId>plugin-workflow-project-export-base</artifactId>
99
<packaging>jar</packaging>

0 commit comments

Comments
 (0)