数据函数“运行成功”不等于结果可信。最常见的问题来自输入映射错了、输出落在错误位置、刷新触发过多，或脚本按预期运行但业务字段选错。
先把参数分成三类
- 输入：函数使用的列、值、数据表或文档属性。
- 输出：返回到 Spotfire 的列、值、数据表或其他结果。
- 触发条件：何时因输入变化自动重新运行，以及是否需要单独会话。
配置时的基本原则
所有必需输入和输出都应有明确映射。参数名称应使用业务语言，例如“检测日期”“目标阈值”“预测分数”，不要只保留脚本变量名。每项输入都要写清楚粒度：是一行、整列、汇总值还是整个数据表。
自动刷新为什么需要谨慎？
自动刷新可让函数在输入变化后更新，但也可能在筛选、属性变化或数据刷新时重复触发。先在小数据集观察触发次数和耗时，再决定是否启用。对于依赖服务器 R、TERR 或 Python 服务的函数，官方还提供单独会话等选项；是否可用取决于部署的计算服务。
结果异常的排查顺序
- 在函数运行前记录输入行数、时间范围和关键统计值。
- 核对输入列的数据类型、空值和单位。
- 确认输出是否写回预期数据表或属性。
- 比较一次手动运行与一次自动刷新后的结果。
- 保留失败输入样本，避免只用“正常数据”验证脚本。
结论
参数配置是数据函数与业务数据之间的合同。输入、输出、触发和验证规则越清楚，算法越容易被他人复用和审查。
Spotfire 报告交付与高级计算教程
官方参考
本文计划于 2026 年 10 月 9 日 发布；涉及软件版本、许可、服务器配置和数据权限时，请以当前产品文档与实际部署环境为准。