11.9.4. フレームワークファイルをインポートする

管理メニュー → 拡張機能 → スマートエビデンス → インポート

スマートエビデンスナビゲーションの インポート リンクをクリックして、スマートエビデンスフレームワークをインポートできます。フレームワークファイルは、Maharaが認識および解釈するために拡張子.matrixで終わる必要があります。

コンピテンシーフレームワークを含む .matrix ファイルをアップロードする

  1. インポート リンクをクリックして、スマートエビデンスファイルをアップロードできる画面に移動します。

  2. 使用したいフレームワークを含んでいる matrix ファイルを選択するために、閲覧 ボタンをクリックします。

  3. ファイルをアップロードするために マトリックスをアップロードする ボタンをクリックします。

ファイルの構造に問題がないかファイルがチェックされます。問題が発生した場合は拒否されます。最も一般的な問題は次のとおりです:

  • 省略名が100文字を超えています。

  • 標準要素の名前が255文字を超えています。

  • 句読点または括弧が正しくありません。

JSONフォーマッタ&バリデータJSONフォーマッタ などのJSONバリデータは、通常、構文エラーを発見できます。文字長のエラーは手動で分類する必要があります。

11.9.4.1. フレームワークファイルを作成する

既存のファイルをダウンロードする からスマートエビデンスフレームワークを開始します。その後、任意の数の変更を加えることができます。

注釈

コミュニティと共有したい独自のスマートエビデンスフレームワークファイルを作成した場合は、ダウンロードしてレビューするために、私たちにそれらを送信 してください。

任意のテキストエディタを使用して、スマートエビデンスフレームワークファイルを作成および編集できます。JSONファイルの構文強調表示をサポートするエディタがある場合は、変更可能なテキストを、Maharaがファイルを解釈するために必要なプロンプトと区別できるという利点があります。

JSONエディタ、例えば、JSON Editor Online または JSONedit を使用することもできます。JSON構文をほとんど使用しないでファイルを表示できます。

注釈

サンプル のうちの一つを利用して、そのとき構造を知り、ファイルにすべての関連した要素を持っているので、フレームワークファイルを始めるのが最もよいです。

11.9.4.2. ファイルの開始

フレームワークファイルは、フレームワークをニーズにカスタマイズすることを可能にする最初に、多くのパラメータを含んでいます。

マトリクスファイルの開始

  1. institution: フレームワークを使用するインスティテューションの短縮名をここに入力してください。フレームワークがすべてのインスティテューション向けである場合、 all はここに配置されます。

    注釈

    インスティテューションの短縮名は、インスティテューション概要ページ のインスティテューション名にカーソルを合わせ、URLの末尾を見ると確認できます。最後のパラメータは、インスティテューションの短縮名です。

  2. name: 作成者に示されるべきフレームワークのタイトルです。

  3. description: フレームワークの説明(description)は、コレクションのスマートエビデンスページに表示されます。それは基本的なHTMLコードを含むことができます。

  4. 説明フィールドのHTMLコードで引用符を使用する必要がある場合は、引用符をエスケープする必要があります。それ以外の場合は、コマンドとして解釈されます。エスケープは、引用符 \" の直前にバックスラッシュを配置することによって行われます。

  5. selfassess: 人が彼らのコンピテンシーを自己評価(selfassess)できるか、またはコンピテンシが他の誰かにより評価できるだけであるかを決定します。次の二つの値が許されます:

    • true: 作成者は自己評価できます。

    • false: 作成者は自己評価を遂行できません。

  6. evidencestatuses: 現在、エビデンスマップで使用できるエビデンスステータスには、開始、未完了、部分的に完了、完了の四つがあります。設定したフレームワークで、これらのステータスに使用する単語を決定できます。例えば、これにより、さまざまな言語でフレームワークを設定できます。

  7. standards: 文書の残りは標準(standards)とサブ標準(standard elements)を保持します。

