上传用户

此页面尚未开始翻译，或者正在翻译过程中，正需要您来做贡献。 请点击左面导航条最末尾的“English”查看原文，开始翻译。 如果您对翻译流程和Wiki语法不了解，请阅读贡献者指引。

   用户资料可以用文档的方式输入、选课以及编为小组。

   首先，请注意：通常情况下不必整批输入用户资料。为减轻工作量，你可以先看能否利用现有的数据库来进行认证，或是让用户自行创建他们自己的帐号，而无须你自己手工认证。有关认证参见管理员（admin）手册中的认证(Authentication)一节。  

   如果你确定要通过一个文本文档输入多位用户帐户资料，所用的文本文件必须按照以下格式组织数据：
   - 每一行只能包括一条记录；
   - 每一条记录由一系列以逗号（ASCII码的commans)分开的数据组成；
   -     * 檔案的第一筆(第一行)資料用來存放欄位名稱，定義出接下來的檔案格式。 
   Required fieldnames: these fields must be included in the first record, and defined for each user 

   username, password, firstname, lastname, email

   Default fieldnames: these are optional - if they are not included then the values are taken from the primary admin 

   institution, department, city, country, lang, auth, timezone

   Optional fieldn-ames: all of these are completely optional. The course names are the "shortnames" of the courses - if present then the user will be enrolled as students in those courses. Group names must be associated to the corresponding courses, i.e. group1 to course1, etc. 

   idnumber, icq, phone1, phone2, address, url, description, mailformat, maildisplay, htmleditor, autosubscribe, course1, course2, course3, course4, course5, group1, group2, group3, group4, group5, type1, type2, type3, type4, type5

   * Commas within the data should be encoded as &#44 - the script will automatically decode these back to commas.
   * For Boolean fields, use 0 for false and 1 for true.
   * Types are used to tell Moodle whether the user is a student or a teacher if a corresponding course exists (e.g. type2 corresponds to course2). 1 = Student, 2 = Editing Teacher, and 3 = Non-editing Teacher. If type is left blank, or if no course is specified, the user is default to student.
   * For courses, use the short name for the course
   * Note: If a user is already registered in the Moodle user database, this script will return the userid number (database index) for that user, and will enrol the user as a student in any of the specified courses WITHOUT updating the other specified data. 

Here is an example of a valid import file:

username, password, firstname, lastname, email, lang, idnumber, maildisplay, course1, group1, type1 jonest, verysecret, Tom, Jones, jonest@someplace.edu, en, 3663737, 1, Intro101, Section 1, 1 reznort, somesecret, Trent, Reznor, reznort@someplace.edu, en_us, 6736733, 0, Advanced202, Section 3, 3 [edit] Updating existing accounts

By default Moodle assumes that you will be creating new user accounts, and skips records where the username matches an existing account. However, if you set "Update existing accounts" to Yes, the existing user account will be updated.

When updating existing accounts you can change usernames as well. Set "Allow renames" to Yes and include in your file a field called oldusername.

Warning: any errors updating existing accounts can affect your users badly. Be careful when using the options to update. [edit] See also

   * Upload users help file also contains information on flat file formatting
   * How does flat file work? forum discussion
   * Can I auto enroll from Excel? forum discussion