특성 메타데이터Attribute metadata

엔터티에는 각 레코드에 포함될 수 있는 데이터를 나타내는 특성의 컬렉션이 포함됩니다.Entities include a collection of attributes that represent the data that can be included within each record. 개발자는 다양한 유형의 특성과 이를 사용하는 방법을 이해해야 합니다.Developers need to understand the different types of attributes and how to work with them.

자세한 정보: Dynamics 365 고객 관계 개발자 가이드: 엔터티 특성 소개More information: Dynamics 365 Customer Engagement Developer Guide: Introduction to entity attributes

특성 이름Attribute names

엔터티와 마찬가지로, 각 특성에는 만들어질 때 정의된 고유한 이름이 있습니다.Like entities, each attribute has a unique name defined when it is created. 이 이름은 다음과 같이 여러 가지 방법으로 표시됩니다.This name is presented in several ways:

이름Name 설명Description
SchemaName 일반적으로 파스칼식 대/소문자 버전의 논리적 이름입니다.Typically, a Pascal cased version of the logical name. 예: AccountNumberi.e. AccountNumber
LogicalName 모두 소문자 이름입니다.All lower-case name. 예: accountnumberi.e. accountnumber

사용자 지정 특성을 만들면 해당 특성이 만들어진 솔루션과 연결된 솔루션 게시자의 사용자 지정 접두사 값이 선택한 이름 앞에 추가됩니다.When you create a custom attribute, the name you choose will be prepended with the customization prefix value of the solution publisher associated with the solution that the attribute was created within.

특성을 만든 후에는 특성 이름을 변경할 수 없습니다.You cannot change the names of an attribute after it is created.

또한 각 특성에는 지역화된 값을 표시할 수 있는 두 가지 속성이 있습니다.Each attribute also has two properties that can display localized values. 이러한 값은 앱의 특성을 참조하는 데 사용되는 값입니다.These are the values that are used to refer to the attributes in an app.

이름Name 설명Description
DisplayName 일반적으로 스키마 이름과 동일하지만 공백을 포함할 수 있습니다.Typically, the same as the schema name, but can include spaces. 예: 계정 번호i.e. Account Number
Description 특성을 설명하거나 사용자에게 지침을 제공하는 짧은 문장입니다.A short sentence describing the attribute or providing guidance to the user. 예: 시스템 보기에서 신속하게 계정을 검색하고 식별하려면 계정에 대한 ID 번호 또는 코드를 입력합니다.i.e. Type an ID number or code for the account to quickly search and identify the account in system views.
모델 기반 앱의 경우 사용자가 양식에서 이 특성에 대한 필드 위를 마우스로 가리키면 이 정보가 표시됩니다.In model-driven apps, this information will appear when users hover over the field for this attribute in a form.

이러한 값은 앱의 특성을 참조하는 데 사용되는 지역화할 수 있는 값입니다.These are the localizable values that are used to refer to the attributes in an app. 이러한 값은 언제든지 변경할 수 있습니다.These values can be changed at any time. 지역화된 값을 추가하거나 편집하려면 Dynamics 365 고객 관계 사용자 지정 가이드: 사용자 지정된 엔터티 및 필드 텍스트를 다른 언어로 번역을 참조하세요.To add or edit localized values see Dynamics 365 Customer Engagement Customization Guide: Translate customized entity and field text into other languages.

특성 유형Attribute types

AttributeTypeName 속성은 특성 유형을 설명합니다.The AttributeTypeName property describes the type of an attribute. 이 속성에는 존재하는 다양한 유형의 각 특성에 대한 레이블을 제공하는 AttributeTypeDisplayName 형식의 값이 포함됩니다.This property contains a value of type AttributeTypeDisplayName which provides a label for each the different types of attributes that exist.

참고

