Workflow Metadatenprofile

In GitLab werden alle Metadatenprofile von Coscine geprüft und gereviewt. Die folgende Anleitung richtet sich an die entsprechenden Admins im Coscine GitLab.

Benachrichtigung: Neuer Merge Request

• Information über einen neues Metadatenprofil erfolgt durch den Erhalt einer E-Mail/Service Ticket mit Betreff "[Coscine] New Merge Request for an Application Profile"
• Zusätzlich kann das Metadatenprofil-Repositorium in Gitlab aboniert werden (Glockensymbol: "watch" aktivieren)

Metadatenprofil-Review durchführen

• Einloggen auf Coscine GitLab Seite unter Metadata Profiles -> Merge Requests
• den kompletten Code unter "Changes" einsehen. Die folgenden Dinge überprüfen:
  • Titel und Beschreibung des Metadatenprofils. Passen sie zusammen? Vor allem die Deutsch-Englisch Übersetzungen?
  • Die Term-IRIs (befinden sich für das jeweilige Feld nach sh:path). Handelt es sich primär um bereits definierte Terms oder sind viele selbst-definiert?
  • English-Deutsch Übersetzungen, ergeben sie Sinn?
  • Werden Beschreibungen der Metadatenfelder bereitgestellt? Wenn ja, stimmt die Beschreibung mit dem Namen des Metadatenfelds überein?
  • Werden verschiedene sh:datatype benutzt? Das default ist string, aber in Feldern wie bspw. "Datum" wäre date eventuell angebracht.
  • Ergeben die ausgewählten terms Sinn? (nur nach eindeutigen Diskrepanzen schauen, z.B. dcterms:author für ein Feld mit dem Name "Device" )
  • Wenn die Basis-URL (Zeile eins in "index.ttl") die GUID wie https://purl.org/coscine/ap/{GUID}/ enthält, ändern Sie dies so, dass sie den Namen des Profils und, falls erforderlich, die Gruppierung enthält: https://purl.org/coscine/ap/{profileName}/ oder https://purl.org/coscine/ap/{group}/{profileName}/.
• Direkt im Code mittels kommentieren und spezifische Codeänderungen vorschlagen (siehe markierte Felder in Abbildung 1)

Abbildung 1 - Vorschläge in GitLab Merge Request mittels Zeilenkommentar

• Kopieren der Metadatenprofil-Syntax unter "Changes" in das AIMS-Frontend:
• Aktion -> "Erstellen", Editor-Ansicht aktivieren und Füller-Symbol zum Wechsel auf Code-Ansicht auswählen (siehe Abbildung 2)
• Einfügen der Metadatenprofil-Syntax über Copy-Paste von GitLab

Abbildung 2 - Review von Metadatenprofilen in AIMS

Prüfung im AIMS-Generator

• AIMS-Frontend: In der Editor-Ansicht über Zahnrad-Symbol Metadaten des Metadatenprofils prüfen, danach Metadaten-Ansicht aktivieren und Feldfunktionen prüfen (siehe Abbildung 2)
  • Prüfen, ob die gewählten Terms Sinn machen (IRI-Feld unter Feld Eigenschaften)
    • Wenn diese unpassend sind (z.B. hinter einem Feld welches Temperatur heißt ist http://purl.org/dc/terms/created angegeben), Kontakt mit Erstellerin wenn möglich über GitLab oder über Servicedesk Ticket aufnehmen
    • Sollte es lediglich Verbesserungsvorschläge zu den Terms geben, gerne Feedback geben, dies ist jedoch kein Grund zur Ablehnung des Metadatenprofils
• Prüfung Ok? Weiter zum Schritt Prüfung auf DSP-10
• Fehler/Unklarheiten? Siehe Syntax-Änderungen

Prüfung auf DSP-10

• GitLab: Im Pipeline-Feld die Aktion "dev_deploy" starten (siehe Abbildung 3)
• Metadatenprofil auf DSP-10 bzgl. Funktionalität prüfen
  • Notwendig: Zugriff via Uni-Netzwerk (ggf. Sicherheitshinweis des Browser ignorieren)
  • Einloggen auf DSP-10 mit ORCiD
  • Bei der ersten Metadatenprofil-Prüfung, Projekt erstellen, welches bei weiteren Prüfungen nachgenutzt werden kann
  • Dem Projekt eine Linked Data Resource hinzufügen
  • Unter Schritt 2 der Linked Data Ressourcenerstellung das zu prüfende Metadatenprofil auswählen
  • Prüfen, ob das Metadatenprofil und alle Felder korrekt angezeigt werden
  • Resource erstellen und Metadatenprofil in der Resource prüfen (ggf werden hier Validierungsprobleme und Bugs erst deutlich)
  • Prüfung Ok?
    • Informieren Sie das Coscine Dev Team mit einem "@" in einem GitLab-Kommentar unter der Merge-Anfrage, um sie auf LIVE zu stellen
    • Merge request bearbeiten und das Label Tested on D-SP10 hinzufügen
    • IT-ServiceDesk-Ticket schließen sobald der Merge request gemerged wurde
  • Fehler/Unklarheiten? Siehe Syntax-Änderungen

Abbildung 3 - Deployment eines Metadatenprofils auf DSP-10

Syntax-Änderungen

• siehe zuerst häufige Probleme
• Austausch bzgl. nächster Schritte mit Coscine Dev Team über GitLab-Kommentar
• Eröffnen eines Issue in Coscine (Label: Metadata Profile)
• Notwendige Änderungen beschreiben und Coscine Dev Team beauftragen (hinzufügen von Assignees)
• Verfolgen des Issue (Notifications aktivieren)
• Kommunikation bzgl. Status mit Ersteller*in über ServiceDesk/GitLab
• Nach erfolgreichen Änderungen fahren Sie mit dem jeweiligen Prüfungsschritt fort

Häufige Probleme

• Profil wird in DSP-10 nicht angezeigt
  • Base URL fehlt (siehe Zeile 1 in diesem Beispiel und füge die entsprechende URL hinzu)
  • Sicher gehen dass die Base URL zu der URL weiter unten (Zeile 16 im Beispiel) passt
• Felder scheinen 'verlinkt' (Eingabe in einem Feld erscheint auch in einem anderen Feld)
  • hier wurde derselbe Term bei beiden Feldern benutzt, was jedoch bei Coscine nicht unterstützt wird
  • oft reicht ein Feld, für das mehrere Eingaben möglich sind (Rücksprache mit Submitter halten)

Benachrichtigung: Erfolgreicher Merge Request

• Nutzende über erfolgreichen Merge Request wenn möglich via GitLab oder via E-Mail/Service Ticket informieren

E-Mail Template

Dear Titel + Name + Surname,

Your metadata profile "name of the metadata profile" has been successfully merged. You can now use it when creating resources in your Coscine project.

Best regards,

The Coscine Team

Log in directly to Coscine (https://coscine.rwth-aachen.de/) and use the storage space. For more information, please visit our Coscine documentation (https://docs.coscine.de/).

Your questions are not answered on our documentation and FAQ pages (https://www.coscine.de/faq/)? Then feel free to contact us. Your request will then be forwarded to the Coscine team accordingly.

For regular updates on new features and further developments, please subscribe to our Coscine mailing list: https://lists.rwth-aachen.de/postorius/lists/coscine.lists.rwth-aachen.de/.