องค์ประกอบคุณสมบัติ

โหนดคุณสมบัติจะกําหนดข้อมูลเฉพาะที่สามารถกําหนดค่าได้ซึ่งคอมโพเนนต์คาดหวังจาก Microsoft Dataverse

พร้อมใช้งานสําหรับ

แอปที่ขับเคลื่อนด้วยแบบจําลองและพื้นที่ทํางาน

คุณสมบัติ

ชื่อ	คำอธิบาย	ประเภท	ต้องมี	พร้อมใช้งานสําหรับ
default-value	ค่าการกําหนดค่าเริ่มต้นที่กําหนดให้กับคอมโพเนนต์ ในแอปแบบจําลองข้อมูล คุณสมบัตินี้ได้รับอนุญาตบนอินพุตเท่านั้น เนื่องจากพารามิเตอร์ที่ผูกไว้คาดว่าจะมีการเชื่อมโยงคอลัมน์	สตริง	ระบุหรือไม่ก็ได้	แอปแบบจำลอง
description-key	ใช้ในหน้าจอการกําหนดค่าเป็นสตริงที่แปลเป็นภาษาท้องถิ่นที่อธิบายคําอธิบายของคุณสมบัติ	สตริง	ระบุหรือไม่ก็ได้	แอปที่ขับเคลื่อนด้วยแบบจําลองและพื้นที่ทํางาน
display-name-key	ใช้ในหน้าจอการกําหนดค่าเป็นสตริงที่แปลเป็นภาษาท้องถิ่นที่อธิบายถึงชื่อของคุณสมบัติ	สตริง	ใช่	แอปแบบจำลอง
ชื่อ	ชื่อของคุณสมบัติ	สตริง	ใช่	แอปที่ขับเคลื่อนด้วยแบบจําลองและพื้นที่ทํางาน
of-type-group	ชื่อของชนิด-กลุ่มตามที่กําหนดในรายชื่อแฟ้ม	สตริง	ระบุหรือไม่ก็ได้	แอปแบบจำลอง
of-type	กําหนดชนิดข้อมูลของคุณสมบัติ	ดู การใช้ชนิด	ระบุหรือไม่ก็ได้	แอปที่ขับเคลื่อนด้วยแบบจําลองและพื้นที่ทํางาน
pfx-default-value	ค่านิพจน์ PFX เริ่มต้นที่กําหนดให้กับคอมโพเนนต์	ดู การใช้ pfx-default-value	ระบุหรือไม่ก็ได้	แอปพื้นที่ทำงาน
จำเป็น	กําหนดให้ต้องระบุคุณสมบัติหรือไม่	boolean	ระบุหรือไม่ก็ได้	แอปแบบจำลอง
การใช้	คุณสมบัติการใช้งานจะระบุว่าคุณสมบัติ นั้นหมายถึงการแสดงคอลัมน์ที่คอมโพเนนต์สามารถเปลี่ยนแปลง (ถูกผูกไว้), อ่านอย่างเดียว (อินพุต) หรือค่าเอาต์พุต	ผูก ป้อนข้อมูล หรือเอาท์พุต	ใช่	แอปแบบจำลอง

หมายเหตุ

ส่วนนี้ประกอบด้วยคําแนะนําเกี่ยวกับการใช้แอตทริบิวต์องค์ประกอบคุณสมบัติ

การใช้ ของ-ชนิด

ค่า of-type คุณสมบัติต้องเป็นหนึ่งในรายการต่อไปนี้:

