Handbuch für den XML-Import V5 - evasys.hs … · Redaktion: Sandra Blomeyer, Dr. Iris Hille,...

2012/08

Handbuch für den

XML-Import V5.1

© 2012 Electric Paper Evaluationssysteme GmbH

2

Impressum

Electric Paper Evaluationssysteme GmbH Konrad-Zuse-Allee 13 21337 Lüneburg Deutschland Telefon: +49 4131 7360 0 Telefax: +49 4131 7360 60 E-Mail: [email protected] Geschäftsführer: Sven Meyer USt-IdNr.: DE 179 384 158 Handelsregister: HRB-Nr. 1604, Lüneburg Redaktion: Sandra Blomeyer, Dr. Iris Hille, Simone Höppner-Welcher, Bernd Röver und Ulrike Schiefelbein © 2012 Electric Paper Evaluationssysteme GmbH Das Werk einschließlich aller seiner Teile ist urheberrechtlich geschützt. Änderungen und Irrtümer vorbehalten.

mailto:[email protected]


3

Inhaltsverzeichnis

1. EINLEITUNG ........................................................................................................ 5

1.1. Verschiedene Systemsprachen ........................................................................ 6

1.2. Import der XML-Datei in EvaSys ....................................................................... 7

2. NEUTRALE SPRACHE: STRUKTURIMPORT OHNE MODULE ........................ 9

2.1. Bestandteile der XML-Datei .............................................................................. 9

2.1.1. Überblick über die Haupt- und Unterelemente ........................................... 9

2.1.2. Elemente eines Themas (Topic) .............................................................. 10

2.1.3. Elemente eines Projekts/Projektverantwortlichen (Person) ..................... 11

2.1.4. Elemente eines Raumes (Room) ............................................................. 13

2.1.5. Elemente einer Umfrage (Survey) ........................................................... 13

2.1.6. Elemente eines Vorgangs (Task) ............................................................. 14

2.1.7. Elemente eines anonymen Teilnehmers (Recipient) ............................... 15

2.1.8. Elemente eines nicht-anonymen Teilnehmers (Participant) ..................... 15

3. HOCHSCHUL/SEMINARSPRACHE: STRUKTURIMPORT .............................. 16

3.1. Bestandteile der XML-Datei ............................................................................ 16

3.1.1. Überblick über die Haupt- und Unterelemente ......................................... 16

3.1.2. Elemente einer Veranstaltung (Lecture) .................................................. 17

3.1.3. Elemente eines Dozenten (Person) ......................................................... 18

3.1.4. Elemente eines Raumes (Room) ............................................................. 19





4. BEISPIELDATEIEN ........................................................................................... 23

5. NEUTRALE SPRACHE: XML-IMPORT VON MODULEN ................................. 24


5.1.1. Elemente des Teilbereichs (Subunit) ....................................................... 26

5.1.2. Elemente des Moduls (Module) ............................................................... 26

5.1.3. Elemente des Themas (ModuleTopic) ..................................................... 28

5.1.4. Elemente des Projekts/Projektverantwortlichen (Person) ........................ 30




4



5.1.9. Zusätzlicher Import des Gesamtmodulthemas......................................... 34

5.2. Beispieldatei für den Modulimport ................................................................... 35

6. HOCHSCHUL-/SEMINARSPRACHE: XML-IMPORT VON MODULEN ........... 35


6.1.1. Elemente des Teilbereichs (Subunit) ....................................................... 38

6.1.2. Elemente des Moduls (Module) ............................................................... 38

6.1.3. Elemente der Veranstaltung (ModuleCourse) .......................................... 40

6.1.4. Elemente des Dozenten (Person) ............................................................ 42





6.1.9. Zusätzlicher Import der Hauptmodulveranstaltung .................................. 46

6.2. Beispieldatei für den Modulimport ................................................................... 47

7. DETAILS ZU DEN IMPORTIERTEN ELEMENTEN ........................................... 47

7.1. XML-Import von Umfragen .............................................................................. 48

7.2. XML-Import der Zeitsteuerung von Onlineumfragen ....................................... 49

7.3. XML-Import von Teilnehmerdaten .................................................................. 51


5

1. Einleitung Dieses Handbuch stellt die Möglichkeiten des Globalimports (über XML) in EvaSys dar. Mit dem Globalimport haben Sie die Möglichkeit, Strukturdaten zu importieren. Dies betrifft:

• Teilbereiche,

• Dozenten/Trainer oder Projekte/Projektverantwortliche,

• Lehrveranstaltungen oder Themen und

• Teilnehmerdaten. Zusätzlich können Sie Umfragen und im Fall von Onlineumfragen die automatische Zeitsteuerung importieren. Auf diese Weise ist es möglich, Daten automatisch aus bei Ihnen existierenden Systemen nach EvaSys zu übertragen. Sie können so die komplette Organisationsstruktur zwischen EvaSys und einem Fremdsystem abgleichen. Der Global-Import arbeitet mit einer XML-Schnittstelle, so dass jedes System, das XML exportieren kann, als Datenquelle geeignet ist. Dies kann z.B. ein LDAP-System sein. Im Normalfall wird für den Import ein Konverter programmiert, der die XML-Exportdateien des datenhaltenden Systems in das EvaSys-XML-Format umwandelt. Bitte wenden Sie sich hierfür an Ihre IT-Abteilung. Das XML-Format für den EvaSys-Import wird mittels einer XSD definiert. XSD steht für XML-Schema-Datei. Eine XSD definiert die Struktur und die Bestandteile einer XML-Datei. Wenn Sie auf der Basis einer XSD eine konkrete XML-Datei definieren, wird dort am Anfang die XSD-Datei angegeben, deren Struktur die nachfolgenden Daten entsprechen sollen. Mit Hilfe eines Validierungswerkzeugs können Sie dadurch anschließend überprüfen, ob die XML-Datei den Anforderungen der XSD entspricht (ob Sie z.B. Elemente vergessen oder aus Versehen einen Tippfehler eingebaut haben). Aus früheren EvaSys-Versionen kennen Sie möglicherweise die Definition der XML-Datei über eine DTD (Document Type Definition). Diese wurde durch die XSD ersetzt. Das Konzept der XSD ist moderner und flexibler und lässt sich daher Neuerungen in EvaSys leichter anpassen. Dadurch ist es möglich, die Anforderungen an die XML-Datei genauer und feiner zu definieren. Die Formatierung, die XML-Dateien aufweisen müssen, um in EvaSys importiert werden zu können, hat sich dadurch nicht geändert, nur die Möglichkeiten zur Prüfung, ob Ihre Importdaten korrekt sind. Bei der Erstellung und Bearbeitung der XML-Importdateien sollten Sie mit Ihrer IT-Abteilung und ggf. zusätzlich mit unserer Supportabteilung zusammenarbeiten. Unsere Supportabteilung erreichen Sie unter der E-Mail-Adresse [email protected] und der Telefonnummer: +49-4131-7360-50.


6

1.1. Verschiedene Systemsprachen EvaSys enthält je nach Derivat verschiedene Systemsprachen. So findet sich in der „EvaSys Education Survey Automation Suite“ (z.B. für eine Hochschule) voreingestellt die Hochschul- und zusätzlich wählbar die Seminaranbietersprache. Die EvaSys-Version für den Healthcare-Bereich („Healthcare Survey Automation Suite“, z.B. für ein Krankenhaus) enthält voreingestellt die neutrale Sprache und zusätzlich wählbar die Seminaranbietersprache. Bei der EvaSys-Version für Corporate-Kunden („Corporate Survey Automation Suite“, z.B. für einen Seminaranbieter) schliesslich ist die Seminaranbietersprache voreingestellt und die neutrale Sprache zusätzlich wählbar. Je nach verwendeter Sprache finden verschiedene XSD-Strukturdateien und damit auch verschiedene XML-Importdateien Anwendung. Die zum jeweiligen System passenden XSD-Dateien und Beispieldateien befinden sich unter „Systeminformationen / Beispieldateien“ Es gibt zwei verschiedene Sprachen für den XML-Import:

• Die „Neutrale Sprache“ verwendet „Projekte“, „Projektverantwortliche“ und Themen,

• die „Hochschul-/Seminarsprache“ hingegen verwendet „Dozent“ bzw. „Trainer“ und „Lehrveranstaltungen“.

Zusätzlich gibt es noch jeweils den XML-Import für Module. Die unterschiedlichen Elemente der XML-Dateien sind in den folgenden Kapiteln dieses Handbuchs erklärt.

