#NocoBase bên ngoài

#Giới thiệu

Nguồn dữ liệu NocoBase bên ngoài có thể kết nối một ứng dụng NocoBase khác với ứng dụng hiện tại, đồng thời giữ lại siêu dữ liệu đã được cấu hình trong ứng dụng từ xa, chẳng hạn như bảng dữ liệu, giao diện trường, tiêu đề và trường quan hệ.

So với nguồn dữ liệu cơ sở dữ liệu bên ngoài, sau khi kết nối NocoBase bên ngoài, thông thường bạn không cần cấu hình lại giao diện trường hoặc tạo thủ công các trường quan hệ. Ngoài việc xem, thêm, chỉnh sửa và xóa bản ghi, còn hỗ trợ tải lên và xem trước tệp, nhập xuất dữ liệu, truy vấn biểu đồ và một số trường hợp sử dụng workflow.

#Thêm nguồn dữ liệu

Sau khi kích hoạt plugin, hãy thêm nguồn dữ liệu NocoBase bên ngoài trong「Quản lý nguồn dữ liệu」và điền thông tin truy cập của ứng dụng từ xa.

Sau khi bật nguồn dữ liệu, hệ thống sẽ tải các bảng dữ liệu của ứng dụng từ xa.

#Giải thích về quyền

Nguồn dữ liệu NocoBase bên ngoài chịu ảnh hưởng đồng thời bởi quyền của ứng dụng hiện tại và ứng dụng từ xa.

• Ứng dụng hiện tại có thể cấu hình quyền truy cập cho các bảng và trường khác nhau như với các nguồn dữ liệu bên ngoài khác;
• ứng dụng từ xa sẽ đọc và thao tác trên dữ liệu tương ứng dựa trên quyền của API key đã cấu hình.

Nguồn dữ liệu NocoBase bên ngoài không trả về siêu dữ liệu quyền dùng để kiểm soát chi tiết trạng thái hiển thị nút ở giao diện người dùng, vì vậy một số nút có thể không tự động bị ẩn theo quyền như ở nguồn dữ liệu chính. Dù nút có hiển thị hay không, thao tác gửi vẫn sẽ được kiểm tra quyền ở phía máy chủ của ứng dụng hiện tại; thao tác không được cấp quyền sẽ bị từ chối.

#Sử dụng bảng dữ liệu

Sau khi tải bảng dữ liệu thành công, hãy chọn nguồn dữ liệu này trong cấu hình trang, cấu hình khối, biểu đồ hoặc workflow để sử dụng các bảng dữ liệu trong ứng dụng từ xa.

Sau khi cấu trúc bảng dữ liệu của ứng dụng từ xa thay đổi, cần tải lại bảng dữ liệu trong ứng dụng hiện tại.

#Mô tả tính năng

Nguồn dữ liệu NocoBase bên ngoài chủ yếu được dùng để sử dụng các bảng dữ liệu và dữ liệu của ứng dụng từ xa trong ứng dụng hiện tại. Cấu trúc bảng dữ liệu, cấu hình trường và dữ liệu thực tế vẫn do ứng dụng từ xa quản lý.

#Bảng dữ liệu và trường

Ứng dụng hiện tại sẽ tải siêu dữ liệu như bảng dữ liệu, giao diện trường, tiêu đề và trường quan hệ của ứng dụng từ xa. So với nguồn dữ liệu cơ sở dữ liệu bên ngoài, thông thường không cần cấu hình lại giao diện trường hoặc tạo thủ công các trường quan hệ trong ứng dụng hiện tại.

Ứng dụng hiện tại không hỗ trợ cấu hình trực tiếp các trường của nguồn dữ liệu NocoBase bên ngoài. Khi cần thêm trường, điều chỉnh kiểu trường hoặc sửa trường quan hệ, hãy thực hiện trong ứng dụng từ xa, sau đó quay lại ứng dụng hiện tại để tải lại bảng dữ liệu.

#Bản ghi và dữ liệu liên kết

Nguồn dữ liệu NocoBase bên ngoài hỗ trợ xem, thêm, chỉnh sửa và xóa bản ghi trong các khối trên trang, đồng thời hỗ trợ xem và duy trì dữ liệu liên kết. Các thao tác sẽ do ứng dụng hiện tại khởi tạo và gửi yêu cầu đến ứng dụng từ xa thông qua API key đã cấu hình.

