다음을 통해 공유

Xrm.Page.data.entity 특성(클라이언트 쪽 참조)

  • 아티클

 

게시 날짜: 2017년 1월

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

특성은 양식에 데이터를 포함합니다.Xrm.Page.data.entity.특성 모음 또는 Xrm.Page.getAttribute 바로 가기 메서드를 사용하여 특성 모음에 액세스합니다. 자세한 내용은 컬렉션(클라이언트 쪽 참조)를 참조하십시오.

특성 속성 및 메서드

  • 부울 및 옵션 집합 특성 메서드
    getInitialValue, getOption, getOptions, getSelectedOption 및 getText 메서드는 부울 또는 옵션 집합 특성에 대한 정보를 가져오는 방법을 제공합니다.

  • 제어
    특성과 연결된 액세스 제어

  • getAttributeType
    특성의 형식을 가져옵니다.

  • getFormat
    특성 형식을 가져옵니다.

  • getIsDirty
    특성의 값이 마지막으로 저장된 이후 변경되었는지 여부를 확인합니다.

  • getIsPartyList
    조회 특성이 partylist 조회를 나타내는지 여부를 결정합니다.

  • getMaxLength
    문자열 데이터를 저장하는 특성을 포함할 수 있는 문자열의 최대 길이를 가져옵니다.

  • getName
    특성의 이름을 가져옵니다.

  • getParent
    모든 특성에 상위에 있는 Xrm.Page.data.entity 개체에 대한 참조를 가져옵니다.

  • getUserPrivilege
    필드 수준 보안을 사용하여 사용자가 필드에 대해 갖는 권한을 결정합니다.

  • 숫자 특성 메서드
    getMax, getMin 및 getPrecision 메서드를 사용하여 숫자 특성의 속성에 대한 정보에 액세스합니다.

  • OnChange 이벤트
    addOnChange, removeOnChange 및 fireOnChange 메서드를 사용하여 OnChange 이벤트에 대한 이벤트 처리기를 관리합니다.

  • RequiredLevel
    setRequiredLevel 및 getRequiredLevel 메서드를 사용하여 레코드를 저장하기 위해 특성이 값을 갖고 있어야 하는지 여부를 제어합니다.

  • SubmitMode
    setSubmitMode 및 getSubmitMode 메서드를 사용하여 레코드가 저장될 때 특성의 값을 제출할지 여부를 제어합니다.

  • 값
    getValue 및 setValue 메서드를 사용하여 특성에 대해 설정된 값을 확인하고 값을 변경합니다.

부울 및 옵션 집합 특성 메서드

getInitialValue, getOption, getOptions, getSelectedOption 및 getText 메서드는Boolean or OptionSet집합 특성에 대한 정보를 가져오는 방법을 제공합니다.

getInitialValue

양식을 열 때 OptionSet 또는 Boolean 특성에 대해 설정된 값을 나타내는 값을 반환합니다.

특성 유형: 옵션 집합 및 부울

Xrm.Page.getAttribute(arg).getInitialValue()
  • 반환 값
    유형: 숫자. 특성의 초기 값입니다.

getOption

메서드에 전달되는 인수와 일치하는 값을 사용하여 옵션 개체를 반환합니다.

특성 유형: 옵션 집합

Xrm.Page.getAttribute(arg).getOption(value)

  • 인수
    문자열 또는 숫자 값

  • 반환 값
    유형:text 및 value 속성이 있는 옵션 개체.

getOptions

옵션 집합 특성에 대한 유효한 옵션을 나타내는 옵션 개체의 배열을 반환합니다.

특성 유형: 옵션 집합

Xrm.Page.getAttribute(arg).getOptions()
  • 반환 값
    유형: 옵션 개체의 배열입니다.

getSelectedOption

옵션 집합 특성에서 선택된 옵션 개체를 반환합니다.

특성 유형: 옵션 집합

Xrm.Page.getAttribute(arg).getSelectedOption()
  • 반환 값
    유형:text 및 value 속성이 있는 옵션 개체.