Bitte beachten Sie: Die verwendete Systemsprache bestimmt, welche XML-Datei für den Import zu verwenden ist. Erstellen Sie eine XML-Datei in z.B. der „Neutralen Sprache“ so läßt sich diese auch nur in Systeme importieren, deren Systemsprache auf „Neutrale Sprache“ steht.

1.2. Import der XML-Datei in EvaSys Sobald Sie eine XML-Datei erstellt haben, können Sie diese als Administrator oder Teilbereichsadministrator im Hauptmenü „Teilbereiche“ unter „Datenimport“ im linken Untermenü importieren:

Abbildung 1: Datenimport in EvaSys

Wenn Sie auf „Datenimport“ klicken, erscheint dieses Fenster:

Abbildung 2: Fenster „Datenimport“

Hier können Sie eine XML-Datei hochladen, um die Daten in EvaSys zu importieren. Wird beim Importieren einer XML-Datei ein struktureller Fehler gefunden, so wird eine Warnmeldung angezeigt, die den letzten gemeldeten Fehler anzeigt.

7© 2012 Electric Paper Evaluationssysteme GmbH

Abbildung 3: Fenster „Datenimport“

Es können also eventuell mehrere weitere Fehler in der XML-Datei vorhanden sein, die nicht angezeigt werden. Ist die XML-Datei fehlerfrei, so wird zur Kontrolle eine Liste der Strukturelemente angezeigt, die mit diesem Importvorgang importiert werden würde. Sowohl die Zuordnung der Lehrveranstaltungen oder Themen zu einzelnen Perioden, als auch der Import von Sekundärdozenten bzw. zusätzlichen Berichtsempfängern lässt sich noch ein- oder ausschalten. Desweiteren können hier auch noch Datensätze vom Import ausgenommen und es kann der Import ganz abgebrochen werden.

Abbildung 4: Überprüfung des Imports, (hier z.B. in Hochschulsprache)

Ist der Import der XML-Datei erfolgreich durchgeführt, so wird in einer Meldung angezeigt, wieviele Teilbereiche, Nutzer bzw. Projekte (mit Angabe der verbrauchten Nutzerlizenzen), Veranstaltung bzw. Themen etc. importiert wurden.



9

2. Neutrale Sprache: Strukturimport ohne Module 2.1. Bestandteile der XML-Datei Im folgenden Kapitel werden die Elemente einer XML-Datei genau erläutert.

2.1.1. Überblick über die Haupt- und Unterelemente Die XML-Datei setzt sich aus mehreren Hauptelementen zusammen, die jedoch nicht alle auftreten müssen:

• Thema (Element: Topic)

• Projekt/Projektverantwortlicher (Element: Person)

• Raum (Element: Room)

• Umfrage (Element: Survey)

• Vorgang (von zeitgesteuerten Onlineumfragen, Element: Task)

• Umfrageteilnehmer (anonymisiert: z.B. zum Versand der Zugangsdaten, Element: Recipient)

• Umfrageteilnehmer (nicht-anonymisiert: z.B. zum Versand der Zugangsdaten und zur nicht-anonymen Auswertung, Element: Participant)

Um sich innerhalb der XML-Datei auf ein Element (z.B. ein konkretes Thema, d.h. ein konkretes Element „Topic“) beziehen zu können, benötigt man einen eindeutigen Namen. Dieser Bezeichner wird als „key“-Attribut bezeichnet und dient während des Import-Vorgangs zur Verknüpfung der verschiedenen Elemente, die mit der XML-Datei importiert werden sollen. Innerhalb von EvaSys wird dieser key weder gespeichert noch verwendet.

Beispiel, hier für ein Krankenhaus: So könnten Sie z.B. das Thema „Abteilung für Orthopädie“ importieren, um dafür eine Patientenbefragung zu starten. Dazu verwenden Sie das Element „Topic“. Dieses verknüpfen Sie (nur zur Orientierung für die XML-Datei) mit einem eindeutigen Bezeichner (dem „key“). Dieser könnte z.B. „Ortho“, „ABC“, „Klinik_Musterstadt_Orthopaedie“ oder auch „Musterstadt_Ortho“ lauten. Dieser sollte keine Leer- und Sonderzeichen enthalten und muss zudem mit einem Buchstaben beginnen. Wichtig ist nur, dass kein anderes Thema diesen key erhält. Er muss also einzigartig für die gesamte Datei sein. Praktisch ist es daher diesen mit dem Elementnamen des verknüpften Elements beginnen zu lassen. In EvaSys soll dieses Thema „Abteilung für Orthopädie“ lauten, als eine Eigenschaft erhält daher dieses konkrete „Topic“-Element als Namen „Abteilung für Orthopädie“ (unabhängig vom key).


10

Diese jeweiligen Hauptelemente müssen durch ein key-Attribut mit einer ID eindeutig gemacht werden. Anhand des eindeutigen Bezeichners, des keys, kann dann auf die einzelnen Elemente, z.B. auf das Thema „Abteilung für Orthopädie “ (mit dem Namen „Klinik_Musterstadt_Orthopaedie“) referenziert werden. Jedes Hauptelement verfügt über weitere Unterelemente.

2.1.2. Elemente eines Themas (Topic) Die Elemente zu einem Thema sind: Element Inhalt Bedeutung

projects/project Key-ID eines Projekts/Projektverant-wortlichen

Verknüpft das Thema mit einem Projekt/Projektverantwortlichen.

Die erste Person einer Importliste wird in EvaSys als Projektverantwortlicher festgelegt, während alle folgenden Personen aus der Importliste in EvaSys als weitere Berichtsempfänger definiert werden.

orgroot Name des Teilbereichs Diesem Teilbereich wird das Thema zugeordnet.

name Name des Themas

short Kennung des Themas Kennung sollte systemweit und muss für einen Projektverantwortlichen eindeutig sein.

room Key-ID eines Raumes Verknüpft das Thema mit einem Raum.

type Themenart Die Themenart muss vorher in EvaSys definiert worden sein.

turnout Anzahl der Teilnehmer an den anzulegenden Umfragen zum Thema

Wichtig für die TAN-Erzeugung bei Onlineumfragen und die Durchnummerierung bei Formularen.

p_o_study Gruppe des Themas Ermöglicht Gruppenberichte.

period (optional)

Nächste Evaluationsperiode Gibt die Periode an, in der das Thema das nächste Mal evaluiert wird (z.B.Q4/2011).

topicfield1 Benutzerdefiniertes Themen-Feld 1


11

Element Inhalt Bedeutung





survey Key-ID einer Umfrage Verknüpft das Thema mit einer Umfrage

participant Key-IDs der Teilnehmer Verknüpft das Thema mit Teilnehmern

external_id Kennung aus externen Systemen, die hier ggf. übernommen werden kann

Tabelle 1: Elemente zu einem Thema

2.1.3. Elemente eines Projekts/Projektverantwortlichen (Person) Die Elemente zu einem Projekt bzw. Projektverantwortlichen lauten: Element Inhalt Beschreibung

firstname Vorname des Projektverantwortlichen

lastname Nachname Notwendiges Element.

title Titel

email E-Mail-Adresse des Projektverantwortlichen

Die E-Mail-Adresse wird benötigt, um Nachrichten, Fragebögen und Berichte an den Projektverantwortlichen zu senden.

gender Geschlecht des Projektverantwortlichen (mögliche Werte: f/m)

Wichtig für die Anrede.

formeditor_access Zugang zum Formulareditor als aktiver Nutzer (mögliche Werte: full/template/none; d.h. uneingeschränkt/nur Vorlagen/Kein Zugriff)

Entspricht den Einstellungsmöglichkeiten beim manuellen Anlegen eines Benutzers (weitere Erläuterungen: siehe entsprechender Abschnitt im EvaSys-Handbuch).

qmview_access Zugang zu den QM Ansichten (mögliche Werte:

Entspricht den Einstellungsmöglichkeiten beim


12

Element Inhalt Beschreibung

full/survey/ subunit/none; d.h.: uneingeschränkter Zugriff/Nur eigene Umfragen/Nur eigener Teilbereich/Keine QM-Ansichten)

manuellen Anlegen eines Benutzers (weitere Erläuterungen: siehe entsprechender Abschnitt im EvaSys-Handbuch).

username Loginname des Projektverantwortlichen

Login für das EvaSys-System. Dieser Name kann in Kombination mit einer Authentifizierung am Verzeichnisserver verwendet werden (LDAP oder Active Directory).

password Passwort des Projektverantwortlichen

Anmeldekennwort in EvaSys

tel Telefonnummer des Projektverantwortlichen

address Adresse des Projektverantwortlichen

