Anleitung Test re³gistry 2.6

Diese Seite dient der Dokumentation aller Anleitungen die im Rahmen des Testens der Re³gistry Migration erstellt werden. Weiterhin werden hier auch externe Quellen, die diesen Prozess unterstützen referenziert.

Die Tickets, die zu Issues im Rahmen des Testens entstehen, werden unter https://redmine.gdi-de.org/projects/test-re3gistry-migration-v2-x gesammelt.

Anmeldung

Anmeldung Backend re³gistry: https://test.registry.gdi-de.org/codelist/backend
1. basic auth Anmeldung User: bkg Pwd: jrc9001!
2. backend Anmeldung mit über eigenes LogIn mit Email und Pwd
  1. Passwort zurücksetzen: https://test.registry.gdi-de.org/codelist/resetPassword

Einleitung zur re³gistry Oberfläche

Je nachdem welche Berechtigungen vorliegen wird die Menüstruktur verändert dargestellt:

Home und Content sind für jeden Nutzer verfügbar. Alle weiteren Tabs sind von den User-Rechten abhängig.

Home

Die Seite zeigt eine Übersicht über die letzten Änderungen, Bearbeitungen, Aktionen, die ausgeführt wurden bzw. die noch ausstehen.

Content

Diese Seite erlaubt mit dem Inhalt der re³gistry zu arbeiten.

Auf der Content-Seite kann nach Inhalten über eine Filterfunktion gesucht werden. Das Bearbeiten der Register und das Neuanlegen ist eine Funktionalität, die nur für submitting organisations und registry manager verfügbar ist.

Funktion Add register

Über +Add register kann ein neues Register hinzugefügt werden. Es erscheint eine neue Seite, die Sie auffordert, die Informationsfelder des neuen Registers auszufüllen. Eine erste Liste von Standardfeldern wird mit dem neu erstellten Register verknüpft. Um Felder hinzuzufügen oder bereits vorhandene Felder anzupassen müssen unter Structure die Felder angepasst werden.

Das Hinzufügen eines neuen Registers innerhalb des Registers kann ausschließlich von einem Benutzer mit der Rolle des registry manager vorgenommen werden. Diese Änderungen müssen nicht den Workflow durchlaufen.

Structure

Hinter dem Tab Structure verbirgt sich das Structure und Management des Datenmodells der einzelnen Register. Auf der Hauptseite des Tabs structure findet man die Liste der verfügbaren content Klassen. Diese werden automatisch beim Anlegen eines neuen Registers erstellt. Über vordefinierte Actions können die Eintragungen bearbeitet werden.

Beim Klicken auf den Namen der content Klasse oder auf das „Auge“-Symbol, öffnet sich die Seite zur Verwaltung der Felder, auf der die Liste der mit der ausgewählten Inhaltsklasse verbundenen Felder angezeigt wird.

Verwaltung der content Felder

Auf der Seite zur Verwaltung der Felder kann die Spalte Display Order per drag and drop in der Reihenfolge verändert werden.

Auch die Felder mit den Eigenschaften können hier (nachträglich) angepasst werden.

Felder Eigenschaften

Is hyperlinked

Wenn dieses Kästchen angekreuzt ist, weiß das System, dass das Feld mit einem Hyperlink versehen werden muss.
Wenn das Feld angekreuzt ist, müssen zwei Felder ausgefüllt werden: die Label und die URL.
Diese Eigenschaft ist nur für die Felder vom Typ Text oder Langtext verfügbar.

Hidden

Wenn das Feld angekreuzt ist, wird das Feld in der öffentlichen Schnittstelle ausgeblendet. Diese Eigenschaft ist nützlich, wenn Informationen, die sich auf einen Referenzcode (oder ein Register) beziehen, gespeichert werden sollen, aber privat bleiben müssen.

Multivalued

Wenn diese Eigenschaft aktiviert ist, können mehrere Werte für dasselbe Feld angegeben werden.

Required

