SKS Maximo Utils

Maximo 表结构和数据更新工具集。

安装

全局安装（CLI 使用）

npm install -g shoukaiseki-maximo-utils

项目中安装（引用使用）

npm install sks-maximo-utils

使用方式

CLI 命令

不带参数运行，打开配置目录：

sks-maximo

带参数运行，加载指定环境配置：

sks-maximo local    # 使用 local 环境配置
sks-maximo dev      # 使用 dev 环境配置
sks-maximo hd       # 使用 hd 环境配置

在脚本中引用

import { 
  importMaxObject, 
  importMaxPresentation, 
  importMaxDomain,
  importMaxAutoKey,
  importMaxScript,
  importMaxAppInfo,
  loadConfig,
  logger
} from 'shoukaiseki-maximo-utils';

// 加载配置（可选，默认 local）
loadConfig('local');

// 导入 Maximo 对象配置
importMaxObject({ fileName: "DBCONFIGJSON/test.json", logname: "测试" });

// 导入应用 XML 配置
importMaxPresentation({ fileName: "SCREENSXML/test.xml", logname: "应用" });

// 导入域配置
importMaxDomain({ fileName: "DBDOMAINJSON/domain.json", logname: "域" });

// 导入 AutoKey 配置
importMaxAutoKey({ fileName: "AUTOKEYJSON/autokey.json", logname: "自动编码" });

// 导入自动化脚本（自动保存历史记录）
// fileName为JSON配置文件，同目录下需有同名.js文件
// 例如：scripts/TEST.json 和 scripts/TEST.js
importMaxScript({ fileName: "scripts/TEST.json" });

// 导入应用信息配置
importMaxAppInfo({ fileName: "MAXAPPINFO/appinfo.json", logname: "应用信息" });

配置文件

首次运行时，会自动在 ~/.sks/nodeutils/ 目录创建 config.json 配置文件。

配置结构：

{
  "logLevel": "INFO",
  "langcode": "zh",
  "envs": {
    "local": {
      "baseUrl": "http://127.0.0.1:9080/maximo",
      "apiKey": "your-api-key",
      "maxauth": "",
      "authType": "apiKey",
      "langcode": "zh"
    },
    "dev": {
      "baseUrl": "https://mdev/maximo",
      "apiKey": "your-api-key",
      "maxauth": "",
      "authType": "apiKey",
      "langcode": "zh"
    }
  }
}

配置说明

| 字段 | 说明 | |------|------| | logLevel | 全局日志级别：TRACE, DEBUG, INFO, WARN, ERROR, FATAL | | langcode | 全局语言代码，默认 zh | | baseUrl | Maximo 服务地址 | | apiKey | API 认证密钥 | | maxauth | Maxauth 认证值 | | authType | 认证类型：apiKey 或 maxauth |

环境配置中可单独设置 logLevel 和 langcode，优先级高于全局配置。

API

导入方法

| 方法 | 说明 | |------|------| | importMaxObject | 导入 Maximo 对象配置（JSON） | | importMaxPresentation | 导入应用 XML 配置 | | importMaxDomain | 导入域配置 | | importMaxAutoKey | 导入 AutoKey 配置 | | importMaxScript | 导入自动化脚本（自动保存历史记录） | | importMaxAppInfo | 导入应用信息配置 |

其他方法

| 方法 | 说明 | |------|------| | loadConfig(env) | 加载指定环境配置 | | saveScriptHistory(options) | 保存脚本历史记录 | | readFileContent(fileName) | 读取文件内容 | | readJsonFile(fileName) | 读取并解析 JSON 文件 | | fileExists(fileName) | 检查文件是否存在 |

日志文件

请求和响应日志会自动保存到 ~/.sks/nodeutils/logs/ 目录：

• request-*.http - 请求日志（IntelliJ IDEA HTTP Client 格式）
• response-*.json - 响应日志

开发

# 安装依赖
npm install

# 本地链接（测试）
npm link

# 在其他项目中链接测试
npm link sks-maximo-utils

License

ISC