Konfiguriranje stolpca za datoteke na portalih

Opomba

Od 12. oktobra 2022 najprej je portal Power Apps Power Pages. Več informacij: Microsoft Power Pages je zdaj splošno dostopen (spletni dnevnik)
Dokumentacijo portalov Power Apps bomo kmalu preselili in združili z dokumentacijo za Power Pages.

Stolpec datoteke se uporablja za shranjevanje binarnih podatkov. Ta stolpec se uporablja predvsem za shranjevanje posamezne datoteke, opombe ali priloge; vendar pa je mogoče shraniti druge oblike binarnih podatkov. Datotečni stolpec lahko konfigurirate na osnovnih in obrazcih z več koraki, da omogočite nalaganje, ogled, spreminjanje ali brisanje datoteke. Stolpec datoteke lahko shrani datoteke do podane največje velikosti stolpca tabele Microsoft Dataverse.

Pomembno

• Datoteke ne morete naložiti z uporabo načina Vstavi na osnovnem obrazcu ali v koraku večstopenjskega obrazca.

Koda Liquid

Liquid je odprtokodni jezik predloge, ki je izvirno integriran v portale Microsoft Power Apps. Razvijalci lahko pridobijo vrednosti stolpca datoteke, ko poizvedujejo po podatkih z uporabo fetchXML in pogleda entitete.

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

Atribut	Description
Imenu	Ime datoteke, ki je povezana s stolpcem.
Velikost	Velikost datoteke v bajtih
URL	Prenos datotek URL

Primer: Pridobite podatke stolpca datoteke iz tabele stikov

Ustvarite nov stolpec vrste podatkov datoteke Dataverse za kontaktno tabelo z imenom myfileattribute.

Opomba

Prepričajte se, da ste konfigurirali ustrezno dovoljenje tabele za tabelo stikov za branje zapisa.

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

Spletni API

Spletni API portalov se lahko uporablja za izvajanje, ustvarjanje, branje, posodabljanje in brisanje postopkov v stolpcih v tabelah Dataverse.

Opomba

Prepričajte se, da ste konfigurirali ustrezen spletni API nastavitve mesta za tabele in stolpce datotek, do katerih želite dostopati.

Pridobivanje podatkov datoteke

Za pridobivanje podatkov datoteke uporabite zahtevo API, opisano v naslednjih primerih.

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

Prenos podatkov o datotekah iz končnih točk spletnih storitev je omejen na največ 16 MB podatkov v enem klicu storitve. Datotečne podatke, ki presegajo 16 MB, je treba razdeliti na 4 MB ali manjše podatkovne bloke (časovna obdobja). Vsak blok je prejet v ločenem klicu API-ja, dokler niso prejeti vsi podatki datoteke. Vaša odgovornost je, da prenesene podatkovne bloke združite v celotno podatkovno datoteko, tako da združite podatkovne bloke v enakem zaporedju, kot so bili prejeti bloki.

Primer: Prenos datotek < 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[ ]

Primer: Prenos datotek > 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[ ]

Prenos podatkovne datoteke

Če želite naložiti datoteko, nastavite vrednost stolpca z datotekami na nabor bajtov, ki vsebuje vsebino datoteke.

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

Primer: nalaganje datoteke

Request

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