Portaalien tiedostosarakkeen määrittäminen

Huomautus

Power Apps -portaaleja kutsutaan 12. lokakuuta 2022 alkaen nimellä Power Pages. Lisätietoja: Microsoft Power Pages on nyt yleisesti saatavilla (blogi)
Siirrämme ja yhdistämme Power Apps -portaalien dokumentaation pian Power Pagesin dokumentaatioon.

Tiedosto-saraketta käytetään binääridatan tallentamiseen. Tätä saraketta käytetään yleensä yksittäisen tiedoston, muistiinpanon tai liitteen tallentamista varten. On kuitenkin mahdollista tallentaa muita binaarimuotoja. Peruslomakkeiden ja monivaiheisten lomakkeiden tiedostosarake voidaan määrittää antamaan mahdollisuus ladata, näyttää, muokata ja poistaa tiedosto. Tiedostosarake voi tallentaa tiedostoja Microsoft Dataverse -taulukon sarakkeen määritettyyn enimmäiskokoon asti.

Tärkeä

• Tiedostoa ei voi ladata käyttämällä Lisää-tilaa peruslomakkeessa tai monivaiheisen lomakkeen vaiheessa.

Liquid-koodi

Liquid on avoimen lähdekoodin mallikieli, joka on integroitu natiivisti Microsoft Power Apps -portaaleihin. Kehittäjät voivat hakea tiedostosarakearvoja tietokyselyn aikana käyttämällä fetchXML-kieltä tai entiteettinäkymää.

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

Määrite	Description
Name	Sen tiedoston nimi, johon tämä sarake liittyy
Size	Tiedoston koko tavuina
URL	Tiedoston latauksen URL-osoite

Esimerkki: Tiedoston saraketietojen hakeminen yhteyshenkilötaulukosta

Luo Dataverse-yhteyshenkilötaulukkoon uusi tiedostotyyppisarake, jonka nimi on myfileattribute.

Huomautus

Varmista, että olet määrittänyt tarvittavat taulukko-oikeudet yhteyshenkilötaulukossa, jotta voit lukea tietueen.

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

Verkon ohjelmointirajapinta

Portaalien verkko-ohjelmointirajapintaa vuo käyttää tiedostosarakkeiden suoritus-, luonti-, luku-, päivitys- ja poistotoimintoihin Dataverse-taulukoissa.

Huomautus

Varmista, että olet määrittänyt soveltuvat WWW-ohjelmointirajapinnan sivustoasetukset haluamasi taulukoiden ja tiedostosarakkeiden käyttöön.

Tiedoston tietojen noutaminen

Voit hakea tiedostotiedot seuraavissa esimerkeissä kuvatussa ohjelmointirajapintapyynnössä.

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

Tiedostotietojen siirrot verkkopalvelun päätepisteistä on rajoitettu 16 Mt:n enimmäistietomäärään palvelukutsua kohden. Yli 16 megatavun tiedostotiedot on jaettava enintään 4 megatavun tietolohkoihin (paloihin). Jokainen lohko vastaanotetaan erillisessä ohjelmointirajapintakutsussa, kunnes kaikki tiedostotiedot on vastaanotettu. Sinun vastuullasi on yhdistää ladatut tietolohkot täydellisen datatiedoston muodostamiseksi yhdistämällä tietolohkot samaan järjestykseen kuin missä lohkot vastaanotettiin.

Esimerkki: Tiedoston lataus < 16 MB

Pyyntö

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

Vastaus

204 No Content
Body:
Byte[ ]

Esimerkki: Tiedoston lataus > 16 MB

Pyyntö

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

Vastaus

HTTP
204 No Content
Body:
Byte[ ]

Lataa tiedoston tiedot palvelimeen

Voit ladata tiedoston palvelimeen määrittämällä tiedostosarakkeen arvoksi tavumatriisin, joka sisältää kuvatiedoston sisällön.

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

Esimerkki: tiedoston lataaminen palvelimeen

Pyydä

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