#Tệp và tệp đính kèm

Tệp sẽ được tải lên bộ lưu trữ mà ứng dụng từ xa sử dụng. Ứng dụng hiện tại chịu trách nhiệm khởi tạo yêu cầu tải lên, xem trước và tải xuống; bản thân tệp không được lưu trong ứng dụng hiện tại.

Origin chủ yếu được dùng để xử lý địa chỉ xem trước của các tệp trong bộ lưu trữ cục bộ của ứng dụng từ xa. Nếu phản hồi từ xa là đường dẫn tương đối, ứng dụng hiện tại sẽ dùng Origin để bổ sung địa chỉ truy cập tệp. Origin nên được điền bằng địa chỉ truy cập công khai của ứng dụng NocoBase từ xa, ví dụ:

https://example.com

Không điền địa chỉ API vào Origin.

#Nhập xuất dữ liệu

Nhập và xuất dữ liệu là các thao tác đọc ghi nguồn dữ liệu thông qua tệp bên ngoài, tất cả đều được chuyển tiếp để thực thi trên ứng dụng từ xa. Ứng dụng hiện tại chịu trách nhiệm tiếp nhận thao tác của người dùng, chuyển tiếp yêu cầu và trả về kết quả tải xuống; việc đọc ghi dữ liệu thực tế do ứng dụng từ xa thực hiện.

• Nhập bản ghi: ứng dụng hiện tại tiếp nhận tệp nhập được tải lên và chuyển tiếp tệp này đến ứng dụng từ xa để thực hiện thao tác nhập;
• Xuất bản ghi: ứng dụng hiện tại chuyển tiếp yêu cầu xuất bản ghi đến ứng dụng từ xa. Ở chế độ đồng bộ, luồng tệp bản ghi do ứng dụng từ xa trả về sẽ được chuyển tiếp để trình duyệt tải xuống; ở chế độ không đồng bộ, ứng dụng hiện tại sẽ tạo một tác vụ không đồng bộ cục bộ, khởi tạo thao tác xuất bản ghi trên ứng dụng từ xa và đồng bộ tiến độ, sau đó lấy luồng tệp bản ghi từ ứng dụng từ xa khi tải xuống kết quả.
• Xuất tệp đính kèm: ứng dụng hiện tại chuyển tiếp yêu cầu xuất tệp đính kèm đến ứng dụng từ xa. Ở chế độ đồng bộ, gói tệp đính kèm do ứng dụng từ xa trả về sẽ được chuyển tiếp để trình duyệt tải xuống; ở chế độ không đồng bộ, ứng dụng hiện tại sẽ tạo một tác vụ không đồng bộ cục bộ, khởi tạo thao tác xuất tệp đính kèm trên ứng dụng từ xa và đồng bộ tiến độ, sau đó lấy luồng gói tệp đính kèm từ ứng dụng từ xa khi tải xuống kết quả.

#In mẫu

In mẫu có thể sử dụng các bản ghi trong nguồn dữ liệu NocoBase bên ngoài. Mẫu in và cấu hình thao tác in được lưu trong ứng dụng hiện tại; khi in, ứng dụng hiện tại sẽ đọc các bản ghi và dữ liệu liên kết từ xa, sau đó tạo tệp in trong ứng dụng hiện tại.

#Biểu đồ

#Bảng điều khiển truy vấn

Nguồn dữ liệu NocoBase bên ngoài có thể được sử dụng cho bảng điều khiển truy vấn biểu đồ. Ứng dụng hiện tại sẽ xử lý các tham số truy vấn theo biểu đồ, nguồn dữ liệu, bảng dữ liệu và quyền trường được cấu hình cục bộ, sau đó yêu cầu ứng dụng từ xa trả về kết quả.

API key từ xa cũng cần có quyền truy cập vào dữ liệu tương ứng, nếu không truy vấn sẽ thất bại.

#Bảng điều khiển SQL

Bảng điều khiển SQL là chế độ truy vấn SQL của biểu đồ và chỉ được dùng để truy vấn. Ứng dụng hiện tại chịu trách nhiệm lưu cấu hình SQL và khởi tạo lệnh gọi; SQL sẽ được chuyển tiếp để thực thi trên ứng dụng từ xa.

