Tự động Đồng bộ Tài liệu lên Cơ sở dữ liệu Notion - Quy trình làm việc n8n

• Quản lý Tự động hóa: Người dùng cần một danh mục tập trung, cập nhật mới nhất về tất cả các luồng công việc n8n đã triển khai.


• Quản trị viên Hệ thống: Những người cần quản trị và giám sát các phiên bản n8n đang hoạt động.


• Lập trình viên: Các nhóm cần tài liệu hóa tự động về các mẫu và luồng công việc n8n đã triển khai của họ.


• Người dùng thành thạo n8n: Bất kỳ ai đang chạy các tác vụ tự động hóa n8n quan trọng cần theo dõi trạng thái.

Việc quản lý tài liệu và theo dõi trạng thái của vô số luồng công việc n8n đã triển khai có thể rất thách thức. Luồng công việc n8n chuyên gia này giải quyết vấn đề đó bằng cách tận dụng API nội bộ của n8n để truy xuất siêu dữ liệu (chẳng hạn như tên, trạng thái hoạt động, ngày tạo và URL) cho các luồng công việc cụ thể được gắn thẻ sync-to-notion. Thông tin này sau đó được đẩy tự động đến một cơ sở dữ liệu Notion chuyên dụng.

Bằng cách sử dụng mẫu n8n chuyên biệt này, người dùng đạt được khả năng quản trị theo thời gian thực, đảm bảo tài liệu Notion của họ luôn phản ánh trạng thái hiện tại của các tác vụ tự động hóa. Nếu một luồng công việc mới, nó sẽ tạo một mục mới; nếu nó đã tồn tại, nó sẽ cập nhật trạng thái. Sự kết hợp các node n8n mạnh mẽ này đảm bảo tính chính xác của dữ liệu với nỗ lực thủ công tối thiểu.

Luồng công việc n8n này hoạt động dựa trên trigger n8n được lên lịch 15 phút một lần, đảm bảo tài liệu của bạn được đồng bộ thường xuyên.

1. Kích hoạt theo lịch trình: Trigger n8n khởi động toàn bộ quy trình cứ sau 15 phút.


2. Lấy dữ liệu Luồng công việc: Một node n8n nội bộ kết nối qua thông tin xác thực API để truy vấn phiên bản n8n đang lưu trữ, truy xuất tất cả các luồng công việc được gắn thẻ cụ thể là sync-to-notion. Điều này cho phép tài liệu hóa chọn lọc các mẫu n8n quan trọng.


3. Chuẩn bị Siêu dữ liệu: Một node Set n8n tiếp theo trích xuất các chi tiết quan trọng từ JSON luồng công việc nhận được, bao gồm trạng thái hoạt động, dấu thời gian tạo/cập nhật, tên luồng công việc, và xây dựng một định danh duy nhất (envId) cùng với URL bên ngoài (lưu ý: ghi chú dán nhãn nhấn mạnh sự cần thiết phải cấu hình URL phiên bản của bạn tại đây).


4. Kiểm tra sự tồn tại trong Notion: Một node HTTP Request n8n truy vấn cơ sở dữ liệu Notion đã cấu hình, tìm kiếm một mục hiện có khớp với envId vừa được tạo (ID luồng công việc duy nhất).


5. Điều khiển Luồng: Một node If n8n kiểm tra kết quả của việc tra cứu Notion. Nếu không có kết quả nào được trả về, nó xác định rằng đây là một luồng công việc n8n mới được thêm vào.


6. Tạo hoặc Cập nhật:

Để cài đặt và sử dụng luồng công việc n8n mạnh mẽ này, hãy làm theo các bước sau:

1. Nhập Mẫu n8n: Sao chép dữ liệu JSON được cung cấp và dán nó vào canvas n8n của bạn bằng cách sử dụng tùy chọn 'New' -> 'Import from JSON' (Mới -> Nhập từ JSON).


