Atributos de imagem

Artigo
07/06/2017

Publicado: novembro de 2016

Aplicável a: Dynamics CRM 2015

Os registros de entidade que incluem dados de imagem oferecem uma experiência exclusiva no aplicativo. Como desenvolvedor, você precisa saber como trabalhar com dados de imagem.

Apenas determinadas entidades do sistema e entidades personalizadas suportam imagens. Para obter informações sobre imagens de suporte das entidades do sistema, consulte Imagens de entidade.

Neste tópico

Atributos de suporte

Recuperando dados da imagem

Carregando dados da imagem

Atributos de suporte

Para as entidades que suportam atributos de imagem, o SchemaName do atributo de imagem da entidade será sempre EntityImage. Quando um atributo da imagem é adicionado a uma entidade, alguns atributos adicionais serão criados para o suporte conforme mostrado na tabela a seguir.

Nome do Esquema	Nome do tipo de atributo	Descrição
EntityImage_Timestamp	BigIntType	O valor representa quando a imagem foi atualizada pela última vez e é usado para ajudar a garantir que a versão mais recente da imagem será baixada e armazenada em cache no cliente.
EntityImage_URL	StringType	Uma URL absoluta para exibir a imagem da entidade em um cliente. A URL é composta dessa forma: `{0}/image/download.aspx?entity={1}&attribute={2}&id={3}&timestamp={4}` 0 : A URL da organização 1 : O nome lógico da entidade 2 : O nome lógico do atributo 3: O valor de EntityImageId. 4: O valor EntityImage_Timestamp Por exemplo: https://myorg.crm.dynamics.com/image/download.aspx?attribute=entityimage&entity=contact&id={ECB6D3DF-4A04-E311-AFE0-00155D9C3020}&timestamp=635120312218444444
EntityImageId	UniqueIdentifierType	O identificador exclusivo da imagem

Nome do Esquema

Nome do tipo de atributo

Descrição

EntityImage_Timestamp

BigIntType

O valor representa quando a imagem foi atualizada pela última vez e é usado para ajudar a garantir que a versão mais recente da imagem será baixada e armazenada em cache no cliente.

EntityImage_URL

StringType

Uma URL absoluta para exibir a imagem da entidade em um cliente.

A URL é composta dessa forma:

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

0 : A URL da organização
1 : O nome lógico da entidade
2 : O nome lógico do atributo
3: O valor de EntityImageId.
4: O valor EntityImage_Timestamp

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

EntityImageId

UniqueIdentifierType

O identificador exclusivo da imagem

Observação

Os clientes que não usam os assemblies do .NET atual precisa incluir SdkClientVersion com o valor de "6.0.0.0" ou maior para receber mais atributos ImageAttributeMetadata.Para obter mais informações:SdkClientVersion.

Recuperando dados da imagem

Ao usar o RetrieveMultiple ou Retrieve, o EntityImage não é incluído quando a propriedade ColumnSet.AllColumns é definido para verdadeiro. Devido ao possível tamanho dos dados nesse atributo, para retornar este atributo, é necessário solicitar explicitamente.

Os dados binários representando a imagem não são devolvidos usando a classe ExecuteFetchRequest substituída. Você deve usar RetrieveMultipleRequest em vez disso.

Para obter mais informações:Exemplo: Definir e recuperar imagens de entidade.

Carregando dados da imagem

Para atualizar imagens, defina o valor de EntityImage para byte[] contendo o conteúdo do arquivo. Todas as imagens são exibidas em um quadrado de 144x144 pixels. As imagens serão colhidas e redimensionadas para reduzir o tamanho dos dados antes de serem salvos.

As imagens com pelo menos um lado maior do que 144 pixels são recortadas no centro para 144x144.
As imagens com dois lados menores que 144 são cortadas em quadrados para seu lado menor.

A tabela a seguir mostra dois exemplos.