コース配布ページの一括登録・一括編集 – WisdomBase HelpCenter

ここでは、ZIPファイルを使用してコース配布ページを一括登録・一括編集する方法についてご説明します。
CSVファイル1つと、各コース配布ページの画像ファイルをまとめたZIPファイルをアップロードすると、複数のコース配布ページを一度に作成・編集できます。

コース配布ページを1件ずつ作成・編集する方法や、各設定項目の詳細については、コース配布ページの新規作成・編集をご参照ください。

[1] 一括登録・一括編集のしくみ

CSVファイルの1行が、コース配布ページ1件に対応します。各行の「url」の値によって、新規作成と編集のどちらになるかが決まります。

CSVの「url」の値	処理の内容
まだ登録されていないURL	コース配布ページが新規作成されます。
すでに登録されているURL	そのURLのコース配布ページが編集されます。空欄の項目は変更されず、値を入力した項目だけが上書きされます。

一括登録・一括編集でコース配布ページが削除されることはありません。CSVに含まれていないコース配布ページはそのまま残ります
登録済みのコース配布ページのURLは、一括編集で変更できません。URLを変更する場合は、コース配布ページの編集画面から変更してください
URLが設定されていないコース配布ページは、一括編集の対象にできません。編集画面から変更してください
空欄は「変更しない」として扱われるため、入力済みの値を一括編集で空欄に戻すことはできません。値を消す場合は編集画面から変更してください
配布コース・試験イベント・チケット・グループの列に値を入力すると、現在の設定は入力した内容に置き換わります（追加ではありません）。既存の設定を残す場合は、既存のIDやグループ名も合わせて入力してください
1件でも不正な値がある場合は、すべての行の処理がキャンセルされます。一部の行だけが登録されることはありません

[2] ZIPファイルを準備する

ZIPファイルには、CSVファイル1つと、必要に応じて画像ファイルを含めます。

例：「spring-campaign」と「autumn-campaign」の2件を登録する場合

course_distribute_pages(UTF-8withBOM).csv
spring-campaign.png
autumn-campaign.jpg

CSVファイル

ZIPファイルにはCSVファイルを1つだけ含めてください
CSVファイルは、コース配布ページ一覧の「サンプルCSVをダウンロード」から取得したファイルをもとに作成してください。1行目の列名（url、titleなど）は変更しないでください
1回に登録・編集できるのは50行（コース配布ページ50件）までです。1行目の列名は件数に含まれません
サンプルCSVには、同じ内容の入力例が3行含まれています。3行ともご利用になる値に書き換えるか、不要な行を削除してください。入力例の行が残っていると、urlの重複などでエラーになります

サンプルCSVは次の3種類の文字コードから選択できます。

UTF-8（BOM付き）：ExcelでCSVを編集する場合はこちらを選択してください
UTF-8：Excel以外のアプリケーションで編集する場合はこちらを選択してください。Excelで開くと文字化けが発生します
Shift-JIS：「髙」（はしご高）などの機種依存文字は使用できません

Shift-JISのCSVファイルを使用する場合は、CSVファイル名に「(SJIS)」を含めてください。ダウンロードしたサンプルCSVのファイル名（course_distribute_pages(SJIS).csv）をそのまま使用すると確実です。ファイル名に「(SJIS)」がないと、UTF-8として読み込まれ、文字化けやエラー（「有効なファイルをアップロードしてください。」など）の原因になります。

画像ファイル

画像ファイルは、コース配布ページの編集画面の「コース配布ページの画像」として設定されます。画像ファイルは任意で、含めなくても登録・編集できます。

ファイル名は、対応する行の「url」の値と同じにしてください（例：urlが「spring-campaign」の場合は「spring-campaign.png」）
使用できる拡張子はpng、jpg、jpeg、gifです
画像1枚あたりのファイルサイズは8MBまでです
推奨の画像サイズは460×258ピクセルです
画像ファイルは、ZIPファイルの直下に置いても、フォルダーの中に置いても読み込まれます
ZIPファイル全体のファイルサイズは200MBまでです

画像ファイルがない行は、次のように扱われます。

