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