AttributeType 속성으로 혼동하지 마세요.Don't be confused by the AttributeType property. 이전의 이 속성 값은 ImageType 특성을 Virtual로 표시한다는 점을 제외하고는 대부분 AttributeTypeName에 맞춰집니다.The values in this older property are mostly aligned with AttributeTypeName except that it shows ImageType attributes as Virtual. AttributeType 속성 대신 AttributeTypeName 속성을 참조해야 합니다.You should refer to the AttributeTypeName property rather than the AttributeType property.

다음 표에서,In the following table:

  • 이러한 유형은 비교를 위해 범주별로 그룹화됩니다.These types are grouped by category for comparison.
  • AttributeTypeDisplayName 값에 대해 사용할 수 있는 경우 .NET 어셈블리의 해당 AttributeMetadata 파생 클래스가 포함됩니다.For each AttributeTypeDisplayName value, the corresponding .NET assembly AttributeMetadata derived class is included where available. 이러한 유형과 AttributeTypeDisplayName 레이블 간에는 일대일 관계가 없습니다.There is not a 1:1 relationship between these types and the AttributeTypeDisplayName label.
  • 사용자 지정 특성으로 만들 수 있는 특성 유형에는 UI에 표시된 해당 레이블이 포함됩니다.Those attribute types that can be created as custom attributes include the corresponding label displayed in the UI.