getText

옵션 집합 특성을 위해 현재 선택한 옵션에 대한 텍스트의 문자열 값을 반환합니다.

특성 유형: 옵션 집합

Xrm.Page.getAttribute(arg).getText()

  • 반환 값
    유형: 문자열. 선택한 옵션의 text 값입니다.

    참고

    옵션을 선택하지 않았으면 getText는 빈 문자열 집합을 반환합니다.

제어

모음에 의해 노출된 메서드에 대한 자세한 내용은 컬렉션(클라이언트 쪽 참조)을 참조하십시오.

각 특성은 페이지에서 두 번 이상 표현될 수 있으므로 컨트롤 모음은 해당 특성을 나타내는 모든 컨트롤에 대한 액세스를 제공합니다. 특성이 페이지에 있는 하나의 필드만으로 표현되는 경우 이 모음의 길이는 1이 됩니다. 컨트롤 51828fe3-f6ff-4f97-80ed-b06b3a354955#BKMK_getName 메서드를 사용하면 첫 번째 컨트롤의 이름은 특성의 이름과 같습니다. 해당 특성에 대한 컨트롤의 두 번째 인스턴스는 ‘<attributeName>1’입니다. 패턴 <attributeName>+N은 특정 특성에 대한 양식에 추가된 추가 컨트롤에 대해 계속됩니다.

양식에 머리글에 있는 비즈니스 프로세스 흐름 컨트롤이 표시되면 비즈니스 프로세스 흐름에 표시되는 각 특성에 대해 추가 컨트롤이 추가됩니다. 이러한 컨트롤에는 header_process_<attribute name> 같은 고유한 이름이 있습니다.

특성에 연결된 컨트롤에 대한 작업을 수행할 때는 항상 컨트롤이 한 번 이상 페이지에 포함될 수 있음을 고려해야 하며 일반적으로 특성에 대해 각 컨트롤에 동일한 작업을 수행해야 합니다. 특정 컨트롤 모음을 순환하여 이를 수행하고 각 컨트롤에서 작업을 수행할 수 있습니다.

다음 샘플은 컨트롤을 숨기고 표시하는 특성 컨트롤 모음을 사용하는 두 개의 재사용 가능한 함수가 있는 JavaScript 라이브러리를 나타냅니다.

  • SDK.Sample.hideAllAttributeControls: 특성의 모든 컨트롤을 숨깁니다.

  • SDK.Sample.showAllAttributeControls: 특성의 모든 컨트롤을 표시합니다.

if (typeof (SDK) == "undefined")
{SDK = { __namespace: true }; }
SDK.Sample = { __namespace: true };
SDK.Sample.hideAllAttributeControls = function (attributeLogicalName) {
    /// <summary>
    /// Hides all controls for the attribute.
    /// </summary>
    /// <param name="attributeLogicalName" type="String" mayBeNull="false" optional="false" >
    /// The logical name of an attribute.
    /// </param>
    if ((typeof attributeLogicalName != "string") ||
        (attributeLogicalName.length <= 3))
    { throw new Error("SDK.Sample.hideAllAttributeControls attributeLogicalName parameter must be a string at least 4 characters long."); }
    Xrm.Page.getAttribute(attributeLogicalName).controls.forEach(
        function (control, i) {
            control.setVisible(false);
            }
        );
}
SDK.Sample.showAllAttributeControls = function (attributeLogicalName) {
    /// <summary>
    /// Shows all controls for the attribute.
    /// </summary>
    /// <param name="attributeLogicalName" type="String" mayBeNull="false" optional="false" >
    /// The logical name of an attribute.
    /// </param>
    if ((typeof attributeLogicalName != "string") ||
        (attributeLogicalName.length <= 3))
    { throw new Error("SDK.Sample.showAllAttributeControls attributeLogicalName parameter must be a string at least 4 characters long."); }
    Xrm.Page.getAttribute(attributeLogicalName).controls.forEach(
        function (control, i) {
            control.setVisible(true);
            }
        );
}

