xAPI 向け cmi5 仕様プロファイル

目次

改版履歴

貢献者

• 1.0 概要
  • 1.1 適用範囲
• 2.0 参考文献
• 3.0 定義
  • 3.1 略語と頭字語
• 4.0 適合性
  • 4.1 Assignable Unit（AU）
  • 4.2 学習管理システム（LMS）
  • 4.3 任意の JSON 値
  • 4.4 コース
• 5.0 概念モデル: 参考情報
• 6.0 LMS の必要条件
  • 6.1 コース構造
  • 6.2 LMS ステート API の必要条件
  • 6.3 LMS ステートメント API の必要条件
• 7.0 AU の必要条件
  • 7.1 AU ステートメント API の必要条件
    • 7.1.1 最初のステートメント API 呼び出し
    • 7.1.2 最後のステートメント呼び出し
    • 7.1.3 ステートメントのタイプ
• 8.0 コンテンツ起動メカニズム
  • 8.1 起動方法
  • 8.2 認証トークン取得 URL
    • 8.2.1 概要
    • 8.2.2 定義: auth-token
    • 8.2.3 エラー
      • 8.2.3.1 取得 URL の重複呼び出し
      • 8.2.3.2 エラー値
  • 8.3 その他の起動環境
• 9.0 xAPI ステートメントデータモデル
  • 9.1 ステートメント ID
  • 9.2 アクタ（Actor）
  • 9.3 動詞（Verb）
    • 9.3.1 Launched
    • 9.3.2 Initialized
    • 9.3.3 Completed
    • 9.3.4 Passed
    • 9.3.5 Failed
    • 9.3.6 Abandoned
    • 9.3.7 Waived
    • 9.3.8 Terminated
    • 9.3.9 Satisfied
  • 9.4 オブジェクト（Object）
  • 9.5 リザルト（Result）
    • 9.5.1 得点（Score）
    • 9.5.2 成功（Success）
    • 9.5.3 完了（Completion）
    • 9.5.4 経過時間（Duration）
      • 9.5.4.1 経過時間を含む AU ステートメント
      • 9.5.4.2 経過時間を含む LMS ステートメント
    • 9.5.5 拡張（Extensions）
      • 9.5.5.1 進捗度
      • 9.5.5.2 理由
  • 9.6 文脈（Context）
    • 9.6.1 学習登録
    • 9.6.2 ContextActivities
      • 9.6.2.1 cmi5 カテゴリアクティビティ
      • 9.6.2.2 moveOn カテゴリアクティビティ
      • 9.6.2.3 発行者 ID グループ化アクティビティ
    • 9.6.3 拡張（Extensions）
      • 9.6.3.1 セッション ID
      • 9.6.3.2 合格点
      • 9.6.3.3 起動モード
      • 9.6.3.4 起動URL
      • 9.6.3.5 発行者ID
      • 9.6.3.6 moveOn
      • 9.6.3.7 起動パラメーター
  • 9.7 タイムスタンプ
• 10.0 xAPI ステートデータモデル
• 11.0 xAPI エージェントプロファイルデータモデル
  • 11.1 言語選択
  • 11.2 音響選択
• 12.0 xAPI アクティビティプロファイルデータモデル
• 13.0 コース構造データの必要条件
  • 13.1 コース構造データモデル
    • 13.1.1 コースレベルメタデータ
    • 13.1.2 ブロックメタデータ
    • 13.1.3 学習目標メタデータ
    • 13.1.4 AU メタデータ
    • 13.1.5 ベンダ固有メタデータ（拡張）
  • 13.2 コース構造 XSD
• 14.0 コースパッケージ
  • 14.1 ZIP 形式のコースパッケージ
  • 14.2 ZIP ファイルパッケージのないコース構造 XML
• 15.0 コース構造の例
  • 15.1 単純な例
  • 15.2 複雑な例
  • 15.3 拡張された例

使用許諾契約書

改版履歴

cmi5 仕様のバージョンは以下のように管理される:

• メジャーバージョン – Stone（Sandstone、Quartz など） – 機能性の大きな変更
• マイナーバージョン – 版（第 1 版、第 2 版など） – 機能性の小さな変更。
• 訂正 – 機能性に影響しない軽微な修正はバージョン付けされない。（特定の改版履歴については GitHub リポジトリを参照）

本仕様書のバージョンは以下のとおり:

Quartz - 第 1 版（2016 年 6 月 1 日）

Sandstone - 第 1 版（2015 年 5 月 15 日）

• 開発者リリース

GitHub でワーキングドラフトを Markdown に変換（2013 年 2 月 20 日）:

• 既存のワーキングドラフトを Microsoft Word から Markdown 形式に変換した。2012 年以前の作業はすべて破棄された。

貢献者

1.0 概要

本仕様書では、学習管理システム（LMS）と Assignable Unit（AU）間の、相互運用可能なランタイム通信について説明する。

1.1 適用範囲

本仕様書の適用範囲は以下に制限される:

• LMS による AU の起動。
• LMS および AU によって使用される起動およびランタイム環境。
• LMS および AU 間のランタイム通信データおよびデータ転送。
• AU によって使用されるランタイムデータに関連する LMS コース定義。
• LMS コース構造のインポート/エクスポート
  
• LMSのレポート処理の必要条件。

本仕様書では、上記の適用範囲内で xAPI 仕様の使用方法を参照する。

xAPI 仕様のその他の使用はこの適用範囲に含まれない。

以上で明示的に定義されていないアクティビティの使用は、本仕様書の適用範囲に含まれない。

2.0 参考文献

本仕様書を適用するうえで欠くことのできない参考文献を以下に示す。

• Internationalized Resource Identifiers (IRIs): IRI Syntax January 2005
  https://www.ietf.org/rfc/rfc3987.txt
• "Experience API", version 1.0.x (subject to change just prior to release), ADL
  https://github.com/adlnet/xAPI-Spec/blob/xAPI-1.0.2/xAPI.md
• cmi5 Course Structure, Sandstone 1st Edition
  https://github.com/AICC/CMI-5_Spec_Current/blob/master/cmi5_coursestructure.md
• MIME Types
  http://www.iana.org/assignments/media-types/index.html
• Extensible Markup Language (XML)
  http://www.w3.org/XML
• The JSON Data Interchange Format
  http://json.org/
• ISO/IEC 21320-1:2015(en) Information technology — Document Container File — Part 1: Core (Commonly called ZIP file format):
  https://www.iso.org/obp/ui/#iso:std:iso-iec:21320ed-1:v1:en

3.0 定義

本仕様書の目的のために、以下の用語および定義を適用する:

• 管理者: LMS および関連システムを管理する管理ユーザ。このユーザは学習者の登録、コース構造定義、レポート管理などのタスクを実行する。

• Assignable Unit (AU): LMS から起動される学習コンテンツの提示単位。AU はトラッキングおよび管理の対象の単位である。AU は学習者についてのデータを収集し、LMS に送信する。

• コース: 学習コンテンツの Assignable Unit の集まりを論理的にグループ化したもの。コースは通常、LMS の内部データ構造である。コースは多くの場合、学習者に割り当てられ、LMS によってトラッキングされる。

• コース構造: Assignable Unit および起動パラメータのリスト。暗黙的に位置された連続性を持ち、コースを表す。

• Experience API（xAPI）: 学習コンテンツ（AU）が Learning Record Store（LRS）との間でデータを送受信するためのランタイムデータ通信仕様。この文書によって参照される xAPI 仕様は、データ転送およびデータモデルを定義するために使用される。

• Internationalized Resource Identifier（IRI）: RFC 3987 に準拠した一意識別子。IRI は IRL であってもよい。IRL は、IRL の作成者によって管理されるドメインの内部で定義されることがのぞましい（SHOULD）。本仕様書における IRI は完全修飾でなければならず（MUST）、IRI 参照であってはならない点に注意。

• Internationalized Resource Locator（IRL）: xAPI 仕様では、（IRI から URI へのルールに従って）URI に変換したときに URL になる IRI を IRL と定めている。

• 学習者: 学習コンテンツ（AU）を閲覧/使用するエンドユーザ。

• 学習管理システム（LMS）: 学習者の登録、学習プレゼンテーションの起動、学習者の成果の分析とレポート、学習者の進捗のトラッキングといった機能を含むコンピュータシステム。cmi5 仕様では LMS による起動、レポート、トラッキングの各役割に焦点を当てている。LMS はその実装の一部として LRS を備えなければならない（MUST）。LMS は LRS と統合されなければならない（MUST）。この文書ではこれ以降、LMS と LRS の統合体をもって「LMS」と呼称する。

• Learning Record Store（LRS）: xAPI 仕様での定義どおり。

3.1 略語と頭字語

ADL: Advanced Distributed Learning
AICC: Aviation Industry Computer-Based Training Committee
API: Application Programming Interface
CMI: Computer Managed Instruction
JSON: JavaScript Object Notation
IRI: Internationalized Resource Identifier
IRL: Internationalized Resource Locator
LMS: Learning Management System
LRS: Learning Record Store
PII: Personally Identifiable Information
URI: Uniform Resource Identifier
URL: Uniform Resource Locator
URN: Uniform Resource Name
xAPI: Experience API
XML: Extensible Markup Language
XSD: XML Schema Definition

4.0 適合性

この章では、本仕様書への適合性について定義する。

本仕様書において:

• 「なければならない（MUST）」は、実装の必要条件として解釈される。
• 「てはならない（MUST NOT）」は、禁止として解釈される。
• 「することがのぞましい（SHOULD）」は、実装にあたっての推奨事項として解釈される。
• 「することはのぞましくない（SHOULD NOT）」は、「することがのぞましい（SHOULD）」の逆と解釈される。
• 「してもよい（MAY）」は、仕様の制限内で許容される一連の行為として解釈される。
• 「必要はない（NEED NOT）」は、必須ではない一連の行為として解釈される。

本仕様書の適用範囲外で xAPI 仕様を使用することは、本仕様書への適合性に影響しない。

4.1 Assignable Unit（AU）