ค่า	คำอธิบาย	พร้อมใช้งานสําหรับ
สกุลเงิน	ค่าเงินระหว่าง -922,337,203,685,477 และ 922,337,203,685,477 สามารถอยู่ในคอลัมน์นี้ได้	แอปที่ขับเคลื่อนด้วยแบบจําลองและพื้นที่ทํางาน
DateAndTime.DateAndTime	แสดงวันที่และเวลา	แอปที่ขับเคลื่อนด้วยแบบจําลองและพื้นที่ทํางาน
DateAndTime.DateOnly	แสดงวันที่เท่านั้น	แอปที่ขับเคลื่อนด้วยแบบจําลองและพื้นที่ทํางาน
ทศนิยม	สามารถใช้จุดทศนิยมของความแม่นยําได้สูงสุด 10 จุดสําหรับค่าระหว่าง -100,000,000,000 และ -100,000,000,000 สามารถอยู่ในคอลัมน์นี้ได้	แอปที่ขับเคลื่อนด้วยแบบจําลองและพื้นที่ทํางาน
Enum	ชนิดข้อมูลที่ระบุ	แอปที่ขับเคลื่อนด้วยแบบจําลองและพื้นที่ทํางาน
FP	สามารถใช้จุดทศนิยมของความแม่นยําได้สูงสุดห้าจุดสําหรับค่าระหว่าง -100,000,000,000 และ -100,000,000,000 สามารถอยู่ในคอลัมน์นี้ได้	แอปที่ขับเคลื่อนด้วยแบบจําลองและพื้นที่ทํางาน
Lookup.Simple	อนุญาตให้สําหรับการอ้างอิงเดียวไปยังตารางที่ระบุ การค้นหาแบบกําหนดเองทั้งหมดเป็นชนิดนี้	แอปแบบจำลอง
Multiple	คอลัมน์นี้สามารถมีอักขระข้อความได้สูงสุด 1,048,576 ตัว	แอปที่ขับเคลื่อนด้วยแบบจําลองและพื้นที่ทํางาน
MultiSelectOptionSet	คุณสามารถกําหนดฟอร์ม (หลัก สร้างด่วน และมุมมองด่วน) และแม่แบบอีเมลโดยการเพิ่มคอลัมน์ตัวเลือก เมื่อคุณเพิ่มคอลัมน์ตัวเลือก คุณสามารถระบุค่าหลายค่าที่พร้อมใช้งานสําหรับผู้ใช้ที่จะเลือกได้ เมื่อผู้ใช้กรอกฟอร์ม พวกเขาสามารถเลือกได้หนึ่งค่า หลายค่า หรือค่าทั้งหมดที่แสดงในรายการดรอปดาวน์	แอปที่ขับเคลื่อนด้วยแบบจําลองและพื้นที่ทํางาน
ออบเจ็กต์	ชนิดข้อมูลวัตถุ สามารถใช้ได้กับคุณสมบัติเอาต์พุตเท่านั้น	แอปที่ขับเคลื่อนด้วยแบบจําลองและพื้นที่ทํางาน
ชุดตัวเลือก	คอลัมน์นี้มีชุดของตัวเลือก แต่ละตัวเลือกมีค่าตัวเลขและป้ายชื่อ เมื่อเพิ่มไปยังฟอร์ม คอลัมน์นี้จะแสดงตัวควบคุมสําหรับผู้ใช้เมื่อต้องเลือกตัวเลือกเดียวเท่านั้น	แอปที่ขับเคลื่อนด้วยแบบจําลองและพื้นที่ทํางาน
SingleLine.Email	ซึ่งจะจัดเก็บเวลาของสตริงในรูปแบบที่ถูกต้องสําหรับอีเมล ตัวควบคุมอินเทอร์เฟซแบบรวมแบบรวมแบบทันทีจะทําให้สามารถคลิกได้โดยอัตโนมัติ	แอปที่ขับเคลื่อนด้วยแบบจําลองและพื้นที่ทํางาน
SingleLine.Phone	ซึ่งจะจัดเก็บเวลาของสตริงในรูปแบบที่ถูกต้องสําหรับ Phone ตัวควบคุมอินเทอร์เฟซแบบรวมแบบรวมแบบทันทีจะทําให้สามารถคลิกได้โดยอัตโนมัติ	แอปที่ขับเคลื่อนด้วยแบบจําลองและพื้นที่ทํางาน
SingleLine.Text	ตัวเลือกนี้จะเพียงแค่แสดงข้อความ	แอปที่ขับเคลื่อนด้วยแบบจําลองและพื้นที่ทํางาน
SingleLine.TextArea	ตัวเลือกรูปแบบนี้สามารถใช้เพื่อแสดงข้อความหลายบรรทัดได้ แต่ด้วยขีดจํากัดของอักขระ 4000 คอลัมน์ข้อความหลายบรรทัดเป็นตัวเลือกที่ดีกว่าถ้าคาดหมายว่ามีข้อความจํานวนมาก	แอปที่ขับเคลื่อนด้วยแบบจําลองและพื้นที่ทํางาน
SingleLine.Ticker	ซึ่งจะจัดเก็บเวลาของสตริงในรูปแบบที่ถูกต้องสําหรับ Ticker ตัวควบคุมอินเทอร์เฟซแบบรวมแบบรวมแบบทันทีจะทําให้สามารถคลิกได้โดยอัตโนมัติ	แอปที่ขับเคลื่อนด้วยแบบจําลองและพื้นที่ทํางาน
SingleLine.URL	ข้อความที่คาดว่าจะมีการเชื่อมโยงหลายมิติเพื่อเปิดเพจที่ระบุ ตัวควบคุมอินเทอร์เฟซแบบรวม (Unified Interface) ที่อยู่นอกกรอบจะเพิ่ม "https://" ไปยังค่าอินพุตที่ไม่ได้เริ่มต้นด้วยโพรโทคอลที่ถูกต้องโดยอัตโนมัติ ต้องการเฉพาะโปรโตคอล HTTP, HTTPS, FTPS, OneNote และ TEL ในคอลัมน์นี้	แอปที่ขับเคลื่อนด้วยแบบจําลองและพื้นที่ทํางาน
สองตัวเลือก	คอลัมน์นี้มีสองตัวเลือก แต่ละตัวเลือกมีค่าตัวเลข 0 หรือ 1 ที่สอดคล้องกับค่าเท็จหรือจริง แต่ละตัวเลือกยังมีป้ายชื่อเพื่อให้สามารถแสดงค่า true หรือ false เป็น "Yes" และ "No", "Hot" และ "Cold", "On" และ "Off" หรือป้ายชื่อใดๆ ที่คุณต้องการแสดง	แอปที่ขับเคลื่อนด้วยแบบจําลองและพื้นที่ทํางาน
Whole.None	ตัวเลือกนี้จะแสดงเพียงตัวเลขเท่านั้น	แอปที่ขับเคลื่อนด้วยแบบจําลองและพื้นที่ทํางาน