범주Category AttributeTypeDisplayName/AttributeTypeDisplayName/
AttributeMetadata 형식AttributeMetadata Type
생성 가능 여부/Can Create/
레이블Label
설명Description
분류Categorization BooleanType
BooleanAttributeMetadataBooleanAttributeMetadata
Yes
두 가지 옵션Two Options
일반적으로 true 또는 false 값을 나타내는 두 가지 옵션에서 선택한 옵션 값을 포함합니다.Contains the selected option value from two options that usually indicate a true or false value.
자세한 정보: 옵션 집합More information: Option Sets
분류Categorization EntityNameType
EntityNameAttributeMetadataEntityNameAttributeMetadata
아니요No 시스템의 엔터티에 해당하는 옵션 값을 포함합니다.Contains an option value that corresponds to an entity in the system. 내부 전용입니다.For internal use only.
분류Categorization MultiSelectPicklistType
MultiSelectPicklistAttributeMetadataMultiSelectPicklistAttributeMetadata
Yes
MultiSelect Option SetMultiSelect Option Set
여러 옵션을 선택할 수 있는 여러 개의 선택된 옵션 값을 포함합니다.Contains multiple selected option values where multiple options can be selected.
자세한 정보:More information:
옵션 집합Option Sets
Dynamics 365 고객 관계 개발자 가이드: 다중 선택 목록 특성Dynamics 365 Customer Engagement Developer Guide: Multi-Select Picklist attributes
분류Categorization PicklistType
PicklistAttributeMetadataPicklistAttributeMetadata
Yes
옵션 집합Option Set
한 가지 옵션을 선택할 수 있는 선택된 옵션 값을 포함합니다.Contains the selected option value where one option can be selected.
자세한 정보: 옵션 집합More information: Option Sets
분류Categorization StateType
StateAttributeMetadataStateAttributeMetadata
아니요No 엔터티 레코드의 상태를 설명하는 옵션 값을 포함합니다.Contains the option value that describes the status of an entity record.
자세한 정보: 옵션 집합More information: Option Sets
분류Categorization StatusType
StatusAttributeMetadataStatusAttributeMetadata
아니요No 엔터티 레코드의 상태에 대한 이유를 설명하는 옵션 값을 포함합니다.Contains the option value that describes the reason for the status of an entity record.
자세한 정보: 옵션 집합More information: Option Sets
컬렉션Collection CalendarRulesType 아니요No CalendarRules 엔터티 레코드의 컬렉션을 포함합니다.Contains a collection of CalendarRules entity records.
이 유형을 사용하는 특성은 없습니다.There are no attributes that use this type. 프록시를 생성할 때 코드 생성 도구에서 메타데이터에 없는 두 개의 시뮬레이션된 특성을 만듭니다.When generating a proxy, the code generation tool will create two simulated attributes that are not present in the metadata. 이러한 특성은 엔터티 레코드와 일대다 관계로 연결된 일정 규칙 레코드의 뷰를 나타냅니다.These attributes represent a view of the calendar rules records associated in a one-to-many relationship to the entity record.
컬렉션Collection PartyListType 아니요No ActivityParty 엔터티 레코드의 컬렉션을 포함합니다.Contains a collection of ActivityParty entity records.
자세한 정보: ActivityParty 엔터티More information: ActivityParty entity
날짜 및 시간Date and Time DateTimeType
DateTimeAttributeMetadataDateTimeAttributeMetadata
Yes
날짜 및 시간Date and Time
날짜 및 시간 값을 포함합니다.Contains a date and time value.
모든 날짜 및 시간 특성은 1753년 1월 1일 오전 12시처럼 이른 시간 값을 지원합니다.All date and time attributes support values as early as 1/1/1753 12:00 AM.
이미지Image ImageType
ImageAttributeMetadataImageAttributeMetadata
Yes
이미지Image
엔터티 레코드에 대한 이미지 데이터 검색을 지원하는 데이터를 포함합니다.Contains data to support retrieving image data for an entity record.
자세한 정보: 엔터티 이미지More information: Entity Images
관리 속성Managed Property ManagedPropertyType
ManagedPropertyAttributeMetadataManagedPropertyAttributeMetadata
아니요No 관리형 솔루션에 포함되는 경우 엔터티 레코드에 저장된 솔루션 구성 요소를 사용자 지정할 수 있는지 여부를 나타내는 데이터를 포함합니다.Contains data that describe whether the solution component stored in the entity record can be customized when included in a managed solution.
자세한 정보: 관리 속성More information: Managed Properties
수량Quantity BigIntType
BigIntAttributeMetadataBigIntAttributeMetadata
아니요No BigInt 값을 포함합니다.Contains a BigInt value. 내부 전용입니다.For internal use only.
수량Quantity DecimalType
DecimalAttributeMetadataDecimalAttributeMetadata
Yes
10진수Decimal Number
Decimal 값을 포함합니다.Contains a Decimal value. Precision 속성은 자릿수 수준을 설정합니다.The Precision property sets the level of precision.
수량Quantity DoubleType
DoubleAttributeMetadataDoubleAttributeMetadata
Yes
부동 소수점 숫자Floating Point Number
Double 값을 포함합니다.Contains a Double value. Precision 속성은 자릿수 수준을 설정합니다.The Precision property sets the level of precision.
수량Quantity IntegerType
IntegerAttributeMetadataIntegerAttributeMetadata
Yes
정수Whole Number
Int 값을 포함합니다.Contains an Int value
수량Quantity MoneyType
MoneyAttributeMetadataMoneyAttributeMetadata
Yes
통화Currency
Decimal 값을 포함합니다.Contains a Decimal value. PrecisionSource 속성은 정밀도 수준이 설정되는 위치를 결정합니다.The PrecisionSource property determines where the level of precision is set.
0: Precision 속성0 : The Precision property
1: Organization.PricingDecimalPrecision 특성1 : The Organization.PricingDecimalPrecision attribute
2: 엔터티 레코드의 TransactionCurrency.CurrencyPrecision 특성2 : The TransactionCurrency.CurrencyPrecision attribute in the entity record
참조Reference CustomerType
LookupAttributeMetadataLookupAttributeMetadata
Yes
고객Customer
계정 또는 연락처 엔터티 레코드에 대한 참조를 포함합니다.Contains a reference to either an account or contact entity record.
참조Reference LookupType
LookupAttributeMetadataLookupAttributeMetadata
Yes
조회Lookup
엔터티 레코드에 대한 참조를 포함합니다.Contains a reference to an entity record. 유효한 레코드의 논리적 이름은 일반적으로 특성의 Targets 속성에 저장됩니다.The logical names of the valid records are usually stored in the Targets property of the attribute.
참조Reference OwnerType
LookupAttributeMetadataLookupAttributeMetadata
아니요No 사용자 또는 팀 엔터티 레코드에 대한 참조를 포함합니다.Contains a reference to either a user or team entity record.
문자열String MemoType
MemoAttributeMetadataMemoAttributeMetadata
Yes
여러 줄 텍스트Multiple Lines of Text
여러 줄 텍스트 상자에 표시할 문자열 값을 포함합니다.Contains a string value intended to be displayed in a multi-line textbox.
문자열String StringType
StringAttributeMetadataStringAttributeMetadata
Yes
한 줄 텍스트Single Line of Text
한 줄 텍스트 상자에 표시할 문자열 값을 포함합니다.Contains a string value intended to be displayed in a single-line textbox.
고유 식별자Unique identifier UniqueidentifierType
UniqueIdentifierAttributeMetadataUniqueIdentifierAttributeMetadata
아니요No GUID 고유 식별자 값을 포함합니다.Contains a GUID unique identifier value.
가상Virtual VirtualType 아니요No 이러한 특성은 코드에서 사용할 수 없으며 일반적으로 무시할 수 있습니다.These attributes cannot be used in code and can generally be ignored.

