Qarma 支持基于文件的数据导出,便于在 Qarma 之外进行进一步分析。这对于以下场景非常有用:
- 商业智能应用(例如展示仪表板,深度分析验货数据和供应商评分卡)
- 在 ERP 系统中批量更新订单状态(也可以通过事件驱动的 API 实现)
- 更新订单预定系统中的验货状态和日期
- 更新主数据系统中的供应商和生产单位信息
当然,还有许多其他应用场景。总的来说,API 支持定义数据导出任务,这些任务将在预定时间间隔内运行,生成可以通过包含 API 密钥的 URL 下载的文件。
获取访问权限
您可以手动或通过编程方式访问数据。若手动提取数据,请访问数据导出页面,您将能够进行一次性的数据提取。
若要获取 API 密钥和用于持续集成数据的 URL,请联系 Qarma 支持团队,并注明您希望基于哪些参数进行数据导出。
参数说明
以下是数据导出的参数:
名称 | 描述 |
---|---|
Date start 和 Date end | 开始日期可以是具体日期或相对日期(例如 -30 天表示从当前日期起,往前推 30 天的所有数据,-3 个月表示从今天起,往前推三个月的数据)。 日期过滤将基于状态对应的日期: 计划中:将根据以下日期进行过滤,按设置顺序选择: 1. 计划日期(验货/验厂的预定日期) 2. 预定日期 3. ETD(预计出发日期) 对于验厂,只有计划日期适用。 进行中:将根据开始日期进行过滤。 报告:将根据结束日期进行过滤。 请注意,由于 Qarma 支持离线操作,因此实际结束日期和数据在 Qarma 服务器上可用的时间之间可能存在延迟。这意味着,如果您过滤每天的数据提取,它需要包括几天前的数据,以确保所有数据都被包含。 |
Type | 选择数据类型:验货、验厂或供应商 |
Extra data | 基本数据始终会导出,这包括验货、验厂或供应商的列表,具体取决于选择的类型。此外,还可以包括以下数据: 检查点:对于“进行中”和“报告”状态的验货和验厂,可以包括所有检查点的列表。 疵点(仅限验货):对于“进行中”和“报告”状态,可以包括所有疵点的列表。 改正措施(仅限验厂):对于“进行中”和“报告”状态,可以包括所有与验厂相关的改正措施列表。 只有在使用了检查点、疵点或改正措施时才包含它们,因为它们会显著增加导出文件的大小。 |
Status | 选择一个或多个状态: 计划中 已下载(仅限验厂) 进行中 报告 |
Interval | 定义导出任务的运行频率。例如:每天 20:00,或每周一 06:00 等等。 |
Data format | 数据可以以 Excel 或一组 CSV 文件的形式提供,内容相同。Excel 文件会包含一个或多个工作表,具体取决于上面定义的Extra data参数。对于每个工作表,都有对应的 CSV 文件。 由于 Excel 文件的行数限制,建议大规模文件集成时使用 CSV 文件而非 Excel 文件。如果 Qarma 导出的数据行数超过一百万行,将不会生成 Excel 文件,只有 CSV 文件可用。 |
详细导出格式说明
如有任何问题或需要帮助,请联系 Qarma 支持团队。供应商与生产单位导出 API