注釈

マトリックスファイルを変更するときは注意してください。使用するセクション内のコンマ、引用符、括弧、中括弧、またはその他の記号を削除しないようにしてください。これらは、ファイルを正しく解釈するために必要です。

例えば、ファイルを JSON フォーマッタとバリデータ に貼り付けることで、ファイルに必要な構文がすべて含まれているかどうかを確認できます。問題があり、JSONがファイルを解釈できない場合、バリデータはエラーが発生する場所を指定するため、エラーを追跡して修正できます。

11.9.4.3. 標準セクション

初期の情報の後に、標準(standards) を定義することができます。それらはスマートエビデンス概要ページの見出しレベルを提供します。

マトリクスファイルの標準

  1. standards: このセクションの紹介です。望んでいるのと同数の標準(standards)を定義することができます。制限はありません。

  2. shortname: 各標準には省略名が必要です。完全なタイトルの番号または要約。省略名は必須で、最大100文字です。

  3. 名称: 標準のタイトルです。必須で最大半角255文字の長さにしてください。

  4. description: 説明(description)は省略可能で、標準(standard)のタイトル(name)上に移動するとき表示されます (モバイルでタッチクリック)。

  5. standardid: それらが正しい順序で置かれ、標準(standard)の要素から戻って参照されるように、個々の標準に自然数を与えます。

  6. コンマを最後の標準(standard)の閉じ波(中)カッコの後に置いてはいけません。

11.9.4.4. 標準要素(サブ標準)セクション

標準(standard)の後に、すべての 標準要素(standard elements)、すなわち個々のサブ標準を定義します。それらはエビデンスを追加できるものです。

注釈

マッピングが正しく起こるように、すべてのサブレベルをより高いレベルのサブ標準のすぐ後に置きます。

マトリクスファイルの標準要素(サブ標準)

  1. standardelements: このセクションの紹介です。いくつの標準要素(サブ標準)を定義することができるかの制限はありません。

  2. shortname: 省略名は、スマートエビデンス概要ページに表示されます。これは必須で、最大100文字です。

  3. name: 標準要素のタイトルです。それは必須で、最大255文字の長さです。

  4. description: 説明は省略可能であり、標準要素の名前にカーソルを合わせると表示されます(モバイルでタッチクリック)。

  5. standardid: 特定の標準要素(サブ標準)を関連付けたい標準(standard)のIDを提供します。

  6. elementid: 別のサブレベルを持っているとき、それを参照できるように、標準要素(サブ標準)にIDを与えます。IDは引用符の間に置かれる必要があります。

  7. parentelementid: 設定する標準要素(サブ標準)が、より低いレベルにある場合、親の標準要素(サブ標準)のelementidを提供します。IDは引用符の間に置かれる必要があります。

    注釈

    標準要素(サブ標準)が下のレベルを持っているとき、それはエビデンス自身、下のレベルの標準要素とだけ関連付けることができません。

11.9.4.5. ファイルの終わり

すべての標準(standard)およびサブ標準(standard elements)を定義したとき、ファイルを終了することができます。

マトリクスファイルの終わり

  1. コンマを最後の標準要素の最後の波カッコの後に置いてはいけません。

  2. すべてのアングルブラケット(山カッコ)および波カッコを確実に閉じます。

11.9.4.6. 結果

ファイルを完成したら、それをMaharaに インポート して、使用を開始できます。

アップロードされた完了した結果

  1. フレームワークのタイトル。

  2. フレームワークの説明。

  3. 標準。それはその下位レベルだけに関連したエビデンスを持つことができません。

  4. 標準要素。

  5. さらに下位レベルの要素を持つ標準要素。それはその下位レベルだけに関連したエビデンスを持つことができません。

  6. 要素の3番目のレベル。

    注釈

    コンピテンシーフレームワークに4以上のレベルを持つことができます。読みやすさはレベルが多くなると減少します。