특성에 대해 지원되는 작업 및 양식 사용Supported operations and form usage for attributes

각 특성에는 참여할 수 있는 작업의 종류와 양식에 포함될 수 있는 방법을 설명하는 부울 속성이 포함됩니다.Each attribute includes boolean properties that describe the kinds of operations it can participate in and how it can be in a form.

속성Property 설명Description
IsRequiredForForm 특성을 양식의 필드로 포함해야 하는지 여부입니다.Whether the attribute must be included as a field in a form.
IsValidForCreate 특성 값을 만들기 작업에서 설정할 수 있는지 여부입니다.Whether the attribute value can be set in a create operation.
IsValidForForm 특성을 양식의 필드로 포함할 수 있는지 여부입니다.Whether the attribute can be included as a field in a form.
IsValidForRead 특성 값을 검색할 수 있는지 여부입니다.Whether the attribute value can be retrieved.
IsValidForUpdate 특성 값을 업데이트 작업에서 설정할 수 있는지 여부입니다.Whether the attribute value can be set in an update operation.

해당 작업에 유효하지 않은 특성에 대한 만들기 또는 업데이트 작업에서 값을 설정하려고 하면 값이 무시됩니다.If you try to set a value in a create or update operation for an attribute that is not valid for that operation, the value will be ignored. 읽기에 유효하지 않은 특성을 검색하려고 하면 null 값이 반환됩니다.If you try to retrieve an attribute that is not valid for read, a null value will be returned.

특성 요구 사항 수준Attribute requirement level

RequiredLevel 속성은 특성 값이 필요한지 여부를 설명하는 부울 관리 속성입니다.The RequiredLevel property is a Boolean managed property that describes if an attribute value is required.

이 속성에는 다음 값을 설정할 수 있습니다.This property can have the following values set:

이름Name Value UI 레이블UI Label 설명Description
None 00 (옵션)Optional 요구 사항이 지정되지 않습니다.No requirements are specified.
SystemRequired 11 시스템 필수System Required 특성에 값이 있어야 합니다.The attribute is required to have a value.
ApplicationRequired 22 업무상 필수Business Required 특성에 비즈니스와 관련된 값이 있어야 합니다.The attribute is required by the business to have a value.
Recommended 33 업무상 권장Business Recommended 특성에 값이 있는 것이 좋습니다.It is recommended that the attribute has a value.

앱용 Common Data Service는 시스템에서 만든 특성에 대해서만 SystemRequired 옵션을 적용합니다.Common Data Service for Apps only enforces the SystemRequired option for attributes created by the system. 사용자 지정 특성은 SystemRequired 옵션을 사용하도록 설정할 수 없습니다.Custom attributes cannot be set to use the SystemRequired option.

