JSON-LD 1.1 フレーミング

4.1.1 概要

有効なJSON-LD フレームは、 有効なJSON-LD 文書の上位集合であり、 展開を通じて保持される追加内容を許可します。 JSON-LD 1.1 Syntax 仕様 [JSON-LD11] で定義された 文法は、 次のように拡張されます:

• フレーミングは、フレーミング キーワードを追加します。これはノードオブジェクトの エントリとして使用でき、 展開時に保持されなければ MUST なりません。
• フレームオブジェクト内の エントリの値で、 キーワードでないものは、 デフォルトオブジェクトを含んでも MAY です。 @default の値は、エントリキーが IRIに展開される値の文法で許可される 他の値に加えて、値 @null、 または @null のみを含む配列を含んでも MAY です。 プロセッサーは、 展開時にこの値を保持しなければ MUST なりません。 デフォルト オブジェクトの他のすべてのエントリは 無視されなければ MUST なりません。
• @id および @type の値は、空のmap、 IRI 参照、 空のmapのみを含む 配列、 またはIRI 参照の配列 であってもよいです。 @type の値は、 @default エントリを持つmapであっても MAY よく、その値は IRIであることに制限されます。 プロセッサーは、 展開時にこの値を保持しなければ MUST なりません。
• フレーミングは、入力文書に含まれるマージされたノード定義上で動作するか、 入力フレームが最上位に @graph エントリを含むかどうかに応じて デフォルトグラフ上で動作します。 名前付き グラフでもある主語を持つノードで、 フレームオブジェクトが @graph を含む場合、フレーミングは、関連する 名前付きグラフからの ノード オブジェクトへ拡張されます。

4.1.2 アルゴリズム

フレーミングアルゴリズムは、 5つの必須入力変数と1つの任意入力変数を取ります。 必須入力は、 フレーミング状態 (state)、 フレーミングする subjects のリスト、 入力フレーム (expanded frame)、 部分的なフレーム結果を収集するために使用される parent、 および active property です。 任意入力変数は ordered フラグです。

このアルゴリズムは、parent が配列である場合には要素を parent に追加することで、または parent がmapである場合には、 parent 内の active property に関連付けられた配列へ追加することで、 parent に要素を追加します。 parent が配列である場合、 active property は null でなければ MUST ならず、 それがmapである場合、 null であっては MUST NOT なりません。

1. frame が配列である場合、 frame をその配列の値に設定します。 これは有効なフレームでなければ MUST なりません。 frame が無効であると判定された場合、 invalid frame エラーが検出され、処理は中止されます。
   1. Frame はmapでなければ MUST なりません。
   2. frame が @id エントリを持つ場合、その値は、 値として単一の空のmapを含む 配列、 有効なIRI、 またはすべての値が有効なIRIである 配列のいずれかで なければ MUST なりません。
   3. frame が @type エントリを持つ場合、その値は、 値として単一の空のmapを含む 配列、 キーが @default であるエントリを持つ mapを含む 配列、 有効なIRI、 またはすべての値が有効なIRIである 配列のいずれかで なければ MUST なりません。
