n8n-nodes-excel-api 1.0.2 → 1.0.3

package/README.md

@@ -589,6 +589,27 @@ range: "A1:D100"
 
 ## 🆕 Latest Features
 
+### 🎉 Automatic Type Conversion (v1.0.3)
+- ✅ **Smart Type Detection**: Automatically convert strings to appropriate data types
+- ✅ **Number Conversion**: `"123"` → `123`, `"45.67"` → `45.67`
+- ✅ **Boolean Conversion**: `"true"` → `true`, `"false"` → `false`
+- ✅ **Null Conversion**: `"null"` or empty string → `null`
+- ✅ **Date Conversion**: ISO format date strings auto-convert (`"2024-01-15"`)
+- ✅ **Preserve Typed Values**: Numbers, booleans, etc. remain unchanged
+- ✅ **All Operations**: Supported in both Append and Update operations
+
+**Example:**
+```json
+{
+  "EmployeeID": "E001",      // Remains string
+  "Age": "30",               // Auto-converts to number 30
+  "Salary": "50000.50",     // Auto-converts to 50000.50
+  "IsActive": "true",        // Auto-converts to boolean true
+  "TerminationDate": "null", // Auto-converts to null
+  "HireDate": "2020-01-15"   // Auto-converts to date format
+}
+```
+
 ### Object Mode
 - ✅ Uses `/api/excel/append_object` API
 - ✅ Automatically reads Excel headers (first row)

package/dist/nodes/ExcelApi/ExcelApi.node.js

@@ -2,6 +2,73 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ExcelApi = void 0;
 const n8n_workflow_1 = require("n8n-workflow");
+/**
+ * 自動轉換欄位值的型態
+ * 支援：數字、布林值、日期、null
+ */
+function convertValueType(value) {
+    // 如果已經是 null、undefined，直接返回
+    if (value === null || value === undefined) {
+        return null;
+    }
+    // 如果不是字串，保持原樣
+    if (typeof value !== 'string') {
+        return value;
+    }
+    // 處理空字串
+    if (value.trim() === '') {
+        return null;
+    }
+    // 處理 "null" 字串
+    if (value.toLowerCase() === 'null') {
+        return null;
+    }
+    // 處理布林值
+    if (value.toLowerCase() === 'true') {
+        return true;
+    }
+    if (value.toLowerCase() === 'false') {
+        return false;
+    }
+    // 處理數字（整數和浮點數）
+    // 使用正則表達式確保是有效的數字格式
+    if (/^-?\d+(\.\d+)?$/.test(value.trim())) {
+        const num = Number(value);
+        if (!isNaN(num)) {
+            return num;
+        }
+    }
+    // 處理 ISO 日期格式
+    // 格式如：2024-01-15 或 2024-01-15T10:30:00 或 2024-01-15T10:30:00.000Z
+    if (/^\d{4}-\d{2}-\d{2}(T\d{2}:\d{2}:\d{2}(\.\d{3}Z?)?)?$/.test(value.trim())) {
+        const date = new Date(value);
+        if (!isNaN(date.getTime())) {
+            // 返回 ISO 字串格式，Excel API Server 會處理
+            return date.toISOString();
+        }
+    }
+    // 其他情況保持原字串
+    return value;
+}
+/**
+ * 遞迴轉換物件或陣列中的所有值
+ */
+function convertObjectValues(obj) {
+    if (obj === null || obj === undefined) {
+        return obj;
+    }
+    if (Array.isArray(obj)) {
+        return obj.map(item => convertValueType(item));
+    }
+    if (typeof obj === 'object') {
+        const converted = {};
+        for (const [key, value] of Object.entries(obj)) {
+            converted[key] = convertValueType(value);
+        }
+        return converted;
+    }
+    return convertValueType(obj);
+}
 class ExcelApi {
     constructor() {
         this.description = {
@@ -374,6 +441,8 @@ class ExcelApi {
                     else {
                         appendValues = appendValuesRaw;
                     }
+                    // 自動轉換值的型態
+                    const convertedValues = convertObjectValues(appendValues);
                     // Use different API endpoint based on append mode
                     if (appendMode === 'object') {
                         // Object Mode: Use append_object API
@@ -387,7 +456,7 @@ class ExcelApi {
                             body: {
                                 file: fileName,
                                 sheet: sheetName,
-                                values: appendValues,
+                                values: convertedValues,
                             },
                             json: true,
                         });
@@ -404,7 +473,7 @@ class ExcelApi {
                             body: {
                                 file: fileName,
                                 sheet: sheetName,
-                                values: appendValues,
+                                values: convertedValues,
                             },
                             json: true,
                         });
@@ -463,11 +532,13 @@ class ExcelApi {
                     else {
                         valuesToSet = valuesToSetRaw;
                     }
+                    // 自動轉換值的型態
+                    const convertedValuesToSet = convertObjectValues(valuesToSet);
                     // Build request body
                     const requestBody = {
                         file: fileName,
                         sheet: sheetName,
-                        values_to_set: valuesToSet,
+                        values_to_set: convertedValuesToSet,
                     };
                     if (identifyBy === 'rowNumber') {
                         const rowNumber = this.getNodeParameter('rowNumber', i);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "n8n-nodes-excel-api",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "n8n node for accessing Excel files via API with concurrent safety",
   "keywords": [
     "n8n-community-node-package",