모델 기반 앱은 ApplicationRequired 옵션을 적용하고, Recommended 옵션에는 다른 프레젠테이션을 사용합니다.Model-driven apps will enforce the ApplicationRequired option and use a different presentation for the Recommended option. 사용자 지정 클라이언트의 작성자는 이 정보를 사용하여 유사한 유효성 검사 또는 프레젠테이션 옵션을 요구할 수 있습니다.Creators of custom clients may use this information to require similar validation or presentation options.

이는 관리 속성이므로 관리형 솔루션의 게시자는 솔루션의 소비자가 솔루션의 특성에 대해 이러한 설정을 변경할 수 있는지 여부를 결정할 수 있습니다.Because this is a managed property, as a publisher of a managed solution you can decide whether consumers of your solution are able to change these settings on attributes in your solution.

자세한 정보: 관리 속성More information: Managed Properties

롤업 및 계산 특성Rollup and calculated attributes

계산 및 롤업 특성을 사용하면 사용자가 수동으로 계산을 수행하고 해당 작업에 집중할 필요가 없습니다.Calculated and rollup attributes free the user from having to manually perform calculations and focus on their work. 시스템 관리자는 개발자와 함께 작업하지 않고도 많은 일반적인 계산 값을 포함하도록 필드를 정의할 수 있습니다.System administrators can define a field to contain the value of many common calculations without having to work with a developer. 또한 개발자는 이러한 계산을 자체 코드 내에서가 아니라 플랫폼 기능을 활용하여 수행할 수 있습니다.Developers can also leverage the platform capabilities to perform these calculations rather than within their own code.

자세한 정보:More information:

특성 형식Attribute format

특성에 대한 형식 값은 모델 기반 앱에 표시되는 방법을 제어합니다.The format values for attributes controls how it is displayed in model-driven apps. 사용자 지정 앱 개발자는 이 정보를 사용하여 비슷한 환경을 만들 수 있습니다.Developer of custom apps may use this information to create similar experiences.

정수 형식Integer formats

정수 특성이 있는 Format 속성을 사용하여 이 유형에 대한 대체 사용자 환경을 표시합니다.Use the Format property with integer attributes to display alternate user experiences for this type.

옵션Option 설명Description
None 숫자 값을 편집하는 텍스트 상자를 표시합니다.Displays a text box to edit a number value
Duration 시간 간격이 포함된 드롭다운 목록을 표시합니다.Displays a drop-down list that contains time intervals. 사용자가 목록에서 값을 선택하거나 시간(분)을 나타내는 정수 값을 입력할 수 있습니다.A user can select a value from the list or type an integer value that represents the number of minutes.
TimeZone 표준 시간대 목록이 포함된 드롭다운 목록을 표시합니다.Displays a drop-down list that contains a list of time zones.
Language 조직에서 사용하도록 설정된 언어 목록이 포함된 드롭다운 목록을 표시합니다.Displays a drop-down list that contains a list of languages that have been enabled for the organization. 다른 언어를 사용하지 않도록 설정된 경우 기본 언어만 선택할 수 있습니다.If no other languages have been enabled, the base language will be the only option. 저장된 값은 해당 언어에 대한 LCID 값입니다.The value saved is the LCID value for the language.

문자열 형식String formats

문자열 특성이 있는 FormatName 속성을 사용하여 문자열 특성의 형식을 지정하는 방법을 제어하도록 StringFormatName 클래스의 값을 설정합니다.Use the FormatName property with string attributes to set values from the StringFormatName Class to control how the string attribute is formatted.

이름Name 설명Description
Email 양식 필드에서 텍스트 값을 이메일 주소로 확인하고 mailto 링크를 해당 필드에 만듭니다.The form field will validate the text value as an e-mail address and create a mailto link in the field.
PhoneNumber 양식 필드에는 Skype를 사용하여 전화 통화를 시작하는 링크가 포함됩니다.The form field will contain a link to initiate a phone call by using Skype.
PhoneticGuide 내부 전용입니다.For internal use only.
Text 양식에 텍스트 상자가 표시됩니다.The form will display a text box.
TextArea 양식에 텍스트 영역 필드가 표시됩니다.The form will display a text area field.
TickerSymbol 양식에 주식 시세 기호에 대한 따옴표를 표시하기 위해 열리는 링크가 표시됩니다.The form will display a link that will open to display a quote for the stock ticker symbol.
URL 양식에 URL을 열 수 있는 링크가 표시됩니다.The form will display a link to open the URL.
VersionNumber 내부 전용입니다.For internal use only.

