コホートをアップロードする
管理者は、[ 管理]> [サイトの管理]> [ユーザー]> [アカウント]> [コホート]> [コホートのアップロード]で 、CSV（カンマ区切り値）形式のテキストファイルから複数のコホートをアップロードできます。コホートは、システム（サイト全体）のコンテキストまたはコースカテゴリのコンテキストの両方で作成できます 。
コホートが作成されたら、適切なフォーマットの.CSVファイルを使用して、 Upload usersページから新しいユーザーを追加することができます。
内容
コホートプロセスをアップロード
これがプロセスの概要です。
- アップロード用のコホートファイルを作成します（ 'name'列と各行の新しいコホートの名前を含むCSVテキストファイル）
- [管理]> [サイトの管理]> [ユーザ]> [アカウント]> [コホート]> [コホートのアップロード]に移動します。
- アップロードするファイルを追加する
- プレビューをアップロード - 設定を確認し、エラーがないか確認します。ファイルでエラーが報告された場合は、必要に応じて修正してください。
- コホートをアップロード - 「コホートをアップロード」をクリック
- コホートのアップロード結果 - 作成されたコホートの数を表示します
- コホートの結果をアップロードする - [続行]をクリックします
- ユーザーのアップロード画面に戻る
設定
ファイル
アップロードするコホートデータを含むCSV形式のテキストファイル。コホートアップロードファイルの詳細については、 「アップロードコホートファイルのファイル形式 」セクションを参照してください。
CSV区切り文字
コホートアップロードファイルのフィールド間の区切り文字として使用される文字。区切り文字は、さまざまなフィールドを単一行で区切ります。デフォルトでは、区切り文字としてコンマ（ '、'）が使用されます。しかしながら、他の選択肢も利用可能である。
、
- フィールド区切り文字としてコンマ文字を使用します;
- フィールド区切り文字としてセミコロン文字を使用します：
- フィールド区切り文字としてコロン文字を使用します\ t
- フィールド区切り文字として\ t（タブ）を使用
エンコーディング
アップロードコホートファイルの文字エンコードを指定できます。デフォルトの文字エンコードはUTF-8です。
デフォルトのコンテキスト
使用可能なコンテキストのリストから、使用するデフォルトのコンテキストを指定できます。デフォルトのコンテキストはシステムコンテキスト（つまりサイト全体）です。コースカテゴリのリストが一覧表示され、それらのコースカテゴリの1つがアップロードコホートファイルで指定されていない場合はデフォルトのコンテキストとして選択できます。あれば文句（またはルックアップに使用可能なフィールドの1つ
文句）が指定されている場合は、その値が使用されます。ただし、特定のコホートにコンテクストIDが提供されていない場合は、デフォルトのコンテキストが使用されます。
アップロードコホートファイルのファイル形式
アップロードコホートのCSVテキストファイルには、カンマ（または他の区切り文字）で区切られたフィールドがあります。最初の行には有効なフィールド名が含まれています（できれば小文字）。残りの行（レコード）には、それぞれの新しいコホートに関する情報が含まれています。
：ヒント：引用符や他のコンマなどのフィールド情報に特殊文字を使用しないでください。大規模なアップロードの前に1つのレコードだけを使ってファイルをテストします。 ：ヒント：スプレッドシートプログラムを使用して、必要な列とフィールドを持つファイルを作成できます。その後、ファイルを「CSV（カンマ区切り）」として保存します。これらのファイルは、検証のために簡単なテキストエディタで開くことができます。
テスト用の有効なアップロードファイル
これは、単純で有効なアップロードコホートファイルの例です。（ファイルの最初の行の列見出しは、この例では他のデータやユーザーの詳細と区別するために太字で強調表示されているだけです）。
名前、ID番号、説明 クラス2019,2019、クラス2019のメンバー 2020年のクラス、2020年、2020年のクラスのメンバー
含めることができるフィールド
- 必須フィールド
名
- 作成するコホートの名前
- オプションのフィールド ：デフォルト以外の値を指定するには、以下のオプションのフィールドを1つ以上含めます。
文句
- アップロードしているコホートのコンテキストID番号を指定するために使用されます。たとえば、特定のコースカテゴリのコンテキストID番号です。ID番号
- アップロードしているコホートのID番号を提供するために使用されます説明
- アップロードしているコホートの説明を提供するために使用されますdescriptionformat
- 説明のテキストフォーマットを指定するために使用されます。デフォルトでは、descriptionformatは推奨値1（FORMAT_HTML）に設定されています。ただし、0（FORMAT_MOODLE）と2（FORMAT_PLAIN）の値も使用できます。これらのフォーマット値はlib / weblib.phpに定義されています。見える
- アップロードしているコホートを表示するか（1）表示しないか（0）を指定するために使用されます。
- 追加フィールド ：必要に応じて、通常は使用されていない間に使用できる追加フィールドがいくつかあります。追加フィールドでは通常、他のテーブル（コースカテゴリやコンテキストテーブルなど）で情報を検索する必要があります。追加フィールドは、コースカテゴリコンテキストIDを検索するための代替方法を提供します。これらの追加フィールドを使用する際には、少し注意が必要です。追加フィールドのリストは以下のとおりです。
コンテキスト
- アップロードしている各コホートのコンテキスト名を指定するために使用されます。カテゴリー
- アップロードしている各コホートのカテゴリ名の名前を指定するために使用されます。たとえば、特定のコースカテゴリのカテゴリ名です。category_id
- アップロードしている各コホートのカテゴリのコースカテゴリID（ID番号ではない）を指定するために使用されます。たとえば、特定のコースカテゴリのコースカテゴリIDです。category_idnumber
- アップロードしている各コホートのカテゴリのコースカテゴリID番号（IDではない）を指定するために使用されます。たとえば、特定のコースカテゴリのコースカテゴリID番号です。category_path
- アップロードしている各コホートのカテゴリのコースカテゴリパスを指定するために使用されます。たとえば、特定のコースカテゴリのコースカテゴリパスです。
