Merge pull request #25 from Kaichi-Nakamura-96/hotfix/W2024-58_mapper

Hotfix/w2024 58 mapper

Author: ivis-kuroda

docs/spec/base/api/API_06_sword_api.md

@@ -12,6 +12,7 @@
 - [処理概要](#処理概要)
 - [エラーメッセージ](#エラーメッセージ)
 - [サーバー設定値](#サーバー設定値)
+- [付録](#付録)
 - [更新履歴](#更新履歴)
 
 ## 目的・用途
@@ -1440,12 +1441,178 @@ JSON-LD形式メタデータをマッピング定義に従ってWEKO3の登録
 
   ```json
   {
-    "extra": "{"著者.出身: 東京", "ファイル.改行コード: LF"}"
+    "extra": "{'著者.出身: 東京', 'ファイル.改行コード: LF'}"
   }
   ```
 
 以上の工程により、アイテムタイプを完成させる。
 
+##### 3. リストの処理について
+JSON-LD形式メタデータおよびアイテムタイプでは、リストに複数の同様のメタデータが格納されるプロパティが含まれる場合がある。  
+このとき、以下の3つの場合が考えられる。
+
+1. JSON-LD形式メタデータでリストに格納される回数と、アイテムタイプでリストに格納される回数が一致する場合
+2. JSON-LD形式メタデータでリストに格納される回数がアイテムタイプでリストに格納される回数より多い場合
+3. JSON-LD形式メタデータでリストに格納される回数がアイテムタイプでリストに格納される回数より少ない場合
+
+それぞれの場合について、以下の処理を行う。
+
+1. 各リストの深さを一致させることができるため、JSON-LD形式の各リストの要素に合わせてマッピング処理を行う。
+2. アイテムタイプのリストに格納される回数と一致するまで、JSON-LD形式メタデータのリストの外側から順に、リストの0番目の要素を取得して処理を行い、一致したら上記[1]と同様のマッピング処理を行う。
+3. JSON-LD形式のリストの要素を、アイテムタイプのリストの外側から順に対応させるよう処理を行う。
+
+上記[3]の場合の具体的な処理について記す。  
+JSON-LD形式メタデータでリストに2回格納されているプロパティを、アイテムタイプでリストに3回格納されるプロパティとしてマッピングする場合を考える。
+
+以下は1つ目のリストに2つの要素を含み、その中の2つ目のリストに2つずつのプロパティを含むJSON-LD形式メタデータ(マッピング元メタデータ)を、JSON形式で表現した例である。
+
+マッピング元メタデータ(JSON形式)  
+```json
+{
+    "json_prop1": [
+        {
+            "json_subprop1": [
+                {
+                    "json_name": "Name1"
+                },
+                {
+                    "json_name": "Name2"
+                }
+            ]
+        },
+        {
+            "json_subprop1": [
+                {
+                    "json_name": "Name3"
+                },
+                {
+                    "json_name": "Name4"
+                }
+            ]
+        }
+    ]
+}
+```
+
+これを要素の区分が分かるよう、以下に図示した。  
+<img src="../media/media/image13.png" width="50%">
+
+マッピング結果として、以下の3パターンが考えられるが、本処理ではパターン1の結果となる。
+
+マッピング結果: パターン1  
+```json
+{
+    "Prop1": [
+        {
+            "subProp1": [
+                {
+                    "subsubProp1": [
+                        {
+                            "name": "Name1"
+                        }
+                    ]
+                },
+                {
+                    "subsubProp1": [
+                        {
+                            "name": "Name2"
+                        }
+                    ]
+                }
+            ]
+        },
+        {
+            "subProp1": [
+                {
+                    "subsubProp1": [
+                        {
+                            "name": "Name3"
+                        }
+                    ]
+                },
+                {
+                    "subsubProp1": [
+                        {
+                            "name": "Name4"
+                        }
+                    ]
+                }
+            ]
+        }
+    ]
+}
+```
+
+マッピング結果: パターン2  
+```json
+{
+    "Prop1": [
+        {
+            "subProp1": [
+                {
+                    "subsubProp1": [
+                        {
+                            "name": "Name1"
+                        },
+                        {
+                            "name": "Name2"
+                        }
+                    ]
+                }
+            ]
+        },
+        {
+            "subProp1": [
+                {
+                    "subsubProp1": [
+                        {
+                            "name": "Name3"
+                        },
+                        {
+                            "name": "Name4"
+                        }
+                    ]
+                }
+            ]
+        }
+    ]
+}
+```
+
+マッピング結果: パターン3  
+```json
+{
+    "Prop1": [
+        {
+            "subProp1": [
+                {
+                    "subsubProp1": [
+                        {
+                            "name": "Name1"
+                        },
+                        {
+                            "name": "Name2"
+                        }
+                    ]
+                },
+                {
+                    "subsubProp1": [
+                        {
+                            "name": "Name3"
+                        },
+                        {
+                            "name": "Name4"
+                        }
+                    ]
+                }
+            ]
+        }
+    ]
+}
+```
+
+各要素の区分が分かるよう、以下に図示した。  
+<img src="../media/media/image14.png" width="100%">
 
 ## 更新履歴