Einschreibung über IMS Enterprise Datei: Unterschied zwischen den Versionen

Aktuelle Version vom 30. April 2012, 12:56 Uhr

IMS Enterprise ist ein internationales Standard-XML-Datei-Format, das verwendet werden kann, um Einschreibungen und Abmeldungen in Kursen sowie Kurs- und Nutzerinformationen zu beschreiben. Die Einschreibung über IMS Enterprise Datei muss von der Moodle-Administration systemweit aktiviert werden: auf der Seite Einstellungen > Website-Administration > Plugins > Einschreibung > Übersicht (siehe Einschreibungs-Plugins verwalten).

Format-Übersicht

Im folgenden finden Sie eine Beschreibung der Grundstruktur einer IMS Enterprise Datei. Ausführliche Informationen gibt es auf der IMS Enterprise Website.

Informationen darüber, welche IMS-Daten-Elemente dieses Plugin verarbeiten kann, finden Sie hier.

Grundstruktur einer IMS Enterprise Datei

Für die IMS-Einschreibung benötigen Sie folgende Elemente:

ein <group>-Element, das den Kurs spezifiziert
ein <person>-Element, das ein Nutzerkonto spezifiziert und
ein <membership>-Element, das <member>-Elemente enthält, die die Rolle einer Person in einem Kurs spezifitzieren.

Hinweis: Beachten Sie, dass die IDs, die in der Moodle-Datenbank verwendet werden, nicht genutzt werden können: Ein externes System kann nie im Voraus wissen, dass Max Müller der 20. Nutzer in der Moodle-Datenbank ist!

Typischerweise wird ein Kurs einen Referenzcode und einen Namen haben. Der Referenzcode sei z.B. MOODLE101. In der IMS Enterprise Datei wird dieser Kurs wie folgt beschrieben:

 <group>
   <sourcedid>

MeinDatenSystem

     <id>MOODLE101</id>
   </sourcedid>
   <description>
     <short>Moodle 101</short>
   </description>
 </group>

Das Einschreibungs-Skript wird nach einem Kurs mit dem Refrenzcode MOODLE101 suchen und diesen Kurs anlegen, falls er noch nicht in Ihrem Moodle-System existiert.

Die Beschreibung einer Person, z.B. "jmoodle" lautet in der IMS Enterprise Datei wie folgt:

<person>
   <sourcedid>

MeinDatenSystem

     <id>jmoodle</id>
   </sourcedid>
   <userid>jmoodle</userid>
   <name>
     <fn>Joe Moodle</fn>
     <n>
       <family>MOODLE</family>
       <given>JOE</given>
     </n>
   </name>
 </person>

Wenn Joe noch kein Moodle-Nutzerkonto hat, wird das Einschreibungs-Skript dieses anlegen.

Die Zugehörigkeit einer Person in einem Kurs wird in der IMS Enterprise Datei wie folgt beschrieben:

 <membership>
   <sourcedid>

MeinDatenSystem

     <id>MOODLE101</id>
   </sourcedid>
   <member>
     <sourcedid>

MeinDatenSystem

       <id>jmoodle</id>
     </sourcedid>
     <role roletype="01">
       <status>1</status>
       <extension><cohort>unit 2</cohort></extension>
     </role>
   </member>
 </membership>

Die IMS Enterprise Specifikation bietet die Möglichkeit, Start- und Enddaten für die Einschreibedauer in einem Kurs anzugeben, diese Daten sind in einem <timeframe>-Element anzugeben.

Neue Kurse automatisch anlegen

Bei Bedarf kann das IMS Enterprise Einschreibungs-Plugin neue Kurse anlegen, wenn in der IMS Enterprise Datei Kurse spezifiziert sind, die es in der Moodle-Datenbank noch nicht gibt.

