sks-maximo-utils 1.1.6 → 1.1.8

package/README.md

@@ -14,7 +14,7 @@ Maximo 表结构和数据更新工具集。
 
 ### 全局安装（CLI 使用）
 ```bash
-npm install -g shoukaiseki-maximo-utils
+npm install -g sks-maximo-utils
 ```
 
 ### 项目中安装（引用使用）
@@ -26,18 +26,39 @@ npm install sks-maximo-utils
 
 ### CLI 命令
 
-不带参数运行，打开配置目录：
+不带参数运行，检查配置并打开配置目录：
 ```bash
 sks-maximo
 ```
 
-带参数运行，加载指定环境配置：
+导入命令通用格式：
+
+```bash
+sks-maximo <import-command> <fileName> [env] [--logname <name>]
+```
+
+环境既可以用位置参数，也可以用 `-e` / `--env` 指定，两者等价：
+
 ```bash
-sks-maximo local    # 使用 local 环境配置
-sks-maximo dev      # 使用 dev 环境配置
-sks-maximo hd       # 使用 hd 环境配置
+sks-maximo import-presentation LIBRARY_EN.xml prod_en
+sks-maximo import-presentation LIBRARY_EN.xml -e prod_en
 ```
 
+导入命令：
+
+| 命令 | 说明 |
+|------|------|
+| `sks-maximo import-object <fileName>` | 导入 Maximo 对象配置 |
+| `sks-maximo import-appinfo <fileName>` | 导入应用信息配置 |
+| `sks-maximo import-presentation <fileName>` | 导入应用 XML 配置 |
+| `sks-maximo import-script <fileName>` | 导入自动化脚本 |
+| `sks-maximo import-domain <fileName>` | 导入域配置 |
+| `sks-maximo import-maxintobject <fileName>` | 导入对象结构（Integration Object）配置 |
+
+环境名必须是 `~/.sks/nodeutils/config.json` 中 `envs` 下已存在的键（例如 `local`、`dev`、`dev_en`、`prod`、`prod_en`、`hd`）。请求会自动追加 `_langcode` 参数，取该环境配置的 `langcode`；环境未配置时取全局 `langcode`（默认 `zh`）。因此做英文数据导入时，要传入配置了 `"langcode": "en"` 的环境，例如 `prod_en`。
+
+所有导入命令都支持 `-l` / `--logname <name>` 自定义日志前缀。
+
 ### 在脚本中引用
 
 ```javascript
@@ -128,17 +149,25 @@ fileUtils.readFileContent('test.txt');
       "authType": "apiKey",
       "langcode": "zh"
     },
-    "dev": {
-      "baseUrl": "https://mdev/maximo",
+    "prod": {
+      "baseUrl": "https://main.manage.prod.example.com/maximo",
+      "apiKey": "your-api-key",
+      "maxauth": "",
+      "authType": "apiKey"
+    },
+    "prod_en": {
+      "baseUrl": "https://main.manage.prod.example.com/maximo",
       "apiKey": "your-api-key",
       "maxauth": "",
       "authType": "apiKey",
-      "langcode": "zh"
+      "langcode": "en"
     }
   }
 }
 ```
 
+`envs` 下的键就是环境名，可自行命名（如 `loc`、`dev`、`dev_en`、`prod`、`prod_en`、`hd`）。同一个 Maximo 服务可以配置多个环境名，仅 `langcode` 不同，用于分别导入中文/英文数据。
+
 ### 配置说明
 
 | 字段 | 说明 |

package/cli.js

@@ -13,10 +13,12 @@ const args = process.argv.slice(2);
 
 // 解析全局选项（--env）
 let globalEnv = 'local';
