コーホートのアップロード
管理者は、管理 > サイト管理 > ユーザ > アカウント > コーホート > コーホートをアップロードする で、CSV（カンマ区切りの値）形式のテキストファイルから複数のコーホートをアップロードすることができます。コーホートはシステム（サイト全体）またはコースカテゴリコンテクストの両方で作成することができます。
コーホートが作成されると、ユーザのアップロードページから、適切にフォーマットされたCSVファイルを使って、新しいユーザを追加することができます。
コホートをアップロードするプロセス
ここでは、プロセスの概要を説明します。
- アップロード用のコーホートファイルを作成します（CSV形式のテキストファイルで、'名前' 列と各新しいコーホートの名前が改行されている）。
- 管理画面 > サイト管理 > ユーザ > アカウント > コーホート > コーホートをアップロードする に移動します。
- アップロードするファイルを追加します。
- アップロードするコーホートのプレビュー - 設定を確認し、エラーがないかチェックします。ファイルにエラーがあった場合は、必要に応じて修正してください。
- コーホートのアップロード - "コーホートをアップロードする "をクリックします。
- コーホートのアップロード結果 - 作成されたコーホートの数が表示されます。
- コーホートのアップロード結果 - "続ける" をクリックします。
- ユーザのアップロード画面に戻ります。
設定
ファイル
アップロードするコーホートデータを含むCSV形式のテキストファイルです。コーホートのアップロードファイルの詳細については、アップロードするコーホートファイルのファイルフォーマットのセクションを参照してください。
CSVのデリミタ
コーホートアップロードファイルのフィールド間のデリミタとして使用される文字です。区切り文字は、1行のさまざまなフィールドを区切ります。デフォルトでは、カンマ（','）がデリミタとして使用されますが、他のオプションも利用できます。
,
- フィールドの区切り文字としてコンマを使用します。;
- フィールドの区切り文字としてセミコロンを使用します。:
- フィールドの区切り文字としてコロンを使用します。\t
- フィールドの区切り文字としてタブを使用します。
エンコーディング
アップロードするコーホートファイルの文字エンコーディングを指定できます。デフォルトの文字コードはUTF-8です。
デフォルトのコンテクスト
使用可能なコンテクストのリストから、使用するデフォルトのコンテクストを指定することができます。デフォルトのコンテクストはシステムコンテクスト (すなわち、サイト全体) です。コースカテゴリのリストが表示され、アップロードされたコーホートファイルでコースカテゴリが提供されていない場合、これらのコースカテゴリの1つをデフォルトコンテクストとして選択することができます。contextid (またはcontextidを検索するためのフィールドの1つ) が提供されている場合、その値が使用されますが、特定のコーホートに対してコンテクストidが提供されていない場合、デフォルトのコンテクストが使用されます。
アップロードするコーホートファイルのファイルフォーマット
アップロードするコーホートのCSVテキストファイルは，コンマ（または他のデリミタ）でフィールドが区切られています。 最初の行には，有効なフィールド名（小文字が望ましい）が書かれています。残りの行（レコード）には，それぞれの新しいコーホートに関する情報が含まれています。
:メモ: フィールド情報には、引用符や他のカンマのような特殊文字を使用しないでください。大規模なアップロードを行う前に、1レコードだけのファイルをテストする。 :メモ: 表計算ソフトを使って、必要な列やフィールドを持つファイルを作成することができます。そして、そのファイルを "CSV（カンマ区切り）" で保存します。これらのファイルは、簡単なテキストエディタで開いて確認することができます。
テスト用の有効なアップロードファイル
以下は、シンプルで有効なアップロードコーホートファイルの例です。 (ファイルの1行目のカラムヘッダは、他のデータやユーザの詳細情報と区別するために、この例では太字でハイライトされています。)
name,idnumber,description Class of 2019,2019,Members of the Class of 2019 Class of 2020,2020,Members of the Class of 2020
対象となるフィールド
- 必須フィールド:
name- 作成されるコーホートの名前。
- 任意のフィールド: デフォルト以外の値を指定するには、以下のオプションフィールドを1つ以上含めてください。
contextid- アップロードするコーホートのコンテクストIDナンバーを指定するために使用します。例えば、特定のコースカテゴリのコンテクストIDナンバーなどです。idnumber- アップロードするコーホートのIDナンバーに使用されます。description- アップロードするコーホートの説明に使用されます。descriptionformat- 説明文のテキスト形式を指定するために使用されます。デフォルトでは、descriptionformatは推奨値である1（FORMAT_HTML）に設定されていますが、0（FORMAT_MOODLE）および2（FORMAT_PLAIN）の値も利用可能です。これらのフォーマット値は、lib/weblib.php で定義されています。visible- アップロードするコーホートを表示する（1）、または、しない（0）を指定するために使用します。
- 追加フィールド: 必要に応じて、通常は使用されないいくつかの追加フィールドを利用することができます。追加フィールドでは通常、他のテーブル (コースカテゴリやコンテクストテーブルなど) の情報を検索する必要があります。追加フィールドは、コースカテゴリのコンテクストIDを見つけるための代替手段を提供します。これらの追加フィールドを使用する際には少し注意してください。追加フィールドのリストは以下のとおりです。
context- アップロードする各コーホートのコンテキスト名を指定します。category- アップロードする各コーホートのカテゴリ名を指定します。例えば、特定のコースカテゴリのカテゴリ名です。category_id- アップロードする各コーホートのカテゴリのコースカテゴリID（idnumberではない）を指定するために使用します。例えば、特定のコースカテゴリのコースカテゴリIDです。category_idnumber- アップロードするコーホートのそれぞれのカテゴリのコースカテゴリidnumber（idではない）を指定するために使用します。例えば、特定のコースカテゴリのコースカテゴリidnumberです。category_path- アップロードするコーホートごとにカテゴリのコースカテゴリパスを指定します。例えば、特定のコースカテゴリのコースカテゴリパスを指定します。
