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

아티클
07/06/2017

게시 날짜: 2016년 11월

적용 대상: Dynamics CRM 2015

Xrm.Page.data.entity는 메서드를 제공하여 페이지, 메서드 및 양식에 포함된 모든 특성 모음에 표시된 레코드에 대한 특정 정보를 검색합니다. 특성 데이터는 양식의 필드가 나타내는 특성으로 제한됩니다.

Xrm.Page.data.entity 속성 및 메서드

특성
엔터티에 대한 특성 모음입니다.
getDataXml
레코드를 저장할 때 서버에 보내는 xml을 나타내는 문자열을 반환합니다.
getEntityName
레코드에 대한 엔터티의 논리 이름을 나타내는 문자열을 반환합니다.
getId
레코드에 대한 GUID id 값을 나타내는 문자열을 반환합니다.
getIsDirty
양식의 필드가 수정되었는지를 나타내는 부울 값을 반환합니다.
OnSave
addOnSave 및 removeOnSave 메서드를 사용하여 저장 이벤트에 이벤트 처리기를 추가하거나 제거합니다.
getPrimaryAttributeValue
엔터티의 기본 특성 값을 문자열로 가져옵니다.
저장
옵션을 사용하여 레코드를 저장하여 양식을 닫거나 저장을 완료한 후 새 양식을 엽니다.

특성

Xrm.Page.data.entity.attributes 컬렉션은 양식에 표시된 레코드의 데이터에 액세스하는 메서드를 제공합니다. 이 컬렉션에 대한 자세한 내용은 컬렉션(클라이언트 쪽 참조)을 참조하십시오. 이 컬렉션에 있는 개체에 사용할 수 있는 속성 및 메서드는 Xrm.Page.data.entity 특성(클라이언트 쪽 참조)를 참조하십시오.

getDataXml

레코드를 저장할 때 서버에 보내는 XML을 나타내는 문자열을 반환합니다. 변경된 필드에 있는 데이터만 서버에 설정됩니다.

참고

이 함수는 태블릿용 Microsoft Dynamics CRM에서 작동하지 않습니다.

Xrm.Page.data.entity.getDataXml()

반환 값
유형: 문자열

예: 이 예제에서 계정 레코드에 대한 다음 세 가지 필드가 업데이트되었습니다.
- 이름
- accountnumber
- telephone2
```
"<account><name>Contoso</name><accountnumber>55555</accountnumber><telephone2>425 555-1234</telephone2></account>"
```

getEntityName

레코드에 대한 엔터티의 논리 이름을 나타내는 문자열을 반환합니다.

Xrm.Page.data.entity.getEntityName()

반환 값
유형: 문자열. 엔터티의 이름입니다.

예: 이 예제에서 거래처 레코드를 편집하고 있었습니다.
```
"account"
```

getId

레코드에 대한 GUID id 값을 나타내는 문자열을 반환합니다.

Xrm.Page.data.entity.getId()

반환 값
유형: 문자열

예: 레코드의 GUID Id 값입니다.
```
"{825CB223-A651-DF11-AA8B-00155DBA3804}"
```

getIsDirty

양식의 필드가 수정되었는지를 나타내는 부울 값을 반환합니다.

Xrm.Page.data.entity.getIsDirty()

반환 값
유형: 부울

OnSave

addOnSave 및 removeOnSave 메서드를 사용하여 저장 이벤트에 이벤트 처리기를 추가하거나 제거합니다.

addOnSave

레코드를 저장할 때 호출되는 함수를 추가합니다.

Xrm.Page.data.entity.addOnSave([function reference])

매개 변수
유형: 함수 참조

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

예: 이 예에서 JavaScript 라이브러리는 두 함수를 포함합니다.addMessageToOnSave 함수를 양식 OnLoad 이벤트에 추가하면 displayOrgName 함수가 OnSave 이벤트의 처리기로 추가됩니다.
```
function displayOrgName(execContext)
{
    try {
        alert(execContext.getContext().getOrgUniqueName());
    }
    catch (e) {
        alert(e.message);
    }
}

function addMessageToOnSave() {
    Xrm.Page.data.entity.addOnSave(displayOrgName);
}
```

removeOnSave

레코드를 저장할 때 호출되는 함수를 제거합니다.

Xrm.Page.data.entity.removeOnSave([function reference])

매개 변수
유형: 함수 참조

예: 이 예에서 JavaScript 라이브러리는 두 함수를 포함합니다.removeMessageFromOnSave 함수를 양식 OnSave 이벤트에 추가하면 displayOrgName 함수가 이벤트의 처리기로 제거됩니다.

function displayOrgName(execContext)
{
    try {
        alert(execContext.getContext().getOrgUniqueName());
    }
    catch (e) {
        alert(e.message);
    }
}

function removeMessageFromOnSave() {
    Xrm.Page.data.entity.removeOnSave(displayOrgName);
}

getPrimaryAttributeValue

엔터티의 기본 특성 값을 문자열로 가져옵니다.

Xrm.Page.data.entity.getPrimaryAttributeValue()

각 엔터티에는 PrimaryNameAttribute로 지정된 문자열 특성 하나가 있습니다. 이 특성의 값은 해당 레코드에 대한 링크가 표시될 때 사용됩니다.

반환 값
유형: 문자열. 엔터티의 기본 특성의 값입니다.
설명
이 메서드는 업데이트된 엔터티에만 사용할 수 있습니다.

저장

옵션을 사용하여 레코드를 동기적으로 저장하여 양식을 닫거나 저장을 완료한 후 새 양식을 엽니다.

Xrm.Page.data.save 및 Xrm.Page.data.entity.save 둘 다 레코드를 저장하지만 Xrm.Page.data.save는 저장 작업이 완료된 후 콜백 함수를 제공합니다.

Xrm.Page.data.entity.save( null | "saveandclose" |"saveandnew" )

인수
- save()
  매개 변수가 포함되지 않은 경우 단순히 레코드가 저장됩니다. 이는 저장 명령을 사용하는 것과 같습니다.
- save("saveandclose")
  이는 저장 후 닫기 명령을 사용하는 것과 같습니다.
- save("saveandnew")
  이는 저장 및 새로 만들기 명령을 사용하는 것과 같습니다.

설명
웹 응용 프로그램에서 빨리 만들기 양식을 사용할 때 saveandnew 옵션은 적용되지 않습니다. 항상 saveandclose이 사용된 것처럼 작동합니다.태블릿용 Microsoft Dynamics CRM에서 빨리 만들기 양식은 saveandnew 동작을 적용합니다.

참고 항목

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