2. state 内の オブジェクト埋め込みフラグ、 明示的 包含フラグ、および 全要求フラグから フラグ embed、explicit、および requireAll を初期化し、 frame 内の @embed、@explicit、および @requireAll の任意のプロパティ値で上書きします。
3. state、subjects、frame、および requireAll を用いて、フレーム照合アルゴリズムにより subjects を frame に対してフィルターして、 一致した主語のリストを作成します。
4. 一致した主語の集合から、id と関連付けられたノードオブジェクト node のそれぞれについて、 任意の ordered フラグが true である場合には id の辞書順で:
   1. output を、@id と id を持つ新しいmapに初期化します。
   2. state 内の埋め込みフラグが false であり、 state 内の graph name および id に関連付けられた 既存の埋め込みノードが parent 内にある場合、 この node について追加処理を実行しません。
   3. そうでなければ、state 内の埋め込みフラグが true であり、 embed が @never であるか、埋め込みによって 循環参照が作成される場合、 output を parent に追加し、 この node について追加処理を実行しません。
   4. そうでなければ、state 内の埋め込みフラグが true であり、 embed が @once であり、 state 内の graph name および id に関連付けられた 既存の埋め込みノードが parent 内にある場合、 output を parent に追加し、 この node について追加処理を実行しません。
   5. state 内の graph map が id のエントリを持つ場合:
      1. frame が @graph エントリを持たない場合、 state 内の graph name が @merged でない限り、 recurse を true に設定し、 subframe を新しい空のmapに設定します。
      2. そうでなければ、subframe を frame 内の @graph の最初のエントリに設定し、 存在しない場合は新しい空のmapに設定し、 id が @merged または @default でない限り、 recurse を true に設定します。
      3. recurse が true の場合:
         1. state 内の graph name の値を id に設定します。
         2. state 内の埋め込みフラグの値を false に設定します。
         3. state のコピーを使用してアルゴリズムを呼び出します。 その際、graph name の値を id に設定し、 埋め込みフラグの値を false に設定し、 state 内の graph map から id に関連付けられたキーを subjects とし、 subframe を frame とし、 output を parent とし、@graph を active property とします。
   6. frame が @included エントリを持つ場合、 埋め込みフラグの値を false に設定した state のコピーを使用して アルゴリズムを呼び出し、 subjects、frame、 output を parent とし、@included を active property とします。
   7. node 内の各 property および objects について、 任意の ordered フラグが true である場合には property の辞書順で:
      1. property がキーワードである場合、 property と objects を output に追加します。
      2. そうでなければ、property が frame 内になく、 explicit が true である場合、 プロセッサーは property の値を output に追加しては MUST NOT ならず、次の ステップはスキップされます。
      3. objects 内の各 item について:
         1. item がプロパティ @list を持つmapである場合、 リスト内の各 listitem は順に処理され、 出力内の新しいリストmapに追加されます:
            1. listitem がノード 参照である場合、 アルゴリズムを呼び出します。 その際、 埋め込みフラグの値を true に設定した state のコピーを使用し、 listitem からの @id の値を、 新しい subjects 配列内の唯一の項目とし、 frame 内の @list からの最初の値を frame とし、 list を parent とし、@list を active property とします。 frame が存在しない場合、 @embed、@explicit、 および @requireAll のプロパティを持つ新しい mapを使用して 新しい frame を作成し、 それらは embed、explicit、および requireAll から取得されます。
            2. そうでなければ、listitem のコピーを list 内の @list に追加します。
         2. item がノード 参照である場合、 アルゴリズムを呼び出します。 その際、 埋め込みフラグの値を true に設定した state のコピーを使用し、 item からの @id の値を、 新しい subjects 配列内の唯一の項目とし、 frame 内の property からの最初の値を frame とし、 output を parent とし、property を active property とします。 frame が存在しない場合、新しい frame を 新しいmapを使用して作成し、 @embed、@explicit、および @requireAll のプロパティを embed、explicit、および requireAll から取得します。
         3. そうでなければ、item のコピーを output 内のアクティブ プロパティに追加します。
      4. frame 内の、キーワードでない 各 property および objects で、 (`@type 以外) output 内にないものについて:
         1. item を objects 内の最初の値とします。これは フレームオブジェクトでなければ MUST なりません。
         2. property frame を objects 内の最初の値に設定します。 値が objects の場合は、新しく作成された フレームオブジェクトに設定します。 property frame はmapでなければ MUST なりません。
         3. property frame が値 true の @omitDefault を含む場合、または @omitDefault を含まず、state 内の デフォルト省略フラグの値が true である場合、 property および property frame をスキップします。
         4. property を output に追加し、 プロパティ @preserve を持つ新しい mapを値とします。 その値は、存在する場合は frame 内の @default の値のコピー、 そうでなければ文字列 @null です。
      5. frame がプロパティ @reverse を持つ場合、 frame 内の @reverse の値である 各 reverse property および sub frame について:
         1. output 内に @reverse プロパティを作成し、 新しいmap reverse dict をその値とします。
         2. 平坦化された主語の map内の各 reverse id および node で、 reverse property プロパティを持ち、 id の @id を持つノード 参照を含むものについて:
            1. reverse property を reverse dict に追加し、 新しい空の配列を その値とします。
            2. アルゴリズムを呼び出します。 その際、 埋め込みフラグの値を true に設定した state のコピーを使用し、 reverse id を 新しい subjects 配列内の唯一の項目とし、 sub frame を frame とし、 null を active property とし、 reverse dict 内の reverse property の 配列値を parent とします。
      6. 前のステップで要求されるように output が設定されたら、 output を parent に追加します。