다음을 통해 공유


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

 

게시 날짜: 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.saveXrm.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 개체 모델 사용

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