McNamara84 / gfz-metadata-editor-msl-v2

MIT License
1 stars 0 forks source link

Projektbeschreibung

Dieser Metadaten-Editor entstand im Rahmen eines studentischen Kooperationsprojekt zwischen Fachhochschule Potsdam und dem GeoForschungsZentrum Potsdam. Der Editor speichert Metadaten zu Forschungsdatensätzen in validen XML-Dateien nach dem DataCite, dem ISO- und dem DIF-Schema.

Installation

  1. Sicherstellen einer Entwicklungsumgebung mit PHP >8.2 sowie eines MySQL-Servers.
  2. XSL- und ZIP-Extension für PHP muss vorhanden und aktiviert sein.
  3. Apache und MySQL starten nicht vergessen.
  4. Datenbank "mde" in MySQL (z. B. mittels phpMyAdmin) erstellen.
  5. Inhalt der Datei sample_settings.php in neue Datei settings.php kopieren und Einstellungen für Datenbankverbindung anpassen.
  6. Für die automatisch generierten Zeitzonen-Auswahl einen kostenlosen API Key unter https://timezonedb.com/ erstellen und ebenfalls in der neu erstellen settings.php eintragen
  7. Google Maps JS API Key erstellen und ebenfalls in die Datei settings.php einfügen.
  8. Alle Dateien dieses Repositories in den Ordner "htdocs"-Ordner des Webservers kopieren.
  9. install.php über den Browser aufrufen. Die Datenbank-Tabellen werden automatisch erstellt.
  10. Der Metadateneditor ist nun über localhost/verzeichnisname im Browser erreichbar.

Bei Problemen mit der Installation, hinterlasse gerne einen Eintrag im Issue Board dieses Repositories!

Abhängigkeiten

In der header.html und footer.html werden folgende Abhängikeiten von Drittanbietern eingebunden:

Einstellungen

In der Datei settings.php können, neben den Zugangsdaten für die Datenbank, auch andere Einstellungen angepasst werden:

API-Endpunkte

getTimezones

Der regelmäßige Aufruf zur Aktualisierung der Zeitzonen im Feld Timezones der Gruppe Spatial and temporal coverage per Cronjob wird empfohlen. Empfohlener Ausführungsintervall: Monatlich Aufzurufender URL: api.php?action=getTimezones

getNasaScienceKeywords

Damit der Thesaurus für die NASA Science Keywords aktuell bleibt, ist die regelmäßige Aktualisierung über diesen API-Endpunkt angedacht. Empfohlender Ausführungsintervall: Wöchentlich Auszuführende URL: api.php?action=getNasaScienceKeywords

getNasaInstrumentsKeywords

Zur Erstellung des Thesaurus für die NASA Instruments Keywords bzw. zur regelmäßigen Aktualisierung ist dieser API-Endpunkt gedacht. Empfohlender Ausführungsintervall: Wöchentlich Auszuführende URL: api.php?action=getNasaInstrumentsKeywords

getNasaPlatformsKeywords

Um auch die NASA GCMD Platforms Keywords als JSON-Datei für den entsprechenden Thesaurus zu aktualisieren wird eine regelmäßige Ausführung von getNasaPlatformsKeywords empfohlen. Empfohlender Ausführungsintervall: Wöchentlich Auszuführende URL: api.php?action=getNasaPlatformsKeywords

getChronostratKeywords

Die Chronostrat Keywords werden von der International Chronostratigraphic Chart International Commission on Stratigraphy veröffentlicht. Eine regelmäßige Aktualisierung wird empfohlen, jedoch werden diese Keywords eher selten aktualisiert. Empfohlender Ausführungsintervall: Monatlich Auszuführende URL: api.php?action=getChronostratKeywords

getCGIKeywords

Die CGI Simple Lithology Keywords werden von der Commission for the Management and Application of Geoscience Information (CGI) entwickelt. Eine regelmäßige Aktualisierung wird empfohlen, jedoch werden diese Keywords eher selten aktualisiert. Empfohlender Ausführungsintervall: Monatlich Auszuführende URL: api.php?action=getCGIKeywords

getGemetConcepts

Die englischsprachigen Konzepte des GEneral Multilingual Environmental Thesaurus (Gemet) werden mit diesem API-Endpunkt beschafft. Eine regelmäßige Aktualisierung wird empfohlen, jedoch werden diese Konzepte und Terme nur "every few years" aktualisiert. Auch Korrekturen erfolgen nur alle paar Monate (siehe: Gemet changes ) Empfohlender Ausführungsintervall: Monatlich Auszuführende URL: api.php?action=getGemetConcepts

getRorAffiliations

Zur regelmäßigen Aktualisierung der Daten in den Auswahlfeldern für die Affiliations von Personen sollte dieser API-Endpunkt regelmäßig ausgeführt werden. Empfohlender Ausführungsintervall: Wöchentlich Auszuführende URL: api.php?action=getRorAffiliations

getCrossRefFunders

Zur regelmäßigen Aktualisierung der Auswwahloptionen im Funders-Dropdown-Feld wird die regelmäßige Ausführung von getCrossRefFunders nahegelegt. Empfohlender Ausführungsintervall: Wöchentlich Auszuführende URL: api.php?action=getCrossRefFunders

getResourceAsDataciteXml

Der API-Endpunkt „getResourceAsDataciteXml” nimmt eine ID entgegen und exportiert den Datensatz mit dieser ID aus der Datenbank und transformiert ihn in eine valide XML-Datei gemäß dem DataCite-Schema in der aktuellen Version 4.5 vom 22.01.2024. Der Endpunkt wird in erster Linie vom Metadateneditor selbst beötigt, kann aber zukünftig auch anderen Anwendungen eine valide DataCite-Datei liefern. Auszuführende URL: api.php?action=getResourceAsDataciteXml&id=1

Formularfelder

Resource Information

Rights

Authors

Contact Person(s)

Contributors

Description

Thesaurus Keywords

Free Keywords

Dates

Spatial and temporal coverage

Räumliche und zeitliche Einordnung des Datensatzes. Zur einfacheren Erfassung der geografischen Angaben wird Google Maps genutzt. Wird auf der Karte ein Rechteck gezeichnet, werden die Koordinaten dieses Rechtecks an die Eingabefelder Latitude Min und Latitude Max sowie Longitude Min und Longitude Max übergeben. Die Speicherung dieser Koordinaten geschieht erst zusammen mit der Speicherung des gesamten Formulars. Wird lediglich ein Marker auf der Karte gesetzt, werden die Felder Latitude Min und Longitude Min befüllt, während Latitude Max und Longitude Max leer bleiben.

Related Work

Datenvalidierung

Datenbankstruktur

Lizenz

Dieses Projekt wurde 2024 von Studenten der Fachhochschule Potsdam in Zusammenarbeit mit dem Deutschen GeoForschungsZentrum entwickelt und wird unter der MIT-Lizenz veröffentlicht.