Globale Gruppen hochladen: Unterschied zwischen den Versionen

Aus MoodleDocs
Wechseln zu:Navigation, Suche
Keine Bearbeitungszusammenfassung
Zeile 4: Zeile 4:


Administrator(innen können eine oder mehrere globale Gruppen anlegen, indem sie ein speziell formatierte CSV-Datei hochladen.  
Administrator(innen können eine oder mehrere globale Gruppen anlegen, indem sie ein speziell formatierte CSV-Datei hochladen.  
Zum Hochladen dieser Datei klicken Sie auf der Seite ''[[Einstellungen-Block|Einstellungen]] > Website-Administration > Nutzer/innen > Nutzerkonten > Globale Gruppen'' auf den Reiter ''Globale Gruppen hochladen''.


Globale Gruppen können systemweit oder im Kontext eines [[Kursbereiche]]s angelegt werden.
Globale Gruppen können systemweit oder im Kontext eines [[Kursbereiche]]s angelegt werden.
Zeile 12: Zeile 10:
Der Ablauf ist folgendermaßen:
Der Ablauf ist folgendermaßen:


# Erstellen Sie eine CSV-Datei mit einer Spalte <pre>name</pre> und dem Namen der globalen Gruppe. Verwenden Sie für jede globale Gruppe eine neue Zeile.
# Erstellen Sie eine CSV-Datei, die die globale(n) Gruppe(n) enthält. Detaillierte Informationen zur Formatierung der Datei finden Sie im Abschnitt [[#Dateiformatierung|weiter unten]].
# Gehen Sie auf die Seite ''Administration > Site administration > Users > Accounts > Cohorts > Upload cohorts'
# Gehen Sie auf die Seite ''[[Einstellungen-Block|Einstellungen]] > Website-Administration > Nutzer/innen > Nutzerkonten > Globale Gruppen'' und klicken Sie auf den Reiter ''Globale Gruppen hochladen''.
# Add file to upload
# Wählen Sie die Datei aus oder ziehen Sie sie per Drag&Drop in das entsprechende Feld. Wählen Sie die Einstellungen ''CSV-Trenner'', ''Kodierung'' und ''Standardkontext'' (siehe [[#Einstellungen|unten]]).
# Upload cohort preview - review settings and check for any errors. If errors are reported with the file, correct as needed.
# Klicken Sie auf den Button ''Vorschau'' und prüfen Sie die Vorschauansicht auf mögliche Fehler.
# Upload cohorts - click "Upload cohorts"
# Klicken Sie auf den Button ''Globale Gruppen hochladen''. Nach dem erfolgreichen Hochladen wird angezeigt, wie viele Gruppen angelegt wurden.
# Upload cohorts results - shows how many cohorts were created
# Klicken Sie auf den Button ''Weiter'', um zurück zur Übersicht aller globalen Gruppen zu gelangen.
# Upload cohorts results - click "Continue"
# Returns to Upload users screen


===Settings===
===Einstellungen===
====File====
====CSV-Trenner====
The CSV formatted text file containing cohort data to be uploaded. See the [[cohort/upload#File_format_for_the_upload_cohorts_file|File format for the upload cohorts file]] section for more detailed information about the cohorts upload file.
 
====CSV delimiter====
The character used as a delimiter between fields in the cohort upload file. The delimiter separates the various fields on a single line. By default, a comma (',') is used as the delimiter; however, other options are available.
The character used as a delimiter between fields in the cohort upload file. The delimiter separates the various fields on a single line. By default, a comma (',') is used as the delimiter; however, other options are available.
; <pre>,</pre>  - uses the comma character as the field delimiter
; <pre>,</pre>  - uses the comma character as the field delimiter
Zeile 32: Zeile 25:
; <pre>\t</pre>  - uses \t (tab) as the field delimiter
; <pre>\t</pre>  - uses \t (tab) as the field delimiter


====Encoding====
====Kodierung====
You can specify the character encoding of the upload cohorts file. The default character encoding is UTF-8.
You can specify the character encoding of the upload cohorts file. The default character encoding is UTF-8.
====Default context====
 
====Standardkontext====
You can specify the default context to use from a list of available contexts. The default context is the System context (i.e. site-wide). A list of course categories will be listed and one of those course categories can be selected as the default context if one is not provided in the upload cohorts file. If the <code>contextid</code> (or one of the available fields to lookup the <code>contextid</code>) is provided, then that value will be used; however, if a contextid is not provided for a particular cohort the default context will be used.
You can specify the default context to use from a list of available contexts. The default context is the System context (i.e. site-wide). A list of course categories will be listed and one of those course categories can be selected as the default context if one is not provided in the upload cohorts file. If the <code>contextid</code> (or one of the available fields to lookup the <code>contextid</code>) is provided, then that value will be used; however, if a contextid is not provided for a particular cohort the default context will be used.


==File format for the upload cohorts file==
==Dateiformatierung==
The upload cohorts CSV text file has fields separated by a comma (or other delimiter).  The first line contains valid field names (preferrably lower case). The rest of the lines (records) contain information about each new cohort.
The upload cohorts CSV text file has fields separated by a comma (or other delimiter).  The first line contains valid field names (preferrably lower case). The rest of the lines (records) contain information about each new cohort.


Zeile 43: Zeile 37:
'':Tip:'' You can use a spreadsheet program to create the file with the required columns and fields. Then save the file as "CSV (comma delimited)". These files can then be opened with simple text editors for verification.  
'':Tip:'' You can use a spreadsheet program to create the file with the required columns and fields. Then save the file as "CSV (comma delimited)". These files can then be opened with simple text editors for verification.  


===Valid upload file for testing===
===Beispieldatei zum Testen===
Here is an example of a simple valid upload cohorts file:
Here is an example of a simple valid upload cohorts file:
(Column headers on the first line of the file are only highlighted in bold in this example to distinguish it from the rest of the of the data/user details)
(Column headers on the first line of the file are only highlighted in bold in this example to distinguish it from the rest of the of the data/user details)
Zeile 51: Zeile 45:
  Class of 2020,2020,Members of the Class of 2020
  Class of 2020,2020,Members of the Class of 2020


===Fields that can be included===
===Felder===


*'''Required fields''':  
*'''Required fields''':  

Version vom 18. Februar 2015, 14:44 Uhr

Neue Funktionalität
in Moodle 3.5!

Baustelle.png Diese Seite ist noch nicht vollständig übersetzt.


Administrator(innen können eine oder mehrere globale Gruppen anlegen, indem sie ein speziell formatierte CSV-Datei hochladen.

Globale Gruppen können systemweit oder im Kontext eines Kursbereiches angelegt werden.

Hochladen der Datei

Der Ablauf ist folgendermaßen:

  1. Erstellen Sie eine CSV-Datei, die die globale(n) Gruppe(n) enthält. Detaillierte Informationen zur Formatierung der Datei finden Sie im Abschnitt weiter unten.
  2. Gehen Sie auf die Seite Einstellungen > Website-Administration > Nutzer/innen > Nutzerkonten > Globale Gruppen und klicken Sie auf den Reiter Globale Gruppen hochladen.
  3. Wählen Sie die Datei aus oder ziehen Sie sie per Drag&Drop in das entsprechende Feld. Wählen Sie die Einstellungen CSV-Trenner, Kodierung und Standardkontext (siehe unten).
  4. Klicken Sie auf den Button Vorschau und prüfen Sie die Vorschauansicht auf mögliche Fehler.
  5. Klicken Sie auf den Button Globale Gruppen hochladen. Nach dem erfolgreichen Hochladen wird angezeigt, wie viele Gruppen angelegt wurden.
  6. Klicken Sie auf den Button Weiter, um zurück zur Übersicht aller globalen Gruppen zu gelangen.

Einstellungen

CSV-Trenner

The character used as a delimiter between fields in the cohort upload file. The delimiter separates the various fields on a single line. By default, a comma (',') is used as the delimiter; however, other options are available.

,
- uses the comma character as the field delimiter
;
- uses the semicolon character as the field delimiter
:
- uses the colon character as the field delimiter
\t
- uses \t (tab) as the field delimiter

Kodierung

You can specify the character encoding of the upload cohorts file. The default character encoding is UTF-8.

Standardkontext

You can specify the default context to use from a list of available contexts. The default context is the System context (i.e. site-wide). A list of course categories will be listed and one of those course categories can be selected as the default context if one is not provided in the upload cohorts file. If the contextid (or one of the available fields to lookup the contextid) is provided, then that value will be used; however, if a contextid is not provided for a particular cohort the default context will be used.

Dateiformatierung

The upload cohorts CSV text file has fields separated by a comma (or other delimiter). The first line contains valid field names (preferrably lower case). The rest of the lines (records) contain information about each new cohort.

:Tip: Avoid special characters in field information like quotes or other commas. Test a file with only one record before a large upload. :Tip: You can use a spreadsheet program to create the file with the required columns and fields. Then save the file as "CSV (comma delimited)". These files can then be opened with simple text editors for verification.

Beispieldatei zum Testen

Here is an example of a simple valid upload cohorts file: (Column headers on the first line of the file are only highlighted in bold in this example to distinguish it from the rest of the of the data/user details)

name,idnumber,description
Class of 2019,2019,Members of the Class of 2019
Class of 2020,2020,Members of the Class of 2020

Felder

  • Required fields:
name - the name of the cohort to be created
  • Optional fields: To provide values other than the default include one or more of the following optional fields:
contextid - used to specify the context id number of the cohorts you are uploading. For example, the context id number of a particular course category.
idnumber - used to provide an id number for the cohorts you are uploading
description - used to provide a description for the cohorts you are uploading
descriptionformat - used to specify the text format of the description. By default, the descriptionformat is set to the recommended value of 1 (FORMAT_HTML); however, values of 0 (FORMAT_MOODLE) and 2 (FORMAT_PLAIN) are also available. These format values are defined in lib/weblib.php.
visible - used to specify whether the cohorts you are uploading should be visible (1) or not (0).
  • Additional fields : If needed, there are some additional fields that while not normally used can be utilized. Additional fields typically require looking up information in other tables (such as the course categories or context tables). The additional fields provide an alternative way of finding the course category context id. A bit of extra caution is recommended in using these additional fields. The list of additional fields includes:
context - used to specify the name of the context name for each of the cohorts you are uploading.
category - used to specify the name of the category name for each of the cohorts you are uploading. For example, the category name of a particular course category.
category_id - used to specify the course category id (not idnumber) of the category for each of the cohorts you are uploading. For example, the course category id of a particular course category.
category_idnumber - used to specify the course category idnumber (not id) of the category for each of the cohorts you are uploading. For example, the course category idnumber of a particular course category.
category_path - used to specify the course category path of the category for each of the cohorts you are uploading. For example, the course category path of a particular course category.

Siehe auch