IBM Maximo REST API能否在现有域中新增值以同步GIS与Maximo？

可行性确认 #

该操作完全可行，只要配置正确的对象结构与请求参数，就能实现通过REST API向Maximo现有域中新增或更新值。

前置检查项 #

• 确保使用的对象结构（如MXAPIDOMAIN或自定义结构）已启用创建/更新权限
• 确认操作用户拥有DOMAIN对象的读写权限
• 请求需携带有效的Maximo认证信息（如Basic Auth或API密钥）

ALNDOMAIN新增/更新Postman请求示例 #

请求配置 #

• 请求方法: POST
• 请求URL: http://<maximo-host>/maximo/oslc/os/MXAPIDOMAIN（使用系统默认对象结构）
• Headers:
  • Content-Type: application/json
  • oslc-Core-Version: 2.0
  • Accept: application/json

请求体（JSON） #

{
  "spi:domainid": "YOUR_ALN_DOMAIN_ID",
  "spi:description": "文本域描述",
  "spi:alndomain": [
    {
      "spi:value": "NEW_GIS_VALUE_1",
      "spi:description": "GIS同步值描述1",
      "spi:sequence": 10,
      "spi:defaultvalue": false
    },
    {
      "spi:value": "NEW_GIS_VALUE_2",
      "spi:description": "GIS同步值描述2",
      "spi:sequence": 20,
      "spi:defaultvalue": true
    }
  ]
}

注：若更新已有域值，只需在alndomain数组中保留目标值的value字段，Maximo会自动匹配更新；仅新增时直接添加新条目即可。

NUMERICDOMAIN新增/更新Postman请求示例 #

请求配置 #

• 请求方法: POST
• 请求URL: http://<maximo-host>/maximo/oslc/os/MXAPIDOMAIN
• Headers: 同ALNDOMAIN配置

请求体（JSON） #

{
  "spi:domainid": "YOUR_NUMERIC_DOMAIN_ID",
  "spi:description": "数值域描述",
  "spi:numericdomain": [
    {
      "spi:value": 150,
      "spi:description": "GIS同步数值1",
      "spi:sequence": 10,
      "spi:defaultvalue": false
    },
    {
      "spi:value": 250,
      "spi:description": "GIS同步数值2",
      "spi:sequence": 20,
      "spi:defaultvalue": true
    }
  ]
}

注：数值域的value字段必须为数字类型，不可用字符串；更新时需确保value与现有数值完全匹配。

常见失败排查 #

• 检查对象结构是否包含ALNDOMAIN/NUMERICDOMAIN子对象，且已启用写权限
• 确认请求体中的命名空间前缀（如spi:）与GET请求返回的结构一致
• 查看Maximo系统日志（maximo.log），定位具体错误（如字段校验失败、权限不足）

内容的提问来源于stack exchange，提问作者PLynn