날짜 및 시간 형식Date and time formats

날짜 및 시간 특성에 대한 동작을 제어하는 DateTimeBehavior 속성입니다.The DateTimeBehavior property to controls the behavior for Date and Time attributes. 다음 세 가지 옵션이 있습니다.There are three options:

옵션Option 간단한 설명Short Description
UserLocal 날짜와 시간 값을 UTC 값으로 시스템에 저장합니다.Stores the date and time value as UTC value in the system.
DateOnly 시간 값이 오전 12시(00:00:00)인 실제 날짜 값을 시스템에 저장합니다.Stores the actual date value with the time value as 12:00 AM (00:00:00) in the system.
TimeZoneIndependent 사용자 표준 시간대와 관계없이 실제 날짜 및 시간 값을 시스템에 저장합니다.Stores the actual date and time values in the system regardless of the user time zone.

Format 속성을 사용하여 DateTimeBehavior와 관계없이 모델 기반 앱에서 값을 표시하는 방법을 제어합니다.Use the Format property control how the value is to be displayed in a model-driven app regardless of the DateTimeBehavior.

옵션Option 설명Description
DateAndTimeDateAndTime 전체 날짜 및 시간을 표시합니다.Display the full date and time
DateOnlyDateOnly 날짜만 표시합니다.Display just the date.

자세한 정보: Dynamics 365 고객 관계 개발자 가이드: 날짜 및 시간 특성의 동작 및 형식More information: Dynamics 365 Customer Engagement Developer Guide: Behavior and format of the date and time attribute

자동 번호 매기기 특성Auto-number attributes

엔터티에 대한 자동 번호 매기기 특성을 추가할 수 있습니다.You can add an auto-number attribute for any entity. 현재 프로그래밍 방식으로 특성을 추가할 수 있습니다.Currently, you can add the attribute programmatically. 이 유형의 특성을 추가하는 사용자 인터페이스가 없습니다.There is no user interface to add this type of attribute. 자세한 정보: Dynamics 365 고객 관계 개발자 가이드: 자동 번호 매기기 특성 만들기More information: Dynamics 365 Customer Engagement Developer Guide: Create auto-number attributes

옵션 집합Option sets

옵션 집합을 표시하는 특성은 특성으로 정의된 옵션 집합을 참조하거나 둘 이상의 특성에서 공유할 수 있는 별도의 옵션 집합을 참조할 수 있습니다.Those attributes which display a set of options can reference a set of options defined by the attribute or they can reference a separate set of options that can be shared by more than one attribute. 이는 한 특성의 값이 다른 특성에도 적용되는 경우에 특히 유용합니다.This is particularly useful when values in one attribute also apply to other attributes. 공통 옵션 집합을 참조하여 옵션을 한 곳에서 유지 관리할 수 있습니다.By referencing a common set of options, the options can be maintained in one place. 글로벌 옵션 집합은 공유할 수 있는 집합입니다.Those option sets that can be shared are global option sets. 로컬 옵션 집합은 특성 내에 정의된 집합입니다.Those defined within the attribute are local option sets.

옵션 데이터 검색Retrieve options data

조직 서비스는 특성에서 사용되는 옵션을 검색하는 데 사용할 수 있는 요청 클래스를 제공합니다.The organization service provides request classes you can use to retrieve the options used by an attribute.

조직 서비스를 사용하여 옵션 검색Use the organization service to retrieve options

옵션이 있는 각 특성은 EnumAttributeMetadata에서 상속받고 OptionSet 속성을 포함합니다.Each of the attributes with options inherit from EnumAttributeMetadata and include an OptionSet Property. 이 속성은 Options 속성 내에 옵션이 포함된 OptionSetMetadata를 포함합니다.This property contains the OptionSetMetadata that includes the options within the Options property.

