Configurați o coloană de fișiere pe portaluri

Notă

Începând cu 12 octombrie 2022, portalurile Power Apps sunt Power Pages. Mai multe informații: Microsoft Power Pages este acum disponibil în general (blog)
În curând vom migra și vom îmbina documentația portalurilor Power Apps cu documentația Power Pages.

O coloană de fișiere este utilizată pentru stocarea datelor binare. Această coloană este utilizată în principal pentru a stoca un singur fișier, notă sau atașament; cu toate acestea, este posibil să stocați și alte forme de date binare. Puteți configura o coloană de fișiere pe formulare de bază și cu mai mulți pași pentru a oferi capacitatea de a încărca, vizualiza, modifica sau șterge fișierul. Coloana de fișiere poate stoca fișiere până la dimensiunea maximă specificată a unei coloane de tabel Microsoft Dataverse.

Important

• Nu puteți încărca un fișier utilizând modul Inserați într-un formular de bază sau într-un pas al unui formular cu mai mulți pași.

Codul Liquid

Liquid este un limbaj de șablon open-source care este integrat nativ în portaluri Microsoft Power Apps. Dezvoltatorii pot regăsi valorile coloanelor de fișiere atunci când interoghează date utilizând fetchXML și vizualizarea entității.

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

Atribut	Descriere
Nume	Numele fișierului asociat cu coloana
Dimensiune	Dimensiunea fișierului, în bytes
Adresă URL	URL de descărcare a fișierului

Exemplu: Regăsiți datele coloanei de fișiere dintr-un tabel de persoane de contact

Creați o nouă coloană de fișiere tip de date în Dataverse pentru un tabel de persoane de contact cu numele myfileattribute.

Notă

Asigurați-vă că ați configurat permisiunea corespunzătoare în tabelul persoanelor de contact pentru a citi înregistrarea.

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

Portalurile Web API se pot utiliza pentru a efectua operațiuni de creare, citire, actualizare și ștergere în coloanele de fișiere din toate tabelele Dataverse.

Notă

Asigurați-vă că ați configurat setările corespunzătoare ale site-ului Web API pentru tabelele și coloanele de fișiere pe care doriți să le accesați.

Se regăsesc datele fișierelor

Pentru a regăsi datele fișierelor, utilizați solicitarea API descrisă în exemplele următoare.

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

Transferurile de date ale fișierelor de la punctele finale ale serviciului web sunt limitate la maximum 16 MB de date într-un singur apel de serviciu. Datele fișierelor care depășesc 16 MB trebuie împărțite în blocuri de date de 4 MB sau mai mici (bucăți). Fiecare bloc este primit într-un apel API separat până când toate datele fișierului au fost primite. Este responsabilitatea dvs. să alăturați blocurile de date descărcate pentru a forma fișierul de date complet, combinând blocurile de date în aceeași ordine în care au fost primite.

Exemplu: descărcați un fișier < 16 MB

Request

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

Response

204 No Content
Body:
Byte[ ]

Exemplu: descărcați un fișier > 16 MB

Request

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

Response

HTTP
204 No Content
Body:
Byte[ ]

Încărcarea datelor unui fișier

Pentru a încărca fișierul, setați valoarea coloanei de fișiere la o matrice de octeți care include conținutul fișierului.

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

Exemplu: încărcați un fișier

Request

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