简介：这份Maximo入门培训资料面向刚接触企业资产管理系统的开发者与实施人员，帮助其从技术架构到代码开发建立完整认知。内容围绕J2EE体系展开，依次讲解RMI业务对象交互、程序结构与模块组成、页面开发中的界面与常用控件、基于工作流引擎的流程定制、后台定时任务的界面配置与代码实现，以及Oracle、DB2等数据库的连接与更新配置，并附有MboSet、Mbo、FldXX等常用类的代码示例与说明，目录层次清晰，便于按章节循序渐进学习。资源包共1个docx文档，约436KB，以文字讲解与代码片段为主，适合作为随查随用的入门笔记。目前已有360人学习，可供需要了解Maximo二次开发基础的读者参考。
1. 第一次打开 Maximo 后台，满屏英文和代码，到底该从哪下手
很多人第一次接触 Maximo，是被公司派去接手一套已经在跑的资产管理系统。打开后台，左边一排菜单是资产、工单、库存，右边跳出来的却是 XML 页面、MboSet、工作流设计器这些词，心里第一反应往往是：这玩意儿到底是给业务用的，还是给程序员用的？
其实它两头都占。Maximo 是一套企业资产管理（EAM）系统，说白了就是帮企业把「有多少设备、坏了怎么修、备件还剩几个、谁在什么时候干了什么」这些事管起来。它基于 J2EE 架构，业务对象走 RMI 机制，页面用 XML 描述，逻辑交互靠 Ajax，底层还有一套 OR 持久化和缓存机制撑着。听起来吓人，但入门阶段你不需要把这些全啃透，只要先搞明白一件事：Maximo 的绝大多数定制，都是在它已有的框架上「填内容」，而不是从零造轮子。这份入门培训资料就是按这个思路排的，从技术介绍、程序结构，一路带到页面、工作流、后台任务、数据库配置和代码开发，适合完全没碰过 Maximo、但需要动手改点东西的新手。
2. 先搞懂它在管什么：Maximo 到底解决哪类问题
2.1 用「设备台账 + 维修流水」理解 EAM
你可以把 Maximo 想成一个超级加强版的设备维修记录本。普通记录本只写「几号设备、哪天坏了、谁修的」，Maximo 在这条线上前后都延伸了：往前有资产台账，记录每台设备的位置、所属部门、采购信息；往后有工单流程，从报修、派工、审批、执行到关闭，每一步都留痕；旁边还挂着库存模块，修的时候领了几个备件、还剩多少，全都联动。
所以它解决的问题很具体：设备多了管不过来、维修过程没人跟踪、备件领用对不上账、审批靠邮件来回传。这些场景里，Maximo 提供的是「一套已经跑通的流程骨架」，你要做的是把公司自己的规则塞进去。入门时先记住三个词就够了：资产（Asset）、工单（Work Order）、库存（Inventory）。后面所有页面开发、工作流、后台任务，基本都围着这三样转。
2.2 为什么零基础也值得学这一套
有人会问，我连 Java 都不熟，学这个是不是太早。恰恰相反，Maximo 的入门门槛不在编程语言，而在「理解它的分层」。它把系统拆得很清楚：表现层是 XML 页面，控制层是 Servlet，业务层是 Mbo 和 MboSet，持久层有 OR 映射兜底。你哪怕只会改页面配置，也能完成不少日常工作；等你想深入，再一层层往下走。
而且它的很多操作是「界面配置优先」。比如页面开发有应用程序设计器，拖拖拽拽就能移动字段、加标签页；数据库配置有管理界面，新建对象、属性、索引、关系都能点出来；后台任务也是先配参数再写一小段代码。对新手来说，这意味着你第一天就能看到自己改的东西生效，不用先搭一整套开发环境跑通 Hello World。这种「改一点、看一眼」的反馈节奏，是坚持学下去的关键。
2.3 这份培训资料覆盖的七个板块
资料本身是按目录组织的，从 1 到 9 章，实际可以归成七块：使用技术介绍、程序结构、页面开发、工作流开发、后台任务开发、数据库配置、代码开发（MboSet、Mbo、FldXX 例子），最后还附了 Mbo 和 MboSet 常用类说明。这个顺序不是随便排的，它对应一条学习路径：先知道系统用什么技术搭的，再知道代码放在哪，然后从最外层的页面开始改，接着是流程、定时任务、数据表，最后才碰业务代码。
新手最容易犯的错，是一上来就扎进 MboSet 的代码里，结果连这个方法在哪个页面被调用都不知道。按资料顺序走，你每学一块都能对应到界面上看得见的东西，理解成本低很多。下面几章我就按这条路径，把每一块讲到「能动手」的程度。
3. 摸清程序结构：你的代码将来放在哪
3.1 先认几个包名，别被 jar 吓住
Maximo 的程序结构，资料里列了一串 jar 和 war：businessobjects.jar 是业务相关类，maximouiweb.war 是前台应用，mboweb.war 是启动加载的 web 应用，properties.jar 放配置文件，resources 放资源。第一次看确实像天书，但你只需要建立一个大致的「地图感」：前台页面在 maximouiweb，启动入口在 mboweb，业务逻辑在 businessobjects。
真正写代码时，你会反复打交道的包是这几个：
| 包名 | 管什么 | 新手什么时候会碰到 |
|---|---|---|
| psdi.server.* | 系统级服务，连接管理、session、线程、数据字典加载 | 理解启动流程时看一眼 |
| psdi.app.* | 业务对象 Mbo、MboSet，描述具体业务逻辑 | 写业务代码的主战场 |
| psdi.mbo.* | 核心持久层操作，实现 OR 映射 | 继承基类时用到 |
| psdi.workflow.* | 工作流逻辑处理 | 做流程定制时 |
| psdi.util.* | 克隆应用、删除应用、加密解密等工具类 | 偶尔调用 |
这张表不用背，遇到时回来查就行。关键是知道「业务代码在 psdi.app，持久层基类在 psdi.mbo」，这两个位置记牢，后面找例子不会迷路。
3.2 启动那一下发生了什么
资料里提到 MAXIMOStartupServlet，它做两件事：读取 maximo.properties 配置文件，然后调用 MXServer.start(properties)。MXServer 是整个系统运行期间的上下文，负责建数据连接池、实现缓存、从数据库加载数据字典、实例化系统服务和应用服务、注册 RMI、管理 MaxSession 线程。
这段你不需要会写，但要理解它的意义：Maximo 是「启动时把一大堆东西装进内存」的系统，所以很多配置改完要重启或者重新加载才生效。新手常见困惑是「我明明改了配置怎么没反应」，答案往往就在这里——它读的是启动时加载的那份。知道这一点，你排查问题时会少走很多弯路。
3.3 页面请求是怎么走到你面前的
前台这边，WebClientServlet 是核心，所有匹配 /ui/* 的 URL 都映射到它，它负责定义页面内容类型，再交给 WebClientSession 处理。而页面内容本身，除了登录验证，其余都由 XML 提供，这些 XML 存在 MAXPRESENTATION 表里，由 JSP 控制标签组件和 JavaScript 脚本共同生成最终页面，CSS 文件夹管通用样式。
把这条链路串起来就是：你访问一个地址 → WebClientServlet 接住 → 找到对应的 XML 页面定义 → 组件和脚本渲染出界面。所以你在应用程序设计器里改的东西，本质是在改这份 XML 定义。理解到这一层，页面开发就不再神秘了。
4. 从页面开始动手：不改代码也能看到效果
4.1 应用程序设计器是新手最好的入口
资料里说得很直白：应用程序设计器简单易用，技术用户和非技术用户都无需编辑代码就能配置应用，还带拖放功能。能做的常见修改包括移动字段和部分、创建新字段、表和标签页；高级一点的有创建或复制应用、定义签名选项、编辑工具栏和选择操作菜单。
我第一次学的时候，就是从「把一个字段从左边挪到右边」开始的。别小看这个动作，它让你完整走了一遍「打开设计器 → 选中应用 → 拖动 → 保存 → 刷新页面看效果」的闭环。闭环跑通了，后面加字段、加标签页都是同一个套路。
4.2 第一个练习：给现有应用加一个标签页
具体步骤按这个顺序走：
- 进入应用程序设计器，选中你要改的那个应用（建议先用演示库里的应用练手，别动生产环境）。
- 在布局区域找到标签页容器，新增一个标签页，给它起个能看懂的名字。
- 从左侧控件区拖一个文本框或表格到新标签页里，绑定到一个已有字段先试试。
- 保存，回到应用页面刷新，确认新标签页出现且能正常显示数据。
- 如果没生效，先检查是不是保存到了正确的应用，再确认是否需要重新加载配置。
这几步里，第 3 步的「绑定已有字段」很关键。新手常犯的错是直接新建字段又没配数据库，结果页面报错。先用现成的字段把流程走通，等第 6 章学完数据库配置，再回来建自己的字段，顺序就顺了。
4.3 常用控件先认五个就够
资料里给了界面示例和常用控件，但没展开。入门阶段你先把这五类认全：文本框（放单行文字）、下拉列表（放枚举值）、表格（放一组记录，通常对应一个 MboSet）、按钮（触发操作）、标签页（组织内容分区）。这五个组合起来，能拼出大部分业务页面。
控件背后的逻辑是：每个控件最终都映射到某个 Mbo 的某个字段，或者某个 MboSet 的一组记录。你现在不用深究映射细节，只要记住「控件不是孤立的，它一定连着数据」。等第 7 章写 Mbo 例子时，这句话会突然变得很清楚。
提示：练习阶段一律在演示库或测试环境操作，改坏了可以重来，这是新手最该养成的习惯。
5. 工作流和后台任务：让系统自己跑起来
5.1 工作流就是一张「记录怎么走」的图
资料把工作流说得很形象：它是一幅图，交互指引记录或用户执行一系列步骤，图形界面里展示记录可能经过的路径。一个工作流定义包含过程模型、活动、转换条件、相关数据、角色，以及需要激活的内部或外部程序。
涉及的应用程序有一串：Actions 操作、Communication Templates 通信模板、Escalations 上报自动触发、Inbox/Assignments Setup 收件箱设置、People 人员、Person Groups 人员组、Roles 角色、Workflow Application 工作流应用、Workflow Designer 工作流设计器、Workflow Inbox 工作流收件箱。新手不用全记，先抓住三个：设计器用来画图，收件箱用来收任务，角色用来决定任务派给谁。
5.2 节点类型认清楚，画图就不会乱
资料里列了开始、停止、任务、条件、手动输入、子过程、交互、等待这些节点。入门最常用的是前四个：
- 开始节点：一个过程只能有一个，建过程时自动放好。
- 停止节点：标志流程结束，可以放多个。
- 任务节点：让用户指引记录路径，至少有一条连接引出来，适合需要人工响应的环节。
- 条件节点：根据记录里的信息自动判断走向，出来的连接必须一正一反，靠节点内的 SQL 表达式解析真假。
任务节点还有几个参数值得注意：标题是图标下显示的文字，描述是说明，应用程序指定流程用在哪个应用，时限规定完成时间、超时则转给升级角色，任务分配可以指定角色并用表达式限制只有满足条件才分配。执行接受操作有两个选项：所有人都接受才算接受，或任意一人接受就算接受。这些参数决定了流程的实际行为，配的时候要对着业务规则一条条核。
5.3 第一个工作流练习：改一遍演示流程
资料建议用演示库里的工作流实例实践，查看过程 APPWFWO，修改后在工单里测试。这个练法很实在，照做就行：
- 打开工作流设计器，找到 APPWFWO 过程，先整体看一遍它的节点和连线，别急着改。
- 挑一个任务节点，改它的标题或时限，保存。
- 到工单应用里新建一条记录，触发这个流程，观察任务是否按新设置出现在收件箱。
- 再试着加一个条件节点，写一条简单的 SQL 表达式，让记录在某个字段满足条件时走不同分支。
- 测试完把改动回退，保持演示库干净。
第 4 步是新手的分水岭。条件节点的表达式写错，流程会卡住或者走错分支，这时候别慌，回设计器看连线是不是一正一反都接好了，再看表达式里的字段名有没有拼错。工作流这块的血泪经验就一句：改完一定要用真实记录跑一遍，光看图看不出问题。
5.4 后台任务：不用人盯的定时活儿
后台任务开发分界面配置和代码开发两步。界面这边新建后台任务、配置相关参数；代码这边继承 SimpleCronTask，实现 init() 做参数初始化，实现 cronAction() 执行具体逻辑。资料给的骨架是这样：
public class CrontaskTest extends SimpleCronTask { public void init() throws MXException { super.init(); // 参数初始化，比如读取配置项 } public void cronAction() { // 执行相应逻辑，比如清理过期数据、生成报表 } }这段代码的含义很直接：init 在任务启动时跑一次，用来准备参数；cronAction 是每次调度触发时执行的正文。新手写第一个后台任务，建议只做一件小事，比如往日志里打一行字或者统计某类记录数量，确认调度真的触发了，再往上加逻辑。常见翻车点是任务配好了但没跑，先查调度时间配置，再查类名有没有写对、有没有部署到位。
6. 数据库配置和代码开发：真正碰数据的那一层
6.1 数据库配置先在界面上走一遍
资料把数据库配置分成界面配置和更新数据库。界面配置包括新建对象、创建对象属性、索引和关系；更新数据库分两步，先打开管理方式，再应用配置变更、开始配置数据库。
这个流程的设计意图是：你先在界面上「声明」你要什么表、什么字段、什么索引，系统再根据声明去改真实数据库。好处是不用手写 DDL，坏处是新手容易漏掉「应用配置变更」这一步，结果界面上看着建好了，数据库里根本没有。我第一次学的时候就卡在这，折腾半天以为是权限问题，其实就是没点应用变更。所以记住顺序：建对象 → 建属性 → 建索引和关系 → 打开管理方式 → 应用配置变更。
6.2 MboSet 例子：一组记录的容器
MboSet 是持久层的核心类，核心超类是 psdi.mbo.MboSet。应用程序对象与 MboSet 直接关联，创建对象时必须指定关联的 MboSet 类。这个类必须继承 psdi.mbo.MboSet，实现 psdi.mbo.MboSetRemote 接口，并且必须定义构造方法、实现 getMboInstance 方法返回 Mbo 实例。资料给的骨架：
package maxdemo.lesson1; import java.rmi.RemoteException; import psdi.mbo.Mbo; import psdi.mbo.MboServerInterface; import psdi.mbo.MboSet; import psdi.util.MXException; public class CustDemoMboSet extends MboSet implements CustDemoMboSetRemote { public CustDemoMboSet(MboServerInterface arg0) throws RemoteException { super(arg0); // 把服务器上下文交给父类 } private static final long serialVersionUID = 3918526761961603733L; protected Mbo getMboInstance(MboSet arg0) throws MXException { // 这里返回你这个 MboSet 对应的 Mbo 实例 return new CustDemoMbo(arg0); } }参数说明：构造方法里的 MboServerInterface 是服务器上下文，必须往父类传；getMboInstance 是工厂方法，MboSet 每次需要一条新记录时都调它，所以这里返回什么类，这个集合里装的就是什么对象。serialVersionUID 是序列化标识，照写即可。理解这两点，你就明白 MboSet 和 Mbo 是「集合与元素」的关系。
6.3 Mbo 例子和 FldXX 例子：一条记录和它的字段
Mbo 代表一条业务记录，FldXX 代表字段级的逻辑。资料把这两个例子和 MboSet 例子并列，说明它们是同一层的三个视角：MboSet 管一批，Mbo 管一条，FldXX 管一个字段的行为。入门时你先把 MboSet 的骨架跑通，再去看 Mbo 怎么在 init 里初始化、initialize 里做加载后处理，最后看 FldXX 怎么在字段值变化时触发校验。
第 8、9 章附的常用类说明，是这一层的「工具箱」。add() 加记录、delete() 删记录、copy() 复制、save() 保存、commit() 提交、isNew() 判断是否新建、isModified() 判断是否改过、setValue() 设值、setValueNull() 置空、getXXXX(attributeName) 取值。这些方法名基本能望文生义，但有两个要特别注意：setFieldFlag 和 setFlag 是控制字段和对象状态的，用错会导致界面上的字段该灰不灰、该亮不亮；rollbackToCheckpoint 是回滚到检查点，属于「后悔药」，但只能在检查点之后用。新手写代码时，先把 add、setValue、save 这三个用熟，就能完成大部分数据操作。
7. 新手最容易踩的五个坑
7.1 改完配置没反应
现象：在设计器里改了页面或数据库配置，刷新后看不到变化。原因：Maximo 启动时加载配置和数据字典，部分改动需要重新加载或重启才生效。解决：先确认保存成功，再按环境要求重新加载配置；数据库改动务必确认「应用配置变更」那一步做了。
7.2 页面控件绑错对象
现象：新加的表格显示不出数据，或者一打开就报错。原因：控件绑定的 MboSet 或字段不存在，或者绑到了错误的业务对象上。解决：回到设计器检查控件的数据源，先用已有字段和已有对象验证，确认链路通了再换成自己的。
7.3 工作流卡在某个节点不动
现象：记录提交后一直停在任务节点，收件箱里也没人收到。原因：任务分配的角色没配对，或者角色下的表达式把所有人都排除了；也可能是条件节点的正反连接没接全。解决：检查任务节点的分配角色和表达式，检查条件节点是否一正一反都有连线，再用一条测试记录完整跑一遍。
7.4 后台任务配了不执行
现象：任务在界面上建好了，但到点没动静。原因：调度时间配置不对、类没有正确部署、或者 cronAction 里抛了异常被吞掉。解决：先看调度配置，再确认类名和包路径，最后在 cronAction 里加日志，确认方法到底有没有被调用。
7.5 代码里直接 new 业务对象
现象：本地测试能跑，放到系统里就出各种奇怪问题。原因：Maximo 的业务对象要走框架的上下文和缓存，直接 new 会绕过这些机制。解决：通过 MboSet 的 getMboInstance 拿对象，通过框架提供的方法操作数据，别自己造实例。
8. 下一步学什么：一条能走通的自学路线
入门之后最容易迷失，因为 Maximo 的面太宽。我的建议是按「用 → 改 → 写」三段走，每段给自己定一个能验收的小目标。
第一段是「用」。花两三天把资产、工单、库存三个应用各点一遍，重点看工单从创建到关闭经过哪些状态、每个状态下哪些字段可编辑。这一步不写任何代码，目的是建立业务感。你可以拿演示库的数据随便造几条记录，反正能删。
第二段是「改」。回到应用程序设计器，给自己定三个任务：给工单加一个标签页、加一个自定义字段并配上数据库、复制一个现有应用改成简化版。三个任务分别练页面布局、数据库配置、应用复制。做完这三个，你对「配置层」就算入门了。
第三段是「写」。从后台任务开始写第一段 Java，因为它的边界最清楚：继承 SimpleCronTask，init 里读参数，cronAction 里干活，跑没跑通看日志就知道。然后再写 MboSet 和 Mbo 的例子，最后碰 FldXX。写的时候对照第 8、9 章的常用类说明，遇到不认识的类先查再猜，别硬编。
下面这张表可以当阶段自检用：
| 阶段 | 目标 | 验收标准 |
|---|---|---|
| 用 | 熟悉三大应用 | 能说清一张工单的完整生命周期 |
| 改 | 掌握配置层 | 独立完成加字段、加标签页、复制应用 |
| 写 | 能写简单逻辑 | 后台任务按时执行并留下日志，MboSet 能增删改查 |
最后说个习惯。我刚开始学的时候，改完东西不记录，过两天就忘了自己动过哪里，出问题只能从头排查。从那以后我每次做改动，都在一个本子上写三行：改了什么、在哪个应用、怎么验证的。这个习惯帮我省了无数返工。希望帮到你。
本文还有配套的精品资源，点击获取