7 章「AU の必要条件」を参照。Assignable Unit は、xAPI 仕様で定められたすべての必要条件に適合しなければならない（MUST）（「参考文献」を参照）。

4.2 学習管理システム（LMS）

6 章「LMS の必要条件」を参照。LMS は、xAPI 仕様で定められた LRS の必要条件すべてに適合しなければならない（MUST）（「参考文献」を参照）。

LMS には、複数のセッションにまたがる別のユーザーに関するすべてのリソースデータ（ステートメント API やアタッチメントと拡張他）を取得できるアカウントを備えなければならない（MUST）。

4.3 任意の JSON 値

JSON プロパティが「オプション」と示されている場合、説明されている JSON 構造からそのようなプロパティを省略してもよい（MAY）。null でない値を持つすべての JSON プロパティは LRS に記録されなければならない（MUST）。

4.4 コース

コースには、13 章および 14 章で列挙しているすべての必要条件に適合したコース構造データがバンドルされなければならない（MUST）。

コース構造データは、本仕様書で説明している一切の特徴や機能（オプションまたは必須）を、適合しない方法で実装してはならない（MUST NOT）。

5.0 概念モデル: 参考情報

cmi5 モデルの概要:

• LMS は、1 つ以上の AU を含むコース構造をインポートする。
• LMS 管理ユーザはコースを学習者に割り当てる。
• 学習者は LMS または関連システムでの認証を行う。
• 学習者は LMS または関連付けられた起動システムから、インターフェイスを使用して AU を起動する。
• LMS は起動データを、LMSに統合された LRS に書き込む。
• AU は、起動パラメータと以前の状態情報を要求するメッセージを LMS に送信する。
• 学習者は AU のコンテンツを参照し、学習を行う。この間、AU は LMS からデータを要求したり、LMS にデータを格納してもよい（MAY）。
• 学習者は AU を終了する。
• AU は最終的なトラッキングデータを LMS に伝達し、"terminate" ステートメントを発行する。
• 管理ユーザは、AU によって個々の学習者に対して記録されたトラッキングデータのレポートを作成および確認する。

Assignable Unit の責務:

• 起動環境からのパラメータを解析し、LMS を特定し、LMS との通信を開始する。
• 「クライアント」として動作し、定義済みのデータ転送方式と、本仕様書で規定する関連コマンドを使用してメッセージを送受信する。
• 本仕様書で定義するデータ型と語彙に従ってすべてのデータを整形する。
• AU の実行を終了する前に "terminate" ステートメントを送信する。

LMS の責務:

• コース構造を作成し、保持する。
• 「サーバ」として動作し、定義済みのトランスポートメカニズムと、本仕様書で規定する関連コマンドを使用してメッセージを受信し、応答する。
• 本仕様書で定義するデータ型と語彙に従ってすべてのデータを整形する。
• 定義済みの環境内で、コースに含まれている指定された AU を起動する。

6.0 LMS の必要条件

本仕様書に適合するための LMS の必要条件は以下のとおり:

• xAPI 仕様の定義に従い LRS を実装する。
• 10 章の定義に従い、AU のステートを初期化するための、追加の「ステート API」必要条件を実装する。
• 8.0 節「コンテンツ起動メカニズム」の定義に従い、ランタイム起動インターフェイスを実装する。
• 9 章の定義に従い、追加の xAPI「ステートメント API」必要条件を実装する。
• 11 章の定義に従い、追加の xAPI「エージェントプロファイル API」必要条件を実装する。
• 6.1 節の定義に従い、コース構造を実装する。

6.1 コース構造

• LMS はコース構造を作成、編集、および保守するための手段を実装することがのぞましい（SHOULD）。
  
• LMS は、13 章および 14 章で定義するコース構造のインポートを実装しなければならない（MUST）。
  
• LMS は、13 章および 14 章で定義するコースデータ構造のエクスポートを実装することがのぞましい（SHOULD）。
  
• LMS は、コース構造を内部的に作成および編集するためのユーザインターフェイスを LMS 管理ユーザに提供することがのぞましい（SHOULD）。
  
• LMS は、1000 を超える AU を含むコース構造をサポートしなければならない（MUST）。
• LMS は、13.2 節で定義する XSD スキーマに準拠したコース構造をサポートしなければならない（MUST）。

6.2 LMS ステート API の必要条件

LMS は 10 章での定義どおり、ステート API の必要条件を実装しなければならない（MUST）。

6.3 LMS ステートメント API の必要条件

LMS は、AU による無効化ステートメントの発行を許可するパーミッション/資格情報を提供してはならない（MUST NOT）。

LMS は、9 章で定義する「ステートメント API」の必要条件と相容れないステートメントを拒否することがのぞましい（SHOULD）。

LMS は「拒否はされないが、9 章で定義されるステートメント API の必要条件を満たさないステートメント」を無効化しなければならない（MUST）。

7.0 AU の必要条件

本仕様書に適合するための AU の必要条件は以下のとおり:

