CSVからジャパンサーチ型RDFを生成するCSV to Japan Search RDF Converter

必須の共通項目ラベルMandatory Items

定義表で必須（あれば必須）となっているラベル項目は、次のように扱います。

Followings are mappings for required items in Common Labels definition.

• IDからはレコードを識別する@idを生成します。
  • IDは1つだけ指定してください。複数指定すると最初のもののみ用い、2つ目以降の値は記述一般として扱います。指定がない場合はデータの行番号を用います。
  • @idにはデータ値をそのまま記述し、@contextの@baseによってURI化しています。生成したJSON-LDを実際に利用する場合は、この@baseを置き換えることで、適切なURIとすることができます。
  • 値の重複チェックは行ないません。ユニークな識別子であることが前提です。
  • 行番号による@idは、データの追加・削除が行なわれると変わってしまい、恒久的な識別子になりません。IDとなる項目を用意してください。
• 名称/タイトルは、schema:nameにマッピングするとともに、最初のものは併せてrdfs:labelにもなります。またschema:nameの値は言語タグを付与します。
  • 元データラベルが「名称」もしくは「タイトル」で始まり、区切り文字を挟んで「タイ語」などの言語名で終わっている場合は、すべての値にその言語名のタグを付与します（サンプルデータ4）。
  • でなければ、値が英数記号のみならば@en、それ以外は@jaとします。
• 定義表のURLは、所蔵館などのページのコンテンツリンクURL、収集サービス（つなぎ役）データベースのページなどの収集ページリンクURLに分けて扱います。前者はjps:accessInfo/schema:url、後者はjps:sourceInfo/schema:urlにマッピングされます。
  • サムネイル画像URLはschema:imageにマッピングされます。IIIFマニフェストURLは、jps:accessInfo/schema:urlとした上でsc:Manifest型を付与します。
  • 提供者、提供者URLは、個別レコードではなくデータセット名/URIに記述してください。
• 最終更新日はjps:sourceInfo/schema:dateModifiedにマッピングされます。定義表のコンテンツの権利区分、コンテンツ公開状況は、現在のRDFモデルでは対応がありません。

• id will be used to generate @id of the record.
  • Specify only one id field. If multiple fields to be set id, only the first one is used to generate @id, and rest will be treated as general field. If not specified, row number of the data will be used.
  • The value of @id is original data itself, and URIfyed via @base in @context. You can edit this @base to get more appropriate URIs.
  • Value conflict is not checked. Provide unique identifiers.
  • @id by row number is not persistent. Prepare one field to set id.
• title is mapped to schema:name, and the first one is also mapped to rdfs:label. The value of schema:name has language tag, which is set to @en if the value consists of only alphanumeric and/or punctuations, @ja otherwise. If original label starts with "名称" or "タイトル" and ends with language name in Japanese, the corresponding lang tag is used for all values.
• access_url is for landing page of holding institution (mapped to jps:accessInfo/schema:url), while database_url is for aggregator's database page (mapped to jps:sourceInfo/schema:url).
• thumbnail_url is mapped to schema:image. iiif_manifest is mapped to jps:accessInfo/schema:url and assigned a type sc:Manifest.
• last_modified is mapped to jps:sourceInfo/schema:dateModified.

任意の共通項目ラベルおよび追加マッピングOptional Items and Additional Mappings

定義表で任意となっているラベル項目は、次のように扱います。

Followings are mappings for non mandatory items in Common Labels definition.

• 場所は、値を簡易正規化してschema:spatial値とするとともに、jps:spatialで元データを含む構造化値を生成します。
  • 場所を「都道府県」「市町村」などに分割しているときは、「都道府県」を場所とし、「市町村」などを場所詳細として構造化値に加えることができます。サンプル2の「所在地区」やサンプル3の「出版国コード」もこれが使えます。
• 座標は、場所情報がある場合のみ、分割文字で[緯度,経度]に分割し、その構造化値に加えます（Geohashは生成しません）。
  • 座標が複数あるときは、最後のもののみが有効です。
  • 緯度、経度を個別のフィールドに記述することもできます。
  • 座標のみで場所がないときは、座標に基づく場所リソースと構造化値を生成して、そこに座標を加えます。場所が複数あるときは、場所詳細と同じく最初の場所に設定します。
• 時間/時代は、値を簡易正規化してschema:temporal値とするとともに、jps:temporalで元データを含む構造化値を生成します。
  • 場所と同様に時間/時代に関しても時間詳細を加えることができます（サンプル3の「出版年月日」など）。複数の扱いは場所の場合と同じです。
• 定義表の人物/団体はより細かく作者/著者、寄与者、出版者/公開者に分けてマッピングします（以下でこれらをエージェント型と呼びます）。それぞれschema:creators、chema:contributor、schema:publisherを生成するとともに、いずれもjps:agentialの値として構造化記述を生成します。

• location generates schema:spatial with semi normalized value, and also jps:spatial with a structured node.
  • location_detail can be added to structured node of primary location.
  • If multiple locations are present, location detail will be added to the first structured node.
• location_latlong is applicable only when a field mapped with location is present. Value is divided into [lat, long], and will be added to the structured node of the location (Geohash is not generated).
  • Only one location_latlong is applied (last one, if more than one present).
  • location_lat, location_long can be described in separate fields.
  • If multiple lat/longs are present, location detail will be added to the first structured node.
  • If location_latlong is present but no location, a pseudo location resounce and structured node will be generated, and geo will be added to that node.
