{"id":15268,"date":"2025-06-08T07:08:53","date_gmt":"2025-06-07T22:08:53","guid":{"rendered":"https:\/\/www.sambuichi.jp\/?p=15268"},"modified":"2025-06-08T07:19:37","modified_gmt":"2025-06-07T22:19:37","slug":"aws-ec2-%e4%b8%8a%e3%81%a7-json-schema-draft-2020-12-un-cefact-%e3%82%b9%e3%82%ad%e3%83%bc%e3%83%9e%e3%82%92%e6%a4%9c%e8%a8%bc%e3%81%99%e3%82%8b%e7%92%b0%e5%a2%83%e6%a7%8b%e7%af%89%e6%89%8b%e9%a0%86","status":"publish","type":"post","link":"https:\/\/www.sambuichi.jp\/?p=15268","title":{"rendered":"AWS EC2 \u4e0a\u3067 JSON Schema Draft 2020-12 + UN\/CEFACT \u30b9\u30ad\u30fc\u30de\u3092\u691c\u8a3c\u3059\u308b\u74b0\u5883\u69cb\u7bc9\u624b\u9806"},"content":{"rendered":"

Views: 13<\/p>

\n

AWS EC2 \u4e0a\u3067 JSON Schema Draft 2020-12 + UN\/CEFACT \u30b9\u30ad\u30fc\u30de\u3092\u691c\u8a3c\u3059\u308b\u74b0\u5883\u69cb\u7bc9\u624b\u9806<\/h1>\n
\nChatGPT (\u7de8\u96c6\uff1a\u4e09\u5206\u4e00\u4fe1\u4e4b\uff09<\/span>
\n2025-06-07<\/span>\n<\/div>\n<\/div>\n
\n
\n
\n
\n

\n\u672c\u8a18\u4e8b\u3067\u306f\u3001UN\/CEFACT \u306b\u3088\u3063\u3066\u516c\u958b\u3055\u308c\u3066\u3044\u308b JSON Schema \u5b9a\u7fa9\u3068 XBRL GL \u30a4\u30f3\u30b9\u30bf\u30f3\u30b9\u3092\u4f7f\u7528\u3057\u3066\u3001Amazon EC2 \u4e0a\u306b JSON Schema Draft 2020-12 \u6e96\u62e0\u306e\u691c\u8a3c\u74b0\u5883\u3092\u69cb\u7bc9\u3059\u308b\u624b\u9806\u3092\u7d39\u4ecb\u3057\u307e\u3059\u3002\n<\/p><\/blockquote>\n<\/div>\n<\/div>\n<\/div>\n

\n

1. \u524d\u63d0\u74b0\u5883\u306e\u69cb\u7bc9<\/h2>\n
\n
\n

1.1. OS \u3068 Node.js \u306e\u30d0\u30fc\u30b8\u30e7\u30f3\u78ba\u8a8d<\/h3>\n
\n

Amazon Linux 2 \u3067\u306f fs\/promises<\/code> \u3084 ajv\/dist\/2020<\/code> \u306e\u8aad\u307f\u8fbc\u307f\u306a\u3069\u306b\u554f\u984c\u304c\u3042\u3063\u305f\u305f\u3081\u3001Amazon Linux 2023 \u3092\u4f7f\u7528\u3057\u307e\u3057\u305f\u3002<\/p>\n<\/div>\n

\n
\n
$ uname -a\r\nLinux ip-xxx.ap-northeast-1.compute.internal ...\r\n$ cat \/etc\/os-release\r\nNAME=\"Amazon Linux\"\r\nVERSION=\"2023\"<\/code><\/pre>\n<\/div>\n<\/div>\n
\n
Node.js \u306f\u4ee5\u4e0b\u306e\u3068\u304a\u308a\u30d0\u30fc\u30b8\u30e7\u30f3 18.20.8 \u3092\u4f7f\u7528\uff1a<\/p>\n<\/div>\n
\n
\n
$ node -v\r\nv18.20.8<\/code><\/pre>\n<\/div>\n<\/div>\n<\/div>\n
\n
1.2. \u5fc5\u8981\u306a\u30e2\u30b8\u30e5\u30fc\u30eb\u306e\u30a4\u30f3\u30b9\u30c8\u30fc\u30eb<\/h3>\n
\n
\n
$ npm install ajv@8.17.1 ajv-formats@3.0.1<\/code><\/pre>\n<\/div>\n<\/div>\n
\n\n\n
\n
Note<\/div>\n<\/td>\n
\n
\n
\u958b\u767a\u521d\u671f\u6bb5\u968e\u3067\u306f\u4ee5\u4e0b\u306e\u3088\u3046\u306b @latest<\/code> \u3092\u6307\u5b9a\u3057\u3066\u6700\u65b0\u5b89\u5b9a\u7248\u3092\u53d6\u5f97\u3059\u308b\u3053\u3068\u3082\u53ef\u80fd\u3067\u3059\u3002<\/p>\n<\/div>\n
\n
\n
$ npm install ajv@latest ajv-formats@latest<\/code><\/pre>\n<\/div>\n<\/div>\n
\n
\u305f\u3060\u3057\u3001@latest<\/code> \u3092\u4f7f\u7528\u3059\u308b\u3068\u5c06\u6765\u306e\u30d0\u30fc\u30b8\u30e7\u30f3\u30a2\u30c3\u30d7\u306b\u3088\u3063\u3066\u52d5\u4f5c\u304c\u5909\u308f\u308b\u53ef\u80fd\u6027\u304c\u3042\u308a\u307e\u3059\u3002
\n\u672c\u8a18\u4e8b\u3067\u306f\u518d\u73fe\u6027\u3092\u91cd\u8996\u3059\u308b\u305f\u3081\u3001\u52d5\u4f5c\u78ba\u8a8d\u6e08\u307f\u306e\u30d0\u30fc\u30b8\u30e7\u30f3\u3092\u660e\u793a\u7684\u306b\u6307\u5b9a\u3057\u3066\u3044\u307e\u3059\u3002<\/p>\n<\/div>\n<\/td>\n<\/tr>\n<\/table>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n
\n
2. UN\/CEFACT \u30b9\u30ad\u30fc\u30de\u306e\u53d6\u5f97<\/h2>\n
\n
\n
2.1. GitHub \u304b\u3089\u306e\u53d6\u5f97\u65b9\u6cd5\uff08\u63a8\u5968\uff09<\/h3>\n
\n
\n
$ git clone https:\/\/github.com\/uncefact\/spec-JSONschema.git\r\n$ cd spec-JSONschema\/JSONschema2020-12\/library\/BuyShipPay\/D23B\/<\/code><\/pre>\n<\/div>\n<\/div>\n<\/div>\n
\n
2.2. curl \u3067\u500b\u5225\u53d6\u5f97\u3059\u308b\u5834\u5408<\/h3>\n
\n
\n
$ mkdir -p schemas\/meta schemas\/codelists\r\n\r\n$ curl -L -o schemas\/meta\/metadata.json \\\r\n  https:\/\/raw.githubusercontent.com\/uncefact\/spec-JSONschema\/main\/JSONschema2020-12\/library\/BuyShipPay\/D23B\/meta\/metadata.json\r\n\r\n$ curl -L -o schemas\/UNECE-BasicComponents.json \\\r\n  https:\/\/raw.githubusercontent.com\/uncefact\/spec-JSONschema\/main\/JSONschema2020-12\/library\/BuyShipPay\/D23B\/UNECE-BasicComponents.json\r\n\r\n$ curl -L -o schemas\/codelists\/UnitCode.json \\\r\n  https:\/\/raw.githubusercontent.com\/uncefact\/spec-JSONschema\/main\/JSONschema2020-12\/library\/BuyShipPay\/D23B\/codelists\/UnitCode.json<\/code><\/pre>\n<\/div>\n<\/div>\n<\/div>\n
\n
2.3. Draft 2020-12 \u30b9\u30ad\u30fc\u30de\u306e\u53d6\u5f97<\/h3>\n
\n
JSON Schema \u306e $schema<\/code> URI \u306b\u6307\u5b9a\u3055\u308c\u308b\uff1a
\nhttps:\/\/json-schema.org\/draft\/2020-12\/schema<\/a><\/p>\n<\/div>\n
\n
\u3053\u306e\u30e1\u30bf\u30b9\u30ad\u30fc\u30de\u306f curl \u3067\u53d6\u5f97\u6642\u306b\u30ea\u30c0\u30a4\u30ec\u30af\u30c8\u3055\u308c\u308b\u305f\u3081\u3001\u5fc5\u305a -L<\/code> \u30aa\u30d7\u30b7\u30e7\u30f3\u3092\u4f7f\u7528\u3057\u307e\u3059\u3002<\/p>\n<\/div>\n
\n
\n
$ curl -L -o schemas\/draft2020-12.json https:\/\/json-schema.org\/draft\/2020-12\/schema<\/code><\/pre>\n<\/div>\n<\/div>\n
\n
-L<\/code> \u3092\u7701\u7565\u3059\u308b\u3068 HTML \u304c\u4fdd\u5b58\u3055\u308c\u3066\u3057\u307e\u3044\u3001AJV \u304c \"Unknown format\"<\/code> \u3068\u3044\u3046\u30a8\u30e9\u30fc\u3067\u30b9\u30ad\u30fc\u30de\u3092\u51e6\u7406\u3067\u304d\u306a\u304f\u306a\u308a\u307e\u3059\u3002<\/p>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n
\n
3. \u691c\u8a3c\u30b9\u30af\u30ea\u30d7\u30c8 validate.js<\/h2>\n
\n
\n
\u4ee5\u4e0b\u306f validate.js<\/code> \u306e\u4e3b\u8981\u90e8\u5206\u3067\u3059\u3002<\/p>\n<\/div>\n
\n
\n
const Ajv2020 = require(\"ajv\/dist\/2020\");\r\nconst addFormats = require(\"ajv-formats\");\r\nconst fs = require(\"fs\/promises\");\r\n\r\nconst ajv = new Ajv2020({ loadSchema, strict: false });\r\naddFormats(ajv);<\/code><\/pre>\n<\/div>\n<\/div>\n
\n
3.1. $ref<\/code> \u3092\u89e3\u6c7a\u3059\u308b loadSchema \u95a2\u6570<\/h3>\n
\n
\n
async function loadSchema(uri) {\r\n  if (uri === \"http:\/\/json-schema.org\/draft\/2020-12\/schema\") {\r\n    return JSON.parse(await fs.readFile(\"schemas\/draft2020-12.json\", \"utf8\"));\r\n  }\r\n  if (uri.endsWith(\"metadata.json\")) {\r\n    return JSON.parse(await fs.readFile(\"schemas\/meta\/metadata.json\", \"utf8\"));\r\n  }\r\n  if (uri.includes(\"UNECE-BasicComponents\")) {\r\n    return JSON.parse(await fs.readFile(\"schemas\/UNECE-BasicComponents.json\", \"utf8\"));\r\n  }\r\n  if (uri.includes(\"UnitCode.json\")) {\r\n    return JSON.parse(await fs.readFile(\"schemas\/codelists\/UnitCode.json\", \"utf8\"));\r\n  }\r\n  throw new Error(\"Unresolved schema: \" + uri);\r\n}<\/code><\/pre>\n<\/div>\n<\/div>\n<\/div>\n
\n
3.2. \u30b9\u30ad\u30fc\u30de\u3068\u30a4\u30f3\u30b9\u30bf\u30f3\u30b9\u306e\u691c\u8a3c\u5b9f\u884c<\/h3>\n
\n
\n
const schema = await ajv.compileAsync(\r\n  JSON.parse(await fs.readFile(\"schemas\/xbrl-gl-cor-schema.json\"))\r\n);\r\nconst data = JSON.parse(await fs.readFile(\"samples\/xbrl-gl-instance.json\"));\r\n\r\nif (schema(data)) {\r\n  console.log(\"\u2705 Validation passed\");\r\n} else {\r\n  console.error(\"\u274c Validation errors:\", schema.errors);\r\n}<\/code><\/pre>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n
\n
4. metadata.json \u306e\u5f79\u5272\u3068\u6df7\u4e71<\/h2>\n
\n
\n
UN\/CEFACT \u30b9\u30ad\u30fc\u30de\u3067\u306f\u3001\"meta\/metadata\"<\/code> \u306e\u3088\u3046\u306b $ref<\/code> \u3092\u901a\u3058\u3066\u30e1\u30bf\u60c5\u5831\u3092\u53c2\u7167\u3057\u307e\u3059\u3002<\/p>\n<\/div>\n
\n
\u8aa4\u3063\u3066\u30d5\u30a1\u30a4\u30eb\u540d\u3092 metadata.json<\/code> \u3067\u306f\u306a\u304f meta-data.json<\/code> \u3068\u3057\u3066\u51e6\u7406\u3057\u3088\u3046\u3068\u3059\u308b\u3068\u3001loadSchema()<\/code> \u3067\u6b63\u3057\u304f\u8aad\u307f\u8fbc\u3081\u305a\u306b\u691c\u8a3c\u306b\u5931\u6557\u3057\u307e\u3059\u3002<\/p>\n<\/div>\n
\n
\n
\"unece:metadata\": {\r\n  \"$ref\": \"meta\/metadata\"\r\n}<\/code><\/pre>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n
\n
5. \u30c7\u30a3\u30ec\u30af\u30c8\u30ea\u69cb\u6210\u4f8b<\/h2>\n
\n
\n
\n
project-root\/\r\n\u251c\u2500\u2500 validate.js\r\n\u251c\u2500\u2500 schemas\/\r\n\u2502   \u251c\u2500\u2500 draft2020-12.json\r\n\u2502   \u251c\u2500\u2500 meta\/\r\n\u2502   \u2502   \u2514\u2500\u2500 metadata.json\r\n\u2502   \u251c\u2500\u2500 codelists\/\r\n\u2502   \u2502   \u2514\u2500\u2500 UnitCode.json\r\n\u2502   \u251c\u2500\u2500 UNECE-BasicComponents.json\r\n\u2502   \u2514\u2500\u2500 xbrl-gl-cor-schema.json\r\n\u2514\u2500\u2500 samples\/\r\n    \u2514\u2500\u2500 xbrl-gl-instance.json<\/code><\/pre>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n
\n
6. format \u691c\u8a3c\u306e\u6709\u52b9\u5316<\/h2>\n
\n
\n
\u4ee5\u4e0b\u306e\u3088\u3046\u306b format<\/code> \u30ad\u30fc\u30ef\u30fc\u30c9\u3092\u4f7f\u3046\u3068\u3001ajv-formats<\/code> \u306b\u3088\u308a\u81ea\u52d5\u7684\u306b\u691c\u8a3c\u3055\u308c\u307e\u3059\u3002<\/p>\n<\/div>\n
\n
\n
{\r\n  \"type\": \"string\",\r\n  \"format\": \"date-time\"\r\n}<\/code><\/pre>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n
\n
7. \u307e\u3068\u3081<\/h2>\n
\n
\n