Chia sẻ qua


setValue (Tài liệu tham khảo về API máy khách)

Đặt giá trị dữ liệu cho một cột.

Các loại cột được hỗ trợ

Tất cả

Cú pháp

formContext.getAttribute(arg).setValue(value)

Tham số

Tùy thuộc vào loại cột.

Loại Cột Kiểu Tham số
boolean Boolean
ngày giờ Ngày

Trong Giao diện Hợp nhất, giá trị ngày được giả định là UTC.
Trong máy khách web thừa tự, giá trị ngày được giả định là theo múi giờ của người dùng.
thập phân Con số
đôi Con số
Số nguyên Con số
lookup Mảng Một mảng các đối tượng tra cứu.

Một số tra cứu nhất định, được gọi là tra cứu 'partylist', cho phép liên kết nhiều bản ghi trong một tra cứu, chẳng hạn như cột Đến: cho một bản ghi bảng email. Do đó, tất cả các giá trị dữ liệu tra cứu đều sử dụng một mảng đối tượng tra cứu – ngay cả khi cột tra cứu không hỗ trợ nhiều tham chiếu bản ghi để thêm vào.

Mỗi tra cứu có các thuộc tính sau:
- entityType: Chuỗi. Tên của bảng được hiển thị trong tra cứu.
- id: Chuỗi: Chuỗi biểu thị giá trị GUID cho bản ghi được hiển thị trong tra cứu. Giá trị phải khớp với định dạng sau: {XXXXXXXX-XXXX-XXXX-XXXXXXXXXXXX}
- name: Chuỗi: Văn bản đại diện cho bản ghi sẽ được hiển thị trong tra cứu.
thông điệp Xâu
tiền Con số
sự lựa chọn Con số
chuỗi Xâu
thông điệp Xâu
tiền Con số
lựa chọn, lựa chọn Con số

Phương pháp getOptions trả về giá trị tùy chọn dưới dạng chuỗi. Bạn phải sử dụng parseInt để chuyển đổi chúng thành số trước khi bạn có thể sử dụng các giá trị đó để đặt giá trị của cột lựa chọn. Các tùy chọn mã trạng thái hợp lệ (Lý do Trạng thái) phụ thuộc vào mã trạng thái hiện tại của bản ghi. Không thể đặt cột mã trạng thái (Trạng thái) trong script biểu mẫu. Để hiểu giá trị mã tiểu bang nào hợp lệ, hãy tham khảo định nghĩa cột. Đối với bảng tùy chỉnh, hãy sử dụng trình duyệt định nghĩa bảng. Cuối cùng, cũng cân nhắc mọi chuyển tiếp trạng thái tùy chỉnh đã được áp dụng cho cột. Thông tin thêm: Xác định lý do trạng thái chuyển tiếp cho Các trường hợp hoặc bảng tùy chỉnh.
String Xâu

Cột Chuỗi có định dạng email yêu cầu chuỗi đại diện cho địa chỉ email hợp lệ.

Lưu ý

Cập nhật cột bằng cách dùng setValue sẽ không làm cho trình xử lý sự kiện OnChange chạy. Nếu bạn muốn trình xử lý sự kiện OnChange chạy, bạn phải sử dụng fireOnChange ngoài đặtValue.

Bài viết liên quan

getValue (Tài liệu tham khảo về API máy khách)