URL tệp đính kèm

Giới thiệu

Trong NocoBase, URL tệp đính kèm (Attachment URL) dùng để lưu địa chỉ truy cập tệp bên ngoài.

Trường URL tệp đính kèm phù hợp với các trường hợp tệp đã được lưu trữ trong hệ thống bên ngoài, dịch vụ lưu trữ đối tượng hoặc CDN, và chỉ cần lưu địa chỉ truy cập trong NocoBase.

Nếu cần NocoBase tải lên và quản lý tệp, hãy chọn Tệp đính kèm. Nếu chỉ là địa chỉ trang web thông thường, hãy chọn URL.

Trường hợp áp dụng

URL tệp đính kèm phù hợp với các trường hợp nghiệp vụ sau:

  • Địa chỉ tệp trong dịch vụ lưu trữ đối tượng bên ngoài
  • Địa chỉ hình ảnh CDN
  • Địa chỉ tài liệu trong hệ thống bên thứ ba
  • Liên kết tệp sau khi di chuyển dữ liệu lịch sử

Tạo cấu hình

Trên trang «Configure fields» của bảng dữ liệu, nhấp vào «Add field» rồi chọn «URL tệp đính kèm» để tạo trường URL tệp đính kèm.

20241017092323

20241017092456

20241017092759

Cấu hìnhMô tả
Field interfaceLoại giao diện của trường. URL tệp đính kèm tương ứng với attachmentUrl, quyết định cách nhập và hiển thị trong trang.
Field display nameTên hiển thị của trường trên giao diện, chẳng hạn như «Địa chỉ tệp», «URL hình ảnh» hoặc «Tệp đính kèm bên ngoài». Nên sử dụng tên mà nhân viên nghiệp vụ có thể hiểu trực tiếp.
Field nameTên định danh của trường, dùng để tham chiếu nội bộ trong API, trường quan hệ, quyền hạn, quy trình làm việc, v.v. Sau khi tạo thường không thể sửa đổi, chỉ hỗ trợ chữ cái, chữ số và dấu gạch dưới, đồng thời phải bắt đầu bằng chữ cái.
Field typeLoại của trường ở tầng dữ liệu. URL tệp đính kèm thường sử dụng string hoặc text để lưu địa chỉ.
Default valueGiá trị mặc định. Khi thêm bản ghi, nếu người dùng không nhập, hệ thống có thể tự động điền giá trị mặc định.
Validation rulesQuy tắc xác thực. Có thể cấu hình định dạng URL, độ dài hoặc bắt buộc nhập.
DescriptionMô tả trường. Thích hợp để ghi rõ ý nghĩa trường, yêu cầu nhập, nguồn dữ liệu hoặc người phụ trách bảo trì.
Lưu ý

Tên trường sẽ được các khối trang, quyền hạn, quy trình làm việc và API tham chiếu sau khi tạo. Hãy xác nhận cách đặt tên trước khi tạo để tránh phát sinh chi phí điều chỉnh cấu hình khi sửa đổi về sau.

Đặc điểm trường

Hành vi mặc định của trường URL tệp đính kèm như sau:

Đặc điểmMô tả
Field interface mặc địnhattachmentUrl.
Field type mặc địnhstring.
Field type tùy chọnstringtext, tùy theo cấu hình trường thực tế.
Thành phần trangChế độ chỉnh sửa sử dụng thành phần nhập URL hoặc địa chỉ tệp đính kèm.
LọcHỗ trợ bộ lọc dạng văn bản và điều kiện trống.
Sắp xếpThông thường không dùng để sắp xếp.
Xác thựcHỗ trợ xác thực định dạng URL, độ dài, bắt buộc nhập, v.v.

Chỉnh sửa cấu hình

Sau khi tạo, nhấp vào «Edit» ở bên phải trường để chỉnh sửa cấu hình trường URL tệp đính kèm. Việc chỉnh sửa trường chủ yếu dùng để điều chỉnh cách trường được hiển thị và sử dụng trong NocoBase, chẳng hạn như sửa tên hiển thị, mô tả, giá trị mặc định, quy tắc xác thực hoặc cấu hình riêng của trường.