2. Thiết lập Thông tin xác thực API n8n: Bạn phải cấu hình node n8n 'Get all workflows with tag' (Lấy tất cả luồng công việc có thẻ) nội bộ bằng thông tin xác thực có quyền đọc dữ liệu luồng công việc của phiên bản n8n của bạn. Thông thường đây là khóa API của tài khoản quản trị n8n.


3. Thiết lập Cơ sở dữ liệu Notion: Tạo một cơ sở dữ liệu Notion mới dành riêng để theo dõi các luồng công việc này. Nó phải chứa các trường sau chính xác như được cấu hình trong các node n8n Notion:

1. Thông tin xác thực Notion: Cập nhật thông tin xác thực API Notion được sử dụng trong các node HTTP Request, Add to Notion và Update in Notion n8n. Đảm bảo rằng Tích hợp có quyền truy cập vào cơ sở dữ liệu được tạo ở bước 3.


2. Cấu hình URL Phiên bản: Xem lại node n8n 'Set fields' (Đặt trường) và thay thế thủ công phần giữ chỗ {{ $vars.instance_url }} bằng URL cơ sở thực tế của phiên bản n8n của bạn để đảm bảo URL được lưu là chính xác.


3. Gắn thẻ các Luồng công việc: Gắn thẻ bất kỳ luồng công việc n8n nào bạn muốn tài liệu hóa bằng thẻ sync-to-notion.

Mỗi 15 phút (Trigger Lên lịch n8n):
Chức năng: Bắt đầu thực thi luồng công việc n8n theo định kỳ.
Cấu hình chính: Đặt để chạy mỗi 15 phút.
Lấy tất cả luồng công việc có thẻ (node n8n):
Chức năng: Truy vấn API nội bộ của n8n để truy xuất dữ liệu JSON cho tất cả các luồng công việc n8n đang hoạt động mang thẻ sync-to-notion.
Cấu hình chính: Lọc các luồng công việc dựa trên tham số tags: "sync-to-notion".
Đặt các trường (node Set n8n):
Chức năng: Chuẩn bị và chuẩn hóa dữ liệu luồng công việc đầu vào thành các trường cụ thể (ví dụ: active, url, envId, name) để dễ dàng ánh xạ sang các trường Notion.
Cấu hình chính: Xây dựng envId duy nhất dưới dạng internal-{{ $json.id }} và URL luồng công việc đầy đủ.
Lấy trang notion theo id luồng công việc (node HTTP Request n8n):
Chức năng: Thực hiện truy vấn POST tới cơ sở dữ liệu API Notion để xác định xem đã tồn tại trang tương ứng với ID luồng công việc n8n cụ thể hay chưa.
Cấu hình chính: Sử dụng thuộc tính envId trong phần thân truy vấn JSON.
Nếu là luồng công việc mới thêm (node If n8n):
Chức năng: Kiểm soát đường đi của luồng, kiểm tra xem truy vấn Notion có trả về tập hợp kết quả rỗng hay không (nghĩa là luồng công việc đó là mới).
Cấu hình chính: Kiểm tra xem mảng {{ $json.results }} có rỗng không.
Thêm vào Notion (node n8n Notion):
Chức năng: Nếu luồng công việc là mới, node n8n này sẽ tạo một trang cơ sở dữ liệu mới với tất cả siêu dữ liệu đã trích xuất.
Cấu hình chính: Thao tác được đặt thành tạo databasePage bằng cách sử dụng dữ liệu đầu vào cho tất cả các giá trị thuộc tính.
Cập nhật trong Notion (node n8n Notion):
Chức năng: Nếu luồng công việc đã tồn tại, node n8n này sẽ cập nhật các trường liên quan (như trạng thái và ngày cập nhật) trên trang Notion hiện có.
* Cấu hình chính: Thao tác được đặt thành update, nhắm mục tiêu pageId hiện có và cập nhật các trường như isActive (dev).