==Bericht zum RDMO-Anwendertreffen AIP Potsdam (24.02.2020) ==
Gründung von RDMO als Open Source Project

Programm [[1]Link] (dort auch alle Slides vom Workshop)

==13:00 Vorstellungsrunde (alle)==

==13:15 Vortrag Datamanagement in Europe (E. Tóth-Czifra)==
https://rdmorganiser.github.io/docs/2020-02-24-EU-RDM.pdf

==13:45 NFDI: Status (H. Enke)==
https://rdmorganiser.github.io/docs/2020-02-24-RDMO_NFDI.pdf

==14:00 Kurze Reports: RDMO-Anwender*innen==
* G. Jagusch RDMO mit Mandantenfähigkeit: Erfahrungen aus Provider-Sicht
https://rdmorganiser.github.io/docs/2020-02-24-RDMO_Darmstadt.pdf

* B. Lindstedt: RDMO4Life als projektbegleitendes DMP-Tool in den Lebenswissenschaften
https://rdmorganiser.github.io/docs/2020-02-24-RDMO4Life_Community-Treffen.pdf

*R. Strötgen: RDMO und Shibboleth
https://rdmorganiser.github.io/docs/2020-02-24-rdmo-shibboleth.pdf

*H. Krockauer: Import von Information aus Drittsystemen in Projekte in RDMO
https://rdmorganiser.github.io/docs/2020-02-24-RDMO-mediator.pdf

==15:00 RDMO Community Versammlung==
Vorstellung Manifest & Governance Struktur durch Harry Enke
Diskussion: (Stichpunkte)

Manifest ist Startpunkt für die erste Phase, kann die notwendigen Transformationen initiieren und leiten. In der kommenden Phase ist auch weiter zu klären, wie ein institutionelles Commitment solidifiziert werden kann. Von Seiten des RDMO-DFG-Projekts wurde die Mitarbeit für die Laufzeit zugesichert, von einzelnen auch darüber hinaus.
Es muss ergänzt werden durch Organisierung der verschiedenen Arbeitsgebiete: Neben den im Manifest genannten Gruppen (Steuerung/Governance und Software) ist eine Content-Maintenance Gruppe (Fragenkataloge, Templates) nötig,

* Grobe Arbeitsteilung zwischen den Gruppen:

* Steuerungsgruppe:
** Governance-Strukturen weiter ausarbeiten
** Fragen von Releasemanagement und Updates (Nachführung der Software bei neue Django-Python Releases) klären und mit Software-Gruppe koordinieren
** Community-Events, -Treffen und Partizipation an relevanten Veranstaltungen

* Software-Gruppe:
** Releases, Code-Entwicklung, Maintenance organisieren
** Content-Maintenance-Gruppe:
** Moderation von Fragebogenentwicklung
** Domänen-Anpassungen

* Folgende Teilnehmenden wurden per Akklamation für die Gruppen bestimmt, um den Transformationsprozess für 1 Jahr weiterzutreiben:

* Steuerungsgruppe:
** Harry Enke (AIP)
** Robert Strötgen (UB TU Braunschweig)
** Johannes Frenzel (RUB)
** Gerald Jagusch (ULB Darmstadt)
** Birte Lindstädt (ZBMed)
** Daniela Hausen (UB RWTH Aachen)
** (Heike Görzig, HZB)

* Software-Gruppe:
** Jochen Klar (selbstständiger Berater)
** Olaf Michaelis (AIP)
** Robert Ulrich (KIT)

* Content-Gruppe
** Kerstin Wedlich-Zachodin (KIT)
** Matthias Fingerhuth
** N.N. (HeFDI)
** Heike Görzig (HZB)
** Ulrike Wuttke (FHP)

==16:00 Breakout-Sessions (Steuerungsgruppe, Software-Gruppe, Content-Gruppe)==
Anm.: Die Zusammenfassungen und Aufgabenlisten sind als Erinnerungs-Hilfen der Diskussionen zu verstehen. Die Festlegungen zu Themen und Arbeitsaufgaben der Gruppen treffen diese selbst.

==17:17 Berichte aus den Breakout-Sessions==

==Bericht Treffen Steuerungsgruppe==

Die Breakout-Session hat die Diskussion des Plenums weitergeführt. Für das MoU-Konzept wurde festgestellt, dass es klarer ausgearbeitet werden muss, aber ein im Moment möglicher Weg für ein Commitment von Einrichtungen sein kann.
Weitere Punkte im Arbeitsprogramm der StG sind auch Festlegungen, wie sich Commitment und Einfluss auf Entscheidungsprozesse zueinander verhalten.
Rechts-Probleme sind dabei mit einzubeziehen.
Zu In-Kind-Contributions wurde gesagt, dass diese auch jetzt möglich sind, für ein Poolen von solchen Contributions muss noch weiter an einer Lösung gearbeitet werden.
Die StG von RDMO will das Networking mit verschiedenen Institutionen, Organisationen und Zusammenschlüssen auf den weg bringen. Hierzu gehören v.a. auch die NFDI-Konsortien und andere Gruppen (z.B. im RDA-Kontext).
Die Aufgaben der StG sind: Roadmap entwerfen und Governance etablieren.

*Als Sprecher*innen wurden G. Jagusch, H. Enke per Akklamation bestimmt.

* Aufgabenliste für die kommenden Monate:
** Roadmap entwerfen
** Manifest präzisieren

* Governance
** Entscheidungsprozesse formalisieren
** Koordination der Anwender, Organisation, Kommunikationsprozesse
** ein MoU entwerfen, dass unterzeichnet werden kann von Institutionen
** Klärung von In-Kind-Contributions
** Networking mit NFDI-Konsortien und Gruppen etc.

==Bericht Treffen Software-Gruppe==

Im ersten Treffen der Software-Gruppe wurde zunächst Jochen Klar zum Sprecher der Gruppe bestimmt. Die bisherigen Arbeitsabläufe auf GitHub und Slack funktionieren und sollen so weitergeführt werden. Die Arbeit mit GitHub Issues soll ausgebaut werden. Zentral für den Erfolg von RDMO wird die gute Zusammenarbeit mit der Steuerungsgruppe angesehen. Um die Arbeit in der Gruppe und am Code auch adäquat zu würdigen, sollen die Mitglieder der Gruppe auch auf der RDMO Webseite aufgeführt werden. Eine Idee um den technischen Support um RDMO zu verbessern, ist die Einrichtung eines festen monatlichen Termins an dem die RDMO Entwickler*innen in einer Videokonferenz ansprechbar sind, eine Art Sprechstunde.

* Sprecher*innen, Arbeitsmodus
** Jochen Sprecher
** Gruppenmitglieder auf RDMO webseite featuren
** Slack für Kommunikation
** Code Quality
** Zusammenarbeitsworkflow mit Steuerungsgruppe
** GitHub Issues nutzen, nur E-Mail und Slack reicht nicht aus um zu organisieren, auch nicht in Richtung Steuerungsgruppe
** monatlichen Termin "Sprechstunde"

==Bericht Treffen Content-Gruppe==

Die Content & Community Gruppe wurde auf Wunsch aus dem Plenum zusätzlich eingerichtet, um sich Fragen zum gemeinsamen Vorantreiben der Entwicklungen bezüglich Fragebögen und Metadaten zu widmen. Ein wichtiges Thema des ersten Treffens der Gruppe war der Erfahrungsaustausch zum Thema “Mapping RDMO zu DataCite” sowie “Mapping RDMO zu maDMP”. Eine zentrale Aufgabe ist in Zukunft die Definition eines Workflows und Austauschs, der einen “Wildwuchs” von RDMO-Attributen entgegenwirkt, um die Interoperabilität zu sichern. Überlegungen waren u. a. die zentrale Bereitstellung einer Übersicht aller existierender RDMO-Attribute (Tabellenformat mit Filter) bzw. die Schaffung eines “Attribut-Review-Workflows”, um festzulegen, welche neuen Attribute in das zentrale RDMO-Datenmodell übernommen werden sollen (im Sinne einer Quality Assurance) sowie eine Warnung, dass neue Attribute ggf. nicht mappen. Hierfür muss ein Abstimmungsworkflow mit der Steuerungsgruppe definiert werden. Eine Empfehlung für DataCite-kompatible RDMO-Attribute (ggf. maDMP-kompatible) ist vorgesehen. Auch wurde der Bedarf für die zentrale Bereitstellung eines H2020-Fragenkatalogs für RDMO diskutiert (momentan existiert nur eine H2020-Sicht, die für Forschende verwirrend ist, da sie nicht von Anfang an sehen, welche Fragen zu beantworten sind). Als Möglichkeit zur Verbesserung der Benutzerfreundlichkeit wurde die weitere Überarbeitung der kontextsensitiven Hilfetexte genannt, wobei hier zu beachten ist, dass inzwischen viele Instanzen eigene Fragenkataloge haben. Weiterhin sollten die Fragenkataloge der Förderer möglichst kompatibel zueinander sein.
Heike Görzig vom HZB berichtete außerdem über Erfahrungswerte, wie dort RDMO als Reporting-Tool eingesetzt wird, z. B. zur Planung von Speicherplatz. Des Weiteren wurden die Bestrebungen bekräftigt, zentral RDMO-Fragenkataloge einzusammeln (insbesondere disziplinspezifische Bündelungen), um sie über GitHub der RDMO-Community zur Verfügung zu stellen. Für die Einsammlung verantwortlich ist Olaf Michaelis.

