이미지 특성

아티클
03/04/2017

게시 날짜: 2017년 1월

적용 대상: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

이미지 데이터가 포함된 엔터티 레코드는 응용 프로그램 내에서 고유한 경험을 제공합니다. 개발자는 이미지 데이터와 함께 작동하는 방식을 이해해야 합니다.

특정 시스템 엔터티 및 사용자 지정 엔터티만 이미지를 지원합니다. 시스템 엔터티가 이미지를 지원하는 정보는 엔터티 이미지를 참조하십시오.

이 항목의 내용

지원하는 특성

이미지 데이터 검색

이미지 데이터 업로드

지원하는 특성

이미지 특성을 지원하는 엔터티의 경우 엔터티 이미지 특성의 SchemaName는 항상 EntityImage입니다. 이미지 특성이 엔터티에 추가되면 다음 표에 나와 있는 것처럼 지원을 위해 추가 특성이 만들어집니다.

스키마 이름	특성 유형 이름	설명
EntityImage_Timestamp	BigIntType	값은 이미지가 마지막 업데이트된 때를 나타내고 이미지의 최신 버전이 클라이언트에 다운로드되고 캐시되었는지 확인하는 데 사용됩니다.
EntityImage_URL	StringType	클라이언트에서 엔터티 이미지를 표시하기 위한 절대 URL입니다. URL은 다음과 같이 구성됩니다. `{0}/image/download.aspx?entity={1}&attribute={2}&id={3}&timestamp={4}` 0 : 조직 URL 1 : 엔터티의 논리적 이름 2 : 특성의 논리적 이름 3 : EntityImageId 값. 4 : EntityImage_Timestamp 값 https://myorg.crm.dynamics.com/image/download.aspx?attribute=entityimage&entity=contact&id={ECB6D3DF-4A04-E311-AFE0-00155D9C3020}&timestamp=635120312218444444을 예로 들 수 있습니다.
EntityImageId	UniqueIdentifierType	이미지의 고유 식별자입니다.

스키마 이름

특성 유형 이름

설명

EntityImage_Timestamp

BigIntType

값은 이미지가 마지막 업데이트된 때를 나타내고 이미지의 최신 버전이 클라이언트에 다운로드되고 캐시되었는지 확인하는 데 사용됩니다.

EntityImage_URL

StringType

클라이언트에서 엔터티 이미지를 표시하기 위한 절대 URL입니다.

URL은 다음과 같이 구성됩니다.

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

0 : 조직 URL
1 : 엔터티의 논리적 이름
2 : 특성의 논리적 이름
3 : EntityImageId 값.
4 : EntityImage_Timestamp 값

https://myorg.crm.dynamics.com/image/download.aspx?attribute=entityimage&entity=contact&id={ECB6D3DF-4A04-E311-AFE0-00155D9C3020}&timestamp=635120312218444444을 예로 들 수 있습니다.

EntityImageId

UniqueIdentifierType

이미지의 고유 식별자입니다.

참고

최신 .NET 어셈블리를 사용하지 않는 클라이언트는 ImageAttributeMetadata 특성을 받으려면 값이 ‘6.0.0.0’ 이상인 SdkClientVersion을 포함해야 합니다.추가 정보:SdkClientVersion.

이미지 데이터 검색

RetrieveMultiple 또는 Retrieve를 사용할 경우 ColumnSet.AllColumns 속성이 true로 설정되면 EntityImage는 포함되지 않습니다. 이 특성에서 데이터의 잠재적 크기로 인해 이 특성을 반환하려면 명시적으로 요청해야 합니다.

이미지를 나타내는 이진 데이터는 더 이상 사용되지 않는 ExecuteFetchRequest 클래스를 사용하여 반환되지 않습니다. 대신 RetrieveMultipleRequest를 사용해야 합니다.

추가 정보:샘플: 엔터티 이미지 설정 및 검색.