什么是层次结构查询？
层次结构查询将存储库搜索结果组织为多个层级，而不是以扁平列表形式呈现。这使您能够查看模型内容的排列方式，以及匹配元素与其周围项目和图表之间的关系。
一个查询最多可涵盖四个层级：
- 项目：包含模型内容的存储库项目。
- 图表：包含匹配元素的图表。
- 元素：符合指定条件的模型元素。
- 子元素：包含在元素内或与元素关联的更详细组件。
您可以从较高层级开始，随着深入逐步细化查询。您也可以跳过中间层级，直接在最与分析相关的层级开始。
为何要使用层次结构查询？
大型存储库通常包含许多项目、图表和模型元素。传统搜索可能识别出匹配项，但提供的上下文信息有限，无法说明这些项的位置或它们如何融入整体模型结构。
层次结构查询可帮助您：
- 跨多个项目和图表定位模型元素。
- 理解搜索结果周围的上下文。
- 按元素类型和属性筛选结果。
- 追踪图表、元素和子元素之间的关系。
- 更高效地探索架构结构和依赖关系。
- 生成机器可读的结果以便进一步处理。
- 保存并复用查询以实现可重复的分析。
在处理企业架构模型、ArchiMate 存储库、大型系统设计及其他复杂建模环境时，此方法尤为有用。
如何打开层次结构查询
- 登录您的 Visual Paradigm 存储库。
- 点击省略号按钮。
- 选择QueryBase.
- 选择您要访问的工作区。
- 进入企业仪表板。
- 点击工具位于右上角。
- 选择按层次结构查询.
按层次结构查询工具打开时，界面右侧会显示一个查询构建窗格。您可以在该窗格中定义查询的层级、条件和标准。
如何构建层次结构查询
构建层次结构查询时，首先确定您要查找的内容以及所需的上下文范围。您可以从项目、图表、元素或子元素开始，然后在相应层级添加条件。
1. 选择起始层级
选择搜索应开始的层级。若需检查整个存储库中的结果，从项目层级开始较为合适；若已明确需要查找的模型内容类型，从元素层级开始则更为高效。
2. 添加搜索条件
定义标准，例如元素类型、名称或属性值。随着查询在层次结构中推进，可逐步细化条件，从而将广泛的存储库内容缩小为特定的一组结果。
3. 细化层次结构
当需要更多上下文时，在更深层级添加条件。例如，您可以搜索特定类型的元素，然后查看这些元素出现的项目和图表。
4. 跳过不必要的层级
您无需使用层次结构中的所有层级。如果不需要项目或图表信息，可以跳过这些层级，直接查询对分析至关重要的元素或子元素。
示例：查找 ArchiMate 节点元素
假设您想查找名称中包含单词服务器的 ArchiMate 节点元素。您可以配置查询以搜索：
- ArchiMate 节点元素类型。
- 名称条件中包含单词“服务器”。
运行查询后，QueryBase 将以 JSON 格式返回匹配的数据。结果将标识满足条件的 ArchiMate 节点元素，并显示它们在存储库中的位置。
在大型存储库中，结果可能显示匹配的节点元素分布在多个项目和图表中。这提供了有用的上下文信息，而仅凭匹配名称的简单列表可能无法体现这一点。
以层次结构图形式查看结果
执行查询后，选择图按钮，以分层结构显示匹配结果。该图展示了结果如何在项目、图表、元素和子元素之间组织。
分层图可帮助您：
- 查看哪些项目包含匹配的元素。
- 识别与这些元素关联的图表。
- 了解模型内容的位置和上下文。
- 追踪架构结构和依赖关系。
- 在浏览复杂存储库时不丢失更广泛的上下文。
当您找到相关图表时，点击其图表链接可直接打开。这使您能够从存储库级别的分析过渡到对底层模型的可视化检查。
将查询结果导出为 JSON
查询结果可以 JSON 格式导出，以便进行额外处理或与其他工具集成。当您需要操作返回的数据、以编程方式分析数据，或将其纳入更广泛的报告工作流时，JSON 非常有用。
导出的结果可能支持以下任务：
- 创建自定义报告。
- 执行额外的数据分析。
- 将模型信息集成到外部应用程序中。
- 比较不同查询或项目之间的结果。
- 自动化存储库分析工作流。
保存并复用查询配置
分层查询可以保存以供将来使用。点击导出查询按钮，将查询配置保存为 JSON 文件。
保存查询配置可让您：
- 稍后重复相同的分析。
- 在不同项目中复用查询。
- 在团队中标准化存储库搜索。
- 与其他建模人员和分析师共享查询逻辑。
- 为重复性调查保持一致的标准。
要复用现有查询，请将其之前保存的 JSON 文件导入 QueryBase。这避免了手动重新构建查询，并有助于使模型分析更加一致和可重复。
分层查询的最佳实践
- 从明确的目标开始：确定您是寻找特定元素、检查项目覆盖范围，还是追踪关系。
- 使用精确的条件：组合元素类型、名称和属性，以减少不相关的结果。
- 选择合适的起始层级：在项目或图表层级开始以进行广泛发现，或在元素层级开始以进行针对性搜索。
- 使用图视图以获取上下文：当需要理解存储库结构时，从 JSON 结果切换到层级图。
- 打开相关图表：检查原始图表以验证匹配元素的意义和上下文。
- 保存可重复使用的查询：当可能需要再次进行相同分析时，导出查询配置。
- 将结果数据与查询逻辑分开：导出结果用于分析，并导出查询配置以供重用。
常见问题
Visual Paradigm 中的“按层级查询”是什么？
“按层级查询”是 QueryBase 的一项功能，可在多个层级（包括项目、图表、元素和子元素）上搜索存储库模型。它以 JSON 和层级图格式呈现结果。
层级查询最多可包含多少个层级？
层级查询最多可跨越四个层级：项目、图表、元素和子元素。
创建查询时我可以跳过某些层级吗？
可以。您可以跳过中间层级，或直接从与搜索最相关的层级开始。
QueryBase 能否搜索特定的模型元素类型？
可以。您可以基于模型元素类型、名称和其他可用属性定义条件。例如，您可以搜索名称包含特定单词的 ArchiMate 节点元素。
层级查询结果如何显示？
查询结果以 JSON 格式返回，也可以显示为层级图。该图展示了匹配元素在项目及图表中的组织方式。
我可以打开包含匹配元素的图表吗？
可以。在结果中选择图表链接，即可打开相关图表，并在建模上下文中检查匹配元素。
我可以保存层级查询以便以后使用吗？
可以。使用“导出查询”功能将查询配置保存为 JSON 文件。稍后您可以导入该文件以重用相同的查询。
总结
Visual Paradigm QueryBase 的层次化查询功能提供了一种实用的方式来探索复杂的模型存储库。通过按项目、图表、元素和子元素组织搜索，它不仅揭示哪些项目符合您的条件，还显示这些项目在更广泛的模型结构中的归属位置。
凭借 JSON 结果、层次化图可视化、直接图表导航以及可重用的查询配置，基于层次的查询功能支持高效的存储库发现、架构分析、依赖关系追踪以及可重复的模型调查。
了解更多关于 QueryBase 的信息，请访问 https://www.visual-paradigm.com/features/querybase/.
