Configurare una colonna immagine nei portali

2023-03-16

Nota

A partire dal 12 ottobre 2022, i portali Power Apps sono denominati Power Pages. Altre informazioni: Microsoft Power Pages è ora generalmente disponibile (blog)
A breve verrà eseguita la migrazione e l'unione della documentazione dei portali Power Apps con la documentazione di Power Pages.

Una colonna immagine memorizza un file immagine in una colonna in una tabella Dataverse. Aggiungi una colonna immagine a un modulo per caricare, visualizzare, modificare ed eliminare immagini. Il modulo mostra una miniatura dell'immagine, se disponibile.

Nota

Non puoi caricare un file di immagine usando la modalità Inserisci su un modulo di base o un passaggio del modulo con più passaggi.

URL dell'immagine

L'URL dell'immagine indica l'URL completo di dove è archiviata l'immagine. Questo può essere utilizzato per lo sviluppo e la risoluzione dei problemi.

L'URL di un'immagine assume la forma seguente:

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

dove:

{0} è l'URL del portale
{1} è il nome logico dell'entità
{2} è il nome logico della colonna
{3} è l'ID immagine

Ad esempio, se il tuo portale si trova in https://contososite.powerappsportals.com, il tuo codice sarà simile a questo:

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

Liquid

Puoi progettare un sito Web usando Liquid code per recuperare i record dalle tabelle Dataverse. Usa fetchXML e la visualizzazione Entità vista per recuperare i valori della colonna dell'immagine, in questo modo:

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

dove:

Tipo è il tipo mimo dell'immagine
Size è la dimensione dell'immagine in byte
Value è il valore dell'immagine con codifica base64
Url è l'URL dell'immagine

Esempio: recuperare un'immagine del contatto predefinita

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

Puoi utilizzare l'API Web dei portali per creare, leggere, aggiornare ed eliminare le immagini nelle colonne immagine delle tabelle Dataverse.

Recuperare i dati dell'immagine

Per scaricare i dati dell'immagine in anteprima, utilizza la seguente chiamata API:

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

I dati di immagine trasferiti dagli endpoint del servizio Web sono limitati a un massimo di 16 MB in una singola chiamata del servizio.

Esempio: download di anteprima

Nell'esempio seguente, utilizzeremo una chiamata GET per scaricare un'anteprima, se esiste.

Richiesta HTTP:

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

Risposta HTTP:

    204 No Content
    
    Body:
    Byte[ ]

In questo esempio, l'anteprima non esiste e quindi non viene restituita alcuna immagine. Se esistesse un'anteprima, la risposta restituirebbe una matrice di byte con valori.

Caricare i dati dell'immagine

Per caricare un'immagine, imposta il valore della colonna immagine su una matrice di byte che contiene il contenuto del file immagine:

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

Esempio: caricamento di un'immagine

Richiesta HTTP:

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

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

Carica immagini profilo

Gli utenti del portale autenticati possono caricare la propria immagine nella sezione profilo del portale. Questa immagine viene salvata nella colonna Immagine dell'entità del record di contatto corrispondente in Dataverse. Gli utenti possono caricare immagini di dimensioni fino a 10 MB.

Crea impostazioni sito

Innanzitutto, devi creare un'impostazione del sito per consentire agli utenti autenticati di caricare un'immagine del profilo:

Accedi a Power Apps.
Seleziona l'ambiente che contiene il tuo portale.
Nel riquadro sinistro seleziona Apps, quindi apri l'app Gestione del portale.
Nel riquadro a sinistra, seleziona Impostazioni sito.
Crea un'impostazione Profile/ShowImage e imposta il valore su vero. (Se l'impostazione esiste, impostarne il valore su true .)

Condividi tramite