คำเตือน

ถ้า manifest.xml ไฟล์ประกอบด้วยชุดข้อมูลอย่างน้อยหนึ่งชุด จากนั้นควรตัดคุณสมบัติของชนิด Lookup.Simple ลงในองค์ประกอบ ชุดข้อมูล ด้วย

องค์ประกอบค่าที่ไม่ได้รับการสนับสนุน

ค่าคุณสมบัติต่อไปนี้ of-type ไม่ได้รับการสนับสนุนในขณะนี้:

ค่า	คำอธิบาย
Lookup.Customer	อนุญาตให้มีการอ้างอิงครั้งเดียวไปยังบัญชีหรือระเบียนผู้ติดต่อ การค้นหาเหล่านี้จะพร้อมใช้งานสําหรับตารางโอกาส กรณี ใบเสนอราคา ใบสั่ง และใบแจ้งหนี้ ตารางเหล่านี้ยังมีการค้นหาบัญชีและผู้ติดต่อแยกต่างหากที่คุณสามารถใช้ถ้าลูกค้าของคุณเป็นประเภทเดียวเสมอ หรือคุณสามารถรวมทั้งสองอย่างแทนที่จะใช้การค้นหาลูกค้า
Lookup.Owner	อนุญาตให้มีการอ้างอิงเดียวกับระเบียนทีมหรือผู้ใช้ ตารางที่ทีมหรือผู้ใช้เป็นเจ้าของทั้งหมดมีหนึ่งในตารางเหล่านี้
Lookup.PartyList	อนุญาตให้มีการอ้างอิงหลายรายการไปยังหลายตาราง การค้นหาเหล่านี้จะอยู่ในคอลัมน์ อีเมลไปยัง และ สําเนาถึง นอกจากนี้ยังใช้ในตารางโทรศัพท์และการนัดหมาย
Lookup.Regarding	อนุญาตให้มีการอ้างอิงเดียวไปยังหลายตาราง การค้นหาเหล่านี้จะพบได้ในคอลัมน์ที่เกี่ยวข้องที่ใช้ในกิจกรรม
คำอธิบายรายการของสถานะ	คอลัมน์ระบบที่มีตัวเลือกที่ให้รายละเอียดเพิ่มเติมเกี่ยวกับคอลัมน์สถานะ แต่ละตัวเลือกจะเชื่อมโยงกับหนึ่งในตัวเลือกสถานะที่พร้อมใช้งาน คุณสามารถเพิ่มและแก้ไขตัวเลือกได้
สถานะ	คอลัมน์ระบบที่มีตัวเลือกซึ่งโดยทั่วไปแล้วจะสอดคล้องกับสถานะใช้งานอยู่และไม่ได้ใช้งาน คอลัมน์ระบบบางคอลัมน์มีตัวเลือกเพิ่มเติม แต่คอลัมน์แบบกําหนดเองทั้งหมดมีตัวเลือกสถานะใช้งานอยู่และไม่ได้ใช้งานเท่านั้น
Whole.Duration	ตัวเลือกรูปแบบนี้สามารถใช้เพื่อแสดงรายการของตัวเลือกระยะเวลา แต่ข้อมูลที่จัดเก็บไว้ในฐานข้อมูลมักจะเป็นจํานวนนาที คอลัมน์มีลักษณะเหมือนรายการดรอปดาวน์ และมีตัวเลือกที่แนะนํา เช่น 1 นาที 15 นาที 30 นาทีตลอดช่วงสามวัน ผู้คนสามารถเลือกตัวเลือกเหล่านี้ได้ อย่างไรก็ตาม ผู้คนสามารถพิมพ์ได้เพียงแค่ไม่กี่นาที และแก้ไขเป็นระยะเวลานั้น
Whole.Language	ตัวเลือกนี้แสดงรายการภาษาที่เตรียมใช้งานสําหรับองค์กรของคุณ ค่าจะแสดงเป็นรายการดรอปดาวน์ของชื่อภาษา แต่ข้อมูลถูกจัดเก็บเป็นตัวเลขโดยใช้รหัส LCID รหัสภาษาคือรหัสตําแหน่งที่ตั้งสี่หลักหรือห้าหลัก ค่ารหัสตําแหน่งที่ตั้งที่ถูกต้องสามารถพบได้ที่ แผนภูมิรหัสตําแหน่งที่ตั้ง (LCID))
Whole.TimeZone	ตัวเลือกนี้แสดงรายการโซนเวลาที่เลือก เช่น (GMT-12:00) ฝั่งตะวันตกและ (GMT-08:00) เวลาแปซิฟิก (สหรัฐอเมริกาและแคนาดา) โซนแต่ละโซนเหล่านี้ถูกเก็บเป็นตัวเลข ตัวอย่างเช่น สําหรับโซนเวลา (GMT-08:00) เวลาแปซิฟิก (สหรัฐอเมริกาและแคนาดา) TimeZoneCode คือ 4