이러한 함수를 사용하려면 여기에 표시된 대로 특성의 논리 이름을 전달합니다.

//Hide the controls for the subject attribute.
SDK.Sample.hideAllAttributeControls("subject");
//Show the controls for the subject attribute.
SDK.Sample.showAllAttributeControls("subject");

getAttributeType

특성의 형식을 나타내는 문자열 값을 반환합니다.

특성 유형:: 모두

Xrm.Page.getAttribute(arg).getAttributeType()

  • 반환 값
    유형: 문자열

    이 메서드는 다음 문자열 값 중 하나를 반환합니다.

    • boolean

    • datetime

    • decimal

    • double

    • integer

    • lookup

    • memo

    • money

    • optionset

    • string

getFormat

특성에 대한 서식 옵션을 나타내는 문자열 값을 반환합니다.

특성 유형:: 모두

Xrm.Page.getAttribute(arg).getFormat()

  • 반환 값
    유형: 문자열

    이 메서드는 다음 문자열 값 또는 null 중 하나를 반환합니다.

    • date

    • datetime

    • duration

    • email

    • language

    • none

    • phone

    • text

    • textarea

    • tickersymbol

    • timezone

    • url

참고

이 형식 정보는 일반적으로 응용 프로그램 필드의 서식 옵션을 나타냅니다. Boolean 필드에 대한 서식 옵션은 제공되지 않습니다.

다음 표에는 특성 스키마 유형 및 서식 옵션의 각 유형에 대해 기대하는 형식 문자열 값이 나와 있습니다.

응용 프로그램 필드 유형

서식 옵션

특성 유형

서식 값

날짜 및 시간

날짜만

datetime

날짜

날짜 및 시간

날짜 및 시간

datetime

datetime

정수

기간

integer

기간

한 줄 텍스트

전자 메일

string

전자 메일

정수

언어

optionset

언어

정수

없음

integer

없음

한 줄 텍스트

텍스트 영역

string

textarea

한 줄 텍스트

텍스트

string

텍스트

한 줄 텍스트

주식 종목 코드

string

tickersymbol

한 줄 텍스트

전화

string

휴대폰

정수

표준 시간대

optionset

timezone

한 줄 텍스트

Url

string

url

getIsDirty

특성 값에 저장되지 않은 변경이 있음을 나타내는 Boolean 값을 반환합니다.

특성 유형:: 모두

Xrm.Page.getAttribute(arg).getIsDirty()
  • 반환 값
    유형: 부울. 저장되지 않은 변경이 있는 경우 true이고, 그렇지 않으면 false입니다.

getIsPartyList

조회 매개 변수가 Partylist 조회를 나타내는지 여부를 나타내는 부울 값을 반환합니다. Partylist 조회를 사용하면 전자 메일 엔터티 레코드에 대한 받는 사람: 필드 같이 여러 레코드를 설정할 수 있습니다.

특성 유형: 조회

Xrm.Page.getAttribute(arg).getIsPartyList()

  • 반환 값
    유형: 부울. 조회 특성이 partylist인 경우 true이고, 그렇지 않으면 false입니다.

  • 설명
    이 메서드는 41462684-3e5d-4858-8be4-1a7c4fcdeff6#BKMK_UpdatedEntties에만 사용할 수 있습니다.

getMaxLength

문자열 또는 메모 특성의 최대 길이를 나타내는 숫자를 반환합니다.

특성 형식: 문자열, 메모

Xrm.Page.getAttribute(arg).getMaxLength()

  • 반환 값
    유형: 숫자. 이 특성에 대해 문자열 길이로 허용되는 최대 길이입니다.

    참고

    전자 메일 양식 description 특성은 메모 특성이지만 getMaxLength 메서드를 갖지 않습니다.

getName

특성의 논리 이름을 나타내는 문자열을 반환합니다.

특성 유형:: 모두

Xrm.Page.getAttribute(arg).getName()
  • 반환 값
    유형: 문자열. 특성의 논리적 이름입니다.