• 8 章「コンテンツ起動メカニズム」の定義どおり、ランタイム起動インターフェイスを実装する。
• xAPI 仕様での定義どおり、ランタイム通信を実装する。
• 10 章での定義どおり、本仕様書のステート API の必要条件を実装する。
• 11 章での定義どおり、本仕様書のプロファイル API の必要条件を実装する。
• 以下の各節での定義どおり、ステートメント API の必要条件を実装する。

7.1 AU ステートメント API の必要条件

7.1.1 最初のステートメント API 呼び出し

AU は、9.3.2 項で説明するように、起動、初期化され、学習者との対話準備ができてから、Initialized を使用したステートメントを LRS に発行しなければならない（MUST）。

7.1.2 最後のステートメント呼び出し

AU は、セッションにおける最後のステートメントとして、9.3.8 項で説明するように Terminated ステートメントを LRS に発行しなければならない（MUST）。

（たとえば、ユーザの行為またはその他何らかの手段により）セッションが終了すると AU が判断した時点で、AU は Terminated ステートメントを発行することがのぞましい（SHOULD）。

セッションが終了を迎えると AU が判断してもよい状況には、以下のようなものがある:

• ブラウザウィンドウまたはアプリケーションのクローズイベントを監視する
• AU で定義された、AU セッションを終了するためのユーザ行為
• ユーザの無操作によるタイムアウトなど、AU で定義されたその他のイベント

7.1.3 ステートメントのタイプ

AU セッションで発行されるステートメントは、以下のカテゴリに分類される:

• 「cmi5 定義」 - cmi5 で定義された Verb、9.6.2.1 項で定義するカテゴリ ID、および文脈テンプレートを使用するステートメント。
• 「cmi5 許容」 - 任意の Verb と cmi5 文脈テンプレートを使用する（が、9.6.2.1 項で定義する cmi5 カテゴリ ID は含まない）ステートメント。
• 「cmi5 非許容」 - cmi5 仕様に適合しないすべてのステートメント。

「cmi5 許容」ステートメントを AU が発行する場合、"Initialized" を用いた cmi5 ステートメントと "Terminated" を用いた cmi5 ステートメントの間に発行しなければならない（MUST）。cmi5 で定義されたセッションの管理および完了ルールにおいて、「cmi5 許容」ステートメントは考慮されない。｛"cmi5 allowed" statements are not considered in cmi5 defined session management and completion rules.｝

8.0 コンテンツ起動メカニズム

8.1 起動方法

AU は LMS によって、コース構造の launchMethod（13.1.4 項「AU メタデータ、URL」）に応じた下記いずれかの方法を用いて起動されなければならない（MUST）:

launchMethod が "OwnWindow" のとき、LMS は以下のいずれかを使用しなければならない（MUST）:

• AU 用の新しいブラウザウィンドウを開く。
• 既存のブラウザウィンドウを AU にリダイレクトする。

launchMethod が "AnyWindow" のとき、LMS は AU のウィンドウコンテキストを選択することができる。すべてのブラウザウィンドウオプション（フレームセット、新しいウィンドウ、ブラウザリダイレクト、その他）が許容される。

どちらの場合でも、AU は、この章に規定された起動パラメータのクエリ文字列を持つ URL と共に LMS によって起動されなければならない（MUST）。起動パラメータは、AU を起動する URL に追加された、クエリ文字列内の名前/値ペアでなければならない（MUST）。

他の目的のためのクエリ文字列が AU の URL に必要な場合、以下で定義する名前付きパラメータと名前が競合してはならない（MUST NOT）。

名前/値ペアの順序に意味はない。AU は順序によらずペアを処理できなければならない（MUST）。

名前に関連付けられた各値は URL エンコードされなければならない（MUST）。

起動 URL の形式は次のとおり:

<URL to AU>
?endpoint=<URL to LMS Listener>
&fetch=<Fetch URL for the Authorization Token>
&actor=<Actor>
&registration=<Registration ID>
&activityId=<AU activity ID>

例:

