Skip to main content

Message tool 消息工具

单个工具示例

“消息”提供一个“单个工具示例”。转至 示例工作流 以了解如何在 Alteryx Designer 中访问此示例和其他更多示例。

使用“消息”向 “结果”窗口 报告有关特定进程的消息。

何时发送消息

选择将消息写入并发送到“结果”窗口的时间。使用此选项可通过“消息”工具捕获行计数或在输出完成后生成消息。

  • 在第一个条记录之前

    1. “消息”工具将第一条记录接收到输入连接。

    2. “消息”工具写入消息。

    3. “消息”工具将记录传递到输出连接。

  • 在表达式为True的行输出之前 :无论表达式是 True 还是 False,都会传递所有记录。

    1. “消息”工具将记录接收到输入连接。

    2. “消息”工具评估给定的表达式,表达式可能取决于该记录中的字段。

      • 如果表达式评估为 True,则“消息”工具会在将记录传递到输出连接之前写入消息。如需了解详情,请参阅 表达式编辑器

      • 如果表达式的计算结果为 False,则“消息”工具不会写入消息。

  • 最后一条记录后

    1. “消息”工具将所有记录传递到输出连接。

    2. “消息”工具写入消息。

  • 在所有下游工具完成之后

    警告

    This option is not supported via the AMP engine. Although you can still select it via AMP, the tool functions as if it's configured to output After Last Record.

    1. 所有下游工具都已完成处理所传递的记录。

    2. “消息”工具写入消息。

设置消息类型

消息类型 :选择工具写入的消息类型。如需了解详情,请参阅 结果 窗口。

  • 消息 :标准 Alteryx 消息。消息显示为标准黑色文本。

    RegEx(9):12 条记录已成功解析,0 条记录未成功解析。

  • 警告 :Alteryx 警告消息。警告以金色文本显示。

    正则表达式 (22):“22 Purple Haze”一值包含太多部分,无法容纳到输出字段数。

  • 字段转换错误 :Alteryx 字段转换错误。转换错误显示为橙色文本。

    公式 (13):代码:"12 Alteryx Blue"被截断。

  • 错误 :Alteryx 错误消息。错误以红色粗体文本显示:

    附加字段 (9): 源必须具有有效连接

  • 错误 - 停止通过此工具传递记录 :Alteryx 错误消息。一旦“消息”工具输出此类型的消息,工作流将不再向“消息”工具的输出连接传递记录。在标准错误消息之后,将显示第二条错误消息,指示工作流已被取消。两个错误均以红色粗体文本显示:

    浏览(13): 缺少传入连接。

    浏览 (13): 工作流已由属性设置取消。

  • 文件输入(路径|说明) :标准 Alteryx 消息,引用含有自定义说明的输入文件。路径名是必需的。不含说明的文件输入会输出一个可点击的空白字段。文件输入显示为标准超链接。格式为 "文件路径|文件说明" 。例如, "C:\Desktop\Input.csv|测试输入文件示例" 将生成此消息:

    消息(15):测试输入文件示例

  • 文件输出(路径|说明) :标准 Alteryx 消息,引用含有自定义说明的输出文件。路径名是必需的。不含说明的文件输入会输出一个可点击的空白字段。文件输入显示为标准超链接。格式为 "文件路径|文件说明" 。例如, "C:\Desktop\Output.csv|示例测试输出文件" 将生成以下消息:

    消息 (15):示例测试输出文件

设置消息优先级

消息优先级 :确定工具在宏指令内部使用时的行为。

  • 普通 :只有在以下情况下才写入消息...

    • “消息”工具包含在正在运行的工作流中。

    • 显示所有宏指令消息 已选中。如果消息工具位于正在运行的工作流中包含的宏指令内部,则不会写入消息。

  • :仅当工具包含在正在运行的工作流中 或者 工作流中的宏指令内部时,才会写入消息。因此,如果它在宏指令中的深度达到 1 级,它就会输出。

  • :无论包含多少级别的宏指令,都始终写入消息。转换错误和错误消息类型始终为高优先级。

临时 :选中时,消息将替换由同一工具发出的现有消息。这对于报告工具进度的消息非常有用,例如报告已处理的行数。

消息表达式

输入要显示的消息。此消息可以是固定文本或从数据字段构建。

示例

"年龄:" + [AgeField] + "超出了允许的范围。"

由于这个工具包含表达式编辑器,在应用或宏工作流中使用此工具时会出现一个额外的输入锚点。使用 “界面”工具 连接到“问题”锚点。

[_RecordNumber_] 变量

  • 在第一条记录之前 :[_RecordNumber_] 始终等于 1。

  • 在表达式为 True 的行输出之前 :[_RecordNumber_] 等于正在计算的表达式的行号。

  • 在最后一条记录之后以及在所有下游工具完成运行之后 :[_RecordNumber_] 等于通过该工具的记录总数。例如:

“文本转换到列工具生成的记录数量:" + TOSTRING([_RecordNumber_])