Konfigurer en filkolonne for portaler

Obs!

Fra og med 12. oktober 2022 er Power Apps-portaler Power Pages. Mer informasjon: Microsoft Power Pages er nå tilgjengelig (blogg)
Vi overfører og slår snart sammen Power Apps-portaldokumentasjonen med Power Pages-dokumentasjonen.

En filkolonne brukes til å lagre binære data. Denne kolonnen brukes primært til å lagre én enkelt fil, ett notat eller et vedlegg. Det er imidlertid mulig å lagre andre former for binærdata. Du kan konfigurere en filkolonne i standardskjemaer og flertrinnsskjemaer for å gi mulighet til å laste opp, vise, endre eller slette filen. Filkolonnen kan lagre filer opptil angitt maksimumsstørrelse til en Microsoft Dataverse-tabellkolonne.

Viktig

• Du kan ikke laste opp en fil ved å bruke innsettingsmodus i et standardskjema eller et trinn i et flertrinnsskjema.

Liquid-kode

Liquid er et open-source-malspråk som er integrert opprinnelig i Microsoft Power Apps-portaler. Utviklere kan hente filkolonneverdier når de spør etter data ved å bruke fetchXML og enhetsvisning.

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

Attributt	Bekrivelse
Name	Navnet på filen som er tilknyttet kolonnen
Size	Filstørrelse i byte
URL	URL-adresse for å laste ned filen

Eksempel: Hente filkolonnedata fra en kontakttabell

Opprett en ny fildatatypekolonne i Dataverse for en kontakttabell med navnet myfileattribute.

Obs!

Kontroller at du har konfigurert de aktuelle tabelltillatelsene i kontakttabellen, slik at oppføringen kan leses.

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

Nett-API

Nett-API-en for portaler kan brukes til å utføre, opprette, lese, oppdatere og slette operasjoner i filkolonner på tvers av Dataverse-tabeller.

Obs!

Kontroller at du har konfigurert de riktige Web-API for nettstedsinnstillinger for tabellene og filkolonnene du vil ha tilgang til.

Hente fildata

Bruk API-forespørselen beskrevet i eksemplene nedenfor for å hente fildata.

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

Overføring av fildata fra endepunktene til nettjenesten er begrenset til maksimalt 16 MB med data i ett tjenesteoppkall. Fildata som overskrider 16 MB, må deles inn i 4 MB eller mindre datablokker (biter). Hver blokk mottas i et separat API-kall til alle fildataene er mottatt. Det er ditt ansvar å føye sammen de nedlastede datablokkene for å danne den fullstendige datafilen ved å kombinere datablokkene i samme rekkefølge som blokkene ble mottatt.

Eksempel: Filnedlasting < 16 MB

Forespørsel

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

Svar

204 No Content
Body:
Byte[ ]

Eksempel: Filnedlasting > 16 MB

Forespørsel

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

Svar

HTTP
204 No Content
Body:
Byte[ ]

Last opp fildata

For å laste opp filen angir du en bytematrise for verdien i filkolonnen som inneholder innholdet i filen.

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

Eksempel: filopplasting

Forespørsel

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