Adresse kann mehrzeilig angegeben werden. (Um einen Zeilenumbruch einzufügen, können Sie \n verwenden).

institutenumber Institutsnummer des Projektverantwortlichen

language Sprache des Projektverantwortlichen

Wenn Sie die Sprache (z.B. englisch) beim Import festlegen, werden die Textvorlagen des Nutzers in der entsprechenden Sprache angezeigt. Falls Sie mehrsprachige Fragebögen verwenden, wählt EvaSys beim Abrufen des Reports oder des Fragebogens in den Umfragendetails automatisch die entsprechende Sprache aus.


projectname Name des Projekts Notwendiges Element

Tabelle 2: Elemente zu einem Projektverantwortlichen


13

2.1.4. Elemente eines Raumes (Room) Elemente zu einem Raum: Element Inhalt Bedeutung

name Name des Raumes Kann als Filter-/Suchkriterium bei Berichten benutzt werden.

Tabelle 3: Elemente zu einem Raum

2.1.5. Elemente einer Umfrage (Survey) Elemente zu einer Umfrage: Element Inhalt Bedeutung

survey_form Formular, mit dem die Umfrage durchgeführt wird

survey_period Periode, in der die Umfrage durchgeführt wird

survey_type Umfragetyp (mögliche Werte: online, coversheet, hardcopy)

online = Onlineumfrage(TAN) codeword = Onlineumfrage(Losung)coversheet = Deckblattumfrage hardcopy = Selbstdruckumfrage

survey_codeword_method

(optional)

Wird survey_codeword_method nicht angegeben so wird „pswd“ verwendet – es sei den survey_codeword wurde angegeben.

(siehe Hinweise in der nächsten Zeile)

pswd = generiert die Losung wie eine TAN (5- oder 7-stellig; Buchstaben & Zahlen) topicid = übernimmt den Wert aus der LV-Kennung topicfield1 = übernimmt den Wert aus dem LV-Benutzerdatenfeld 1 topicfield 2 = übernimmt den Wert aus dem LV-Benutzerdatenfeld 2 topicfield 3 = übernimmt den Wert aus dem LV-Benutzerdatenfeld 3 topicfield 4 = übernimmt den Wert aus dem LV-Benutzerdatenfeld 4 topicfield 5 = übernimmt den Wert aus dem LV-Benutzerdatenfeld 5

survey_codeword (optional)

Losung die für die Umfrage verwendet werden soll.

Diese Angabe ist stärker als survey_codeword_method und überschreibt dessen Einstellung. Hinweis: Wird nur berücksichtigt, wenn survey_type = codeword Hinweis2: Wird eine Losung vorgegeben, die bereits im System verwendet wird, so wird diese durch eine zufällig generierte TAN-ähnliche Losung ersetzt. Hinweis3: Enthält eine Losung


14


Leerzeichen, so werden diese automatisch entfernt.

survey_verify Verifikation ja oder nein? (mögliche Werte: 0, 1)

survey_tasks geplante Vorgänge Verweist auf Elemente vom Typ Task

Tabelle 4: Elemente zu einer Umfrage

2.1.6. Elemente eines Vorgangs (Task) Elemente zu einem Vorgang: Element Inhalt Bedeutung

type Typ des Vorgangs (mögliche Werte: dispatch_pswd/remind_pswd/close_survey)

dispatch_pswd: Zugangsdaten versenden

remind_pswd: Erinnerung versenden

close_survey: Umfrage schließen

datetime Zeitpunkt des Vorgangs

reminder_days Intervall, in dem Erinnerungen automatisch an Teilnehmer versendet werden sollen, die ihre TAN noch nicht verbraucht haben

sender_name Name des Absenders

sender_email E-Mail-Adresse des Absenders

text E-Mail-Text Zeilenumbrüche, die in der E-Mail vorhanden sein sollen, müssen als \n eingetragen sein (siehe Beispieldateien)

subject Betreffzeile der E-Mail

recipients/recipient Empfänger der E-Mail

dispatch_report Berichtsverschickung nach Schließen der Umfrage ja/nein (mögliche Werte: 1/0; d.h. ja/nein)

result_access Zugang der Teilnehmer zum HTML-Bericht ja/nein (mög-liche Werte: 1/0; d.h. ja/nein)

Tabelle 5: Elemente zu einem Vorgang


15

2.1.7. Elemente eines anonymen Teilnehmers (Recipient) Elemente zu einem anonymen Teilnehmer (TN): Element Inhalt Bedeutung

email E-Mail-Adresse des TN Tabelle 6: Elemente zu einem anonymen Teilnehmer

2.1.8. Elemente eines nicht-anonymen Teilnehmers (Participant) Elemente zu einem nicht-anonymen Teilnehmer (TN): Element Inhalt Bedeutung

email E-Mail-Adresse

firstname Vorname

lastname Nachname

gender Geschlecht (mögliche Werte: f, m)

title Titel

address Postadresse

custom1 benutzerdefiniertes Feld



Tabelle 7: Elemente zu einem nicht-anonymen Teilnehmer


16

3. Hochschul/Seminarsprache: Strukturimport 3.1. Bestandteile der XML-Datei Im folgenden Kapitel werden die Elemente einer XML-Datei genau erläutert.

3.1.1. Überblick über die Haupt- und Unterelemente Die XML-Datei setzt sich aus mehreren Hauptelementen zusammen, die jedoch nicht alle auftreten müssen:

• Veranstaltung (Element: Lecture)

• Dozent (Element: Person)

• Raum (Element: Room)



• Lehrveranstaltungsteilnehmer (anonymisiert: z.B. zum Versand der Zugangsdaten, Element: Recipient)

• Lehrveranstaltungsteilnehmer (nicht-anonymisiert: z.B. zum Versand der Zugangsdaten und der nicht-anonymen Auswertung, Element: Participant)

Um sich innerhalb der XML-Datei auf ein Element (z.B. eine konkrete Veranstaltung, d.h. ein konkretes Element „Lecture“) beziehen zu können, benötigt man einen eindeutigen Namen. Dieser Bezeichner wird als „key“-Attribut bezeichnet und dient nur innerhalb der XML-Datei zur eindeutigen Bezeichnung eines Elements. Außerhalb (z.B. innerhalb von EvaSys) ist dieser key nicht von Bedeutung.

Beispiel (hier für eine Hochschulvorlesung): So könnten Sie z.B. die Veranstaltung „Mathematik I“ importieren. Dazu verwenden Sie das Element „Lecture“. Dieses verknüpfen Sie (nur zur Orientierung für die XML-Datei) mit einem eindeutigen Bezeichner (dem „key“). Dieser könnte z.B. „Kurs1“, „ABC“, „Mathe1“ oder auch „Mathematik1“ lauten. Leer- und Sonderzeichen sind für den XML-internen Bezeichner nicht gestattet, er muss zudem mit einem Buchstaben beginnen. Wichtig ist nur, dass kein anderer Kurs diesen key erhält. In EvaSys soll diese Veranstaltung „Mathematik 1“ lauten, als eine Eigenschaft erhält daher dieses konkrete „Lecture“-Element als Namen „Mathematik 1“ (unabhängig vom key).

Diese jeweiligen Hauptelemente müssen durch ein key-Attribut mit einer ID eindeutig gemacht werden.


17

Anhand des eindeutigen Bezeichners, des keys, kann dann auf die einzelnen Elemente, z.B. auf die Lehrveranstaltung „Kurs1“ (mit dem Namen „Mathematik 1“) referenziert werden. Jedes Hauptelement verfügt über weitere Unterelemente.

3.1.2. Elemente einer Veranstaltung (Lecture) Die Elemente zu einer Veranstaltung sind: Element Inhalt Bedeutung

dozs/doz Key-ID einer Person Verknüpft die Veranstaltung mit einer Person.

Der erste Dozent einer Importliste wird in EvaSys als Dozent festgelegt, während alle folgenden Dozenten aus der Importliste in EvaSys als Sekundärdozenten definiert werden.

orgroot Name des Teilbereichs Diesem Teilbereich wird die Veranstaltung zugeordnet.

name Name der Veranstaltung

short Kennung der Veranstaltung Kennung sollte systemweit und muss für einen Dozenten eindeutig sein.

room Key-ID eines Raumes Verknüpft die Veranstaltung mit einem Raum.

type Typ der Veranstaltung Der Typ muss vorher in EvaSys definiert worden sein.

turnout Anzahl der Teilnehmer an der Veranstaltung

Wichtig für die TAN-Erzeugung bei Onlineumfragen und die Durchnummerierung bei Formularen.

p_o_study Studiengang der Veranstaltung

