テキストファイルを介したユーザーのアップロード
この方法で情報（ユーザーに関連付けられたフィールド）をアップロードするには、コース固有のロールを持つ複数のコースへのユーザーの登録からユーザプロファイルのユーザー情報の更新、ユーザーの削除まで、多くのオプションがあります。サイト。
ヒント： 通常、ユーザーのアップロードを使用してユーザーを一括でアップロードする必要はありません。メンテナンス作業を最小限に抑えるには、既存の外部データベースへの接続やユーザーが自分のアカウントを作成できるようにする（自己登録）など、手動メンテナンスを必要としない認証形式を最初に検討する必要があります。 。詳細については、認証を参照してください。
ユーザーアップロードファイルのファイル形式
ユーザーのアップロードファイルには、カンマ（またはその他の区切り文字）で区切られたフィールドのみがあります-スペースはありません。最初の行には、有効なフィールド名が含まれています。残りの行（レコード）には、各ユーザーに関する情報が含まれています。
ヒント： 引用符や他のコンマなどのフィールド情報には特殊文字を使用しないでください。大規模なアップロードの前に、1つのレコードのみでファイルをテストします。
ヒント： スプレッドシートプログラムを使用して、必要な列とフィールドを含むファイルを作成できます。次に、ファイルを「CSV（カンマ区切り）」として保存します。これらのファイルは、確認のためにシンプルなテキストエディタ（Notepad ++など）で開くことができます。
テスト用の有効なアップロードファイル
新機能
Moodle 3.x!
- サイト管理/ユーザー/ユーザーのアップロードから、テキスト（.csv）ファイルの例を入手できます。それはダウンロードしてあなたのニーズに適応させることができます。
ユーザー名,名,姓,メール
student1,Student,One,s1@example.com
student2,Student,Two,s2@example.com
student3,Student,Three,s3@example.com
- 追加フィールドは以下のように追加できます。コースとコーホートはすでに手動で作成されている必要があります。
ユーザー名,名,姓,メール,コース1,グループ1,コーホート1
student1,Student,One,s1@example.com,math102,groupA,cohortZ
student2,Student,Two,s2@example.com,math102,groupB,cohort Y
student3,Student,Three,s3@example.com,math102,groupA,cohortZ
含めることができるユーザーフィールド
ヒント： 初めてファイルをアップロードする前に、1人のユーザーで使用することを提案したフィールドを含むファイルをテストすることを強くお勧めします。
必須フィールド
これらは、必須のユーザー識別フィールドです。
username,firstname,lastname,email
妥当性検査は以下に対して実行されます。
- usernameには、アルファベットの lowercase文字、数字、ハイフン '-'、アンダースコア '_'、ピリオド '.'、またはアットマーク '@'のみを含めることができます
- emailの形式： name@example.com
パスワード
アップロード画面の[新しいユーザーパスワード]設定が[必要に応じてパスワードを作成してメールで送信する]に設定されている場合、[パスワード]フィールドはオプションですが、[ファイルに必要なフィールド]の場合は必須です。
含める場合、値はサイトのパスワードポリシーの要件を満たす必要があります。
特定のユーザーのパスワード変更を強制するには、パスワードフィールドを changemeに設定します。省略した場合、各ユーザー（次のCronジョブの実行中）のパスワードが生成され、ウェルカムメールが送信されます。ウェルカムメールのテキストは、「サイト管理>言語>言語のカスタマイズ」の言語設定にあり、文字列識別子は「newusernewpasswordtext」です。
オプションのユーザーフィールド
注：フィールド内のカンマは,としてエンコードする必要があります-スクリプトはこれらをカンマにデコードします。 ヒント：値が2つしかないブール型フィールドの場合、falseには 0を、trueには 1を使用します。
デフォルト以外の値を提供するには、以下のオプションのユーザーフィールドを1つ以上含めることができます。
institution,department,city,country,lang,auth,timezone,idnumber,icq,phone1,phone2,address,url,description,mailformat,maildisplay,maildigest,htmleditor,autosubscribe,interests,theme
これらのほとんどは、ユーザープロファイルに属するユーザープロファイルフィールドまたはユーザー設定フィールドであり、ユーザーが入力するか手動で作成するときに入力されます。ただし、特定の形式が必要なものもあります。
詳細については、追加氏名フィールドを参照してください。注意すべき重要な点は次のとおりです。
country-大文字の国で2つの文字コードを使用します（例：AU、ES、GB、US）。これらはすべて大文字です。国コードとして「au」、「es」、または「USA」を使用すると、データベースエラーが発生します。国の2文字のコードをうまく処理できない場合は、ISO Webサイトで入手可能な国名とコード要素のリストを参照してください。 。一般的なエラーは、英国にUKを使用することです。 GBにする必要があります。
lang-Moodle言語パックで定義されている2文字（または拡張4文字）コードを使用します。 en、es、en_us、de、「サイト管理>言語>言語パック」。
auth-サイトがLDAPなどの代替認証方法を使用している場合は、authフィールドを使用する必要があります。そうでない場合、認証方法はデフォルトで手動になり、別の認証方法を使用しているユーザーはログに記録できませんに。 プラグイン>認証で定義された短縮名コードをさまざまなタイプに使用します。マニュアル、nlogin、ldap、cas、mnet、db、なし。 auth列を含めない場合、新しく作成されたユーザーは手動のアカウントタイプで作成されます。
csvファイルで「auth」を「nologin」に設定すると、作成されたユーザーはログインできなくなります。
timezone-ゾーン/地域の観点から、ロケーション設定にある形式である必要があります。オーストラリア/シドニー、アジア/カトマンズ、ヨーロッパ/マドリードなど。エントリでは大文字と小文字が区別されるため、ヨーロッパ/ロンドンは機能しますが、ヨーロッパ/ロンドンは機能しません。
注：必須： mailformat、 maildisplay、 htmleditor、 autosubscribeの設定
maildigestユーザーがコースや強制購読フォーラムから大量のメールを受信しないようにするには、 maildigestを使用します。このフィールドのオプションは、0 =ダイジェストなし、1 =完全なダイジェスト、2 =主題のみのダイジェストです。 maildisplay を使用すると、ユーザーのメール表示オプションを設定できます。このフィールドのオプションは、「0」=非特権ユーザーからメールアドレスを非表示にする、「1」=すべてのユーザーに私のメールアドレスの表示を許可する、「2」=他のコースメンバーのみに私のメールアドレスの表示を許可する。
themeユーザーテーマは、「classic」、「boost」、またはインストールされている他のテーマの名前を使用して追加できます。値はテーマの短い名前である必要があります。たとえば、「ブースト」ではなく「ブースト」、「フォードソン」ではなく「フォードソン」です。
カスタムプロファイルフィールド名
これらはオプションであり、サイトでカスタムプロファイルフィールドを作成したかどうかによって異なります。ファイル内のヘッダーの名前は「profile_field_xxxxx」の形式です。ここで、xxxxは、作成したカスタムユーザープロファイルフィールド名の一意のショートネームです。
フィールド名は、プロファイルフィールドの短縮名の大文字小文字と一致する必要があります。したがって、たとえば、カスタムプロファイルフィールドの短縮名がすべて大文字の場合（例： DOB ）、ヘッダーの profile_field_DOB ではなく profile_field_dob を使用して大文字と小文字を一致させます。 「有効なフィールド名ではありません」エラーを生成します。同様に、 Dob のような大文字と小文字が混在する短縮名には、 profile_field_Dob のヘッダーが必要です。 （これの例外は、ショートネームがすべて小文字である場合、フィールドヘッダーではどのケースでも機能します。これは歴史的な癖ですが、ベストプラクティスはケースを一致させることであり、エラーを回避します。）
profile_field_xxxxx
'例' ：カスタムフィールド "genre"を作成するには、新しいフィールドに略称 "genre"を書き込み、.csvファイルのヘッダーに "profile_field_genre"を書き込む必要があります。
日付であるカスタムプロファイルフィールドの場合、ISO標準形式YYYY-MM-DDを使用します。その後、インターフェースで適切にローカライズされます。たとえば、入社日を表すdohireというフィールドは、次のようになります。
username,firstname,lastname,email,profile_field_dohire blumbergh,Bill,Lumbergh,blumbergh@example.com,1990-02-19 pgibbons,Peter,BGibbons,pgibbons@example.com,1996-06-05 tsmykowski,Tom,Smykowski,tsmykowski@example.com,1970-01-01
メニューであるカスタムプロファイルフィールドの場合、定義したとおりに、メニューリストのフィールドの対応する値を使用します。例：カスタムフィールド「corporatedivision」。3つの値「Management」、「Development」、または「Training」のいずれか。その3つの単語（「トレーニング」など）の1つをそのフィールドの値として挿入するだけです。例えば。
username,firstname,lastname,email,profile_field_corporatedivision blumbergh,Bill,Lumbergh,blumbergh@example.com,Management pgibbons,Peter,BGibbons,pgibbons@example.com,Development tsmykowski,Tom,Smykowski,tsmykowski@example.com,Training
特別なユーザー変更フィールド
ユーザーアカウントの管理には、 oldusername、 deleted、および suspendedの3つの特別なフィールドが使用されます。 詳細は以下を参照してください。
登録フィールド
オプションで、手動登録を使用して既存のコースにユーザーを登録できます。この方法で手動登録のみが行われます。コースで手動登録方法が無効になっている場合、登録は行われません。
このタイプのアップロードファイルのフィールドを使用します。
course1,type1,role1,group1,enroltimestart1,enrolperiod1,enrolstatus1,course2,type2,role2,group2,enroltimestart2,enrolperiod2,enrolstatus2
など。
ヘッダーフィールド mustには、type1、role1、group1、enrolperiod1およびenrolstatus1がすべてコース 1からコース nのコース1に適用されるように数値のサフィックスが付いています。コースの登録を1つだけ行っている場合でも、見出し名に数字の1を使用する必要があります。つまり、course1、role1などです。数字のない裸の見出しは使用しないでください。もちろん、これらはエラーを生成するため、ロールなど。
course#はコースの短縮名です。存在する場合、ユーザーはそのコースに登録されます。コースのフルネームは使用しないでください。使用するとエラーが発生します。このフィールドは、登録を成功させるための唯一の必須フィールドです。他のすべてはオプションです。
type#は、登録に使用される役割を設定します。値1はデフォルトのコースロール、2は従来の教師ロール、3は従来の非編集教師です。
role#は、ロールのショートネームまたはロールIDのいずれかを使用して、ロールを直接指定するために使用できます（ロールの数値名はサポートされていません）。通常は、[ユーザー]> [権限]> [役割の定義]で定義されている役割の短縮名である役割名を使用します。学生、編集教師。役割の列を省略すると、ユーザーはデフォルトの役割（通常は学生）でコースに登録されます。
group#は、名前またはIDを使用して、ユーザーをグループに割り当てるために使用できます（数値のグループ名はサポートされていません）。注：グループがまだ存在しない場合は、作成されます。
enroltimestart#は、各コースの登録開始時間を設定するために使用できます。ここで明示的に設定しない場合、登録開始時刻は今日に設定されます。
enrolperiod#は、各コースの登録期間を日数で設定するために使用できます。ここで明示的に設定しない場合、すべてのユーザーがコースの手動登録メソッドで設定された期間を取得します（デフォルトは0で、無制限を意味します）。
enrolstatus#はオプションです。デフォルトでは、新しく登録されたすべてのユーザーがアクティブに設定されています。値1を使用すると、コース内のユーザーが一時停止され、ユーザーが以前に非アクティブ/一時停止として設定されていた場合、値0はユーザーの一時停止を解除して再度アクティブにします。
コーホートメンバーシップの割り当て
ファイル内に２つのフィールド「ユーザー名」「コーホートID」のみを書いて、既存のコーホートにユーザを割り当てることができます。これは、ユーザの名、姓、および電子メールアドレスが必要な通常の場合とは違い、例外的なことであることに注意してください。
cohort#は、使用するフォームであり、コースへの登録と同様に、各ヘッダーに番号を追加する必要があり、cohort1, cohort2 などと書くことになります。
内部コーホートID番号または既存のコーホートの非数値のコーホートIDを使用する必要があります。フルネームを使用しないでください。 （コーホートIDは、通常「ショートネーム」として他で知られているものです。）
以下はサンプルCSVファイルです。
username,cohort1,cohort2 student1,nursing,2016class student2,nursing,2014class student3,nursing,2014class
MNet
既存のMNetユーザーは、フィールドヘッダー mnethostidを使用して、以下のようにコース、グループ、またはコーホートに追加できます
- コースへの登録：ユーザー名+ mnethostid +コースが必要です
- グループに追加：ユーザー名+ mnethostid +コース+グループが必要
- コーホートに追加：ユーザー名+ mnethostid +コーホートが必要
- suspending/reviving accounts：username + mnethostid + suspended required
他のすべての操作は無視されます。ユーザーの追加、削除、更新はできません（名前やメールアドレス、プロフィールフィールドの変更など）。
システムの役割を設定
ユーザーは、システムコンテキストが定義された役割の サイト管理>ユーザー>権限>役割の定義 で定義されているシステム役割の短縮名を使用して、既に定義されているシステム役割に割り当てることもできます。
sysrole1,sysrole2,sysrole3 など
ユーザーは、システムロール（通常はマネージャーまたはコース作成者）に、そのロールの短縮名を入力することでアップロードできます。他のロールは、「システム」コンテキストですでに割り当てられている場合にのみアップロードできます。 カスタムロールの作成を参照してください。 sysrole2、sysrole3などのフィールドを使用して、複数の役割を割り当てることができます。番号サフィックスは、登録フィールドの番号サフィックスとはまったく関係がないことに注意してください。番号は1から順に増加する必要があります。
システムロールの割り当て解除 マイナス記号「-」を前に付けて、その役割の短縮名を入力することにより、特定のシステム役割からユーザーを削除することもできます。ユーザーが現在その役割に割り当てられている場合、その役割から削除されます。ユーザーが現在そのシステムロールに割り当てられていない場合、フィールド値は無視されます。ただし、フィールド値はシステムに存在するシステムロールを参照する必要があります。そうでない場合、エラーが発生します。
ユーザープロセスのアップロード
- アップロード用のファイルを作成
- 「サイト管理>ユーザー>アカウント>ユーザーのアップロード」に移動します
- アップロードするファイルを追加
- ユーザープレビューをアップロードする-設定とデフォルトのユーザープロファイル設定を確認する
- ユーザープレビューのアップロード-[ユーザーのアップロード]をクリックします
- ユーザーのアップロード結果-ユーザーのリスト、アップロードで行われた例外、ユーザー数の概要が表示されます
- ユーザーの結果をアップロードする-[続行]をクリックする
- ユーザーのアップロード画面に戻ります
ユーザープレビューの更新
目的のアップロード動作をより適切に制御するためのさまざまな設定があります。これらの設定は、[ユーザーのプレビューをアップロード]ページにあります。
警告：既存のアカウントの更新エラーは、ユーザーに悪影響を及ぼす可能性があります。更新のオプションを使用するときは、 注意してください。
アップロードタイプ
アップロードタイプは、既存のアカウントの処理方法を指定します。
- 新規追加のみ、既存のユーザーをスキップ
- デフォルトのMoodleアップロードタイプです。アップロードされたファイルの新しいレコードごとに新しいユーザーアカウントを作成します。アップロードされたファイルで既存のユーザー名が見つかった場合、既存のユーザー名と一致すると、そのレコードは「スキップ」されます。既存のユーザーアカウントをスキップすることで、既存のレコードのデータは変更されず（[既存のユーザーを追加して更新]オプションとは対照的）、2番目の新しいユーザーアカウントが作成されます（ "とは異なります"） 「すべて追加、必要に応じてユーザー名に番号を追加する」オプション）。
- すべて追加し、必要に応じてユーザー名に番号を追加します
- アップロードされたファイルの各レコードに新しいユーザーアカウントを作成します。既存のユーザーアカウントが見つかった場合は、ユーザー名に番号が追加された新しいアカウントが作成されます。たとえば、ユーザー名「jsmith」のユーザーアカウントがすでに存在し、アップロードされたファイルの新しいレコードにユーザー名「jsmith」のレコードが含まれている場合、作成するユーザー名に「1」が追加された追加のユーザーアカウントが作成されますユーザー「jsmith1」。
- 新しいユーザーを追加して既存のユーザーを更新
- アップロードファイル内の新しいユーザーごとに新しいユーザーアカウントを作成します。同じユーザー名の既存のユーザーアカウントが見つかった場合、アカウント情報はアップロードされたファイルのデータによって「 更新 」されます。
- 既存のユーザーのみを更新
- アップロードファイルで見つかった新しいユーザーを無視し、アップロードされたファイルで一致するユーザー名レコードが見つかった場合はユーザーアカウントを更新します。
新しいユーザーのパスワード
新しいユーザーアカウントを作成するとき、Moodleは新しいパスワードを作成するか（提供されていない場合）、アップロードしたファイルにパスワードを要求できます。
- 必要に応じてパスワードを作成し、メールで送信
- アップロードされたファイルにパスワードがない場合は、新しいユーザーアカウントごとにランダムなデフォルトパスワードを作成し、ユーザー情報と新しいパスワードをユーザーにメールで送信します。
- ファイルに必要なフィールド
- アップロードしたファイルにパスワードを順番に入力する必要があります。パスワードを指定しないと、エラーが生成され、ユーザーアカウントは作成されません。このユーザー情報またはパスワードの通知はユーザーに送信されません。
既存のユーザーの詳細
[既存のユーザーの詳細]オプションは、アップロードタイプで既存のユーザーアカウントの更新が許可されている場合にのみ使用できます。 Moodleが既存のユーザーのユーザー詳細情報を処理する方法を指定します。
- 変更なし
- アップロードされたユーザーの詳細データを無視し、既存のユーザーアカウントデータは変更しません。
- ファイルで上書き
- 既存のユーザーアカウントのデータを、アップロードされたファイルで提供されたデータで上書きします。
- ファイルとデフォルトで上書き
- アップロードされたファイルで提供されたデータで既存のユーザーアカウントのデータを上書きし、アップロードされたファイルでデータが提供されていない場合、既存のユーザーの詳細のデフォルト値を入力します。
- ファイルから欠落しているデフォルトを埋める
- フィールドが空の場合（まだデータが含まれていない場合）、アップロードされたファイルで提供されているデータを既存のユーザーアカウントに追加し、データが提供されていない場合は既存のユーザーの詳細にデフォルト値を入力しますアップロードされたファイル内。
既存のユーザーパスワード
[既存のユーザーの詳細]設定を[ファイルで上書き]に設定すると、[既存のユーザーパスワード]オプションが表示されます。既存のユーザーアカウントのパスワードデータを処理する方法、それらを変更する、またはそのままにする方法を指定します。これは、本当にユーザーパスワードを大量に変更することを確実にするためのちょっとした保険です。
- 変更なし
- アップロードされたユーザーファイルのパスワードフィールドを無視し、既存のユーザーアカウントのパスワードはそのままにします。
- Update
- 既存のユーザーアカウントのパスワードを、アップロードされたファイルで提供されたパスワードで上書きします
パスワードの変更を強制する
[パスワードの変更を強制する]オプションでは、ユーザーアカウントにタグを付けるタイミングを指定します。これにより、次回のログイン試行時にユーザーはユーザーのパスワードを変更する必要があります。
- 弱いパスワードを持っているユーザー
- ユーザーアカウントのサイトの パスワードポリシーで定義されている弱いパスワードを使用している場合、ユーザーは次回のログイン試行時にパスワードの変更を強制されます。サイトに パスワードポリシーがない場合、このオプションは表示されません。
- なし
- アップロードされたファイル内のユーザーは、ユーザーの次回のログイン試行時にパスワードの変更を強制されません。
- すべて
- アップロードされたファイル内のすべてのユーザーは、ユーザーの次回のログイン試行時にパスワードを強制的に変更されます。
名前の変更を許可
アップロードしたファイルに特別な oldusernameフィールドが含まれている場合、ユーザーの名前を oldusernameから新しい usernameに変更できます。デフォルトの設定では、名前の変更を「許可しない」ようになっています。ユーザー名を変更すると、ユーザーはログイン時に新しいユーザー名を使用する必要があることに注意してください。
- いいえ
- oldusernameフィールドを無視し、既存のユーザーアカウントのユーザー名フィールドを変更しません。
- はい
- アップロードされたファイルのユーザー名フィールドに入力されたデータによって、既存のユーザーアカウントのユーザー名を変更できます。 oldusernameが検索され、ユーザー名列に提供されたデータで更新されます。
削除を許可
アップロードされたファイルにdeletedという特別なフィールドが含まれている場合、アップロードファイルを使用して既存のユーザーアカウントを削除することができます。デフォルトの設定では、削除を許可しません。ユーザーアカウントを削除すると、そのユーザーはログインできなくなることに注意してください。保護のため、この方法ではサイト管理者のユーザーアカウントを削除できません。
- いいえ
- アップロードされたファイルのdeleted特殊フィールドを無視し、既存のユーザーアカウントを変更しません
- はい
- deletedフィールドの値が1の場合、既存のユーザーアカウントを削除できます。
アカウントの一時停止と有効化を許可する
アップロードされたファイルに 'suspended' 特殊フィールドが含まれている場合、アップロードファイルを使用して、既存のユーザーアカウントを一時停止またはアクティブ（一時停止解除）にすることができます。デフォルト設定では、既存のユーザーアカウントの一時停止/アクティブ化が許可されます。既存のユーザーアカウントを一時停止すると、そのユーザーはログインできなくなります。
- はい
- suspendedフィールドの値が1の場合、既存のユーザーアカウントを一時停止できます。
- いいえ
- アップロードされたファイルのsuspended特別フィールドを無視し、既存のユーザーアカウントのステータスを変更しません。
メールアドレスの重複を防ぐ
可能ですが、メールアドレスが重複しているユーザーをアップロードすることは推奨されません。デフォルトでは、重複するメールアドレスを持つユーザーのアップロードは禁止されています。メールアドレスの重複を許可するには、サイト管理►プラグイン►認証►認証の管理に移動します。 「同じメールアドレスのアカウントを許可する」にチェックを入れることができます。次に、ユーザーのアップロード画面で、[メールアドレスの重複を防止する]設定を変更できます。
ただし、これはファイルのアップロードにはお勧めできません。実装する前に、ユーザーアップロードを十分にテストしてください。
詳細については、 Managing authenticationドキュメントページをご覧ください。
- はい
- アップロードされたファイルの「 email 」列にあるものと同じメールアドレスが既存のユーザーアカウントにすでにある場合、アップロードされたユーザーアカウントは作成されません。
- いいえ
- 既存のユーザーアカウントに、アップロードされたファイルの email列に同じメールアドレスが既にある場合に、ユーザーアカウントを作成できます。
ユーザー名を標準化
ユーザー名の標準化は、デフォルトでユーザー名をすべて小文字に変換し、不正な文字を取り除くために使用されます。ユーザー名を標準化しないことは可能です。ただし、そうすることは推奨されません。
- はい
- ユーザー名に小文字と数字のみが含まれるように、既存のユーザーアカウントを更新するか、新しいユーザーアカウントを作成する前に、アップロードされたファイルにあるユーザー名を標準化します。
- いいえ
- アップロードされたファイルで見つかったユーザー名の標準化をスキップして、新しく作成または更新されたユーザー名がアップロードされたファイル内のユーザー名とまったく同じになるようにします（非推奨）。
より技術的な説明を求める人のために、ユーザー名を標準化するプロセスは、文字がすべてUTF-8（fix_utf8）でエンコードされていることを確認し、ユーザー名を小文字に変換してから、非文字/非数字文字を取り除きます（ただし、 「サイト管理>セキュリティ>サイトポリシー>ユーザー名に拡張文字を許可する」がオンになっている）のようなもので：
$username = preg_replace('/[^-\.@_a-z0-9]/', , $username);
ユーザーの一括操作を選択
アップロードしたファイルの処理が完了すると（すべての新しいアカウントが作成され、既存のアカウントが前の設定で指定されたとおりに更新されます）、それらのユーザーアカウントの一部を選択して追加の バルクユーザーアクションなど
- ユーザーがまだ確認していない、メールベースの自己登録で作成されたユーザーアカウントを確認する
- メッセージを送信します（メッセージングを有効にする必要があります）
- ユーザーアカウントを削除する
- ページにユーザーのリストを表示する
- ユーザーデータをテキスト、ODS、またはExcelファイル形式でダウンロード
- ユーザーにパスワードの変更を強制する
- コーホートにユーザーを追加する
デフォルトでは、 バルクユーザーアクションのユーザーは選択されていません。
- いいえ
- バルクユーザーアクションでユーザーが選択されていません
- 新しいユーザー
- バルクユーザーアクションには、新しく作成されたユーザーのみが選択されます
- 更新されたユーザー
- バルクユーザーアクションでは更新されたユーザーアカウントのみが選択されます
- すべてのユーザー
- アップロードされたファイルで見つかったすべてのユーザー（既存の更新されたユーザーと新しく作成されたユーザーアカウント）がバルクユーザーアクションに選択されます
デフォルト値
アップロードされたファイルに含まれていない一部のフィールドにデフォルトのユーザー値を指定できます。一部のフィールドは次のとおりです。
- Email display
- Forum auto-subscribe
- City/town
- ID number
- Institution
- Department
[もっと見る...]リンクをクリックすると、他のデフォルトのユーザープロファイルフィールドが表示されます。ここでは、認証方法、国を含む17の異なるフィールドを設定できます。言語、タイムゾーン、その他のほとんどの標準ユーザープロファイルフィールド。
その他のフィールド
ユーザー用のカスタムプロフィールフィールドを作成した場合、それらはここに表示されます。
ユーザー結果のアップロード
[ユーザーのアップロード]をクリックしてプレビュー設定を承認すると、[ユーザーのアップロード結果]画面が表示されます。
この画面には、アップロードプロセスで各ユーザーに加えられた例外または変更が表示されます。たとえば、ユーザー情報を更新していた場合、更新された情報が表示されます。または、ユーザーが追加されなかった場合、そのレコードが強調表示されます。
画面には、アップロードまたは更新されたユーザーの数が要約され、脆弱なパスワードの数とエラーの数が示されます。
アップロードユーザーの高度な可能性
テンプレート
注：Moodle 2.0で必要な場合、このセクションを確認および更新する必要があります。そうして、完了したらこのメモを削除してください」
デフォルト値は、次のコードが許可されているテンプレートとして処理されます。
- %l-姓で置き換えられます
- %f-名で置き換えられます
- %u-ユーザー名に置き換えられます
- %%-%に置き換えられます
パーセント記号（%）とコード文字（l、fまたはu）の間には、次の修飾子を使用できます。
- （-）マイナス記号-コード文字で指定された情報は小文字に変換されます
- （+）プラス記号-コード文字で指定された情報は大文字に変換されます
- （〜）チルダ記号-コードレターで指定された情報は、タイトルケースに変換されます。
- 10進数-コード文字で指定された情報は、その数の文字に切り捨てられます
たとえば、firstnameがJohnで、lastnameがDoeの場合、指定されたテンプレートで次の値が取得されます。
- %l%f = DoeJohn
- %l%1f = DoeJ
- %-l%+ f = doeJOHN
- %-f_%-l = john_doe
- http://www.example.com/~%u/ は http://www.example.com/~jdoe/ になります（ユーザー名がjdoeの場合）または%-1f%-l）
テンプレート処理はデフォルト値でのみ実行され、CSVファイルから取得した値では実行されません。
正しいMoodleユーザー名を作成するために、ユーザー名は常に小文字に変換されます。さらに、[サイトのポリシー]ページの[ユーザー名に拡張文字を許可する]オプションがオフの場合、文字、数字、ダッシュ（-）、ドット（.）以外の文字は削除されます。たとえば、名がJohn Jr.で姓がDoeの場合、ユーザー名%-f _%-lは、[ユーザー名に拡張文字を許可]がオンの場合はjohn jr._doeを生成し、オフの場合はjohnjr.doeを生成します。
[新しいユーザー名の重複処理]設定が[カウンターの追加]に設定されている場合、自動インクリメントカウンターがテンプレートによって生成されたユーザー名の重複に追加されます。たとえば、CSVファイルにJohn Doe、Jane Doe、Jenny Doeという名前のユーザーが含まれていて、ユーザー名が明示されていない場合、デフォルトのユーザー名は%-1f%-lで、新しいユーザー名の重複処理が追加カウンターに設定されている場合、生成されるユーザー名は次のようになります。 jdoe、jdoe2、jdoe3。
アカウントの削除
deletedフィールドが存在する場合、値が1のユーザーは削除されます。この場合、username以外のすべてのフィールドを省略できます。ファイルをアップロードした後、[アップロードタイプ]を[既存のユーザーのみ更新]に、[削除を許可]オプションを[はい]に変更してください。
ヒント： suspendedでも同様のフィールドを使用できます。これにより、ユーザーアカウントを完全に削除するのではなく、一時的に無効にすることができます。
アカウントの削除とアップロードは、単一のCSVファイルで実行できます。たとえば、次のファイルはユーザーTom Jonesを追加し、ユーザーreznortを削除します。
username,firstname,lastname,deleted jonest,Tom,Jones,0 reznort,,,1
エンコード形式
ユーザーの最初のアップロード画面で、プルダウンリストからファイルのエンコード形式を選択できます。これらには、UTF-8（デフォルト）、ASCII、ISO-8859-1からISO-8859-11、または36を超えるフォーマットのいずれかが含まれます。
ヒント
スプレッドシート
Excelなどのスプレッドシートプログラムを使用して.csvファイルを作成する場合は、アップロードする前に、テキストエディターで結果の出力を確認してください。最終的なファイルを保存する前に情報の列を追加および削除した場合は、空のフィールドから各行の末尾のカンマを取得できます。文字エンコードも確認してください。 csvファイルは、ユーザーアカウントのアップロードに使用できるシンプルなテキストファイル（ASCIIまたはUnicode）です。
Excelは、-（マイナス）または+（プラス）で始まるパスワードをゼロに変換します。 .csvとして保存し、「このフォーマットを維持し、互換性のない機能は除外する」に「はい」と言った場合でも。ゼロを指定するとアップロードプロセスが停止するため、アップロードする前にこれを確認してください。
Excelで数式を使用してフィールドを作成する場合（たとえば、ユーザー名を作成するための連結関数）、数式を含むセルをコピーし、値をチェックして特別な貼り付けを使用して、CSVの許容可能なデータにするファイル。
データフィールドの末尾にスペースがある場合も、アップロードは失敗します。多くの場合、これは単純なFind ""およびReplace with ""では削除できません。情報がWebソースからコピーされている場合は、改行なしのスペースを含めることができるため、アップロードが正しく完了しません。これらの非表示のスペースを見つけるには、Excelの検索と置換機能を使用します。検索フィールドで、altキーを押しながら0160と入力します。置換フィールドは空白のままにします。
フィールドサイズの制限
データベースフィールドで定義されているように、一部のフィールドには最大文字長があります。通常、ファイルはプレビューリスト画面にインポートされますが、プロセスは完了しません。デバッグをオンにして、長すぎるフィールドを確認します。エラーは「ユーザーが追加されていません-エラー」になります。
一部の一般的なフィールドのサイズ（文字数）は現在（3.2）です。
- username - 100
- password - 255
- idnumber - 255
- firstname - 100
- lastname - 100
- lastnamephonetic - 255
- firstnamephonetic - 255
- middlename - 255
- alternatename - 255
- institution - 255
- department - 255
- address - 255
- city - 120
- icq -15
- skype - 50
- yahoo - 50
- aim - 50
- msn - 50
- phone1 - 20
- phone2 - 20
ここにリストされているすべてのユーザーフィールド
- アップロードファイルで有効なすべてのユーザーフィールドを以下に示します。ただし、作成したカスタムフィールド（以下を参照）は除きます。
firstname,lastname,username,email,password,auth,idnumber,institution,department,city,country,timezone,lang,mailformat,maildisplay,maildigest,htmleditor,autosubscribe,skype,msn,aim,yahoo,icq,phone1,phone2,address,url,description,descriptionformat,interests,oldusername,deleted,suspended,alternatename,lastnamephonetic,firstnamephonetic,middlename
コース情報への登録は,
course1,type1,role1,group1,enrolperiod1,enrolstatus1
です。
ここで、各登録は番号でグループ化されています。
ケイパビリティ
一部のユーザーがこの機能にアクセスできるように、制限されたロールを作成することができます。次のケイパビリティを許可して、システム/サイトレベルでロールを作成します。
- moodle/site:uploadusers
- moodle/role:assign
そして
- この新しいロールの[ロールの割り当てを許可する]タブで、アップロードする必要のあるロール、特に学生だけでなく、教師、非編集教師、および作成したその他のカスタムのロールを割り当てることを許可します。アップロードでユーザーを割り当てるために使用されます。
特に、moodle/role:assignケイパビリティを忘れないでください（これらのユーザーがユーザーを登録するコースに持っている場合でも、機能しません）。
こちらもご覧ください
- フラットファイル登録
- ユーザプロファイルフィールドカスタムユーザープロファイルフィールドに関するデータをアップロードユーザーファイルに含める方法の詳細
- コースをアップロードする
フォーラムディスカッション：