• temporal generates schema:temporal with semi normalized value, and also jps:temporal with a structured node.
  • Temporal field can have temporal_detail. Same as location case if multiple details present.
• creator, contributor and publisher generate corresponding schema: property, as well as jps:agential with a structured node.

定義表にない、次のマッピングを用意しています。

Followings are mappings not defined in Common Labels.

• コンテンツのタイプを示すため、「タイプ」「ジャンル」などをタイプ（クラス）としてマッピングできます。該当する項目がない場合は、基本クラスの設定に従います。
  • タイプはコンテンツの基本区分（書籍、文化財など大きく情報を区分する枠）を示します。利活用スキーマでRDF化する利点はさまざまな種類のコンテンツ情報を同じモデルで記述できるところにありますが、こうしたデータを組み合わせて利用する場合、それがどんなタイプなのか（図書なのか、絵画なのか、あるいは建築物なのか）を判別できることがとても重要です。
  • 元データは、項目名を導入句にしたschema:description（記述一般と同じ）としても保持します。タイプを複数指定すると、2つ目以降の値は記述一般のみになります。
• キーワード/主題/分類は、schema:aboutにマッピングされます。元データの項目が「分類」でも、タイプ（クラス）とする方が適切なケースもあるので、その場合は選択メニューでマッピングを変更してください。
• 識別子は、ラベルがISBN、ISSNの場合は対応するschema.orgプロパティも生成します。それ以外は、現在のところjps:accessInfo/jps:contentIdの値にしています。

• Use type to specify the content's type (class). If no field is set to this mapping, Default type will be used.
• keywd_subj is mapped to schema:about.
• At this moment, identifier generates schema.org if field label is ISBN or ISSN.Otherwise, this will be mapped to jps:accessInfo/jps:contentId.

データ値の処理と簡易正規化Data Value Porcessing and Normalization

次のような値処理を組み込んでいます。

Some special value treatmens will be applied for certain fields.

• 作者/著者、寄与者、場所、キーワード/主題/分類は、分割文字（列）を指定してフィールド値を分割処理させることができます。
• 構造化値の役割（jps:relationType）は、項目名から自動設定します。作者/著者、寄与者のみ、データ値末尾に「著」「編」などがあればそれを役割に用い、名前からは削除します。

• creator, contributor, location and keywd_subj can be divided into multiple values, with "sep char" set.
• The role in structured node (jps:relationType) will be determined by source field label, though only Japanese label is useful for this mapping at this moment.

辞書を用いた正規化は対応していませんが、次のような簡易処理を行ないます。

Although values are not consulted to dictionaries, some simple normalization will be taken place.

• 場所は、都道府県名で始まる場合は、place:名前空間の値に正規化します。最初が市区町村名である場合は、そこまでを取り出してncplace:名前空間の値とします。元の値は構造化ノードのschema:descriptionに保持します。
• 時間/時代は、最初が3-4桁の数字なら西暦年、最初が数字2桁＋"世紀"ならば年範囲、時代を表す文字列があればその時代を、time:名前空間の値に正規化します。それ以外はtime:_undefinedになります。いずれの場合も元の値は構造化ノードのschema:descriptionに保持します。
• エージェント型およびキーワード/主題/分類は、項目名をNDC（あるいはNDC9）、NDLC、NDLSH、NDLA、VIAF、Wikidata、DBpedia、DBpedia-jとするか、これらの名前を項目名末尾に半角()で加えると、データ値をそれぞれの名前空間に連結してURIとします（サンプル1の「作者(NDLA)」、サンプル3の「分類(NDLC)」）。またこれらの項目名のデータ値を"名前(コード)"の形にすると、コードの部分を切り出してURIのローカル名とします（括弧は半角）。
• 正規化されない値は、エージェント型はncname:、場所はncplace:、キーワード/主題/分類はkeyword:名前空間URIに連結します。このとき、一定以上の長さの値は、後半をハッシュ化してローカル名とします。

• Value of spatial will be normalized if it starts with (1) 都道府県 (prefecture in Japanese), use the 都道府県 name as the localname in place: namespace; (2) 市区町村 (cities), use the 市区町村 name as the localname in ncplace: namespace. In either case, the original value is preserved as schema:description in the structured node.
• Value of temporal will be normalized in time: namespace if it (1) begins with 3-4 digits, (2) begins with 2 digits followed by "世紀" (century), or (3) containts "時代" (era). Otherwise, normalized value will be time:_undefined. In either case, the original value is preserved as schema:description in the structured node.
• For "agent" (creator, contributor and publisher) and keywd_subj, if the source field label is an authority name (one of NDC (or NDC9), NDLC, NDLSH、NDLA, VIAF, Wikidata, DBpedia or DBpedia-j), or appended an authority name in parentheses e.g. "creator (DBpedia)", data value will be appended to corresponding namespace URI. If the value of those fields is in the form of "value (code)", code part is used as the local name, allowing more readable data value (original data is preserved in the structured node).
• Non-normalized values will be local names with namespace URIs, ncname: for "agent", ncplace: for location and keyword: for keywd_subj. Long local name will be trimed at certain length, and the rest part is hashed.