allowing for extra properties in edi file declaration (#207)

Adding `_comment` property to EDI schema to annotate segments and/or elements.

Author: jose-sherpa

extensions/omniv21/samples/edi/1_canadapost_edi_214.schema.json

@@ -12,6 +12,7 @@
                 "child_segments": [
                     {
                         "name": "GS",
+                        "_comment": "functional group",
                         "child_segments": [
                             {
                                 "name": "scanInfo", "type": "segment_group", "min": 0, "max": -1, "is_target": true,
@@ -26,7 +27,7 @@
                                     {
                                         "name": "N4",
                                         "elements": [
-                                            { "name": "cityName", "index": 1 },
+                                            { "name": "cityName", "index": 1, "_comment": "E19" },
                                             { "name": "provinceCode", "index": 2 },
                                             { "name": "postalCode", "index": 3 },
                                             { "name": "countryCode", "index": 4 }

extensions/omniv21/samples/edi/2_ups_edi_210.schema.json

@@ -14,6 +14,7 @@
                 "child_segments": [
                     {
                         "name": "GS",
+                        "_comment": "functional group",
                         "child_segments": [
                             {
                                 "name": "invoiceInfo", "type": "segment_group", "min": 0, "max": -1, "is_target": true,
@@ -74,7 +75,7 @@
                                                 "elements": [
                                                     { "name": "refIdQualifier_N901", "index": 1 },
                                                     { "name": "refId_N902", "index": 2, "default": "" },
-                                                    { "name": "date", "index": 4, "default": "" },
+                                                    { "name": "date", "index": 4, "default": "", "_comment": "YYYYMMDD"},
                                                     { "name": "product_code_C04004", "index": 7, "component_index": 4, "default": "" }
                                                 ]
                                             },

extensions/omniv21/validation/ediFileDeclaration.go

@@ -42,7 +42,8 @@
                             "index": { "type": "integer", "minimum": 1 },
                             "component_index": { "type": "integer", "minimum": 1 },
                             "empty_if_missing": { "type": "boolean","$comment": "deprecated, use 'default'" },
-                            "default": { "type": "string" }
+                            "default": { "type": "string" },
+                            "_comment": { "$ref": "#/definitions/value_comment" }
                         },
                         "required": [ "name", "index" ],
                         "additionalProperties": false
@@ -53,10 +54,12 @@
                     "items": {
                       "$ref": "#/definitions/segment_declaration_type"
                     }
-                }
+                },
+                "_comment": { "$ref": "#/definitions/value_comment" }
             },
             "required": [ "name" ],
             "additionalProperties": false
-        }
+        },
+        "value_comment": { "type": "string" }
     }
 }