迭代图层 (ModelBuilder)

使用情况

  • 此工具专用于 ModelBuilder ,而并不在编写 Python 脚本时使用。

  • 图层类型参数设置为表视图时,仅会对独立表进行迭代。 要使用要素或栅格表,请将图层类型参数分别设置为要素图层栅格图层

  • 对于每次迭代,该工具都会返回以下输出:

    • 输出图层 - 基于已设置的参数过滤器的地图中的图层。 此图层将包含已在图层上设置的一切选择或连接。
    • 名称 - 图层的名称。 该名称可用于行内变量替换
    • 输出图层类型 - 图层的类型。 该值与使用图层类型参数设置的图层类型相匹配。 输出值为常量且未本地化。 如果使用了两个或多个图层类型,则该类型可用于创建分支模型,如下所示:
      使用图层类型派生输出的示例
    • 工作空间或格式类型 - 图层的工作空间类型。 系统仅为要素图层、栅格图层和表视图返回此值。 输出值为常量且未本地化。 对于存储在基于文件夹的工作空间中的栅格图层,将返回文件格式(例如 TIFF)且此值可用于创建分支模型或作为用于评估所迭代图层类型的诊断使用。
      使用工作空间类型派生输出的示例

  • 该工具将返回与使用图层类型参数设置的类型以及使用可见性状态参数设置的过滤器相匹配的图层。 例如,如果图层类型参数设置为要素图层栅格图层可见性参数设置为不可见状态参数设置为有效,则该工具将返回不可见且有效的要素和栅格图层。

  • 如果未设置图层类型参数或没有图层与参数条件相匹配,则输出图层的值将设置为 OUTPUT_LAYER名称输出图层类型输出的值将设置为 FEATURE_LAYER,且工作空间或格式类型输出将设置为 WORKSPACE

  • 可将图层类型参数设置为多种类型,例如要素图层栅格图层表视图。 然而,该工具可能会连接到可能与某些图层类型不兼容的下游工具上,例如复制要素复制栅格复制行。 要在这种情况下支持多种图层类型,必须将图层类型参数设置为单个特定图层类型。 然后将输出连接到使用该特定数据类型的相应工具。 完成所有下游连接后,您即可将图层类型参数设置为全部三个图层类型。 此工作流是必要的,原因是该工具的起始默认值将设置为与将栅格作为输入的工具不兼容的要素图层类型。 一旦将所有图层类型都添加到模型中,验证就会使工具处于有效状态。

参数

标注说明数据类型
输入地图

带有要迭代的图层的输入地图。

Map
通配符
(可选)

* 与有助于限制结果的字符的组合。星号表示允许使用任意字符。如果未指定通配符,则将返回所有输入。例如,可使用通配符来限制对以某个字符或词语(例如 A*Ari*Land* 等)开头的输入名称进行迭代。

String
图层类型
(可选)

指定将用于过滤图层的图层类型。 如果未指定图层类型,则将迭代所有受支持的图层类型。 可以使用一种以上的图层类型来过滤图层。

  • 注记图层注记图层将被迭代。
  • 建筑图层建筑物图层将被迭代。
  • 构建场景图层建筑物场景图层将被迭代。
  • 尺寸图层尺寸图层将被迭代。
  • 要素图层要素图层将被迭代。
  • 地统计分析图层地统计图层将被迭代。
  • 分组图层图层组将被迭代。
  • 子类型图层组子类型图层组将被迭代。
  • KML 图层KML 图层将被迭代。
  • LAS 数据集图层LAS 数据集图层将被迭代。
  • 镶嵌图层镶嵌图层将被迭代。
  • 网络分析图层网络分析图层将被迭代。
  • 网络数据集图层网络数据集图层将被迭代。
  • 宗地图层宗地图层将被迭代。
  • 栅格图层栅格图层将被迭代。
  • 场景服务图层场景服务图层将被迭代。
  • 表视图表视图将被迭代。
  • Terrain 图层地形图层将被迭代。
  • TIN 图层TIN 图层将被迭代。
  • 拓扑图层拓扑图层将被迭代。
  • 追踪网络图层追踪网络图层将被迭代。
  • 公共设施网络图层公共设施网络图层将被迭代。
  • 体素图层体素图层将被迭代。
String
工作空间类型

指定将用于过滤图层的工作空间类型。 如果未指定工作空间类型,则将迭代受支持的工作空间类型的所有图层。

工作空间类型参数仅在图层类型参数设置为要素图层栅格图层表视图时启用。

  • 大数据连接大数据连接工作空间中的图层将被迭代。
  • BIM 文件BIM 文件工作空间中的图层将被迭代。
  • CADCAD 工作空间中的图层将被迭代。
  • 分隔文本文件分隔文本文件工作空间中的图层将被迭代。
  • 企业级地理数据库企业级地理数据库工作空间中的图层将被迭代。
  • 要素服务要素服务工作空间中的图层将被迭代。
  • 文件地理数据库文件地理数据库工作空间中的图层将被迭代。
  • 内存中数据库内存中数据库工作空间中的图层将被迭代。
  • Microsoft ExcelMicrosoft Excel 工作空间中的图层将被迭代。
  • NetCDFNetCDF 工作空间中的图层将被迭代。
  • OLE DBOLE DB 工作空间中的图层将被迭代。
  • 栅格栅格工作空间中的图层将被迭代。
  • Shapefileshapefile 工作空间中的图层将被迭代。
  • SQLiteSQLite 工作空间中的图层将被迭代。
  • SQL 查询图层SQL 查询图层工作空间中的图层将被迭代。
  • 流服务流服务工作空间中的图层将被迭代。
  • Web 要素服务web 要素服务工作空间中的图层将被迭代。
String
要素类型
(可选)

指定将用于过滤图层的要素类型。 如果未指定要素类型,则将迭代所有受支持的要素类型。

  • 注记注记要素类将被迭代。
  • 尺寸尺寸要素类将被迭代。
  • 简单边简单边要素类将被迭代。
  • 复杂边复杂边要素类将被迭代。
  • 简单交汇点简单交汇点要素类将被迭代。
  • 复杂交汇点复杂交汇点要素类将被迭代。
  • 线线要素类将被迭代。
  • 点要素类将被迭代。
  • 面要素类将被迭代。
  • 多面体多面体要素类将被迭代。
String
栅格类型
(可选)

工作空间类型参数设置为栅格时将用于过滤栅格图层的栅格格式类型。 如果未指定栅格类型,则将迭代受支持的栅格类型的所有图层。

String
可见性
(可选)

指定是否将使用图层可见性来过滤图层。

  • 全部图层可见性将不会用于过滤图层。
  • 可见可见图层将被迭代。
  • 不可见不可见图层将被迭代。
String
State
(可选)

指定将用于过滤图层的图层状态。 如果该参数设置为无效,则将返回源路径图层损坏的图层。

  • 全部图层状态将不会用于过滤图层。
  • 有效有效的图层将被迭代。
  • 无效无效的图层将被迭代。
String
递归
(可选)

指定迭代器是否将迭代嵌套图层组。

  • 选中 - 嵌套图层组将被迭代。
  • 未选中 - 嵌套图层组将不会被迭代。
Boolean

派生输出

标注说明数据类型
输出图层

基于已设置的参数过滤器的地图中的图层。 此图层将包含已在图层上设置的一切选择或连接。

Any Value
名称

图层的名称。

String
输出图层类型

图层的类型。

String
工作空间或格式类型

图层的工作空间类型。

String

环境

此工具不使用任何地理处理环境。

许可信息

  • Basic: 是
  • Standard: 是
  • Advanced: 是