上传用户

此页面尚未开始翻译，或者正在翻译过程中，正需要您来做贡献。 请点击左面导航条最末尾的“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 fieldnames: 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