新規作成の場合：配布するコースのコース画像が表示されます
編集の場合：設定済みの画像がそのまま残ります

次の場合はエラーになり、すべての処理がキャンセルされます。

CSVのどの行の「url」とも一致しない名前の画像ファイルがある

同じ名前で拡張子だけが異なる画像ファイルが複数ある（例：spring-campaign.pngとspring-campaign.jpg）

CSVファイルと画像ファイル以外のファイル（xlsxファイルやtxtファイルなど）が含まれている

[3] CSVファイルの項目

「必須」の項目は、新規作成・編集のどちらの行でも必ず入力してください。それ以外の項目は、空欄の場合、新規作成では未設定（「0」または「1」を入力する項目は「0」）、編集では現在の設定のままになります。たとえば、新規作成の行でis_publishを空欄にすると、公開しない状態で作成されます。

列名	編集画面の項目	入力内容
url（必須）	URL	半角英小文字（a～z）、半角数字、ハイフン（-）で入力します。数字のみは指定できません。同じCSV内で同じurlを複数の行に指定することはできません。例：spring-campaign
title（必須）	コース配布ページ名	30文字以内で入力します。
counts（必須）	配布可能上限数	1以上の整数を入力します。
course_ids	配布コース	配布するコースのコースIDを入力します。複数ある場合は「\|」（半角の縦線）で区切ります。対面コースのコースIDは指定できません。例：101\|102
exam_event_ids	配布する試験イベントコースの試験イベント	配布する試験イベントのIDを入力します。複数ある場合は「\|」で区切ります。試験イベントコース機能をご利用の場合のみ入力できます。
offline_course_ticket_ids	配布する対面コースのチケット	配布するチケットのIDを入力します。複数ある場合は「\|」で区切ります。
group_names	配布時に付与するグループ	付与するグループのグループ名を入力します。複数ある場合は「\|」で区切ります。例：営業部\|新入社員
valid_at	配布予定日時	「YYYY/MM/DD HH:MM」の形式で、未来の日時を入力します。空欄の場合、コースは即時配布されます。試験イベントやチケットを配布する場合は、試験イベントの受験開始可能日時の終了日時、チケットの販売終了日時よりも前の日時を入力してください。例：2026/12/01 10:00
closed_at	配布期限	「YYYY/MM/DD HH:MM」の形式で入力します。空欄の場合は配布期限なしとなります。
expired_enable	受講期限を設定する	受講期限を設定する場合は「1」、設定しない場合は「0」を入力します。
expired_mode_cd	期間で指定する／日時で指定する	「期間で指定する」場合は「0」、「日時で指定する」場合は「1」を入力します。
expiration_days	受講可能日数	1以上の整数を入力します。expired_enableが「1」、expired_mode_cdが「0」の場合は必須です。
expired_at	受講期限日時	「YYYY/MM/DD HH:MM」の形式で入力します。expired_enableが「1」、expired_mode_cdが「1」の場合は必須です。
custom_signup_page_title	このページで表示される新規登録ページ	表示する新規登録ページのタイトルを入力します。新規登録ページ機能をご利用の場合のみ入力できます。
page_title	コース配布ページの見出し	コース配布ページに表示する見出しを入力します。
page_content	コース配布ページの本文	コース配布ページに表示する本文を入力します。
button_label	コース配布ボタンのラベル	コース配布ボタンに表示する文字を入力します。
thanks_title	配布完了ページの見出し	配布完了ページに表示する見出しを入力します。
thanks_html	配布完了後メッセージ	配布完了ページに表示するメッセージを入力します。
og_title	ページタイトル	検索エンジン用のページタイトルを入力します。
og_discription	メタディスクリプション	検索エンジン用の概要文を入力します。
require_user_login	ログイン済みユーザーのみアクセス可能にする	チェックを入れる場合は「1」、外す場合は「0」を入力します。
send_email_notify_to_user	コース受講可能処理実行時に受講者にメールで通知する	チェックを入れる場合は「1」、外す場合は「0」を入力します。
is_publish	公開する	公開する場合は「1」、公開しない場合は「0」を入力します。

