Mengkonfigurasi kolom file di portal

Catatan

Mulai 12 Oktober 2022, portal Power Apps menjadi Power Pages. Informasi selengkapnya: Microsoft Power Pages kini tersedia secara umum (blog)
Kami akan segera memigrasikan dan menggabungkan dokumentasi portal Power Apps dengan dokumentasi Power Pages.

Kolom File digunakan untuk menyimpan data biner. Kolom ini terutama digunakan untuk menyimpan satu file, catatan, atau lampiran; namun, Anda dapat menyimpan formulir data biner lainnya. Anda dapat mengkonfigurasi bidang file pada formulir dasar dan multilangkah untuk memberikan kemampuan mengunggah, melihat, memodifikasi, atau menghapus file. Kolom file dapat menyimpan file hingga ukuran maksimum kolom tabel Microsoft Dataverse yang ditentukan.

Penting

• Anda tidak dapat mengunggah file menggunakan mode Sisipkan pada formulir dasar atau langkah formulir multilangkah.

Kode liquid

Liquid adalah bahasa template open source yang terintegrasi secara native ke dalam portal Microsoft Power Apps. Pengembang dapat mengambil nilai kolom file saat mereka mengkueri data menggunakan fetchXML dan tampilan entitas.

{% for item in tables.results.entities %}
    {{ item.columnname.Name }}
    {{ item.columnname.Size }}
    {{ item.columnname.Url }}
{% endfor %}

Atribut	Description
Nama	Nama file yang terkait dengan kolom
Ukuran	Ukuran file dalam byte
URL	URL Pengunduhan file

Contoh: Ambil data kolom file dari tabel kontak

Buat kolom jenis data file baru di Dataverse untuk tabel kontak dengan nama myfileattribute.

Catatan

Pastikan Anda telah mengkonfigurasi izin tabel yang sesuai pada tabel kontak untuk membaca rekaman.

{% 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 %}

API Web

API Web Portal dapat digunakan untuk melakukan operasi buat, perbarui, dan hapus di kolom file di semua tabel Dataverse.

Catatan

Pastikan Anda telah mengkonfigurasi pengaturan situs Web API yang sesuai untuk tabel dan kolom file yang ingin Anda akses.

Mengambil data file

Untuk mengambil data file, gunakan permintaan API yang dijelaskan dalam contoh berikut.

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

Transfer data file dari titik akhir layanan web terbatas pada maksimum 16 MB data dalam satu panggilan layanan. Data file yang melebihi 16 MB harus dibagi menjadi 4 MB atau blok data yang lebih kecil (bongkahan). Setiap blok diterima dalam panggilan API terpisah hingga semua data file diterima. Anda bertanggung jawab untuk menggabungkan blok data yang diunduh untuk membentuk file data lengkap, dengan menggabungkan blok data dalam urutan yang sama seperti blok yang diterima.

Contoh: pengunduhan file < 16 MB

Minta

HTTP
GET [Portal Url]/_api/accounts(62d53214-9dfa-eb11-94ee-0022482230a8)/myfileattribute/$value
Headers:
Content-Type: application/octet-stream

Tanggapan

204 No Content
Body:
Byte[ ]

ContOH: pengunduhan file > 16 MB

Minta

HTTP
GET [Portal Url]/_api/accounts(62d53214-9dfa-eb11-94ee-0022482230a8)/myfileattribute/$value
Headers:
Content-Type: application/octet-stream
Range: bytes=0-1023

Tanggapan

HTTP
204 No Content
Body:
Byte[ ]

Mengunggah data File

Untuk mengunggah file, atur nilai kolom file ke larik bita yang berisi konten file.

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

Contoh: Unggah file

Minta

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