Ermöglicht Studiengangsberichte.

period (optional)

Nächste Evaluationsperiode Gibt die Periode an, in der die Veranstaltung das nächste Mal evaluiert wird (z.B. SS10).

coursefield1 Benutzerdefiniertes LV-Feld 1





survey Key-ID einer Umfrage Verknüpft die Veranstaltung mit


18


einer Umfrage

participant Key-IDs der Teilnehmer Verknüpft die Veranstaltung mit Teilnehmern


Tabelle 8: Elemente zu einer Veranstaltung

3.1.3. Elemente eines Dozenten (Person) Die Elemente zu einem Dozenten lauten: Element Inhalt Beschreibung

firstname Vorname des Dozenten


title Titel

email E-Mail-Adresse des Dozenten Die E-Mail-Adresse wird benötigt, um Nachrichten, Fragebögen und Berichte an den Dozenten zu senden.

gender Geschlecht des Dozenten (mögliche Werte: f/m)


formeditor_access Zugang zum Formulareditor als aktiver User (mögliche Werte: full/template/none; d.h. uneingeschränkt/nur Vorlagen/Kein Zugriff)


qmview_access Zugang zu den QM Ansichten (mögliche Werte: full/survey/ subunit/none; d.h.: uneingeschränkter Zugriff/Nur eigene Umfragen/Nur eigener Teilbereich/Keine QM-Ansichten)


username Loginname des Dozenten Login für das EvaSys-System. Dieser Name kann in Kombination mit einer Authentifizierung am Verzeichnisserver verwendet werden (LDAP oder Active Directory).

password Passwort des Dozenten Anmeldekennwort in EvaSys

tel Telefonnummer des Dozenten


19


address Adresse des Dozenten Adresse kann mehrzeilig angegeben werden. (Um einen Zeilenumbruch einzufügen, können Sie \n verwenden).

institutenumber Institutsnummer des Dozenten

language Sprache des Dozenten Wenn Sie die Sprache (z.B. englisch) beim Import festlegen, werden die Textvorlagen des Nutzers in der entsprechenden Sprache angezeigt. Falls Sie mehrsprachige Fragebögen verwenden, wählt EvaSys beim Abrufen des Reports oder des Fragebogens in den Umfragendetails automatisch die entsprechende Sprache aus.


Tabelle 9: Elemente zu einem Dozenten

3.1.4. Elemente eines Raumes (Room) Elemente zu einem Raum: Element Inhalt Bedeutung

name Name des Raumes Kann als Filter-/Suchkriterium bei Berichten benutzt werden.

Tabelle 10: Elemente zu einem Raum





online = Onlineumfrage(TAN) codeword = Onlineumfrage(Losung)coversheet = Deckblattumfrage


20


hardcopy = Selbstdruckumfrage

survey_codeword_method

(optional)

Wird survey_codeword_method nicht angegeben so wird „pswd“ verwendet – es sei den survey_codeword wurde angegeben.


pswd = generiert die Losung wie eine TAN (5- oder 7-stellig; Buchstaben & Zahlen) courseid = übernimmt den Wert aus der LV-Kennung coursefield1 = übernimmt den Wert aus dem LV-Benutzerdatenfeld 1 coursefield2 = übernimmt den Wert aus dem LV-Benutzerdatenfeld 2 coursefield3 = übernimmt den Wert aus dem LV-Benutzerdatenfeld 3 coursefield4 = übernimmt den Wert aus dem LV-Benutzerdatenfeld 4 coursefield5 = übernimmt den Wert aus dem LV-Benutzerdatenfeld 5



Diese Angabe ist stärker als survey_codeword_method und überschreibt dessen Einstellung. Hinweis: Wird nur berücksichtigt, wenn survey_type = codeword Hinweis2: Wird eine Losung vorgegeben, die bereits im System verwendet wird, so wird diese durch eine zufällig generierte TAN-ähnliche Losung ersetzt. Hinweis3: Enthält eine Losung Leerzeichen, so werden diese automatisch entfernt.





21


type Typ des Vorgangs (mögliche Werte: dispatch_pswd/remind_pswd/close_survey)

dispatch_pswd: Zugangsdaten versenden

remind_pswd: Erinnerung versenden

close_survey: Umfrage schließen









result_access Zugang der Teilnehmer zum HTML-Bericht ja/nein (mögliche Werte: 1/0; d.h. ja/nein)



22





firstname Vorname

lastname Nachname


title Titel

address Postadresse





4. Beispieldateien Unter „Systeminformationen“ - „Beispieldateien“ befindet sich eine zur jeweiligen EvaSys-Sprache passende Beispieldatei, die sich auch in EvaSys importieren lässt. So können Sie bei Bedarf den ganzen Importvorgang beispielhaft durchspielen.

Abbildung 5: Beispieldateien, hier in einem Hochschulsystem



24

5. Neutrale Sprache: XML-Import von Modulen Mit einem Modul können mehrere Einzelbefragungen auf einem Fragebogen zusammengefasst werden (weitere Informationen zur Modulevaluation finden Sie im Nutzerhandbuch). Der XML-Import empfiehlt sich, wenn Sie das Modul nicht per Hand anlegen möchten, sondern eine XML-Datei automatisch generieren können. Gerade bei einer hohen Zahl von Themen und/oder Projekten bzw. Projektverantwortlichen kann dies eine deutliche Arbeits- und Zeitersparnis mit sich bringen. Bitte beachten Sie folgende Besonderheit bei der Modulevaluation: Um ein Modul in EvaSys anzulegen, legt man wie gewohnt einen neuen Nutzer an, dem man den Benutzertyp „Modul“ zuweist. Als Personenname gibt man dort den für das Modul Verantwortlichen an. Dieser ist aus EvaSys-Sicht ähnlich zu betrachten wie der Projektverantwortliche. Wie sonst einem Projekt werden in diesem Fall dem Modul die zugehörigen Themen zugewiesen. Wenn es für die Einzelbestandteile des Moduls Verantwortliche aus verschiedenen Teilbereichen gibt, bleiben diese ihrem jeweiligen Teilbereich zugeordnet und werden als weitere Berichtsempfänger für das entsprechende Thema des Moduls eingetragen. EvaSys benötigt folgende vier Elemente, um ein Modul aufbauen zu können:

• den Teilbereich

• das Modul

• die zugehörigen Themen

• die weiteren Berichtsempfänger Sie können ohne Probleme Teilbereiche, Berichtsempfänger etc. angeben, die bereits im System vorhanden sind. Denn wenn die zu importierende Information bereits im System vorliegt, erkennt das System dies und importiert sie nicht noch einmal. Falls bereits ein Teilbereich mit einem gleichen Namen existiert, verändert der Import nicht die Eigenschaften des Teilbereichs (Logo, Behandlung handschriftlicher Texte). Die darauf folgenden Informationen (mit dem Teilbereich verbundene Module und Projektverantwortliche) werden für diesen Teilbereich jedoch importiert. Dasselbe gilt für die anderen drei Teile, falls diese bereits mit gleichem Namen im System auftreten. Die XML-Datei, mit der Module importiert werden, unterscheidet sich erheblich von der üblichen XML-Importdatei. Wie beim bekannten XML-Import wird jeder der Hauptkomponenten (Teilbereich, Modul, Thema, Projekt/Projektverantwortlicher) ein eindeutiges Schlüsselattribut zugeordnet.


25

So erhält beispielsweise ein Modul einen key, der auch in den Informationen über einen Teilbereich enthalten ist. Wenn beide übereinstimmen, „weiß“ EvaSys, dass Modul und Teilbereich zusammen gehören. Ebenso verbindet ein jeweils eindeutiger key jedes Thema und jeden Projektverantwortlichen mit dem Modul. Einige Elemente müssen in der XML-Datei vorliegen, weil sie beim Import dringend benötigt werden. Sie werden in der folgenden Tabelle mit „notwendiges Element“ bezeichnet. Einige Elemente können optional hinzugefügt werden. Bitte beachten Sie, dass EvaSys die Elemente der XML-Datei nicht eigens validiert. Falls Sie die als „notwendiges Element“ bezeichneten Elemente in der XML-Datei nicht angeben, kann es daher zu unvollständigen Importvorgängen kommen.

5.1. Bestandteile der XML-Datei Im Folgenden werden die Elemente dargestellt, die in der XML-Datei für den Modulimport vorhanden sein müssen bzw. können. Die Hauptelemente sind

• der Teilbereich (Element: Subunit)

• das Modul selbst (Element: Module)

• das Modulthema (Element: ModuleTopic)