新規作成する行では、course_ids、exam_event_ids、offline_course_ticket_idsのうち少なくとも1つを入力してください。編集する行でこの3つをすべて空欄にした場合は、現在の配布対象がそのまま残ります。

[4] 一括登録・一括編集を実行する

WisdomBase管理画面 > コース配布ページ一覧を開きます。
「サンプルCSVをダウンロード」をクリックし、文字コードを選択してサンプルCSVをダウンロードします。
サンプルCSVに、登録・編集するコース配布ページの情報を入力します。
CSVファイルと画像ファイルを1つのZIPファイルにまとめます。
「ファイルを選択」をクリックし、作成したZIPファイルを選択します。
「一括登録・一括編集を実行」をクリックします。

処理の結果は、画面上部に表示されます。

ZIPファイルの内容	表示されるメッセージ
CSVファイルのみ	すぐに処理され、「コース配布ページを一括登録しました。（作成: ○件、更新: ○件）」と表示されます。
画像ファイルを含む	「リクエストを受け付けました。」と表示され、バックグラウンドで処理されます。処理の完了は画面やメールで通知されません。しばらくお待ちいただいた後にページを更新し、コース配布ページ一覧で登録・編集の内容をご確認ください。

画像ファイルを含む場合も、ファイルの内容のチェックはアップロード時に行われます。不正な値がある場合は、「リクエストを受け付けました。」ではなくエラーメッセージが表示されます。「リクエストを受け付けました。」と表示されてから時間がたっても反映されない場合は、サポート窓口までお問い合わせください。

[5] エラーが表示された場合

エラーがある場合は、画面上部に「インポートに失敗しました。」と表示され、続けてエラーの内容が一覧で表示されます。行ごとのエラーには「○行目」と行番号が表示されます。行番号は、1行目の列名を含めて数えた番号です。

エラーがある場合、コース配布ページは1件も登録・編集されません。内容を修正し、もう一度ZIPファイルをアップロードしてください。

主なエラーメッセージ	対処方法
ファイルを選択してください。アップロードできないファイル形式です。zip形式のファイルを選択してください。	zip形式のファイルを選択してから実行してください。
一括で登録できる件数は50件までです。	CSVファイルを50行以下に分けて、複数回に分けて実行してください。
zipファイルのファイルサイズが大きすぎます。200MB以下にしてください。	画像ファイルのサイズを小さくするか、ZIPファイルを分けて実行してください。
画像ファイルのサイズが大きすぎます。8MB以下にしてください。	表示されたファイルを8MB以下にしてください。
対応するurlの行が見つからない画像です	表示された画像ファイルの名前を、CSVの「url」の値と同じにしてください。不要な画像ファイルはZIPファイルから削除してください。
同じファイル名で拡張子違いの画像が複数あります	表示された名前の画像ファイルを1つだけ残してください。
ZIPファイルに許可されていないファイルが含まれています。	表示されたファイルをZIPファイルから削除してください。
ZIPファイルにCSVファイルが含まれていません。 ZIPファイルに複数のCSVファイルが含まれています。	ZIPファイルにCSVファイルを1つだけ含めてください。
配布可能なコース配布ページ数の上限（○件）を超えるため、インポートできません。	ご契約で作成できるコース配布ページ数の上限を超えています。新規作成する行を減らしてください。
urlが重複しています urlの形式が正しくありません。	同じurlの行が複数ないか、urlが半角英小文字・半角数字・ハイフンのみで入力されているかご確認ください。
少なくとも1つの配布対象を指定してください。	新規作成する行に、course_ids、exam_event_ids、offline_course_ticket_idsのいずれかを入力してください。
不正なコースIDです。	course_idsに対面コースなど、配布できないコースのIDが含まれていないかご確認ください。
存在しないコースIDです存在しない試験イベントIDです存在しないチケットIDです存在しないグループです存在しない新規登録ページです	表示された行のID、グループ名、新規登録ページのタイトルが正しいかご確認ください。
○行目機種依存文字が含まれています。	Shift-JISのCSVファイルで機種依存文字を使用しています。UTF-8（BOM付き）のサンプルCSVを使用してください。

目次