库存预测所采用的输入文件格式

首页 » 资源 » 此处


为了提供库存预测，Lokad 需要导入格式化为纯文本文件或 Excel 表的表格数据。这些表格应遵循 Lokad 的相关原则。文件应存储在 Lokad 帐户中。实际上，Lokad 支持多种第三方应用，由 Lokad 自动生成的数据文件直接从应用本身提取数据。但是，如果没有提供这样的内置支持，必须手动生成 Lokad 所要使用的文件。本文详细介绍了库存预测所采用的格式。

概述       示例文件    文件命名规则       平面文件遮罩    Lokad_Items 的字段       标签字段       标记字段    Lokad_Orders 的字段    Lokad_Parts 的字段    Lokad_Settings 的字段    重命名列    处理大型文件       压缩       分割    建议使用 TSV 格式       数字和日期

概述

为了生成报告，Lokad 要求至少提供两个表格文件：

• Lokad_Items 包含所要处理的 SKU/条码/基准项目/产品的列表。
• Lokad_Orders 包含销售/订单/消耗列表，也即观测到的历史需求。
  

这两个文件应包含表格数据：第一行包含列标题，后续行包含实际数据。Lokad 支持大部分纯文本格式，例如 CSV（逗号分隔值）、TSV（制表符分隔值）乃至 Microsoft Excel 表——前提是 Excel 工作簿遵循简单的制表形式。Lokad 支持加载具有以下扩展名的文件：.tsv .csv .xlsx .xls .txt。此外还支持各种日期或数字格式。

另外也可以提供可选文件 Lokad_Parts，其中可以包含套件/捆绑包/物料清单/部件列表。另外一个可选文件是 Lokad_Settings，其中可以包含库存设置覆盖。

在下文中，我们将详细介绍项目和订单表的列名。大部分商业管理软件可以生成平面文件导出。但是，这些导出不太可能遵循 Lokad 的列命名模式。例如，订单数量在 Lokad 中命名为 Quantity，但在您的系统中可能就是 Qty。为了解决这一问题，可以使用 Envision 脚本对平面文件进行预处理，然后再执行所有必要的调整。

示例文件

下载示例文件

示例文件 Lokad_Items.tsv 的内容可能类似于：

Id	LabelName	ServiceLevel	LeadTime	StockOnHand	StockOnOrder	
1	Candy Canes 200g	0.95	3	181	80
2	Orange Stick Candy 100g	0.95	3	400	200
3	Lemon Saf-T-Pops 200g	0.95	3	222	200
4	Caramel Squares 500g	0.95	3	121	50
5	Orange Sweethearts 100g	0.9	7	1498	680

您可以如下文所述，在此文件中添加更多标签和标记列。

示例文件 Lokad_Orders.tsv 的内容可能类似于：

Id	Date	Quantity
1	2013-07-01	174
1	2013-07-02	96
1	2013-07-03	271
1	2013-07-04	335
1	2013-07-06	72

文件命名规则

Lokad 会根据与文件名相关的一组规则，来加载指定输入文件夹（从项目配置页面可以进行调整）中的文件。具体而言，Lokad 会尝试加载文件名以 Lokad_Items、Lokad_Orders、Lokad_Parts 或 Lokad_Settings 开头的任何文件。然后，文件扩展名必须为支持的扩展名（.tsv、.csv、.txt、.xlsx 或 .xls）之一。另外，如果文件进行了 GZip 处理，那么文件扩展名也可以包含 .gz。

平面文件遮罩

当文件由 Sync 等文件导入工具生成时，可能会存在需要覆盖特定文件内容的情形。手动编辑此工具生成的平面文件可能不太实际，因为文件下次刷新数据时可能会再次生成该文件，因而会覆盖最初对此文件进行的更改。因此，Lokad 提供了一种叫做文件遮罩的功能，这项功能精确提供了一种持续覆盖文件导入工具输出的途径。

基本文件名是指不带扩展名后缀的文件名（例如 Lokad_Items.tsv 的基本文件名是 Lokad_Items）。任何时候只要检测到的两个文件只有基本文件名不同，如果其中一个文件恰好为 Excel 文件，那么 Lokad 仅加载该 Excel 文件，另一个文件则予以忽略。该 Excel 表会遮罩其相应的平面文件。

Lokad_Items 的字段

文件 Lokad_Items 包含所要预测的项目的列表。具体来说，如果要预测 3 个商店，每个商店有 1000 个基准项目，那么此文件应包含 3x1000=3000 行。