getParent

모든 특성에 상위에 있는 Xrm.Page.data.entity 개체를 반환합니다.

이 함수는 다른 객체와 일관된 인터페이스를 제공합니다. 이 경우 모든 특성은 동일한 개체를 반환하므로 유용한 상황이 많지 않습니다.

특성 유형:: 모두

Xrm.Page.getAttribute(arg).getParent()
  • 반환 값
    유형:Xrm.Page.data.entity 개체.

getUserPrivilege

사용자가 특성에 대한 데이터 값을 만들거나 읽거나 업데이트하는지 나타내는 권한에 해당하는 세 가지 부울 속성을 사용하여 개체를 반환합니다. 이 함수는 필드 수준 보안이 특정 특성에 대한 사용자의 권한을 수정할 때 사용됩니다. 자세한 내용은 Microsoft Dynamics 365의 필드 값에 대한 액세스를 제어하기 위해 필드 보안을 사용할 수 있는 방법을 참조하십시오.

특성 유형:: 모두

Xrm.Page.getAttribute(arg).getUserPrivilege()

  • 반환 값
    유형: 개체

    개체에는 세 개의 부울 속성이 있습니다.

    • canRead

    • canUpdate

    • canCreate

숫자 특성 메서드

getMax, getMin 및 getPrecision 메서드를 사용하여 숫자 특성의 속성에 대한 정보에 액세스합니다.

getMax

특성에 대해 허용되는 최대값을 나타내는 숫자를 반환합니다.

특성 형식: 금액, 10진수, 정수, 이중

Xrm.Page.getAttribute(arg).getMax()
  • 반환 값
    유형: 숫자. 특성에 허용되는 최대 값입니다.

getMin

특성에 대해 허용되는 최소값을 나타내는 숫자를 반환합니다.

특성 형식: 금액, 10진수, 정수, 이중

Xrm.Page.getAttribute(arg).getMin()
  • 반환 값
    유형: 숫자. 특성에 허용되는 최소값입니다.

getPrecision

소수점 이하 허용되는 자릿수를 반환합니다.

특성 형식: 금액, 10진수, 이중 및 정수

Xrm.Page.getAttribute(arg).getPrecision()
  • 반환 값
    유형: 숫자. 소수점 이하 허용되는 자릿수입니다.

OnChange 이벤트

특성에 대한 OnChange 이벤트에 작업하는 데 사용할 수 있는 세 가지 메서드가 있습니다.

  • addOnChange

  • removeOnChange

  • fireOnChange

addOnChange

특성 값이 변경될 때 호출할 함수를 설정합니다.

Xrm.Page.getAttribute(arg).addOnChange([function reference])

  • 매개 변수
    유형: 함수 포인터

    설명: 함수는 이벤트 처리기 파이프라인의 맨 아래에 추가됩니다. 실행 컨텍스트는 이벤트 처리기에 전달된 첫 번째 매개 변수로 자동 설정됩니다. 자세한 내용은 실행 컨텍스트(클라이언트 쪽 참조)을 참조하십시오.

    예: 이 예에서 JScript 라이브러리는 두 함수를 포함합니다.addMessageToOnChange 함수를 양식 OnLoad 이벤트에 추가하면 displayMessage 함수가 양식에 있는 첫 번째 특성에 대한 OnChange 이벤트로 추가합니다.

    function addMessageToOnChange() 
{ 
   Xrm.Page.data.entity.attributes.get(0).addOnChange(displayOrgName);
}
function displayOrgName(execContext) 
{ 
   Xrm.Utility.alertDialog(execContext.getContext().getOrgUniqueName()); 
}

removeOnChange

특성에 대한 OnChange 이벤트 처리기에서 함수를 제거합니다.

