Llegeix en anglès

Comparteix a través de

Configurar la columna d'un fitxer al Power Pages

  • Article

La columna de fitxer s'utilitza per emmagatzemar dades binàries. Aquesta columna s'utilitza principalment per emmagatzemar un únic fitxer, nota o fitxer adjunt; tanmateix, és possible emmagatzemar altres formularis de dades binàries. Podeu configurar una columna del fitxer en formularis bàsics i de múltiples pasos per proporcionar la capacitat de carregar, visualitzar, modificar o suprimir el fitxer. La columna del fitxer pot emmagatzemar fitxers fins a la mida màxima de la columna de taula del Microsoft Dataverse.

Animació d'una taula amb camps per al número de producte, el nom del producte i el catàleg de productes. Per emplenar el camp Catàleg de productes, l'usuari selecciona Trieu un fitxer i, a continuació, navega a un fitxer PDF per carregar-lo i utilitzar-lo per al catàleg de productes.

Important

  • No podeu carregar un fitxer mitjançant el mode d'Inserció en un formulari bàsic o un pas de formulari de diversos pasos.

Codi Liquid

Liquid és un llenguatge de plantilla de codi obert integrat nativament al Microsoft Power Pages. Els desenvolupadors poden recuperar valors de columna dels fitxers quan fan consultes de dades mitjançant fetchXML i la visualització d'entitats.

{% for item in tables.results.entities %}
    {{ item.columnname.Name }}
    {{ item.columnname.Size }}
    {{ item.columnname.Url }}
{% endfor %}
Atribut Descripció
Nom El nom del fitxer associat amb la columna
Mida Mida del fitxer en bytes
Adreça URL URL de baixada del fitxer

Exemple: recuperar les dades de columna del fitxer d'una taula de contactes

Creeu una columna del tipus de dades del fitxer al Dataverse per a una taula de contacte amb el nom myfileattribute.

Nota

Assegureu-vos que heu configurat el permís de taula adequat a la taula de contactes per llegir el registre.

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

API web

L'API web dels portals es pot utilitzar per crear, llegir, actualitzar i suprimir operacions en columnes d'arxius en les taules del Dataverse.

Nota

Assegureu-vos que heu configurat la configuració de lloc de l'API web adequada per a les taules i les columnes de fitxer a les quals voleu accedir.

S'estan recuperant les dades del fitxer

Per recuperar dades dels fitxers, utilitzeu la sol·licitud de l'API descrita en els exemples següents.

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

Les dades de fitxer transferides des dels extrems de servei web es limiten a un màxim de 16 MB de dades en una única trucada de servei. Les dades dels fitxers que superen els 16 MB s'han de dividir en 4 MB o blocs de dades més petits (fragments). Cada bloc es rep en una trucada de l'API diferent fins que s'han rebut totes les dades dels fitxers. És la vostra responsabilitat combinar els blocs de dades baixats per formar el fitxer de dades complet, combinant els blocs de dades en la mateixa seqüència que els blocs que es van rebre.

Exemple: baixada d'arxiu < 16 MB

Sol·licita
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[ ]

Exemple: baixada d'arxiu > 16 MB

Sol·licita
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[ ]

Càrrega de dades de fitxers

Per carregar un fitxer, definiu el valor de la columna de fitxer en una matriu de bytes que contingui el contingut del fitxer.

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

Exemple: càrrega de fitxers

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