Lokad_Items
Id	字符串	必填	项目标识符（需求历史记录将根据此标识符聚合）。每行应有一个唯一标识符。
LabelFoo	字符串	可选	要在 Excel 报告中显示的属性。参见下文的标签字段。
TagFoo	字符串	可选	产品属性，预测引擎可使用此属性来改进预测准确度。参见下文的标记字段。
TagLabelFoo	字符串	可选	可同时作为标签和标记的属性。
StockOnHand	数值	可选	实际拥有的项目计数。如果 StockOnHand 或 StockAvailable 均未提供，则不能计算优化的再订货数量。尽管存在 StockAvailable 时此字段大多被忽略（参见下文），但在实际上，仍有必要包含此字段，因为此数量是唯一能根据在售的"实际"库存数量进行核对的数量。
StockAvailable	数值	可选	做好供应准备的项目的计数。与 StockOnHand 不同，此数量考虑了已售出但尚未拣货的单位，因此这些项目不可再用于供应。如果 StockOnHand 或 StockAvailable 均未提供，则无法计算优化的再订货数量。
StockOnOrder	数值	可选	已进行再订货但尚未供货的项目的计数。
LeadTime	整数	可选	库存需要覆盖的天数。另请参阅交付周期指南。如果不提供此值，则无法计算分位数预测和分位数网格。
LeadTime2	整数	可选	仅适用于计算分位数网格。用于表示备选的交付周期（具有备选的分位数网格）。如果存在此字段，Lokad_Grid 输出文件中会增加一个叫做 Probability2 的字段。
LeadTime3	整数	可选	与 LeadTime2 相同。同上，但输出中会包含 Probability3 字段。
ServiceLevel	数值	可选	不发生缺货的预期概率。此值应介于 0 和 1 之间（包括 1）。另请参阅服务水平指南。进行分位数预测时必须提供此值，但进行分位数网格时无此要求，后一种情况类似于同时对所有可能的服务水平执行分位数预测。
LotMultiplier	整数	可选	该字段用于反映再订货时对批次大小的潜在约束。只有在进行分位数预测时方需使用该字段。它指示了要应用于 Lokad 所建议的订货数量的四舍五入的倍数。如忽略此字段，则其默认值为 1。示例：如果 LotMultiplier=10，Lokad 会建议只按照 10 的倍数进行再订货，例如 10、20、30 等等。

标签字段

任何以标记 Label 作为前缀的字段将在 Lokad 生成的 Excel 报告中作为额外的列插入。举个例子，如果 TSV 文件中包含一个叫做 LabelProductName 的字段，表明报告中有一列的名称 ProductName（名称中去除了 Label 前缀）。

这种约定便于添加任意的额外字段组来用于报告用途。这些字段通常包括但不限于：供应商、品牌、ISBN 等。这些字段仅用于显示，并不影响预测操作本身。

标记字段

任何以标记 Tag 为前缀的字段，其作用都是帮助 Lokad 改进预测准确度。标记的常见示例有系列、子系列、颜色、尺寸、品牌等等。标记字段值可以为空：不必为每个项目都提供标记值。

Lokad_Orders 的字段

文件 Lokad_Orders 包含过去消耗库存的所有客户订单的列表。为获得最高准确度，建议提供每日聚合的历史记录（非每周或每月）。如果有相应的数据，建议的历史记录的深度为 3 至 5 年。

Lokad_Orders
Id	字符串	必填	匹配 Lokad_Items 文件的 Id 字段（外键）。
Date	日期时间	必填	与订单数量相关的日期。
Quantity	数值	必填	所订购项目的数量。

Lokad_Parts 的字段

有时，库存输入（收到的商品）的粒度与库存输出（供应的商品）的粒度并不完全匹配。当存在套件、捆绑包、组装部件时，或者是根据物料清单生产商品时，便会发生此类情况。

举个例子，在销售套件时，Lokad_Orders 中没有记录相应的行。但是，由于库存优化是在套件级别进行，而不是在部件级别进行，因此 Lokad_Orders 中的套件行必须替换为多个构成该套件的部件的行。

Lokad_Parts 文件为可选文件。

Lokad_Parts
Bundle	字符串	必填	从库存优化角度要替换为部件的目标项目。匹配 Lokad_Items 文件的 Id 字段（外键）。
Part	字符串	必填	捆绑包的部件之一。匹配 Lokad_Items 文件的 Id 字段（外键）。
Quantity	数值	可选	捆绑包中包含的部件数目。如果此字段被忽略，则其值为 1。

Lokad 不支持递归捆绑包，即捆绑包的捆绑包情形。请注意，如果发现循环依赖性，Lokad 将无法导入数据。

Lokad_Settings 的字段

文件 Lokad_Settings 主要用于 Lokad 本身通过内置的某种整合应用生成 Lokad_Items 文件的情形。在这种情形下，文件 Lokad_Settings 可以用于覆盖和/或完成通过 Sync 获取的数据。实际上，如果您从一开始就对生成 Lokad_Items 的逻辑进行了控制，那么很少需要使用该文件。但是，为保证完整性，我们还是会在下面介绍 Lokad_Settings。

