Customize 특성 메타데이터 메시지

 

게시 날짜: 2017년 1월

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

AttributeMetadata 클래스를 사용하여 기존 특성을 검색합니다. 이 클래스는 RetrieveAttributeRequest 메시지에서 반환됩니다.AttributeMetadata 클래스는 추상 MetadataBase 클래스에서 상속됩니다.

CreateAttributeRequest 메시지로 각 특성 유형에 대해 특정 클래스를 사용하여 특성을 업데이트하거나 사용자 지정 특성을 만듭니다.

참고

사용자 지정 특성을 만든 후 프로그래밍 방식으로 액세스할 수 있지만 사용자가 볼 수 있도록 엔터티 양식에 먼저 추가해야 합니다.

특성 유형

다음 표에는 사용할 수 있는 각 유형의 Attribute가 나와 있습니다. 각 특성은 AttributeMetadata 클래스에서 상속됩니다.

클래스

응용 프로그램 레이블

설명

BooleanAttributeMetadata

두 개 옵션

부울 특성입니다. 두 옵션에 대한 텍스트를 지정할 수 있습니다. 양식에 추가되면 필드 속성은 특성을 두 라디오 단추로 표시할지, 확인란 또는 목록으로 표시할지 여부를 제어합니다.

DateTimeAttributeMetadata

날짜 및 시간

날짜와 시간 특성입니다. 시간대 정보를 포함하거나 제외하고 날짜와 시간 값을 저장하는 동작을 지정하고 값의 표시 형식을 정의하는 서식을 지정할 수 있습니다. 추가 정보: 날짜 및 시간 특성의 동작 및 형식

참고

Microsoft Dynamics CRM Online 2015 업데이트 1 또는 Microsoft Dynamics 365(온-프레미스)를 사용 중인 경우 모든 날짜 및 시간 특성은 이제 1/1/1753 12:00 AM만큼 이른 값을 지원합니다.

DecimalAttributeMetadata

10진수

10진수 특성입니다. 정밀도를 최대 10자리 소수 자릿수 수준까지, 최소값 및 최대값은 -100,000,000,000에서 100,000,000,000으로 지정할 수 있습니다.

DoubleAttributeMetadata

부동 소수점 수

double 특성입니다. 정밀도를 최대 5자리 소수 자릿수 수준까지, 최소값 및 최대값은 -100,000,000,000에서 100,000,000,000으로 지정할 수 있습니다.

참고

DoubleAttributeMetadata는 Microsoft Dynamics CRM 4.0에 사용되는 FloatAttributeMetadata를 대체합니다.

ImageAttributeMetadata

이미지

이미지 특성입니다. 각 엔터티에는 하나의 이미지 특성을 사용할 수 있습니다. 특정 시스템 엔터티에는 이미지 특성이 있으며, 이러한 특성이 없는 시스템 엔터티에는 새 이미지 특성을 추가할 수 없습니다. 이미지 특성을 사용자 지정 엔터티에 추가할 수 있습니다.

모든 이미지 특성에는 SchemaName ‘EntityImage’ 및 LogicalName ‘entityimage’가 있습니다. 사용자 지정 이미지 특성은 이름에 솔루션 게시자 사용자 지정 접두사를 사용하지 않습니다.추가 정보:엔터티 이미지.

IntegerAttributeMetadata

정수

정수 특성입니다. 최소값과 최대값을 -2,147,483,648에서 2,147,483,647로 지정할 수 있습니다.

IntegerFormat 열거형을 사용하여 다음 유형의 필드를 만들기 위해 이 특성의 서식을 지정할 수 있습니다.

  • 기간: 시간 간격이 들어 있는 드롭다운 목록을 표시합니다. 사용자는 목록에서 값을 선택하거나 분 수를 나타내는 정수 값을 입력할 수 있습니다.

  • 표준 시간대: 표준 시간대의 목록이 들어 있는 드롭다운 목록을 표시합니다.

  • 언어: 조직에 활성화된 언어 목록이 포함된 드롭다운 목록이 표시됩니다. 활성화된 다른 언어가 없을 경우 유일한 옵션은 기본 언어입니다. 저장되는 값은 언어의 LCID 값입니다.

LookupAttributeMetadata

조회

CreateOneToManyRequest 메시지를 사용하여 엔터티 관계를 만들 때 특성이 만들어집니다.

MemoAttributeMetadata

여러 줄 텍스트

메모 특성입니다. 양식의 텍스트 상자 필드로 표시합니다. 최대 길이는 1048576자입니다.

MoneyAttributeMetadata

통화

금액 특성입니다. 최소값과 최대값을 -922,337,203,685,477에서 922,337,203,685,477 사이로 지정할 수 있습니다.