Xrm.Page.getAttribute(arg).removeOnChange([function reference])

  • 매개 변수
    유형: 함수 참조

    예: 이 예에서 JScript 라이브러리는 두 함수를 포함합니다.removeMessageFromOnChange 함수를 다른 양식 이벤트에 추가하면 양식에 있는 첫 번째 특성에 대한 OnChange 이벤트로 displayOrgName 함수를 제거합니다.

    function removeMessageFromOnChange() 
{
   Xrm.Page.data.entity.attributes.get(0).removeOnChange(displayOrgName);
}
function displayOrgName(execContext) 
{ 
   Xrm.Utility.alertDialog(execContext.getContext().getOrgUniqueName()); 
}

fireOnChange

해당 이벤트에 연결된 스크립트가 실행할 수 있도록 특성에서 OnChange 이벤트가 발생하도록 합니다.

특성 유형:: 모두

Xrm.Page.getAttribute(arg).fireOnChange()

RequiredLevel

레코드를 저장하기 전에 응용 프로그램이 필드가 데이터를 포함하고 있는지 여부를 제어할 수 있습니다.getRequiredLevel 및 setRequiredLevel 메서드를 사용하여 이 요구 사항을 조정합니다.

getRequiredLevel

특성에 대한 값이 필요한지 또는 권장되는지 여부를 나타내는 문자열 값을 반환합니다.

특성 유형:: 모두

Xrm.Page.getAttribute(arg).getRequiredLevel()

  • 반환 값
    유형: 문자열

    세 가지 가능한 값 중 하나를 반환합니다.

    • none

    • required

    • recommended

setRequiredLevel

레코드를 저장하기 전에 특성에 대해 데이터가 필요한지 권장되는지 여부를 설정합니다.

중요

특성의 필수 수준을 줄이면 페이지를 저장할 때 오류가 발생할 수 있습니다. 서버에 의해 특성이 필요한 경우 특성 값이 없으면 오류가 발생합니다.

이 메서드는 양식의 필드에 대해서만 지원됩니다. 비즈니스 프로세스 컨트롤에 표시되는 특성과 함께 이 메서드를 사용하여 비즈니스 프로세스 흐름 단계에 대한 요구 사항 수준을 설정할 수 없습니다. 비즈니스 프로세스 흐름 단계에 사용할 수 있는 클라이언트 측 메서드에 대한 자세한 내용은 단계 메서드를 참조하십시오.

특성 유형:: 모두

Xrm.Page.getAttribute(arg).setRequiredLevel(requirementLevel)

  • 인수
    유형: 문자열

    다음 값 중 하나:

    • none

    • required

    • recommended

SubmitMode

레코드가 만들어지거나 저장될 때 특성에 대한 데이터가 제출될 시기를 제어할 수 있습니다. 예를 들어, 양식에서 논리만 제어할 필드가 양식에 있을 수 있습니다. 데이터 캡처에 관심이 없는 경우가 있습니다. 데이터가 저장되지 않도록 설정할 수 있습니다. 또는 항상 포함되는 값에 따라 플러그 인이 등록될 수 있습니다. 항상 포함되도록 특성을 설정할 수 있습니다.createdby 같이 레코드의 초기 저장 후에 업데이트되지 않는 특성은 저장할 때 제출되지 않도록 설정됩니다. 변경 여부에 관계 없이 특성 값을 제출하도록 하려면 모드 매개 변수가 “항상”으로 설정된 상태에서 setSubmitMode 함수를 사용합니다.

setSubmitMode를 사용할 때는 세 가지 옵션이 있습니다.

  • always: 값이 항상 제출됩니다.

  • never: 값이 제출되지 않습니다. 이 옵션을 설정하는 경우 이 특성에 대한 양식에 있는 필드에서 데이터를 편집할 수 없습니다.

  • dirty(기본값): null이 아닌 경우 값이 제출되지 않으며 변경될 때만 저장됩니다.

getSubmitMode를 사용하여 현재 설정을 결정합니다.

getSubmitMode

레코드가 저장될 때 특성의 데이터가 제출됨을 나타내는 문자열을 반환합니다.

특성 유형:: 모두

