GetFieldsOnLayout
将布局上的字段列表作为 JSON 数据返回。
格式
GetFieldsOnLayout( 布局名称 )
参数
布局名称
- 表示布局名称的文本表达式。如果“布局名称”
是空字符串(“”),则使用当前布局。
返回的数据类型
文本
原始版本
22.0
说明
此函数返回 JSON 对象,其中包含有关指定布局上可访问的字段的信息。
符合以下任何条件的字段被排除在外:
-
字段对象在布局区域之外(请参阅在布局上放置和删除字段)。
-
满足“在以下情况下隐藏对象”条件并且选择了“在查找模式下应用”(请参阅隐藏或显示布局对象)。
-
对于“字段输入”,“查找模式”未选择(请参阅允许或防止向字段输入数据)。
-
“包含快速查找的字段”未选中(请参阅配置快速查找)。
-
当前账户的权限集没有读取访问权限(请参阅编辑记录访问权限)。
-
该字段是摘要、全局或容器字段(请参阅定义合计字段、定义全局字段(具有全局存储的字段)和关于容器字段)。
返回的 JSON 对象具有以下结构:
{
"layout_name": "LayoutName",
"字段": {
"TableOccurrence::FieldName1": {
"类型": "字符串",
"描述": "字段注释 (可选)"
},
"TableOccurrence::FieldName2": {
"类型": "数字"
}
}
}
-
layout_name
键包含布局的名称。 -
字段
对象包含每个可访问字段的键值对。 -
每个字段的键是其完全限定的名称(例如,TableOccurrence::FieldName)。
-
每个字段的值都是带有
类型
键的对象(如果字段的数据类型是数字,则为数字
;否则为字符串
)。 -
如果该字段在“管理数据库”对话框中有注释,则包含一个可选的
描述
键。如果表格中的任何字段注释以[LLM]
开头,则仅显示以[LLM]
开头的注释。[LLM]
前缀从描述
值中删除。
注释
-
该函数使用相同的标准来确定哪些字段可以通过查找访问,以及像通过自然语言执行查找脚本步骤执行查找一样返回哪些字段信息。
示例 1
返回 JSON 对象,描述产品布局上查找的字段。
JSONFormatElements ( GetFieldsOnLayout ( "产品" ) )
如果“产品”布局包含以下字段:
字段名 | 注释 |
---|---|
创建日期 |
[LLM] 产品的创建日期 |
价格 |
[LLM] 产品价格以美元为单位 |
产品 ID |
[LLM] 唯一标识产品的主密钥 |
产品名称 |
[LLM] 产品描述性名称 |
状态 |
库存中的产品状态。库存状态包括:有现货、已订购 |
g_UserFavorites |
包含当前用户最喜欢的产品的全局字段 |
该函数返回:
{
"字段" :
{
"产品::创建日期" :
{
"描述" : "产品的创建日期",
"类型" : "字符串"
},
"产品::价格" :
{
"描述" : "以美元表示的产品价格",
"类型" : "数字"
},
"产品::产品ID" :
{
"描述" : "唯一识别产品的主密钥",
"类型" : "数字"
},
"产品::产品名称" :
{
"描述" : "产品的描述性名称",
"类型" : "字符串"
},
"产品::状态" :
{
"类型" : "字符串"
}
},
"layout_name" : "产品"
}
请注意,由于至少有一个字段注释以 [LLM]
标签开头,因此只有带有 [LLM]
标签的字段包含描述。g_UserFavorites 字段完全省略了,因为它是一个全局字段,无法查找。
示例 2
返回当前布局上所有字段的列表和当前布局上可查找的所有字段的列表。这可能会指出您不知道无法查找的字段。
Let (
[
layoutFields = FieldNames ( Get ( 文件名 ) ; Get ( 布局名称 ) ) ;
findFields = JSONListKeys ( GetFieldsOnLayout ( Get ( 布局名称 ) ) ; "字段" ) ;
sortedLayoutFields = SortValues ( layoutFields ; 1 ) ;
sortedFindFields = SortValues ( findFields ; 1 ) ;
$$result = "当前布局上的所有字段:" & ¶ & sortedLayoutFields & ¶ &
"其中,可查找的字段为:" & ¶ & sortedFindFields
] ;
$$result
)
可能的输出存储在产品布局的 $$result 中:
当前布局上的所有字段:
创建日期
照片
价格
产品 ID
产品名称
状态
其中,可查找的字段为:
产品::创建日期
产品::价格
产品::产品ID
产品::产品名称
产品::状态