• das Projekt/der Projektverantwortliche (Element: Person)



• Umfrageteilnehmer (anonymisiert: z.B. zum Versand der Zugangsdaten, Element: Recipient)

• Umfrageteilnehmer (nicht-anonymisiert: z.B. zum Versand der Zugangsdaten und der nicht-anonymen Auswertung, Element: Participant)


26

5.1.1. Elemente des Teilbereichs (Subunit) Die Elemente des Teilbereichs lauten: Element Inhalt Beschreibung

subunitname Name des Teilbereichs Notwendiges Element.

subunitlogo Name des Logos Das Logo wird in EvaSys festgelegt.

openquestions Behandlung handschriftlicher Texte (mögliche Werte: display/ anonymous/hide; d.h.: Direkt anzeigen/Nie anzeigen/Nach manueller Erfassung anzeigen)

Hier wird definiert, ob die handschriftlichen Texte der offenen Fragen gezeigt werden sollen oder nicht und ob sie anonymisiert werden.

Tabelle 15: Elemente zu einem Teilbereich

5.1.2. Elemente des Moduls (Module) Die Elemente des Moduls selbst lauten: Element Inhalt Beschreibung

module_subunit Key-ID zum Teilbereich Verbindet das Modul mit dem Teilbereich.

Notwendiges Element.

modulename Name des Moduls Notwendiges Element.

module_period (optional)

Nächste Evaluationsperiode

Gibt die Periode an, in der das Modul das nächste Mal evaluiert wird (z.B.Q4/08).

module_short Kennung des Moduls

module_participants Enthält Verweise auf Teilnehmer, die an anderer Stelle in dem zu importierenden XML-Dokument definiert werden.

Hintergrund: So können die gleichen Teilnehmer verschiedenen Modulen zugeordnet werden.

module_projects Verweist auf den Projektverantwortlichen des Moduls

Hintergrund: So können die gleichen Projekte/ Projektverantwortlichen verschiedenen Modulen zugeordnet werden.

supervisor_firstname Vorname des Modulverantwortlichen

supervisor_lastname Nachname Notwendiges Element.

supervisor_title Titel


27


supervisor_email E-Mail-Adresse dieser Person

Die E-Mail-Adresse wird benötigt, um Nachrichten, Fragebögen und Berichte an den Modulverantwortlichen zu senden.

supervisor_gender Geschlecht des Modulverantwortlichen (mögliche Werte: f/m)


supervisor_username Loginname des Modulverantwortlichen


supervisor_password Passwort des Modulverantwortlichen

Passwort für das EvaSys-System

supervisor_tel Telefonnummer des Modulverantwortlichen

supervisor_address Adresse dieser Person Adresse kann mehrzeilig angegeben werden (\n bewirkt einen Zeilenumbruch).

supervisor_language Sprache des Modulverantwortlichen

Wenn Sie die Sprache (z.B. englisch) beim Import festlegen, werden die Textvorlagen des Modulverantwortlichens in der entsprechenden Sprache angezeigt. Falls Sie mehrsprachige Fragebögen verwenden, wählt EvaSys beim Abrufen des Reports oder des Fragebogens in den Umfragendetails automatisch die entsprechende Sprache aus

supervisor_institutenumber Institutsnummer des Modulverantwortlichen

supervisor_formeditor_

access

Zugang zum Formulareditor als aktiver Nutzer (mögliche Werte: full/template/none; d.h.: uneingeschränkt/nur Vorlagen/Kein Zugriff)

Entspricht den Einstellungsmöglichkeiten beim manuellen Anlegen eines Nutzers (weitere Erläuterungen: s. EvaSys-Anwenderhandbuch).


28


supervisor_qmview_access Zugang zu den QM Ansichten (mögliche Werte: full/survey/ subunit/none; d.h.: uneingeschränkter Zugriff/Nur eigene Umfragen/Nur eigener Teilbereich/Keine QM-Ansichten)

Entspricht den Einstellungsmöglichkeiten beim manuellen Anlegen eines Nutzers (weitere Erläuterungen: siehe entsprechender Abschnitt im EvaSys-Handbuch).

survey Key-ID einer Umfrage Verknüpft das Modul mit einer Umfrage

Tabelle 16: Elemente zu einem Modul

5.1.3. Elemente des Themas (ModuleTopic) Die Elemente des Themas lauten: Element Inhalt Beschreibung

moduletopic_module Key-ID zum Modul Verbindet das Thema mit dem Modul.


moduletopic_name Name des Themas Notwendiges Element.

moduletopic_short Themakennung Die Themenkennung muss systemweit sowie für einen Projektverantwortlichen eindeutig sein.


moduletopic_room Raum

moduletopic_type Themenart Die Themenart muss zuvor in EvaSys definiert werden (s. das entsprechende Kapitel im Nutzerhandbuch).

moduletopic_turnout Teilnehmerzahl Wird für die Generierung von TANs bei Onlineumfragen sowie für Seriendruckvorgänge benötigt.

moduletopic_p_o_study Gruppe Verbindet ein Thema mit der dazugehörigen Gruppe.

moduletopic_topicfield1 Eigenschaft des Themas, die vom Benutzer definiert wird, Nr. 1

Inhalt des benutzerdefinierten Themenfeldes 1 (wird in EvaSys unter Einstellungen/ Konfiguration/ TH-Benutzer-datenfelder festgelegt: „Inhalt des ersten Zusatzfeldes“)


29



Inhalt des benutzerdefinierten Themenfeldes 2







moduletopic_projects Hiermit beginnt die Liste der Projektverantwortlichen.

Hintergrund: So können die gleichen Teilnehmer verschiedenen Modulen zugeordnet sein.

Hier sind es die Projektverantwortlichen für ein Thema in dem Modul.

Dieses Element kann das folgende Element moduletopic_project enthalten.

moduletopic_project Verweist auf den Projektverantwortlichen des Moduls per Key-ID

Verbindet das Thema mit dem zugehörigen Projektverantwortichen

moduletopic_participants Enthält Verweise auf Teilnehmer, die an anderer Stelle in dem zu importierenden XML-Dokument definiert werden.


Hier sind es die Teilnehmer zu einem Thema in dem Modul.

Dieses Element kann das folgende Element participant enthalten.

participant Verweist auf die Teilnehmer des Moduls per Key-ID

Verbindet das Thema mit den zugehörigen Teilnehmern

Tabelle 17: Elemente zu einem Thema


30

5.1.4. Elemente des Projekts/Projektverantwortlichen (Person) Die Elemente des Projekts/Projektverantwortlichen lauten wie folgt: Element Inhalt Beschreibung

firstname Vorname des Projektverantwortlichen


title Titel

email E-Mail-Adresse des Projektverantwortlichen

Die E-Mail-Adresse wird benötigt, um Nachrichten, Fragebögen und Berichte an den Projektverantwortlichen zu senden.

gender Geschlecht des Projektverantwortlichen (mögliche Werte: f/m)


formeditor_access Zugang zum Formulareditor als aktiver Nutzer (mögliche Werte: full/template/none; d.h. uneingeschränkt/nur Vorlagen/Kein Zugriff)


username Loginname des Projektverantwortlichen

Login für das EvaSys-System. Dieser Name kann in Kombination mit einer Authentifizierung am Verzeichnisserver verwendet werden (LDAP or Active Directory).

password Passwort des Projektverantwortlichen

Anmeldekennwort in EvaSys

tel Telefonnummer des Projektverantwortlichen


31


address Adresse des Projektverantwortlichen

Adresse kann mehrzeilig angegeben werden (\n bewirkt einen Zeilenumbruch).

institutenumber Institutsnummer des Projektverantwortlichen

person_subunit Key-ID zum Teilbereich Verbindet das Projekt mit dem Teilbereich.


language Sprache des Projektverantwortlichen

Wenn Sie die Sprache (z.B. englisch) beim Import festlegen, werden die Textvorlagen des Nutzers in der entsprechenden Sprache angezeigt. Falls Sie mehrsprachige Fragebögen verwenden, wählt EvaSys beim Abrufen des Reports oder des Fragebogens in den Umfragedetails automatisch die entsprechende Sprache aus.

Tabelle 18: Elemente zu einem Projekt/Projektverantwortlichen





online = Onlineumfrage(TAN) codeword = Onlineumfrage(Losung)coversheet = Deckblattumfrage hardcopy = Selbstdruckumfrage

survey_codeword_method Wird survey_codeword_meth

pswd = generiert die Losung wie


32


(optional) od nicht angegeben so wird „pswd“ verwendet – es sei den survey_codeword wurde angegeben.


