コースをアップロードする

注:このページはテキスト(.csv)ファイルでコースを作成することについてです。コースバックアップを.mbzまたは.tgz形式でアップロードする場合は、 コースのリストアを参照してください。


コースをアップロードする

新しいコースを作成することに加えて、コースをアップロードする機能は、コースを更新または削除したり、他のコースからコンテンツをインポートしたりするためにも使用できます。この機能を使用してコーステンプレートを作成する方法については、新しいコースの追加を参照してください。

1つ以上のコースをアップロードする

  1. [管理]> [サイトの管理]> [コース]> [コースのアップロード]に移動します。
  2. CSVファイルをドラッグアンドドロップするか、[ファイルを選択する]ボタンをクリックしてファイルピッカーでファイルを選択します。
  3. 適切なインポートオプションを慎重に選択してから、プレビューボタンをクリックしてください。
コース管理画面をアップロードする
コースがアップロードされました

注:コマンドラインツールadmin / tool / uploadcourse / cli / uploadcourse.phpを使用することも可能です。

Webインターフェイスを使用しているときは、 プレビューオプションを使用して、 プレビューされた行にエラーが検出されたかどうかを確認します。アップロードを続行しても、コースで何か問題が検出された場合、それは無視されます。

短いファイルの例

uploadcourse.csv:

注:ショートネーム、フルネーム、およびカテゴリは必須です。

categoryフィールドはカテゴリのIDを取り、デフォルトのカテゴリMiscellaneousはid 1を持ちます。カテゴリはすでに存在している必要があります。存在しないカテゴリIDを入力すると、アップロードプレビュー中に「IDでカテゴリを解決できませんでした」というエラーが表示され、そのカテゴリのコースは作成されません。

shortname,fullname,category,summary,enrolment_1,enrolment_1_role,enrolment_1_enrolperiod,role_student
courserestored,Course restored, 1 ,a summary,manual,student, 1 month,
courserestored2,Course restored 2 , 1 ,a summary,,,,
courserestored3,Course restored 3 , 1 ,a summary,,,,padawan
courserestored4,Course restored 4 , 1 , "a summary, with comma" ,manual,student, 1 month,padawan

項目間にスペースがないことに注意してください。

テキストファイルを作成する

コースをアップロードするためのテキストファイルはCSVファイルでなければなりません。コース情報とコースアクションの2つのカテゴリに分けられる次の列を受け入れます。

コース情報フィールド

これらの設定のほとんどは、コースの設定ページで利用できます。詳細についてはコース設定を参照してください。フィールド名は小文字にする必要があります。

shortname
ショートネーム
fullname
フルネーム
idnumber
ID番号
category
コースを配置するカテゴリのID。これは、 category_idnumberおよびcategory_pathよりも優先されます
category_idnumber
コースを配置するカテゴリのID番号。category_pathよりも優先されます
category_path
コースを配置するカテゴリのパスです。カテゴリ "Movies"の下にある "Science-Fiction"というカテゴリにコースを配置する場合、提供する値は次のとおりです。
Movies / Science-Fiction
。区切り記号は
[space]/[space]
。カテゴリが存在しなければならないことにも注意してください、それは作成されません。コースを最上位のカテゴリ "Movies"に配置する場合、提供する値は次のとおりです。
Movies
visible
コースが表示されている場合は1、非表示になっている場合は0
startdate
コースが始まる時間。この値はタイムスタンプを生成するためにPHP関数strtotimeに渡されることに注意してください。例01.12.2014(2014年12月1日)
enddate
コースが終了する時間startdateと同様に、この値はタイムスタンプを生成するためにPHP関数strtotimeに渡されることに注意してください。例01.12.2014(2014年12月1日)
summary
コースのまとめ
format
使用するコース形式。これは有効なコース形式プラグイン名でなければなりません。 トピックなど
theme
使用するテーマ
lang
使用する言語
newsitems
ニュース項目数
showgrades
評定表を学生に表示するには1、非表示にするには0。
showreports
活動レポートを表示するには1、非表示にするには0。
legacyfiles
従来のコースファイルを有効にする場合は1、無効にしない場合は0。
maxbytes
コースの最大アップロードサイズ(バイト単位)。サイト制限には0を使用してください。
groupmode
グループなしの場合は 0、 個別 グループの場合は1、 表示グループの場合は 2。
groupmodeforce
グループモードを強制するには1、それ以外の場合は0を入力します。
enablecompletion
活動の完了を有効にするには1、そうでない場合は0。
tags
コースに追加するタグのコンマ区切りリスト。既存のタグは削除されます。複数のタグを引用符で囲みます。

