16.自动生成XML

一旦定义了转换规则，模块必须能够自动生成可用的XML文件来自平台中输入或检测到的数据。

此步骤至关重要，因为它将现场信息或业务形式转化为结构化流程，准备传输到 ERP、连接器、文档系统或其他目标工具。

目标不仅是“制作 XML”，而且是生成 XML：

• 可靠的，

• 合规，

• 清晰易读，

• 可验证的，

• 可重复使用的。

因此，自动生成必须基于稳健且受监督的逻辑。

---

16.1 可重复

一代人必须是reproductible，也就是说，对于相同的源数据，系统必须始终根据相同的规则产生相同的结果。

这意味着：

• 相同的字段必须提供相同的标签，

• 每次都必须应用相同的业务规则，

• 必须遵守相同的格式约定，

• 相同的依赖关系应该产生相同的输出。

这种再现性对于避免以下情况至关重要：

• 结构偏差，

• 根据用户的不同，处理方式也有所不同，

• 随机误差，

• 涉及同一主题的两批货物之间的不一致。

它还使得与目标系统的安全交换成为可能，目标系统需要稳定且可预测的格式。

实际上，这假设 XML 生成引擎的工作原理是：

• 定义的模型，

• 固定规则，

• 记录的映射，

• 和集中逻辑。

---

16.2 可追溯

一代人必须是可追溯的，以便准确地知道：

• 当生成 XML 时，

• 从什么来源，

• 由哪个用户或进程，

• 用什么数据，

• 根据哪个版本的规则，

• 以及结果如何。

由于多种原因，可追溯性至关重要。

首先，它允许您解释传输到第三方系统的文件。
然后，它可以让您快速识别错误或差异的根源。
最后，它构成审计、合规性或历史逻辑中的处理证明。

因此，该模块必须能够记录以下信息：

• 源对象的标识符，

• 生成日期和时间，

• 世代状况，

• 使用的 XML 模型的版本，

• 触发用户或服务，

• 进行的检查的日志，

• 可能的错误消息，

• 生成文件的哈希值或引用。

因此，每个 XML 都成为一个跟踪对象，而不是动态生成的简单文件。

---

16.3 一致

一代人必须是相干，即XML的内容必须与预期的业务逻辑完全对应。

一致性涉及以下两个方面：

• 文件的结构，

• 字段之间的关系，

• 良好价值观的存在，

• 尊重商业意识。

例如 ：

• 设备代码必须对应于正确的机器，

• 开始日期不得晚于结束日期，

• 干预类别必须与所处理对象的类型兼容，

• 维护通知的安全字段不得不一致，

• 如果需要的话，声明的附件必须实际存在。

因此，一致性在数据之间强加了内部验证逻辑，而不仅仅是字段的技术存在。

换句话说，XML 在技术上可能是“格式良好”的，但在功能上仍然是错误的。
模块应该避免这种情况。

---

16.4 可控

一代人必须是可控的，也就是说我们必须能够：

• 了解生成了什么，

• 检查内容，

• 重读应用逻辑，

• 发送前确认文件符合要求。

无法快速控制的自动化系统就会产生风险。
因此，有必要提供管理员、关键用户或业务经理可以访问的验证机制。

该控制可能涉及：

• XML 结构，

• 生成的标签，

• 注入的值，

• 预期字段的存在，

• 对应关系的一致性，

• 符合目标模式。

这使得在保持人工监督能力的同时确保自动化成为可能。

---

16.5 显示预览

系统必须能够在验证或发送之前显示 XML 预览.

通过此概述，您可以：

• 可视化生成的结构，

• 控制主要值，

• 识别可能的异常情况，

• 让用户或管理员放心，

• 方便调试。

概述可以以多种形式提供：

• 原始 XML 视图，

• 带缩进的结构化视图，

• 简化的面向业务的视图，

• 源和输出之间的比较。

这个概述特别有用：

• 在配置阶段，

• 在测试过程中，

• 对于敏感流量，

• 或者在目标系统报告错误的情况下。

它为原本不可见的机制带来了透明度。

---

16.6 生成调试

系统必须能够生成调试模式以便准确理解 XML 是如何构建的。

调试不仅仅适合开发人员。
它对于职能管理员、集成商和业务顾问也很有用。

良好的调试必须能够识别：

• 哪个源数据馈送到哪个信标，

• 使用了什么规则，

• 哪些字段被忽略，

• 应用了哪些转换，

• 进行了哪些计算或串联，

• 出现堵塞的地方。

例如，调试可能指示：

• “标签<TPLNR>从 Equipment_code 字段提供”，

• “缺少必填字段：intervention_date”，

• “转换后的值：‘电梯’→‘ELEV’”，

• “由于没有有效文档，未生成附件 XML 块”。

此调试模式对于以下方面至关重要：

• 加快整改速度，

• 使配置可靠，

• 减少分析时间，

• 记录发动机的实际运行情况。

---

16.7 检查必填字段

系统必须强制检查必填字段的存在和有效性在任何最后一代之前。

这些必填字段可能取决于：

• 表格类型，

• 业务对象的类型，

• 目标系统的

• 商业环境，

• 所选配置的。

检查不应仅限于字段是否“存在”。
它还必须控制：

• 它不是空的，

• 它的格式正确，

• 它包含一个可接受的值，

• qu’il est compatible avec les autres données.

例如 ：

• 日期必须有效，

• 命名法中必须存在设备标识符，

• 一种干预类型必须属于授权列表，

• 优先级必须与所选类别一致。

此步骤可避免目标生成不完整、错误或拒绝的 XML。

---

16.8 如果 XML 不完整则阻止

系统必须能够如果 XML 不完整或不一致，则自动阻止最终生成或发送.

这种封锁是必要的安全措施。
最好阻止发送，而不是传输错误的文件，否则会产生：

• ERP 方面的拒绝，

• 处理异常，

• 糟糕的对象创建，

• 对系统失去信心。

阻止必须是明确且易于理解的。
该模块必须清楚地表明：

• 为什么 XML 被阻止，

• 缺少哪些字段，

• 需要纠正哪些错误，

• 相关的关键程度是什么。

例如 ：

• “不可能生成：未指定设备”，

• “发送被阻止：缺少日期字段”，

• “无效的 XML：缺少强制标签”，

• “控制失败：干预类型不一致”。

好的阻止并不只是要拒绝。
它还必须指导纠正。

---

16.9 总体目标

因此，必须将 XML 自动生成视为结构化生产引擎，而不是作为简单的技术输出。

它必须允许：

• 在不失去控制的情况下实现自动化，

• 标准化，但没有不必要的僵化，

• 传输可靠的数据，

• 以保证高水平的质量。

按照这个逻辑，XML 变成：

• 一个业务对象，

• 集成支持，

• 受控流量，

• 信息结构的证明。

---

16.10 预期结果

在该过程结束时，模块必须能够：

• 恢复源数据，

• 应用定义的规则，

• 构建预期的 XML，

• 检查其完整性，

• 显示预览，

• 产生详细的调试，

• 必要时阻止，

• 然后仅验证或传输符合要求的文件。