Note

ในขณะนี้ คอลัมน์ไฟล์ไม่ได้รับการสนับสนุน ข้อมูลเพิ่มเติม: คอลัมน์ไฟล์

การใช้ pfx-default-value

ใช้ค่า pfx-default-value คุณสมบัติ เพื่อประเมินเหตุการณ์และคุณสมบัติโดยใช้นิพจน์ Power Fx แทนค่าเริ่มต้นแบบคงที่ คุณสามารถใช้ข้อมูลนี้เพื่อ:

• ปรับขนาดตัวควบคุมแบบตอบสนอง
• เข้าถึงตัวเชื่อมต่อ
• ระบุข้อมูลตัวอย่าง
• คุณสมบัติอ้างอิงธีม
• เหตุการณ์ที่กำหนดเอง

Note

• คุณสามารถใช้นิพจน์ Power Fx ใด ๆ ได้ แต่คุณต้องตรวจสอบให้แน่ใจว่านิพจน์ถูกต้องเมื่อนําเข้าตัวควบคุม
• ถ้าคุณใช้เครื่องหมายอัญประกาศภายในหรืออักขระพิเศษอื่นๆ ให้ตัดค่าในเครื่องหมายอัญประกาศเดี่ยว ตัวอย่างเช่น: pfx-default-value='"Test"'
• คุณสามารถอ้างอิงตัวควบคุมอื่น ๆ (รวมถึงหน้าจอ) และคุณสมบัติได้ เขียนการอ้างอิงเหล่านี้เป็น: %ControlName.ID%.ControlProperty ตัวอย่าง: pfx-default-value='SubmitForm(%MyFormName.ID%)'
• เขียน enums เช่น DisplayType และ ScreenTransition เป็น: %EnumName.RESERVED%.EnumValue ตัวอย่าง: pfx-default-value='Back(%ScreenTransition.RESERVED%.Cover)'
• ถ้าpfx-default-valueรวมอยู่ด้วย จากนั้นจะมีความสําคัญมากกว่าdefault-value

องค์ประกอบแม่

องค์ประกอบ	คำอธิบาย
ควบคุม	กําหนดเนมสเปซ เวอร์ชัน และข้อมูลการแสดงผลของคอมโพเนนต์

ตัวอย่าง

<property name="myFirstProperty" display-name-key="myFirstProperty_Display_Key"
description-key="myFirstProperty_Desc_Key" of-type="SingleLine.Text" usage="bound" required="true" />

บทความที่เกี่ยวข้อง

การอ้างอิงสคีมารายชื่อแฟ้มของเฟรมเวิร์กคอมโพเนนต์ใน Power Apps
การอ้างอิง API ของเฟรมเวิร์กคอมโพเนนต์ Power Apps
ภาพรวมเฟรมเวิร์กคอมโพเนนต์ใน Power Apps