Ρύθμιση παραμέτρων στήλης αρχείου σε πύλες

Σημείωση

Από τις 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 %}

Χαρακτηριστικό	Description
'Ονομα	Το όνομα του αρχείου που σχετίζεται με τη στήλη
Size	Μέγεθος αρχείου σε byte
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 %}

API Web

Το ΑΡΙ Web πυλών μπορεί να χρησιμοποιηιεί για λειτουργίες εκτέλεσης, δημιουργίας, ανάγνωσης, ενημέρωσης και διαγραφής σε στήλες αρχείων σε πίνακες του Dataverse.

Σημείωση

Βεβαιωθείτε ότι έχετε ρυθμίσει τις παραμέτρους των κατάλληλων ρυθμίσεων τοποθεσίας ΑΡΙ web για τους πίνακες και τις στήλες αρχείων στις οποίες θέλετε να αποκτήσετε πρόσβαση.

Ανάκτηση δεδομένων αρχείου

Για να ανακτήσετε δεδομένα αρχείων, χρησιμοποιήστε την αίτηση API που περιγράφεται στα παρακάτω παραδείγματα.

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

Η μεταφορά δεδομένων αρχείου από τα τελικά σημεία της υπηρεσίας Web περιορίζεται στο μέγιστο των 16 MB δεδομένων σε μία κλήση εξυπηρέτησης. Τα δεδομένα αρχείων που υπερβαίνουν τα 16 MB πρέπει να χωρίζονται σε 4 MB ή μικρότερα μπλοκ δεδομένων. Κάθε μπλοκ λαμβάνεται σε μια ξεχωριστή κλήση API μέχρι να ληφθούν όλα τα δεδομένα αρχείου. Είναι δική σας ευθύνη να συμμετάσχετε στα μπλοκ δεδομένων που λάβατε για να δημιουργήσετε ένα πλήρες αρχείο δεδομένων συνδυάζοντας τα μπλοκ δεδομένων με την ίδια σειρά που τα μπλοκ ελήφθησαν.

Παράδειγμα: Λήψη αρχείου < 16 MB

Αίτημα

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

Απάντηση

204 No Content
Body:
Byte[ ]

Παράδειγμα: Λήψη αρχείου > 16 MB

Αίτημα

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

Απάντηση

HTTP
204 No Content
Body:
Byte[ ]

Αποστολή δεδομένων αρχείου

Για να αποστείλετε το αρχείο, ορίστε την τιμή της στήλης αρχείου σε έναν πίνακα byte που περιέχει το περιεχόμενο του αρχείου.

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

Παράδειγμα: αποστολή αρχείου

Αίτημα

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