แชร์ผ่าน


ฟังก์ชัน DataSourceInfo

นําไปใช้กับ: แอป พื้นที่ทํางานแอปแบบจําลองข้อมูล

แสดงข้อมูลเกี่ยวกับ แหล่งข้อมูล

ภาพรวม

แหล่งข้อมูลสามารถให้ประโยชน์ของข้อมูลเพื่อปรับประสบการณ์ของผู้ใช้ให้เหมาะสมที่สุด

คุณสามารถใช้ข้อมูลระดับ คอลัมน์ เพื่อตรวจสอบความถูกต้องของการป้อนข้อมูลของผู้ใช้ และให้ข้อคิดเห็นกับผู้ใช้ทันที ก่อนที่จะใช้ฟังก์ชัน Patch ฟังก์ชัน Validate ใช้ข้อมูลเดียวกัน

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

แหล่งข้อมูลแตกต่างกันตามปริมาณข้อมูลที่มี รวมถึงการไม่มีข้อมูลใดให้เลย คอลเลกชัน ไม่ได้ให้ข้อมูลใดๆ ถ้าไม่มีข้อมูลบางส่วนให้ ข้อมูลเริ่มต้นจะถูกใช้แทน หรือส่งกลับ ค่าว่าง

หมายเหตุ

ในปัจจุบัน DataSourceInfo ฟังก์ชันนี้ไม่ได้รับการสนับสนุนในรายการ Microsoft

คำอธิบาย

ข้อมูลคอลัมน์

คุณสามารถใช้ DataSourceInfo เพื่อรับข้อมูลเกี่ยวกับคอลัมน์เฉพาะของแหล่งข้อมูลได้:

อาร์กิวเมนต์ข้อมูล ชนิดผลลัพธ์ คำอธิบาย
DataSourceInfo. DisplayName String ชื่อที่แสดงสำหรับคอลัมน์ ถ้าไม่มีชื่อที่แสดงกำหนดไว้ จะส่งกลับชื่อคอลัมน์นั้น
DataSourceInfo. MaxLength ตัวเลข จำนวนสูงสุดของอักขระที่คอลัมน์สามารถเก็บไว้ได้ ใช้กับคอลัมน์ที่มีสตริงเท่านั้น ถ้าไม่ได้ตั้งค่าสูงสุด ส่งกลับ ว่างเปล่า
DataSourceInfo. MaxValue ตัวเลข ค่าตัวเลขสูงสุดที่คอลัมน์สามารถเก็บไว้ได้ ใช้กับคอลัมน์ที่มีตัวเลขเท่านั้น ถ้าไม่ได้ตั้งค่าสูงสุด ส่งกลับ ว่างเปล่า
DataSourceInfo. MinValue ตัวเลข ค่าตัวเลขต่ำสุดที่คอลัมน์สามารถเก็บไว้ได้ ใช้กับคอลัมน์ที่มีตัวเลขเท่านั้น ถ้าไม่ได้กำหนดค่าต่ำสุดไว้ จะส่งกลับ ว่างเปล่า
DataSourceInfo. ต้องระบุ แบบบูลีน จำเป็นต้องมีค่าในคอลัมน์นี้หรือไม่ ถ้าไม่ได้ตั้งค่าโดยแหล่งข้อมูล จะส่งกลับ เท็จ

อาร์กิวเมนต์ที่สามคือชื่อของคอลัมน์เป็นสตริง ตัวอย่างเช่น คอลัมน์ โทรศัพท์ ในคอลเลกชัน บุคคล จะมีการส่งผ่านเป็น "โทรศัพท์" โดยรวมถึงเครื่องหมายอัญประกาศ

ข้อมูลแหล่งข้อมูล

นอกจากนี้ คุณยังสามารถใช้ DataSourceInfo เพื่อรับข้อมูลเกี่ยวกับแหล่งข้อมูลทั้งหมด:

อาร์กิวเมนต์ข้อมูล ชนิดผลลัพธ์ คำอธิบาย
DataSourceInfo. AllowedValues แบบบูลีน ชนิดของสิทธิ์ใดสำหรับแหล่งข้อมูลนี้ที่สามารถมอบให้ผู้ใช้ได้ ถ้าไม่ถูกตั้งค่าโดยแหล่งข้อมูล จะส่งกลับ ว่างเปล่า
DataSourceInfo. สร้าง Permission แบบบูลีน ผู้ใช้ปัจจุบันมีสิทธิ์ในการสร้างเรกคอร์ดในแหล่งข้อมูลนี้หรือไม่ ถ้าไม่ได้ตั้งค่าโดยแหล่งข้อมูล จะส่งกลับ จริง
DataSourceInfo. DeletePermission แบบบูลีน ผู้ใช้ปัจจุบันมีสิทธิ์ในการลบเรกคอร์ดในแหล่งข้อมูลนี้หรือไม่ ถ้าไม่ได้ตั้งค่าโดยแหล่งข้อมูล จะส่งกลับ จริง
DataSourceInfo. EditPermission แบบบูลีน ผู้ใช้ปัจจุบันมีสิทธิ์ในการแก้ไขเรกคอร์ดในแหล่งข้อมูลนี้หรือไม่ ถ้าไม่ได้ตั้งค่าโดยแหล่งข้อมูล จะส่งกลับ จริง
DataSourceInfo. ReadPermission แบบบูลีน ผู้ใช้ปัจจุบันมีสิทธิ์ในการอ่านไขเรกคอร์ดในแหล่งข้อมูลนี้หรือไม่ ถ้าไม่ได้ตั้งค่าโดยแหล่งข้อมูล จะส่งกลับ จริง

