上传用户

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

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

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

   如果你确定要通过一个文本文档输入多位用户帐户资料，所用的文本文件必须按照以下格式组织数据：
   - 每一行只能包括一条记录；
   - 每一条记录由一系列以逗号（ASCII码的commans)分开的数据组成；
   - 第一条记录（即第一行数据）是文件字段名称列表，它决定了该文件接下来的内容的格式 
     必需字段名： 下列字段必须包括在第一条记录中，用以确定每一位不同的用户 

     用户名, 密码, 名, 姓, 电子邮件地址

     默认字段名：下列字段是可选字段， 如果文档文件中未包括这些字段，将随后直接从初始管理员数据中调用if they are not included then the values are taken from the primary admin 

     院校, 系, 城市, 国家, 语言, auth, 时区

    可选字段名： 下列字段全部为完成可选字段。课程名称为课程的简称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. 

    编号, icq号, 电话号码1, 电话号码2, 地址, 统一资源定位器, 描述, 邮件格式, 邮件显示, html编辑器, 自动订阅, 课程1, 课程2, 课程3, 课程4, 课程5, 小组1, 小组2, 小组3, 小组4, 小组5, 类型1, 类型2, 类型3, 类型4, 类型5

   * 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