moodle/lang/en/help/uploadgroups.html

34 lines
1.8 KiB
HTML
Executable File

<h1>Upload groups</h1>
<p>This facility allows the batch upload of groups into Moodle.</p>
<ul>
<li>Each line of the file contains one record</li>
<li>Each record is a series of data separated by commas</li>
<li>The first record of the file is special, and contains a list of fieldnames. This defines the format of the rest of the file.
<blockquote>
<p><strong>Required fieldnames:</strong> these fields must be included in the first record, and defined for each user</p>
<p></p>
<code class="example1">groupname</code>
<p><strong>Default fieldnames:</strong> these are optional - if they are not included then the values are taken from the current language and current course</p>
<p><code class="example1">idnumber, coursename, lang</code> </p>
<p><strong>Optional fieldnames: </strong>all of these are completely optional. </p>
<p> <code class="example1">description, enrolmentkey, picture, hidepicture</code></p>
</blockquote>
</li>
<li>Commas within the data should be encoded as &amp;#44 - the script will automatically decode these back to commas. </li>
<li>For Boolean fields, use 0 for false and 1 for true. </li>
<li>Either idnumber or coursename can be used to identify the course. Idnumber overrides coursename. If neither is specified, the groups will be added to the current course. </li>
<li>Coursename is the course shortname.</li>
<li>Note: If a group is already registered in the Moodle database for a particular course, this script will return the
group name for that group. Teachers are only allowed to upload groups in courses they are authorized to edit.</li>
</ul>
<p>Here is an example of a valid import file:</p>
<p><code>groupname,idnumber,lang,description,picture <br />
group1, Phil101, en, this group requires extra attention!, 0 <br />
group2, Math243, , ,
</code></p>