eine TAN (5- oder 7-stellig; Buchstaben & Zahlen) courseid = übernimmt den Wert aus der LV-Kennung coursefield1 = übernimmt den Wert aus dem LV-Benutzerdatenfeld 1 coursefield2 = übernimmt den Wert aus dem LV-Benutzerdatenfeld 2 coursefield3 = übernimmt den Wert aus dem LV-Benutzerdatenfeld 3 coursefield4 = übernimmt den Wert aus dem LV-Benutzerdatenfeld 4 coursefield5 = übernimmt den Wert aus dem LV-Benutzerdatenfeld 5








33


type Typ des Vorgangs (mögliche Werte: dipatch_pswd/remind_pswd/close_survey; d.h. Zugangsdaten versenden/Erinnerung versenden/Umfrage schließen)







recipient/recipients Empfänger der E-Mail





34





firstname Vorname

lastname Nachname


title Titel

address Postadresse





5.1.9. Zusätzlicher Import des Gesamtmodulthemas Beim XML-Import von Modulen kann eine ID für das Gesamtmodulthema erstellt werden, um einen Teilnehmerimport zu ermöglichen. Weitere Berichtsempfänger können dann mit dem Gesamtthema verknüpft werden. Beim Modulimport entscheiden die Elemente <module_short> und <survey>, ob das Gesamtmodulthema automatisch erstellt wird. Eines der Elemente muss vorhanden sein. Für das Gesamtmodulthema ist es an dieser Stelle nicht relevant, ob wirklich Daten für die Umfrage in der XML-Datei vorhanden sind. Sind beide Elemente nicht angegeben, bedeutet das, dass erst beim manuellen Anlegen der Umfrage in EvaSys das Gesamtmodulthema erstellt wird (und nicht beim Import). Wenn Sie das Gesamtmodulthema auf diese Weise manuell (und nicht durch Import) erzeugen, werden beim Anlegen der ersten Modulumfrage die Umfrageeilnehmer für die einzelnen Themen dieses Moduls kopiert und zum erstellten Gesamtmodulthema hinzugefügt.

Bitte beachten Sie, dass das Gesamtmodulthema automatisch angelegt wird, sobald Sie Projektverantwortliche direkt für ein Modul angeben.

5.2. Beispieldatei für den Modulimport Sie finden unter Systeminformationen – Beispieldateien einen komplette Beispieldatei zum Import von Modulen in EvaSys:

Abbildung 6: Beispieldatei Modulimport

6. Hochschul-/Seminarsprache:

XML-Import von Modulen Mit einem Modul können mehrere Einzelbefragungen auf einem Fragebogen zusammengefasst werden. Sinnvoll ist die Verwendung von Modulen beispielsweise bei Bachelor- oder Masterstudiengängen (weitere Informationen zur Modulevaluation finden Sie im Nutzerhandbuch). Der XML-Import empfiehlt sich, wenn Sie das Modul nicht per Hand anlegen möchten, sondern eine XML-Datei automatisch generieren können. Gerade bei einer hohen Zahl von Veranstaltungen und/oder Dozenten kann dies eine deutliche Arbeits- und Zeitersparnis mit sich bringen. Bitte beachten Sie folgende Besonderheit bei der Modulevaluation: Um ein Modul in EvaSys anzulegen, legt man wie gewohnt einen neuen Nutzer an, dem man den Benutzertyp „Modul“ zuweist. Als Personenname gibt man dort den für das Modul Verantwortlichen an. Daher ist aus EvaSys-Sicht der Dozent einer Modul-



36

Lehrveranstaltung zunächst das Modul selbst. Wie sonst einem Dozenten werden in diesem Fall dem Modul die zugehörigen Veranstaltungen zugewiesen. Denn die Dozenten dieser einzelnen Lehrveranstaltungen können aus verschiedenen Teilbereichen stammen. Sie bleiben daher ihrem jeweiligen Teilbereich zugeordnet und werden als Sekundärdozenten für die entsprechende Veranstaltung des Moduls eingetragen. EvaSys benötigt folgende vier Elemente, um ein Modul aufbauen zu können:

• den Teilbereich

• das Modul

• die zugehörigen Veranstaltungen

• die Dozenten Sie können ohne Probleme Teilbereiche, Dozenten etc. angeben, die bereits im System vorhanden sind. Denn wenn die zu importierende Information bereits im System vorliegt, erkennt das System dies und importiert sie nicht noch einmal. Falls bereits ein Teilbereich mit einem gleichen Namen existiert, verändert der Import nicht die Eigenschaften des Teilbereichs (Logo, Behandlung handschriftlicher Texte). Die darauf folgenden Informationen (mit dem Teilbereich verbundene Module und Dozenten) werden für diesen Teilbereich jedoch importiert. Dasselbe gilt für die anderen drei Teile, falls diese bereits mit gleichem Namen im System auftreten. Die XML-Datei, mit der Module importiert werden, unterscheidet sich erheblich von der üblichen XML-Importdatei. Wie beim bekannten XML-Import wird jeder der Hauptkomponenten (Teilbereich, Modul, Veranstaltung, Dozent) ein eindeutiges Schlüsselattribut zugeordnet.


37

So erhält beispielsweise ein Modul einen key, der auch in den Informationen über einen Teilbereich enthalten ist. Wenn beide übereinstimmen, „weiß“ EvaSys, dass Modul und Teilbereich zusammen gehören. Ebenso verbindet ein jeweils eindeutiger key jeden Kurs und jeden Dozenten mit dem Modul. Einige Elemente müssen in der XML-Datei vorliegen, weil sie beim Import dringend benötigt werden. Sie werden in der folgenden Tabelle mit „notwendiges Element“ bezeichnet. Einige Elemente können optional hinzugefügt werden. Bitte beachten Sie, dass EvaSys die Elemente der XML-Datei nicht eigens validiert. Falls Sie die als „notwendiges Element“ bezeichneten Elemente in der XML-Datei nicht angeben, kann es daher zu unvollständigen Importvorgängen kommen.

6.1. Bestandteile der XML-Datei Im Folgenden werden die Elemente dargestellt, die in der XML-Datei für den Modulimport vorhanden sein müssen bzw. können. Die Hauptelemente sind

• der Teilbereich (Element: Subunit)

• das Modul selbst (Element: Module)

• die Modulveranstaltung (Element: ModuleCourse)

• der Dozent (Element: Person)



• Lehrveranstaltungsteilnehmer (anonymisiert: z.B. zum Versand der Zugangsdaten, Element: Recipient)

• Lehrveranstaltungsteilnehmer (nicht-anonymisiert: z.B. zum Versand der Zugangsdaten und der nicht-anonymen Auswertung, Element: Participant)


38

6.1.1. Elemente des Teilbereichs (Subunit) Die Elemente des Teilbereichs lauten: Element Inhalt Beschreibung

subunitname Name des Teilbereichs Notwendiges Element.

subunitlogo Name des Logos Das Logo wird in EvaSys festgelegt.

openquestions Behandlung handschriftlicher Texte (mögliche Werte: display/ anonymous/hide; d.h.: Direkt anzeigen/Nie anzeigen/Nach manueller Erfassung anzeigen)

Hier wird definiert, ob die handschriftlichen Texte der offenen Fragen gezeigt werden sollen oder nicht und ob sie anonymisiert werden.

Tabelle 23: Elemente zu einem Teilbereich

6.1.2. Elemente des Moduls (Module) Die Elemente des Moduls selbst lauten: Element Inhalt Beschreibung

module_subunit Key-ID zum Teilbereich Verbindet das Modul mit dem Teilbereich.


modulename Name des Moduls Notwendiges Element.

module_period (optional)

Nächste Evaluationsperiode

Gibt die Periode an, in der das Modul das nächste Mal evaluiert wird (z.B. SS10).

module_short Kennung des Moduls

module_participants Enthält Verweise auf Teilnehmer, die an anderer Stelle in dem zu importierenden XML-Dokument definiert werden.

Hintergrund: So können die gleichen Teilnehmer verschiedenen Modulen zugeordnet werden.

module_instructors Verweist auf den Dozenten des Moduls

Hintergrund: So können die gleichen Dozenten verschiedenen Modulen zugeordnet werden.

supervisor_firstname Vorname des Modulverantwortlichen

supervisor_lastname Nachname Notwendiges Element.

supervisor_title Titel

supervisor_email E-Mail-Adresse dieser Die E-Mail-Adresse wird


39


Person benötigt, um Nachrichten, Fragebögen und Berichte an den Modulverantwortlichen zu senden.

supervisor_gender Geschlecht des Modulverantwortlichen (mögliche Werte: f/m)