http://www.example.com/LA1/Start.html
?endpoint=http://lrs.example.com/lrslistener/
&fetch=http://lms.example.com/tokenGen.htm?k=2390289x0
&actor={"objectType": "Agent","account": 
{"homePage": "http://www.example.com","name": "1625378"}
&registration=760e3480-ba55-4991-94b0-01820dbd23a2
&activityId=http://www.example.com/LA1/001/intro

（読みやすさのために、上記の例は URL エンコードされていない。）

URL 起動パラメータの値について以下で説明する:

8.2 認証トークン取得 URL

8.2.1 概要

LMS は、fetch の名前/値ペアを起動 URL に含めなければならない（MUST）。AU は、fetch URL への HTTP POST を実行して認証トークンを取得しなければならない（MUST）。要求のキャッシングを防ぐために、HTTP GET は認められていないことに注意されたい。

fetch URL は、Content-Type が "application/json" の JSON 構造を返さなければならない（MUST）。JSON 構造の例を次に示す:

{
  "auth-token": "QWxhZGRpbjpvcGVuIHNlc2FtZQ=="
}

AU は、以降すべての LMS との xAPI 通信で、「RFC 1945 - 11.1 Basic Authentication Scheme」の定義どおり、auth-token を HTTP ヘッダーに含めなければならない（MUST）。fetch URL によって返される認証トークンは、セッションの期間に限定されなければならない（MUST）。

AU は認証トークンの取得を複数回にわたって試みることはのぞましくない（SHOULD NOT）。fetch URL は「ワンタイム利用」URL であり、2 回目以降の使用はエラーを生成することがのぞましい（SHOULD）（8.2.3 項を参照）。

8.2.2 定義: auth-token

8.2.3 エラー

8.2.3.1 取得 URL の重複呼び出し

fetch URL は「ワンタイム利用」URL であり、最初の要求だけが auth-token を返すことがのぞましい（SHOULD）。セッション中、fetch URL に行われた 2 回目以降の要求はエラーを生成することがのぞましい（SHOULD）。エラーは Content-Type が "application/json" の JSON 構造の形式で返すことがのぞましい（SHOULD）。JSON 構造の例を次に示す:

{
  "error-code": "1",
  "error-text": "The authorization token has already been returned."
}

8.2.3.2 エラー値

以下の error-code 値が認められている。

error-text の値は LMS によって定義される。

8.3 その他の起動環境

その他の起動環境は現在、本仕様書で定義されていない。こうしたその他の環境における、LMS および AU のための cmi5 実装では、xAPI 仕様で規定されているのと同じ REST 通信インターフェイスを使用するであろう。xAPI 仕様では起動メカニズムを定めていない。

9.0 xAPI ステートメントデータモデル

9.1 ステートメント ID

AU は、それが発行するすべてのステートメントに対して、ステートメント ID プロパティを UUID 形式で（xAPI 仕様での定義どおり）割り当てなければならない（MUST）。

9.2 アクタ（Actor）

Actor プロパティは LMS によって定義される。すべての「cmi5 定義」ステートメントの Actor プロパティは、xAPI 仕様での定義に従って、objectType を "Agent" にして、"account" を含んでいなければならない（MUST）。

9.3 動詞（Verb）

以下の xAPI Verb が本仕様書で定義されている。

「cmi5 許容」ステートメントは本節の使用ルールの適用外であることに注意されたい。

特に断りのない限り、本節で扱うすべてのステートメントは「cmi5 定義」ステートメントを指している。

AU は、本仕様書の他の項目で必須としている以下の Verb を使用しなければならない（MUST）。

AU セッションにおける AU Verb 順序付けルールは以下のとおり:

• Verb は重複してはならない（MUST NOT）（cmi5 定義ステートメントにおいて）。
• {"Passed","Failed"} Verb の組を 2 つ以上使用してはならない（MUST NOT）（cmi5 定義ステートメントにおいて）。
• cmi5 定義ステートメントである "Completed" は registration ごとに 1 つしか使用できない。
• cmi5 定義ステートメントである "Passed" は registration ごとに 1 つしか使用できない。
• "Failed" ステートメントが "Passed" ステートメントの後に来てはならない（cmi5 定義ステートメントにおいて）。
• "Initialized" は最初のステートメントでなければならない（MUST）（cmi5 で許容または定義されたステートメントの中で）。
• "Terminated" は最後のステートメントでなければならない（MUST）（cmi5 で許容または定義されたステートメントの中で）。

本仕様書に記載されていない追加の Verb を AU で使用してもよい。

ステートメントで AU が使用する Verb にかかわらず、LMS はすべてのステートメントを記録し、レポートを提供しなければならない（MUST）。

9.3.1 Launched

9.3.2 Initialized

9.3.3 Completed

9.3.4 Passed

9.3.5 Failed

9.3.6 Abandoned

9.3.7 Waived

9.3.8 Terminated

9.3.9 Satisfied

9.4 オブジェクト（Object）

すべての「cmi5 定義」ステートメントには、本節で規定する Object が存在しなければならない（MUST）。

Satisfied Verb を含むステートメントを除き、cmi5 定義ステートメントにおける Object は AU を表す。Object が AU のとき、特定の AU に対する Object の "id" プロパティの値は、起動 URL で定義される activityId と一致しなければならない（MUST）。

Satisfied ステートメントでは、Object はブロックまたはコースを表す。（「9.3.9 Satisfied」を参照）

9.5 リザルト（Result）

使用する cmi5 Verb により、結果を有するステートメントがある。

9.5.1 得点（Score）

得点がレポートされることは必須ではない。AU が得点を報告する場合、（もし LMS 起動データで AU に対して定義されていれば）"masteryScore" と Verb が整合していなければならない（MUST）。

下記の cmi5 定義ステートメントでは、result の "score" プロパティを設定してもよい（MAY）。

• Passed
• Failed

上記以外の cmi5 定義ステートメントには、"score" プロパティを含めてはならない（MUST NOT）。

• scaled
  0 ～ 1 の範囲（両端を含む）の小数値。
• raw
  score オブジェクトの "min" プロパティから "max" プロパティまでの範囲（両端を含む）の整数値。"raw" 値が提供されるとき、AU は score の "min" 値と "max" 値も提供しなければならない（MUST）。
• min
  "raw" 得点プロパティの最小値を示す整数値。
• max
  "raw" 得点プロパティの最大値を示す整数値。

9.5.2 成功（Success）

下記の cmi5 定義ステートメントについては、result の "success" プロパティを true に設定しなければならない（MUST）:

• Passed
• Waived

下記の cmi5 定義ステートメントについては、result の "success" プロパティを false に設定しなければならない（MUST）:

• Failed

上記以外の cmi5 定義ステートメントには、"success" プロパティを含めてはならない（MUST NOT）。

9.5.3 完了（Completion）

下記の cmi5 定義ステートメントについては、result の "completion" プロパティを true に設定しなければならない（MUST）:

• Completed
• Waived

上記以外の cmi5 定義ステートメントには、"completion" プロパティを含めてはならない（MUST NOT）。

9.5.4 経過時間（Duration）

"duration" プロパティは ISO 8601 フォーマットの時間値であり、本項で定義するいくつかのステートメントでは必須である。下記以外の cmi5 で定義されたステートメントにも "duration" プロパティを含めてよい（MAY）。

9.5.4.1 経過時間を含む AU ステートメント

Terminated ステートメント

AU は "duration" プロパティを "Terminated" ステートメントに含めなければならない（MUST）。AU は Terminated ステートメントに対して、"Initialized" ステートメントから "Terminated" ステートメントまでの時間差として経過時間を計算することがのぞましい（SHOULD）。AU は、AU によって決定される基準に基づいて経過時間を計算するための別の方法を使用してもよい。

"Completed" ステートメント

AU は "duration" プロパティを "Completed" ステートメントに含めなければならない（MUST）。AU は、完了状態を達成するまでに学習者が必要とした時間を経過時間として計算することがのぞましい（SHOULD）。

Passed ステートメント

AU は "duration" プロパティを "Passed" ステートメントに含めなければならない（MUST）。AU は、AU の判定対象のアクティビティを試行し成功するまでに学習者が必要とした時間を経過時間として計算することがのぞましい（SHOULD）。

Failed ステートメント

AU は "duration" プロパティを "Failed" ステートメントに含めなければならない（MUST）。AU は、AU の判定対象のアクティビティを試行し失敗するまでに学習者が必要とした時間を経過時間として計算することがのぞましい（SHOULD）。

9.5.4.2 経過時間を含む LMS ステートメント

Abandoned ステートメント

"duration" プロパティを "Abandoned" ステートメントに含めなければならない（MUST）。"duration" プロパティは少なくとも、"Launched" ステートメントを起点に、AU によって発行された（あらゆる種類の）最後のステートメントまでの時間を計算して、合計セッション時間として設定しなければならない（MUST）。LMS は、合計セッション時間がさらに長かったかどうかを判断するために、他の（LMS 固有の）方法も（使用可能であれば）使用することがのぞましい（SHOULD）。

9.5.5 拡張（Extensions）

9.5.5.1 進捗度

9.5.5.2 理由

9.6 文脈（Context）

すべての cmi5 定義ステートメントは、本節で定義するオブジェクト/値をすべて含む文脈を含まなければならない（MUST）。LMS または AU のいずれかが追加のオブジェクトを提供してもよい（MAY）。

9.6.1 学習登録（registration）

文脈オブジェクトで使用される "registration " プロパティの値は、LMS によって提供される値でなければならない（MUST）。LMS はこの値を生成し、起動 URL を介して AU に渡さなければならない（MUST）。登録時に、LMS はコース構造内の MoveOn 基準を評価しなければならない（MUST）。例えば、コース構造において、"MoveOn"（進行）基準が "Not Applicable"（適用不可能）というブロックが評価されると、この時点で "Satisfied"（満足した）ステートメントが生成されるであろう。

AU 起動セッションの外で発生したすべての Satisfied ステートメントについて、LMS は一意のセッション ID を生成し、それらのステートメントに対してその ID を使用しなければならない（MUST）。

9.6.2 contextActivities

このプロパティの目的は、LMS またはその他のレポーティングシステムによる LRS の検索を容易にすることである。"contextActivities" プロパティには、それらの ID をステートメントリストフィルタとして使用できる Activity オブジェクトのリストが含まれる。cmi5 定義ステートメントはすべて、文脈テンプレートの contextActivites で定義されたすべてのプロパティと値を含まなければならない（10 章「xAPI ステートデータモデル」を参照）。

9.6.2.1 cmi5 カテゴリアクティビティ

7.1.3 項で説明しているように、cmi5 定義ステートメントで使用される "category" 文脈アクティビティリストにおいて "id" が 「https://w3id.org/xapi/cmi5/context/categories/cmi5" である Activity オブジェクト。

9.6.2.2 moveOn カテゴリアクティビティ

"success"（成功した）または "completion"（完了した）プロパティを含む結果オブジェクト（9.5 節）を伴う cmi5 定義ステートメントは、"category" 文脈アクティビティリスト内に、"https://w3id.org/xapi/cmi5/context/categories/moveon" という "ID" を伴う Activity オブジェクトを持たなければならない（MUST）。その他のステートメントにこの Activity を含めてはならない（MUST NOT）。

9.6.2.3 発行者 ID グループ化アクティビティ

コース構造からの発行者 ID を使用している AU についてのステートメントを識別するために使用される。

LMS は、AU の起動に先立ち、ステート API（10 章参照）で説明するように、"contextTemplate" 内の "grouping" 文脈アクティビティリストに、不変の値である = コース構造からの AU の ID 属性（13.1.4 項「AU メタデータ」の「id」を参照）の値、を "ID" プロパティに持つ Activity オブジェクトを含めなければならない（MUST）。LMS はさらに、LMS が LRS で直接実行するすべての「cmi5 定義」および「cmi5 許容」ステートメントに対して、発行者 id の Activity を "grouping" 文脈アクティビティリストに含めなければならない（MUST）。

9.6.3 拡張（Extensions）

以下は、cmi5 のために仕様化された拡張である。ここで仕様化されている拡張と競合または重複しない限り、その他の拡張も認められている。

9.6.3.1 セッション ID

9.6.3.2 masteryScore（合格点）

9.6.3.3 起動モード

9.6.3.4 起動URL

9.6.3.5 発行者ID

本項は適用外となった。9.6.2.3 項「発行者 ID グループ化アクティビティ」を参照。

9.6.3.6 moveOn

9.6.3.7 launchParameters（起動パラメーター）

9.7 タイムスタンプ

ステートメントの順序の必要条件が満たされることを保証するために、すべてのステートメントは xAPI 仕様に従って timestamp プロパティを含めなければならない（MUST）。すべてのタイムスタンプは UTC 時間で記録されなければならない（MUST）。セッション内のステートメントでタイムスタンプが一意である必要はない。記録される時間は、状況が実際に発生した時点を示すことがのぞましい（SHOULD）。

10.0 xAPI ステートデータモデル

AU を起動するのに先立って、LMS は LRS のステート API レコード内にドキュメントを作成または更新しなければならない（MUST）。これは、本節で定義する JSON ドキュメントでなければならない（MUST）。

ステート API PUT プロパティ:

• activityId: AU のアクティビティ ID
• agent: 受講登録されている LMS 学習者を表すエージェント。これは、AU 起動時に LMS によって生成される actor プロパティと一致しなければならない（MUST）。
• registration: コースでの LMS 学習者受講登録を表す登録 ID。これは、AU 起動時に LMS によって使用される登録 ID と一致しなければならない（MUST）。
• stateId: LMS.LaunchData

"LMS.LaunchData" ドキュメントのプロパティについて以下で説明する。

11.0 xAPI エージェントプロファイルデータモデル

cmi5 では、学習者の選好は学習者を適用範囲とする。LMS と AU はどちらも、xAPI エージェントプロファイル内の学習者の選好に変更を書き込んでもよい。LMS/LRS は、xAPI 仕様（7.6 節）で定義されているように、"403 Forbidden" 応答を返すことによって、AU によって要求された学習者の選好の変更を無視またはオーバーライドすることを選択してよい。AU は 403 応答をエラー状況として扱ってはならない（MUST NOT）。

起動時に、AU は学習者の選好ドキュメントをエージェントプロファイルから取得しなければならない（MUST）。

エージェントプロファイルを読み書きするとき、ドキュメント名は "cmi5LearnerPreferences" でなければならず（MUST）、フォーマットは次に示すような JSON 構造でなければならない（MUST）。

{
  "languagePreference": "<values for languages>",
  "audioPreference": "<on or off>"
}

11.1 languagePreference（言語選択）

languagePreference は、xAPI 仕様（5.2 節）で指示されているように、RFC 5646 言語タグのコンマ区切りリストでなければならない（MUST）。リストでは、ユーザが優先する順に言語を指定しなければならない（MUST）。下記の例では、ユーザの第 1 優先言語は en-US である。ユーザの第 2 優先言語は fr-FR であり、第 3 優先は fr-BE である。

{
  "languagePreference": "en-US,fr-FR,fr-BE",
  ...
}

AU が複数の言語をサポートする場合、上記の例のようなユーザの言語優先順位に従って AU を表示することがのぞましい（SHOULD）。AU が "zh-CN"、"fr-BE"、および "fr-FR" をサポートしている場合、AU を "fr-FR" で表示することがのぞましい（SHOULD）。AU が複数の言語をサポートしない、またはエージェントプロファイルで languagePreference が指定されていない場合、AU をそのデフォルト言語で表示してもよい。

11.2 audioPreference（音響選択）

audioPrefence 値は、オーディオを "on" または "off" のどちらにすることがのぞましい（SHOULD）かを示す。AU は起動時にこの値に基づいてオーディオを有効または無効にしなければならない（MUST）。エージェントプロファイルで audioPreference の値が提供されない場合、AU はその独自のデフォルト値を使用してもよい（MAY）。

例:

{
  "audioPreference": "on",
  ...
}

12.0 xAPI アクティビティプロファイルデータモデル

AU は xAPI 仕様（7.5 節「アクティビティプロファイル API」）に従ってアクティビティプロファイル API を使用してもよい。

13.0 コース構造データの必要条件

13.1 コース構造データモデル

本節で定義するすべてのデータ要素について、先頭/末尾のスペースはすべて、コース構造のインポート時に LMS によって削除しなければならない（MUST）。

13.1.1 コースレベルメタデータ

以下のメタデータの属性と要素はコースレベルのもので、全体としてコースの例を以下で説明する。

13.1.2 ブロックメタデータ

本項のデータは、グループ AU のあるブロック構造に使用される。ブロックは 1 つ以上の AU で構成される。ブロックには学習目標や他のブロックへの参照を含めることもできる。

13.1.3 学習目標メタデータ

本項のデータは目標によって使用される。目標はブロックまたは個別 AU と関連付けることができる。

13.1.4 AU メタデータ

本項のデータは、AU を特定し起動データを提供するために、LMS によって使用される。AU はオブジェクティブを含んでもよい。

13.1.5 ベンダ固有メタデータ（拡張）

コース設計者は、独自の名前空間付き要素をコース構造に配置することによって、ソース構造仕様の拡張を定義してもよい（MAY）。コース設計者はそのために、XML スキーマ定義を提供しなければならず（MUST）、これらのベンダ固有拡張を記述した仕様を人間が読める形で提供することがのぞましい（SHOULD）。これらの拡張はコース構造 XML を有効に保たなければならない（MUST）。インポート側の LMS はこれらの要素を無視してもよい（MAY）。したがって、拡張を作成するときは、LMS が追加の要素をサポートしない場合でもコースはそのまま使用できるような形で作成することがのぞましい（SHOULD）。

拡張の普及を促進するために、コース設計者は自らの仕様のためにフリーまたはオープンソースライセンスを選択し、その仕様を公開することがのぞましい（SHOULD）。

13.2 コース構造 XSD

ローカルでは v1/CourseStructure.xsd から、リモートでは https://w3id.org/xapi/profiles/cmi5/v1/CourseStructure.xsd から入手可能。LMS インポート機能のために、または LMS によってエクスポートのために作成されるすべてのコース構造はこの XSD に適合しなければならず（MUST）、"cmi5.xml" という名前でなければならない（MUST）。

14.0 コースパッケージ

6.1 節で定義するコースのインポートとエクスポートのために、LMS は以下の形式すべてをサポートしなければならない（MUST）。

• Zip32
• Zip64
• コース構造 XML ファイル

14.1 ZIP 形式のコースパッケージ

2 つの ZIP ファイル形式は、https://www.pkware.com/support/zip-app-note で定義される仕様に従わなければならない（MUST）。ZIP ファイルを使用してコースをパッケージ化するとき、コースのルートディレクトリにコース構造 XML ファイルを含めなければならず（MUST）、コースの AU と関連付けられたメディアをコースに含めてもよい（MAY）。

• ZIP コースパッケージに含めるメディアはすべて、コース構造 XML において相対 URL 参照を使用しなければならない（MUST）。
• ZIP コースパッケージに含めないメディアはすべて、コース構造 XML において FQDN 付きの URL 参照を使用しなければならない（MUST）。
• 以上のルールに従っている限り、完全修飾 URL と相対 URL を混在させてコースパッケージに含めてもよい（MAY）。

14.2 ZIP ファイルパッケージのないコース構造 XML

コース構造 XML ファイルが ZIP ファイルパッケージなしで提供される場合、すべての URL 参照は完全修飾でなければならない（MUST）。

15.0 コース構造の例

以下の 2 つの例では、地質学の分野において、コース設計者がいかに単純に、またいかに複雑にコースを構造化できるかを示す。タイトルと説明は Wikipedia の Earth Sciences Portal（https://en.wikipedia.org/wiki/Portal:Earth_sciences）から取得または翻訳される。

15.1 単純な例

単純な単一の AU コース構造は v1/examples/simple-cmi5.xml で入手できる。

15.2 複雑な例

複数の目標、ネスト構造のある複数のブロック、複数の AU ブロックなどを伴った複雑なコース構造は v1/examples/complex-cmi5.xml で入手できる。

15.3 拡張された例

拡張された単純なコース構造の例は v1/examples/extended-cmi5.xml で入手できる。この例では、v1/examples/extended-cmi5.xsd で定義された XML スキーマ定義に従ってベンダ固有メタデータを使用する。

使用許諾契約書

Copyright © 2012-2016 Advanced Distributed Learning (ADL) Initiative, U.S. Department of Defense, All rights reserved

Apache License, Version 2.0（以下「本ライセンス」）に基づき使用を許諾する。本ライセンスに適合しない形態で本ファイルを使用してはならない。本ライセンスのコピーは http://www.apache.org/licenses/LICENSE-2.0 で入手できる。

準拠法によって要求または書面にて合意された場合を除き、本ライセンスに基づいて配布されるソフトウェアは「現状有姿のまま」、明示的にも黙示的にも、いかなる種類の保証または条件も付帯することなく配布される。本ライセンスに基づく許可および制限を規定する具体的な文言については、本ライセンスを参照のこと。