Xrm.Page.getAttribute(arg).getSubmitMode()

  • 반환 값
    유형: 문자열

    세 가지 가능한 값 중 하나를 반환합니다.

    • always

    • never

    • dirty

    편집 가능한 필드의 기본값이 ‘dirty’이며, 이는 데이터 값이 변경될 때만 값이 서버에 제출된다는 것을 의미합니다.

setSubmitMode

레코드가 저장될 때 특성의 데이터가 제출될지 여부를 설정합니다.

특성 유형:: 모두

Xrm.Page.getAttribute(arg).setSubmitMode()

  • 인수
    유형: 문자열

    다음 값 중 하나:

    • always: 데이터가 항상 저장과 함께 보내집니다.

    • never: 데이터가 저장과 함께 보내지지 않습니다. 이 옵션을 사용하는 경우 이 특성에 대한 양식의 필드는 편집할 수 없습니다.

    • dirty: 기본 동작입니다. 데이터가 변경되면 데이터가 저장과 함께 보내집니다.

값

특성 값에 액세스하거나 설정하는 것은 양식 스크립트에서 가장 일반적으로 수행되는 작업입니다.

getValue

특성에 대한 데이터 값을 검색합니다.

특성 유형:: 모두

Xrm.Page.getAttribute(arg).getValue()

  • 반환 값
    유형: 형식의 특성에 따라 달라집니다.

    특성 유형

    반환 유형

    부울

    부울

    datetime

    날짜

    Microsoft Dynamics 365 사용자 로케일 기본 설정을 사용하여 날짜의 문자열 버전을 가져오려면 format 및 localeFormat 메서드를 사용합니다. 다른 메서드는 사용자의 Microsoft Dynamics 365 로케일 기본 설정 대신 운영 체제 로케일 설정을 사용하여 날짜 서식을 지정합니다.

    10진수

    숫자

    Double

    숫자

    정수

    숫자

    조회

    배열

    조회 개체의 배열입니다.

    참고

    특정 조회를 사용하면 전자 메일 엔터티 레코드에 대한 받는 사람: 필드 같이 조회에 관련된 여러 레코드를 설정할 수 있습니다. 따라서 모든 조회 데이터 값은 조회 특성이 추가할 둘 이상의 레코드 참조를 지원하지 않는 경우에도 조회 개체의 배열을 사용합니다.

    각 조회에는 다음과 같은 속성이 있습니다.

    entityType

    문자열: 조회에 표시되는 엔터티 이름

    ID

    문자열: 조회에 표시되는 레코드에 대한 GUID 값의 문자열 표현입니다.

    이름

    문자열: 조회에 표시할 레코드를 나타내는 텍스트입니다.

    메모

    문자열

    money

    숫자

    옵션 집합

    숫자

    문자열

    문자열

setValue

특성에 대한 데이터 값을 설정합니다.

특성 유형:: 모두