* Sprecherin, Arbeitsmodus:
** Sprecherin: Kerstin Zedlich-Wachodin (KIT)
** Arbeitsmodus: als Kommunikationsweg wurde pull request für entsprechende “issues” vorgeschlagen

==Abschlussdiskussion & Zusammenfassung==
Jens L.: Vorschlag noch einen Workshop zu machen vor Projektende (Spätsommer, nach GWK Beschluss) , könnte der 4. Community Workshop sein

2019-04-23T10:12:38Z

Omichaelis: /* Welche Dokumentation existiert für RDMO? */

= Frequently asked questions =

Diese Seite enthält häufig gestellte Fragen über den Research Data Management Organiser (RDMO).

== Grundlagen ==

=== Was ist ein (Forschungs-)Datenmanagementplan? ===

Ein (Forschungs-)Datenmanagementplan, kurz DMP, ist ein formales Dokument aus dem hervorgeht welche Daten während eines Projekts verwendet und erhoben werden und wie mit diesen während und nach dem Projekt umgegangen wird. Wichtige Aspekte sind hierbeit u.a. Sicherheit, Nachnutzbarkeit und Langzeitarchivierung. Der Plan hilft dabei dem Ersteller strukturierter sein Projektvorhaben anzugehen und seine Daten im Idealfall besser zu dokumentieren. Außerdem verlangen immer mehr Förderer nach einem Datenmnagementplan bei der Projektantagsstellung.

=== Was ist RDMO? ===

Der Research Data Management Organiser, kurz RDMO, ist eine webbasiertes Software zur Erstellung von interaktiven Datenmanagementplänen für Institutionen und Forschende. Dies hilft beim Planen von Projekten und dem Verwalten von Datenmanagementaufgaben über den gesamten Datenlebenszyklus.
Nach dem Anmelden und Log-In können Forschende einen Fragenkatalog zu ihrem im Projekt zu erzeugenden und genutzen Daten beantworten. Dies ist besonders für die Projektantragsstellung bei einigen Fördern wichtig.

RDMO ist das Produkt eines DFG-geförderten Projekts, welches sich in zwei Phasen aufteilt. Die erste Projektphase verlief von November 2015 bis April 2017. Die zweite Projektphase läuft von November 2017 bis April 2020. RDMO wird vom Projektteam stetig verbessert.

