คอลัมน์ในแอปแบบจําลองข้อมูล (การอ้างอิง API ไคลเอ็นต์)

คอลัมน์ประกอบด้วยข้อมูลในแบบฟอร์มหรือตารางของแอปแบบจําลอง formContext.data.entity.attributesใช้คอลเลกชันหรือformContext.getAttributeวิธีการทางลัดเพื่อเข้าถึงคอลเลกชันของคอลัมน์ สําหรับข้อมูลเพิ่มเติมเกี่ยวกับคอลเลกชัน ดูคอลเลกชัน (การอ้างอิง API ไคลเอ็นต์)

เมื่อต้องการเข้าถึงคอลัมน์ภายในคอลเลกชัน ให้ส่งผ่านชื่อ (สตริง) หรือค่าดัชนี (จํานวน) ของคอลัมน์เป็นอาร์กิวเมนต์ไปยังเมธอด ตัวอย่างเช่น: formContext.getAttribute(arg) ถ้าคุณไม่ได้ระบุอาร์กิวเมนต์ เมธอด จะส่งกลับคอลเลกชันของแอตทริบิวต์ทั้งหมดบนฟอร์ม

คอลัมน์จะถูกจัดประเภทตามชนิด ใช้เมธอด getAttributeType เพื่อกําหนดชนิดของคอลัมน์ บางวิธีการคอลัมน์จะพร้อมใช้งานสําหรับคอลัมน์บางชนิดเท่านั้น

บทความนี้ให้ข้อมูลเกี่ยวกับวิธีการที่พร้อมใช้งานสําหรับแต่ละชนิดคอลัมน์

ชนิดคอลัมน์ทั้งหมด

คุณสมบัติ ตัวควบคุม มีคอลเลกชันของ ตัวควบคุม ที่เกี่ยวข้องกับคอลัมน์

วิธีการต่อไปนี้สามารถใช้ได้กับชนิดคอลัมน์ทั้งหมด:

วิธีการ คำอธิบาย
addOnChange เพิ่มฟังก์ชันที่จะเรียกใช้เมื่อเหตุการณ์ของ OnChange คอลัมน์เกิดขึ้น
fireOnChange ทริกเกอร์เหตุการณ์ของ OnChange คอลัมน์
getAttributeType แสดงชนิดของคอลัมน์
getFormat แสดงรูปแบบของคอลัมน์
getIsDirty ส่งกลับว่าคอลัมน์มีการเปลี่ยนแปลงที่ยังไม่ได้บันทึกหรือไม่
getName แสดงชื่อตรรกะของคอลัมน์
getParent แสดงออบเจ็กต์หลักformContext.data.entity
getRequiredLevel ส่งกลับว่าจําเป็นต้องมีค่าคอลัมน์หรือแนะนํา
getSubmitMode ส่งกลับเมื่อมีการส่งข้อมูลของคอลัมน์เมื่อบันทึก
getUserPrivilege ส่งกลับสิทธิ์การใช้งานของผู้ใช้เพื่อสร้าง อ่าน หรืออัปเดตค่าของคอลัมน์
getValue แสดงค่าข้อมูลของคอลัมน์
isValid ส่งกลับว่าค่าของคอลัมน์ถูกต้องหรือไม่
removeOnChange ลบฟังก์ชันออกจากตัวจัดการเหตุการณ์ของ OnChange คอลัมน์
setIsValid ตั้งค่าความถูกต้องของคอลัมน์และข้อความแสดงข้อผิดพลาด
setRequiredLevel ตั้งค่าว่าต้องการค่าคอลัมน์หรือแนะนําก่อนที่จะบันทึก
setSubmitMode ตั้งค่าว่าจะส่งข้อมูลของคอลัมน์เมื่อบันทึกหรือไม่
setValue ตั้งค่าข้อมูลของคอลัมน์

ชนิดคอลัมน์บูลีน

นอกเหนือจากวิธีการที่พร้อมใช้งานสําหรับชนิดคอลัมน์ทั้งหมด ชนิดคอลัมน์ บูลีน มีวิธีการต่อไปนี้:

วิธีการ คำอธิบาย
getInitialValue แสดงค่าของคอลัมน์เมื่อเปิดฟอร์ม

ชนิดคอลัมน์การค้นหา

นอกเหนือจากวิธีการที่พร้อมใช้งานสําหรับชนิดคอลัมน์ทั้งหมด ชนิดคอลัมน์ การค้นหา จะมีวิธีการต่อไปนี้:

วิธีการ คำอธิบาย
getIsPartyList ส่งกลับว่าการค้นหาอนุญาตให้มีหลายเรกคอร์ดเป็นการค้นหารายการฝ่ายหรือไม่

ตัวเลือกและชนิดคอลัมน์ตัวเลือก

นอกเหนือจากวิธีการที่พร้อมใช้งานสําหรับชนิดคอลัมน์ทั้งหมด ตัวเลือก และชนิดคอลัมน์ ตัวเลือก จะมีวิธีการต่อไปนี้:

วิธีการ คำอธิบาย
getInitialValue แสดงค่าของคอลัมน์เมื่อเปิดฟอร์ม
getOption ส่งกลับตัวเลือกที่ตรงกับป้ายชื่อหรือค่าที่ระบุ
getOptions แสดงตัวเลือกที่ถูกต้องของคอลัมน์
getSelectedOption แสดงตัวเลือกหรือตัวเลือกที่เลือก
getText แสดงข้อความของตัวเลือกหรือตัวเลือกที่เลือก

ชนิดคอลัมน์ตัวเลข (ทศนิยม คู่ จํานวนเต็ม เงิน)

วิธีการต่อไปนี้จะพร้อมใช้งานสําหรับคอลัมน์ทศนิยม สองเท่า และจํานวนเต็มเท่านั้น:

วิธีการ คำอธิบาย
getMax แสดงค่าที่อนุญาตสูงสุดของคอลัมน์
getMin แสดงค่าต่ําสุดที่อนุญาตของคอลัมน์
getPrecision แสดงจํานวนหลักที่อนุญาตหลังจุดทศนิยม
setPrecision ตั้งค่าจํานวนหลักที่ได้รับอนุญาตหลังจุดทศนิยม

ชนิดคอลัมน์สตริง

นอกเหนือจากวิธีการที่พร้อมใช้งานสําหรับชนิดคอลัมน์ทั้งหมดตามที่อธิบายไว้ก่อนหน้านี้ วิธีการต่อไปนี้จะพร้อมใช้งานสําหรับคอลัมน์ สตริง เท่านั้น:

วิธีการ คำอธิบาย
getMaxLength แสดงความยาวสตริงสูงสุดของคอลัมน์

ทําความเข้าใจเกี่ยวกับแบบจําลองวัตถุ Xrm
ตัวควบคุม (การอ้างอิง Client API)