Kurse werden über die "idnumber" referenziert - ein Datenfeld in der Tabelle mdl_course in der Moodle-Datenbank, das verwendet wird, um den Kurs im externen Nutzerverwaltungssystem zu identifizieren. Wenn dieses Feld nicht gefunden wird, dann wird nach der Kurzbezeichnung des Kurses gesucht. Nur wenn ein Kurs dann immer noch nicht in der Moodle-Datenbank gefunden wurde, wird ein neuer Moodle-Kurs angelegt.

Auf diese Weise neu angelegte Kurse werden grundsätzlich VERBORGEN angezeigt. Auf diese Weise wird verhindet, dass Nutzer/innen Zugang zu inhaltlich leeren Kursen erhalten, die von den Trainer/innen erst noch mit Inhalten befüllt werden müssen.

Teilnehmer/innen und Trainer/innen abmelden

Bei Bedarf kann die IMS Enterprise Datei auch dazu verwendet werden, um Nutzer/innen aus einem Kurs abzumelden. Es gibt drei verschiedene Möglichkeiten:

ein <member>-Element, das eine Person und einen Kurs spezifiziert und dessen <recstatus-Attribut des <role>-Elements auf 3 (d.h. "löschen") gesetzt ist. DAS IST DERZEIT NOCH NICHT IMPLEMENTIERT.
ein <member-Element, das eine Person und einen Kurs spezifiziert und bei dem das <status>-Element auf 0 gesetzt ist (d.h. "inaktiv").

Die dritte Methode kann verwendet werden, ohne dass in den Einstellungen zur IMS ENterprise Einschreibung die Abmeldung von Nutzer/innen aktiviert werden muss:

ein <member>-Element mit einem ein <timeframe>-Element für Beginn und Ende des Einschreibezeitraums. Wenn diese Einträge vorhanden sind, werden die Daten in der Moodle-Datenbank abgespeichert, und nach Ende des Abmeldezeitraums sorgt Moodle automatisch dafür, dass die Nutzer/innen aus dem Kurs abgemeldet werden.

Siehe auch

IMS Enterprise specification - offizielle Website
Conformance summary - Zusammenfassung, welche Teile der Spezifikation Moodle verwendet
Minted IMS Enterprise enrolment plugin - Weiterentwicklung des Plugins durch minted project

@@ Zeile 1: / Zeile 1: @@
 {{Einschreibung}}