조직 서비스를 사용하면 다음 메시지를 사용하여 옵션 집합에 대한 정보를 검색할 수 있습니다.With the organization service you can use the following messages to retrieve information about optionsets:

요청 클래스Request Class 설명Description
RetrieveAllOptionSetsRequestRetrieveAllOptionSetsRequest 모든 글로벌 옵션 집합에 관한 데이터를 검색합니다Retrieves data about all global optionsets
RetrieveAttributeRequestRetrieveAttributeRequest 임의의 로컬 옵션 집합이 포함된 특성에 관한 데이터를 검색합니다Retrieves data about an attribute including any local optionsets
RetrieveMetadataChangesRequestRetrieveMetadataChangesRequest 로컬 옵션 집합을 포함할 수 있는 쿼리에 따라 메타데이터를 검색합니다.Retrieves metadata based on a query that can include local optionsets
자세한 정보: 메타데이터에 대한 변경 내용 추적 및 검색More information: Retrieve and detect changes to metadata
RetrieveOptionSetRequestRetrieveOptionSetRequest 하나의 글로벌 옵션 집합에 관한 데이터를 검색합니다.Retrieves data about a global option set.

자세한 정보:More information:

Web API를 사용하여 옵션 검색Use the Web API to retrieve options

Web API는 옵션 값을 쿼리하기 위한 RESTful 스타일을 제공합니다.The Web API provides a RESTful style for querying option values. 엔터티 내에서 특성을 검색하여 로컬 또는 글로벌 옵션을 검색할 수 있습니다.You can retreive local or global options by retrieving the attributes within an entity. 다음 예제에서는 Account.AccountCategoryCode 속성에 포함된 옵션에 대해 OptionSetMetadata를 반환합니다.The following example returns the OptionSetMetadata for the options included in the Account.AccountCategoryCode property.

GET <organization url>/api/data/v9.0/EntityDefinitions(LogicalName='account')/Attributes(LogicalName='accountcategorycode')/Microsoft.Dynamics.CRM.PicklistAttributeMetadata?$select=LogicalName&$expand=OptionSet

또한 Web API를 사용하면 RetrieveMetadataChanges 함수도 사용할 수 있습니다.With the Web API you can also use the RetrieveMetadataChanges Function.

자세한 정보: Dynamics 365 고객 관계 개발자 가이드: Web API를 사용하여 메타데이터 쿼리 - EntityMetadata 특성 쿼리More information: Dynamics 365 Customer Engagement Developer Guide: Query metadata using the Web API > Querying EntityMetadata attributes

특성 매핑Attribute mapping

기존 엔터티 레코드의 컨텍스트에서 새 엔터티 레코드를 만들면, 기존 엔터티 레코드의 특정 값을 새 엔터티 레코드에 대한 기본값으로 자동으로 전송할 수 있습니다.When you create a new entity record in the context of an existing entity record, you can automatically transfer certain values from the existing entity record as default values for the new entity record. 이렇게 하면 모델 기반 앱을 사용하는 사용자에 대한 데이터 입력이 간소화됩니다.This streamlines data entry for people using model-driven apps. 응용 프로그램 사용자는 매핑된 값을 보고 엔터티를 저장하기 전에 편집할 수 있습니다.Application users see the mapped values and can edit them before saving the entity.

사용자 지정 클라이언트를 만드는 개발자의 경우, InitializeFrom 메시지(조직 서비스 InitializeFromRequest 클래스 또는 Web API InitializeFrom 함수)를 사용하여 구성된 기본값이 설정된 엔터티 데이터를 가져옴으로써 동일한 동작을 수행할 수 있습니다.For developers creating custom clients, the same behavior can be achieved by using the InitializeFrom message (Organization service InitializeFromRequest Class or Web API InitializeFrom Function) to get the entity data with the configured default values set.

자세한 정보More information

참고 항목See also

Common Data Service for Apps 엔터티Common Data Service for Apps entities