OneRoster CSV
説明
ManageBac+ を使用すると、管理者はOneRoster 1.2 標準のManageBac+版を使用して、ユーザー、クラス、登録情報、および関連データをインポートおよびエクスポートできます。この機能は、 [設定] > [データ交換]からアクセスでき、インポート前にデータが正しいことを確認するための検証レポートが含まれています。
OneRoster標準は、 IMS Global Learning Consortiumによって開発・維持されており、このデータ交換のためのフレームワークを提供します。技術的な実装について説明した資料は、こちらで参照できます。
ManageBac+ OneRoster 1.2 CSVカスタム仕様
輸出
ManageBac+におけるエクスポートとは、システムから外部フォーマットにデータを転送するプロセスを指し、ユーザーが他のシステムと情報を共有、バックアップ、または統合することを可能にします。
エクスポートを開始するには、データ交換マネージャーの「エクスポート」タブに移動します。
ステップ2 - モードオプション（一括エクスポートと差分エクスポート）が表示された場合は、他の管理者が既にエクスポートを完了していることを意味します。希望するエクスポート方法を選択し、 「エクスポートに進む」をクリックしてください。
ManageBac+における一括エクスポートと差分エクスポートは、データ管理において異なる目的を果たします。
- 一括エクスポート：このプロセスでは、関連するすべてのレコードを一度にエクスポートします。通常、初期設定時や新しいシステムへの移行時など、完全なデータセットが必要な場合に使用されます。この方法により、既存のすべてのデータが確実に取得され、転送されます。
- 差分エクスポート：このプロセスでは、前回のエクスポート以降に変更されたレコード（新規作成、更新、削除されたエントリなど）のみがエクスポートされます。データセット全体を転送することなくデータを最新の状態に保つことができるため、継続的な同期の効率が向上します。差分エクスポートは、一括エクスポートが完了した後にのみ実行できます。
「エクスポートに進む」をクリックすると、エクスポート処理がバックグラウンドで開始され、ユーザーはExchange履歴タブに移動します。
完了したら、最新のエクスポートファイルを見つけて、ダウンロードボタン（下向きの矢印）をクリックしてZIPファイルを取得してください。
ダウンロードしたファイルを確認してください。ファイルの内容には、すべてのエンティティと、それらがManageBac+のカスタム仕様でどのように表現されているかが記載されています。
輸入
データ交換マネージャーを使用してインポートプロセスを開始するには、 [インポート]タブで ZIP ファイルを選択してください。
お使いのコンピューターからOneRosterのZIPファイルを選択し、 「保存」をクリックしてアップロードしてください。
必須項目を入力してください：
manifest.csvファイルにsource.systemnameとsource.systemcodeが含まれていない場合、アップロード領域の下に入力欄が表示されます。詳細については、 「ファイル仕様」＞「manifest.csv」セクションを参照してください。
これらの値が既にmanifest.csvファイルに含まれている場合、フィールドは自動的に入力されるため、入力することはできません。
すべての設定が完了したら、下部にある「検証に進む」ボタンをクリックしてください。これによりインポート処理が開始され、バックグラウンドでOneRosterとManageBac+検証が実行されます。
OneRosterからのインポートは、一度に1件しか処理できません。
上部の「Exchange履歴」タブからインポート状況を確認してください。インポートが完了したら、最新のインポートを見つけて検証結果を確認してください。
Exchange Reportページが開き、概要とOneRoster ZIPファイルからアップロードされたすべてのCSVファイルが表示されます。
各CSVタブでは、エラーと警告は、問題のあるセル内でそれぞれの色で強調表示されます。
タブは3つあり、最初に選択されているデフォルトタブは「無効」です。
有効—警告や検証エラーのないすべての行が含まれます
警告—少なくとも 1 つの警告を含むすべての行が含まれます
無効—少なくとも 1 つの無効な行がすべて含まれます
警告または無効化に関連するメッセージを理解するには、クリックして行情報を展開してください。
警告は、インポートを妨げるものではない潜在的な問題です。管理者は、状況に応じて、警告を無視するか、調整を行うかを選択できます。
無効なレコードは機能要件を満たしていないため、インポート処理を進めることができません。
無効化の原因となったすべての問題を解決した後、更新されたZIPファイルを使用して新しいインポートを実行してください。
データエンティティ
以下の表は、 ManageBac+さまざまなエンティティがOneRoster 1.2のエンティティおよびCSVファイルにどのように対応するかを示しており、データモデルの違いを考慮しながら、シームレスなデータ交換を保証します。
| OneRoster 1.2 エンティティ | ManageBac+エンティティ | OneRosterのCSVファイル |
| 組織 -> 地区 | 該当なし | 組織 |
| 組織 -> 学校 | 学校 | 組織 |
| 組織 -> プログラム拡張 | プログラム | 組織 |
| 学年度 -> 学校年度 | 学年度 | 学術セッション |
| コース | 主題グループ | コース |
| コース -> 科目 | 対象者 | コース |
| クラス | クラス | クラス |
| ユーザー、役割 -> 学生、人口統計情報 | 学生 | ユーザー、役割、人口統計 |
| ユーザー、役割 -> 教師 | 教師 | ユーザー、ロール |
| ユーザー、役割 -> 親 | 両親 | ユーザー、ロール |
| ユーザー、役割 -> 管理者 | 管理者 | ユーザー、ロール |
| ユーザー -> エージェント | 親子関係 | ユーザー |
| 登録 | クラスメンバーシップ | 登録 |
例えば、 ManageBac+学生は、 OneRosterの「学生」ロールを持つユーザーに相当します。OneRosterでは、ユーザーとロールはそれぞれusers.csvとroles.csvで定義されます。
データ交換マネージャーは、上記にリストされているレコードのみを更新し、その他のデータは一切変更しません。
デルタ輸入とバルク輸入の比較
データ交換プロセスにおける重要な違いは、デルタインポートとバルクインポートの違いです。
-
デルタ輸入：
- 既存のManageBac+レコードを照合および更新します。
- 存在しないレコードは新規に作成します。
- ソースデータに含まれていないレコードは変更せずに残します。
-
大量輸入：
- 差分インポートと同じ処理（レコードの照合、更新、作成）を実行します。
- さらに、ソースデータに存在しないManageBac ManageBac+内のアクティブなレコードをすべてアーカイブします。
- 例えば、 「IB Biology」のようなクラスがManageBac+で有効になっているにもかかわらず、ソースデータに存在しない場合、インポート処理後にアーカイブされます。
要約すると、一括インポートは、ソースデータからレコードを作成および更新するだけでなく、ソースデータに存在しないレコードをアーカイブする機能も備えています。
学年度移行期間中に一括インポートを行う場合は、 OneRosterには学年グループが含まれていないため、学年グループは別途管理する必要があることにご注意ください。
インポート時のレコードマッチング
ManageBac+ 、差分インポートと一括インポートの両方において、ソースデータのレコードとシステム内のレコードを照合するために、主に次の 2 つの戦略を使用します。
- sourcedIdが以前に使用されていた場合、次の項目で説明するマッチング方法を使用して、対応するレコードに直接マッチングされます。
- sourcedIdsによるマッチングが利用できない場合、または初めて遭遇する場合、次の表は各エンティティのマッチング戦略の概要を示しています。
| 実在物 | ソース列（OR） | （MB）に一致 |
| 学校 | orgs.types == "school" | 現在通っている学校に一致するもの（記録は1件のみ） |
| プログラム | orgs.sourcedId 、最初のアンダースコアの後のサフィックスに一致 |
プログラムコードに一致 （例： abc-dedf_diplomaはIBディプロマです） |
| 学術セッション | academicSessions.startDate 、 academicSessions.endDate | 年度/学期の開始/終了日に合わせて調整 |
| コース | コースタイトル | 主題グループのタイトルに一致 |
| 対象者 | コース.科目[] | 配列内の各文字列は件名タイトルに一致します |
| クラス | クラス.classCode | クラスIDに一致 |
| ユーザー | ユーザー.ユーザー名 | 生徒／教師／保護者のメールアドレスに一致 |
よくある質問
質問： OneRosterとは何ですか？また、 ManageBac+がOneRosterのカスタム仕様を使用しているのはなぜですか？
OneRosterは、IMS Global Learning Consortiumによって開発された、広く採用されている仕様です。これは、学生情報、コースデータ、登録情報などの教育データを、異なるシステム間で標準化するために開発されました。ManageBac ManageBac+のOneRoster 1.2の実装では、ベースとなるOneRoster仕様のデータモデルがManageBac+の機能要件と異なるため、「 ManageBac+ OneRoster Dialect」（MB OR Dialect）と呼ばれる独自の仕様を使用しています。このカスタマイズにより、 ManageBac+内部データ構造と機能に合わせてレコードをインポートおよびエクスポートできるようになります。
質問： ManageBac+ OneRosterのインポート/エクスポートにはどのファイルが含まれており、どのファイルが必須ですか？
ManageBac+ OneRoster のデータは、CSV ファイルを含む zip アーカイブとして交換されます。manifest.csv ファイルは必須です。以下のファイルはオプションですが、対応するエンティティが含まれる場合はアーカイブ内に必ず存在する必要があります: academicSessions.csv、orgs.csv、courses.csv、classes.csv、roles.csv、users.csv、enrollments.csv、および demographics.csv。なお、空のオプションファイルには、必須の列ヘッダーを含める必要があります。
質問：各ファイルに必要な列は何ですか？また、有効な値は何ですか？
これらの詳細は、技術的な実装について説明した資料に記載されており、こちらから参照できます。
ManageBac+ OneRoster 1.2 CSVカスタム仕様
質問： OneRosterのデータをManageBac+にインポートする際の検証ルールは何ですか？
ManageBac+インポートされたすべての CSV ファイルに対して複数の共通検証を適用します。これらの検証結果は、「データ交換履歴」タブに表示されます。各エンティティには一連の検証があり、その詳細は技術的な実装を説明する資料に記載されています。資料はこちらから参照できます。
ManageBac+ OneRoster 1.2 CSVカスタム仕様
質問： ManageBac+と他のOneRoster 1.2準拠システム間でデータを交換する際に、どのような違いや潜在的な非互換性がありますか？
ManageBac+から標準のOneRoster 1.2を実装するサードパーティシステムにデータをエクスポートする場合、エクスポートデータは一般的に互換性があります。ManageBac ManageBac+ 、ユーザー、コース、クラスなどのファイルにメタデータ列を追加しますが、これらは通常、受信システムで無視できます。
ただし、サードパーティシステムからManageBac+にデータをインポートする場合、 ManageBac+独自の仕様により、特定の要件を満たす必要があります。たとえば、クラスとコースは特定のタイプ（ext:program）を持つ組織に関連付けられている必要があり、ユーザー、コース、クラスファイルに追加のメタ列が必要になる場合があります。また、学事日程のインポート時にも、部分的な準拠が求められます。
質問： ManageBac+データ交換マネージャーにおける「一括エクスポート」と「差分エクスポート」の違いは何ですか？ 一括エクスポートは、選択したデータをすべてエクスポートし、 ManageBac+の現在の情報の完全なスナップショットを提供します。これは通常、最初のエクスポートとして実行されます。一方、差分エクスポートは、前回の一括エクスポートが正常に完了してから発生した変更（追加、修正、削除）のみをエクスポートします。差分エクスポートを実行するには、事前に少なくとも1回の一括エクスポートを完了している必要があります。
質問： OneRosterのZIPファイルをManageBac+にインポートする際、ソースシステム名とコードはどこで指定すればよいですか？
ManageBac+特に複数の学生情報システムから名簿データを取得する場合、OneRoster データのソースを識別するために source.systemname と source.systemcode が必要です。これらのフィールドが manifest.csv ファイルに含まれていない場合は、データ交換マネージャーで ZIP ファイルをアップロードした後、手動で入力するよう求められます。これらの値は、同じソースシステムからのインポート間で一貫している必要があります。
質問：エクスポート時にデルタ方式を選択できないのはなぜですか？
回答：デルタ方式を有効にするには、最初のバルクエクスポートを完了する必要があります。最初のバルクエクスポートが完了すると、デルタ方式が利用可能になります。デルタ方式では、前回の完全なバルクエクスポート以降の変更点がエクスポートされます。
質問： ManageBac+のカスタムOneRoster仕様で、学年グループを指定するにはどうすればよいでしょうか？
回答：現時点では学年グループはサポートされていませんが、ManagaBacの機能要件を満たすために必要な拡張機能をサポートするため、OneRosterとの連携を検討しています。学年グループのメンバーシップは、「設定」→「名簿」→「メンバーシップ」から管理することをお勧めします。
質問：取引所履歴ページのステータスは何を意味しますか？
回答： ManageBac+は、以下の説明が付いた4つの異なるステータスがあります。
スケジュール済み- これは、システムがインポートを正常にスケジュールし、後で開始するようにキューに登録されたことを意味します。開始されると、「処理中」に移行します。
処理中- これは、システムが現在、エクスポートまたはインポートのバックグラウンドタスクを実行していることを意味します。これは一時的なもので、後ほど以下のいずれかのステータスに変わります。
失敗- このステータスが表示された場合、バックグラウンドタスクが完了できなかったことを意味します。エクスポートエラーについては、 ManageBac+サポートチームにお問い合わせください（リクエストを送信）。インポートエラーについては、目のアイコンをクリックしてレポートビューページを開き、検証エラーを確認して、次回のインポートのために修正してください。
成功- これは、タスクがエラーなく完了したことを意味します。