Afbeeldingskenmerken

Artikel
07/06/2017

Gepubliceerd: november 2016

Is van toepassing op: Dynamics CRM 2015

Entiteitrecords die afbeeldinggegevens bevatten, bieden een unieke ervaring binnen de toepassing. Als ontwikkelaar moet u begrijpen hoe u met afbeeldinggegevens werkt.

Alleen bepaalde systeementiteiten en aangepaste entiteiten ondersteunen afbeeldingen. Voor meer informatie over welke systeementiteiten afbeeldingen ondersteunen raadpleegt u Entiteitsafbeeldingen.

In dit onderwerp

Ondersteunende kenmerken

Afbeeldinggegevens ophalen

Afbeeldingsgegevens uploaden

Ondersteunende kenmerken

Voor die entiteiten die afbeeldingkenmerken ondersteunen, is de SchemaName van het entiteitsafbeeldingskenmerk altijd EntityImage. Wanneer een afbeeldingskenmerk aan de entiteit wordt toegevoegd worden enkele aanvullende kenmerken gemaakt ter ondersteuning zoals weergegeven in de volgende tabel.

Schemanaam	Naam type kenmerk	Beschrijving
EntityImage_Timestamp	BigIntType	De waarde geeft weer wanneer de afbeelding het laatst is bijgewerkt en wordt gebruikt om ervoor zorgen dat de nieuwste versie van de installatiekopie wordt gedownload en op de client in cache.
EntityImage_URL	StringType	Een absolute URL om de entiteitafbeelding in de client weer te geven. URL is samengesteld deze manier: `{0}/image/download.aspx?entity={1}&attribute={2}&id={3}&timestamp={4}` 0 : De organisatie URL 1 : Logische naam entiteit 2 : Logische naam kenmerk 3 : De EntityImageId-waarde. 4 : De EntityImage_Timestamp-waarde Bijvoorbeeld: https://myorg.crm.dynamics.com/image/download.aspx?attribute=entityimage&entity=contact&id={ECB6D3DF-4A04-E311-AFE0-00155D9C3020}&timestamp=635120312218444444
EntityImageId	UniqueIdentifierType	De unieke id van de afbeelding

Schemanaam

Naam type kenmerk

Beschrijving

EntityImage_Timestamp

BigIntType

De waarde geeft weer wanneer de afbeelding het laatst is bijgewerkt en wordt gebruikt om ervoor zorgen dat de nieuwste versie van de installatiekopie wordt gedownload en op de client in cache.

EntityImage_URL

StringType

Een absolute URL om de entiteitafbeelding in de client weer te geven.

URL is samengesteld deze manier:

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

0 : De organisatie URL
1 : Logische naam entiteit
2 : Logische naam kenmerk
3 : De EntityImageId-waarde.
4 : De EntityImage_Timestamp-waarde

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

EntityImageId

UniqueIdentifierType

De unieke id van de afbeelding

Notitie

De clients die de huidige .NET-assembly's niet gebruiken moeten SdkClientVersion toevoegen met de waarde "6.0.0.0" of hoger om ImageAttributeMetadata kenmerken te ontvangen.Meer informatie:SdkClientVersion.

Afbeeldinggegevens ophalen

Als u RetrieveMultiple of Retrieve gebruikt wordt de EntityImage niet bijgevoegd als de ColumnSet.AllColumns eigenschap staat ingesteld op waar. Door de potentiële grootte van gegevens in dit kenmerk, als u dit kenmerk wilt terugkeren moet u het moet vragen.

De binaire gegevens die de afbeelding weergeven worden niet teruggezonden met de afgeschafte ExecuteFetchRequest klasse. U moet in plaats hiervan RetrieveMultipleRequest gebruiken.

Meer informatie:Voorbeeld: Entiteitsafbeeldingen instellen en ophalen.

Afbeeldingsgegevens uploaden

Om afbeeldingen bij te werken stel de waarde van EntityImage in op een byte[] die de inhoud van het bestand bevat. Alle afbeeldingen worden weergegeven in een 144x144-pixelvierkant. De waarden worden bijgesneden en voor de grootte van de gegevens worden gewijzigd voordat het formaat te beperken is opgeslagen.

Afbeeldingen met minimaal één kant groter zijn dan 144 pixels worden bijgesneden midden op aan 144x144.
De waarden met beide zijden kleiner dan 144 worden bijgesneden tot vierkant aan de zijkant kleinste.

De volgende tabel bevat twee voorbeelden.