ฟังก์ชัน DataSourceInfo
ใช้กับ:
แอปพื้นที่ทำงาน แอปแบบจำลอง
แสดงข้อมูลเกี่ยวกับ แหล่งข้อมูล
ภาพรวม
แหล่งข้อมูลสามารถให้ประโยชน์ของข้อมูลเพื่อปรับประสบการณ์ของผู้ใช้ให้เหมาะสมที่สุด
คุณสามารถใช้ข้อมูลระดับ คอลัมน์ เพื่อตรวจสอบความถูกต้องของการป้อนข้อมูลของผู้ใช้ และให้ข้อคิดเห็นกับผู้ใช้ทันที ก่อนที่จะใช้ฟังก์ชัน Patch ฟังก์ชัน Validate ใช้ข้อมูลเดียวกัน
คุณสามารถใช้ข้อมูลที่ระดับแหล่งข้อมูล ตัวอย่างเช่น เพื่อปิดใช้งานหรือซ่อนปุ่ม แก้ไข และ สร้าง สำหรับผู้ใช้ที่ไม่มีสิทธิ์ในการแก้ไข และสร้าง เรกคอร์ด
แหล่งข้อมูลแตกต่างกันตามปริมาณข้อมูลที่มี รวมถึงการไม่มีข้อมูลใดให้เลย คอลเลกชัน ไม่มีข้อมูล ถ้าไม่มีข้อมูลบางส่วนให้ ข้อมูลเริ่มต้นจะถูกใช้แทน หรือส่งกลับ ค่าว่าง
หมายเหตุ
ปัจจุบัน ไม่รองรับฟังก์ชัน DataSourceInfo ใน Microsoft Lists
คำอธิบาย
ข้อมูลคอลัมน์
คุณสามารถใช้ DataSourceInfo เพื่อรับข้อมูลเกี่ยวกับคอลัมน์ที่เฉพาะเจาะจงของแหล่งข้อมูลได้:
| อาร์กิวเมนต์ข้อมูล | ชนิดผลลัพธ์ | คำอธิบาย |
|---|---|---|
| DataSourceInfo.DisplayName | String | ชื่อที่แสดงสำหรับคอลัมน์ ถ้าไม่มีชื่อที่แสดงกำหนดไว้ จะส่งกลับชื่อคอลัมน์นั้น |
| DataSourceInfo.MaxLength | ตัวเลข | จำนวนสูงสุดของอักขระที่คอลัมน์สามารถเก็บไว้ได้ ใช้กับคอลัมน์ที่มีสตริงเท่านั้น ถ้าไม่ได้ตั้งค่าสูงสุด ส่งกลับ ว่างเปล่า |
| DataSourceInfo.MaxValue | ตัวเลข | ค่าตัวเลขสูงสุดที่คอลัมน์สามารถเก็บไว้ได้ ใช้กับคอลัมน์ที่มีตัวเลขเท่านั้น ถ้าไม่ได้ตั้งค่าสูงสุด ส่งกลับ ว่างเปล่า |
| DataSourceInfo.MinValue | ตัวเลข | ค่าตัวเลขต่ำสุดที่คอลัมน์สามารถเก็บไว้ได้ ใช้กับคอลัมน์ที่มีตัวเลขเท่านั้น ถ้าไม่ได้กำหนดค่าต่ำสุดไว้ จะส่งกลับ ว่างเปล่า |
| DataSourceInfo.Required | แบบบูลีน | จำเป็นต้องมีค่าในคอลัมน์นี้หรือไม่ ถ้าไม่ได้ตั้งค่าโดยแหล่งข้อมูล จะส่งกลับ เท็จ |
อาร์กิวเมนต์ที่สามคือชื่อของคอลัมน์เป็นสตริง ตัวอย่างเช่น คอลัมน์ โทรศัพท์ ในคอลเลกชัน บุคคล จะมีการส่งผ่านเป็น "โทรศัพท์" โดยรวมถึงเครื่องหมายอัญประกาศ
ข้อมูลแหล่งข้อมูล
คุณสามารถใช้ DataSourceInfo เพื่อรับข้อมูลเกี่ยวกับแหล่งข้อมูลทั้งหมดได้:
| อาร์กิวเมนต์ข้อมูล | ชนิดผลลัพธ์ | คำอธิบาย |
|---|---|---|
| DataSourceInfo.AllowedValues | แบบบูลีน | ชนิดของสิทธิ์ใดสำหรับแหล่งข้อมูลนี้ที่สามารถมอบให้ผู้ใช้ได้ ถ้าไม่ถูกตั้งค่าโดยแหล่งข้อมูล จะส่งกลับ ว่างเปล่า |
| DataSourceInfo.CreatePermission | แบบบูลีน | ผู้ใช้ปัจจุบันมีสิทธิ์ในการสร้างเรกคอร์ดในแหล่งข้อมูลนี้หรือไม่ ถ้าไม่ได้ตั้งค่าโดยแหล่งข้อมูล จะส่งกลับ จริง |
| DataSourceInfo.DeletePermission | แบบบูลีน | ผู้ใช้ปัจจุบันมีสิทธิ์ในการลบเรกคอร์ดในแหล่งข้อมูลนี้หรือไม่ ถ้าไม่ได้ตั้งค่าโดยแหล่งข้อมูล จะส่งกลับ จริง |
| DataSourceInfo.EditPermission | แบบบูลีน | ผู้ใช้ปัจจุบันมีสิทธิ์ในการแก้ไขเรกคอร์ดในแหล่งข้อมูลนี้หรือไม่ ถ้าไม่ได้ตั้งค่าโดยแหล่งข้อมูล จะส่งกลับ จริง |
| DataSourceInfo.ReadPermission | แบบบูลีน | ผู้ใช้ปัจจุบันมีสิทธิ์ในการอ่านไขเรกคอร์ดในแหล่งข้อมูลนี้หรือไม่ ถ้าไม่ได้ตั้งค่าโดยแหล่งข้อมูล จะส่งกลับ จริง |
หมายเหตุ
DataSourceInfo ส่งกลับค่า จริง หากไม่สามารถระบุได้ว่าผู้ใช้ปัจจุบันมีสิทธิ์ที่ร้องขอหรือไม่ เซิร์ฟเวอร์จะตรวจสอบสิทธิ์อีกครั้งเมื่อดำเนินการจริงและข้อผิดพลาดจะปรากฏขึ้นหากไม่ได้รับอนุญาต ขณะนี้ การตรวจสอบการอนุญาตด้วย DataSourceInfo ทำได้เฉพาะเมื่อใช้ Microsoft Dataverse
ไวยากรณ์
DataSourceInfo(DataSource, Information [, ColumnName])
- DataSource – จำเป็น แหล่งข้อมูลสำหรับการใช้
- ข้อมูล - จำเป็นต้องมี ชนิดข้อมูลของที่คุณต้องการเรียกใช้
- ColumnName - ไม่บังคับ ชื่อคอลัมน์ที่ดึงข้อมูลระดับคอลัมน์ สำหรับข้อมูลที่ระดับแหล่งข้อมูล อาร์กิวเมนต์ ColumnName ไม่สามารถใช้ได้
หมายเหตุ
ใน Power Apps ก่อนเวอร์ชัน 3.24042 ชื่อคอลัมน์ถูกระบุด้วยสตริงข้อความโดยใช้เครื่องหมายคำพูดคู่ และหากเชื่อมต่อกับแหล่งข้อมูล ชื่อคอลัมน์ก็จะต้องเป็นชื่อเชิงตรรกะด้วย ตัวอย่างเช่น ชื่อตรรกะ "cr43e_name" ที่มีเครื่องหมายคำพูดคู่ถูกนำมาใช้แทนชื่อที่แสดง ชื่อ ที่ไม่มีเครื่องหมายคำพูด สำหรับแหล่งข้อมูล SharePoint และ Excel ที่มีชื่อคอลัมน์ที่มีการเว้นวรรค แต่ละช่องว่างจะถูกระบุด้วย "_x0020_" เช่น "ชื่อคอลัมน์" เป็น "Column_x0020_Name" หลังจากเวอร์ชันนี้ แอปทั้งหมดได้รับการอัปเดตโดยอัตโนมัติเป็นไวยากรณ์ใหม่ที่อธิบายไว้ในบทความนี้
ตัวอย่าง
ตัวอย่างในส่วนนี้ใช้นี้แหล่งข้อมูลชื่อ IceCream:
แหล่งข้อมูลยังให้ข้อมูลนี้:
- ชื่อที่แสดงสำหรับ ปริมาณ คือ "ปริมาณที่ถือครอง"
- ความยาวสูงสุดของ Flavor คือ 30 อักขระ
- คอลัมน์ Flavor ต้องมีค่า คอลัมน์ ปริมาณ ไม่จำเป็นต้องมี
- ค่าต่ำสุดของ ปริมาณ คือ 0
- ค่าสูงสุดของ ปริมาณ คือ 100
- ผู้ใช้ปัจจุบันสามารถอ่านและแก้ไขเรกคอร์ดของแหล่งข้อมูล IceCream ได้ แต่ไม่สามารถสร้างหรือลบเรกคอร์ดได้
| สูตร | คำอธิบาย | ผลลัพธ์ |
|---|---|---|
| DataSourceInfo(IceCream, DataSourceInfo.DisplayName, Quantity) | ส่งกลับชื่อที่แสดงสำหรับคอลัมน์ ปริมาณ ของแหล่งข้อมูล IceCream | "ปริมาณที่ถือครอง" |
| DataSourceInfo(IceCream, DataSourceInfo.MaxLength, Flavor) | ส่งกลับความยาวสูงสุดของสตริงคอลัมน์ Flavor ของแหล่งข้อมูล IceCream | 30 |
| DataSourceInfo(IceCream, DataSourceInfo.Required, Flavor) | จำเป็นต้องมีคอลัมน์ Flavor ของแหล่งข้อมูล IceCream หรือไม่ | จริง |
| DataSourceInfo(IceCream, DataSourceInfo.Required, Quantity) | จำเป็นต้องมีคอลัมน์ ปริมาณ ของแหล่งข้อมูล IceCream หรือไม่ | เท็จ |
| DataSourceInfo(IceCream, DataSourceInfo.MaxValue, Quantity) | ส่งกลับค่าตัวเลขสูงสุดสำหรับคอลัมน์ ปริมาณ ของแหล่งข้อมูล IceCream | 100 |
| DataSourceInfo(IceCream, DataSourceInfo.MinValue, Quantity) | ส่งกลับค่าตัวเลขต่ำสุดสำหรับคอลัมน์ ปริมาณ ของแหล่งข้อมูล IceCream | 0 |
| DataSourceInfo( IceCream, DataSourceInfo.ReadPermission) | ผู้ใช้ปัจจุบันสามารถอ่านเรกคอร์ดในแหล่งข้อมูล IceCream ได้หรือไม่ | true |
| DataSourceInfo( IceCream, DataSourceInfo.EditPermission) | ผู้ใช้ปัจจุบันสามารถแก้ไขเรกคอร์ดในแหล่งข้อมูล IceCream ได้หรือไม่ | true |
| DataSourceInfo( IceCream, DataSourceInfo.CreatePermission) | ผู้ใช้ปัจจุบันสามารถสร้างเรกคอร์ดในแหล่งข้อมูล IceCream ได้หรือไม่ | false |
| DataSourceInfo( IceCream, DataSourceInfo.DeletePermission) | ผู้ใช้ปัจจุบันสามารถลบเรกคอร์ดในแหล่งข้อมูล IceCream ได้หรือไม่ | false |