添加全局定义
主窗口中的定义概览网格(参见下方截图)显示了Schema的全局定义列表。这些全局定义是:(i) 主Document Schema定义、(ii) 全局JSON类型的定义(或较新版本中的\$defs),例如对象、数组、字符串等JSON Schema类型;(iii) 外部或自定义的JSON类型的定义;当前仅存储在名为resourceDefinitions容器中的定义可用;这是Microsoft的Azure资源管理器针对JSON定义使用的容器。通过网格工具栏(参见下方截图)中的追加定义部分或插入定义部分可以将新的resourceDefinitions部分添加到Schema文档。
如果一个JSON类型需要在同一个Schema或另一个Schema中重复使用,全局定义该类型是非常有用的。例如,您可以在一个JSON Schema中为美国电话号码定义一个JSON字符串类型,然后不仅在同一个Schema中,而且还在其他JSON Schema中引用这一定义。
添加定义和相关操作
以下操作可用于在定义概览网格中添加和编辑定义。
•添加定义:单击定义概览网格(参见上方截图)左上方的追加已命名的Schema定义或插入已命名的Schema定义图标。这将在您追加或插入的位置的网格中创建一个具有默认名称的新的空定义。新定义也在“概览”输入助手中被列为Def(参见上方截图)。
•更改定义的类型:每个新定义在创建时都使用Any类型。您可以在“详细信息”输入助手中更改其类型(参见下方截图,其中类型为“字符串”)或通过在设计视图中编辑定义。
•重命名定义:为此,请双击其名称,然后进行编辑。或者,在“详细信息”输入助手中编辑名称字段。
•输入对定义的描述:在“详细信息”输入助手中编辑描述字段。在定义概览网格中,描述位于定义名称旁边(参见下方截图)。您还可以双击定义概览网格中的描述字段以编辑描述。
•引用定义:有关详细信息,请参见“概览”输入助手和全局和局部定义部分。
•编辑定义:单击定义概览网格中定义的图标,或双击“概览”输入助手中的定义。这将在设计视图中打开定义,可以在其中进行编辑。