Larkbase Node for n8n

Node để tích hợp Larkbase (Larksuite Base) với n8n, cho phép thực hiện các thao tác CRUD, tìm kiếm và upsert dữ liệu.

Cập nhật mới nhất - Phiên bản 1.2.0

• Nâng cao bảo mật code khi publish lên npmjs:
  • Tối ưu hóa cấu hình obfuscate để bảo vệ code tốt hơn
  • Thêm bước uglify để nén và làm rối code thêm một lớp
  • Cập nhật quy trình build an toàn
  • Thêm tài liệu hướng dẫn về bảo mật trong docs/Mẹo bảo mật.md
• Được cập nhật vào ngày: 15/03/2024

Cập nhật mới nhất - Phiên bản 1.1.7

• Tăng cường bảo mật code khi publish lên npmjs:
  • Thêm tính năng obfuscate code để bảo vệ logic nghiệp vụ
  • Tích hợp quá trình uglify để tối ưu và bảo vệ code
  • Cải thiện quy trình build với các bước bảo mật
• Được cập nhật vào ngày: 14/03/2024

Cập nhật mới nhất - Phiên bản 1.1.6

• Tăng cường bảo mật code khi publish lên npmjs:
  • Thêm tính năng obfuscate code để bảo vệ logic nghiệp vụ
  • Tích hợp quá trình uglify để tối ưu và bảo vệ code
  • Cải thiện quy trình build với các bước bảo mật
• Được cập nhật vào ngày: 14/03/2024

Cập nhật mới nhất - Phiên bản 1.1.4

• Thêm tham số user_id_type=user_id mặc định vào tất cả các API calls
• Cải thiện xử lý user ID trong các thao tác CRUD và tìm kiếm
• Đảm bảo tương thích với định dạng user_id trong Larkbase
• Được cập nhật vào ngày: 13/03/2024

Kế Hoạch Phát Triển - Phiên bản 1.2.0 (Đang phát triển)

• Nâng cấp hệ thống xác thực với tính năng kiểm tra baseUrl
• Tăng cường bảo mật thông qua việc xác thực instance n8n
• Cải thiện hệ thống cache cho license validation
• Thêm validation cho baseUrl của instance n8n
• Dự kiến hoàn thành: Cuối tháng 3/2024

Cập nhật mới nhất - Phiên bản 1.1.3

• Đổi tên package thành "n8n-nodes-ntn-backup-larkbase"
• Hiển thị version của package trong subtitle của tất cả các node
• Cải thiện trải nghiệm người dùng với hiển thị version rõ ràng trong UI
• Tăng cường tính minh bạch về phiên bản đang sử dụng
• Được cập nhật vào ngày: 30/10/2023

Phiên bản 1.1.0

• Nâng cấp lên phiên bản 1.1.0 - phiên bản ổn định và hoàn thiện
• Cải thiện tính năng Batch Upsert để xử lý lượng lớn dữ liệu
• Sửa lỗi phân trang khi xử lý hàng nghìn bản ghi
• Tối ưu hóa hiệu suất của các thao tác hàng loạt
• Sửa script build để tương thích tốt hơn khi cài đặt từ npmjs
• Thêm xử lý kiểm tra thư mục tồn tại trong script copy
• Thêm script publish-package để dễ dàng phát hành lên npmjs
• Tích hợp tất cả các tính năng từ các phiên bản 1.1.x trước đó

Phiên bản 1.0.40

• Merge nhánh fix/batch-upsert vào main
• Cải thiện tính năng Batch Upsert để xử lý lượng lớn dữ liệu
• Sửa lỗi phân trang khi xử lý hàng nghìn bản ghi
• Tối ưu hóa hiệu suất của các thao tác hàng loạt
• Cập nhật tài liệu và ví dụ sử dụng

Phiên bản 1.0.39

• Khắc phục lỗi giao diện không cập nhật với version trước đó
• Đảm bảo các thay đổi UI được hiển thị đúng trong n8n
• Tiếp tục cải thiện tính năng "Get Fields và Tạo Mapping"

Phiên bản 1.0.38

• Sửa lỗi tính năng "Get Fields và Tạo Mapping" khi mới mở giao diện lên
• Khắc phục lỗi "Referenced node is unexecuted" khi tải tùy chọn từ máy chủ
• Cải thiện trải nghiệm người dùng bằng cách sử dụng trường string thay cho options
• Hiển thị danh sách fields đã lấy để người dùng có thể tham khảo khi thêm trường mapping
• Cập nhật hướng dẫn chi tiết để người dùng dễ dàng sử dụng

Phiên bản 1.0.37

• Xóa bỏ tùy chọn "Xử lý dữ liệu thừa" khỏi UI nhưng vẫn giữ lại logic lọc bỏ các trường không khớp
• Tối ưu hóa xử lý dữ liệu thừa: tự động lọc bỏ các trường không tồn tại trong bảng Larkbase
• Cải thiện log để thông báo cho người dùng về việc lọc trường không khớp
• Sửa lỗi hiển thị: Thuộc tính 'Cột Khóa (Key Columns)' luôn hiển thị bất kể chế độ dữ liệu
• Cải thiện tự động chọn cột khóa mặc định khi không có khóa nào được chỉ định
• Đã tách hàm execute sang module riêng để code gọn gàng và dễ bảo trì

Tính năng chính

• Create: Tạo mới bản ghi
• Update: Cập nhật bản ghi
• Search: Tìm kiếm bản ghi với nhiều điều kiện
• Upsert: Cập nhật nếu bản ghi đã tồn tại, tạo mới nếu chưa tồn tại
• Debug: Hiển thị chi tiết quá trình xử lý và giao tiếp API

Cài đặt

npm install n8n-nodes-ntn-backup-larkbase

Hướng dẫn sử dụng

Vui lòng tham khảo tài liệu trong thư mục docs để biết thêm chi tiết về cách sử dụng từng chức năng.

Dành cho nhà phát triển

Nếu bạn muốn phát triển hoặc chỉnh sửa node này, hãy làm theo các bước sau:

1. Clone repository này về máy tính của bạn

2. Cài đặt dependencies:

   npm install --legacy-peer-deps

   Lưu ý: Sử dụng --legacy-peer-deps để tránh xung đột giữa các phiên bản của package

3. Build node:

   npm run build

4. Để test node trong môi trường Docker:

   # Di chuyển vào thư mục chứa script Docker
   cd n8n-docker
   # Chạy script khởi động n8n
   ./start-n8n.sh

Thông tin xác thực

Để sử dụng node này, bạn cần thiết lập thông tin xác thực trong n8n:

1. App ID: ID ứng dụng Larkbase của bạn
2. App Secret: Bí mật ứng dụng Larkbase của bạn
3. Access Token: Token truy cập API Larkbase của bạn
4. License Key: Khóa bản quyền để kích hoạt node (bắt buộc)

License

MIT