supervisor_username Loginname des Modulverantwortlichen


supervisor_password Passwort des Modulverantwortlichen

Passwort für das EvaSys-System

supervisor_tel Telefonnummer des Modulverantwortlichen

supervisor_address Adresse dieser Person Adresse kann mehrzeilig angegeben werden (\n bewirkt einen Zeilenumbruch).

supervisor_language Sprache des Modulverantwortlichen

Wenn Sie die Sprache (z.B. englisch) beim Import festlegen, werden die Textvorlagen des Modulverantwortlichens in der entsprechenden Sprache angezeigt. Falls Sie mehrsprachige Fragebögen verwenden, wählt EvaSys beim Abrufen des Reports oder des Fragebogens in den Umfragendetails automatisch die entsprechende Sprache aus

supervisor_institutenumber Institutsnummer des Modulverantwortlichen

supervisor_formeditor_

access

Zugang zum Formulareditor als aktiver User (mögliche Werte: full/template/none; d.h.: uneingeschränkt/nur Vorlagen/Kein Zugriff)


supervisor_qmview_access Zugang zu den QM Ansichten (mögliche

Entspricht den Einstellungsmöglichkeiten


40


Werte: full/survey/ subunit/none; d.h.: uneingeschränkter Zugriff/Nur eigene Umfragen/Nur eigener Teilbereich/Keine QM-Ansichten)

beim manuellen Anlegen eines Benutzers (weitere Erläuterungen: siehe entsprechender Abschnitt im EvaSys-Handbuch).

survey Key-ID einer Umfrage Verknüpft das Modul mit einer Umfrage

Tabelle 24: Elemente zu einem Modul

6.1.3. Elemente der Veranstaltung (ModuleCourse) Die Elemente der Veranstaltung lauten: Element Inhalt Beschreibung

modulecourse_module Key-ID zum Modul Verbindet die Veranstaltung mit dem Modul. Notwendiges Element.

modulecourse_name Name der Veranstaltung Notwendiges Element.

modulecourse_short Veranstaltungs-ID Die Veranstaltungs-ID muss systemweit sowie für einen Dozenten eindeutig sein. Notwendiges Element.

modulecourse_room Raum

modulecourse_type Veranstaltungstyp Der Veranstaltungstyp muss zuvor in EvaSys definiert werden (s. entsprechendes Kapitel im Nutzerhandbuch).

modulecourse_turnout Teilnehmerzahl Wird für die Generierung von TANs bei Onlineumfragen sowie für Seriendruckvorgänge benötigt.

modulecourse_p_o_study Studiengang Verbindet eine Veranstaltung mit einem Studiengang.

modulecourse_coursefield1 Veranstaltungsfeld, das vom Benutzer definiert wird, Nr. 1

Inhalt des benutzerdefinierten Lehrveranstaltungsfeldes 1 (wird in EvaSys unter Einstellungen/ Konfiguration/ LV-Benutzerdatenfelder festgelegt: „Inhalt des ersten Zusatzfeldes“)

modulecourse_coursefield2 Veranstaltungsfeld, das vom Benutzer definiert

Inhalt des benutzerdefinierten Lehrveranstaltungsfeldes 2


41


wird, Nr. 2







modulecourse_instructors Hiermit beginnt die Liste der Dozenten.


Hier sind es die Dozenten eines Kurses in dem Modul.

Dieses Element kann das folgende Element modulecourse_instructor enthalten.

modulecourse_instructor Verweist auf den Dozenten des Moduls per Key-ID

Verbindet die Veranstaltung mit dem zugehörigen Dozenten

modulecourse_participants Enthält Verweise auf Teilnehmer, die an anderer Stelle in dem zu importierenden XML-Dokument definiert werden.


Hier sind es die Teilnehmer eines Kurses in dem Modul.

Dieses Element kann das folgende Element participant enthalten.

participant Verweist auf die Teilnehmer des Moduls per Key-ID

Verbindet die Veranstaltung mit den zugehörigen Teilnehmern

Tabelle 25: Elemente zu einer Veranstaltung


42

6.1.4. Elemente des Dozenten (Person) Die Elemente des Dozenten lauten wie folgt: Element Inhalt Beschreibung

firstname Vorname des Dozenten


title Titel

email E-Mail-Adresse des Dozenten

Die E-Mail-Adresse wird benötigt, um Nachrichten, Fragebögen und Berichte an den Dozenten zu senden.

gender Geschlecht des Dozenten (mögliche Werte: f/m)


formeditor_access Zugang zum Formulareditor als aktiver User (mögliche Werte: full/template/none; d.h. uneingeschränkt/nur Vorlagen/Kein Zugriff)


username Loginname des Dozenten Login für das EvaSys-System. Dieser Name kann in Kombination mit einer Authentifizierung am Verzeichnisserver verwendet werden (LDAP or Active Directory).

password Passwort des Dozenten Anmeldekennwort in EvaSys

tel Telefonnummer des Dozenten

address Adresse des Dozenten Adresse kann mehrzeilig angegeben werden (\n bewirkt einen Zeilenumbruch).

institutenumber Institutsnummer des Dozenten

person_subunit Key-ID zum Teilbereich Verbindet die Person mit dem


43


Teilbereich.


language Sprache des Dozenten Wenn Sie die Sprache (z.B. englisch) beim Import festlegen, werden die Textvorlagen des Nutzers in der entsprechenden Sprache angezeigt. Falls Sie mehrsprachige Fragebögen verwenden, wählt EvaSys beim Abrufen des Reports oder des Fragebogens in den Umfragendetails automatisch die entsprechende Sprache aus.

Tabelle 26: Elemente zu einem Dozenten





online = Onlineumfrage(TAN) codeword = Onlineumfrage(Losung) coversheet = Deckblattumfrage hardcopy = Selbstdruckumfrage

survey_codeword_method Wird survey_codeword_method

pswd = generiert die Losung wie eine TAN (5- oder 7-


44


(optional) nicht angegeben so wird „pswd“ verwendet – es sei den survey_codeword wurde angegeben.


stellig; Buchstaben & Zahlen) courseid = übernimmt den Wert aus der LV-Kennung coursefield1 = übernimmt den Wert aus dem LV-Benutzerdatenfeld 1 coursefield2 = übernimmt den Wert aus dem LV-Benutzerdatenfeld 2 coursefield3 = übernimmt den Wert aus dem LV-Benutzerdatenfeld 3 coursefield4 = übernimmt den Wert aus dem LV-Benutzerdatenfeld 4 coursefield5 = übernimmt den Wert aus dem LV-Benutzerdatenfeld 5






45


type Typ des Vorgangs (mögliche Werte: dipatch_pswd/remind_pswd/close_survey; d.h. Zugangsdaten versenden/Erinnerung versenden/Umfrage schließen)












46





firstname Vorname

lastname Nachname


title Titel

address Postadresse



custom3 benutzerdefiniertes Feld Tabelle 30: Elemente zu einem nicht-anonymen Teilnehmer

6.1.9. Zusätzlicher Import der Hauptmodulveranstaltung Beim XML-Import von Modulen kann eine ID für die Hauptmodulveranstaltung erstellt werden, um einen Teilnehmerimport zu ermöglichen. Sekundärdozenten können dann mit der Hauptveranstaltung verknüpft werden. Beim Modulimport entscheiden die Elemente <module_short> und <survey>, ob die Hauptmodulveranstaltung automatisch erstellt wird. Eines der Elemente muss vorhanden sein. Für die Hauptmodulveranstaltung ist es an dieser Stelle nicht relevant, ob wirklich Daten für die Umfrage in der XML-Datei vorhanden sind. Sind beide Elemente nicht angegeben, bedeutet das, dass erst beim manuellen Anlegen der Umfrage in EvaSys die Hauptmodulveranstaltung erstellt wird (und nicht beim Import). Wenn Sie die Hauptmodulveranstaltung auf diese Weise manuell (und nicht durch Import) erzeugen, werden beim Anlegen der ersten Modulumfrage die Teilnehmer der einzelnen Veranstaltungen dieses Moduls kopiert und zur erstellten Hauptmodulveranstaltung hinzugefügt.

Bitte beachten Sie, dass die Modulhauptveranstaltung automatisch angelegt wird, sobald Sie Dozenten direkt für ein Modul angeben.

6.2. Beispieldatei für den Modulimport Sie finden unter Systeminformationen – Beispieldateien einen komplette Beispieldatei zum Import von Modulen in EvaSys:

Abbildung 7: Beispieldatei Modulimport