Diese Eigenschaft legt fest, ob das Feld obligatorisch sein soll oder nicht. Wenn sie markiert ist, müssen die entsprechenden Felder ausgefüllt werden.

Show in table

Mit dieser Eigenschaft können Sie festlegen, ob das Feld in der Übersichtstabelle sichtbar sein soll.

Diese Eigenschaft ist für Register und die Registratur nicht verfügbar.

Neue Felder

Für jede Content Klasse können weitere Felder definiert werden. Hierbei kann ein neues Feld angelegt oder ein bestehendes verwendet werden.

Sofern ein neues Feld angelegt werden sollte, müssen folgende Felder gefüllt werden:

Local ID = eindeutiger Bezeichner

Label in the master language = Bezeichnung in der Systemsprache (Rückfallsprache der Anwendung)

Field type = Der Typ aus der Dropdownliste

Text mit max. 1024 Zeichen
Long Text, Text mit mehr als 1014 Zeichen
Date
Number, numerische Werte

Content class reference = mit diesem Feldtyp kann der Benutzer einen Referenzcode in einem Register x verknüpfen, der auf einen anderen Referenzcode in einem Register y verweist

Schritt für Schritt-Anleitung für was???

Anlegen eines Registers

Schritt 1: Gehe auf die registry Seite und klicke auf die Schaltfläche „Add register“.

Schritt 2: Füge die Registerangaben hinzu und klicke auf "Save"

2.1 Nun sehen Sie das neu erstellte Register in der Tabelle „New item proposed“

2.2 Gehen Sie zum Menüreiter „Registry Manager“ und „publish“ die Aktion, die das neu erstellte Register enthält

2.3 Gehen Sie zum Menüreiter „Structure“

In diesem Moment können nur die register items hinzugefügt werden (z. B. Codelist unter Verwendung der INSPIRE-Registerbegriffe)

Register items hinzufügen

2.4. Sie können die Registereinträge über die Schnittstelle hinzufügen, indem Sie auf „Add Item“ klicken oder einen „Bulk import“ durchführen.

Add item

Unten sehen Sie die addition eines einzelnen items über die Schnittstelle:

Klicken Sie dann auf „save“ und folgen Sie dem gesamten workflow, um das item zu veröffentlichen.

hierarchisches item

2.5 Nehmen wir an, ich möchte ein weiteres item erstellen. Aber ich möchte, dass dieses item als übergeordnetes (partent) item das item hat, das ich zuvor erstellt habe.

Dazu gehe ich in structure und füge in der reg_itemclass „PGTestRegistry-Item“ ein Feld „parent“ ein. Gemäß ISO13195 muss ein übergeordnetes item die gleiche Elementklasse haben wie das untergeordnete (child) item .

2.6 „add field“ auswählen. Anschließend aus der Dropdown-Liste das übergeordnete Feld auswählen, um es mit dem itemclass „PGTestRegistry-Item“ zu verknüpfen

Jetzt zur strucure dieser itemclass zurückkehren und wählen, ob diese in der Tabelle anzeigt werden soll oder nicht. Zu Empfehlen ist, das Kästchen anzukreuzen, um es in der Tabelle anzuzeigen.

Massenimport

2.7 "Start bulk process" und danach bulk import auswählen

Anschließend das template file downloaden und ausfüllen.

Exemplarisch: BULK_IMport_values.csv

Prozess wird gestartet und nach erfolgreichen Upload erhalte ich den Hinweis auf der Website.

Nun muss nur noch dem workflow zur Veröffentlichung der items gefolgt werden.

Der übergeordnete Wert kann hier auch schon manuell ausgewählt bzw. dargestellt werden.

Schritt 3: Gehe nun zurück zu structure und füge eine untergeordnete Elementklasse für „PGTestRegistry-Item“ hinzu.

3.1 Füge local ID für die item class hinzu und speichere die Änderung und füge ein übergeordnetes Feld hinzu, wie wir es für „PGTestRegistry-Item“ getan haben.