หมายเหตุ

DataSourceInfo แสดงค่า true ถ้าไม่สามารถกําหนดได้ว่าผู้ใช้ปัจจุบันมีสิทธิ์ที่ร้องขอหรือไม่ เซิร์ฟเวอร์จะตรวจสอบสิทธิ์อีกครั้งเมื่อดำเนินการจริงและข้อผิดพลาดจะปรากฏขึ้นหากไม่ได้รับอนุญาต ในขณะนี้ การตรวจสอบสิทธิ์ด้วย DataSourceInfo จะสามารถทําได้เมื่อใช้ Microsoft Dataverse เท่านั้น

ไวยากรณ์

DataSourceInfo( DataSource, Information [, ColumnName] )

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

หมายเหตุ

ใน Power Apps ก่อนเวอร์ชัน 3.24042 ชื่อคอลัมน์ถูกระบุด้วยสตริงข้อความโดยใช้เครื่องหมายคำพูดคู่ และหากเชื่อมต่อกับแหล่งข้อมูล ชื่อคอลัมน์ก็จะต้องเป็นชื่อเชิงตรรกะด้วย ตัวอย่างเช่น ชื่อตรรกะ "cr43e_name" ที่มีเครื่องหมายคำพูดคู่ถูกนำมาใช้แทนชื่อที่แสดง ชื่อ ที่ไม่มีเครื่องหมายคำพูด สำหรับแหล่งข้อมูล SharePoint และ Excel ที่มีชื่อคอลัมน์ที่มีการเว้นวรรค แต่ละช่องว่างจะถูกระบุด้วย "_x0020_" เช่น "ชื่อคอลัมน์" เป็น "Column_x0020_Name" หลังจากเวอร์ชันนี้ แอปทั้งหมดได้รับการอัปเดตโดยอัตโนมัติเป็นไวยากรณ์ใหม่ที่อธิบายไว้ในบทความนี้

ตัวอย่าง

ตัวอย่างในส่วนนี้ใช้นี้แหล่งข้อมูลชื่อ IceCream:

IceCream ตัวอย่าง

แหล่งข้อมูลยังให้ข้อมูลนี้:

  • ชื่อที่แสดงสำหรับ ปริมาณ คือ "ปริมาณที่ถือครอง"
  • ความยาวสูงสุดของ Flavor คือ 30 อักขระ
  • คอลัมน์ Flavor ต้องมีค่า คอลัมน์ ปริมาณ ไม่จำเป็นต้องมี
  • ค่าต่ำสุดของ ปริมาณ คือ 0
  • ค่าสูงสุดของ ปริมาณ คือ 100
  • ผู้ใช้ปัจจุบันสามารถอ่านและแก้ไขเรกคอร์ดของแหล่งข้อมูล IceCream ได้ แต่ไม่สามารถสร้างหรือลบเรกคอร์ดได้
สูตร คำอธิบาย ผลลัพธ์
DataSourceInfo( ไอศกรีม, DataSourceInfo. DisplayName, Quantity ) ส่งกลับชื่อที่แสดงสำหรับคอลัมน์ ปริมาณ ของแหล่งข้อมูล IceCream "ปริมาณที่ถือครอง"
DataSourceInfo( ไอศกรีม, DataSourceInfo. MaxLength, Flavor ) ส่งกลับความยาวสูงสุดของสตริงคอลัมน์ Flavor ของแหล่งข้อมูล IceCream 30
DataSourceInfo( ไอศกรีม, DataSourceInfo. จําเป็น, รสชาติ ) จำเป็นต้องมีคอลัมน์ Flavor ของแหล่งข้อมูล IceCream หรือไม่ จริง
DataSourceInfo( ไอศกรีม, DataSourceInfo. Required, Quantity ) จำเป็นต้องมีคอลัมน์ ปริมาณ ของแหล่งข้อมูล IceCream หรือไม่ เท็จ
DataSourceInfo( ไอศกรีม, DataSourceInfo. MaxValue, Quantity ) ส่งกลับค่าตัวเลขสูงสุดสำหรับคอลัมน์ ปริมาณ ของแหล่งข้อมูล IceCream 100
DataSourceInfo( ไอศกรีม, DataSourceInfo. MinValue, Quantity ) ส่งกลับค่าตัวเลขต่ำสุดสำหรับคอลัมน์ ปริมาณ ของแหล่งข้อมูล IceCream 0
DataSourceInfo( ไอศกรีม, DataSourceInfo. ReadPermission) ผู้ใช้ปัจจุบันสามารถอ่านเรกคอร์ดในแหล่งข้อมูล IceCream ได้หรือไม่ จริง
DataSourceInfo( ไอศกรีม, DataSourceInfo. EditPermission) ผู้ใช้ปัจจุบันสามารถแก้ไขเรกคอร์ดในแหล่งข้อมูล IceCream ได้หรือไม่ จริง
DataSourceInfo( ไอศกรีม, DataSourceInfo. สร้าง Permission) ผู้ใช้ปัจจุบันสามารถสร้างเรกคอร์ดในแหล่งข้อมูล IceCream ได้หรือไม่ เท็จ
DataSourceInfo( ไอศกรีม, DataSourceInfo. DeletePermission) ผู้ใช้ปัจจุบันสามารถลบเรกคอร์ดในแหล่งข้อมูล IceCream ได้หรือไม่ เท็จ