发布模型

发布模型会创建一个托管工具项目，该工具项目可以作为自定义 web 工具运行。

发布模型需要遵循以下步骤：

1. 创建模型。
2. 为需要在 web 工具中进行配置的输入添加变量。
3. 将这些变量设置为模型参数。
4. 管理参数以自定义其在自定义 Web 工具中的显示方式。
5. 运行并保存模型。
6. 发布模型。

许可要求

要发布模型，需要获得使用 ModelBuilder 的许可和配置，以及发布 Web 工具权限。

将变量设置为模型参数

当模型发布并作为自定义 web 工具打开时，设置为模型参数的变量将显示为工具参数，以便您指定不同于创建模型时指定的数据或值。

输出托管数据变量将自动设置为模型参数，而输入数据和值变量必须手动设置为参数。 输出中间数据变量无法设置为模型参数。

要将输入数据和值变量设置为模型参数，请完成以下步骤：

1. 要创建或打开模型和连接到分析会话，请完成以下步骤。
2. 如有必要，添加数据、工具和变量。
3. 单击变量元素以将其选中。

   元素工具栏随即出现在所选变量上方。

4. 单击添加或移除参数 。

   该变量上随即显示参数图标 ，指示其已设置为模型参数。

在将必要的变量设置为模型参数后，可随时管理 Web 工具参数。

管理 Web 工具参数

管理 Web 工具参数窗口用于重新排序和更新自定义 web 工具中的参数设置。

要管理 web 工具参数，请完成以下步骤：

1. 完成创建或者打开相应模型的步骤，该模型包含数据、工具、变量和模型参数。
2. 如果尚未连接到分析会话，请连接。
3. 在操作工具栏上，单击管理 Web 工具参数 。

   管理 Web 工具参数窗口随即出现。 模型中的参数将按其添加顺序列出。 每个参数都具有名称和别名。 别名链接到参数标注设置。

   注：

   无法在管理 Web 工具参数窗口中添加或移除参数。 有关添加和移除参数的信息，请参阅将变量设置为模型参数。

4. 要显示参数的设置，请单击展开 。
5. 根据需要更新以下设置：
   • 参数标注 - 工具参数的简短标注。 此文本将作为参数名称在自定义 web 工具的工具窗格中显示。 标注应该为参数用途的简短描述，并使用通俗易懂的语言编写。
   • 弹出帮助文本 - 工具参数的简短说明。 在自定义 web 工具的工具窗格中，当单击参数旁的帮助按钮 时，将显示此文本。 根据需要，包含对参数功能的描述、不同值对工具结果的影响、受支持的输入以及默认值。
   • 必需 - 指示验证和运行工具是否需要此参数。 如果将模型参数连接至一个或多个必需工具参数，则将启用此值并且无法对其进行编辑。 如果所有已连接工具参数均为可选项，则可以打开模型参数以将参数设置为必需参数，或者关闭模型参数以将参数设置为可选参数。 将参数设置为必需项将强制用户在运行 web 工具之前提供输入。
   • 数据类型 - 指示与参数兼容的输入。 此值基于变量数据类型，无法对其进行更改。
   • 过滤器 - 确定可为参数指定的输入值或数据的限制或约束。 这些选项取决于数据类型，如下所示：
     • 双精度 - 最小值和最大值。
     • 要素图层 - 允许的要素类型列表，其中包括多点、点、线和面。
     • 整型 - 最小值和最大值。
     • 字符串 - 唯一值列表。
     如果在模型图中的变量与工具之间创建了新连接，则模型参数的过滤器将被重置。 更改模型连接后，应检查和更新过滤器。
   • 包含默认值 - 指示工具参数是否具有默认值。 如果打开，则参数将基于变量值使用默认值。 如果关闭，则参数将默认为空。 默认值可用于引导用户输入或者简化 web 工具，因为用户无需手动更新参数。 此设置应该用于具有可接受值菜单的参数，例如单位，以及预期经常使用相同输入值，而无需进行更新的参数。 默认值不适用于大多数文本、数值或要素图层输入。
   • 默认值 - 指示工具参数的默认值。 要更改默认值，请更新模型逻辑示意图中变量的值。 默认值应该是在大多数情况下都能提供准确或理想结果的值。 此设置仅在启用包含默认值后可用。
6. 要隐藏参数设置，请单击折叠 。
7. 针对其余每个参数重复前 3 个步骤。

   如有必要，您也可以更改参数顺序。

8. 单击参数名称旁的重新定位 ，然后将参数拖动至其他位置。

   或者，单击重新定位，然后从菜单中选择一个选项。 根据参数的位置，该选项将包括上移、下移、移至顶部和移至底部。

