Billedattributter.

Artikel
03/04/2017

Udgivet: januar 2017

Gælder for: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Objektposter, der indeholder billeddata, giver en enestående oplevelse i programmet. Som udvikler skal du sætte dig ind i, hvordan du arbejder med billeddata.

Kun visse systemobjekter og brugerdefinerede objekter understøtter billeder. Se Objektbilleder for at få flere oplysninger om, hvilke systemobjekter der understøtter billeder.

Dette emne indeholder

Understøttelse af attributter

Hentning af billeddata

Overførsel af billeddata

Understøttelse af attributter

For de objekter, som understøtter billedattributter, er SchemaName for objektbilledattributten altid EntityImage. Når en billedattribut føjes til et objekt, oprettes der nogle ekstra attributter for at understøtte det, som vist i nedenstående tabel.

Skemanavn	Attributtypenavn	Beskrivelse
EntityImage_Timestamp	BigIntType	Værdien angiver, hvornår billedet sidst blev opdateret og bruges til at sikre, at den nyeste version af billedet er hentet og gemt i cachen på klienten.
EntityImage_URL	StringType	En absolut URL-adresse til visning af objektbilledet i en klient. URL-adressen er sammensat således: `{0}/image/download.aspx?entity={1}&attribute={2}&id={3}&timestamp={4}` 0: URL-adresse for organisationen 1: Objektets logiske navn 2: Logisk navn for attributten 3: Værdien EntityImageId. 4: Værdien EntityImage_Timestamp F.eks.: https://myorg.crm.dynamics.com/image/download.aspx?attribute=entityimage&entity=contact&id={ECB6D3DF-4A04-E311-AFE0-00155D9C3020}&timestamp=635120312218444444.
EntityImageId	UniqueIdentifierType	Det entydige id for billedet.

Skemanavn

Attributtypenavn

Beskrivelse

EntityImage_Timestamp

BigIntType

Værdien angiver, hvornår billedet sidst blev opdateret og bruges til at sikre, at den nyeste version af billedet er hentet og gemt i cachen på klienten.

EntityImage_URL

StringType

En absolut URL-adresse til visning af objektbilledet i en klient.

URL-adressen er sammensat således:

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

0: URL-adresse for organisationen
1: Objektets logiske navn
2: Logisk navn for attributten
3: Værdien EntityImageId.
4: Værdien EntityImage_Timestamp

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

EntityImageId

UniqueIdentifierType

Det entydige id for billedet.

Bemærk

Klienter, der ikke bruger de aktuelle .NET-assemblies, skal inkludere SdkClientVersion med en værdi på '6.0.0.0' eller højere for at kunne modtage ImageAttributeMetadata-attributter.Flere oplysninger:SdkClientVersion.

Hentning af billeddata

Når du bruger RetrieveMultiple eller Retrieve medtages EntityImage ikke, når egenskaben ColumnSet.AllColumns er angivet til true. På grund af den potentielle størrelse af data i denne attribut skal du udtrykkeligt anmode om det, hvis attributten skal stilles tilbage.

De binære data, der repræsenterer billedet, returneres ikke ved hjælp af den forældede ExecuteFetchRequest klasse. Du skal bruge RetrieveMultipleRequest i stedet.

Flere oplysninger:Eksempel: Angive og hente objektbilleder.

Overførsel af billeddata

Hvis du vil opdatere billeder, skal du angive værdien af EntityImage til en byte[], der indeholder indholdet af filen. Alle billeder vises i et kvadrat på 144 x 144 pixel. Billeder bliver beskåret og tilpasset for at reducere størrelsen af dataene, før de gemmes.

Billeder med mindst én side, der er større end 144 pixel, beskæres på center til 144 x 144.
Billeder med begge sider, der er mindre end 144, beskæres til et kvadrat med deres mindste side.

I nedenstående tabel vises to eksempler.