Ρύθμιση παραμέτρων στήλης εικόνων σε Power Pages

Μια στήλη εικόνων αποθηκεύει ένα αρχείο εικόνας σε μια στήλη σε πίνακα Microsoft Dataverse. Προσθέστε μια στήλη εικόνας σε μια φόρμα για αποστολή, προβολή, τροποποίηση και διαγραφή εικόνων. Η φόρμα εμφανίζει μια μικρογραφία της εικόνας, εάν είναι διαθέσιμη.

Σημείωση

Δεν μπορείτε να αποστείλετε μια εικόνα χρησιμοποιώντας τη λειτουργία εισαγωγής σε μια βασική φόρμα ή ένα βήμα φόρμας πολλών βημάτων.

Διεύθυνση URL εικόνας

Η διεύθυνση URL της εικόνας υποδεικνύει την πλήρη διεύθυνση URL της τοποθεσίας όπου είναι αποθηκευμένη η εικόνα. Μπορεί να χρησιμοποιηθεί για ανάπτυξη και αντιμετώπιση προβλημάτων.

Μια διεύθυνση URL εικόνας παίρνει την ακόλουθη φόρμα:

{0}/Image/download.aspx?entity={1}&attribute={2}&id={3}

όπου:

• {0} είναι η διεύθυνση URL της τοποθεσίας web

• {1} είναι το λογικό όνομα της οντότητας

• {2} είναι το λογικό όνομα της στήλης

• {3} είναι το αναγνωριστικό εικόνας

Για παράδειγμα, εάν η τοποθεσία web σας βρίσκεται στη διεύθυνση https://contososite.powerappsportals.com, ο κώδικάς σας θα έχει την εξής μορφή:

https://contososite.powerappsportals.com/Image/download.aspx?entity=contact&attribute=entityimage&id=cb059a4a-b1a6-ec11-9840-00224829604e

Liquid

Μπορείτε να σχεδιάσετε έναν ιστότοπο χρησιμοποιώντας τον Κώδικα Liquid για την ανάκτηση των καρτελών από πίνακες του Dataverse. Χρησιμοποιήστε το fetchXML και την προβολή Οντότητας για να λάβετε τιμές στήλης εικόνας, όπως αυτή:

XML

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

όπου:

• Τύπος είναι ο τύπος mime της εικόνας

• Μέγεθος είναι το μέγεθος της εικόνας σε byte

• Τιμή είναι η τιμή εικόνας ως συμβολοσειρά base64

• Url είναι η διεύθυνση URL εικόνας

Παράδειγμα: Ανάκτηση μιας προεπιλεγμένης εικόνας επαφής

XML

    {% fetchxml contacts %}
        <fetch version="1.0" output-format="xml-platform" mapping="logical" distinct="false">
            <entity name="contact">
                <attribute name="fullname"/>
                <attribute name="entityimage"/>
            </entity>
        </fetch>
    {% endfetchxml %}

    {% for item in contacts.results.entities %}
        {
            "Full Name":"{{ item.fullname }}"
            "Entity Image Type":"{{ item.entityimage.Type}}",
            "Entity Image Size":"{{ item.entityimage.Size}}",
            "Entity Image Url":"{{ item.entityimage.Url}}",
            "Entity Image Value":"{{ item.entityimage.Value}}"
        }
    {% endfor %}

API Web

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

Ανάκτηση δεδομένων εικόνας

Για να κάνετε λήψη δεδομένων εικόνας μικρογραφίας, χρησιμοποιήστε την ακόλουθη κλήση API:

HTML

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

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

Παράδειγμα: Λήψη μιας μικρογραφίας

Στο παρακάτω παράδειγμα, θα χρησιμοποιήσουμε μια κλήση GET για να πραγματοποιήσουμε λήψη μιας μικρογραφίας, αν υπάρχει.

Αίτηση HTTP:

HTML

    GET [website url]/_api/accounts(62d53214-9dfa-eb11-94ee-0022482230a8)/entityimage/$value
    
    Headers:
    Content-Type: application/octet-stream

Απόκριση HTTP:

HTML

    204 No Content
    
    Body:
    Byte[ ]

Σε αυτό το παράδειγμα, η μικρογραφία δεν υπάρχει και επομένως δεν επιστρέφεται καμία εικόνα. Εάν υπήρχε μια μικρογραφία, η απόκριση θα επέστρεφε έναν πίνακα byte με τιμές.

Αποστολή δεδομένων εικόνας

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

HTML

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

Παράδειγμα: Αποστολή μιας εικόνας

Αίτηση HTTP:

HTML

    PUT [website url]/_api/accounts(62d53214-9dfa-eb11-94ee-0022482230a8)/entityimage

    Headers:
    Content-Type: application/octet-stream
    
    Body :
    Byte [ ]

Αποστολή εικόνων προφίλ

Οι χρήστες τοποθεσίας web που έχουν υποβληθεί σε έλεγχο ταυτότητας μπορούν να στείλουν την εικόνας τους στην ενότητα της τοποθεσίας web. Η εικόνα αποθηκεύεται στη στήλη Εικόνα οντότητας της αντίστοιχης καρτέλας επαφής στο Dataverse. Οι χρήστες μπορούν να στείλουν εικόνες έως και 10 MB.

Ρυθμίσεις δημιουργίας τοποθεσίας

Αρχικά, πρέπει να δημιουργήσετε μια ρύθμιση τοποθεσίας ώστε να επιτρέπεται στους χρήστες που έχουν υποβληθεί σε έλεγχο ταυτότητας να πραγματοποιούν αποστολή μιας εικόνας προφίλ:

1. Ανοίξτε την εφαρμογή Διαχείριση πύλης

2. Στην περιοχή Τοποθεσία Web, επιλέξτε Ρυθμίσεις τοποθεσίας.

3. Δημιουργήστε μια ρύθμιση που ονομάζεται Profile/ShowImage και ορίστε την τιμή της αληθής. (Εάν η ρύθμιση υπάρχει, ορίστε την τιμή της σε αληθής.)