Atributos de imagem

  • Artigo

 

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

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.

Antes de

Após
Imagem antes do redimensionamento

300x428
imagem depois do redimensionamento

144x144
Redimensionamento de imagem secundária de exemplo

91x130
redimensionar o segundo exemplo

91x91

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

Confira Também

Introdução às entidades no Microsoft Dynamics CRM 2015
Introdução aos atributos de entidade no Microsoft Dynamics CRM 2015
Exemplo: Definir e recuperar imagens de entidade

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais