本教程详细介绍了在Maximo中，如何利用自定义表格控件的“关系”属性及其“where子句”实现保存记录后自动清空表格视图的功能。通过设置一个永假的where子句，可以确保表格在加载及保存后不显示任何现有数据，同时仍允许用户添加新行，从而有效解决“Start Empty”属性无法满足的业务需求。
Maximo自定义表格控件的清空需求与挑战
在Maximo应用程序开发中，自定义表格控件是展示和操作列表数据的重要组件。有时，业务场景要求用户在表格中输入新记录并保存后，表格视图能够立即清空，以便用户可以继续输入新的数据，而无需显示刚刚保存的记录。
Maximo表格控件提供了一个名为“Start Empty”（启动时为空）的属性。当此属性设置为true时，表格在应用程序首次加载时会显示为空。然而，这个属性的局限性在于，它仅在应用程序启动时生效。一旦用户在表格中添加了记录并执行保存操作，Maximo会根据表格控件关联的数据源关系重新加载数据。如果该关系能够找到刚刚保存的记录，那么这些记录将再次显示在表格中，这与我们期望的“保存后清空”行为不符。
核心解决方案：利用关系属性的Where子句
要实现自定义表格控件在保存记录后自动清空，我们需要利用其“关系”（Relationship）属性。Maximo中的每个表格控件都通过一个关系与底层数据对象（MBO）进行关联，这个关系定义了表格将显示哪些数据。通过巧妙地修改这个关系的where子句，我们可以控制数据加载的行为，从而达到保存后清空的目的。
基本原理：
- 阻止数据加载： 将关系的where子句设置为一个永远为假的条件（例如，3 = 4）。这样，无论何时，当Maximo尝试通过此关系从数据库中获取数据时，都将找不到任何匹配的记录。
- 允许添加新行： 尽管where子句阻止了现有数据的加载，但表格控件仍然允许用户通过“添加行”功能创建新的、未保存的记录。这些新行在保存之前是存在于内存中的，不受where子句的限制。
- 保存后重新清空： 当用户保存记录时，Maximo会将内存中的新行写入数据库。保存操作完成后，表格控件会根据其关系定义重新刷新数据。由于关系的where子句仍然是永假的，刷新操作将再次找不到任何记录，从而使表格视图恢复到清空状态。
实施步骤与示例
要将此解决方案应用到您的Maximo自定义表格控件，请遵循以下步骤：
打开应用程序设计器： 登录Maximo，导航到“系统配置”>“平台配置”>“应用程序设计器”。
选择目标应用程序： 找到并打开包含您自定义表格控件的应用程序。
定位自定义表格控件： 在应用程序设计器界面中，选择您的自定义表格控件。您可以通过点击控件并查看其属性来确认。
-
修改关系属性：
- 在表格控件的属性窗口中，找到名为“关系”（Relationship）的属性。
- 点击“关系”属性旁边的查找图标或直接编辑其值。
- 在关系定义中，找到“Where子句”（Where Clause）字段。
- 将“Where子句”的值修改为一个永远不会为真的条件。
示例代码：
3 = 4
或者
1 = 0
任何能够确保条件永假的表达式都可以。
-
保存并测试： 保存应用程序的更改，然后注销并重新登录Maximo，或刷新应用程序缓存，以确保更改生效。打开修改后的应用程序，测试自定义表格控件的行为。您应该会发现：
- 表格在加载时是空的。
- 您可以添加新行并输入数据。
- 保存记录后，表格会立即清空。
工作机制解析
- 数据源与关系： Maximo的表格控件通过一个数据源（Data Source ID）与一个MBO关联，而这个数据源又通过一个“关系”定义了从父MBO获取子MBO的方式。where子句是这个关系的一部分，用于过滤子MBO的数据。
- 新行添加： 当用户点击“添加行”时，Maximo会在内存中创建一个新的MBO实例，并将其添加到表格的数据集中。这个新实例尚未写入数据库，因此不受where子句的限制。
- 保存操作： 当用户点击保存按钮时，Maximo会将所有在内存中修改或添加的MBO实例持久化到数据库。
- 数据刷新： 保存操作完成后，Maximo通常会触发数据源的刷新机制。表格控件会根据其关联的关系重新查询数据。由于我们设置的where子句（如3 = 4）始终为假，查询结果将是空的，从而实现了表格的清空。
注意事项
- 适用场景： 此方法主要适用于那些只希望添加新记录，并且在保存后立即清空视图以准备下一条新记录输入的场景。例如，工时单（Timesheet）录入、批次数据录入等。
- 不适用于编辑现有数据： 如果您的业务需求是允许用户查看、编辑和保存现有数据，则此方法不适用。因为where子句会阻止任何现有数据的显示。在这种情况下，您可能需要考虑其他定制方案，例如在保存后通过脚本清除表格数据模型，或使用自定义对话框进行数据输入。
- 关系定义的准确性： 确保您修改的是表格控件正确的关系属性。错误的修改可能导致表格无法正常工作。
- 性能影响： 将where子句设置为3 = 4这种简单的条件对系统性能几乎没有影响，因为它是一个非常快速的评估。
总结
通过巧妙地利用Maximo自定义表格控件的“关系”属性，并将其“where子句”设置为一个永假的条件，我们能够有效地实现表格在保存记录后自动清空的功能。这种方法简单、直接，并且避免了复杂的编程定制，是解决特定业务需求的一种高效途径。在实施前，请务必理解其工作原理和适用场景，以确保它符合您的具体业务需求。
