Markdown

Giới thiệu

Trong NocoBase, Markdown (Markdown) được dùng để lưu nội dung ở định dạng Markdown.

Trường Markdown phù hợp với tài liệu hướng dẫn, phương án xử lý, nội dung chính của cơ sở kiến thức, ghi chú thay đổi và các nội dung khác. Trường này lưu văn bản, khi hiển thị trên trang sẽ được kết xuất theo Markdown.

Nếu cần trải nghiệm chỉnh sửa WYSIWYG, bạn có thể chọn Văn bản có định dạng hoặc Markdown Vditor.

Trường hợp sử dụng

Markdown phù hợp với các trường hợp nghiệp vụ sau:

  • Nội dung chính của cơ sở kiến thức, tài liệu hướng dẫn
  • Phương án xử lý, nhật ký khắc phục sự cố
  • Ghi chú phát hành, ghi chú thay đổi
  • Nội dung văn bản dài cần định dạng nhẹ

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 「Markdown」 để tạo trường Markdown.

20240512181311

Cấu hìnhMô tả
Field interfaceLoại giao diện của trường. Markdown tương ứng với markdown, quyết định cách nhập và hiển thị trên trang.
Field display nameTên hiển thị của trường trên giao diện, chẳng hạn như 「Tài liệu hướng dẫn」, 「Phương án xử lý」 hoặc 「Nội dung chính」. 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à các chức năng khác. Sau khi tạo thường không nên 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. Trường Markdown thường sử dụng text để lưu nội dung.
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ể giới hạn độ dài hoặc yêu cầu bắt buộc nhập.
DescriptionMô tả trường. Phù hợp để ghi ý nghĩa của trường, yêu cầu nhập liệu, 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 trên 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 sau này.

Đặc điểm của trường

Hành vi mặc định của trường Markdown như sau:

Đặc điểmMô tả
Field interface mặc địnhmarkdown.
Field type mặc địnhtext.
Field type tùy chọntextstring, tùy theo cấu hình trường thực tế.
Thành phần trên trangChế độ chỉnh sửa sử dụng thành phần chỉnh sửa Markdown.
LọcHỗ trợ các bộ lọc dành cho văn bản, chẳng hạn như chứa, để trống, không để 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 văn bản như độ dài và bắt buộc nhập.

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 Markdown. 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ừ mộ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 mà 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ể 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ộ. Sau khi điều chỉnh, cách nhập, hiển thị và xác thực trên trang sẽ bị ảnh hưởng.
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 của trường, yêu cầu nhập liệu, nguồn dữ liệu hoặc người phụ trách bảo trì.
Lưu ý

Chuyển đổi Field type hoặc Field interface không chỉ đơn giản là thay đổi tên hiển thị. Việc này sẽ ảnh hưởng đến cách lưu trữ trường, thành phần nhập liệu, 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ó, trước tiên hãy xác nhận đị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 Markdown. 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 Markdown mới được tạo 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 trên trang, biểu mẫu, bộ lọc, quyền hạn, quy trình làm việc, API, việc nhập xuất dữ liệu và dữ liệu hiện có. Trước khi xóa, hãy xác nhận trường đó có còn được cấu hình nghiệp vụ nào tham chiếu hay không.

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

Trường Markdown phù hợp để sử dụng trong việc chỉnh sửa nội dung và hiển thị chi tiết. 20260709230801

Trường hợpCông dụng
Khối biểu mẫuChỉnh sửa nội dung Markdown.
Khối chi tiếtHiển thị nội dung được kết xuất theo Markdown.
Khối bảngHiển thị nội dung tóm tắt.
Quy trình làm việcDùng nội dung chính làm nội dung để tạo thông báo hoặc tài liệu.

Liên kết liên quan