Các cột trong ứng dụng dựa trên mô hình (Tham khảo API máy khách)

Cột chứa dữ liệu trong biểu mẫu hoặc lưới ứng dụng dựa trên mô hình. Sử dụng bộ formContext.data.entity.attributes sưu tập hoặc phương formContext.getAttribute pháp lối tắt để truy nhập tuyển tập cột. Để biết thêm thông tin về bộ sưu tập, hãy xem Bộ sưu tập (Tham khảo API máy khách).

Để truy nhập một cột trong tuyển tập, hãy chuyển tên (chuỗi) hoặc giá trị chỉ mục (số) của cột làm đối số cho phương thức. Ví dụ: formContext.getAttribute(arg). Nếu bạn không xác định đối số, phương thức sẽ trả về tập hợp tất cả các thuộc tính trên biểu mẫu.

Các cột được phân loại theo loại. Sử dụng phương pháp getAttributeType để xác định loại cột. Một số phương pháp cột nhất định chỉ sẵn dùng cho các loại cột cụ thể.

Bài viết này cung cấp thông tin về các phương pháp sẵn dùng cho từng loại cột.

Tất cả các loại cột

Thuộc tính điều khiển cung cấp một tập hợp các điều khiển liên kết với cột.

Các phương pháp sau đây sẵn dùng cho tất cả các loại cột:

Phương pháp	Mô tả
addOnChange	Thêm một hàm để chạy khi sự kiện của cột OnChange xảy ra.
fireOnChange	Kích hoạt sự kiện của OnChange cột.
getAttributeType	Trả về kiểu cột.
getFormat	Trả về định dạng cột.
getIsDirty	Trả về việc cột có thay đổi chưa lưu hay không.
getName	Trả về tên lô-gic của cột.
getParent	Trả về đối tượng mẹ formContext.data.entity .
getRequiredLevel	Trả về giá trị cột là bắt buộc hay được đề xuất.
getSubmitMode	Trả về khi dữ liệu của cột được gửi khi lưu.
getUserPrivilege	Trả về đặc quyền của người dùng để tạo, đọc hoặc cập nhật giá trị của cột.
getValue	Trả về giá trị dữ liệu của cột.
isValid	Trả về giá trị của cột có hợp lệ hay không.
removeOnChange	Loại bỏ hàm khỏi bộ xử lý sự kiện OnChange của cột.
setIsValid	Đặt tính hợp lệ của cột và thông báo lỗi.
setRequiredLevel	Đặt xem giá trị cột là bắt buộc hay được đề xuất trước khi lưu.
setSubmitMode	Đặt xem dữ liệu của cột có được gửi khi lưu hay không.
setValue	Đặt giá trị dữ liệu của cột.

Kiểu cột Boolean

Ngoài các phương pháp sẵn dùng cho tất cả các loại cột, kiểu cột boolean còn cung cấp phương pháp sau đây:

Phương pháp	Mô tả
getInitialValue	Trả về giá trị của cột khi mở biểu mẫu.

Kiểu cột tra cứu

Ngoài các phương pháp sẵn dùng cho tất cả các loại cột, kiểu cột tra cứu còn cung cấp phương pháp sau đây:

Phương pháp	Mô tả
getIsPartyList	Trả về việc tra cứu có cho phép tra cứu nhiều bản ghi như một danh sách bên hay không.

Các lựa chọn và loại cột lựa chọn

Ngoài các phương pháp sẵn dùng cho tất cả các kiểu cột, các lựa chọn và kiểucột lựa chọn còn cung cấp các phương pháp sau đây:

Phương pháp	Mô tả
getInitialValue	Trả về giá trị của cột khi mở biểu mẫu.
getOption	Trả về tùy chọn khớp với nhãn hoặc giá trị đã xác định.
getOptions	Trả về tùy chọn hợp lệ của cột.
getSelectedOption	Trả về tùy chọn hoặc tùy chọn đã chọn.
getText	Trả về văn bản của tùy chọn hoặc tùy chọn đã chọn.

Kiểu cột số (thập phân, kép, số nguyên, tiền)

Các phương pháp sau đây chỉ sẵn dùng cho cột thậpphân, kép và số nguyên:

Phương pháp	Mô tả
getMax	Trả về giá trị tối đa cho phép của cột.
getMin	Trả về giá trị tối thiểu cho phép của cột.
getPrecision	Trả về số chữ số được phép sau dấu thập phân.
setPrecision	Đặt số chữ số được phép sau dấu thập phân.

Loại cột chuỗi

Ngoài các phương pháp sẵn dùng cho tất cả các loại cột như đã giải thích ở phần trước, phương pháp sau đây chỉ sẵn dùng cho cột chuỗi:

Phương pháp	Mô tả
getMaxLength	Trả về độ dài chuỗi tối đa của cột.

Bài viết liên quan

Tìm hiểu về mô hình đối tượng Xrm
Điều khiển (Tài liệu tham khảo về API máy khách)