Xrm.Page.getAttribute(arg).setValue()

  • 인수
    특성의 형식에 따라 달라집니다.

    특성 유형

    인수 종류

    부울

    부울

    datetime

    날짜

    10진수

    숫자

    double

    숫자

    Integer

    숫자

    조회

    배열

    조회 개체의 배열입니다.

    참고

    ‘partylist’ 조회라고 하는 특정 조회를 사용하면 전자 메일 엔터티 레코드에 대한 받는 사람: 필드 같이 조회에 관련된 여러 레코드를 설정할 수 있습니다. 따라서 모든 조회 데이터 값은 조회 특성이 추가할 둘 이상의 레코드 참조를 지원하지 않는 경우에도 조회 개체의 배열을 사용합니다.

    각 조회 값에는 다음과 같은 속성이 있습니다.

    entityType

    문자열: 조회로 표현되는 엔터티의 논리 이름입니다.

    ID

    문자열: 조회에 표시되는 레코드에 대한 GUID 값의 문자열 표현입니다. 값은 다음과 같은 형식이어야 합니다. {XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}.

    이름

    문자열: 조회에 표시할 레코드를 나타내는 텍스트입니다. 일반적으로 엔터티의 기본 특성입니다.

    간단한 조회 특성 값을 설정하기 위해 만들 수 있는 도우미 함수의 예는 조회 특성 값 설정를 참조하십시오.

    메모

    문자열

    money

    숫자

    옵션 집합

    숫자

    참고

    getOptions 메서드는 옵션 값을 문자열로 반환합니다. 이러한 값을 사용하여 옵션 집합 특성의 값을 설정하기 전에 parseInt를 사용하여 숫자로 변환해야 합니다.

    유효한 statuscode(상태 설명) 옵션은 레코드의 현재 statecode에 따라 다릅니다.statecode(상태) 필드는 양식 스크립트에서 설정할 수 없습니다. 어떤 statecode 값이 유효한지 이해하려면 특성에 대한 메타데이터를 참조하십시오. 시스템 엔터티에 대한 기본값 목록은 TechNet: 기본 상태 및 상태 설명 값을 참조하십시오. 사용자 지정 엔터티의 경우 조직에 대한 메타데이터 찾아보기에서 설명하는 엔터티 메타데이터 브라우저를 사용하십시오. 마지막으로, 필드에 적용된 사용자 지정 상태 전환을 고려하십시오.추가 정보:TechNet: 상태 설명 전환 정의.

    문자열

    문자열

    > [!NOTE]
> <P>전자 메일 형식이 있는 문자열 필드는 문자열이 유효한 전자 메일 주소를 나타내야 합니다.</P>

    참고

    • setValue를 사용하여 특성을 업데이트하면 OnChange 이벤트 처리기가 실행되지 않습니다.OnChange 이벤트 처리기를 실행하려면 setValue 외에 fireOnChange를 사용해야 합니다.

    • 태블릿용 Microsoft Dynamics 365이 서버에 연결되어 있지 않으면 setValue는 작동하지 않습니다.

    • 복합 특성의 값을 설정할 수 없습니다.추가 정보:복합 특성에 대한 스크립트 작성.

    조회 특성 값 설정

    다음 예제에서는 간단한 조회 특성에 대한 값을 설정하는 setSimpleLookupValue 도우미 함수의 정의를 보여줍니다.

    function setSimpleLookupValue(LookupId, Type, Id, Name) {
   /// <summary>
   /// Sets the value for lookup attributes that accept only a single entity reference.
   /// Use of this function to set lookups that allow for multiple references, 
   /// a.k.a 'partylist' lookups, will remove any other existing references and 
   /// replace it with just the single reference specified.
   /// </summary>
   /// <param name="LookupId" type="String" mayBeNull="false" optional="false" >
   /// The lookup attribute logical name
   /// </param>
   /// <param name="Type" type="String" mayBeNull="false" optional="false" >
   /// The logical name of the entity being set.
   /// </param>
   /// <param name="Id" type="String" mayBeNull="false" optional="false" >
   /// A string representation of the GUID value for the record being set.
   /// The expected format is "{XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}".
   /// </param>
   /// <param name="Name" type="String" mayBeNull="false" optional="false" >
   /// The text to be displayed in the lookup.
   /// </param>
   var lookupReference = [];
   lookupReference[0] = {};
   lookupReference[0].id = Id;
   lookupReference[0].entityType = Type;
   lookupReference[0].name = Name;
   Xrm.Page.getAttribute(LookupId).setValue(lookupReference);
  }

    다음은 거래처 양식에서 primarycontactid 특성을 설정하기 위해 setSimpleLookupValue 함수를 사용하는 예입니다.

    setSimpleLookupValue("primarycontactid", "contact", "{6D9D4FCF-F4D3-E011-9D26-00155DBA3819}", "Brian Lamee");

    참고 항목

    클라이언트 쪽 프로그래밍 참조
    양식 스크립팅 빠른 참조
    Microsoft Dynamics 365 양식용 코드 작성
    Xrm.Page 개체 모델 사용

    Microsoft Dynamics 365

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