本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 常见的安装问题
## 引用完整性错误：“product\_id 值与产品数据集中的任何 ID 都不匹配”
最常见的原因是 ID 字段中的尾随空格。从固定宽度的数据库导出的源系统通常用空格填充字符串字段。主产品可能有干净的 ID（“MAT604”），而订单行文件有填充的 ID（“MAT604”）。系统会进行严格的字符串匹配，因此这些字符串不会加入。
**修复：**将 TRIM () 添加到数据流 SQL 转换中的所有字符串 ID 字段。将其应用于 product\_ID、ship\_from\_site\_id、customer\_tpartner\_id 和任何其他加入密钥。还要检查文件之间是否存在引用不一致之处。重新导出 CSV 时，请使用 QUOTE\_ALL 来防止出现类型推断问题，即看起来像数字的 ID（例如 “111613”）在一个文件中被视为整数，在另一个文件中被视为字符串。
**预防：**即使你今天看不到问题，也要始终修剪 SQL 转换中的所有 ID 字段，这是默认做法。在两次导出之间，源数据可能会发生变化。
## 基础产品中缺少订单历史记录中的商品
您的订单历史记录通常会包含不在当前主产品中的产品（停产产品、一次性商品、测试 SKU）。如果任何 product\_id 没有匹配的产品主记录，则系统将拒绝整个订单文件。
**修复：**(a) 在基本产品中为缺失的产品创建存根行，其中包含最少的必填字段（ID、描述、base\_uom），或者 (b) 筛选订单历史记录以仅包含基本产品中存在的产品。选项 (a) 是首选，因为它保留了可能对谱系和趋势检测有用的需求历史记录。
## 上传主产品时出现 CSV 解析错误
包含逗号、引号或特殊字符的产品描述可能会中断 CSV 解析。您可能会在特定行上看到诸如 “预期 17 个字段，已看到 19” 之类的错误。
**修复：**带有正确引号 Re-export 的文件 (QUOTE\_ALL)。检查描述字段中是否有嵌入逗号的特定失败行。
## 上传后数据未显示
+ 确认您的文件格式没有更改（扩展名、列标题、编码）。
+ 检查文件名和扩展名是否符合预期模式 — 将.csv 重命名为.csv000 或类似名称会中断摄取。
+ 上传后，允许最多 30 分钟完成数据摄取。
+ 如果列标题在两次加载之间发生变化（例如，由命名的列 month/year），则需要在上传之前进行预处理步骤。
## 数据刷新后 PIV 未更新
+ PIV 会在摄取完成大约 15 分钟后触发，运行时间约为 20-30 分钟。
+ End-to-end 从数据上传到新的 PIV：大约 1-1.5 小时。
+ 如果 PIV 在 24 小时以上未更新，请联系支持人员。
## 异常计数似乎太高或太低
+ **太高：**阈值可能过于宽松，或者单个产品\+网站可能会在不同的日期生成多个例外。请联系支持人员查看规则配置。
+ **太低：**阈值可能过于严格，或者某些商品可能缺少所需的数据（例如预测、库存水平）。
Spot-check 您熟悉的几款产品，并将系统显示的内容与您的源系统进行比较。
## 例外情况未显示财务影响
财务影响要求在产品数据中填写单位成本。如果产品缺少成本或为零，则不会显示任何美元价值。请咨询您的支持团队了解成本数据覆盖范围——跨多个成本字段的瀑布式方法通常可以提供最佳覆盖范围。