n8n-nodes-excel-api 1.0.2 → 1.0.4

package/README.md

@@ -22,7 +22,6 @@ This node works with [Excel API Server](https://github.com/code4Copilot/excel-ap
 - ✅ **Data Integrity** - No data loss or corruption
 - ✅ **Multi-User Support** - Perfect for multi-user HTML form submissions
 - ✅ **Google Sheets-like Interface** - Familiar operations in n8n
-- ✅ **Batch Operations** - Efficient bulk updates
 
 ## 📦 Installation
 
@@ -152,39 +151,17 @@ Read data from Excel file.
 - Return raw data array if no headers
 
 ### 3. Update
-Update existing row data.
-
-**Identify Methods:**
-
-#### By Row Number
-Directly specify row number to update (starts from 2, row 1 is header).
-
-**Example:**
-```json
-{
-  "operation": "update",
-  "identifyBy": "rowNumber",
-  "rowNumber": 5,
-  "valuesToSet": {
-    "Status": "Completed",
-    "Update Date": "2025-12-21"
-  }
-}
-```
-
-#### By Lookup
-Find rows to update by looking up specific column values.
+Update existing row data by looking up specific column values.
 
 **Process Modes:**
 
-##### All Matching Records - Default
-Update all matching rows, suitable for batch update scenarios.
+#### All Matching Records - Default
+Update all matching rows, suitable for scenarios where multiple rows share the same value.
 
 **Example: Update all IT department employees**
 ```json
 {
   "operation": "update",
-  "identifyBy": "lookup",
   "lookupColumn": "Department",
   "lookupValue": "IT",
   "processMode": "all",
@@ -195,14 +172,13 @@ Update all matching rows, suitable for batch update scenarios.
 }
 ```
 
-##### First Match Only
+#### First Match Only
 Update only the first matching record, suitable for unique identifier lookups.
 
 **Example: Update specific employee data**
 ```json
 {
   "operation": "update",
-  "identifyBy": "lookup",
   "lookupColumn": "Employee ID",
   "lookupValue": "E100",
   "processMode": "first",
@@ -215,50 +191,34 @@ Update only the first matching record, suitable for unique identifier lookups.
 
 **💡 Usage Tips:**
 - When looking up by unique identifiers (Employee ID, Email), use `processMode: "first"` for better performance
-- Use `processMode: "all"` when batch updating multiple records
+- Use `processMode: "all"` when updating multiple records that share the same value
 - Default is `"all"` to ensure no matching records are missed
 
 ### 4. Delete
-Delete a row from the sheet.
-
-**Identify Methods:**
-
-#### By Row Number
-```json
-{
-  "operation": "delete",
-  "identifyBy": "rowNumber",
-  "rowNumber": 5
-}
-```
-
-#### By Lookup
-Find rows to delete by looking up specific column values.
+Delete rows from the sheet by looking up specific column values.
 
 **Process Modes:**
 
-##### All Matching Records - Default
+#### All Matching Records - Default
 Delete all matching rows.
 
 **Example: Delete all terminated employees**
 ```json
 {
   "operation": "delete",
-  "identifyBy": "lookup",
   "lookupColumn": "Status",
   "lookupValue": "Terminated",
   "processMode": "all"
 }
 ```
 
-##### First Match Only
+#### First Match Only
 Delete only the first matching record.
 
 **Example: Delete specific employee**
 ```json
 {
   "operation": "delete",
-  "identifyBy": "lookup",
   "lookupColumn": "Employee ID",
   "lookupValue": "E100",
   "processMode": "first"
@@ -268,31 +228,7 @@ Delete only the first matching record.
 **⚠️ Important:**
 - Delete operations cannot be undone, use with caution
 - When looking up by unique identifiers, use `processMode: "first"`
-- Verify lookup conditions carefully when batch deleting to avoid accidental data loss
-
-### 5. Batch
-Execute multiple operations at once (more efficient).
-
-**Example:**
-```json
-{
-  "operations": [
-    {
-      "type": "append",
-      "values": ["E010", "Alice", "Marketing", "Specialist", "65000"]
-    },
-    {
-      "type": "update",
-      "row": 5,
-      "values": ["E005", "Updated Name", "IT", "Manager", "90000"]
-    },
-    {
-      "type": "delete",
-      "row": 10
-    }
-  ]
-}
-```
+- Verify lookup conditions carefully to avoid accidental data loss
 
 ## 🎨 Usage Examples
 
@@ -372,23 +308,7 @@ document.getElementById('registrationForm').addEventListener('submit', async (e)
 └──────────────────┘
 ```
 
-### Example 3: Batch Updates
-
-```
-┌──────────────────┐
-│ Code             │  Prepare operations array
-│                  │  operations = [...]
-└────────┬─────────┘
-         │
-         ▼
-┌──────────────────┐
-│ Excel API        │  Operation: Batch
-│ (Batch)          │  File: data.xlsx
-│                  │  Operations: {{ $json.operations }}
-└──────────────────┘
-```
-
-### Example 4: Update Salary by Employee ID
+### Example 3: Update Salary by Employee ID
 
 ```
 ┌──────────────────┐
@@ -412,7 +332,7 @@ document.getElementById('registrationForm').addEventListener('submit', async (e)
 └──────────────────┘
 ```
 
-### Example 5: Batch Department Status Update
+### Example 4: Batch Department Status Update
 
 **Use Case:** Review all employees in a department at once
 
@@ -442,7 +362,7 @@ document.getElementById('registrationForm').addEventListener('submit', async (e)
 └──────────────────┘
 ```
 
-### Example 6: Clean Up Expired Data
+### Example 5: Clean Up Expired Data
 
 **Use Case:** Periodically delete employee records terminated over a year ago
 
@@ -559,21 +479,7 @@ pm2 restart n8n
 
 ## 📊 Performance Optimization Tips
 
-### 1. Use Batch Operations
-```javascript
-// ❌ Bad: Multiple single operations
-for (item of items) {
-  await appendRow(item);
-}
-
-// ✅ Good: One batch operation
-await batchOperations(items.map(item => ({
-  type: "append",
-  values: item.values
-})));
-```
-
-### 2. Specify Range When Reading
+### 1. Specify Range When Reading
 ```javascript
 // ❌ Bad: Read entire file
 range: ""
@@ -582,13 +488,34 @@ range: ""
 range: "A1:D100"
 ```
 
-### 3. Use Efficient Workflows
+### 2. Use Efficient Workflows
 - Combine related operations in one workflow
 - Reduce number of API calls
 - Use caching appropriately
 
 ## 🆕 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)
@@ -597,10 +524,9 @@ range: "A1:D100"
 - ✅ No need to remember column order
 
 ### Advanced Update and Delete
-- ✅ Support operations by row number
 - ✅ Support operations by column value lookup
 - ✅ Can update specific columns without affecting others
-- ✅ Batch processing support with process modes
+- ✅ Process modes: all matching records or first match only
 
 ### Lookup Column Selection
 - ✅ Dynamic dropdown selection of Excel headers

package/dist/nodes/ExcelApi/ExcelApi.node.d.ts

@@ -1,12 +1,16 @@
-import { IExecuteFunctions, ILoadOptionsFunctions, INodeExecutionData, INodePropertyOptions, INodeType, INodeTypeDescription } from 'n8n-workflow';
+import { IExecuteFunctions, ILoadOptionsFunctions, INodeExecutionData, INodeListSearchResult, INodePropertyOptions, INodeType, INodeTypeDescription } from 'n8n-workflow';
 export declare class ExcelApi implements INodeType {
     description: INodeTypeDescription;
     methods: {
         loadOptions: {
-            getExcelFiles(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]>;
             getExcelSheets(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]>;
             getColumnNames(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]>;
         };
+        listSearch: {
+            searchExcelFiles(this: ILoadOptionsFunctions, filter?: string): Promise<INodeListSearchResult>;
+            searchExcelSheets(this: ILoadOptionsFunctions, filter?: string): Promise<INodeListSearchResult>;
+            searchColumnNames(this: ILoadOptionsFunctions, filter?: string): Promise<INodeListSearchResult>;
+        };
     };
     execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;
 }

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

@@ -2,6 +2,76 @@
 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;
+        }
+    }
+    // 處理日期格式
+    // 只有日期（yyyy-MM-dd），直接回傳字串，不附加時間
+    if (/^\d{4}-\d{2}-\d{2}$/.test(value.trim())) {
+        return value.trim();
+    }
+    // 有時間的 ISO 格式（yyyy-MM-ddTHH:mm:ss...），才轉換為 ISO 字串
+    if (/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}/.test(value.trim())) {
+        const date = new Date(value);
+        if (!isNaN(date.getTime())) {
+            return date.toISOString();
+        }
+    }
+    // 其他情況保持原字串
+    return value;
+}
+/**
+ * 遞迴轉換物件或陣列中的所有值
+ */
+function convertObjectValues(obj) {
+    if (obj === null || obj === undefined) {
+        return null;
+    }
+    if (Array.isArray(obj)) {
+        return obj.map(item => convertObjectValues(item));
+    }
+    if (typeof obj === 'object') {
+        const converted = {};
+        for (const [key, value] of Object.entries(obj)) {
+            converted[key] = convertObjectValues(value);
+        }
+        return converted;
+    }
+    return convertValueType(obj);
+}
 class ExcelApi {
     constructor() {
         this.description = {
@@ -34,7 +104,6 @@ class ExcelApi {
                         { name: 'Read', value: 'read', action: 'Read Excel file', description: 'Read data from Excel file' },
                         { name: 'Update', value: 'update', action: 'Update row', description: 'Update an existing row' },
                         { name: 'Delete', value: 'delete', action: 'Delete row', description: 'Delete a row' },
-                        { name: 'Batch', value: 'batch', action: 'Batch operations', description: 'Execute multiple operations at once' },
                     ],
                     default: 'append',
                 },
@@ -42,25 +111,54 @@ class ExcelApi {
                 {
                     displayName: 'File Name',
                     name: 'fileName',
-                    type: 'options',
+                    type: 'resourceLocator',
                     required: true,
-                    typeOptions: {
-                        loadOptionsMethod: 'getExcelFiles',
-                    },
-                    default: '',
+                    default: { mode: 'list', value: '' },
                     description: 'Select an Excel file from the server',
+                    modes: [
+                        {
+                            displayName: 'From List',
+                            name: 'list',
+                            type: 'list',
+                            typeOptions: {
+                                searchListMethod: 'searchExcelFiles',
+                                searchable: true,
+                            },
+                        },
+                        {
+                            displayName: 'By Name',
+                            name: 'name',
+                            type: 'string',
+                            placeholder: 'e.g. report.xlsx',
+                            hint: 'Enter the exact Excel filename',
+                        },
+                    ],
                 },
                 // Sheet selection
                 {
                     displayName: 'Sheet Name',
                     name: 'sheetName',
-                    type: 'options',
-                    typeOptions: {
-                        loadOptionsMethod: 'getExcelSheets',
-                        loadOptionsDependsOn: ['fileName'],
-                    },
-                    default: 'Sheet1',
+                    type: 'resourceLocator',
+                    default: { mode: 'list', value: '' },
                     description: 'Select a worksheet from the file',
+                    modes: [
+                        {
+                            displayName: 'From List',
+                            name: 'list',
+                            type: 'list',
+                            typeOptions: {
+                                searchListMethod: 'searchExcelSheets',
+                                searchable: true,
+                            },
+                        },
+                        {
+                            displayName: 'By Name',
+                            name: 'name',
+                            type: 'string',
+                            placeholder: 'e.g. Sheet1',
+                            hint: 'Enter the exact worksheet name',
+                        },
+                    ],
                 },
                 // Append operation - Mode selection
                 {
@@ -90,10 +188,10 @@ class ExcelApi {
                             appendMode: ['object']
                         }
                     },
-                    default: '{\n  "Column1": "{{ $json.field1 }}",\n  "Column2": "{{ $json.field2 }}"\n}',
+                    default: '{{ JSON.stringify({\n  "Column1": $json["field1"],\n  "Column2": $json["field2"]\n}) }}',
                     required: true,
                     description: 'Object with column names as keys. Column names must match Excel headers exactly.',
-                    hint: 'Example: {"員工編號": "{{ $json.body.employeeId }}", "姓名": "{{ $json.body.name }}"}',
+                    hint: 'Example: {{ JSON.stringify({ "員工編號": $json["employeeId"], "姓名": $json["name"] }) }}',
                 },
                 // Append - Array Mode
                 {
@@ -121,54 +219,38 @@ class ExcelApi {
                     description: 'Cell range to read (e.g., A1:D10). Leave empty to read all data',
                     placeholder: 'A1:D10',
                 },
-                // Update & Delete: Row Identification Method
-                {
-                    displayName: 'Identify Row By',
-                    name: 'identifyBy',
-                    type: 'options',
-                    displayOptions: { show: { operation: ['update', 'delete'] } },
-                    options: [
-                        { name: 'Row Number', value: 'rowNumber', description: 'Specify the exact row number' },
-                        { name: 'Lookup', value: 'lookup', description: 'Find row by matching a column value' },
-                    ],
-                    default: 'rowNumber',
-                    description: 'How to identify the row to update/delete',
-                },
-                // Row Number (for direct specification)
-                {
-                    displayName: 'Row Number',
-                    name: 'rowNumber',
-                    type: 'number',
-                    displayOptions: {
-                        show: {
-                            operation: ['update', 'delete'],
-                            identifyBy: ['rowNumber']
-                        }
-                    },
-                    required: true,
-                    default: 2,
-                    description: 'Row number to update/delete (1-based, row 1 is header)',
-                    hint: '⚠️ Row 1 is protected (header row). Data rows start from row 2.',
-                },
-                // ✨ NEW: Lookup Column - 改為下拉選單
+                // Lookup Column
                 {
                     displayName: 'Lookup Column',
                     name: 'lookupColumn',
-                    type: 'options',
-                    typeOptions: {
-                        loadOptionsMethod: 'getColumnNames',
-                        loadOptionsDependsOn: ['fileName', 'sheetName'],
-                    },
+                    type: 'resourceLocator',
+                    default: { mode: 'list', value: '' },
                     displayOptions: {
                         show: {
                             operation: ['update', 'delete'],
-                            identifyBy: ['lookup']
                         }
                     },
                     required: true,
-                    default: '',
                     description: 'Column name to search in (automatically loaded from Excel headers)',
                     hint: '💡 The list shows all column names from the first row of your Excel file',
+                    modes: [
+                        {
+                            displayName: 'From List',
+                            name: 'list',
+                            type: 'list',
+                            typeOptions: {
+                                searchListMethod: 'searchColumnNames',
+                                searchable: true,
+                            },
+                        },
+                        {
+                            displayName: 'By Name',
+                            name: 'name',
+                            type: 'string',
+                            placeholder: 'e.g. EmployeeID',
+                            hint: 'Enter the exact column name from the first row of your Excel file',
+                        },
+                    ],
                 },
                 // Lookup Value (for lookup method)
                 {
@@ -178,7 +260,6 @@ class ExcelApi {
                     displayOptions: {
                         show: {
                             operation: ['update', 'delete'],
-                            identifyBy: ['lookup']
                         }
                     },
                     required: true,
@@ -195,7 +276,6 @@ class ExcelApi {
                     displayOptions: {
                         show: {
                             operation: ['update', 'delete'],
-                            identifyBy: ['lookup']
                         }
                     },
                     options: [
@@ -223,60 +303,15 @@ class ExcelApi {
                     default: '{\n  "Status": "Done",\n  "UpdatedDate": "2024-01-01"\n}',
                     required: true,
                     description: 'Object with column names as keys and new values',
-                    hint: 'Example: {"Status": "{{ $json.status }}", "Salary": {{ $json.salary }}}',
-                },
-                // Batch operation
-                {
-                    displayName: 'Operations',
-                    name: 'batchOperations',
-                    type: 'json',
-                    displayOptions: { show: { operation: ['batch'] } },
-                    default: `[
-  {
-    "type": "append",
-    "values": ["value1", "value2"]
-  },
-  {
-    "type": "update",
-    "row": 5,
-    "values": ["new1", "new2"]
-  }
-]`,
-                    required: true,
-                    description: 'Array of operations to execute',
-                    hint: 'Each operation should have "type" (append/update/delete) and related fields',
+                    hint: 'Example: {{ JSON.stringify({ "Status": $json["status"], "Salary": $json["salary"] }) }}'
                 },
             ],
         };
         this.methods = {
             loadOptions: {
-                async getExcelFiles() {
-                    const credentials = await this.getCredentials('excelApiAuth');
-                    const apiUrl = credentials.url;
-                    const apiToken = credentials.token;
-                    try {
-                        const response = await this.helpers.request({
-                            method: 'GET',
-                            url: `${apiUrl}/api/excel/files`,
-                            headers: {
-                                'Authorization': `Bearer ${apiToken}`,
-                            },
-                            json: true,
-                        });
-                        if (response.success && response.files) {
-                            return response.files.map((file) => ({
-                                name: file,
-                                value: file,
-                            }));
-                        }
-                        return [];
-                    }
-                    catch (error) {
-                        return [];
-                    }
-                },
                 async getExcelSheets() {
-                    const fileName = this.getNodeParameter('fileName');
+                    const fileNameRaw = this.getNodeParameter('fileName');
+                    const fileName = (fileNameRaw && typeof fileNameRaw === 'object' ? fileNameRaw.value : fileNameRaw);
                     if (!fileName) {
                         return [];
                     }
@@ -306,8 +341,10 @@ class ExcelApi {
                 },
                 // ✨ NEW: 獲取欄位名稱（表頭）
                 async getColumnNames() {
-                    const fileName = this.getNodeParameter('fileName');
-                    const sheetName = this.getNodeParameter('sheetName');
+                    const fileNameRaw = this.getNodeParameter('fileName');
+                    const fileName = (fileNameRaw && typeof fileNameRaw === 'object' ? fileNameRaw.value : fileNameRaw);
+                    const sheetNameRaw = this.getNodeParameter('sheetName');
+                    const sheetName = (sheetNameRaw && typeof sheetNameRaw === 'object' ? sheetNameRaw.value : sheetNameRaw);
                     if (!fileName || !sheetName) {
                         return [];
                     }
@@ -337,6 +374,101 @@ class ExcelApi {
                     }
                 },
             },
+            listSearch: {
+                async searchExcelFiles(filter) {
+                    const credentials = await this.getCredentials('excelApiAuth');
+                    const apiUrl = credentials.url;
+                    const apiToken = credentials.token;
+                    try {
+                        const response = await this.helpers.request({
+                            method: 'GET',
+                            url: `${apiUrl}/api/excel/files`,
+                            headers: { 'Authorization': `Bearer ${apiToken}` },
+                            json: true,
+                        });
+                        if (response.success && response.files) {
+                            let files = response.files;
+                            if (filter) {
+                                const f = filter.toLowerCase();
+                                files = files.filter((file) => file.toLowerCase().includes(f));
+                            }
+                            return {
+                                results: files.map((file) => ({ name: file, value: file })),
+                            };
+                        }
+                        return { results: [] };
+                    }
+                    catch (error) {
+                        return { results: [] };
+                    }
+                },
+                async searchExcelSheets(filter) {
+                    const fileNameRaw = this.getNodeParameter('fileName');
+                    const fileName = (fileNameRaw && typeof fileNameRaw === 'object' ? fileNameRaw.value : fileNameRaw);
+                    if (!fileName) {
+                        return { results: [] };
+                    }
+                    const credentials = await this.getCredentials('excelApiAuth');
+                    const apiUrl = credentials.url;
+                    const apiToken = credentials.token;
+                    try {
+                        const response = await this.helpers.request({
+                            method: 'GET',
+                            url: `${apiUrl}/api/excel/sheets?file=${encodeURIComponent(fileName)}`,
+                            headers: { 'Authorization': `Bearer ${apiToken}` },
+                            json: true,
+                        });
+                        if (response.success && response.sheets) {
+                            let sheets = response.sheets;
+                            if (filter) {
+                                const f = filter.toLowerCase();
+                                sheets = sheets.filter((s) => s.toLowerCase().includes(f));
+                            }
+                            return {
+                                results: sheets.map((sheet) => ({ name: sheet, value: sheet })),
+                            };
+                        }
+                        return { results: [] };
+                    }
+                    catch (error) {
+                        return { results: [] };
+                    }
+                },
+                async searchColumnNames(filter) {
+                    const fileNameRaw = this.getNodeParameter('fileName');
+                    const fileName = (fileNameRaw && typeof fileNameRaw === 'object' ? fileNameRaw.value : fileNameRaw);
+                    const sheetNameRaw = this.getNodeParameter('sheetName');
+                    const sheetName = (sheetNameRaw && typeof sheetNameRaw === 'object' ? sheetNameRaw.value : sheetNameRaw);
+                    if (!fileName || !sheetName) {
+                        return { results: [] };
+                    }
+                    const credentials = await this.getCredentials('excelApiAuth');
+                    const apiUrl = credentials.url;
+                    const apiToken = credentials.token;
+                    try {
+                        const response = await this.helpers.request({
+                            method: 'GET',
+                            url: `${apiUrl}/api/excel/headers?file=${encodeURIComponent(fileName)}&sheet=${encodeURIComponent(sheetName)}`,
+                            headers: { 'Authorization': `Bearer ${apiToken}` },
+                            json: true,
+                        });
+                        if (response.success && response.headers) {
+                            let headers = response.headers;
+                            if (filter) {
+                                const f = filter.toLowerCase();
+                                headers = headers.filter((h) => h.toLowerCase().includes(f));
+                            }
+                            return {
+                                results: headers.map((header) => ({ name: header, value: header })),
+                            };
+                        }
+                        return { results: [] };
+                    }
+                    catch (error) {
+                        return { results: [] };
+                    }
+                },
+            },
         };
     }
     async execute() {
@@ -348,15 +480,17 @@ class ExcelApi {
         const credentials = await this.getCredentials('excelApiAuth');
         const apiUrl = credentials.url;
         const apiToken = credentials.token;
-        // Common parameters
-        const fileName = this.getNodeParameter('fileName', 0);
-        const sheetName = this.getNodeParameter('sheetName', 0) || 'Sheet1';
-        if (!fileName) {
-            throw new n8n_workflow_1.NodeOperationError(this.getNode(), 'File Name is required. Please select an Excel file.');
-        }
         try {
             for (let i = 0; i < items.length; i++) {
                 let responseData;
+                // Common parameters (per-item to support Expression mode)
+                const fileNameRaw = this.getNodeParameter('fileName', i);
+                const fileName = (fileNameRaw && typeof fileNameRaw === 'object' ? fileNameRaw.value : fileNameRaw) || '';
+                const sheetNameRaw = this.getNodeParameter('sheetName', i);
+                const sheetName = (sheetNameRaw && typeof sheetNameRaw === 'object' ? sheetNameRaw.value : sheetNameRaw) || '';
+                if (!fileName) {
+                    throw new n8n_workflow_1.NodeOperationError(this.getNode(), 'File Name is required. Please select an Excel file.');
+                }
                 if (operation === 'append') {
                     // Get append mode to determine which parameter to use
                     const appendMode = this.getNodeParameter('appendMode', i);
@@ -374,6 +508,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 +523,7 @@ class ExcelApi {
                             body: {
                                 file: fileName,
                                 sheet: sheetName,
-                                values: appendValues,
+                                values: convertedValues,
                             },
                             json: true,
                         });
@@ -404,7 +540,7 @@ class ExcelApi {
                             body: {
                                 file: fileName,
                                 sheet: sheetName,
-                                values: appendValues,
+                                values: convertedValues,
                             },
                             json: true,
                         });
@@ -428,6 +564,10 @@ class ExcelApi {
                     });
                     if (responseData.success && responseData.data) {
                         const data = responseData.data;
+                        if (data.length <= 1) {
+                            returnData.push({ json: { success: true, data: [] } });
+                            continue;
+                        }
                         if (data.length > 1) {
                             const headers = data[0];
                             const hasHeaders = headers.every((h) => typeof h === 'string' && h.length > 0);
@@ -448,8 +588,6 @@ class ExcelApi {
                     }
                 }
                 else if (operation === 'update') {
-                    // Get identification method
-                    const identifyBy = this.getNodeParameter('identifyBy', i);
                     const valuesToSetRaw = this.getNodeParameter('valuesToSet', i);
                     let valuesToSet;
                     if (typeof valuesToSetRaw === 'string') {
@@ -463,24 +601,21 @@ 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);
-                        requestBody.row = rowNumber;
-                    }
-                    else if (identifyBy === 'lookup') {
-                        const lookupColumn = this.getNodeParameter('lookupColumn', i);
-                        const lookupValue = this.getNodeParameter('lookupValue', i);
-                        const processMode = this.getNodeParameter('processMode', i);
-                        requestBody.lookup_column = lookupColumn;
-                        requestBody.lookup_value = lookupValue;
-                        requestBody.process_all = (processMode === 'all');
-                    }
+                    const lookupColumnRaw = this.getNodeParameter('lookupColumn', i);
+                    const lookupColumn = (lookupColumnRaw && typeof lookupColumnRaw === 'object' ? lookupColumnRaw.value : lookupColumnRaw);
+                    const lookupValue = this.getNodeParameter('lookupValue', i);
+                    const processMode = this.getNodeParameter('processMode', i);
+                    requestBody.lookup_column = lookupColumn;
+                    requestBody.lookup_value = lookupValue;
+                    requestBody.process_all = (processMode === 'all');
                     responseData = await this.helpers.request({
                         method: 'PUT',
                         url: `${apiUrl}/api/excel/update_advanced`,
@@ -493,31 +628,22 @@ class ExcelApi {
                     });
                     // Check if any rows were affected
                     if (responseData.success && responseData.updated_count === 0) {
-                        throw new n8n_workflow_1.NodeOperationError(this.getNode(), identifyBy === 'lookup'
-                            ? `No matching rows found. Lookup column: "${requestBody.lookup_column}", Lookup value: "${requestBody.lookup_value}"`
-                            : `Row ${requestBody.row} not found or is protected (header row cannot be updated)`);
+                        throw new n8n_workflow_1.NodeOperationError(this.getNode(), `No matching rows found. Lookup column: "${requestBody.lookup_column}", Lookup value: "${requestBody.lookup_value}"`);
                     }
                 }
                 else if (operation === 'delete') {
-                    // Get identification method
-                    const identifyBy = this.getNodeParameter('identifyBy', i);
                     // Build request body
                     const requestBody = {
                         file: fileName,
                         sheet: sheetName,
                     };
-                    if (identifyBy === 'rowNumber') {
-                        const rowNumber = this.getNodeParameter('rowNumber', i);
-                        requestBody.row = rowNumber;
-                    }
-                    else if (identifyBy === 'lookup') {
-                        const lookupColumn = this.getNodeParameter('lookupColumn', i);
-                        const lookupValue = this.getNodeParameter('lookupValue', i);
-                        const processMode = this.getNodeParameter('processMode', i);
-                        requestBody.lookup_column = lookupColumn;
-                        requestBody.lookup_value = lookupValue;
-                        requestBody.process_all = (processMode === 'all');
-                    }
+                    const lookupColumnRaw = this.getNodeParameter('lookupColumn', i);
+                    const lookupColumn = (lookupColumnRaw && typeof lookupColumnRaw === 'object' ? lookupColumnRaw.value : lookupColumnRaw);
+                    const lookupValue = this.getNodeParameter('lookupValue', i);
+                    const processMode = this.getNodeParameter('processMode', i);
+                    requestBody.lookup_column = lookupColumn;
+                    requestBody.lookup_value = lookupValue;
+                    requestBody.process_all = (processMode === 'all');
                     responseData = await this.helpers.request({
                         method: 'DELETE',
                         url: `${apiUrl}/api/excel/delete_advanced`,
@@ -530,40 +656,9 @@ class ExcelApi {
                     });
                     // Check if any rows were affected
                     if (responseData.success && responseData.deleted_count === 0) {
-                        throw new n8n_workflow_1.NodeOperationError(this.getNode(), identifyBy === 'lookup'
-                            ? `No matching rows found. Lookup column: "${requestBody.lookup_column}", Lookup value: "${requestBody.lookup_value}"`
-                            : `Row ${requestBody.row} not found or is protected (header row cannot be deleted)`);
+                        throw new n8n_workflow_1.NodeOperationError(this.getNode(), `No matching rows found. Lookup column: "${requestBody.lookup_column}", Lookup value: "${requestBody.lookup_value}"`);
                     }
                 }
-                else if (operation === 'batch') {
-                    const batchOperationsRaw = this.getNodeParameter('batchOperations', i);
-                    let batchOperations;
-                    if (typeof batchOperationsRaw === 'string') {
-                        try {
-                            batchOperations = JSON.parse(batchOperationsRaw);
-                        }
-                        catch {
-                            throw new n8n_workflow_1.NodeOperationError(this.getNode(), 'Batch Operations must be a valid JSON array');
-                        }
-                    }
-                    else {
-                        batchOperations = batchOperationsRaw;
-                    }
-                    responseData = await this.helpers.request({
-                        method: 'POST',
-                        url: `${apiUrl}/api/excel/batch`,
-                        headers: {
-                            'Authorization': `Bearer ${apiToken}`,
-                            'Content-Type': 'application/json',
-                        },
-                        body: {
-                            file: fileName,
-                            sheet: sheetName,
-                            operations: batchOperations,
-                        },
-                        json: true,
-                    });
-                }
                 else {
                     throw new n8n_workflow_1.NodeOperationError(this.getNode(), `Unsupported operation: ${operation}`);
                 }

package/package.json

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