Khi sử dụng bảng điều khiển SQL, người dùng cục bộ cần có quyền cấu hình UI trong ứng dụng hiện tại, đồng thời API key từ xa cũng cần có quyền cấu hình UI trong ứng dụng từ xa. SQL không phân tách các tham số truy vấn theo quyền bảng dữ liệu và trường như bảng điều khiển truy vấn, vì vậy hãy thận trọng khi cấp quyền cấu hình UI cho người dùng cục bộ và API key tương ứng.

#Workflow

Nguồn dữ liệu NocoBase bên ngoài có thể liên quan đến hai bộ workflow của ứng dụng hiện tại và ứng dụng từ xa. Ứng dụng hiện tại phản hồi các sự kiện trong chuỗi yêu cầu của trang, nút và API cục bộ; sau khi nhận được yêu cầu được chuyển tiếp, ứng dụng từ xa sẽ xử lý theo cấu hình workflow riêng của mình.

Cần lưu ý rằng ứng dụng hiện tại sẽ không lắng nghe các sự kiện thêm, cập nhật hoặc xóa xảy ra bên trong bảng dữ liệu từ xa. Các sự kiện của bảng dữ liệu từ xa chỉ được kích hoạt trong ứng dụng từ xa.

#Trigger

Bảng dưới đây mô tả tình huống kích hoạt trong ứng dụng hiện tại và ứng dụng từ xa của các trigger chịu ảnh hưởng bởi nguồn dữ liệu NocoBase bên ngoài khi workflow tương ứng được bật.

Các trigger không phụ thuộc vào nguồn dữ liệu sẽ được kích hoạt theo cấu hình tương ứng trong ứng dụng hiện tại và ứng dụng từ xa.

Nếu cần xây dựng quy trình xử lý dữ liệu NocoBase bên ngoài trong ứng dụng hiện tại, bạn nên sử dụng sự kiện trước yêu cầu, sự kiện sau yêu cầu hoặc sự kiện thao tác tùy chỉnh. Các workflow đã có trong ứng dụng từ xa sẽ được ứng dụng từ xa thực thi độc lập.

#Node

Bảng dưới đây chỉ liệt kê các node liên quan đến nguồn dữ liệu. Các node dùng chung như điều kiện, tính toán, vòng lặp và xử lý JSON không phụ thuộc vào loại nguồn dữ liệu, có thể sử dụng như workflow thông thường.

#Câu hỏi thường gặp

#Không xuất hiện bảng dữ liệu

Kiểm tra xem nguồn dữ liệu đã được bật chưa, cũng như địa chỉ API và API key có chính xác không. Ứng dụng từ xa cũng cần cho phép API key đó truy cập vào bảng dữ liệu tương ứng.

#Tải tệp lên thành công nhưng không thể xem trước

Nếu ứng dụng hiện tại hoặc ứng dụng từ xa sử dụng bộ lưu trữ tệp cục bộ, hãy kiểm tra xem Origin có được điền bằng địa chỉ truy cập công khai của ứng dụng tương ứng hay không. Không nên điền địa chỉ API vào Origin.

#Ứng dụng hiện tại có quyền nhưng thao tác thất bại

Kiểm tra quyền của API key trong ứng dụng từ xa. Nguồn dữ liệu NocoBase bên ngoài chịu ảnh hưởng đồng thời bởi quyền của ứng dụng hiện tại và quyền của ứng dụng từ xa.

#Không thể sử dụng bảng dữ liệu sau khi dịch vụ từ xa gặp sự cố

Nếu ứng dụng từ xa gặp lỗi 502, khởi động lại hoặc tạm thời không khả dụng, ứng dụng hiện tại có thể tạm thời không đọc được siêu dữ liệu bảng dữ liệu từ xa. Sau khi dịch vụ từ xa khôi phục, ứng dụng hiện tại sẽ tự động tải lại siêu dữ liệu vào lần tiếp theo truy cập các bảng dữ liệu của nguồn dữ liệu này.

#Tại sao không thể cấu hình trường trong ứng dụng hiện tại

Nguồn dữ liệu NocoBase bên ngoài sử dụng cấu trúc bảng dữ liệu và cấu hình trường của ứng dụng từ xa. Hãy điều chỉnh trường trong ứng dụng từ xa, sau đó quay lại ứng dụng hiện tại để tải lại bảng dữ liệu.