模型参数

任何模型变量都可以设置为模型参数。 下面是将模型变量设置为参数的两个主要原因：

• 模型作为地理处理工具运行时，设置为模型参数的变量将显示为工具参数，从而允许您为模型指定要处理的数据或值，而不是处理创建模型时指定的内容。

  

• 当模型作为地理处理工具运行时，设置为模型参数并引用数据集的输出变量将添加到地图中。 此外，如果将派生输出变量设置为模型参数，并且该变量引用由工具更新的数据集或工作空间，则当模型工具运行完成时，该数据集或工作空间将自动刷新以使更新可见。

设置模型参数

要将模型变量设置为模型参数，必须在 模型构建器 中编辑该模型。 在 模型构建器 中，右键单击变量，然后选择参数。 当变量设置为参数时，模型中变量的旁边将显示字母 P。

使用变量名称作为模型参数标注。 可通过对 模型构建器 中的模型变量进行重命名来重命名模型参数。 右键单击变量，选择重命名，然后提供新名称。 如果您在地理处理窗格中打开模型工具，参数名称将反映新名称。 变量值将用作相应模型参数的默认值。 如果变量在 模型构建器 中没有值，则模型参数将为空。

要让模型工具输出在历史记录窗格中显示，将输出设置为模型参数。 例如，如果工具输出 .html 文件，将输出参数设置为模型参数，以从历史记录窗格打开该文件。

模型参数属性

您可使用模型属性窗口更改模型参数的一些属性。 当在地理处理窗格中打开模型工具时，这些属性将影响参数的显示方式。

右键单击工具箱中的模型工具，然后选择属性，或者如果您正在 模型构建器 中编辑模型，在 ModelBuilder 选项卡上单击属性按钮。

顺序

通过在工具属性窗口的参数选项卡中将参数拖动到新顺序来更改参数的顺序。

类型

此属性用于指定模型参数的类型，如下所示：

• 必需 - 该参数必须具有要运行的工具的值。
• 可选 - 不需要为参数提供值。
• 派生 - 在以下情况下使用派生参数：
  • 输出与输入相同。 例如，计算字段工具可更新输入表中字段的值， 但不会创建表或修改输入的方案。
  • 用于修改输入方案的工具。 例如，添加字段工具将向输入表中添加字段。
  • 该工具输出标量值，例如数字、字符串或布尔值。 例如，获取计数工具返回派生的整型值。
  • 该工具根据其他参数中的值创建输出。 例如，创建要素类工具返回从具有路径和名称值的其他参数构建的派生要素类路径。
  • 此工具将在已知位置创建数据。 例如，在您的脚本中，将在已知工作空间中创建要素类。 要素类和工作空间都不是参数选项。

根据模型中参数的使用方式，自动指定必填、可选和派生的名称。 例如，如果将变量用作模型中工具所需参数的输入，则将需要该模型参数。 可将模型参数从可选的模型参数更改为模型工具的必选模型参数，但是不能将必选参数更改为可选参数。

要将可选参数更改为必选参数，请在工具属性窗口的参数选项卡中将类型选项设置为必选。

方向

此属性定义参数是工具的输入还是工具的输出。

如果参数类型为派生，则参数方向将自动设置为输出。

所有脚本工具都应具有输出参数，以便能够在 模型构建器 中使用。 模型构建器 的基本理念是将工具的输出连接到其他工具的输入，如果脚本工具没有输出参数，则其不适用于 模型构建器。 输出可能是为参数值提供的数据集、在脚本中确定位置或名称的派生输出，也可能是经过计算或确定的派生值。 您至少可以输出一个布尔值，如果工具成功完成，返回 true，否则返回 false。

描述

此属性用于设置参数的描述，当您将鼠标悬停在参数标注旁边的信息按钮 上时，该描述将在工具对话框上显示。

或者，在模型元数据中提供参数帮助。 右键单击工具箱中的模型，然后选择编辑元数据。 在语法部分中添加模型工具参数的信息。

了解有关自定义工具的详细信息

类别

可以将参数指定给类别。 当在地理处理窗格中打开工具时，已分类的参数将显示在一个下拉区域中。

过滤器

使用参数过滤器可限制可为模型工具参数指定的输入值或数据。 例如，值列表过滤器要求只能为参数指定列表中的值。 将与过滤器不匹配的值输入到参数中会导致错误，并且必须输入有效值才能运行模型。

可用过滤器如下所示：

• 值列表 - 预定义关键字列表。 可以为字符串和数值模型参数设置值列表过滤器。
• 范围 - 最小和最大数值。 包括范围边界值，这表示最小值和最大值也是有效数据。
• 要素类 - 允许的要素形状类型列表，包括点、多点、折线、多边形和多面体。
• 文件 - 有效文件扩展名列表，例如 .txt 或 .gpx。

  注：

  请勿在扩展名中包括句点。 例如，输入 txt，而不要输入 .txt。 带分号 (;) 的单独列表值。 例如，要同时允许 .txt 和 .csv 文件，请输入 txt; csv。

• 字段 - 允许的字段类型列表，包括短型、长型、单精度、双精度、文本、日期、OID、几何、BLOB、栅格、GUID、全局 ID 和 XML。
• 工作空间 - 允许的工作空间类型，包括文件系统、本地地理数据库和企业级地理数据库。

依赖关系

您可以使某一参数依赖于另一参数。 其典型的用途是将接受属性字段的参数转换为依赖于另一个要素类参数或表参数；字段参数将包括依存参数属性字段的下拉列表。

符号系统

可将图层文件与定义的符号系统一同保存，并将该图层文件用作模板，以便将模型输出添加到地图时对其进行符号化。 可通过以下方式实现此目的：

• 在工具属性窗口的参数选项卡中，将输出参数的符号系统选项设置为图层文件路径，例如 C:\Data\LandUseOverlay\Symbolized.lyrx。
• 将应用图层的符号系统工具添加到模型的末尾，然后将符号系统图层参数设置为图层文件路径。