创建查询

创建或打开查询时,它会显示在相应命名的选项卡上。

查询向导用于定义查询的参数和条件。向导内容按“源”、“样式”、“筛选器”和“列”选项卡组织,用于指导输入。尽管为了按一定顺序收集输入内容而对向导选项卡进行了排序,但是您可在任何选项卡之间导航。

要创建查询:

  1. 在主页上,选择查询
  2. 单击 “新建查询”工具栏按钮
  3. 可选:创建查询的替代参数,以便在运行时将用户定义的值传递到查询筛选器中。
    1. 单击 “添加参数”按钮
    2. 单击添加并添加键-值对。

      注:

      键-值对不能按顺序使用 "<%" 或 "%>",也不能使用等于号。

    3. 单击确定
  4. 选项卡中,为查询选择版本或版本变量。

    可以选择标准、基线或截止版本。“版本”列表的默认设置为标准版本。要选择基线或截止版本,请单击“版本”列表下的标准

  5. 执行一项操作:
    • 对于全局查询,请转至下一步。

    • 对于本地查询,请单击 省略号按钮,选择层次和顶级节点,然后单击确定

      注:

      要更改层次/顶级节点组合,请单击清除,然后针对本地查询重复这些步骤。

  6. 样式中选择查询结果的显示方式:
    • 列表 - 以动态列表的形式返回符合条件的节点。

    • 标记节点 - 在层次树中标记符合条件的节点。

    • 两者 - 符合条件的节点不仅以动态列表的形式返回,还在层次中进行标记。

    注:

    对于全局查询,仅能以列表形式返回结果。

  7. 可选:如果选择了“标记节点”或“两者”,则选择“展开到标记的节点”以自动打开和展开具有标记节点的层次。

    注:

    此选项仅适用于本地查询。

  8. 筛选器中单击添加以插入条件行。
  9. 选择属性和运算符,为标准行输入值或替代参数,然后按 Enter 以保存行。

    注:

    替代参数格式为 <%ParamKey%>,其中 <% 和 %> 是记录运行时替代变量的标识符,ParamKey 是要用于替代的参数的名称;例如 <%AccountType%>。可以包含括号来对条件进行分组和定义是否为属性包括继承的值。有关运算符说明,请参阅“运算符说明”。

    提示:

    单击 “编辑”按钮 可修改行。单击 “删除”按钮 可删除行。单击箭头以移动行。

  10. 包含选项中选择要包括在查询结果中的节点:
    • 仅限匹配 - 仅返回符合条件的节点

    • 匹配和祖先 - 返回符合条件的所有节点及其祖先

    • 匹配和后代 - 返回符合条件的所有节点及其后代

  11. 可选:如果在第 9 步中选择了匹配和祖先匹配和后代,则默认情况下选择包含选项并在结果中包含符合条件的节点。
  12. 可选:如果在第 9 步中选择了匹配和祖先,则可以选择包含查询顶级节点的祖先以包含顶级节点之上的祖先节点。

    包含查询顶级节点的祖先选项仅在为查询指定的顶级节点未包含所有祖先时才包含其他祖先(“匹配和祖先”选项)。因此,此选项对于后代没有影响(“匹配和后代”选项)。

  13. 选择选项卡,然后选择一个类别。
  14. 选择要在查询结果中显示为列的属性并将其从可用移至已选中

    注:

    Name 属性始终显示在查询结果中,不管选择显示哪些属性。

    列选择只是运行时参数,不会与查询一起保存。

    提示:

    使用箭头可在“已选中”列表中定位列。列表中的第一项是第一列,列表中的第二项是第二列,依次类推。

  15. 可选:选择包含标准属性以自动在查询结果中包含筛选条件中引用的属性。
  16. 执行以下任意操作:
    • 单击 “保存”按钮 保存查询。

      系统将提示您为此查询定义名称、说明和对象访问组。选择一个自定义对象访问组或以下项之一:

      • 用户 - 仅供单个用户查看和运行的个人对象。

      • 标准 - 公共对象,适用于所有用户进行查看和运行。只有数据管理员用户才能创建和修改标准查询。

      • 系统 - 仅供应用程序管理员角色的用户查看和运行的受限对象。

    • 单击 “运行”按钮 运行查询。