Lokad_Settings 文件为可选文件。

Lokad_Settings
Id	字符串	必填	将覆盖其库存设置的目标项目。匹配 Lokad_Items 文件的 Id 字段（外键）。
ServiceLevel	数值	可选	介于 0 和 1（包括在内）之间的一个浮点数，用于表示不发生缺货的预期概率。如果此字段留空，将保留初始项目值。
LeadTime	整数	可选	用于表示持续时间的天数（整数），适用于计算需求预测。如果此字段留空，将保留初始项目值。
LotMultiplier	整数	可选	用于表示再订货数量的相应倍数（整数）。如果此字段留空，将保留初始项目值。

重命名列

标题必须与上述列名相匹配。不匹配任何列名的标题会被忽略。如果文件包含正确的标题但这些标题具有不同的名称，可以让 Lokad 重命名。要执行此操作，需要构建 Envision 脚本。

处理大型文件

在处理大型文件时，可以压缩此类文件，和/或将其分割成多个文件。这一点适用于 Lokad_Items 和 Lokad_Orders。

压缩

为节约磁盘空间和提高传输速度，可以有选择地将文件逐一压缩成存档。在这种情况下：

• 每个存档只能包含 1 个文件。
• 必须采用 Deflate 压缩（例如使用 GZIP 工具）。
• 存档名称应以 .gz 结尾（例如：Lokad_Orders.tsv.gz）。
  

分割

对于超大型文件（压缩后仍超过 100MB），我们还建议将其分割成多个更小的独立文件。这些分割文件既可以进行增量数据上载，也更易于在上载和下载时进行并行处理。推送到 Lokad 的平面文件名来自于 4 个不同部分，以 Lokad_Orders_20150131.tsv 为例：

1. Lokad：前缀部分，用于指示文件遵循 Lokad 格式原则。
2. Orders：中间部分，用于指示数据类型，支持的数据类型有 Items、Orders 和 Parts。
3. 20150131：可选的任意后缀，用于指示文件分割用途。
4. tsv：平面文件格式扩展名，支持 tsv 和 csv。
   

Lokad 将结合所有仅后缀不同的文件；也即 Lokad 会将所有这些文件视为一个文件进行合并。当然，为了让结合顺利进行，所有文件应具有相同的标题。在上例中，我们使用了紧凑型日期来作为后缀，但也可以将任何字母数字字符串作为后缀。

此外也可以结合对压缩文件进行分割的文件。举个例子，Lokad_Orders_20150129.tsv.gz、Lokad_Orders_20150130.tsv.gz、Lokad_Orders_20150131.tsv.gz 等一系列文件可以表示对订单数据进行每日递增压缩。

建议使用 TSV 格式

Lokad 支持各种各样的表格格式，例如 TSV、CS 乃至 Microsoft Excel，前提是这些数据要严格遵循表格格式。Lokad 的设计决定了能够支持各种日期和数字格式，因此在这些方面您大可放心。不过，如果您是软件开发人员，那么我们建议您遵循下面的原则。的确，Lokad 可能会成功解析各种格式，但如果您遵循这些原则，那么肯定能成功解析。

Lokad 建议的格式为 TSV（制表符分隔值）。尽管 TSV 格式比较老旧，但对于处理大型数据集的效果出奇的好。TSV 格式的定义如下：

• 其中包含 UTF8 编码的行的文本文件。
• 每行包含通过 TAB 字符（横表、HT、ASCII 控制码 9）彼此分隔的字段。
• 每个行回车采用 \n（换行，控制码 10）或 \r\n（控制码 13，回车，然后换行）进行编码。
• 此处的字段仅指 TAB 以外的字符组成的任意字符串。实际上，每个 TAB 可将行分成不同的字段值。
• 每行必须包含相同的字段名称。
• 第一行包含字段名称（所有行），也即列标题。
  

有关更详细的说明（以及从 Excel 导出的说明），请参阅制表符分隔值 (TSV)：一种用于表格数据交换的格式

数字和日期

浮点数必须使用 .（点）作为小数分隔符。不允许使用其他数字分隔符。

• 正确：1234.00
• 正确：-12
• ‘‘‘错误’’’：1234,12
• ‘‘‘错误’’’：1.123,12
• ‘‘‘错误’’’：1,123.12
  

日期格式应为 yyyy-MM-dd，其中：

• yyyy - 4 位数的年份
• MM - 2 位数的月份
• dd – 2 位数的日期
  

例如：

• 正确：2012-09-18
• ‘‘‘错误’’’：2012-9-18
• ‘‘‘错误’’’：9-18-2012
• ‘‘‘错误’’’：18-9-2012