添加和配置“添加附件”

“添加附件”步骤用于将文件附件添加至作业或将文件与作业相关联。 运行步骤时，作业磁贴中将显示以下按钮，具体取决于步骤的配置：

• 作业磁贴中显示浏览按钮，该按钮用于将可接受的文件类型附加至作业。 如果为步骤配置了可接受文件类型列表，只能将允许的文件类型附加到作业。
• 作业磁贴中显示链接按钮，该按钮用于将 URL、文件路径或文本关联至作业。 对于 URL 附件，仅支持 HTTP 和 HTTPS URL 格式。

如果为步骤配置了步骤帮助，则其会显示在作业底部。

在 Workflow Manager Web 应用程序中上传文件或将其与作业相关联后，可执行以下操作：

• 在名称文本框中更新文件的名称。
• 单击操作按钮查看附件，下载附件或复制附件的文件路径或文档 ID。 单击 URL 附件将打开 URL 重定向对话框，其中包含继续访问 URL 或取消的选项。 要清除 URL 重定向对话框，请选中不再显示此警告复选框。
• 单击删除附件 以删除附件。

注：

要在 Workflow Manager Web 应用程序的详细信息面板中显示作业附件，单击附件选项卡 。

了解有关管理作业附件的详细信息

在 ArcGIS Pro 中上传文件或将其与作业相关联后，可执行以下操作：

• 在名称文本框中更新文件的名称。
• 单击操作按钮显示附件，在计算机默认应用程序中打开附件或复制附件文本或文档 ID。
• 单击删除附件 以删除附件。

运行该步骤时，可以执行以下操作：

• 可通过单击暂停暂停步骤。

  注：

  如果暂停了步骤，则已添加的所有附件仍附加至作业，但是其名称无法更新。

• 可通过单击继续来继续执行步骤。

注：

如果步骤不是可选步骤，则步骤必须先运行或暂停至少一次，然后才能完成。

配置步骤

执行以下操作来配置该步骤：

1. 创建或编辑工作流示意图，以访问步骤库面板。
2. 将添加附件从步骤库面板拖至工作流画布上步骤的连接箭头。

   了解有关向工作流示意图添加步骤的详细信息

   步骤详细信息面板随即出现。

3. 在步骤名称文本框中提供步骤的名称。
4. 或者，在用户提示文本框中添加您希望在该步骤运行时显示的消息。

   如果用户提示包含纯文本和 Arcade 表达式，请将文本格式设置如下：

   'This job is currently assigned to ' + JobOwner($Job) + '.'

   提示：

   单击此输入支持 Arcade 表达式 ，然后选择 ArcGIS Arcade 表达式以将其添加至其关联文本框。

5. 可以选择在文件夹名称文本框中提供将存储附件的文件夹的名称。

   文件夹名称不能包含文件系统路径或特殊字符。 如果未提供文件夹名称，将自动创建名为 General 的文件夹。

   注：

   文件夹包含在工作流项目中，并且不是文件系统路径。

6. （可选）允许文件附加至作业。
   1. 在附件类型部分中，选中已嵌入复选框。

      注：

      每个嵌入附件的最大文件大小由要素图层决定。

   2. 在将输入限制为以下文件类型文本框中，提供可附加文件类型的文件扩展名的逗号分隔列表。

      警告：

      如果未指定文件扩展名列表，则可附加到作业的文件类型取决于您的 ArcGIS 组织配置。

      了解有关 ArcGIS Online 中支持的文件类型的详细信息

7. （可选）允许文件与作业相关联。
   1. 在附件类型部分中，选中已链接复选框。
   2. 选择其中一个链接文件选项：
      • URL - 将 URL 与作业相关联。
      • 文件路径 - 将文件路径与作业相关联。
      • 文本 - 将文件或文件夹路径或文档 ID 与作业相关联。
8. 单击选项选项卡。
9. 根据需要配置步骤选项。
   • 手动 - 手动运行步骤。
     • 可选 - 允许完成步骤而无需运行。
   • 自动 - 步骤被激活后立即执行。
   • 按计划运行 - 根据您设置的计划运行步骤。

     了解有关计划工具的详细信息

10. （可选）选择以下选项之一配置步骤中的帮助：
    • 无 - 配置不含步骤帮助的步骤。
    • 文本 - 在文本文本框中配置步骤的帮助文本。

      可以使用 ArcGIS Arcade 表达式为步骤帮助提供动态值。 如果步骤帮助包含纯文本和 Arcade 表达式，则必须将文本格式设置如下：

      
      'For further assistance, please contact' + JobCreator($Job) + '.'

    • URL - 在 URL 文本框中为步骤配置指向帮助资源的链接。

      注：

      仅支持 HTTP 和 HTTPS URL 格式。

      还可以使用 Arcade 表达式提供动态值。 如果 URL 包含纯文本和 Arcade 表达式，则必须将文本格式设置如下：

      
      'https://pro.arcgis.com/en/pro-app/latest/tool-reference/' + JobExtendedProperty($Job, 'tools', 'toolbox') + '/' + jobExtendedProperty($job, 'tools', 'alias') + '.htm'

      配置自动编码 Arcade 结果复选框：

      • 如果 Arcade 表达式返回了在转换为 URL 时必须进行转义的特殊字符（例如空格或正斜线），请确保已选中自动编码 Arcade 结果复选框。
      • 如果使用 Arcade 表达式构建基础 URL，则请取消选中自动编码 Arcade 结果复选框。

11. 或者，单击样式选项卡以更改步骤的形状和颜色。
12. 或者，单击关于选项卡并在步骤描述文本框中提供该步骤的描述。

    提示：

    关于选项卡还包含步骤 ID，可与动态作业属性配合使用以获取步骤的输出。 单击复制步骤 ID 将步骤 ID 复制到剪贴板。

返回值

当该步骤完成时，将存储返回值以指示该步骤的结果。 可以使用路径立即评估返回值，以确定工作流中的后续步骤。 您还可以使用 ArcGIS Arcade 表达式在整个工作流中检索已完成步骤的返回值。 下表列出了该步骤的返回值：

返回值	描述
S000001	该步骤成功完成。
F000001	该步骤未能成功完成。

输出值

该步骤完成后，其输出值将被存储，可用于确定工作流所遵循的路径，或者可用作整个工作流中其他步骤的输入。 下表列出了该步骤的输出值：

输出	描述
<Attachment ID>	返回添加到步骤的附件 ID 数组