|
参数名称
|
说明
|
基本类型
|
|---|---|---|
|
networkName
|
筛选所基于的网络名称。查询将仅返回从该网络的事物中查找到的结果。
|
STRING
|
|
networkParentNode
|
通过 networkName 指定的网络中顶部节点的名称。查询将返回网络中指定父节点的所有子项。
|
STRING
|
|
networkMaxDepth
|
要在其中查找父节点子项的级别。1 返回直接子项，2 返回子项的子项。如果将其设置为 0 或默认/空，则它将返回子项的完整层次结构。
|
INTEGER
|
|
offset
|
按指定值偏移结果。例如，如果数据库中有 200 个结果，偏移量为 5，则会返回结果 5 至 200 (总计 195 个结果)。
可将 offset 与 maxItems 搭配使用以模拟分页。对大量结果的查询深入，查询时间可能会更慢。
例如，若存在事物 1 至 1000 且 maxItems 为 5，则每个页面将显示 5 个结果。
• 第 1 页：offset 为 0。由于 maxItems 为 5，因此会返回前 5 个结果。
• 第 2 页：offset 为 5。返回第 6 至第 10 个结果。
• 第 3 页：offset 为 10。返回第 11 至第 15 个结果。
• 以此类推。
在此示例中，返回的结果数量较小，因此查询时间很快。
|
NUMBER
|
|
basicPropertyNames
|
用于列出基本属性的名称。
|
INFOTABLE
|
|
withPermissions
|
布尔型参数 (true 或 false)，用于指定是否应考虑权限。如果为 true，则服务将在执行操作之前检查权限。
|
BOOLEAN
|
|
nameMask
|
用于指定：模式或掩码以筛选名称。
|
STRING
|
|
propertyNames
|
用于列出：要检索或处理的属性的名称。
|
INFOTABLE
|
|
query
|
用于定义：用来筛选结果的查询参数。
|
QUERY
|
|
networkName
|
用于指定：网络的名称。
|
STRING
|
|
maxItems
|
指示所需的最大项数，类似于分页中的页面大小。适用于控制单一结果页面中返回的项数。
|
NUMBER
|
|
tags
|
要筛选的数据标记。
|
TAGS
|
// result: INFOTABLE dataShape: "RootEntityList"
let result = ThingTemplates["GenericThing"].QueryImplementingThingsOptimized({
networkParentNode: undefined /* STRING */,
networkMaxDepth: undefined /* INTEGER {"defaultValue":0} */,
maxItems: undefined /* NUMBER {"defaultValue":500} */,
basicPropertyNames: undefined /* INFOTABLE {"dataShape":"EntityList"} */,
withPermissions: undefined /* BOOLEAN {"defaultValue":false} */,
offset: undefined /* NUMBER {"defaultValue":0} */,
nameMask: undefined /* STRING */,
propertyNames: undefined /* INFOTABLE {"dataShape":"EntityList"} */,
query: undefined /* QUERY */,
networkName: undefined /* STRING */,
tags: undefined /* TAGS */
});