Katalog erstellen

Tutorial zum Erstellen eines Fragenkatalogs

Nach der erfolgreichen Installation von RDMO, können Sie sich bei ihrer RDMO-Instanz anmelden. Sie landen dann auf der Startseite auf der "Meine Projekte" anzeiget wird. Diese Seite ist zunächst leer. Als erstes sollte man daher auf der rechten Seite unten auf "Neues Projekt erstellen" klicken. Man kann seinem neuen Projekt einen (Fragen-)Katalog zuweisen. Zur Auswahl stehen die in dem Programm bereits vorhandenen Kataloge, z.B. "RDMO", welcher sehr ausführlich ist.

Wenn Sie jedoch keinen passenden Katalog finden, dann können Sie auch ihren eigenen Fragenkatlog für ihren Förderer oder ihr Institut erstellen. Beachten Sie jedoch, dass es oft ausreicht eine entsprechende Ansicht (Template) über das Managament-Menü basierend auf den RDMO-Katalog zu ertellen. Dies ist einfacher zu erstellen und ist unter Management/Ansichten dokumentiert.

Falls Sie sich dafür entschieden haben einen neuen Fragenkatalog aufzusetzen, dann haben Sie folgende zwei Möglichkeiten:

1. Einen komplett neuen Fragekatalog erstellen oder
2. Einen alten Fragekatalog kopieren und dann bearbeiten. (Ein einfaches Kopieren eines Fragekatalogs ist derzeit noch nicht möglich, wird aber in einer späteren Version möglich sein. Stand: 09.01.2018)

Anmerkung: Das Tutorial basiert auf die Erstellung eines Fragenkatalogs mit dem Namen "SNF", welcher für die Schweizer Nationalfonds steht, oder auch den Namen "Test". Sie können ihrem Katalog einen beliebigen, aber für den späteren Nutzer möglichst nachvollziehbaren, Namen geben.

Einen komplett neuen Fragenkatalog erstellen

Um einen komplett neuen Fragenkatalog zu erstellen, klicken Sie in der rechten Sidebar auf „Neuen Katalog erstellen“. In dem sich nun geöffneten Fenster geben Sie folgende Informationen ein:

