Конфигурисање колоне датотеке на порталима

Напомена

Од 12. октобра 2022. Power Apps портали постају Power Pages. Више информација: Услуга Microsoft Power Pages је сада општедоступна (блог)
Ускоро ћемо мигрирати и објединити документацију о Power Apps порталима са документацијом о услузи Power Pages.

Колона датотеке се користи за чување бинарних података. Ова колона се првенствено користи за складиштење једне датотеке, поруке или прилога; међутим, могуће је ускладиштити друге облике бинарних података. Колону датотеке можете да конфигуришете у основним обрасцима и обрасцима са више корака да бисте обезбедили могућност отпремања, приказа, измене или брисања датотеке. Колона датотеке може да ускладишти датотеке до наведене максималне величине колоне Microsoft Dataverse табеле.

Важно

• Не можете да отпремите датотеку помоћу режима Уметање у основном обрасцу или обрасца са више корака.

Liquid кôд

Liquid је језик предлошка отвореног кода који је природно интегрисан у Microsoft Power Apps портале. Програмери могу да преузму вредности колона датотека када извршавају упит над подацима користећи FetchXML и приказ ентитета.

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

Атрибут	Опис
Именуј	Име датотеке повезано са колоном
Величина	Величина датотеке, у бајтовима
URL адреса	URL адреса за преузимање датотеке

Пример: Преузимање података колоне датотеке из табеле контаката

Креирајте нову колону типа података датотеке у услузи Dataverse за табелу контаката под именом myfileattribute.

Напомена

Уверите се да сте подесили одговарајућу дозволу за табелу контаката за читање записа.

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

Web API

Web API за портале се може користити за извршавање операција креирања, читања, ажурирања и брисања у колонама датотека у свим Dataverse табелама.

Напомена

Уверите се да сте подесили одговарајуће Web API поставке локације за табеле и колоне датотека којима желите да приступите.

Преузимање података датотеке

Да бисте преузели податке датотеке, користите API захтев описан у следећим примерима.

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

Преноси података датотека са крајњих тачака веб-услуге ограничен је на највише 16 MB података у једном позиву услуге. Подаци датотеке који премашују 16 MB морају бити подељени у блокове (делове) података од 4 MB или мање. Сваки блок се прима у посебном API позиву док се не приме сви подаци датотеке. Ваша је одговорност да саставите преузете блокове података так ода формирају комплетну датотеку података, комбинујући блокове података у истом низу у којем су блокови примљени.

Пример: Преузимање датотеке < 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[ ]

Пример: Преузимање датотеке > 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[ ]

Отпремање датотеке с подацима

Да бисте отпремили датотеку, поставите вредност колоне датотеке на низ бајтова који садржи садржај датотеке.

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

Пример: Отпремање датотеке

Request

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