Nếu trường đến từ bảng đã được đồng bộ trong cơ sở dữ liệu chính, việc chỉnh sửa thường là ánh xạ trường — ánh xạ trường cơ sở dữ liệu thành Field type và Field interface của NocoBase.

Cấu hìnhCho phép chỉnh sửaMô tả
Field display nameSửa tên hiển thị của trường trên giao diện, không thay đổi tên định danh của trường.
Field nameKhôngTên định danh của trường thường không thể chỉnh sửa trong biểu mẫu chỉnh sửa sau khi đã tạo.
Field interfaceHỗ trợ có điều kiệnCó thể điều chỉnh khi ánh xạ trường cơ sở dữ liệu chính hoặc trường được đồng bộ. Việc điều chỉnh sẽ ảnh hưởng đến cách nhập, hiển thị và xác thực trên trang.
Field typeHỗ trợ có điều kiệnCó thể điều chỉnh khi ánh xạ trường cơ sở dữ liệu chính hoặc trường được đồng bộ. Trước khi điều chỉnh, cần xác nhận dữ liệu hiện có có thể được sử dụng theo kiểu mới hay không.
Default valueĐiều chỉnh giá trị mặc định khi thêm bản ghi mới.
Validation rulesĐiều chỉnh quy tắc xác thực của trường.
DescriptionBổ sung ý nghĩa trường, yêu cầu nhập, nguồn dữ liệu hoặc người phụ trách bảo trì.
Lưu ý

Việc chuyển đổi Field type hoặc Field interface không chỉ đơn giản là thay đổi tên hiển thị. Điều này sẽ ảnh hưởng đến cách lưu trữ trường, thành phần nhập, quy tắc xác thực, điều kiện lọc và cách sử dụng biến quy trình làm việc. Khi có nhiều dữ liệu hiện có, hãy xác nhận trước rằng định dạng dữ liệu có tương thích hay không.

Xóa trường

Nhấp vào «Delete» ở bên phải trường để xóa trường URL tệp đính kèm. Trong cơ sở dữ liệu chính, bạn cũng có thể chọn nhiều trường rồi xóa hàng loạt.

Khi xóa trường URL tệp đính kèm được tạo mới trong cơ sở dữ liệu chính, thông thường cột thực tế trong cơ sở dữ liệu và dữ liệu hiện có trong cột đó cũng sẽ bị xóa. Khi xóa trường được đồng bộ từ cơ sở dữ liệu hoặc ánh xạ từ nguồn dữ liệu bên ngoài, phạm vi ảnh hưởng phụ thuộc vào nguồn dữ liệu và nguồn gốc của trường tương ứng.

Cảnh báo

Xóa trường có thể ảnh hưởng đến các khối trang, biểu mẫu, bộ lọc, quyền hạn, quy trình làm việc, API, chức năng nhập xuất và dữ liệu hiện có. Hãy xác nhận trước khi xóa rằng trường không còn được các cấu hình nghiệp vụ tham chiếu.

Sử dụng trong cấu hình trang

Trường URL tệp đính kèm phù hợp để hiển thị và truy cập các tệp bên ngoài. 20260709231803

Trường hợpCông dụng
Khối biểu mẫuNhập địa chỉ tệp bên ngoài.
Khối chi tiếtHiển thị liên kết tệp.
Khối bảngHiển thị liên kết hoặc lối vào dạng hình thu nhỏ.
Quy trình làm việcĐưa địa chỉ tệp vào thông báo hoặc yêu cầu bên ngoài.

Liên kết liên quan

  • Trường — Tìm hiểu về công dụng, phân loại và logic ánh xạ của trường
  • Bảng thông thường — Tạo và quản lý trường trong bảng thông thường
  • Tệp đính kèm — Tải lên và liên kết tệp NocoBase
  • URL — Lưu liên kết thông thường