ユーザのアップロード

再作成中です - Mitsuhiro Yoshida 2009年3月30日 (月) 09:48 (UTC)

ロケーション: サイト管理 > ユーザ > アカウント > ユーザのアップロード

ユーザのアップロードユーティリティは、Moodleにユーザ情報をアップロードする、シンプルですがパワフルな方法です。ユーザの作成のみ、またはユーザを作成して同時にコースへ登録することもできます。

• メモ: 最近のバージョンのMoodleでは、サイト管理者による個人的な手動ユーザ登録に加えて、サイト管理者がユーザ登録に関わらなくても良いツールが実装されています。例えば、外部データベースへの接続、またはユーザが独自にアカウントを作成する方法です。詳細は、サイト管理メニューの認証セクションをご覧ください。

ユーザデータのテキストファイルは、以下に示す特定のフォーマットに従う必要があります。

アップロードファイルのフォーマット

フラットファイルを使用して、ユーザをインポート、コースに登録、グループに入れることができます。

あなたが本当に複数のユーザをテキストファイルからインポートしたい場合、以下のようにテキストファイルの書式を合わせてください:

• それぞれの行には、1レコードを含んでください。
• それぞれのレコードを、カンマ区切りのデータにしてください。
• 最初の行は特別な行で、フィールド名を含みます。ここでは、ファイル内のデータフォーマットを定義します。

必須フィールド名: これらのフィールドを最初のレコードに含んで、それぞれのユーザに定義してください。

username, password, firstname, lastname, email

username、passwordおよびemailフィールドでは、妥当性チェックが実施されることを記憶してください。ユーザ名 (username) には、アルファベットまたは数字のみ含むことができ、アンダースコアは使用できませんが、ピリオド「.」は使用することができます。パスワードは、サイトのパスワードポリシーで指定された要件に合致する必要があります。emailには、有効なメールアドレスのフォーマットを使用してください。

デフォルトフィールド名: これらのフィールドは任意です - デフォルトフィールド名が含まれていない場合、主adminから値が取得されます:

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

任意フィールド名: これらは、完全に任意のフィールドです。コース名はコースの「shortnames」です - 存在する場合、ユーザは、存在するコースに学生として受講登録できます。グループ名は、対応するコースに関連付ける必要があります (例 course1にgroup1を割り当てる)。

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

ユーザプロファイルフィールド: すべてのユーザプロファイルフィールドまたはカスタムプロファイルフィールドは、次の形式で記述します (moodle 1.9): profile_field_<your_custom_field>。

ロールの修正: Moodle 1.7以降、ロールが追加されたため、登録に使うことのできる新しいフィールド名「role」が追加されました。あなたは、レガシー「type」フィールドの代わりに、直接ロールを指定するため、「role」フィールドを使用することができます - ロールの省略名またはIDを使用してください (ロールの数字名はサポートされていません)。

• データ内のカンマは「&#44」にエンコードしてください - スクリプトは、エンコードされたスクリプトを自動的にカンマに戻します。
• ブール型フィールドでは、偽 (false) の場合はゼロ、真 (true) の場合は1を使用します。
• 一致するコースが存在する場合、typeは、ユーザが学生なのか教師なのかをMoodleに伝えるため使用されます (例 type2はcourse2に一致します)。1 = 学生、2 = 編集権限のある教師、3 = 編集権限のない教師です。typeが空白の場合、またはコースが指定されていない場合、ユーザにはデフォルトとして学生が割り当てられます。
• パスワードの変更を強制する: パスワードの変更を希望するユーザのパスワードに「changeme」を設定してください。
• メールを無効にする: メールアドレスを無効にするには、パラメータ「emailstop」を「1」に設定してください。あなたが「1」に設定した場合、メールアドレスは有効となります。あなたがすべてのメールアドレスを有効にしたい場合、このパラメータをアップロードファイルに入れる必要はありません。
• courseには、コース省略名を使用してください。
• メモ: すでにユーザがMoodleユーザデーターベースに登録されている場合、このスクリプトは、そのユーザのユーザID (データベースインデックス) を戻して、他のデータを更新せず、指定されたコースにユーザを学生として受講登録します。

以下、有効なインポートファイルの例です:

username, password, firstname, lastname, email, lang, idnumber, maildisplay, course1, group1, type1
jonest, verysecret, Tom, Jones, jonest@someplace.edu, en_utf8, 3663737, 1, Junk102, Section 1, 1
reznort, somesecret, Trent, Reznor, reznort@someplace.edu, ja_utf8, 6736733, 0, Junk102, Section 3, 3

(Text copied from Upload users help file.)

既存のアカウントの更新

デフォルトでは、あなたが新しいアカウントを作成して、既存のアカウントと合致するレコードはスキップすると想定しています。しかし、あなたが「既存のアカウントを更新する」を「Yes」にした場合、既存のアカウントが更新されます。

既存のアカウントを更新する場合、あなたはユーザ名を変更することもできます。「リネームを許可する」を「Yes」に設定して、あなたのファイルにフィールド「oldusername」を含んでくださいｍ。

警告: 既存のアカウント更新時のエラーは、あなたのユーザに悪影響を及ぼします。更新時、このオプションは注意して使ってください。

エンコーディング

Moodle 1.9以前のバージョンでは、ファイルはあなたの言語パックと同じエンコーディングにする必要がありました。Moodle 1.7および1.8では、常にUTF-8です。

Moodle 1.9

Moodle 1.9以降のバージョンでは、エンコーディングを選択できるようになりました。

ユーザアップロードのプレビュー

ユーザアップロードのプレビュー (Moodle 1.9)

ヒント

スプレッドシート

.csvファイルを作成するため、あなたがExcel等のスプレッドシートプログラムを使用する場合、アップロード前に出力内容をテキストエディタで確認してください。It is possible to get trailing commas on each line from an empty field if you have added and deleted columns of information prior to saving the final file. Also check the character encoding. A csv file is a simple text file (ASCII or Unicode) that can be used to upload user accounts.

Also, Excel translates passwords that begin with - (minus) or + (plus) as zero. Even when saving as .csv and saying "Yes" to "Keep this format, and leave out any incompatible features." Check for this before uploading, as a zero halts the upload process.

国

The country should be written as a two letter code, e.g. BE for Belgium, NL for the Netherlands, and should be written in capitals. If not, it gets abbreviated to two letters, which can cause an invalid country entry in the database.

関連情報

• フラットファイル

Using Moodle forum discussions:

• Can I auto enroll from Excel?
• Making Email Optional
• Uploading users to custom roles