다음을 통해 공유

웹 리소스와 함께 OData 끝점 사용

  • 아티클

 

게시 날짜: 2016년 11월

적용 대상: Dynamics CRM 2015

웹 리소스를 사용하는 OData 끝점은 Microsoft Dynamics CRM 2015 및 Microsoft Dynamics CRM Online 2015 업데이트 데이터에 사용할 다른 인터페이스를 제공합니다. URI(Uniform Resource Identifier)를 기반으로 하는 서비스를 사용하여 HTTP 요청을 실행하기 위해 OData 끝점을 사용할 수 있습니다.

이 항목의 내용

OData 정의

OData의 Microsoft Dynamics CRM 구현

코드를 생성하는 타사 도구

OData 정의

OData 끝점은 개방형 데이터 프로토콜을 사용합니다. 이 프로토콜은 "RESTful" 디자인 패턴을 구현합니다. REST는 Representational State Transfer를 의미합니다.REST는 고유한 URI를 사용하여 모든 리소스를 다루는 구조적 스타일입니다.Microsoft Dynamics 365에서 리소스는 엔터티 컬렉션 또는 레코드일 수 있습니다.

REST는 인터넷 작동 방식으로 작동합니다.GET, POST, MERGE 및 DELETE와 같은 HTTP 동사를 사용하여 리소스와 상호 작용합니다.HTTP 요청 및 응답을 처리하는 데 다양한 라이브러리를 사용할 수 있습니다.REST는 프로그래밍 언어에 사용할 수 있는 표준 인터페이스를 제공합니다.REST를 사용하면 작업을 동기 또는 비동기로 처리할 수 있습니다. 비동기 작업을 수행할 수 있는 기능은 REST를 Microsoft Dynamics CRM 2015 및 Microsoft Dynamics CRM Online 2015 업데이트에서 사용되는 스크립트 및 웹 리소스에 적합하게 만듭니다.

OData의 Microsoft Dynamics CRM 구현

Microsoft Dynamics CRM 2015 및 Microsoft Dynamics CRM Online 2015 업데이트은 WCF(Windows Communication Foundation) 데이터 서비스 프레임워크를 사용하여 REST 기반 데이터 서비스인 OData(개방형 데이터 프로토콜) 끝점을 제공합니다. 이 끝점은 Organization Data Service에서 호출됩니다.Microsoft Dynamics 365에서 서비스 루트 URI는 다음과 같습니다.

[Your Organization Root URL]/xrmservices/2011/organizationdata.svc

OData는 ATOM 또는 JavaScript Object Notation(JSON)을 사용하여 데이터를 보내고 받습니다.ATOM은 RSS 피드에 사용되는 XML 기반 형식입니다.JSON은 JavaScript 개체의 직렬화에 허용되는 텍스트 형식입니다.

Microsoft Dynamics 365에서 사용되는 엔터티에 해당하는 일관된 URIs 집합을 제공하기 위해 EDM(엔터티 데이터 모델)은 "엔터티 유형"의 레코드 양식 및 레코드 간 연결로 데이터를 구성합니다.

OData 엔터티 데이터 모델

Microsoft Dynamics 365 EDM은 다음 경로에서 사용할 수 있는 OData 서비스 메타데이터 문서에 설명되어 있습니다.

[Your Organization Root URL]/xrmservices/2011/organizationdata.svc/$metadata

이 XML 문서는 사용 가능한 데이터를 설명하는 CSDL(개념적 스키마 정의 언어)을 사용합니다.JavaScript를 사용할 때 관리형 코드를 사용하거나 사용 가능한 개체에 대한 참조로 이 문서를 다운로드하여 유형의 클래스를 생성하기 위해 사용합니다.

제한 사항

OData 끝점은 SOAP 끝점에 대한 대안을 제공하지만 현재 몇 가지 제한이 있습니다. limitations.

  • 엔터티 레코드에는 만들기, 검색, 업데이트 및 삭제 작업만 수행할 수 있습니다.

    • Execute 메서드가 필요한 메시지는 수행할 수 없습니다.

    • 작업 연결 및 연결 취소는 탐색 속성을 사용하여 수행할 수 있습니다.

  • OData 프로토콜은 완전히 구현되지 않습니다. 일부 시스템 쿼리 옵션은 사용할 수 없습니다.
    자세한 내용은 OData 끝점을 사용하는 OData 시스템 쿼리 옵션을 참조하십시오.

  • 코드를 작성할 때 없었던 사용자 지정 엔터티, 특성 또는 관계에 대해 관리형 코드에 초기 바인딩을 사용할 수 없습니다.
    관리형 코드를 사용하여 프로그래밍하는 동안 일반적으로 WCF 데이터 서비스 클라이언트 데이터 서비스 클래스를 사용합니다. 이러한 클래스는 디자인 타임에 강력한 유형의 클래스를 가져오도록 초기 바인딩 런타임을 허용합니다. 사용 가능한 유일한 엔터티는 클래스를 생성할 때 시스템에서 정의된 엔터티입니다. 즉, 생성될 때 WCF 데이터 서비스 클라이언트 데이터 서비스 클래스에 포함되지 않은 사용자 지정 엔터티, 특성 또는 관계에서 런타임에 바인딩을 사용할 수 없습니다.

코드를 생성하는 타사 도구

Microsoft Dynamics 365을 사용하는 개발자 커뮤니티는 OData 끝점의 작동 및 사용할 수 있는 코드를 생성할 수 있는 방법을 보여 주는 몇 가지 도구를 만들었습니다. 다음 도구는 OData 끝점을 사용하는 Dynamics 365 데이터를 사용하여 작동하는 코드를 생성할 수 있는 기능을 제공합니다.

  • CRM REST 작성기
    이 도구를 사용하여 다양한 JavaScript 라이브러리를 사용하는 데이터를 검색하고 작업을 수행하는 요청을 작성합니다.

    이 도구를 구축하는 데 도움을 준 Microsoft Dynamics 365 MVP Jason Lattimer에게 감사를 표합니다.

  • OData 쿼리 디자이너
    Dynamics XRM 도구 프로젝트에 포함된 OData 쿼리 디자이너를 사용하면 OData 끝점을 사용하는 데이터를 검색하는 쿼리를 만들 수 있습니다.

    이 도구 및 기타 도구를 구축하는 데 도움을 준 Microsoft Dynamics 365 MVP Rhett Clinton에게 감사를 표합니다.

참고 항목

웹 리소스에서 웹 서비스 데이터 사용(OData 및 최신 앱 SOAP 끝점)
웹 리소스를 사용하여 최신 응용 프로그램에 대해 최신 앱 SOAP 끝점 사용
Microsoft Dynamics CRM 2015용 웹 리소스
Microsoft Dynamics CRM 2015 개발자 리소스 페이지를 사용하여 끝점 다운로드
OData 끝점을 사용하여 Microsoft Dynamics CRM 2015 데이터 쿼리
OData 끝점을 사용하여 기본 데이터 작업 수행
Ajax 및 JScript 웹 리소스와 함께 OData 끝점 사용
OData 끝점을 사용하여 추가 데이터 작업 수행
샘플: JavaScript 및 jQuery와 함께 OData 끝점을 사용하여 만들기, 검색, 업데이트 및 삭제
샘플: JavaScript와 함께 OData 끝점을 사용하여 만들기, 검색, 업데이트 및 삭제
샘플: OData 끝점 jQuery 연락처 편집기
개방형 데이터 프로토콜 개요
OData SDK
기술 문서: REST 끝점과 함께 옵션 집합 옵션 사용 - JScript

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