★ FEATURED ARTICLE 简介本资源是一份面向IT运维工程师、资产管理系统实施人员及Maximo初学者的入门级培训文档聚焦Maximo平台核心配置能力培养解决企业级资产与工单管理系统的部署与定制化基础问题。文档以Word格式.doc单文件呈现体积5.96MB内容结构清晰覆盖数据库配置与属性配置两大核心模块第一章详述对象建模含主对象、新建对象、类、级别、持久性、数据库连接设置及configdb工具使用第二章深入属性定义机制包括类型与长度约束、等同属性复用、虚拟字段、缺省值、自动编号及字段绑定类等关键实践要点。所有知识点均配有操作逻辑说明与典型应用场景提示便于读者边学边练、快速上手系统定制。目前已有254人学习下载是理解Maximo数据模型底层逻辑、开展二次开发与流程配置的重要参考材料。1. Maximo基本培训文档不是说明书是能直接上手改数据库、搭界面、写后台逻辑的实操手册你刚接手一个Maximo项目客户提了三个需求要在工单里加一个“维修耗时小时”字段支持小数点后一位要新建一个“备件领用申请”应用带表格附件多选弹窗还要让这个申请只对某几个站点可见且审批人只能看到自己负责的那部分数据。翻遍官方文档全是概念堆砌查CSDN博客代码片段断在关键处缺类路径、少configdb触发步骤、没权限组绑定细节——最后卡在“保存后数据库没建表”“点击按钮没反应”“授权后还是403”这种玄学现场。这份《Maximo基本培训.doc》就是为这类场景写的它不讲“什么是MBO”而是告诉你新建对象后必须点哪三个按钮才能让数据库真生成testline表不罗列“域有几种类型”而是用练习题逼你亲手把YORN字段绑到复选框、再验证前端是否同步显示“是/否”不空谈“BEAN类作用”而是给出tablebean中handleButtonEvent()方法里getMboSet().moveTo(0)和fireStructureChanged()的调用顺序——错一步列表就刷不出来。它面向的是已经部署好Maximo环境、有WebSphere或Jboss基础、能进Admin Console但还没摸清psdi.mbo.*包体系的一线实施工程师或内部开发。整份文档按真实工作流组织先动数据库对象→属性→关系→configdb再搭界面控件拖拽→绑定域→签名选项接着写逻辑MBO增删改→tablebean事件→后台任务调度最后锁权限组→应用授权→对象级限制。所有操作都落在具体菜单路径、按钮名称、配置项勾选状态上没有一句“理论上可以……”。提示这不是入门扫盲材料。如果你连Maximo登录页都还没见过建议先完成标准安装验证确保maximo.ear已部署、maxadmin账号可登录、Database Configuration应用能打开。本文档默认你已具备该前提。2. 数据库配置从新建对象到configdb落地的四步闭环Maximo的数据库配置不是SQL DDL脚本执行器而是一套元数据驱动的声明式建模工具。它的核心矛盾在于你在界面上做的所有改动只是在内存中修改了对象定义快照真正的数据库表变更必须经过configdb这道闸门。跳过它或者中途失败就会出现“界面上能看到新字段但数据库表里没有对应列”的经典翻车。2.1 新建对象主对象、持久性、级别三要素必须一次选对新建对象的操作路径Database Configuration→ 工具栏New Object按钮 → 输入Name如TESTLINE、Description如测试明细表。此时关键配置项如下配置项可选项必须选择理由血泪经验Main Object✓ / ✗必须勾选。只有主对象才能被工作流引擎识别后续若要为TESTLINE建审批流此处不勾则流程设计器里根本找不到该对象曾有项目因漏勾此选项导致流程发布后始终无法触发排查3天才发现对象非主对象Persistent✓ / ✗必须勾选。不勾选即为虚拟对象Virtual Objectconfigdb后数据库无表也无法持久化数据。业务表99%需勾选某导师演示时故意不勾结果学员误以为“虚拟对象临时表”上线后数据全丢LevelSYSTEM / ORG / SITE根据业务范围选。若TESTLINE仅限某站点使用选SITE若跨组织共享选ORG若全系统通用如ASSET选SYSTEM。选错会导致后续字段约束报错SITE级对象必须含SITEID和ORGID字段否则configdb直接失败错误日志只提示“level validation failed”# configdb执行命令Linux环境 cd $MAXIMO_HOME/tools/maximo ./configdb.sh -d DB2 -u maximo -p maximo -s MAXIMO注意configdb.sh参数中的-d指定数据库类型DB2/Oracle/SQLServer-s是数据库实例名非URL务必与maximo.properties中mxe.db.name一致。执行前确认$MAXIMO_HOME已正确设置且当前用户对tools/maximo目录有执行权限。2.2 属性配置类型、等同属性、搜索类型的硬约束对象建好后点开Attributes标签页添加字段。以TESTLINE为例需添加DURATION维修耗时字段类型与长度Type选DECIMALLength填10Scale填1小数点后1位。为什么不是ALN因为ALN存文本无法参与数值计算如工单总耗时求和为什么Scale1客户明确要求“精确到0.1小时”Scale0会强制取整。等同属性Equiv Attribute若DURATION需与WORKORDER表的ACTUALDURATION保持一致同类型、同精度则在此处输入WORKORDER.ACTUALDURATION。关键逻辑等同属性是双向同步的。改WORKORDER.ACTUALDURATION的Scale为2TESTLINE.DURATION的Scale也会自动变为2。生产环境慎用避免误触核心表。搜索类型Search Type必须设为WILDCARD模糊搜索或EXACT精确匹配。若不设该字段在应用界面的查询区域将不可见。玄学现象DURATION设为EXACT后在工单查询页输入5.5能搜到但输入5搜不到因数据库存的是5.0。此时应改用WILDCARD或前端加LIKE 5.%处理。2.3 关系与索引让关联查询不变成全表扫描TESTLINE需关联到WORKORDER工单主表关系配置路径Relationships标签页 →New Relationship→ 填写Relationship Name:TESTLINEWO命名规则子表主表缩写Parent Object:WORKORDERChild Object:TESTLINEWhere Clause:workorderid :workorderid注意冒号语法表示引用父对象字段为什么必须写Where ClauseMaximo不自动生成ON条件。漏写会导致关联查询返回笛卡尔积10万条工单 × 100条明细 1000万行页面直接卡死。索引配置在Indexes标签页为TESTLINE的workorderid字段建索引Index Name:TESTLINE_WOID_IDXUnique: ✗非唯一索引因一个工单可有多条明细Columns: 添加workorderid字段并设Order为ASC-- configdb后实际生成的SQLOracle示例 CREATE INDEX TESTLINE_WOID_IDX ON TESTLINE (WORKORDERID ASC);排查技巧若关联查询极慢登录数据库执行EXPLAIN PLAN FOR SELECT ... FROM TESTLINE t, WORKORDER w WHERE t.workorderidw.workorderid看执行计划是否走索引。未走索引则检查索引名是否含非法字符如空格、字段名大小写是否与数据库实际列名一致。2.4 configdb全流程避坑从标记到生效的五个关键节点configdb不是一键执行而是分阶段校验、生成、执行。以下五步任一失败都会导致“界面有、库中无”现象原因解决执行configdb.sh后提示No changes to process对象/属性修改后未点击Save或修改状态未被标记为ADD/CHANGE。检查对象列表右侧Status列应为Add或Change而非None返回Database Configuration界面对目标对象右键 →Save再刷新列表确认状态已更新configdb.sh报错ORA-00942: table or view does not exist当前用户maximo无CREATE TABLE权限或MAXIMO模式下已存在同名表但无DROP权限用DBA账号执行GRANT CREATE TABLE TO maximo; GRANT DROP ANY TABLE TO maximo;或手动DROP TABLE TESTLINE后再试configdb成功但数据库中TESTLINE表无DURATION字段字段添加后未保存或Status列为None。configdb只处理标记为ADD/CHANGE的属性进入Attributes页找到DURATION行确认Status为Add右键Save再执行configdbconfigdb后TESTLINE表存在但workorderid字段为NULLABLEY关系配置中未勾选Required导致外键字段允许为空。业务上workorderid必填必须强制非空编辑关系TESTLINEWO勾选Required再执行configdb会生成ALTER TABLE TESTLINE MODIFY WORKORDERID NOT NULLconfigdb成功但Maximo应用重启后TESTLINE对象在应用设计器里找不到configdb只更新数据库未刷新Maximo缓存。需手动清除$MAXIMO_HOME\applications\maximo\businessobjects下的编译文件执行$MAXIMO_HOME\tools\maximo\buildmaximo.batWindows或buildmaximo.shLinux重建businessobject jar提示生产环境执行configdb前务必备份maximo.properties和数据库MAXIMO模式。configdb不可逆一旦执行无法回滚到前一版本除非用数据库备份恢复。3. 应用程序设计器从拖控件到签名选项的完整链路数据库建完下一步是让业务用户能看见、能操作这些数据。Maximo的应用程序设计器Application Designer不是低代码平台而是基于XML模板Java BEAN的混合开发环境。它的核心逻辑是界面控件Presentation绑定数据源MboSet数据源由MBO类驱动而MBO类的行为由签名选项Signature Options控制权限。漏掉任一环轻则功能缺失重则权限失控。3.1 控件选用板哪些控件必须配域哪些必须写BEANApplication Designer的控件面板Control Palette分两类声明式控件Declarative如Text Box、Check Box、Table只需绑定属性Attribute和域Domain无需写Java代码。行为式控件Behavioral如Pushbutton、Attachments、Help Grid必须关联BEAN类如psdi.webclient.beans.pushbutton.PushButtonBean否则点击无响应。以TESTLINE应用为例需添加一个Table控件展示明细列表一个Pushbutton触发“导出Excel”一个Attachments控件上传维修照片。关键配置Table的Data Source必须设为TESTLINE即MboSet名Table Column的Attribute设为DURATIONPushbutton的Bean Class填psdi.webclient.beans.pushbutton.PushButtonBeanMethod填exportToExcel需确保该方法在BEAN中已实现Attachments的Bean Class填psdi.webclient.beans.attachments.AttachmentsBeanMbo Name填TESTLINE。为什么Table不写BEAN也能显示因为Table是声明式控件其数据加载由框架自动调用getMboSet().execute()完成。而Pushbutton是行为式控件框架只负责渲染按钮点击后的逻辑必须由BEAN的handleEvent()方法实现。3.2 签名选项权限控制的最终闸门签名选项Signature Options是Maximo权限模型的基石。它不控制“谁能看这个应用”而是控制“在这个应用里谁能执行哪个操作”。配置路径Application Designer→ 选中应用 →Select Action→Signature Options。以TESTLINE应用为例需配置ADDRECORD允许新增明细DELETE允许删除EXPORT允许导出ATTACHFILE允许上传附件。关键逻辑签名选项本身不生效必须与权限组Security Group绑定。例如给MAINTENANCE组授予TESTLINE应用的ADDRECORD和DELETE权限该组成员才能新增/删除明细若未授EXPORT即使界面上有导出按钮点击也会提示“Access denied”。3.3 导入导出应用跨环境迁移的黄金法则应用设计完成后不能直接在生产环境修改必须通过导入导出。导出路径Application Designer→Export Application→ 选择TESTLINE→ 保存为TESTLINE.xml。导入到另一环境如UAT登录UAT环境的Application DesignerImport Application→ 选择TESTLINE.xml勾选Overwrite existing application覆盖同名应用点击Import。血泪经验导入失败常见原因有三① XML中引用的域如TESTLINE_STATUS在目标环境不存在需先导入域② 应用依赖的MBO类如psdi.app.testline.TestLineSet未部署需先编译打包jar并放入$MAXIMO_HOME\applications\maximo\lib③ XML中appnameTESTLINE与目标环境已存在应用名冲突需先在UAT中Delete Application。3.4 常见问题排查界面不显示、按钮无响应、附件上传失败现象原因解决TESTLINE应用打开后表格为空无任何报错Table控件的Data Source未设为TESTLINE或TESTLINEMboSet未在maximo.properties中注册检查maximo.properties是否有mxe.db.object.TESTLINEpsdi.app.testline.TestLineSet无则添加并重启服务器点击Export按钮无反应浏览器控制台无JS错误Pushbutton的Bean Class未指定或指定的BEAN类中exportToExcel()方法未实现Override public void handleEvent()查看$MAXIMO_HOME\applications\maximo\businessobjects\src\psdi\webclient\beans\pushbutton\下对应BEAN确认方法签名和注解正确Attachments控件显示“Upload File”但点击后无文件选择框Attachments控件的Mbo Name填错如填成TEST而非TESTLINE或TESTLINE对象未启用附件功能需在Database Configuration中勾选Allow Attachments进入Database Configuration→ 找到TESTLINE对象 →Attachments标签页 → 勾选Enable Attachments再configdb应用导入后DURATION字段显示为0.0无法编辑字段DURATION的Readonly属性在Application Designer中被勾选或绑定的域Domain设置了Readonly规则在Application Designer中双击DURATION字段 →Properties→ 取消勾选Readonly检查域TESTLINE_DURATION的Default Value是否为0.0若是则清空提示每次修改应用后务必清除浏览器缓存CtrlF5强制刷新并检查Maximo日志$MAXIMO_HOME\logs\maximo.log中是否有ERROR级别报错关键词如NullPointerException、ClassNotFoundException。4. MBO与BEAN开发从字段校验到后台任务的代码实操当标准配置无法满足业务逻辑时如“维修耗时必须大于0且小于24小时”就必须写Java代码。Maximo的扩展开发分两层MBO层Model处理数据规则BEAN层View处理界面交互。二者通过MboSet桥接形成MVC变体。4.1 MBO类TestLine的init()与save()校验TestLine是TESTLINE对象对应的MBO类继承Mbo。核心方法// src/psdi/app/testline/TestLine.java public class TestLine extends Mbo implements TestLineRemote { Override public void init() throws MXException, RemoteException { super.init(); // 初始化时若DURATION为空则设为0.0 if (getDouble(DURATION) 0.0) { setValue(DURATION, 0.0, NOACCESSCHECK); } } Override public void save() throws MXException, RemoteException { super.save(); // 保存前校验DURATION必须0且24 double duration getDouble(DURATION); if (duration 0 || duration 24) { throw new MXApplicationException(testline, DURATION_INVALID, new Object[]{duration}); // 抛出预定义错误需在maximo.ear中配置资源文件 } } }参数说明setValue(DURATION, 0.0, NOACCESSCHECK)中的NOACCESSCHECK跳过权限检查避免初始化时因字段只读而失败MXApplicationException的testline是资源包名DURATION_INVALID是错误码需在$MAXIMO_HOME\applications\maximo\resources\maximoresources.jar中定义对应提示语。4.2 tablebean类TestLineTableBean的按钮事件处理TestLineTableBean继承TableBean处理表格级操作。例如为“批量审核”按钮写逻辑// src/psdi/webclient/benas/testline/TestLineTableBean.java public class TestLineTableBean extends TableBean { Override public int execute() throws MXException, RemoteException { // 重写execute()在表格加载前执行 MboSetRemote testLineSet getMboSet(); testLineSet.setWhere(statusDRAFT); // 只加载草稿状态 return super.execute(); } public void approveSelected() throws MXException, RemoteException { // 获取选中行 MboSetRemote selectedSet getMboSet().getSelection(); for (int i 0; i selectedSet.count(); i) { MboRemote mbo selectedSet.getMbo(i); mbo.setValue(status, APPROVED, NOACCESSCHECK); } // 刷新表格 fireStructureChanged(); } }关键点fireStructureChanged()必须调用否则界面不刷新getSelection()返回的是当前选中行的MboSet副本修改后需显式调用save()框架自动处理。4.3 后台任务TestLineCleanupTask的定时清理需每天凌晨2点清理7天前的草稿明细。后台任务开发三步创建任务类TestLineCleanupTask.javapublic class TestLineCleanupTask implements ScheduleTask { Override public void start(TaskSchedule schedule) throws MXException, RemoteException { // 获取TESTLINE MboSet MboSetRemote testLineSet getMboServer().getMboSet(TESTLINE); // 设置WHERE条件草稿且创建时间早于7天 Calendar cal Calendar.getInstance(); cal.add(Calendar.DAY_OF_YEAR, -7); String where statusDRAFT AND createddate new SimpleDateFormat(yyyy-MM-dd HH:mm:ss).format(cal.getTime()) ; testLineSet.setWhere(where); testLineSet.reset(); // 删除所有匹配记录 while (testLineSet.count() 0) { testLineSet.getMbo(0).delete(); } testLineSet.save(); } }在maximo.properties中注册mxe.scheduler.task.TestLineCleanupTaskpsdi.app.testline.TestLineCleanupTask在Cron Task Setup应用中创建实例Task Name:TESTLINECLEANUPClass Name:TestLineCleanupTaskCron Expression:0 0 2 * * ?每天2点Active: ✓注意Cron Expression格式为秒 分 时 日 月 周 年Maximo不支持年字段填?即可Active必须勾选否则任务不启动。4.4 MBO与BEAN联调避坑数据不同步、方法不触发现象原因解决TestLine的save()方法未执行数据直接入库TestLine类未在maximo.properties中注册或TESTLINE对象的Class字段未指向该类检查maximo.properties是否有mxe.db.object.TESTLINEpsdi.app.testline.TestLine并在Database Configuration中确认TESTLINE对象的Class字段值为此字符串TestLineTableBean的approveSelected()方法抛NullPointerExceptiongetMboSet()返回null因TableBean未正确绑定到TESTLINE数据源在Application Designer中选中Table控件 →Properties→Data Source必须为TESTLINE且TESTLINEMboSet已在maximo.properties中注册后台任务执行后日志显示0 records deleted但数据库中有草稿数据Cron Expression时区错误Maximo默认UTC服务器为CST或createddate字段类型为DATETIME但WHERE条件用了字符串比较改用setQbe()方法testLineSet.setQbe(status, DRAFT); testLineSet.setQbe(createddate, cal.getTime());由框架生成正确SQL提示所有自定义Java类必须编译为.class文件放入$MAXIMO_HOME\applications\maximo\businessobjects\classes并执行buildmaximo.bat/sh重新打包businessobjects.jar最后重启应用服务器。5. 权限与后台任务从数据隔离到自动化运维的闭环权限不是“给用户开个账号”而是构建一张细粒度的访问控制网后台任务也不是“写个定时脚本”而是嵌入Maximo生命周期的可靠服务。二者结合才能实现“某站点人员只能看本站点工单且每日自动归档历史数据”的生产级需求。5.1 权限组与数据限制对象级与属性级的双重锁MAINTENANCE权限组需限制TESTLINE数据对象限制Object Restriction进入Security Groups→MAINTENANCE→Data Restrictions→Add RowObject:TESTLINEWhere Clause:siteid :USERINFO.SITEID动态获取当前用户所在站点。属性限制Attribute Restriction同一页面 →Attribute Restrictions→Add RowObject:TESTLINEAttribute:DURATIONRestriction:READONLY仅查看不可编辑。关键逻辑Where Clause中的:USERINFO.SITEID是Maximo内置变量自动替换为当前用户PERSON记录中的SITEID值。若用户无SITEID如超级管理员该限制不生效符合“管理员全局可见”预期。5.2 后台任务实例化从配置到监控的完整链路TESTLINECLEANUP任务创建后需验证其可靠性手动触发测试进入Cron Task Setup→ 找到TESTLINECLEANUP→Action→Run Now查看$MAXIMO_HOME\logs\maximo.log搜索TESTLINECLEANUP确认有Deleted X records日志。监控任务状态进入Cron Task Status应用筛选Task Name TESTLINECLEANUP关键字段Last Run Time最后执行时间、Next Run Time下次执行时间、StatusACTIVE/INACTIVE。失败告警配置在Cron Task Setup中勾选Send Email on FailureEmail Address: 运维邮箱Failure Threshold:1失败1次即发邮件。血泪经验曾有任务因TestLineCleanupTask中getMboServer()返回null而失败原因是未在构造函数中调用super()。正确写法public class TestLineCleanupTask implements ScheduleTask { private MboServerRemote mboServer; Override public void start(TaskSchedule schedule) throws MXException, RemoteException { this.mboServer schedule.getMboServer(); // 后续用this.mboServer.get...替代getMboServer() } }5.3 权限与任务协同确保自动化不越权后台任务以MAXADMIN身份运行不受用户权限组限制。这意味着TESTLINECLEANUP能删除所有草稿无论siteid为何值。若需按站点清理必须在任务代码中显式加入权限判断public void start(TaskSchedule schedule) throws MXException, RemoteException { MboServerRemote mboServer schedule.getMboServer(); // 获取所有活跃站点 MboSetRemote siteSet mboServer.getMboSet(SITE); siteSet.setWhere(statusACTIVE); siteSet.reset(); for (int i 0; i siteSet.count(); i) { MboRemote site siteSet.getMbo(i); String siteId site.getString(SITEID); // 为每个站点清理其草稿 MboSetRemote testLineSet mboServer.getMboSet(TESTLINE); testLineSet.setWhere(siteid siteId AND statusDRAFT AND createddate cal.getTime() ); testLineSet.reset(); // ... 删除逻辑 } }为什么必须这样写因为Where Clause中的:USERINFO.SITEID在后台任务中无意义无用户上下文必须硬编码或动态枚举站点。5.4 生产环境终极检查清单在将TESTLINE方案上线前我强制自己走一遍以下10步少一步都可能引发P1故障步骤操作验证方式不通过后果1TESTLINE对象configdb成功数据库中TESTLINE表存在且含DURATION字段SELECT * FROM TESTLINE WHERE ROWNUM1应用打开即报错MboSet not found2TESTLINEMboSet在maximo.properties中注册检查文件是否存在mxe.db.object.TESTLINE行自定义MBO逻辑不执行3TESTLINE应用在Application Designer中导出为XML文件大小1KB且含appnameTESTLINE/appname跨环境迁移失败4TESTLINE应用导入UAT后能正常打开并显示表格浏览器无JS错误表格有数据界面白屏5DURATION字段在应用中可编辑、可保存输入5.5→ 保存 → 刷新后仍显示5.5业务数据无法录入6MAINTENANCE组成员登录后TESTLINE表格只显示本站点数据创建两条TESTLINE记录siteid分别为SITEA和SITEB用SITEA用户登录只看到一条数据泄露风险7TESTLINECLEANUP任务手动触发后日志显示删除记录数grep TESTLINECLEANUP maximo.log | tail -5历史数据堆积磁盘爆满8TESTLINE应用的Export按钮点击后生成Excel文件下载文件用Excel打开内容与表格一致用户投诉“导出功能失效”9Attachments控件上传文件后在Document应用中可查到进入Documents→Find Documents→Owner TESTLINE维修证据无法追溯10所有自定义Java类编译无警告buildmaximo成功$MAXIMO_HOME\applications\maximo\businessobjects\classes\psdi\app\testline\TestLine.class存在服务器启动失败从那以后我每次上线新功能都强制走一遍这10步——不是信不过自己写的代码而是信不过那个以为“这次肯定没问题”的自己。希望帮到你。本文还有配套的精品资源点击获取
阅读完成 · 觉得有帮助？