7. Details zu den importierten Elementen Zusätzlich zu den Strukturdaten (Teilbereiche, Projekte, Themen) können Sie Umfragen, zeitgesteuerte Vorgänge von Onlineumfragen sowie Teilnehmerdaten importieren. In diesen Fällen muss die XML-Importdatei die entsprechenden Daten enthalten, die auch in der XSD beschrieben sind.



48

7.1. XML-Import von Umfragen Wenn EvaSys bei der Überprüfung zum Import von Strukturdaten auch Informationen zu Umfragen findet, sehen Sie vor dem eigentlichen Import eine entsprechende Information. Sie können dann entscheiden, ob Sie Umfragedaten importieren möchten oder nicht. Wenn Sie sich dafür entscheiden, zeigt das System anschließend eine Zusammenfassung der importierten Daten an. Falls es zu Fehlermeldungen während des Imports kommt, werden die Umfragen mit fehlerhaften Angaben nicht angelegt. Alle weiteren werden angelegt. (Mögliche Fehler wären z.B. eine Umfrage mit einem Formular, das in EvaSys nicht existiert, für eine Periode, die in EvaSys nicht existiert usw.) Sie können jedoch die XML-Datei korrigieren und erneut importieren. Schon angelegte Umfragen werden dadurch nicht mehr verändert, sondern nur noch die korrigierten hinzugefügt. In der Zusammenfassung der importierten Daten sehen Sie jeweils, welche Datensätze bereits bestehen (blau) und welche hinzugefügt werden (rot).

Bitte beachten Sie unbedingt: Es findet beim Import keine Prüfung statt, ob das verwendete Formular zugelassen ist für

• die Themenart, • den Teilbereich, • den Umfragentyp und • die Periode.

Diese Überprüfung wird nur durchgeführt, wenn Sie Umfragen manuell erzeugen!

Fügen Sie die Ergänzung im Element Topic (allgemeiner XML-Import) beziehungsweise im Element Module (Modul-XML-Import) ein. Um eine Umfrage zu definieren, muss zunächst ein Element „Topic“ einen Verweis auf eine Umfrage enthalten, z.B. in der Form: <survey><EvaSysRef type="Survey" key="Survey1"></survey>

Die Umfrage wird dann z.B. wie folgt definiert: <Survey key="Survey1">

<survey_form>DEMO_FB</survey_form>

<survey_period>Q4/2011 </survey_period>

<survey_type>online</survey_type>

<survey_verify>0</survey_verify>

</Survey>

Hiermit wird eine Onlineumfrage für den Fragebogen „DEMO_FB“ importiert, die im Q4/2011 ohne Verifikation stattfindet.


49

7.2. XML-Import der Zeitsteuerung von Onlineumfragen Zusätzlich zu den Umfragedaten können Sie die Zeitsteuerung von Umfragen importieren (geplante Vorgänge), sowie die E-Mail-Adressen der Empfänger, denen Sie die TANs über die zeitgesteuerten Vorgänge zusenden möchten. Die XML-Datei muss in diesem Fall um die Elemente für die Zeitsteuerung ergänzt werden. Wenn EvaSys bei der Überprüfung zum Import von Daten auch Informationen zu geplanten Vorgängen findet, sehen Sie vor dem eigentlichen Import eine entsprechende Information. Sie können dann entscheiden, ob Sie diese Umfragedaten importieren möchten oder nicht. Wenn Sie sich dafür entscheiden, zeigt das System anschließend eine Zusammenfassung der importierten Daten an. Falls es beim Import von geplanten Vorgängen zu Fehlern kommt, werden diese fehlerhaften Vorgänge gespeichert. Sie werden allerdings nicht ausgeführt, bevor diese Fehler behoben wurden. Es können folgende Fehler auftreten:

• falsche Absenderadresse,

• fehlende Absenderadresse,

• keine Empfänger,

• ungültiges Datum. Die importierten Fehler können Sie in der Liste der geplanten Vorgänge beheben. Dort ist erkennbar, welche Vorgänge fehlerhaft sind. Alternativ können Sie die geplanten Vorgänge auch über die Umfragedetails bearbeiten. Während Umfragen nur importiert werden, wenn die Umfrage im System noch nicht existiert, prüft EvaSys bei geplanten Vorgängen nur, ob der Vorgang deaktiviert ist. Will man den Import eines geplanten Vorgangs wiederholen, muss also zunächst der Vorgang deaktiviert werden.


50

Um zeitgesteuerte Vorgänge über XML zu importieren, muss der Verweis auf einen Vorgang zunächst ins Element „Survey“ eingefügt werden, z.B. als <survey_tasks>

<survey_task><EvaSysRef type="Task" key="Task1" /></survey_task>

</survey_tasks>

„Task1“ wird dann definiert, beispielsweise wie folgt:

<Task key="Task1">

<type>dispatch_pswd</type>

<datetime>2010-08-30 10:00</datetime>

<sender_name>Ernst Evaluation</sender_name>

<sender_email>[email protected]</sender_email>

<text>Sehr geehrter Gast,\n

Sie sind hiermit zur Teilnahme bei einer Onlinebefragung berechtigt.\n

Bitte folgen Sie dem unten stehenden Link. Ein Klick darauf öffnet den Fragebogen zur Umfrage [SURVEY].\n

Zur Teilnahme klicken Sie bitte hier: [DIRECT_ONLINE_LINK]\n

Vielen Dank vorab für Ihre Teilnahme und herzlichen Gruß,\n

Ernst Evaluation\n

Qualitätsbeauftragter</text>\n

<subject>Zugangsdaten zur Onlineumfrage [SURVEY]</subject>

<recipients>

<recipient>

<EvaSysRef type="Recipient" key="Recipient1" />

</recipient>

<recipient>

<EvaSysRef type="Recipient" key="Recipient2" />

</recipient>

</recipients>

</Task>

<Recipient key="Recipient1">

<email>[email protected]</email>

</Recipient>

<Recipient key="Recipient2">


</Recipient>


51

7.3. XML-Import von Teilnehmerdaten Zusätzlich zu den Strukturdaten können Sie Teilnehmerdaten importieren. Die XML-Datei muss in diesem Fall um die entsprechenden Elemente ergänzt werden.

Bitte beachten Sie, dass der Import eines Nachnamens (als „Schalter“) dafür sorgt, dass das Thema als nichtanonym gilt. Das heißt, dass alle importierten Teilnehmer als nichtanonym betrachtet werden, sobald bei einem einzigen Teilnehmer mindestens der Nachname vorhanden ist. Anonym sind die importierten Teilnehmer nur, wenn alle keinen Nachnamen haben.

Sie können die importierten Teilnehmer mit einem neuen Thema verknüpfen oder sie zu einem bereits existierenden Thema hinzufügen. Die Erweiterung erfolgt im Element Topic. Im folgenden Beispiel soll eine Teilnehmerin an einer Weiterbildungsveranstaltung („Helga Huber“) importiert werden. Da die Auswertung nicht-anonym erfolgen soll, sind außer der E-Mail-Adresse weitere Daten angegeben:

<Participant key="Participant1">


<firstname>Helga</firstname>

<lastname>Huber</lastname>

<gender>f</gender>

<title>Dr.</title>

<address>Kirschenallee 2, 12345 Musterstadt</address>

<custom1>Rehaklinik</custom1>

<custom2>Stationsärztin Innere</custom2>

<custom3>Erstkunde</custom3>

</Participant>

Beim Teilnehmerimport für Modulthemen erweitern Sie die Elemente Module sowie ModuleTopic.

Bitte beachten Sie, dass beim Import der Teilnehmerdaten die in den Details eines Themas hinterlegte Teilnehmeranzahl ignoriert wird. EvaSys speichert automatisch die Anzahl der importierten Teilnehmer.


52

Hinweis: Wenn Sie nach erfolgtem Import die Teilnehmerdaten noch einmal importieren möchten, können Sie die vorhandenen Teilnehmer über den Button [Löschen] beim CSV-Import entfernen. Anschließend importieren Sie die XML-Datei erneut. Die XML-Datei muss die gleichen Strukturdaten wie beim ersten Import haben, damit die bereits vorhandenen Teilbereiche, Themen und Projekte erkannt werden. Zusätzlich haben Sie die Möglichkeit, die vorhandenen Teilnehmerdaten in den Details eines Themas unter [Teilnehmer verwalten] zu bearbeiten.

Date post:	01-Aug-2018
Category:	Documents
Upload:	lamtruc
View:	215 times
Download:	0 times

Handbuch für den XML-Import V5 - evasys.hs … · Redaktion: Sandra Blomeyer, Dr. Iris Hille,...

Documents