정밀도 수준은 PrecisionSource 속성을 사용하여 설정할 수 있습니다.

  • 정밀도를 0으로 설정하면 MoneyAttributeMetadata.Precision 값이 사용됩니다.

  • 정밀도를 1으로 설정하면 Organization.PricingDecimalPrecision 값이 사용됩니다.

  • 정밀도를 2으로 설정하면 TransactionCurrency.CurrencyPrecision 값이 사용됩니다.

PicklistAttributeMetadata

옵션 집합

선택 목록 특성입니다. 이 특성은 드롭다운 목록에 표시되는 옵션 집합을 제공합니다. 고유한 옵션을 포함하거나 전역 옵션 집합을 사용할 수 있도록 선택 목록 특성을 만들 수 있습니다.

StateAttributeMetadata

상태

상태(state) 특성은 엔터티를 만들 때 자동으로 만들어집니다.

참고

이 특성에 사용할 수 있는 옵션은 읽기 전용입니다.

StatusAttributeMetadata

상태 설명

상태(status) 특성은 엔터티를 만들 때 자동으로 만들어집니다. 각 옵션은 엔터티에 대한 StateAttributeMetadata 특성에 연결해야 합니다.InsertStatusValueRequest 메시지를 사용하여 이 특성에 사용할 수 있는 옵션을 업데이트합니다.

참고

상태(status) 값은 특정 상태(state) 값에 종속되므로 각 StatusOption은 특정 상태(state) 특성 값을 참조해야 합니다.

StringAttributeMetadata

한 줄 텍스트

StringAttributeMetadata 형식를 참조하십시오.

StringAttributeMetadata 형식

문자열 특성은 Skype 또는 Lync를 사용하여 전화 통화를 시작하는 링크를 허용하도록 서식을 지정할 수 있습니다. 이렇게 변경하려면 StringAttributeMetadata 클래스에 새 FormatName 속성을 추가하고 Format 속성을 더 이상 사용하지 않아야 합니다.

참고

Lync는 Business용 Skype로 브랜드 이미지를 새롭게 바꾸었습니다. 현재 Microsoft Dynamics 365에서 “Lync”에 대한 언급을 계속 보겠지만 Dynamics 365는 비즈니스용 Skype를 사용할 것입니다.

StringAttributeMetadata.Format의 서식을 정의하는 StringFormat 열거형을 더 이상 사용하지 않습니다. 대신 StringFormatName 클래스를 사용하여 StringAttributeMetadata(FormatName)의 값을 설정합니다.

그러면 StringFormat 열거형에 없는 PhoneNumber의 서식을 설정할 수 있습니다.

이전 버전과의 호환성을 위해 Format 또는 FormatName 속성을 사용하여 특성의 서식을 지정하는 방법을 제어하는 값을 설정할 수 있습니다.Format만 사용할 경우 기존 코드는 계속 작동하지만 FormatName을 사용하지 않으면 특성을 전화 번호로 서식을 지정할 수 없습니다. 두 속성을 모두 설정하면 FormatName을 사용하여 설정된 값이 적용됩니다.

StringFormatName 클래스에 다음 멤버가 들어 있습니다. 각 멤버는 멤버 이름과 동일한 값을 가진 문자열을 반환합니다.

멤버 이름 및 값

설명

Email

양식 필드는 텍스트 값을 전자 메일 주소로 유효성을 검사하고 필드에 mailto 링크를 만듭니다.

PhoneNumber

양식 필드에는 Lync 또는 Skype를 사용하여 전화 통화를 시작하는 링크가 들어 있습니다.

PhoneticGuide

내부 전용입니다.

Text

양식에 텍스트 상자가 표시됩니다.

TextArea

양식에 텍스트 영역 필드가 표시됩니다.

TickerSymbol

양식에 주식 종목 코드에 대해 견적을 표시하기 위해 열리는 링크가 표시됩니다.

URL

양식에 URL을 여는 링크가 표시됩니다.

VersionNumber

내부 전용입니다.

참고 항목

Dynamics 365 메타데이터에서 조직 서비스 사용
특성 메타데이터에 대한 작업
날짜 및 시간 특성의 동작 및 형식
Entity 특성 메타데이터 메시지
샘플: 특성 메타데이터에 대한 작업
기술 문서: REST 끝점과 함께 옵션 집합 옵션 사용 - JScript
샘플: 파일에 특성 메타데이터 덤프
샘플: 파일에 특성 선택 목록 메타데이터 덤프
샘플: 날짜 및 시간 동작 변환

Microsoft Dynamics 365

© 2017 Microsoft. All rights reserved. 저작권 정보