RDMO besitzt eine eigene Webseite: [http://www.rdmorganiser.github.io] und wird ist freie Software unter [http://www.github.com|GitHub] veröffentlicht.

=== Kostet RDMO etwas? ===

Nein, RDMO ist als freie Software unter GitHub verfügbar [http://www.github.com|GitHub]. RDMO sollte auf einen Server des Instituts installiert werden und kann dann von allen zugehörigen Mitarbeitern und Forschenden kostenlos genutzt werden.

=== Auf welchen Betriebssystemen läuft RDMO? ===

Für Demonstrations-, Entwicklungs- oder Testzwecke kann RDMO auf Linux, Windows und macOS installiert werden. Falls Sie jedoch eine Produktionsumgebung aufsetzen möchten, RDMO über ein Netzwerk oder das Internet anbieten möchten, dann empfehlen wir sehr eine aktuelle Linux-Version, namentlich CentOS7, Debian 8 oder 9, oder Ubuntu 16.04.3 LTS (Xenial Xerus) zu verwenden.

=== Welche ist die aktuelle Version von RDMO? ===

Die aktuelle Version von RDMO finden Sie unter [http://www.github.com/rdmorganiser/rdmo/releases]. RDMO kann problemlos installiert und genutzt werden. Wir werden versuchen zeitnah eine Version 1.0.0 zu veröffentlichen.

=== Welche Dokumentation existiert für RDMO? ===

Eine gesamte Dokumentation für die Installation und Verwendung von RDMO finden Sie unter [https://rdmo.readthedocs.io/de/latest/index.html].
Unter [[RDMO]] finden Sie außerdem Tutorials zu spezifischen Anwendungen.

=== Welche Mailingslisten existieren für RDMO? ===

Für die allgemeine Mailingliste für RDMO können sie sich über folgenden Link anmelden: rdmo@listserv.dfn.de
Über die interne Mailingliste vom RDMO-Team können Sie direkt Fragen an das Team stellen: rdmo-team@listserv.dfn.de

=== Wie kann ich zu RDMO beitragen? ===

Der Code von RDMO ist auf [http://www.github.com|GitHub] veröffentlicht und somit können Sie den Code auch selbst ändern. Sie können außerdem sogenannte "Issues" erstellen, wenn Sie neue Probleme identifieziert haben, die gelöst werden müssen: [https://github.com/rdmorganiser/rdmo/issues]. Sie können selbstverständlich auch bereits bestehende Probleme beheben.
Für Verbesserungen der Dokumentation können Sie sich hier bei forschungsdaten.org registrieren und frei editieren.
Falls Sie auf einem anderen Weg etwas zu RDMO beitragen wollen, kontaktieren Sie uns: rdmo-team@listserv.dfn.de

== Für Nutzer ==

=== Gibt es eine Schnellstartanleitung für RDMO? ===

Ja, diese finden Sie hier: [https://rdmorganiser.github.io/docs/Schnellstartanleitung.pdf]

=== Wo finde ich RDMO? ===

Informieren Sie sich bitte bei den Zuständigen ihres Instituts für Datenmanagement(pläne), ob es an ihrem Institut eine eigene RMDO-Instanz gibt oder ob Sie eine andere nutzen dürfen.

=== Wie logge ich mich bei RDMO ein? ===

Für gewöhnlich können Sie ihre Zugangsdaten von ihrem Institut verwenden, um sich bei RDMO einzuloggen. Fragen Sie bitte bei den Zuständigen ihres Instituts für Datenmanagement(pläne) nach.

=== Gibt es Beispielpläne? ===

Nein, derzeit gibt es von uns keine ausgefüllten Beispielpläne. Eine Übersicht der Fragen unseres generischen Fragenkataloges finden Sie hier: [https://rdmorganiser.github.io/docs/RDMO-Fragenkatalog_nummeriert.pdf].

=== Wie lange werden meine Pläne gespeichert? ===

Es ist nicht vorgesehen, dass Datenmanagementpläne von anderen gelöscht werden. Sie können Sie selbst löschen, indem sie auf ihrer Startseite mit der Übersicht ihrer Projekte (also Pläne) auf fas Lösch-Smbol des entsprechenden Projektes klicken. Dieser Vorgang ist nicht umkehrbar!

=== Was ist, wenn ich zu einem anderen Institut wechsele? ===

Derzeit sind die RDMO-Instanzen lokal und sie können sich mit ihren Zugangsdaten ihres Instituts anmelden. Dies schließt leider (bisher) die Mitnahme von Projekte zu einem anderen Institut aus.

=== Wie kann ich mit anderen Zusammen an einem Plan arbeiten? ===

Sie können als Besitzer eines Projekts bzw. Plans andere Teilnehmer, die ebenfalls bei RDMO registriert sind, hinzufügen. Dazu klicken Sie auf das entsprechende Projekt und dann können sie in der rechten Navigationsleiste ein ''Mitglieder hinzufügen''. sie müssen dann den Benutzernamen oder dessen E-Mail-Adresse eingeben und festlegen, ob dieser (Mit-)Besitzer werden soll oder einen anderen Status ("Rolle") mit anderen Rechten werden soll.

=== Wer kann mir an meinem Institut helfen? ===

Viele Universitäten und Institute haben mittlerweile eine oder mehere Personen, die für das Datenmanagement an ihrer Einrichtung zuständig sind. Erkundigen Sie sich auf der Internetseite ihres Instituts.

=== Wo fange ich an, nachdem ich mich eingeloggt habe? ===

Als Nutzer von RDMO werden Sie nach dem Login auf Ihrer Startseite mit Ihren Projekten landen. Zunächst ist diese Seite lehr. Sie müssen zunächst ein "Neues Projekt erstellen" und danach können sie den Fragenkatalog beantworten.

== Für Administratoren ==

=== Woher kann man RDMO beziehen? ===

RDMO wird als freie Software auf [http://www.github.com] angeboten. Das rdmo-app-Verzeichnis kann durch Klonen des entsprechenden Repositories erstellt werden.

=== Wie kann RDMO installiert werden? ===

Die Installationsanleitung finden Sie unter [https://rdmo.readthedocs.io/de/latest/installation/index.html].

=== Wo installiere ich RDMO? ===

Sie benötigen einen eigenen Server (beispielsweise an ihrer Universität oder Institut) auf dem sie RDMo installieren. Es exisitert derzeit keine allgemeine RDMO-Instanz, die für jeden zugänglich wäre, sondern nur institutsinterne Instanzen.

=== Was ist ein Fragenkatalog in RDMO? ===

Wenn man einen Datenmanagementplan erstellen möchte, ergeben sich die verschiedensten Fragen zu den Daten und deren Umgang. In einem Fragenkatalog sind diese Fragen in Untergruppen sortiert. Oft werden von den Förderern wie z.B. der EU mit H2020 eine Sammlung an Fragen vorgegeben, die beantwortet werden müssen für ein Projekt.

=== Welche Fragenkataloge exisiteren bereits? ===

Für RDMO existieren bereits verschiedene Fragenkataloge, die Sie in Ihre Instanz importieren können (z. B. der vom RDMO-Projekt erstellte ausführliche Fragenkatalog (RDMO) oder der Katalog für den Schweizer Nationsfonds (SNF)). Die existierenden Fragenkataloge sind auf Github bereitgestellt ([https://github.com/rdmorganiser/rdmo-catalog/tree/master/rdmorganiser/questions]). Es können jedoch neue Fragenkataloge erstellt werden. Oft bietet es sich auch an sogennante Ansichten (Views) zu erstellen, die nur einen Ausschnitt und/oder eine andere Reihenfolge der Fragen und deren Antworten in verschiedenen Exportformaten ausgibt.

=== Wie erstelle ich einen neuen Fragenkatalog? ===

Dazu gibt es ein Tutorial: [[Katalog_erstellen]]. Eine allgemeine Dokumentation findet sie unter [http://www.rdmo.readthedocs.io/de/latest/management/questions.html]. Generell kann ein Fragenkatlog komplett neu erstellt werden oder aber durch das Kopieren eines bereits vorhanden Fragenkataloges, der dann angepasst wird. Das kopieren eines Fragenkataloges ist derzeit noch nicht möglich, ist aber in Arbeit.

=== Wie exportiere ich eine Liste aller Fragen eines Fragenkatalogs? ===

Gehen Sie mit Managementrechten über den Menüpunkt "Management" auf die Ansicht der Fragenkataloge ("Fragen") und wählen Sie über das Drop-down-Menü unter dem Punkt "Katalog" auf der rechten Seite den gewünschten Fragenkatalog aus. Weiter unten stehen Ihnen unter dem Punkt "Export" verschiedenen Exportformate zur Verfügung. Klicken Sie auf das gewünschte Format. Ggf. können Sie die Ausgabe bearbeiten, da auch Hilfetexte mit ausgegeben werden.

=== Was ist eine Ansicht in RDMO? ===

Eine Ansicht oder auch View ist eine Vorlage, die bestimmt wie die vom Benutzer gegebenen Antworten auf ein Textdokument gemappt werden. Dies ermöglicht es aus dem umfangreichen Fragenkatalog nur bestimmte Fragen und deren Antworten zu extrahieren und ggf. eine andere Reihenfolge oder Layout zu bringen. Hierbei wird mit Variabeln und Tags gearbeitet.

=== Welche Ansichten exisiteren bereits? ===

Derzeit existieren in RDMO aug GitHub sechs Ansichten, wobei diese teilweise nur der Demonstration dienen:
* Bielefeld - DMP Vorlage der Universität Bielefeld.
* CITEC DMP - DMP Vorlage der Universität Bielefeld für CITEC geförderte Projekte.
* DMPonline template - Vorlage von DMPonline, Online: https://dmponline.dcc.ac.uk
* DMPTool template - Vorlage von DMPtool, basiert auf on "NSF-GEN: Generic", Online: https://dmptool.org
* Horizon 2020 FAIR Data Management Plan template - Vorlage für Horizon 2020, aus "Guidelines on FAIR Data Management in Horizon 2020"
* SNF Vorlage - DMP für die SNF (Schweiz)

=== Wie erstelle ich eine neue Ansicht? ===

Dazu gibt es ein Tutorial dazu: [[Ansicht_erstellen]]. Eine allgemeine Dokuemntation findet Sie unter [http://www.rdmo.readthedocs.io/de/latest/management/views.html]

=== Wie ist das Rollenkonzept in RDMO zu verstehen? ===

Wenn Sie ein neues Projekt anlegen, dann sind sie automatisch der ''Besitzer'' dieses Projektes und Sie haben alle Rechte einschließlich das Löschen eines Projekts. Sie können weitere Mitglieder zu dem Projekt einladen und müssen ihnen eine Rolle zuweisen. Diese Rollen sind derzeit:
* '''Besitzern''': hat alle Rechte.
* '''Manager''': hat alle Rechte außer das Löschen eines Projekts. Er kann Snapshots erstellen und Veränderungen vornehmen.
* '''Autor''': hat Lese- und Schreibrichte.
* '''Gast''': hat nur Leserechte

=== Welche Benutzergruppen gibt es? ===

Die Benutzergruppen sind unter [http://rdmo.readthedocs.io/de/latest/administration/users.html] dokumentiert. Es gibt vier Benutzergruppen mit unterschiedlichen Rechten:
* Editor - Zugriff auf das Mangement-Interface und das Recht das Datenmodel zu ändern
* Reviewer - Zugriff auf das Management-Inteface, aber kein Recht etwas zu ändern
* API - können mit einer programmierbaren API auf alles Elemente des Datenmodels zugreifen
* Superuser - hat alle Rechte

=== Ist RDMO mandatenfähig? ===

Nein, RDMO ist (bisher) nicht mandantenfähig. Dies würde bedeuten, dass auf demselben Server eine RDMO-Instanz mehrere Mandanten (Kunden oder Auftraggeber) unabhängig voneinander bedient. Dies ist nicht möglich, aber es spricht nichts dagegen mehrere RDMO-Instanzen auf einen Server zu installieren.

=== Wo nehme ich welche Einstellungen vor? ===

Als Administrator sind für Sie vor allem zwei Seiten wichtig: das Management-Menü und das Admin-Menü.
Das Management-Menü dient dazu neue Fragenkataloge und alles was damit zu tun hat zu erstellen und anzupasssen. Die Untermenüs sind Domäne, Optionen, Bedingungen, Fragen, Aufgaben, Ansichten.
Über das Admin-Menü werden v.a. die Nutzer, deren Rechte, Nutzerkonten, der Auth Token und der Domainname verwaltet. Auch hier können wie im Managemnt-Menü die Domäne und alles rund um die Fragen verwaltet werden.

== Fehlermeldungen ==

=== Ich habe einen Fehler gefunden. Wie gehe ich jetzt vor? ===

Wenn Sie den gefunden Fehler haben, den Sie nicht selbst beheben können, dann überprüfen Sie zunächst, ob der Fehler bereits hier auf der Webseite beschrieben ist. Falls nicht, dann gehen Sie bitte auf die "Issue"-Seite von GitHub: [https://github.com/rdmorganiser/rdmo/issues]. Dort sind alle aktuellen Fehlermeldungen (und Feature-Wünsche) gesammelt. Überpüfen Sie, ob Ihr Fehler bereits beschrieben ist und somit in der Bearbeitung ist. Falls nicht, dann eröffnen Sie bitte ein neues Issue und beschreiben Sie wann der Fehler aufgetreten ist. Nennen Sie die RDMO-Version und ggf. die Fehlermeldung.
Falls es sich um ein akutes Problem handelt, dass zeitnah behoben werden sollte, dürfen Sie gerne Hilfe über die Mailingliste anfragen oder sich direkt an das RDMO-Team wenden: rdmo-team@listserv.dfn.de .

=== Was bedeutet "dieses Feld wird benötigt?" ===
* Wenn Felder für die Parameter in den entsprechenden Fenstern nicht oder nicht richtig ausgefüllt wurden, gibt es Fehlermeldungen. Beispielsweise müssen die deutschen und englische Texte ausgefüllt werden („Text (en)“ und „Text (de)“), wohingegen die Hilfetexte („Hilfe (en)“ und „Hilfe (de)“) leer bleiben dürfen.

[[Datei:Notgiven.PNG|700px|none]]

=== Was bedeutet das rote Dreieck rechts im Panel einer Entität oder eines Attributs? ===
* Falsch gesetzte Entitäten oder Attribute werden durch ein rotes Dreieck in der entsprechenden Leiste der Frage, etc. angezeigt:
[[Datei:Error.PNG|700px|none]]

=== Die Antwort in der angewendeten Ansicht (View) ist leer, obwohl die Frage beantwortet wurde? Was habe ich falsch gemacht? ===

Bitte beachten Sie, dass sie stehts "values"+den Pfad des Attributes oder der Entität angeben müssen, wobei die Schrägstriche durch Punkte ersetzt werden. Ledeglich wenn durch eine <code>for</code>-Schleife dieser Pfad (teilweise) ersetzt wird, reicht die verkürzende, neue Variable aus:

<pre>
{% for dataset in values.project.dataset %}
Datensatz {{ dataset.id }}:
Volumen: {{dataset.size.volume}}
{% endfor %}
</pre>

In diesem Fall ersetzt "dataset" nach dem <code>for</code> das "values.project.dataset", so dass innerhalb der Schleife nur "dataset.size.volume" geschrieben werden muss anstatt "values.project.dataset.size.volume".

=== Was bedeutet "Unclosed tag on line ..." in der Ansicht (View)? ===

Wenn sie ihre Eintragen (zwischen)speichern und dabei eine Fehlermeldung wie folgt erhalten:

[[Datei:FehlermeldungAnsicht.PNG|800px|none]]

Dann bedeutet dies, dass sie <nowiki>{% endfor %}</nowiki> vergessen haben, welches eine for-Schleife schließt. solche syntaktischen Fehler werden Ihnen angezeigt.
Ob die benutzten Variabeln richtig aufgeschlüsselt werden, sehen sie in dem Code-Eingabefenster jedoch nicht. Erst wenn sie die Ansicht innerhalb ihres Projekts aufrufen, werden sie Fehler feststellen können. Es werden dann Einträge fehlen doer falsch dargestellt sein. Überprüfen Sie in solch einem Fall die richtige Angabe ihrer Variabeln.

=== Wieso funktioniert der Import über den Hochlade-Button meiner xml-Datei nicht? ===

Überprüfen Sie, dass ihre xml-Datei wirklich eine xml- und keine html-Datei ist. Auf der GitHub-Seite des rdmo-catalog [http://github.com/rdmorganiser/rdmo-catalog] befindet sich eine Liste von xml-Dateien. Klicken Sie oben rechts auf den grünen Button "Clone or download", um die Dateien auf ihren Rechner zu kopieren. Wenn sie jedoch auf eine einzelne xml-Datei einen Rechtsklick machen und "Speichern unter" wählen, dann wird diese Datei als html-Datei gespeichert und von RDMO als nicht passend bewertet. Achten sie also darauf, dass ihre xml-Datei korrekt ist.

Ein anderes Problem kann sein, dass sie versuchen in dem falschen Untermenü ihre xml-Datei hochzuladen. Die Datei domain.xml beispielsweise muss unter dem Reiter "Domäne" hochgeladen werden. Ebenso müssen Fragenktaloge unter "Fragen" hochgeladen werden, etc.

RDMO FAQ

2019-04-23T09:58:01Z

Omichaelis: /* Welche Ansichten exisiteren bereits? */

= Frequently asked questions =

Diese Seite enthält häufig gestellte Fragen über den Research Data Management Organiser (RDMO).

== Grundlagen ==

=== Was ist ein (Forschungs-)Datenmanagementplan? ===

Ein (Forschungs-)Datenmanagementplan, kurz DMP, ist ein formales Dokument aus dem hervorgeht welche Daten während eines Projekts verwendet und erhoben werden und wie mit diesen während und nach dem Projekt umgegangen wird. Wichtige Aspekte sind hierbeit u.a. Sicherheit, Nachnutzbarkeit und Langzeitarchivierung. Der Plan hilft dabei dem Ersteller strukturierter sein Projektvorhaben anzugehen und seine Daten im Idealfall besser zu dokumentieren. Außerdem verlangen immer mehr Förderer nach einem Datenmnagementplan bei der Projektantagsstellung.

=== Was ist RDMO? ===

Der Research Data Management Organiser, kurz RDMO, ist eine webbasiertes Software zur Erstellung von interaktiven Datenmanagementplänen für Institutionen und Forschende. Dies hilft beim Planen von Projekten und dem Verwalten von Datenmanagementaufgaben über den gesamten Datenlebenszyklus.
Nach dem Anmelden und Log-In können Forschende einen Fragenkatalog zu ihrem im Projekt zu erzeugenden und genutzen Daten beantworten. Dies ist besonders für die Projektantragsstellung bei einigen Fördern wichtig.

RDMO ist das Produkt eines DFG-geförderten Projekts, welches sich in zwei Phasen aufteilt. Die erste Projektphase verlief von November 2015 bis April 2017. Die zweite Projektphase läuft von November 2017 bis April 2020. RDMO wird vom Projektteam stetig verbessert.

RDMO besitzt eine eigene Webseite: [http://www.rdmorganiser.github.io] und wird ist freie Software unter [http://www.github.com|GitHub] veröffentlicht.

=== Kostet RDMO etwas? ===

Nein, RDMO ist als freie Software unter GitHub verfügbar [http://www.github.com|GitHub]. RDMO sollte auf einen Server des Instituts installiert werden und kann dann von allen zugehörigen Mitarbeitern und Forschenden kostenlos genutzt werden.

=== Auf welchen Betriebssystemen läuft RDMO? ===

Für Demonstrations-, Entwicklungs- oder Testzwecke kann RDMO auf Linux, Windows und macOS installiert werden. Falls Sie jedoch eine Produktionsumgebung aufsetzen möchten, RDMO über ein Netzwerk oder das Internet anbieten möchten, dann empfehlen wir sehr eine aktuelle Linux-Version, namentlich CentOS7, Debian 8 oder 9, oder Ubuntu 16.04.3 LTS (Xenial Xerus) zu verwenden.

=== Welche ist die aktuelle Version von RDMO? ===

Die aktuelle Version von RDMO finden Sie unter [http://www.github.com/rdmorganiser/rdmo/releases]. RDMO kann problemlos installiert und genutzt werden. Wir werden versuchen zeitnah eine Version 1.0.0 zu veröffentlichen.

=== Welche Dokumentation existiert für RDMO? ===

Eine gesamte Dokumentation für die Installation und Verwendung von RDMO finden Sie unter [http://www.rdmo.readthedocs.io/de/latest/index.html].
Unter [[RDMO]] finden Sie außerdem Tutorials zu spezifischen Anwendungen.

=== Welche Mailingslisten existieren für RDMO? ===

Für die allgemeine Mailingliste für RDMO können sie sich über folgenden Link anmelden: rdmo@listserv.dfn.de
Über die interne Mailingliste vom RDMO-Team können Sie direkt Fragen an das Team stellen: rdmo-team@listserv.dfn.de

=== Wie kann ich zu RDMO beitragen? ===

Der Code von RDMO ist auf [http://www.github.com|GitHub] veröffentlicht und somit können Sie den Code auch selbst ändern. Sie können außerdem sogenannte "Issues" erstellen, wenn Sie neue Probleme identifieziert haben, die gelöst werden müssen: [https://github.com/rdmorganiser/rdmo/issues]. Sie können selbstverständlich auch bereits bestehende Probleme beheben.
Für Verbesserungen der Dokumentation können Sie sich hier bei forschungsdaten.org registrieren und frei editieren.
Falls Sie auf einem anderen Weg etwas zu RDMO beitragen wollen, kontaktieren Sie uns: rdmo-team@listserv.dfn.de

== Für Nutzer ==

=== Gibt es eine Schnellstartanleitung für RDMO? ===

Ja, diese finden Sie hier: [https://rdmorganiser.github.io/docs/Schnellstartanleitung.pdf]

=== Wo finde ich RDMO? ===

Informieren Sie sich bitte bei den Zuständigen ihres Instituts für Datenmanagement(pläne), ob es an ihrem Institut eine eigene RMDO-Instanz gibt oder ob Sie eine andere nutzen dürfen.

=== Wie logge ich mich bei RDMO ein? ===

Für gewöhnlich können Sie ihre Zugangsdaten von ihrem Institut verwenden, um sich bei RDMO einzuloggen. Fragen Sie bitte bei den Zuständigen ihres Instituts für Datenmanagement(pläne) nach.

=== Gibt es Beispielpläne? ===

Nein, derzeit gibt es von uns keine ausgefüllten Beispielpläne. Eine Übersicht der Fragen unseres generischen Fragenkataloges finden Sie hier: [https://rdmorganiser.github.io/docs/RDMO-Fragenkatalog_nummeriert.pdf].

=== Wie lange werden meine Pläne gespeichert? ===

Es ist nicht vorgesehen, dass Datenmanagementpläne von anderen gelöscht werden. Sie können Sie selbst löschen, indem sie auf ihrer Startseite mit der Übersicht ihrer Projekte (also Pläne) auf fas Lösch-Smbol des entsprechenden Projektes klicken. Dieser Vorgang ist nicht umkehrbar!

=== Was ist, wenn ich zu einem anderen Institut wechsele? ===

Derzeit sind die RDMO-Instanzen lokal und sie können sich mit ihren Zugangsdaten ihres Instituts anmelden. Dies schließt leider (bisher) die Mitnahme von Projekte zu einem anderen Institut aus.

=== Wie kann ich mit anderen Zusammen an einem Plan arbeiten? ===

Sie können als Besitzer eines Projekts bzw. Plans andere Teilnehmer, die ebenfalls bei RDMO registriert sind, hinzufügen. Dazu klicken Sie auf das entsprechende Projekt und dann können sie in der rechten Navigationsleiste ein ''Mitglieder hinzufügen''. sie müssen dann den Benutzernamen oder dessen E-Mail-Adresse eingeben und festlegen, ob dieser (Mit-)Besitzer werden soll oder einen anderen Status ("Rolle") mit anderen Rechten werden soll.

=== Wer kann mir an meinem Institut helfen? ===

Viele Universitäten und Institute haben mittlerweile eine oder mehere Personen, die für das Datenmanagement an ihrer Einrichtung zuständig sind. Erkundigen Sie sich auf der Internetseite ihres Instituts.

=== Wo fange ich an, nachdem ich mich eingeloggt habe? ===

Als Nutzer von RDMO werden Sie nach dem Login auf Ihrer Startseite mit Ihren Projekten landen. Zunächst ist diese Seite lehr. Sie müssen zunächst ein "Neues Projekt erstellen" und danach können sie den Fragenkatalog beantworten.

== Für Administratoren ==

=== Woher kann man RDMO beziehen? ===

RDMO wird als freie Software auf [http://www.github.com] angeboten. Das rdmo-app-Verzeichnis kann durch Klonen des entsprechenden Repositories erstellt werden.

=== Wie kann RDMO installiert werden? ===

Die Installationsanleitung finden Sie unter [http://www.rdmo.readthedocs.io/de/latest/installation/index.html].

=== Wo installiere ich RDMO? ===

Sie benötigen einen eigenen Server (beispielsweise an ihrer Universität oder Institut) auf dem sie RDMo installieren. Es exisitert derzeit keine allgemeine RDMO-Instanz, die für jeden zugänglich wäre, sondern nur institutsinterne Instanzen.

=== Was ist ein Fragenkatalog in RDMO? ===

Wenn man einen Datenmanagementplan erstellen möchte, ergeben sich die verschiedensten Fragen zu den Daten und deren Umgang. In einem Fragenkatalog sind diese Fragen in Untergruppen sortiert. Oft werden von den Förderern wie z.B. der EU mit H2020 eine Sammlung an Fragen vorgegeben, die beantwortet werden müssen für ein Projekt.

=== Welche Fragenkataloge exisiteren bereits? ===

Für RDMO existieren bereits verschiedene Fragenkataloge, die Sie in Ihre Instanz importieren können (z. B. der vom RDMO-Projekt erstellte ausführliche Fragenkatalog (RDMO) oder der Katalog für den Schweizer Nationsfonds (SNF)). Die existierenden Fragenkataloge sind auf Github bereitgestellt ([https://github.com/rdmorganiser/rdmo-catalog/tree/master/rdmorganiser/questions]). Es können jedoch neue Fragenkataloge erstellt werden. Oft bietet es sich auch an sogennante Ansichten (Views) zu erstellen, die nur einen Ausschnitt und/oder eine andere Reihenfolge der Fragen und deren Antworten in verschiedenen Exportformaten ausgibt.

=== Wie erstelle ich einen neuen Fragenkatalog? ===

Dazu gibt es ein Tutorial: [[Katalog_erstellen]]. Eine allgemeine Dokumentation findet sie unter [http://www.rdmo.readthedocs.io/de/latest/management/questions.html]. Generell kann ein Fragenkatlog komplett neu erstellt werden oder aber durch das Kopieren eines bereits vorhanden Fragenkataloges, der dann angepasst wird. Das kopieren eines Fragenkataloges ist derzeit noch nicht möglich, ist aber in Arbeit.

=== Was ist eine Ansicht in RDMO? ===

Eine Ansicht oder auch View ist eine Vorlage, die bestimmt wie die vom Benutzer gegebenen Antworten auf ein Textdokument gemappt werden. Dies ermöglicht es aus dem umfangreichen Fragenkatalog nur bestimmte Fragen und deren Antworten zu extrahieren und ggf. eine andere Reihenfolge oder Layout zu bringen. Hierbei wird mit Variabeln und Tags gearbeitet.

=== Welche Ansichten exisiteren bereits? ===

Derzeit existieren in RDMO aug GitHub sechs Ansichten, wobei diese teilweise nur der Demonstration dienen:
* Bielefeld - DMP Vorlage der Universität Bielefeld.
* CITEC DMP - DMP Vorlage der Universität Bielefeld für CITEC geförderte Projekte.
* DMPonline template - Vorlage von DMPonline, Online: https://dmponline.dcc.ac.uk
* DMPTool template - Vorlage von DMPtool, basiert auf on "NSF-GEN: Generic", Online: https://dmptool.org
* Horizon 2020 FAIR Data Management Plan template - Vorlage für Horizon 2020, aus "Guidelines on FAIR Data Management in Horizon 2020"
* SNF Vorlage - DMP für die SNF (Schweiz)

=== Wie erstelle ich eine neue Ansicht? ===

Dazu gibt es ein Tutorial dazu: [[Ansicht_erstellen]]. Eine allgemeine Dokuemntation findet Sie unter [http://www.rdmo.readthedocs.io/de/latest/management/views.html]

=== Wie ist das Rollenkonzept in RDMO zu verstehen? ===

Wenn Sie ein neues Projekt anlegen, dann sind sie automatisch der ''Besitzer'' dieses Projektes und Sie haben alle Rechte einschließlich das Löschen eines Projekts. Sie können weitere Mitglieder zu dem Projekt einladen und müssen ihnen eine Rolle zuweisen. Diese Rollen sind derzeit:
* '''Besitzern''': hat alle Rechte.
* '''Manager''': hat alle Rechte außer das Löschen eines Projekts. Er kann Snapshots erstellen und Veränderungen vornehmen.
* '''Autor''': hat Lese- und Schreibrichte.
* '''Gast''': hat nur Leserechte

=== Welche Benutzergruppen gibt es? ===

Die Benutzergruppen sind unter [http://rdmo.readthedocs.io/de/latest/administration/users.html] dokumentiert. Es gibt vier Benutzergruppen mit unterschiedlichen Rechten:
* Editor - Zugriff auf das Mangement-Interface und das Recht das Datenmodel zu ändern
* Reviewer - Zugriff auf das Management-Inteface, aber kein Recht etwas zu ändern
* API - können mit einer programmierbaren API auf alles Elemente des Datenmodels zugreifen
* Superuser - hat alle Rechte

=== Ist RDMO mandatenfähig? ===

Nein, RDMO ist (bisher) nicht mandantenfähig. Dies würde bedeuten, dass auf demselben Server eine RDMO-Instanz mehrere Mandanten (Kunden oder Auftraggeber) unabhängig voneinander bedient. Dies ist nicht möglich, aber es spricht nichts dagegen mehrere RDMO-Instanzen auf einen Server zu installieren.

=== Wo nehme ich welche Einstellungen vor? ===

Als Administrator sind für Sie vor allem zwei Seiten wichtig: das Management-Menü und das Admin-Menü.
Das Management-Menü dient dazu neue Fragenkataloge und alles was damit zu tun hat zu erstellen und anzupasssen. Die Untermenüs sind Domäne, Optionen, Bedingungen, Fragen, Aufgaben, Ansichten.
Über das Admin-Menü werden v.a. die Nutzer, deren Rechte, Nutzerkonten, der Auth Token und der Domainname verwaltet. Auch hier können wie im Managemnt-Menü die Domäne und alles rund um die Fragen verwaltet werden.

== Fehlermeldungen ==

=== Ich habe einen Fehler gefunden. Wie gehe ich jetzt vor? ===

Wenn Sie den gefunden Fehler haben, den Sie nicht selbst beheben können, dann überprüfen Sie zunächst, ob der Fehler bereits hier auf der Webseite beschrieben ist. Falls nicht, dann gehen Sie bitte auf die "Issue"-Seite von GitHub: [https://github.com/rdmorganiser/rdmo/issues]. Dort sind alle aktuellen Fehlermeldungen (und Feature-Wünsche) gesammelt. Überpüfen Sie, ob Ihr Fehler bereits beschrieben ist und somit in der Bearbeitung ist. Falls nicht, dann eröffnen Sie bitte ein neues Issue und beschreiben Sie wann der Fehler aufgetreten ist. Nennen Sie die RDMO-Version und ggf. die Fehlermeldung.
Falls es sich um ein akutes Problem handelt, dass zeitnah behoben werden sollte, dürfen Sie gerne Hilfe über die Mailingliste anfragen oder sich direkt an das RDMO-Team wenden: rdmo-team@listserv.dfn.de .

=== Was bedeutet "dieses Feld wird benötigt?" ===
* Wenn Felder für die Parameter in den entsprechenden Fenstern nicht oder nicht richtig ausgefüllt wurden, gibt es Fehlermeldungen. Beispielsweise müssen die deutschen und englische Texte ausgefüllt werden („Text (en)“ und „Text (de)“), wohingegen die Hilfetexte („Hilfe (en)“ und „Hilfe (de)“) leer bleiben dürfen.

[[Datei:Notgiven.PNG|700px|none]]

=== Was bedeutet das rote Dreieck rechts im Panel einer Entität oder eines Attributs? ===
* Falsch gesetzte Entitäten oder Attribute werden durch ein rotes Dreieck in der entsprechenden Leiste der Frage, etc. angezeigt:
[[Datei:Error.PNG|700px|none]]

=== Die Antwort in der angewendeten Ansicht (View) ist leer, obwohl die Frage beantwortet wurde? Was habe ich falsch gemacht? ===

Bitte beachten Sie, dass sie stehts "values"+den Pfad des Attributes oder der Entität angeben müssen, wobei die Schrägstriche durch Punkte ersetzt werden. Ledeglich wenn durch eine <code>for</code>-Schleife dieser Pfad (teilweise) ersetzt wird, reicht die verkürzende, neue Variable aus:

<pre>
{% for dataset in values.project.dataset %}
Datensatz {{ dataset.id }}:
Volumen: {{dataset.size.volume}}
{% endfor %}
</pre>

In diesem Fall ersetzt "dataset" nach dem <code>for</code> das "values.project.dataset", so dass innerhalb der Schleife nur "dataset.size.volume" geschrieben werden muss anstatt "values.project.dataset.size.volume".

=== Was bedeutet "Unclosed tag on line ..." in der Ansicht (View)? ===

Wenn sie ihre Eintragen (zwischen)speichern und dabei eine Fehlermeldung wie folgt erhalten:

[[Datei:FehlermeldungAnsicht.PNG|800px|none]]

Dann bedeutet dies, dass sie <nowiki>{% endfor %}</nowiki> vergessen haben, welches eine for-Schleife schließt. solche syntaktischen Fehler werden Ihnen angezeigt.
Ob die benutzten Variabeln richtig aufgeschlüsselt werden, sehen sie in dem Code-Eingabefenster jedoch nicht. Erst wenn sie die Ansicht innerhalb ihres Projekts aufrufen, werden sie Fehler feststellen können. Es werden dann Einträge fehlen doer falsch dargestellt sein. Überprüfen Sie in solch einem Fall die richtige Angabe ihrer Variabeln.

=== Wieso funktioniert der Import über den Hochlade-Button meiner xml-Datei nicht? ===

Überprüfen Sie, dass ihre xml-Datei wirklich eine xml- und keine html-Datei ist. Auf der GitHub-Seite des rdmo-catalog [http://github.com/rdmorganiser/rdmo-catalog] befindet sich eine Liste von xml-Dateien. Klicken Sie oben rechts auf den grünen Button "Clone or download", um die Dateien auf ihren Rechner zu kopieren. Wenn sie jedoch auf eine einzelne xml-Datei einen Rechtsklick machen und "Speichern unter" wählen, dann wird diese Datei als html-Datei gespeichert und von RDMO als nicht passend bewertet. Achten sie also darauf, dass ihre xml-Datei korrekt ist.

Ein anderes Problem kann sein, dass sie versuchen in dem falschen Untermenü ihre xml-Datei hochzuladen. Die Datei domain.xml beispielsweise muss unter dem Reiter "Domäne" hochgeladen werden. Ebenso müssen Fragenktaloge unter "Fragen" hochgeladen werden, etc.

RDMO FAQ

2019-04-23T09:57:46Z

Omichaelis: /* Frequently asked questions */

= Frequently asked questions =

Diese Seite enthält häufig gestellte Fragen über den Research Data Management Organiser (RDMO).

== Grundlagen ==

=== Was ist ein (Forschungs-)Datenmanagementplan? ===

Ein (Forschungs-)Datenmanagementplan, kurz DMP, ist ein formales Dokument aus dem hervorgeht welche Daten während eines Projekts verwendet und erhoben werden und wie mit diesen während und nach dem Projekt umgegangen wird. Wichtige Aspekte sind hierbeit u.a. Sicherheit, Nachnutzbarkeit und Langzeitarchivierung. Der Plan hilft dabei dem Ersteller strukturierter sein Projektvorhaben anzugehen und seine Daten im Idealfall besser zu dokumentieren. Außerdem verlangen immer mehr Förderer nach einem Datenmnagementplan bei der Projektantagsstellung.

=== Was ist RDMO? ===

Der Research Data Management Organiser, kurz RDMO, ist eine webbasiertes Software zur Erstellung von interaktiven Datenmanagementplänen für Institutionen und Forschende. Dies hilft beim Planen von Projekten und dem Verwalten von Datenmanagementaufgaben über den gesamten Datenlebenszyklus.
Nach dem Anmelden und Log-In können Forschende einen Fragenkatalog zu ihrem im Projekt zu erzeugenden und genutzen Daten beantworten. Dies ist besonders für die Projektantragsstellung bei einigen Fördern wichtig.

RDMO ist das Produkt eines DFG-geförderten Projekts, welches sich in zwei Phasen aufteilt. Die erste Projektphase verlief von November 2015 bis April 2017. Die zweite Projektphase läuft von November 2017 bis April 2020. RDMO wird vom Projektteam stetig verbessert.

RDMO besitzt eine eigene Webseite: [http://www.rdmorganiser.github.io] und wird ist freie Software unter [http://www.github.com|GitHub] veröffentlicht.

=== Kostet RDMO etwas? ===

Nein, RDMO ist als freie Software unter GitHub verfügbar [http://www.github.com|GitHub]. RDMO sollte auf einen Server des Instituts installiert werden und kann dann von allen zugehörigen Mitarbeitern und Forschenden kostenlos genutzt werden.

=== Auf welchen Betriebssystemen läuft RDMO? ===

Für Demonstrations-, Entwicklungs- oder Testzwecke kann RDMO auf Linux, Windows und macOS installiert werden. Falls Sie jedoch eine Produktionsumgebung aufsetzen möchten, RDMO über ein Netzwerk oder das Internet anbieten möchten, dann empfehlen wir sehr eine aktuelle Linux-Version, namentlich CentOS7, Debian 8 oder 9, oder Ubuntu 16.04.3 LTS (Xenial Xerus) zu verwenden.

=== Welche ist die aktuelle Version von RDMO? ===

Die aktuelle Version von RDMO finden Sie unter [http://www.github.com/rdmorganiser/rdmo/releases]. RDMO kann problemlos installiert und genutzt werden. Wir werden versuchen zeitnah eine Version 1.0.0 zu veröffentlichen.

=== Welche Dokumentation existiert für RDMO? ===

Eine gesamte Dokumentation für die Installation und Verwendung von RDMO finden Sie unter [http://www.rdmo.readthedocs.io/de/latest/index.html].
Unter [[RDMO]] finden Sie außerdem Tutorials zu spezifischen Anwendungen.

=== Welche Mailingslisten existieren für RDMO? ===

Für die allgemeine Mailingliste für RDMO können sie sich über folgenden Link anmelden: rdmo@listserv.dfn.de
Über die interne Mailingliste vom RDMO-Team können Sie direkt Fragen an das Team stellen: rdmo-team@listserv.dfn.de

=== Wie kann ich zu RDMO beitragen? ===

Der Code von RDMO ist auf [http://www.github.com|GitHub] veröffentlicht und somit können Sie den Code auch selbst ändern. Sie können außerdem sogenannte "Issues" erstellen, wenn Sie neue Probleme identifieziert haben, die gelöst werden müssen: [https://github.com/rdmorganiser/rdmo/issues]. Sie können selbstverständlich auch bereits bestehende Probleme beheben.
Für Verbesserungen der Dokumentation können Sie sich hier bei forschungsdaten.org registrieren und frei editieren.
Falls Sie auf einem anderen Weg etwas zu RDMO beitragen wollen, kontaktieren Sie uns: rdmo-team@listserv.dfn.de

== Für Nutzer ==

=== Gibt es eine Schnellstartanleitung für RDMO? ===

Ja, diese finden Sie hier: [https://rdmorganiser.github.io/docs/Schnellstartanleitung.pdf]

=== Wo finde ich RDMO? ===

Informieren Sie sich bitte bei den Zuständigen ihres Instituts für Datenmanagement(pläne), ob es an ihrem Institut eine eigene RMDO-Instanz gibt oder ob Sie eine andere nutzen dürfen.

=== Wie logge ich mich bei RDMO ein? ===

Für gewöhnlich können Sie ihre Zugangsdaten von ihrem Institut verwenden, um sich bei RDMO einzuloggen. Fragen Sie bitte bei den Zuständigen ihres Instituts für Datenmanagement(pläne) nach.

=== Gibt es Beispielpläne? ===

Nein, derzeit gibt es von uns keine ausgefüllten Beispielpläne. Eine Übersicht der Fragen unseres generischen Fragenkataloges finden Sie hier: [https://rdmorganiser.github.io/docs/RDMO-Fragenkatalog_nummeriert.pdf].

=== Wie lange werden meine Pläne gespeichert? ===

Es ist nicht vorgesehen, dass Datenmanagementpläne von anderen gelöscht werden. Sie können Sie selbst löschen, indem sie auf ihrer Startseite mit der Übersicht ihrer Projekte (also Pläne) auf fas Lösch-Smbol des entsprechenden Projektes klicken. Dieser Vorgang ist nicht umkehrbar!

=== Was ist, wenn ich zu einem anderen Institut wechsele? ===

Derzeit sind die RDMO-Instanzen lokal und sie können sich mit ihren Zugangsdaten ihres Instituts anmelden. Dies schließt leider (bisher) die Mitnahme von Projekte zu einem anderen Institut aus.

=== Wie kann ich mit anderen Zusammen an einem Plan arbeiten? ===

Sie können als Besitzer eines Projekts bzw. Plans andere Teilnehmer, die ebenfalls bei RDMO registriert sind, hinzufügen. Dazu klicken Sie auf das entsprechende Projekt und dann können sie in der rechten Navigationsleiste ein ''Mitglieder hinzufügen''. sie müssen dann den Benutzernamen oder dessen E-Mail-Adresse eingeben und festlegen, ob dieser (Mit-)Besitzer werden soll oder einen anderen Status ("Rolle") mit anderen Rechten werden soll.

=== Wer kann mir an meinem Institut helfen? ===

Viele Universitäten und Institute haben mittlerweile eine oder mehere Personen, die für das Datenmanagement an ihrer Einrichtung zuständig sind. Erkundigen Sie sich auf der Internetseite ihres Instituts.

=== Wo fange ich an, nachdem ich mich eingeloggt habe? ===

Als Nutzer von RDMO werden Sie nach dem Login auf Ihrer Startseite mit Ihren Projekten landen. Zunächst ist diese Seite lehr. Sie müssen zunächst ein "Neues Projekt erstellen" und danach können sie den Fragenkatalog beantworten.

== Für Administratoren ==

=== Woher kann man RDMO beziehen? ===

RDMO wird als freie Software auf [http://www.github.com] angeboten. Das rdmo-app-Verzeichnis kann durch Klonen des entsprechenden Repositories erstellt werden.

=== Wie kann RDMO installiert werden? ===

Die Installationsanleitung finden Sie unter [http://www.rdmo.readthedocs.io/de/latest/installation/index.html].

=== Wo installiere ich RDMO? ===

Sie benötigen einen eigenen Server (beispielsweise an ihrer Universität oder Institut) auf dem sie RDMo installieren. Es exisitert derzeit keine allgemeine RDMO-Instanz, die für jeden zugänglich wäre, sondern nur institutsinterne Instanzen.

=== Was ist ein Fragenkatalog in RDMO? ===

Wenn man einen Datenmanagementplan erstellen möchte, ergeben sich die verschiedensten Fragen zu den Daten und deren Umgang. In einem Fragenkatalog sind diese Fragen in Untergruppen sortiert. Oft werden von den Förderern wie z.B. der EU mit H2020 eine Sammlung an Fragen vorgegeben, die beantwortet werden müssen für ein Projekt.

=== Welche Fragenkataloge exisiteren bereits? ===

Für RDMO existieren bereits verschiedene Fragenkataloge, die Sie in Ihre Instanz importieren können (z. B. der vom RDMO-Projekt erstellte ausführliche Fragenkatalog (RDMO) oder der Katalog für den Schweizer Nationsfonds (SNF)). Die existierenden Fragenkataloge sind auf Github bereitgestellt ([https://github.com/rdmorganiser/rdmo-catalog/tree/master/rdmorganiser/questions]). Es können jedoch neue Fragenkataloge erstellt werden. Oft bietet es sich auch an sogennante Ansichten (Views) zu erstellen, die nur einen Ausschnitt und/oder eine andere Reihenfolge der Fragen und deren Antworten in verschiedenen Exportformaten ausgibt.

=== Wie erstelle ich einen neuen Fragenkatalog? ===

Dazu gibt es ein Tutorial: [[Katalog_erstellen]]. Eine allgemeine Dokumentation findet sie unter [http://www.rdmo.readthedocs.io/de/latest/management/questions.html]. Generell kann ein Fragenkatlog komplett neu erstellt werden oder aber durch das Kopieren eines bereits vorhanden Fragenkataloges, der dann angepasst wird. Das kopieren eines Fragenkataloges ist derzeit noch nicht möglich, ist aber in Arbeit.

=== Was ist eine Ansicht in RDMO? ===

Eine Ansicht oder auch View ist eine Vorlage, die bestimmt wie die vom Benutzer gegebenen Antworten auf ein Textdokument gemappt werden. Dies ermöglicht es aus dem umfangreichen Fragenkatalog nur bestimmte Fragen und deren Antworten zu extrahieren und ggf. eine andere Reihenfolge oder Layout zu bringen. Hierbei wird mit Variabeln und Tags gearbeitet.

=== Welche Ansichten exisiteren bereits? ===

Derzeit existieren in RDMO aug GitHub sechs Ansichten, wobei diese teilweise nur der Demonstration dienen:
* Bielefeld - DMP Vorlage der Universität Bielefeld.
* CITEC DMP - DMP Vorlage der Universität Bielefeld für CITEC geförderte Projekte.
* DMPonline template - Vorlage von DMPonline, Online: https://dmponline.dcc.ac.uk
* DMPTool template - Vorlage von DMPtool, basiert auf on "NSF-GEN: Generic", Online: https://dmptool.org
* Horizon 2020 FAIR Data Managament Plan template - Vorlage für Horizon 2020, aus "Guidelines on FAIR Data Management in Horizon 2020"
* SNF Vorlage - DMP für die SNF (Schweiz)

=== Wie erstelle ich eine neue Ansicht? ===

Dazu gibt es ein Tutorial dazu: [[Ansicht_erstellen]]. Eine allgemeine Dokuemntation findet Sie unter [http://www.rdmo.readthedocs.io/de/latest/management/views.html]

=== Wie ist das Rollenkonzept in RDMO zu verstehen? ===

Wenn Sie ein neues Projekt anlegen, dann sind sie automatisch der ''Besitzer'' dieses Projektes und Sie haben alle Rechte einschließlich das Löschen eines Projekts. Sie können weitere Mitglieder zu dem Projekt einladen und müssen ihnen eine Rolle zuweisen. Diese Rollen sind derzeit:
* '''Besitzern''': hat alle Rechte.
* '''Manager''': hat alle Rechte außer das Löschen eines Projekts. Er kann Snapshots erstellen und Veränderungen vornehmen.
* '''Autor''': hat Lese- und Schreibrichte.
* '''Gast''': hat nur Leserechte

=== Welche Benutzergruppen gibt es? ===

Die Benutzergruppen sind unter [http://rdmo.readthedocs.io/de/latest/administration/users.html] dokumentiert. Es gibt vier Benutzergruppen mit unterschiedlichen Rechten:
* Editor - Zugriff auf das Mangement-Interface und das Recht das Datenmodel zu ändern
* Reviewer - Zugriff auf das Management-Inteface, aber kein Recht etwas zu ändern
* API - können mit einer programmierbaren API auf alles Elemente des Datenmodels zugreifen
* Superuser - hat alle Rechte

=== Ist RDMO mandatenfähig? ===

Nein, RDMO ist (bisher) nicht mandantenfähig. Dies würde bedeuten, dass auf demselben Server eine RDMO-Instanz mehrere Mandanten (Kunden oder Auftraggeber) unabhängig voneinander bedient. Dies ist nicht möglich, aber es spricht nichts dagegen mehrere RDMO-Instanzen auf einen Server zu installieren.

=== Wo nehme ich welche Einstellungen vor? ===

Als Administrator sind für Sie vor allem zwei Seiten wichtig: das Management-Menü und das Admin-Menü.
Das Management-Menü dient dazu neue Fragenkataloge und alles was damit zu tun hat zu erstellen und anzupasssen. Die Untermenüs sind Domäne, Optionen, Bedingungen, Fragen, Aufgaben, Ansichten.
Über das Admin-Menü werden v.a. die Nutzer, deren Rechte, Nutzerkonten, der Auth Token und der Domainname verwaltet. Auch hier können wie im Managemnt-Menü die Domäne und alles rund um die Fragen verwaltet werden.

== Fehlermeldungen ==

=== Ich habe einen Fehler gefunden. Wie gehe ich jetzt vor? ===

Wenn Sie den gefunden Fehler haben, den Sie nicht selbst beheben können, dann überprüfen Sie zunächst, ob der Fehler bereits hier auf der Webseite beschrieben ist. Falls nicht, dann gehen Sie bitte auf die "Issue"-Seite von GitHub: [https://github.com/rdmorganiser/rdmo/issues]. Dort sind alle aktuellen Fehlermeldungen (und Feature-Wünsche) gesammelt. Überpüfen Sie, ob Ihr Fehler bereits beschrieben ist und somit in der Bearbeitung ist. Falls nicht, dann eröffnen Sie bitte ein neues Issue und beschreiben Sie wann der Fehler aufgetreten ist. Nennen Sie die RDMO-Version und ggf. die Fehlermeldung.
Falls es sich um ein akutes Problem handelt, dass zeitnah behoben werden sollte, dürfen Sie gerne Hilfe über die Mailingliste anfragen oder sich direkt an das RDMO-Team wenden: rdmo-team@listserv.dfn.de .

=== Was bedeutet "dieses Feld wird benötigt?" ===
* Wenn Felder für die Parameter in den entsprechenden Fenstern nicht oder nicht richtig ausgefüllt wurden, gibt es Fehlermeldungen. Beispielsweise müssen die deutschen und englische Texte ausgefüllt werden („Text (en)“ und „Text (de)“), wohingegen die Hilfetexte („Hilfe (en)“ und „Hilfe (de)“) leer bleiben dürfen.

[[Datei:Notgiven.PNG|700px|none]]

=== Was bedeutet das rote Dreieck rechts im Panel einer Entität oder eines Attributs? ===
* Falsch gesetzte Entitäten oder Attribute werden durch ein rotes Dreieck in der entsprechenden Leiste der Frage, etc. angezeigt:
[[Datei:Error.PNG|700px|none]]

=== Die Antwort in der angewendeten Ansicht (View) ist leer, obwohl die Frage beantwortet wurde? Was habe ich falsch gemacht? ===

Bitte beachten Sie, dass sie stehts "values"+den Pfad des Attributes oder der Entität angeben müssen, wobei die Schrägstriche durch Punkte ersetzt werden. Ledeglich wenn durch eine <code>for</code>-Schleife dieser Pfad (teilweise) ersetzt wird, reicht die verkürzende, neue Variable aus:

<pre>
{% for dataset in values.project.dataset %}
Datensatz {{ dataset.id }}:
Volumen: {{dataset.size.volume}}
{% endfor %}
</pre>

In diesem Fall ersetzt "dataset" nach dem <code>for</code> das "values.project.dataset", so dass innerhalb der Schleife nur "dataset.size.volume" geschrieben werden muss anstatt "values.project.dataset.size.volume".

=== Was bedeutet "Unclosed tag on line ..." in der Ansicht (View)? ===

Wenn sie ihre Eintragen (zwischen)speichern und dabei eine Fehlermeldung wie folgt erhalten:

[[Datei:FehlermeldungAnsicht.PNG|800px|none]]

Dann bedeutet dies, dass sie <nowiki>{% endfor %}</nowiki> vergessen haben, welches eine for-Schleife schließt. solche syntaktischen Fehler werden Ihnen angezeigt.
Ob die benutzten Variabeln richtig aufgeschlüsselt werden, sehen sie in dem Code-Eingabefenster jedoch nicht. Erst wenn sie die Ansicht innerhalb ihres Projekts aufrufen, werden sie Fehler feststellen können. Es werden dann Einträge fehlen doer falsch dargestellt sein. Überprüfen Sie in solch einem Fall die richtige Angabe ihrer Variabeln.

=== Wieso funktioniert der Import über den Hochlade-Button meiner xml-Datei nicht? ===

Überprüfen Sie, dass ihre xml-Datei wirklich eine xml- und keine html-Datei ist. Auf der GitHub-Seite des rdmo-catalog [http://github.com/rdmorganiser/rdmo-catalog] befindet sich eine Liste von xml-Dateien. Klicken Sie oben rechts auf den grünen Button "Clone or download", um die Dateien auf ihren Rechner zu kopieren. Wenn sie jedoch auf eine einzelne xml-Datei einen Rechtsklick machen und "Speichern unter" wählen, dann wird diese Datei als html-Datei gespeichert und von RDMO als nicht passend bewertet. Achten sie also darauf, dass ihre xml-Datei korrekt ist.

Ein anderes Problem kann sein, dass sie versuchen in dem falschen Untermenü ihre xml-Datei hochzuladen. Die Datei domain.xml beispielsweise muss unter dem Reiter "Domäne" hochgeladen werden. Ebenso müssen Fragenktaloge unter "Fragen" hochgeladen werden, etc.