9. 单击保存。

将保存 web 工具参数设置并关闭管理 web 工具参数窗口。 现在，您可以随时发布模型。

发布模型

发布模型会创建一个工具项目，可以将其作为自定义 web 工具进行共享和运行。

要发布模型，请完成以下步骤：

1. 完成创建或者打开相应模型的步骤，该模型包含数据、工具、变量和参数。
2. 如果尚未连接到分析会话，请连接。
3. 运行模型。

   运行该模型有助于确保 web 工具将成功运行。

   在发布模型之前，您应该预览 web 工具以确保已设置正确的 Web 工具参数。

4. 保存模型。

   已发布 Web 工具将基于已保存分析模型项目。 必须先运行并保存模型，然后才能将其发布。 如果对模型进行了任何更改，则必须再次运行并保存模型。

5. 在模型工具栏上，单击预览 web 工具 。

   随即在分析窗格中显示 web 工具的预览。 如果需要对 web 工具进行更改，请返回到工作流以设置并管理参数。 再次单击预览 Web 工具更新预览。

   当预览显示 web 工具中所需的所有参数和配置后，即可发布模型。

6. 在模型工具栏上，单击发布 。

   发布为 web 工具窗口随即出现。 如果不满足发布要求，请检查其余要求，关闭发布为 web 工具窗口，并完成要求，然后再返回此工作流。

   了解有关发布要求的详细信息

7. 为新项目执行以下操作：
   • 提供标题。
   • 在我的内容中选择要用于保存项目的文件夹。
   • 提供用于描述该项目的标签和摘要。
8. 单击发布。

   将发布模型并创建工具项目。

9. 单击打开 Web 工具项目打开工具项目的详细信息或关闭发布为 Web 工具窗口。

可以从工具窗格通过单击打开自定义 web 工具打开自定义 web 工具。 还可以从详细信息页面将工具项目与组织或群组共享。

注：

无法与公众共享工具项目。

发布要求

必须满足以下所有要求才能将分析模型发布为 Web 工具。

发布用户权限

您的用户账户必须满足许可要求才能将分析模型发布为 Web 工具。 如果您的账户不满足许可要求，则发布按钮将不可用。

要更新用户账户权限，请联系组织管理员。

模型支持 web 工具发布

对于每个分析模型项目，只能发布一个 Web 工具。 因此，如果已经发布了分析模型以创建 web 工具，则将无法满足模型支持 web 工具发布要求。

您还必须具有分析模型的编辑权限才能将其发布，这意味着您必须是模型所有者或托管分析模型的组织的管理员。

可以通过删除已发布的现有工具项目或创建模型副本来满足此发布要求。 如果删除某个现有的工具项目，且组织中已启用回收站，则还必须将该工具项目从回收站中移除，才能满足此要求。

要创建已发布或已与您共享的模型的副本，请完成以下步骤：

1. 在模型工具栏中，单击另存为。
2. 为新项目执行以下操作：
   • 提供标题。
   • 在我的内容中选择要用于保存项目的文件夹。
   • 提供用于描述该项目的标签和摘要。
3. 单击保存。

   新分析模型随即创建并在仅查看模式下打开。 您现在可以激活模型并根据需要进行更改，然后发布模型以创建 Web 工具。

创建托管输出

分析模型必须创建托管要素图层或表图层输出，然后才能发布为 Web 工具。 默认情况下，添加到模型的所有工具将创建中间输出，而不是托管输出。

要满足此要求，确保一个工具的结果图层参数设置为创建托管图层或覆盖现有图层。 托管输出将设置为模型参数，并在运行模型或 Web 工具后添加到 Web 地图。 应为要作为分析结果进行可视化的输出（例如模型中最后一个工具的输出）创建托管图层。 要获取最佳结果，仅在模型中为一个工具创建托管输出。

了解有关模型输出的详细信息

管理 Web 工具参数

必须在管理 web 工具参数窗口中解决 web 工具参数中的错误。

如果默认值与过滤范围不兼容（例如，过滤值为 1 到 10 之间的数字，而默认值为 11），则将显示消息默认值在过滤范围外。 模型参数的默认值基于变量参数，而过滤值则在管理 web 工具参数窗口中设置。 要解决错误，在管理 Web 工具参数窗口中更新过滤器值，或更改变量值以更新默认参数值。

运行模型

整个模型必须成功运行，然后才能将其发布为 Web 工具，以确保 Web 工具正常运行。 如果在成功运行后对模型进行了其他更改，则必须在启用发布之前重新运行该工具。

保存模型更改

模型运行成功后必须保存。 已发布 Web 工具基于已保存分析模型项目。 如果模型中存在未保存更改，则不会启用发布。