Konfigurace sloupce souborů na portálech

Poznámka

S účinností od 12. října 2022 jsou portály Power Apps Power Pages. Další informace: Služba Microsoft Power Pages je nyní obecně dostupná (blog)
Zanedlouho migrujeme a sloučíme dokumentaci k portálům Power Apps s dokumentací k Power Pages.

Sloupec typu Soubor slouží k ukládání binárních dat. Tento sloupec se primárně používá k uložení jednoho souboru, poznámky nebo přílohy; je však možné ukládat i jiné formy binárních dat. Můžete nakonfigurovat sloupec souboru v základních a vícekrokových formulářích, aby bylo možné soubor odeslat, zobrazit, upravit nebo odstranit. Sloupec souboru umožňuje uložit soubory až do zadané maximální velikosti ve sloupci tabulky Microsoft Dataverse.

Důležité

• Nemůžete nahrát soubor pomocí režimu Vložit v kroku základního nebo vícekrokového formuláře.

Kód Liquid

Liquid je jazyk šablony s otevřeným zdrojovým kódem, který je nativně integrován do portálů Microsoft Power Apps. Vývojáři mohou načíst hodnoty sloupců souboru při dotazu na data pomocí fetchXML a zobrazení entity.

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

Atribut	Description
Name	Název souboru přidruženého ke sloupci
Size	Velikost souboru, v bajtech
URL	Adresa URL ke stažení souboru

Příklad: Načtení dat sloupce souboru z tabulky kontaktů

Vytvořte nový sloupec datového typu Soubor v Dataverse pro tabulku kontaktů se jménem myfileattribute.

Poznámka

Zkontrolujte, že jste konfigurovali příslušné oprávnění tabulky v tabulce kontaktů pro čtení záznamu.

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

Webové rozhraní API

Webové rozhraní API portálů můžete použít k provádění operací vytváření, čtení, aktualizaci a odstraňování na sloupcích souborů napříč tabulkami Dataverse.

Poznámka

Zkontrolujte, že jste konfigurovali nastavení webu příslušného webové rozhraní API pro tabulky a sloupce souborů, ke kterým chcete získat přístup.

Načítání dat souborů

Chcete-li načíst data souboru, použijte požadavek API popsaný v následujících příkladech.

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

Přenosy souborových dat z koncových bodů webové služby jsou omezeny na maximálně 16 MB dat v jednom volání služby. Data souboru přesahující 16 MB musí být rozdělena do 4 MB nebo menších datových bloků (kusů). Každý blok je přijímán v samostatném volání API, dokud nejsou přijata všechna data souboru. Je vaší odpovědností spojit stažené datové bloky a zformovat úplný datový soubor kombinací datových bloků ve stejném pořadí, v jakém byly bloky přijaty.

Příklad: Stažení souboru < 16 MB

Požadavek

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

Odpověď

204 No Content
Body:
Byte[ ]

Příklad: Stažení souboru > 16 MB

Požadavek

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

Odpověď

HTTP
204 No Content
Body:
Byte[ ]

Nahrání dat souboru

Chcete-li nahrát soubor, nastavte hodnotu sloupce souboru na bajtové pole, které obsahuje obsah souboru.

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

Příklad: Nahrání souboru

Požádat

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