JSONデータプロバイダは、［レポートデータソース］ダイアログ内の［接続］セクションで以下のオプションをサポートしています。
スキーマ
ActiveReports12.0Jでは、JSONデータプロバイダはJSONスキーマを使用してフィールドを取得します。JSONスキーマはJSONデータの構造を表します。JSONスキーマの詳細については、http://json-schema.org/latest/json-schema-core.htmlを参照してください。
JSONスキーマのキーワードは以下のとおりです。
- 型（types）: JSONスキーマの要素の型を定義します。型の詳細については、こちら（英語サイト）を参照してください。
- プロパティ（properties）: オブジェクト型のJSONスキーマ要素のプロパティコレクションを定義します。プロパティの詳細については、こちら（英語サイト）を参照してください。
- 項目（items）: JSONスキーマ要素の配列型の項目の定義を表します。1つだけの値がサポートされます。
たとえば、"items" : [ {...}, {...}, {...} ]は複数の値を含んでいるため、サポートされません。項目の詳細については、こちら（英語サイト）を参照してください。
- 定義（definitions）:
$refを含んでいる他のJSONスキーマ要素に使用する個別の定義を定義しています。定義の詳細については、こちら（英語サイト）を参照してください。
- $ref: オブジェクト型のJSONスキーマ要素の定義への参照を定義します。サポートされているのは、定義(
{ $ref : #/definitions/... })の参照だけです。
 |
メモ: JSONプロバイダの接続文字列の作成に必要なオプションはスキーマのみです。 |
［スキーマ］タブでは、使用するJSONデータに対応するJSONスキーマファイルを選択します。JSONスキーマを指定するうえで使用可能なオプションは次のとおりです。
- 外部ファイルまたはURL: JSONスキーマの外部ファイルのパス、またはURLを入力するか、ドロップダウンからレポートが配置されているのと同じフォルダに存在するJSONファイルを選択します。このオプションを使用して作成された接続文字列は schemadocで開始します。
- 埋め込み: レポートに埋め込むJSONスキーマファイルのパスを入力します。手動でスキーマを入力するか、選択したJSONファイル内でスキーマを編集することができます。このオプションを使用して作成された接続文字列は schemadataで始まります。
JSONスキーマについては、http://jsonschema.net/#/などのJSONスキーマジェネレータを使用して自動生成することができます。
コンテンツ
［コンテンツ］タブでは、JSONデータソースの形式を指定します。指定に使用可能なオプションは次のとおりです。
- 外部ファイルまたはURL: JSONスキーマの外部ファイルのパス、またはURLを入力するか、ドロップダウンからレポートが配置されているのと同じフォルダに存在するJSONファイルを選択します。このオプションを使用して作成された接続文字列はjsondocで開始します。
- 埋め込み: レポートに埋め込むJSONデータファイルのパスを入力します。データは手動で入力するか、選択したJSONファイル内で編集することができます。このオプションを使用して作成する接続文字列は、jsondataで開始します。
- 式: 実行時にJSONデータにバインドするための式を入力します。式の詳細については、「動的に作成したJSONデータソースの使用」を参照してください。
接続文字列
JSON接続文字列は2箇所で構成されています。「jsondoc」あるいは「jsondata」と「schemadoc」あるいは「schemadata」の箇所です。
- jsondocあるいはjsondata: ローカルシステム上、またはWeb上のアクセス可能な場所にある特定のJSONファイルを指定します。
-
schemadocあるいはschemadata: 既存のJSONデータに対応するJSONスキーマファイルを指定します。
例：
jsondoc=C:\Data\customers.json;schemadata={
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"address": {
"type": "object",
"properties": {
"streetAddress": {
"type": "string"
},
"city": {
"type": "string"
}
},
"required": [
"streetAddress",
"city"
]
},
"phoneNumber": {
"type": "array",
"items": {
"type": "object",
"properties": {
"location": {
"type": "string"
},
"code": {
"type": "integer"
}
},
"required": [
"location",
"code"
]
}
}
},
"required": [
"address",
"phoneNumber"
]
}