-{{Zum Übersetzen}}
+'''IMS Enterprise''' ist ein internationales Standard-XML-Datei-Format, das verwendet werden kann, um Einschreibungen und Abmeldungen in Kursen sowie Kurs- und Nutzerinformationen zu beschreiben. Die [[Einschreibung über IMS Enterprise Datei]] muss von der Moodle-Administration systemweit aktiviert werden: auf der Seite ''[[Einstellungen-Block|Einstellungen]] > Website-Administration > Plugins > Einschreibung > Übersicht'' (siehe [[Einschreibungs-Plugins verwalten]]).
-Location: IMS Enterprise file edit settings link in ''Site administration > Plugins > Enrolments > Manage enrol plugins''
-'''IMS Enterprise''' is an international standard XML file format which may be used to specify enrolments/unenrolments in courses, as well as course information and user information.
-==Format overview==
+==Format-Übersicht==
+Im folgenden finden Sie eine Beschreibung der Grundstruktur einer IMS Enterprise Datei. Ausführliche Informationen gibt es auf der [http://www.imsglobal.org/enterprise/ IMS Enterprise Website].
-Below is a simple guide to the basic structure of a typical IMS Enterprise data file. Much more information is available on the [http://www.imsglobal.org/enterprise/ IMS Enterprise official website].
+Informationen darüber, welche IMS-Daten-Elemente dieses Plugin verarbeiten kann, finden Sie [http://cvs.moodle.org/contrib/plugins/enrol/imsenterprise/entv1p1_conformance_summary.html?view=co hier].
-You may like to read the [http://cvs.moodle.org/contrib/plugins/enrol/imsenterprise/entv1p1_conformance_summary.html?view=co conformance summary] which describes which IMS data elements this plugin can process.
+===Grundstruktur einer IMS Enterprise Datei===
-==Basic guide to IMS Enterprise file format==
+Für die IMS-Einschreibung benötigen Sie folgende Elemente:
+*ein <code><</code><code>group></code>-Element, das den Kurs spezifiziert
+*ein <code><</code><code>person></code>-Element, das ein Nutzerkonto spezifiziert und
+*ein <code><</code><code>membership></code>-Element, das <code><</code><code>member></code>-Elemente enthält, die die Rolle einer Person in einem Kurs spezifitzieren.
-For any IMS-style enrolment you need a <group> tag which specifies the course, a <person> tag which specifies the user account, and a <membership> tag containing <member> tags which specify a person's role within a given course.
+'''Hinweis''': Beachten Sie, dass die IDs, die in der Moodle-Datenbank verwendet werden, nicht genutzt werden können: Ein externes System kann nie im Voraus wissen, dass Max Müller der 20. Nutzer in der Moodle-Datenbank ist!
-Remember that the numeric keys used in the Moodle databases are not the interoperable data - a student data system is never going to know in advance that Joe is the 20th user added to the Moodle database - so those aren't the keys exchanged in this type of data.
+Typischerweise wird ein Kurs einen Referenzcode und einen Namen haben. Der Referenzcode sei z.B. MOODLE101. In der IMS Enterprise Datei wird dieser Kurs wie folgt beschrieben:
-Typically a course would have a reference code as well as a name, so let's assume its code is MOODLE101. To define your course you could use
    <group>
      <sourcedid>
-       <source>MyDataSystem</source>
+       <source>MeinDatenSystem</source>
        <id>MOODLE101</id>
      </sourcedid>
@@ Zeile 30: / Zeile 30: @@
    </group>
-The enrolment script will look for a course with code MOODLE101, and (optionally) create it if it doesn't exist. Similarly for the person - let's assume it's "jmoodle":
+Das Einschreibungs-Skript wird nach einem Kurs mit dem Refrenzcode MOODLE101 suchen und diesen Kurs anlegen, falls er noch nicht in Ihrem Moodle-System existiert.
+Die Beschreibung einer Person, z.B. "jmoodle" lautet in der IMS Enterprise Datei wie folgt:
   <person>
      <sourcedid>
-       <source>MyDataSystem</source>
+       <source>MeinDatenSystem</source>
        <id>jmoodle</id>
      </sourcedid>
@@ Zeile 47: / Zeile 49: @@
    </person>
-If Joe doesn't already have an account, the script can (optionally) create an account for him.
+Wenn Joe noch kein Moodle-Nutzerkonto hat, wird das Einschreibungs-Skript dieses anlegen.
-Let's now look at the membership, adding the person to the course:
+Die Zugehörigkeit einer Person in einem Kurs wird in der IMS Enterprise Datei wie folgt beschrieben:
    <membership>
      <sourcedid>
-       <source>MyDataSystem</source>
+       <source>MeinDatenSystem</source>
        <id>MOODLE101</id>
      </sourcedid>
      <member>
        <sourcedid>
-         <source>MyDataSystem</source>
+         <source>MeinDatenSystem</source>
          <id>jmoodle</id>
        </sourcedid>
@@ Zeile 68: / Zeile 70: @@
    </membership>
-The IMS Enterprise specification does offer a facility for specifying start/end dates for enrolments, so those can be included using the <timeframe> tag if needed.
+Die IMS Enterprise Specifikation bietet die Möglichkeit, Start- und Enddaten für die Einschreibedauer in einem Kurs anzugeben, diese Daten sind in einem <code><timeframe></code>-Element anzugeben.
-If a person is already added to a group within the course, the script won't actually modify that. If they are not grouped, however, then the specified grouping will be applied.
-==Automatic creation of new courses==
-If required, the IMS Enterprise enrolment plugin can create new courses for any it finds in the IMS data but not in Moodle's database.
-Courses are first queried by their "idnumber" - an alphanumeric field in Moodle's course table, which can specify the code used to identify the course in the Student Information System (for example). If that is not found, the course table is searched for the "short description", which in Moodle is the short course identifier as displayed in the breadcrumbs etc. (In some systems these two fields may well be identical.) Only when that search has failed can the plugin optionally create new courses.
-Any newly-generated courses are HIDDEN when created. This is to prevent the possibility of students wandering into completely empty courses that the teacher may be unaware of.
+==Neue Kurse automatisch anlegen==
+Bei Bedarf kann das IMS Enterprise Einschreibungs-Plugin neue Kurse anlegen, wenn in der IMS Enterprise Datei Kurse spezifiziert sind, die es in der Moodle-Datenbank noch nicht gibt.
-==Unenrolling students/teachers==
+Kurse werden über die "idnumber" referenziert - ein Datenfeld in der Tabelle <code>mdl_course</code> in der Moodle-Datenbank, das verwendet wird, um den Kurs im externen Nutzerverwaltungssystem zu identifizieren. Wenn dieses Feld nicht gefunden wird, dann wird nach der Kurzbezeichnung des Kurses gesucht. Nur wenn ein Kurs dann immer noch nicht in der Moodle-Datenbank gefunden wurde, wird ein neuer Moodle-Kurs angelegt.
-If required, the Enterprise data can add as well as remove course enrolments - for students and for teachers. If this setting is turned on, then Moodle will carry out unenrolments when specified in the data.
+Auf diese Weise neu angelegte Kurse werden grundsätzlich VERBORGEN angezeigt. Auf diese Weise wird verhindet, dass Nutzer/innen Zugang zu inhaltlich leeren Kursen erhalten, die von den Trainer/innen erst noch mit Inhalten befüllt werden müssen.
-There are three ways of unenrolling students within the IMS data:
+==Teilnehmer/innen und Trainer/innen abmelden==
-* A <member> element which specifies the given student and course, and with the "recstatus" attribute of the <role> element set to 3 (which means "delete"). THIS IS NOT YET IMPLEMENTED IN THE MOODLE PLUGIN.
+Bei Bedarf kann die IMS Enterprise Datei auch dazu verwendet werden, um Nutzer/innen aus einem Kurs abzumelden. Es gibt drei verschiedene Möglichkeiten:
-* A <member> element which specifies the given student and course, and with the <status> element set to 0 (which means "inactive").
-The third method is slightly different. It does not require this config setting to be activated, and can be specified well in advance of the unenrolment date:
+* ein <code><</code><code>member></code>-Element, das eine Person und einen Kurs spezifiziert und dessen <code><</code><code>recstatus</code>-Attribut des <code><</code><code>role></code>-Elements auf 3 (d.h. "löschen") gesetzt ist. '''DAS IST DERZEIT NOCH NICHT IMPLEMENTIERT'''.
+* ein <code><</code><code>member</code>-Element, das eine Person und einen Kurs spezifiziert und bei dem das <code><</code><code>status></code>-Element auf 0 gesetzt ist (d.h. "inaktiv").
-* A <member> element which specifies a <timeframe> for the enrolment can specify the begin and/or end dates for enrolment of this particular student. These dates are loaded into Moodle's enrolment data table if present, and so after the end-date, a student will no longer be able to access that particular course.
+Die dritte Methode kann verwendet werden, ohne dass in den Einstellungen zur IMS ENterprise Einschreibung die Abmeldung von Nutzer/innen aktiviert werden muss:
+*ein <code><</code><code>member></code>-Element mit einem ein <code><</code><code>timeframe></code>-Element für Beginn und Ende des Einschreibezeitraums. Wenn diese Einträge vorhanden sind, werden die Daten in der Moodle-Datenbank abgespeichert, und nach Ende des Abmeldezeitraums sorgt Moodle automatisch dafür, dass die Nutzer/innen aus dem Kurs abgemeldet werden.
 ==Siehe auch==

Documentation