简介Maximo作为企业级资产管理软件其数据库配置与属性设计是系统落地的基础也是许多新手最先遇到的难点。这份培训文档面向刚接触Maximo的运维人员、资产管理员及系统实施者围绕第一章“数据库配置”与第二章“属性配置”系统展开从连接数据库、新建对象、理解主对象、持久性、级别与类到设置属性类型、等同属性、搜索类型、虚拟字段、缺省值与自动编号并配有test、testline等练习表及关系示例能够帮助读者建立完整的数据模型认知掌握工单、资产等核心模块的配置思路。资源为单个doc文件大小约5.96MB目录结构清晰适合按章节逐节阅读和对照上机练习。目前已有253人学习浏览文档末尾还提供了作者在CSDN发布的延伸阅读链接便于读者进一步获取Maximo实际使用技巧、排错经验与最佳实践避免常见配置误区。1. Maximo 定制开发地图先分清对象、应用与程序三层Maximo 的定制开发之所以容易让人一头雾水是因为它的所有功能都可以被拆成三条线数据库配置负责“数据长什么样”应用程序设计器负责“界面怎么摆”扩展程序负责“操作逻辑怎么跑”。只要心里有这张三层地图后面学对象、属性、域、权限、后台任务都只是往里填细节。这份笔记按培训教材的模块顺序重新整理成一条可复习的链路适合正在跟项目做二次开发、或者准备内部考核的人使用——把每个模块的“是什么、改哪里、什么时候生效”一次理清复习时直接拿最后一张清单自查。2. 数据库配置对象、属性、关系与 configdb 的落库机制2.1 对象的定义主对象、持久性与级别的取舍数据库配置里的“对象”对应数据库中的一张表。新建对象时只需要填对象名和描述命名一般用业务对应的英文或英文简写例如资产对应 ASSET工单对应 WORKORDER。新建出来的对象状态是“待添加”此时去数据库里查表是查不到的只有执行过 configdb 后表才会真正建出来。这个“两步走”的机制是整个模块最重要的心智模型后面所有改字段、建关系都遵循同一套规则。三个关键开关在新建对象时必须想清楚主对象只有勾选了主对象这个对象才能被创建工作流程。资产、工单、位置这类核心对象都是主对象普通从属表一般不设。持久性默认选中。勾选后 configdb 会在数据库建表数据可以落库取消勾选则变成虚拟对象configdb 后也不存在对应表数据无法保存只能运行时临时用用完即丢。虚拟对象通常用于计算中间量或组装界面展示用的临时结构。级别默认 SYSTEM常用还有 ORG 和 SITE。SITE 级别强制要求属性里必须有 SITEID 和 ORGID 两个字段ORG 级别则必须有 ORGID。这是 Maximo 做数据隔离的底层依据配错级别会导致组织或站点维度取数失败。对象还有一个“类”的概念默认绑定系统标准的psdi.mbo.custapp.CustomMboSet。类决定了这个对象在对象级别的操作行为例如新建、删除、保存时执行什么逻辑。需要自定义时可以写自己的 MboSet 子类并在这里绑定这属于第四章要展开的扩展内容。2.2 属性七种配置项与类型选型对象的属性就是表的字段。新建对象时系统会自动生成两个字段一个是“对象名ID”作为唯一标识值不能重复另一个是 DESCRIPTION用于描述。实际业务字段全部手动添加添加后同样要 configdb 才会在数据库表中生成列。属性类型是最容易选错的地方。常用类型如下表类型可存内容典型场景ALN汉字、字母、数字名称、描述、备注UPPER大写字母输入小写自动转大写资产编号、工单号DATE日期年月日计划开工日期DATETIME时间年月日时分秒实际完成时间DECIMAL数字默认两位小数可自定义数量、金额INTEGER整数数量、序号YORN只有 1 或 0复选框绑定的字段属性页里还有六个容易忽略的配置项。等同属性让当前属性与目标属性的类型、长度保持联动改一边另一边跟着变其中有一条铁律ORGID 必须等同于 ORGANIZATION 的 ORGIDSITEID 必须等同于 SITE 的 SITEID。搜索类型决定这个字段能否出现在搜索对话框中没设置搜索类型的字段在搜索框里是查不到的。虚拟字段不落库靠运行时逻辑算出来。缺省值是在用户什么都没输入时自动带入的值。自动编号用于生成唯一序列号比如工单号自动递增。字段绑定类关联一个 Java 类用来做字段级的校验或值变更联动比如输入数量后自动联动金额。2.3 关系、索引与 configdb改完对象必须做的最后一步关系是对象之间的业务关联定义类似数据库外键但更偏向业务导航。配置好关系后父对象可以便捷地获取到子 MboSet在列表、表格和 Java 代码里直接通过关系名取数。索引则是给字段建查询加速结构高频查询字段建议加索引但不要滥用索引过多会影响写入性能。所有对象、属性、关系的变更都在 configdb 这一步才真正落到数据库。修改对象信息后系统会给对应对象打上状态标记configdb 时根据标记去修改数据库表结构。培训练习题里的 test 和 testline 就是典型的主从对象练习先建 test 主表再建 testline 明细表然后通过关系把两者关联起来最后 configdb确认表结构真的变了。梳理下来会发现最容易忽略的不是“怎么建对象”而是“建完之后忘了 configdb”。很多新人在设计器里看不到自己新加的字段多半就是只改了定义没有同步数据库。从那之后凡是动过对象或属性我都会先看一眼界面右上角有没有未同步的标记有就立刻执行 configdb。3. 域与应用设计器值校验、控件与界面组装的协作3.1 域先于界面生效的值规则域是 Maximo 里独立于对象的一层配置用来约束属性可以取哪些值。它的作用是给属性划定一个合法的值集合用户在这个属性上输入不在此集合内的值时系统会阻止保存。域的完整配置链路是添加域 → 编辑域值 → 在属性上绑定域。添加域时先给域起名并确定它的值范围然后进入域值编辑页面逐条维护允许的值。每个值一般包含值和描述两项例如状态域里可以有“已提交”“已批准”“已完成”几个条目。最后在数据库配置的属性页里把这个域绑上去属性就生效了。实际使用时要区分两种值来源一种是域里预先写死的固定值另一种是表驱动的动态值。固定值适合状态、类型这类枚举表驱动的域则从某张业务表里取值适合动态字典比如从人员表里取所有有效人员。域本身不关心界面用什么控件控件只是展示真正的合法性校验发生在数据层这也是一开始在数据库配置里就绑定域的原因——绕开界面直接写数据时域校验依然生效。3.2 应用设计器的界面骨架显示、标签页组、标签页与部分应用程序设计器是组装界面的地方它的层级结构可以理解为“应用 → 显示 → 标签页组 → 标签页 → 部分 → 部分列 → 控件”。每一层管一块区域层级嵌套关系清楚了拖控件时才不会乱。控件选用板是左侧的控件仓库拖到画布上就能用。选中控件后右侧控件属性面板决定它的行为绑定哪个属性、是否必填、是否只读、默认值是多少。控件属性里最容易踩的一个点是把“必填”放在控件层而不是数据层导致数据从后台写入时绕过界面校验——所以必填约束尽量在对象或域层面定义界面只负责提示。标签页组和标签页用来组织信息模块比如一个工单应用可以有“工单信息”“计划”“实际”几个标签页。部分和部分列是更细的布局单元用来把同一区域里的字段分列排放。多部分文本框适合拆分的编码类字段比如“区号-号码”一次录入自动拼成完整值文本框就是普通单值输入。表控件和表列用于承载主从结构中的明细记录相当于界面上直接内嵌一个子表。复选框绑定 YORN 字段显示为勾选状态附件控件挂文件帮助格显示辅助说明信息按钮控件则是后面接 Java 动作的入口。3.3 应用导入导出、编辑对话框、签名选项与选择操作应用设计器不只是拖控件。导入和导出功能用于把整个应用定义从一个环境搬到另一个环境开发环境调好的界面导出后导入到测试或生产环境能省下大量重复手工搭建的时间。编辑对话框配置弹窗版编辑界面适用于在列表页直接编辑某条记录的字段。签名选项控制哪些操作需要二次确认例如删除记录时要求输入用户名和密码防止误操作。选择操作允许在菜单里挂额外的动作入口这些动作通常对应 Java 代码里的方法工具栏菜单则是自定义顶部按钮的入口。这章的重点是理解“界面只是壳”。文本框、复选框、表这些都只是展示和输入载体真正的数据校验、默认值、自动编号、权限控制早就在数据库配置和域里定好了。设计器里改控件属性能影响交互但影响不了数据规则。4. 扩展程序MBO 类与 Bean 类的职责划分4.1 程序的四种 Java 类先分清楚谁管数据、谁管界面Maximo 的二次开发代码可以归纳为四个大类MBO 类里细分为字段类、流程操作类和 MboSet/Mbo 类BEAN 类里细分为应用程序主类、tablebean 类和选择对话框类。区分它们的口诀是MBO 管数据和业务逻辑BEAN 管界面动作和交互。程序路径决定了你的代码放在哪个 class 目录、类名怎么写、系统按什么规则加载。写代码前先确定路径否则类找不到是最常见的低级错误。4.2 字段类与流程操作类字段级和对象级的逻辑字段绑定类以MboValueAdapter为基础它监听某个字段的值变化。典型用途用户输入数量后自动算总价、输入设备编码后自动带出设备名称、保存前校验某个字段的合法性。示例结构如下public class CustomField extends MboValueAdapter { public CustomField(MboValue mbv) { super(mbv); } Override public void validate() throws MXException, RemoteException { // 字段校验拿到当前值不满足条件则抛出异常 String val getMboValue().getString(); if (!Y.equals(val) !N.equals(val)) { throw new MXException(只能输入 Y 或 N); } } Override public void action() throws MXException, RemoteException { // 值变更后的联动逻辑修改同记录的其他字段 if (getMboValue().getInt() 100) { getMboValue().getMbo().setValue(DESCRIPTION, 大额记录, 11L); } } }validate 方法负责校验action 方法负责值变化后的联动动作。字段绑定的路径就写在数据库配置的属性页里写完编译后要重新加载类否则系统仍用旧逻辑。MAXTableDomain是域校验相关的绑定类一般配合域使用在 Java 层面扩展域的统计算法。流程操作类则定义对象级操作比如新建、删除、保存、状态流转时的额外业务处理绑定到对象的“类”上。4.3 BEAN 类应用主类、tablebean 与选择对话框应用程序主类管理应用的生命周期包含初始化、页面加载、工具栏按钮动作等。工具栏按钮上配置的“执行 Java 方法”就指向这个类里的方法。tablebean 类管理界面上的表格行为例如表按钮点击后对表格选中行做什么处理。选择对话框类分多选和单选两种多选用于“批量选择资产”“批量指派人员”这种场景单选用于“只能选一个父对象”的场景。选择对话框的代码核心是接收选择结果、回填到目标字段然后按需触发后续校验。4.4 MboSet 与 Mbo数据操作的编程入口MboSet 可以理解为一批 Mbo 记录的集合Mbo 是单条记录。MboSet 的操作包括查询、遍历、新增、删除、保存Mbo 的操作包括取值、赋值、获取父级、获取子集、初始化、删除。先用 MXSession 建立连接再通过getMboSet取数MXSession session MXServer.getMXServer().getMXSession(USER, PASSWORD); MboSetRemote assetSet session.getMboSet(ASSET); assetSet.setWhere(STATUS 运行中); assetSet.reset(); // 遍历并读取字段 MboRemote asset assetSet.moveFirst(); while (asset ! null) { System.out.println(资产编号: asset.getString(ASSETNUM)); asset assetSet.moveNext(); }Mbo 的生命周期顺序很关键新建时先add()再 setValue 赋值最后save()保存后系统才生成正式的主键和唯一标识。初始化逻辑写在init()里delete 写在继承方法里。很多初学的人直接在构造器里写初始化逻辑导致某些场景下字段还没加载就取不到值——正确做法是重写init()。写扩展程序最容易翻车的地方是分了类却没搞清楚调用时机字段类在属性层面触发流程操作类在对象操作时触发bean 类在界面动作时触发。想在保存后做联动就要选对层的代码否则看代码怎么都发现不了为什么不执行。5. 权限与后台任务配置路径与易漏点排查5.1 权限组的创建与应用程序授权权限体系的链路是权限组 → 授权应用 → 数据限制 → 用户入组。先创建权限组例如给仓库操作员建一个“STORE_OP”组然后在应用授权里勾选该组可以访问哪些应用程序、每个应用里有没有新增、修改、删除的权限。最后把用户加进权限组登录后系统按组解析出全部权限。常见误区是给用户授予了某应用入口但应用内的按钮还是灰色或不可用——因为这属于签名选项和密钥权限的范畴要检查该操作有没有被单独授权。系统应用的授权粒度分到“操作”级别新增、修改、删除、审批各有各的权限开关不能只授一个总开关。5.2 对象限制与属性限制行与列的两种数据边界数据限制分对象限制和属性限制这两者经常被混为一谈。对象限制是行级过滤相当于给这个权限组对某对象的查询加一个固定的 where 条件。例如限制仓库操作员只能看到“状态已接收”的工单在对象限制里写条件即可。属性限制是列级控制决定某权限组的用户在界面上能不能看到、能不能编辑某个字段。例如采购员看不到成本字段或看到了但不能修改。对象限制控制能看到哪些行 → 相当于数据库查询条件属性限制控制能看到和编辑哪些列 → 相当于界面字段级权限两条规则叠加使用时要特别小心属性限制隐藏字段但对象限制并未排除该字段相关数据后台导数据时字段依然在。如果既想隐藏又想隔离必须两层一起配。5.3 后台任务的创建、实例与启用后台任务用于执行定时或批处理逻辑完整链路是创建后台任务程序 → 创建后台任务实例 → 配置参数 → 启用并运行。后台任务程序里绑定处理类决定任务执行时跑什么代码实例则是一次具体运行的计划决定任务什么时候跑、跑哪些数据、参数是什么。配置实例时最重要的检查项是“启用”状态和“运行时间”。很多人创了实例却忘了启用到点任务毫无反应或者实例启用了但参数里对象名写错导致批处理对空集合跑了一遍。更新任务逻辑后也要重新测试实例否则线上跑的还是旧逻辑。后台任务的日志是排查第一现场任务失败先看异常栈里反馈的是哪个环节。5.4 权限与后台任务的五个高频易漏点易漏点应用程序授权给了但操作级权限没给具体动作。现象是用户能进应用却新增不了。原因是系统对新增、删除等动作的授权是独立的。补法是逐项检查应用下每个动作的勾选状态。易漏点对象限制的 where 条件写错或没覆盖所有站点。现象是数据时有时无。原因是条件里少了 ORGID 或 SITEID 维度。补法是先不加限制测一次看全集再加限制对比差异。易漏点属性限制与对象限制用混。现象是字段在列表隐藏了但明细或报表里仍能取出值。原因是不理解行级与列级是两个维度。补法是按“行看对象限制、列看属性限制”的原则重新拆分。易漏点后台任务实例创建后未启用。现象是定时任务从没触发过。原因是实例默认不启用。补法是创建后立即进入实例列表确认计划状态首次先手动跑一遍验证参数。易漏点改了任务逻辑只重新编译没有重新部署类或重启容器。现象是任务跑完结果和旧逻辑一致。原因是后台任务的类加载没有自动热更新。补法是发布代码后重启服务并观察一次完整执行日志。6. 复习清单按对象到权限的数据流自查一遍到这里整条链路已经走完数据库配置定义表和字段域约束值应用设计器组界面Java 程序接行为权限和后台任务控制边界与调度。复习时不要按章节顺序从头翻而是顺着一条业务数据的生命周期过一遍效率高得多。我的复习方法是六步自查建表层对象有没有设持久性级别是 ORG 还是 SITE关键字段齐全吗改完 configdb 了吗字段层类型选对没有YORN 字段绑复选框了吗等同属性没配错吧值规则层哪些字段需要校验范围域建了吗属性上绑了没有界面层控件绑的属性名对不对多部分文本框用对场景没有入出对话框挂好没逻辑层字段联动写在哪一层校验应该在 validate 还是 action按钮方法指到 bean 类哪个方法了边界层谁有权限看行级限制的 where 条件覆盖全组织没有定时任务实例启用没有每次带新学员时我都会让他们拿一张新建的业务表格从建对象开始走完这六步能走通就说明脉络通了。从那以后我每次接到新的定制需求都强制自己先画一遍这张数据流图再动手省掉了大量改到一半才发现“源头就没设对”的返工。希望这份复习笔记能帮到你把翻过就忘的细节变成随时可以自查的清单。本文还有配套的精品资源点击获取