Attributi di immagine

  • Articolo

 

Data di pubblicazione: gennaio 2017

Si applica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

I record dell'entità in cui sono inclusi i dati di immagine assicurano un'esperienza univoca nell'applicazione. Come sviluppatore è necessario conoscere come utilizzare i dati di immagine.

Solo alcune entità di sistema e le entità personalizzate supportano le immagini. Per informazioni sulle entità di sistema che supportano le immagini, vedere Immagini di entità.

In questo argomento

Attributi di supporto

Recupero dei dati di immagine

Caricamento dei dati di immagine

Attributi di supporto

Per le entità che supportano gli attributi di immagini, l'oggetto SchemaName dell'attributo di immagine dell'entità è sempre EntityImage. Quando un attributo di immagine viene aggiunto a un'entità alcuni attributi aggiuntivi vengono creati per supportarlo come illustrato nella seguente tabella.

Nome schema

Nome del tipo di attributo

Descrizione

EntityImage_Timestamp

BigIntType

Il valore rappresenta quando l'immagine è stata aggiornata per l'ultima volta e consente di essere certi che la versione più recente dell'immagine venga caricata e memorizzata nella cache sul client.

EntityImage_URL

StringType

Un URL assoluto per visualizzare l'immagine dell'entità in un client.

L'URL si compone in questo modo:

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

  • 0: l'URL dell'organizzazione

  • 1: il nome logico dell'entità

  • 2: il nome logico dell'attributo

  • 3: il valore EntityImageId.

  • 4: il valore EntityImage_Timestamp

Ad esempio:
https://myorg.crm.dynamics.com/image/download.aspx?attribute=entityimage&entity=contact&id={ECB6D3DF-4A04-E311-AFE0-00155D9C3020}&timestamp=635120312218444444

EntityImageId

UniqueIdentifierType

Identificatore univoco dell'immagine.

Nota

I client che non utilizzano gli assembly .NET correnti devono includere SdkClientVersion con un valore di "6.0.0.0" o superiore per ricevere gli attributi ImageAttributeMetadata.Ulteriori informazioni:SdkClientVersion.

Recupero dei dati di immagine

Quando si utilizza RetrieveMultiple o Retrieve, EntityImage non è incluso quando la proprietà ColumnSet.AllColumns è impostata su true. A causa delle potenziali dimensioni dei dati in questo attributo, per restituire questo attributo è necessario richiederlo in modo esplicito.

I dati binari che rappresentano l'immagine non vengono restituiti utilizzando la classe ExecuteFetchRequest deprecata. Utilizzare RetrieveMultipleRequest, in alternativa.

Ulteriori informazioni:Esempio: impostare e recuperare le immagini di entità.

Caricamento dei dati di immagine

Per caricare le immagini impostare il valore di EntityImage su byte[] che contiene i contenuti del file. Tutte le immagini vengono visualizzate in un quadrato di 144x144 pixel. Le immagini verranno ritagliate e ridimensionate per ridurre le dimensioni dei dati prima di essere salvati.

  • Le immagini che hanno almeno un lato più lungo di 144 pixel vengono ritagliate al centro 144x144.

  • Le immagini con entrambi i lati di dimensioni inferiori a 144 vengono ritagliate a quadrato in base al lato più piccolo.

Nella seguente tabella sono riportati due esempi.

Prima

Dopo
Immagine prima del ridimensionamento

300x428
immagine dopo il ridimensionamento

144x144
Secondo esempio di ridimensionamento dell'immagine

91x130
secondo esempio di ridimensionamento

91x91

Ulteriori informazioni:Esempio: impostare e recuperare le immagini di entità.

Vedere anche

Introduzione alle entità in Microsoft Dynamics 365
Introduzione agli attributi di entità di Microsoft Dynamics 365
Esempio: impostare e recuperare le immagini di entità

Microsoft Dynamics 365

© 2017 Microsoft. Tutti i diritti sono riservati. Copyright