แชร์ผ่าน

กำหนดค่าคอลัมน์ไฟล์บนพอร์ทัล

  • บทความ

หมายเหตุ

พอร์ทัล Power Apps คือ Power Pages โดยมีผลในวันที่ 12 ตุลาคม 2022 ข้อมูลเพิ่มเติม: Microsoft Power Pages มีให้ใช้งานทั่วไป (บล็อก)
ในไม่ช้าเราจะย้ายและรวมคู่มือพอร์ทัล Power Apps เข้ากับ คู่มือ Power Pages

คอลัมน์ ไฟล์จะใช้สำหรับจัดเก็บข้อมูลไบนารี คอลัมน์นี้ใช้เพื่อจัดเก็บไฟล์ บันทึกย่อ หรือไฟล์แนบเป็นหลัก อย่างไรก็ตาม เป็นไปได้ที่จะจัดเก็บข้อมูลไบนารีในรูปแบบอื่น ๆ ด้วย คุณสามารถกำหนดค่าคอลัมน์ไฟล์บนฟอร์มพื้นฐานและฟอร์มแบบหลายขั้นตอนเพื่อให้มีความสามารถในการอัปโหลด ดู แก้ไข หรือลบไฟล์ คอลัมน์ไฟล์ทำให้คุณสามารถจัดเก็บไฟล์ได้ถึงขนาดสูงสุดที่ระบุในคอลัมน์ของตาราง Microsoft Dataverse

ภาพเคลื่อนไหวของตารางพร้อมฟิลด์สำหรับหมายเลขผลิตภัณฑ์ ชื่อผลิตภัณฑ์ และแค็ตตาล็อกผลิตภัณฑ์ ในการเติมข้อมูลในฟิลด์แค็ตตาล็อกผลิตภัณฑ์ ผู้ใช้เลือก เลือกไฟล์ จากนั้นเรียกดูไฟล์ PDF เพื่ออัปโหลดและใช้สำหรับแค็ตตาล็อกผลิตภัณฑ์

ข้อสำคัญ

  • คุณไม่สามารถอัปโหลดไฟล์โดยใช้โหมด แทรก ในขั้นตอนของฟอร์มพื้นฐานหรือฟอร์มแบบหลายขั้นตอน

รหัส Liquid

Liquid เป็นภาษาของเทมเพลตของแหล่งที่มาแบบเปิด ซึ่งถูกรวมเข้าในพอร์ทัล Microsoft Power Apps นักพัฒนาสามารถดึงค่าคอลัมน์ของไฟล์ได้ในขณะที่สอบถามข้อมูลโดยใช้ fetchXML และมุมมองเอนทิตี

{% for item in tables.results.entities %}
    {{ item.columnname.Name }}
    {{ item.columnname.Size }}
    {{ item.columnname.Url }}
{% endfor %}
แอตทริบิวต์ Description
Name ชื่อของไฟล์ที่สัมพันธ์กับคอลัมน์
Size ขนาดของไฟล์ในหน่วย (ไบต์)
URL URL ไฟล์ที่ดาวน์โหลด

ตัวอย่าง: ดึงข้อมูลคอลัมน์ไฟล์จากตารางผู้ติดต่อ

สร้างคอลัมน์ประเภทไฟล์ข้อมูลใหม่ใน Dataverse สำหรับตารางการติดต่อด้วยชื่อ myfileattribute

หมายเหตุ

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

{% fetchxml contacts %}
<fetch version="1.0" output-format="xml-platform" mapping="logical" distinct="false">
  <entity name="contact">
    <attribute name="fullname" />
    <attribute name="myfileattribute" />    
  </entity>
</fetch>
{% endfetchxml %}

{% for item in contacts.results.entities %}
        "Full Name":"{{ item.fullname }}"
        "Entity File Url":"{{ item.myfileattribute.Name }}",      
        "Entity File Size":"{{ item.myfileattribute.Size }}",
        "Entity File Type":"{{ item.myfileattribute.Url }}" 
{% endfor %}

Web API

Web API ของพอร์ทัล สามารถใช้เพื่อดำเนินการสร้าง อ่าน อัปเดต และลบ ในคอลัมน์ไฟล์ในตาราง Dataverse ได้

หมายเหตุ

ตรวจสอบให้แน่ใจว่าคุณได้กำหนดค่า Web API ที่เหมาะสม การตั้งค่าเว็บไซต์ สำหรับตารางและคอลัมน์ไฟล์ที่คุณต้องการเข้าถึง

การเรียกดูข้อมูลไฟล์

หากต้องการดึงข้อมูลไฟล์ ให้ใช้คำขอ API ที่อธิบายไว้ในตัวอย่างต่อไปนี้

GET /_api/<entity-type>(id)/<file-attribute-name>/$value

การถ่ายโอนข้อมูลไฟล์จากจุดสิ้นสุดของบริการเว็บจำกัดข้อมูลสูงสุดที่ 16 MB ในการเรียกใช้บริการครั้งเดียว ข้อมูลไฟล์ที่เกิน 16 MB ต้องแบ่งออกเป็น 4 MB หรือบล็อกข้อมูล (chunks) ที่เล็กกว่า แต่ละบล็อกจะได้รับในการเรียก API แยกต่างหาก จนกว่าจะได้รับข้อมูลไฟล์ทั้งหมด เป็นความรับผิดชอบของคุณที่จะเข้าร่วมบล็อกข้อมูลที่ดาวน์โหลดจากไฟล์ข้อมูลที่สำเร็จ โดยการรวมบล็อคข้อมูลในลำดับเดียวกันกับที่ได้รับบล็อก

ตัวอย่าง: ไฟล์ที่ดาวน์โหลด < 16 MB

ส่งคำขอ
HTTP
GET [Portal Url]/_api/accounts(62d53214-9dfa-eb11-94ee-0022482230a8)/myfileattribute/$value
Headers:
Content-Type: application/octet-stream
การตอบสนอง
204 No Content
Body:
Byte[ ]

ตัวอย่าง: ไฟล์ที่ดาวน์โหลด > 16 MB

ส่งคำขอ
HTTP
GET [Portal Url]/_api/accounts(62d53214-9dfa-eb11-94ee-0022482230a8)/myfileattribute/$value
Headers:
Content-Type: application/octet-stream
Range: bytes=0-1023
การตอบสนอง
HTTP
204 No Content
Body:
Byte[ ]

อัปโหลดไฟล์ข้อมูล

หากต้องการอัปโหลดไฟล์ ให้ตั้งค่าคอลัมน์ไฟล์เป็นอาร์เรย์ไบต์ที่มีเนื้อหาของไฟล์

PUT or PATCH /_api/<entity-type>(id)/<file-attribute-name>

ตัวอย่าง: การอัปโหลดไฟล์

ส่งคำขอ
HTTP
PUT [Portal Url]/_api/accounts(62d53214-9dfa-eb11-94ee-0022482230a8)/myfileattribute
Headers:
Content-Type: application/octet-stream
Body :
Byte [ ]