+let envSpecified = false;
 const filteredArgs = [];
 for (let i = 0; i < args.length; i++) {
   if (args[i] === '--env' || args[i] === '-e') {
     globalEnv = args[i + 1];
+    envSpecified = true;
     i++; // 跳过值
   } else {
     filteredArgs.push(args[i]);
@@ -24,7 +26,15 @@ for (let i = 0; i < args.length; i++) {
 }
 
 const cmd = filteredArgs[0];
-const env = filteredArgs[0];
+
+// 兼容位置参数写法：sks-maximo import-xxx <fileName> <env>
+const importCommands = ['import-object', 'import-appinfo', 'import-presentation', 'import-script', 'import-domain', 'import-maxintobject'];
+if (!envSpecified && importCommands.includes(cmd)) {
+  const positionalEnv = filteredArgs[2];
+  if (positionalEnv && !positionalEnv.startsWith('-')) {
+    globalEnv = positionalEnv;
+  }
+}
 
 if (!cmd || ['-h', '--help', '-?', '--version', '-v'].includes(cmd)) {
   console.log(`sks-maximo v${packageJson.version}`);
@@ -57,7 +67,7 @@ if (!cmd || ['-h', '--help', '-?', '--version', '-v'].includes(cmd)) {
   console.log('选项:');
   console.log('  -h, --help              # 显示帮助信息');
   console.log('  -v, --version           # 显示版本信息');
-  console.log('  --env, -e <env>         # 指定环境（默认 local）');
+  console.log('  --env, -e <env>         # 指定环境（直接输入sks-maximo 可进行打开配置目录）');
   console.log('  --file <fileName>       # 请求体文件路径（JSON）');
   console.log('  --params <params>       # URL参数（JSON格式）');
   console.log('');

package/nodeutils/config.js

@@ -1,8 +1,8 @@
-import fs from 'fs';
-import os from 'os';
-import path from 'path';
-import { fileURLToPath } from 'url';
-import logger from './logger.js';
+import fs from "fs";
+import os from "os";
+import path from "path";
+import { fileURLToPath } from "url";
+import logger from "./logger.js";
 
 // 获取当前模块目录
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
@@ -11,7 +11,7 @@ let globalConfig = null;
 
 function getConfigPath() {
   const homeDir = os.homedir();
-  return path.join(homeDir, '.sks', 'nodeutils', 'config.json');
+  return path.join(homeDir, ".sks", "nodeutils", "config.json");
 }
 
 export function getConfigDir() {
@@ -39,7 +39,7 @@ export function loadConfig(env = null) {
 
   if (!env) {
     const args = process.argv.slice(2);
-    env = args[0] || 'local';
+    env = args[0];
   }
 
   try {
@@ -53,16 +53,22 @@ export function loadConfig(env = null) {
       copySampleConfig(configPath);
     }
 
-    const configData = fs.readFileSync(configPath, 'utf-8');
+    const configData = fs.readFileSync(configPath, "utf-8");
     const allConfigs = JSON.parse(configData);
+    if (!env) {
+      env = allConfigs.defaultEnv;
+    }
+    if(!env){
+      throw new Error(`未找到环境 ${env} 的配置`);
+    }
 
     // 获取全局配置
-    const globalLogLevel = allConfigs.logLevel || 'INFO';
+    const globalLogLevel = allConfigs.logLevel || "INFO";
     // console.log("globalLogLevel:"+ globalLogLevel);
 
     // 获取环境配置
     const envs = allConfigs.envs || {};
-    const envConfig = envs[env] || envs.local || envs.dev;
+    const envConfig = envs[env] ;
 
     if (!envConfig) {
       throw new Error(`未找到环境 ${env} 的配置`);
@@ -73,21 +79,21 @@ export function loadConfig(env = null) {
 
     // 设置默认 authType
     if (!globalConfig.authType) {
-      globalConfig.authType = 'apiKey';
+      globalConfig.authType = "apiKey";
     }
 
     // logLevel 优先使用环境配置，否则使用全局配置
     const logLevel = envConfig.logLevel || globalLogLevel;
-    
+
     // langcode 优先使用环境配置，否则使用全局配置，默认 zh
-    const langcode = envConfig.langcode || allConfigs.langcode || 'zh';
+    const langcode = envConfig.langcode || allConfigs.langcode || "zh";
     globalConfig.langcode = langcode;
 
     // 规范化 baseUrl
     if (globalConfig.baseUrl) {
-      globalConfig.baseUrl = globalConfig.baseUrl.replace(/\\/g, '/');
-      if (!globalConfig.baseUrl.endsWith('/')) {
-        globalConfig.baseUrl += '/';
+      globalConfig.baseUrl = globalConfig.baseUrl.replace(/\\/g, "/");
+      if (!globalConfig.baseUrl.endsWith("/")) {
+        globalConfig.baseUrl += "/";
       }
     }
 
@@ -102,7 +108,7 @@ export function loadConfig(env = null) {
 }
 
 function copySampleConfig(configPath) {
-  const sampleConfigPath = path.join(__dirname, 'sample.config.json');
+  const sampleConfigPath = path.join(__dirname, "sample.config.json");
 
   const configDir = path.dirname(configPath);
   if (!fs.existsSync(configDir)) {
@@ -115,30 +121,35 @@ function copySampleConfig(configPath) {
   } else {
     // 如果 sample.config.json 不存在，创建默认配置
     const defaultConfig = {
-      "logLevel": "INFO",
-      "langcode": "zh",
-      "envs": {
-        "local": {
-          "baseUrl": "http://127.0.0.1:9080/maximo",
-          "langcode": "zh",
-          "apiKey": "your-api-key-here",
-          "maxauth": ""
+      logLevel: "INFO",
+      langcode: "zh",
+      defaultEnv: "local",
+      envs: {
+        local: {
+          baseUrl: "http://127.0.0.1:9080/maximo",
+          langcode: "zh",
+          apiKey: "your-api-key-here",
+          maxauth: "",
         },
-        "dev": {
-          "baseUrl": "https://mdev/maximo",
-          "langcode": "zh",
-          "apiKey": "your-api-key-here",
-          "maxauth": ""
+        dev: {
+          baseUrl: "https://mdev/maximo",
+          langcode: "zh",
+          apiKey: "your-api-key-here",
+          maxauth: "",
         },
-        "hd": {
-          "baseUrl": "http://xxxxx:9080/maximo",
-          "langcode": "zh",
-          "apiKey": "your-api-key-here",
-          "maxauth": ""
-        }
-      }
+        hd: {
+          baseUrl: "http://xxxxx:9080/maximo",
+          langcode: "zh",
+          apiKey: "your-api-key-here",
+          maxauth: "",
+        },
+      },
     };
-    fs.writeFileSync(configPath, JSON.stringify(defaultConfig, null, 2), 'utf-8');
+    fs.writeFileSync(
+      configPath,
+      JSON.stringify(defaultConfig, null, 2),
+      "utf-8",
+    );
     logger.info(`[Config] 已创建默认配置文件: ${configPath}`);
   }
 }
@@ -159,5 +170,5 @@ export default {
   getConfig,
   getWorkDir,
   getConfigDir,
-  checkAndCreateConfig
-};
+  checkAndCreateConfig,
+};

package/nodeutils/maximoTools.js

@@ -500,7 +500,10 @@ export async function importMaxScript({fileName, logname}) {
         
         var headers={};
         if (scriptExists && scriptHref) {
-            deployUrl = scriptHref;
+            // Maximo 的资源 ID 是标准 base64 且把填充位 = 替换为 -（如 ...Uw== → ...Uw--），
+            // 不能用 base64url（直接去掉填充会导致服务端找不到资源而返回 404）。
+            const scriptId = Buffer.from(autoscript).toString('base64').replace(/=+$/, m => '-'.repeat(m.length));
+            deployUrl = `api/os/MXSCRIPT/_${scriptId}`;
             deployMethod = 'POST';
             headers =  {
                 'Content-Type': 'application/merge-patch+json',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sks-maximo-utils",
-  "version": "1.1.6",
+  "version": "1.1.8",
   "description": "Maximo helper tools for updating table structures and data",
   "type": "module",
   "main": "index.js",