• URI Prefix: bitte wählen Sie ein Wort für ihre RDMO-Instanz und verwenden dieses durchgängig (Das Entwicklerteam verwendet für seine Demo-Instanz: https://rdmorganiser.github.io/terms)
• Schlüssel: wählen Sie einen beliebigen Namen, den sich ausschließlich für diesen Fragekatalog zur Identifizierung verwenden (z.B. „rdmo“ für den RDMO-Fragenkatalog)
• Kommentar: geben Sie optional einen beschreibenden Text ein, wofür der Katalog gedacht ist
• Reihenfolge: legen Sie fest an welcher Stelle der Katalog bei der Katalogauswahl später erscheinen soll. Je höher die Zahl ist, desto weiter unten erscheint der Katalog in der Auswahl. Hierbei ist der Bezug zu den gewählten Zahlen der anderen Kataloge wichtig.
• Titel (en): geben Sie einen englischen Titel für den Fragenkatalog ein
• Titel (de): geben Sie einen deutschen Titel für den Fragenkatalog ein

Danach besitzen Sie einen völlig leeren Fragenkatalog, der dann durch Hinzufügen von neuen Abschnitten, Unterabschnitten, Fragesets und Fragen auf der rechten Seite erweitert werden kann.

Die verschiedenen Elemente des Fragebogens haben verschiedenen Eigenschaften, um ihr Verhalten zu beschreiben. Alle Elemente haben einen URI-Präfix, einen Schlüssel und einen internen Kommentar, die nur von dem Manager der RDMO-Installation gesehen werden können.

• URI-Prefix: Benutzen Sie das Wort, welches Sie bereits beim Erstellen ihres Kataloges verwendet haben.
• Schlüssel: Verwenden Sie einen beliebigen Namen, der möglichst im Bezug zu der Frage steht. Es wird empfohlen das Vokabular des Dublin-Core-Metadaten-Satzes zu verwenden. Das eingetragene Wort kann für eine andere Frage wiederverwendet werden, da sich dessen Eindeutigkeit durch seine übergeordnete Entität abgeleitet aus dem Unterabschnitt ergibt.
• Interner Kommentar: Geben Sie optional eine kurze Beschreibung an.

Außerdem können folgende Parameter geändert werden:

Abschnitt

• Katalog: Der Katalog zu dem der Abschnitt gehört. Ändern des Katalogs wird den Abschnitt zu einem anderen Katalog verschieben. Daher wird er dann nicht mehr in der aktuellen Ansicht sichtbar sein.
• Reihenfolge: Bestimmt die Reihenfolge des Abschnittes in der Liste oder in dem Interview.
• Titel (en): Der englische Titel des Abschnittes, der dem Benutzer angezeigt wird.
• Titel (de): Der deutsche Titel des Abschnittes, der dem Benutzer angezeigt wird.

Unterabschnitt

• Abschnitt: Wählen Sie aus der Liste den Abschnitt zu dem dieser Unterabschnitt gehört. Ändern des Abschnittes wird den Unterabschnitt zu einem anderen Abschnitt verschieben. Daher wird er dann nicht mehr im aktuellen Abschnitt sichtbar sein.
• Reihenfolge: Bestimmt die Reihenfolge des Teilabschnittes in der Liste oder in dem Interview.
• Titel (en): Der englische Titel des Teilabschnittes, der dem Benutzer angezeigt wird.
• Titel (de): Der deutsche Titel des Teilabschnittes, der dem Benutzer angezeigt wird.

Fragenset

• Unterabschnitt: Der Teilabschnitt zu dem das Fragenset gehört. Ändern des Teilabschnittes verschiebt die Frage zu einem anderen Abschnitt.
• Reihenfolge: Bestimmt die Position des Fragesets in der Liste oder im Interview.
• Entität: Die Entität vom Domänenmodel mit dem das Fragenset verknüpft ist. Beachten Sie, dass die Art wie das Fragenset dem Benutzer gezeigt wird teilweise bei der Entität festgelegt ist. Eine Frage, die mit einer Kollektionsentität verknüpft ist, erlaubt Antworten für verschiedene Sets.
• Titel (en): Der englische Titel des Teilabschnittes, der dem Benutzer angezeigt wird.
• Titel (de): Der deutsche Titel des Teilabschnittes, der dem Benutzer angezeigt wird.

Frage

• Unterabschnitt: Der Unterabschnitt zu dem die Frage gehört. Ändern des Teilabschnittes verschiebt die Frage zu einem anderen Abschnitt.
• Übergeordnete Entität: Das Fragenset zu dem die Frage gehört. Dies sollte „- - - “ für eine Frage sein, die direkt zu einem Teilabschnitt hinzugefügt wird und nicht zu einem Fragenset.
• Reihenfolge: Bestimmt die Position des Teilabschnittes in der Liste oder in dem Interview.
• Attribut: Das Attribut von dem Domänenmodel zu dem die Frage zugeordnet ist, welches sich von der Entität des zugehörigen Fragesets ableitet. Beachten Sie, dass die Art wir die Frage dem Benutzer angezeigt wird teilweise von der Entität festgelegt wird. Eine Frage, die mit einer Kollektiventität verknüpft ist, erlaubt mehrere Antworten und zeigt ein „Hinzufügen“-Symbol..
• Widget type: Die Art des Widgets für die Frage. Folgende Widgets können gewählt werden:
  • Text (Ein Einzeiler-Textfeld)
  • Textarea (Ein Mehrzeiler-Textfeld)
  • Yes/No (Ein Set aus Radio Buttons für „Ja“ und „Nein“)
  • Checkboxes (Ein Set aus Check boxes, das verknüpfte Attribut muss eine Kollektion sein)
  • Radio Buttons (Ein Set aus Radio buttons, das verknüpfte Attribut muss ein Optionenset sein)
  • Select drop down (Ein Drop down menu, das verknüpfte Attribut muss ein Optionenset haben)
  • Range slider (Ein horizontaler Schieber, das verknüpfte Attribut muss einen Wertebereich haben)
  • Date picker (Ein Drop down element mit einem Kalender, um ein Datum zu wählen. Das verknüpfte Attribut muss vom Datentyp Datetime sein)
• Text (en): Der englische Text für die Frage. Der Text wird in fett gedruckt dem Benutzer angezeigt.
• Textl (de): Der deutsche Text für die Frage. Der Text wird in fett gedruckt dem Benutzer angezeigt.
• Hilfe (en): Der englische Hilfetext für die Frage. Der Hilfetext wird dem Benutzer in grau angezeigt.
• Hilfe (de): Der deutsche Hilfetext für die Frage. Der Hilfetext wird dem Benutzer in grau angezeigt.

Neue Entitäten und Attribute können über das Managementmenü in der oberen Navigationsleiste unter „Domäne“ angelegt werde. (Eine genauere Beschreibung dazu gibt es unter http://rdmo.readthedocs.io/de/latest/management/domain.html)

Optionen und Bedinungen werden ebenfalls über das Managemeentmenü in der oberen Navigationsleister erstellt und bearbeitet. (Eine genauere Beschreibung dazu gibt es unter http://rdmo.readthedocs.io/de/latest/management/options.html & http://rdmo.readthedocs.io/de/latest/management/conditions.html)

Wenn sie einer Entität oder einem Attribut eine Option oder eine Bedinung zuordnen wollen, dann klicken Sie rechts im Panel der Entität oder des Attributs auf das dritte Symbol "Optionen bearbeiten" bzw. das fünfte Symbol "Bedinungen bearbeiten" und wählen sie die entsprechende Option bzw. Bedingung aus.

Einzelne Fragen oder Fragensets?

Fragen, die zu einem Fragenset zusammengefasst sind, erscheinen zusammen auf einer Seite beim Beantworten der Fragen. Wohingegen eine Frage ohne zughörigem Fragenset oder ein Fragenset mit nur einer Frage ein einzelne Frage auf einer Seite erscheinen lässt. Es ist sinnvoll, thematisch verknüpfte Fragen in einem Fragenset zu bündeln.

Fehlermeldungen

• 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.

• Falsch gesetzte Entitäten oder Attribute werden durch ein rotes Dreieck in der entsprechenden Leiste der Frage, etc. angezeigt:

Einen neuen Fragenkatalog aus einem alten Fragenkatalog erstellen

Wenn Sie einen alten Fragenkatlog kopieren und als Vorlage für einen neuen Fragenkatalog nutzen wollen, werden sie Abschnitte, Unterabschnitte, Fragensets und einzelne Fragen hinzufügen, löschen oder in eine andere Reihenfolge bringen wollen. (Die einfache Kopierfunktion wird später eingebaut werden. Stand: 09.01.2018) Bitte lesen Sie zunächst ds vorherige Kapitel, um die einzelnen Parameter zu den verschiedenen Objekten zu verstehen.

Auf der linken Seite werden die Abschnitte, Teilabschnitte und Fragen des aktuellen Katalogs angezeigt. Für Abschnitte und Teilabschnitte wird der Titel und Schlüssel angezeigt. Für Fragen und Fragensets wird der Schlüssel und der Schlüssel des verknüpften Attributes oder Entität angezeigt. Die Reihenfolge der verschiedenen Elemente ist die Gleiche wie im struktiriertem Interview, welches dem Benutzer angezeigt wird. Auf der rechten Seite eines jeden Elementfeldes zeigen Symbolde die Interaktionsmöglichkeiten an. Folgende Optionen sind verfügbar:

• Hinzufügen eines neuen Abschnittes, einer neuen Frage oder eines Fragensets zu einem Teilabschnitt oder eine neue Frage zu einem Frgenset.
• Bearbeiten eines Elements, um seine Eigenschaften zu ändern.
• Kopieren einer Frage oder eines Fragekatalogs. Dies wird das gleiche Fenster öffnen wir beim Bearbeiten. Es können einige der Eigenschaften verändert werden und das Element wird als ein neues Element gespeichert. Dies kann Zeit sparen wenn mehrere ähnliche Fragen erstellt werden.
• Löschen eines Elements und all seiner Abkömmlinge (z.B. Unterabschnitte und all dessen Fragen und Fragensets). Diese Handlung kann nicht rückgängig gemacht werden!

Sie können ganze Abschnitte und Unterabschnitte mit Hilfe des Lösch-Symbols löschen. Beachten Sie, dass diese Aktion nicht rückgängig gemacht werden kann! Es erscheint ein Fenster, dass auflistet, welchen Abschnitt und welche dazugehörigen Objekte gelöscht werden sollen. Erst durch das Klicken auf den „Löschen“-Button wird unwiderruflich gelöscht.

Sie können auch Fragesets und einzelne Fragen löschen. Beachten Sie, dass diese Aktion nicht rückgängig gemacht werden kann!

Sie können neue Abschnitte, Unterabschnitte, Fragesets und Fragen hinzugefügen. Dies erreichen Sie über die Optionenauswahl auf der rechten Seite oder das Klicken des Plus-Symbols in den einzelnen Panels bereits vorhandener Objekte. Diese Objekte besitzen verschiedene Parameter, die gesetzt werden müssen. Welche das sind, ist weiter oben beschrieben. Wenn Entitäten und Attribute benötigt werden, die im vorherigen Fragenkatalog nicht vorhanden waren, müssen diese über das Managementmenü in der Navigationsleiste unter „Domäne“ hinzugefügt werden. (Die Dokumentation dazu gibt es unter Management/Domäne)

Die Reihenfolgen der Abschnitte, Unterabschnitte, Fragensets und Fragen können geändert werden. Wird beispielsweise die Zahl für die Reihenfolge eines Abschnittes erhöht, so erscheint der Abschnitt mit all seinen Unterabschnitten und Fragen später im Fragenkatalog. Wichtig ist hierbei, dass die Zahlen aufsteigend sind. Bei zwei Abschnitten mit der gleichen Zahl für die Reihenfolge wird eine zufällige Reihenfolge gewählt. Die Zahlen müssen jedoch nicht lückenlos sein. Die Zahl für die Reihenfolge sortiert das Objekte in Bezug auf seine nächst höhere Struktur. So werden Fragen innerhalb eines Fragensets sortiert. Eine einzelne Frage ohne Fragenset kann aber gegenüber anderen Einzelfragen oder Fragensets im gleichen Unterabschnitt sortiert werden.

Die Zuordnung von Objekten wie Fragen und Abschnitte können durch das Anklicken des Bearbeitungssymbols und schließlich der Wahl des zugehörigen Fragensets, Unterabschnitt oder Abschnitt geändert werden. Das Objekt wirkt unmittelbare nachdem Anklicken des „Sichern“-Buttons verschoben. Sie können ein Fragenset zu einem anderen (Unter-)Abschnitt verschieben, dessen zugehörigen Fragen werden jedoch nicht verschoben. Diese müssen einzeln zu dem (Unter-)Abschnitt verschoben werden indem die entsprechenden Parameter geändert werden.

Fragen, die zu einem Fragenset zusammengefasst sind, erscheinen zusammen auf einer Seite beim Beantworten der Fragen. Wohingegen eine Frage ohne zughörigem Fragenset oder ein Fragenset mit nur einer Frage auch als einzelne Frage auf einer Seite erscheinen wird. Es ist sinnvoll, thematisch verknüpfte Fragen in einem Fragenset zu bündeln.

Eine einfache Nutzung von Bedingungen können über Entscheidungsfragen eingebaut werden. Je nach Beantwortung der Frage mit „ja“ oder „nein“ werden die darauffolgende(n) dazugehörige(n) Fragen angezeigt oder nicht. (Die DOkumentation dafür finden Sie unter Management/Bedingungen.) In diesem Fall sollten sich die nachgestellten Fragen nicht im gleichen Fragenset befinden wie die Entscheidungsfrage, um zu ermöglichen, dass die nachfolgenden nicht angezeigt werden, wenn die Bedingung als „falsch“ ausgewertet wurde.

Beachten Sie, dass wenn Sie einen Fragenkatalog entfernen (löschen), dann löschen Sie auch automatisch alle zugehörigen Projekte.

Anschließendes

Nachdem Sie einen neuen Fragenkatalog erstellt haben, empfiehlt es sich eine passende Ansicht zu erstellen, die auf den eigenen Fragenkatalog angepasst ist. Ansonsten stehen die Ansichten für verschiedene Förderer bzw. Institute (Bielefeld, CITEC, DMPonline, DMPTool, Horizon 2020). Die Dokumentation finden Sie unter Managament/Ansichten.