添加和配置“发送电子邮件”

“发送电子邮件”步骤用于在运行步骤时向一个或多个收件人发送电子邮件通知。 此步骤类型可用于在完成步骤或作业时或步骤未成功完成时通知用户。

在使用“发送电子邮件”步骤发送电子邮件通知之前：

• 您必须为 ArcGIS Workflow Manager 配置电子邮件置。
• 您可能需要修改自定义角色以使用 ArcGIS Arcade 表达式检索组织成员的电子邮件地址。

步骤配置

要配置步骤，请执行以下操作：

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

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

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

3. 在步骤名称文本框中提供步骤的名称。
4. 根据需要在收件人、抄送和密件抄送文本框中键入以分号分隔的电子邮件地址，或者使用 ArcGIS Arcade 表达式以创建动态收件人的列表。

   一个电子邮件地址	[e-mail]
   多个电子邮件地址	[e-mail];[e-mail];[e-mail];[e-mail]
   一个 Arcade 表达式	"GetUser($CurrentPortal, JobOwner($Job))['Email']"
   多个 Arcade 表达式	"GetUser($CurrentPortal, JobOwner($Job))['Email']";"GetUser($CurrentPortal)['Email']";"GetUser($CurrentPortal, LastRunner($Job, 'f50d740d-cc04-9296-4ce3-181e82604465'))['Email']"
   电子邮件地址和 Arcade 表达式	[e-mail];"GetUser($CurrentPortal, JobOwner($Job))['Email']";[e-mail];"GetUser($CurrentPortal)['Email']"

   注：

   必须在收件人、抄送或密件抄送文本框中至少提供一个有效的电子邮件地址或 Arcade 表达式。

   提示：

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

5. 在主题文本框中，输入电子邮件通知的主题。

   还可以使用 ArcGIS Arcade 表达式为主题提供动态值。 如果主题包含纯文本和 Arcade 表达式，则需要按如下所示格式化文本：

   JobName($Job) + ' is ready'

6. 在正文文本框中，输入电子邮件通知的消息文本。

   还可以使用 ArcGIS Arcade 表达式为正文提供动态值。 如果正文包含纯文本和 Arcade 表达式，则需要按如下所示格式化文本：

   '<b>' + JobName($Job) + '</b>, created by <b>' + JobCreator($Job) + '</b>, was started on <b>' + Text(Date(JobStartDate($Job)), 'dddd, MMMM D, Y') + '</b>.'

   注：

   您必须启用 HTML 通知选项才能在正文文本框中使用 HTML 标签。

7. 或者，如果您的作业包含附件，则可以使用包含附件下的以下选项将作业附件包含在电子邮件通知中：
   • 无 - 电子邮件通知中不包含作业附件。
   • 全部 - 电子邮件通知中包含所有作业附件文件夹。
   • 按文件夹 - 在按文件夹文本框中键入以逗号分隔的作业附件文件夹名称列表，以指定要包含在电子邮件通知中的作业附件文件夹。

     注：

     作业附件文件夹包含在工作流项目中，而非文件系统路径。

   注：

   如果作业包含多个附件，则其将作为单个 .zip 文件发送，并保留附件文件夹结构。

8. 或者，单击预览以预览电子邮件。

   注：

   如果电子邮件包含特定于作业的 Arcade 表达式，您必须在预览电子邮件文本框中提供有效的作业 ID，然后才能预览 Arcade 表达式。 如果电子邮件包含步骤输出值的 Arcade 表达式，则必须先完成该步骤，然后才能预览输出值。

9. 单击选项选项卡。
10. 根据需要配置步骤选项。
    • 手动 - 手动运行步骤。
      • 可选 - 允许完成步骤而无需运行。
    • 自动 - 步骤被激活后立即执行。

      注：

      如果您的工作流示意图配置为自动运行一系列步骤，其中包括“评估数据质量”或“运行 GP 服务”步骤，则在启动步骤序列的用户令牌到期后，尝试自动运行的步骤将失败。 您必须拥有 ArcGIS Workflow Manager Server Advanced 角色的许可才能继续运行其他自动化步骤，而无需手动干预。

    • 按计划运行 - 根据您设置的计划运行步骤。

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

11. 或者，在步骤帮助文本框中提供该步骤的帮助文本。

    还可以使用 ArcGIS Arcade 表达式为步骤帮助提供动态值。 如果步骤帮助包含纯文本和 Arcade 表达式，则需要按如下所示格式化文本：

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

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

    提示：

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

返回值

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

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