登録フィールド

登録方法を有効にして設定するために、いくつかのフィールドを構築できます。フィールドは、そのプロパティの登録方法名のenrolment_ [番号]、およびenrolment_ [番号] _property名前を付ける必要があります。

enrolment_[number]
登録方法の名前(例:手動、ゲスト、自己)
enrolment_[number]_delete
この登録方法をコースから削除するには1、1に設定すると他のすべてのプロパティは無視されます。
enrolment_[number]_disable
この登録方法をコースから無効にするには1、1に設定すると他のすべてのプロパティは無視されます。
enrolment_[number]_startdate
登録開始日この値はPHPの関数strtotime()に渡されます。
enrolment_[number]_enddate
登録終了日です。この値はPHPの関数strtotime()に渡されます。
enrolment_[number]_enrolperiod
秒数、または "4 days"のようにstrtotime()によって理解される値ではない場合
enrolment_[number]_role
ロールのショートネーム
enrolment_[number]_[property]
指定された登録方法で資産が理解される場所
enrolment_[number]_password
コース登録キー

注:コースのアップロードは、すべての登録方法とまだ互換性があるわけではありません( MDL-43127 )。

enrolment_1: manual
enrolment_1_role: student
enrolment_1_enrolperiod: 1 month

enrolment_2: self
enrolment_2_startdate: 2013-01-30

ロールの名前変更

いくつかのロールの名前を変更するには、次のパターンを使用します。

role_[shortname]
ロールの新しい名前[ショートネーム]

role_student: Apprentice
role_teacher: Master
role_mycustomrole: Jedi

これは、教師のロールの短縮名がeditingteacherであり、非編集教師のための短い名前は教師であることは注目に値します。

コースアクションフィールド

これらの設定は、 コースプロセスパラメータよりも優先されます。

delete
コースを削除するには1
rename
コースの名前を変更するためのショートネーム
backupfile
コースにインポートするバックアップファイル(.mbz)への絶対パス。

(これはあなたのコースへのフルパス、例えば/home/yourmoodle/public_html/moodle27/transfert/backup.mbzを意味します。これがわからない場合は、 サイト管理>サーバー> PHP情報でinclude_pathを見てください。)

templatecourse
コンテンツをインポートするコースのショートネーム
reset
コースをリセットするには1

必須フィールド

shortname
このフィールドは、新しいコースを作成することを除いて、すべての操作に必須です。詳細については、コースプロセスパラメータショートネームテンプレートの詳細を参照してください。
fullname
新しいコースを作成するときに必要です。
category, category_idnumber, category_path
コースを作成するときにこれらのうちの1つが必要です。

インポートオプション

予期しない動作を防ぐには、ツールにできることを指定する必要があります。

Upload mode
これにより、コースを作成または更新できるかどうかを指定できます。
Update mode
コースの更新を許可する場合は、コースの更新対象をツールに指示する必要もあります。
Allow deletes
削除フィールドが受け入れられるかどうか
Allow renames
名前変更フィールドが受け入れられるかどうか
Allow resets
リセットフィールドが受け入れられるかどうか

コースプロセス

これにより、アップロードしたすべてのコースに対して実行するアクションを指定できます。

Shortname template
ショートネームなしでコースを作成している場合は、このフィールドを使用してショートネームを自動的に生成できます。このフィールドは2つのプレースホルダーを受け入れます:ID番号の%i、要約の%f。
Restore file
作成/更新後にコースにインポートするバックアップファイル(.mbz)。
Restore from course
作成/更新後にコンテンツをインポートするコースのショートネーム。
Reset after upload
コースを作成または更新した後にコースをリセットするかどうか。

デフォルトのコース値

これらは、CSVファイルで指定されていないすべてのフィールドに対してWebインターフェースで設定できる値です。コースの作成時には常に使用されますが、更新中に指定された場合にのみ使用されます( 更新モードを参照)。

スピードアップ

バックアップファイルの内容をインポートするとき、または他のコースを実行するときは、設定keeptempdirectoriesonbackupを有効にすることをお勧めします。同じソースから複数回インポートしている場合は、これによってアップロードのプロセスがかなり速くなります。

関連情報