Microsoft Dynamics 365웹 API 제한 사항
게시 날짜: 2017년 1월
적용 대상: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
Microsoft Dynamics 365 웹 API는 조직 서비스의 기능과 함께 완전 패리티를 제공합니다.Microsoft Dynamics 365(온라인 및 온-프레미스)의 경우, 이 항목에서 제한 사항에 대해 설명합니다.
이 항목의 내용
Microsoft Dynamics 365용 2016년 12월 업데이트(온라인) 및 Microsoft Dynamics 365용 서비스 팩 2016년 12월(온-프레미스)의 제한 사항
Microsoft Dynamics 365용 2016년 12월 업데이트(온라인) 및 Microsoft Dynamics 365용 서비스 팩 2016년 12월(온-프레미스)에서 해소된 제한 사항
Microsoft Dynamics CRM Online 2016 업데이트 1 및 Microsoft Dynamics CRM 2016 서비스 팩 1에서 해소된 제한 사항
Microsoft Dynamics CRM Online 2016 업데이트 0.1 및 Microsoft Dynamics CRM 2016 업데이트 0.1에서 해소된 제한 사항
Microsoft Dynamics 365용 2016년 12월 업데이트(온라인) 및 Microsoft Dynamics 365용 서비스 팩 2016년 12월(온-프레미스)의 제한 사항
이 섹션에서는 Microsoft Dynamics 365용 2016년 12월 업데이트(온라인) 및 Microsoft Dynamics 365용 서비스 팩 2016년 12월(온-프레미스)의 제한 사항에 대한 정보를 제공합니다.
웹 API에서 일부 사용자 지정 작업을 사용할 수 없음
누락된 기능 및 일부 조직 서비스 메시지에 대한 작업
웹 API에서 일부 사용자 지정 작업을 사용할 수 없음
복잡한 반환 값과 단순한 반환 값을 포함하는 사용자 지정 동작을 정의하는 경우 실행 해당 작업은 웹 API에서 지원되지 않지만 2011 SOAP 끝점을 사용하면 가능합니다. 복잡한 반환 값은 EntityReference, Entity, 또는 EntityCollection입니다. 단순한 반환 값의 조합 또는 단일 복합을 값 가질 수 있습니다.추가 정보:사용자 고유의 작업 만들기
누락된 기능 및 일부 조직 서비스 메시지에 대한 작업
다음 표는 Microsoft Dynamics 365용 2016년 12월 업데이트(온라인) 및 Microsoft Dynamics 365용 서비스 팩 2016년 12월(온-프레미스)가 적용된 후 해당 기능이나 동작이 없는 메시지를 나열합니다.
초기 릴리스에서 누락된 기능 및 동작 목록의 경우, Microsoft Dynamics CRM Online 2016 업데이트 0.1 및 Microsoft Dynamics CRM 2016 업데이트 0.1에 추가된 함수 및 동작 및 Microsoft Dynamics CRM Online 2016 업데이트 1 및 Microsoft Dynamics CRM 2016 서비스 팩 1에 추가된 함수 및 동작 아래의 목록과 이 목록을 합친 것입니다.
Microsoft Dynamics 365용 2016년 12월 업데이트(온라인) 및 Microsoft Dynamics 365용 서비스 팩 2016년 12월(온-프레미스)에서 해소된 제한 사항
이 섹션에서는 Microsoft Dynamics 365용 2016년 12월 업데이트(온라인) 및 Microsoft Dynamics 365용 서비스 팩 2016년 12월(온-프레미스)의 제한 사항에 대한 정보를 제공합니다.
사용자가 오프 라인 상태일 때 Outlook용 Microsoft Dynamics 365(오프라인 액세스 가능)에 대해 웹 API에 사용할 수 없습니다.
날짜 값을 쿼리할 수 없음
컬렉션의 매개 변수 엔터티 컬렉션 매개 변수 뿐만 아니라 다른 매개 변수를 사용하여 작업을 호출할 때 본문의 마지막 매개 변수로 전달되어야 합니다.
고객 조회 특성을 만들 수 없음
게시되지 않은 메타데이터를 검색할 수 없음
새 작업 추가됨
다음 작업이 Microsoft Dynamics 365용 2016년 12월 업데이트(온라인) 및 Microsoft Dynamics 365용 서비스 팩 2016년 12월(온-프레미스)에 대한 웹 API에 추가되었습니다.
사용자가 오프 라인 상태일 때 Outlook용 Microsoft Dynamics 365(오프라인 액세스 가능)에 대해 웹 API에 사용할 수 없습니다.
참고
이 문제는 Microsoft Dynamics 365용 2016년 12월 업데이트(온라인) 및 Microsoft Dynamics 365용 서비스 팩 2016년 12월(온-프레미스)에서 해결됩니다.
JavaScript 양식 스크립트, 리본 명령 또는 HTML 웹 리소스에서 실행 되는 코드가 웹 API를 사용할 수 없습니다. 이제 사용자가 오프라인인 경우 사용되는 로컬 서버에서 활성화됩니다.
날짜 값을 쿼리할 수 없음
이 문제는 실제 제한 사항이 아니라 구문 문제입니다. 필터에 날짜 값을 지정할 때 작은따옴표를 사용하지 마십시오.
연락처의 생일 등의 날짜 속성을 쿼리할 때 다음 쿼리 구문을 사용할 수 있습니다.
/contacts?$select=fullname,birthdate&$filter=birthdate eq 1990-01-01
다음 구문을 사용할 수 없습니다.
/contacts?$select=fullname,birthdate&$filter=birthdate eq '1990-01-01'
컬렉션의 매개 변수 엔터티 컬렉션 매개 변수 뿐만 아니라 다른 매개 변수를 사용하여 작업을 호출할 때 본문의 마지막 매개 변수로 전달되어야 합니다.
참고
이 문제는 Microsoft Dynamics 365용 2016년 12월 업데이트(온라인) 및 Microsoft Dynamics 365용 서비스 팩 2016년 12월(온-프레미스)에서 해결됩니다.
다음과 같은 작업에는 엔터티 컬렉션 매개 변수가 다른 매개 변수와 함께 포함되어 있습니다.
Microsoft Dynamics 365용 2016년 12월 업데이트(온라인) 및 Microsoft Dynamics 365용 서비스 팩 2016년 12월(온-프레미스) 이전에서는 이러한 동작을 사용하면 엔터티 컬렉션을 포함하는 매개 변수가 JSON 또는 오류를 반환하는 시스템의 마지막 매개 변수로 전달되어야 합니다. 예를 들어, QualifyMemberList Action를 사용할 때 오류가 발생해 다음 방식으로 매개 변수 값을 전달합니다.
{
"ListMember": [
{
"@odata.type": "Microsoft.Dynamics.CRM.account",
"accountid": "483F8080-6976-E511-9172-0024E8436263"
},
{
"@odata.type": "Microsoft.Dynamics.CRM.account",
"accountid": "4D3F8080-6976-E511-9172-0024E8436263"
}
],
"OverrideorRemove": true
}
하지만 다음이 성공해야 합니다.
{
"OverrideorRemove": true,
"ListMember": [
{
"@odata.type": "Microsoft.Dynamics.CRM.account",
"accountid": "483F8080-6976-E511-9172-0024E8436263"
},
{
"@odata.type": "Microsoft.Dynamics.CRM.account",
"accountid": "4D3F8080-6976-E511-9172-0024E8436263"
}
]
}
고객 조회 특성을 만들 수 없음
참고
이 문제는 Microsoft Dynamics 365용 2016년 12월 업데이트(온라인) 및 Microsoft Dynamics 365용 서비스 팩 2016년 12월(온-프레미스)에서 해결됩니다.
Microsoft Dynamics CRM Online 2016 업데이트 1 및 Microsoft Dynamics CRM 2016 서비스 팩 1에서는 웹 API를 사용하여 고객 조회 특성을 만들 수 없습니다.
Microsoft Dynamics 365용 2016년 12월 업데이트(온라인) 및 Microsoft Dynamics 365용 서비스 팩 2016년 12월(온-프레미스)를 사용하여 웹 API로 고객 조회 특성을 만들려면 고객 조회 특성 만들기를 참조하십시오.
게시되지 않은 메타데이터를 검색할 수 없음
참고
이 문제는 Microsoft Dynamics 365용 2016년 12월 업데이트(온라인) 및 Microsoft Dynamics 365용 서비스 팩 2016년 12월(온-프레미스)에서 해결됩니다.
메타데이터를 검색하는 조직 서비스 Message는 아직 게시에 의해 수행되지 않은 메타데이터 정의를 반환하는 옵션을 제공하는 RetrieveAsIfPublished 매개 변수를 포함합니다. 이 기능은 메타데이터를 편집할 때 사용할 응용 프로그램을 구축하고 실행되지 않은 변경 사항을 저장해야 할 경우 유용합니다.Microsoft Dynamics CRM Online 2016 업데이트 1 및 Microsoft Dynamics CRM 2016 서비스 팩 1에서 메타데이터에 대한 모든 검색 작업은 게시된 메타데이터를 반환합니다.추가 정보:웹 API를 Dynamics 365 메타데이터와 함께 사용 및 사용자 지정 항목 게시 두 가지가 있습니다.
Microsoft Dynamics CRM Online 2016 업데이트 1 및 Microsoft Dynamics CRM 2016 서비스 팩 1에서 해소된 제한 사항
Microsoft Dynamics CRM Online 2016 업데이트 1및 Microsoft Dynamics CRM 2016 서비스 팩 1에 함수 및 동작이 추가되었으며 웹 API를 사용하여 다음과 같은 문제를 해결합니다.
Microsoft Dynamics CRM Online 2016 업데이트 1 및 Microsoft Dynamics CRM 2016 서비스 팩 1에 추가된 함수 및 동작
단일 값 탐색 속성의 값을 기준으로 쿼리를 필터링할 수 없습니다.
Microsoft Dynamics CRM Online 2016 업데이트 1 및 Microsoft Dynamics CRM 2016 서비스 팩 1에 추가된 함수 및 동작
다음 표에서는 Microsoft Dynamics CRM Online 2016 업데이트 1 및 Microsoft Dynamics CRM 2016 서비스 팩 1에 추가된 함수와 동작을 나열합니다.
단일 값 탐색 속성의 값을 기준으로 쿼리를 필터링할 수 없습니다.
참고
이 문제는 Microsoft Dynamics CRM Online 2016 업데이트 1 및 Microsoft Dynamics CRM 2016 서비스 팩 1에서 부분적으로 해결됩니다. 이제 탐색 속성이 참조되는 엔터티의 기본 특성 값을 참조하는 경우 탐색 단일 값 속성에 대한 쿼리를 필터링할 수 있습니다.추가 정보:단일 값 탐색 속성을 기준으로 레코드 필터링
탐색 단일 값 속성의 속성을 사용하여 쿼리에서를 필터로 501 오류가 나타납니다. 예를 들어, 다음 쿼리는 기본 연락처 firstname 속성 값이 "Renee"인 모든 거래처를 반환하려고 합니다.
요청
GET [Organization URI]/api/data/v8.0/accounts?$select=name&$filter=primarycontactid/firstname eq 'Renee' HTTP/1.1 Accept: application/json OData-MaxVersion: 4.0 OData-Version: 4.0응답
HTTP/1.1 501 Not Implemented Content-Type: application/json; odata.metadata=minimal OData-Version: 4.0 { "error": { "code": "", "message": "The query node (0) is not supported", "innererror": { "message": "The query node (0) is not supported", "type": "Microsoft.Crm.CrmHttpException", "stacktrace": <stacktrace value removed for brevity> } } }
Microsoft Dynamics CRM Online 2016 업데이트 0.1 및 Microsoft Dynamics CRM 2016 업데이트 0.1에서 해소된 제한 사항
Microsoft Dynamics CRM Online 2016 업데이트 0.1및 Microsoft Dynamics CRM Online 2016 업데이트 0.1는 함수 및 동작을 추가하고 웹 API를 사용하여 다음과 같은 문제를 해결 합니다.
Microsoft Dynamics CRM Online 2016 업데이트 0.1 및 Microsoft Dynamics CRM 2016 업데이트 0.1에 추가된 함수 및 동작
자체 참조용 다 대 다 관계를 쿼리할 때 발생하는 오류
일부 $expand에 대한 $select 표현은 무시될 수 있습니다.
Null 값이 있는 경우 단일 값 탐색 속성을 $espand 쿼리에서 반환할 수 있습니다.
activitypointer에 연결된 FetchXML 쿼리가 연결된 필드를 포함하지 않을 수 있습니다
확장된 탐색 속성 결과에 null 값 속성을 반환할 수 있습니다.
Microsoft Dynamics CRM Online 2016 업데이트 0.1 및 Microsoft Dynamics CRM 2016 업데이트 0.1에 추가된 함수 및 동작
다음 표에서는 Microsoft Dynamics CRM Online 2016 업데이트 0.1 및 Microsoft Dynamics CRM 2016 업데이트 0.1에 추가된 함수와 동작을 나열합니다.
자체 참조용 다 대 다 관계를 쿼리할 때 발생하는 오류
참고
이 문제는 Microsoft Dynamics CRM Online 2016 업데이트 0.1 및 Microsoft Dynamics CRM 2016 업데이트 0.1에서 해결됩니다.
자체 참조 다 대 다 관계를 갖는 시스템 엔터티에는 connectionroleassociation_association를 갖는 connectionrole EntityType 및 campaigncampaign_association를 갖는 campaign EntityType 두 가지가 있습니다. 이러한 컬렉션 값 탐색 속성을 사용하는 쿼리를 시도할 경우 다음과 같은 HTTP Status 400 오류가 예상 됩니다.Reflexive relationship must specify direction using ReflexiveManyToManyRelationship.
이러한 다 대 다 관계를 사용하는 데이터를 쿼리해야 할 경우, 교차 엔터티를 대신 사용할 수 있습니다.campaigncampaign_association 컬렉션 값 탐색 속성의 경우 campaignitem EntityType 엔터티는 관계를 정의하는 특수 교차 엔터티입니다. connectionroleassociation_association의 경우, connectionroleassociation은 이 다 대 다 관계를 정의하는 데이터를 포함하는 보통 교차 엔터티입니다. 보통 교차 엔터티는 참조 문서에 들어있지 않지만 웹 API에서 사용할 수 있습니다./api/data/v8.0/connectionroleassociations URI를 사용하여 connectionroleassociation 엔터티에 액세스할 수 있습니다.추가 정보:모음 값 탐색 속성
일부 $expand에 대한 $select 표현은 무시될 수 있습니다.
참고
이 문제는 Microsoft Dynamics CRM Online 2016 업데이트 0.1 및 Microsoft Dynamics CRM 2016 업데이트 0.1에서 해결됩니다.
마지막 탐색 속성이 없는 경우 두 개의 탐색 속성을 검색할 때 $select 쿼리 옵션 탐색 속성의 모든 속성이 반환 됩니다. 예를 들어 다음과 같은 쿼리를 구축한다고 가정해 보겠습니다.
GET
[Organization URI]/api/data/v8.0/accounts(0495779B-F67F-E511-80C2-00155DB09B03)$select=name&$expand=contact_customer_accounts($select=lastname),opportunity_customer_accounts
두어야는 name 계정 속성의 lastname 를 사용 하 여 연결 된 연락처의 contact_customer_accounts 및 모든 속성을 사용 하 여 관련 기회 opportunity_customer_accounts.
그러나 연락처 뿐만 아니라 관련된 기회의 모든 속성에 대 한 모든 속성을 얻을 수 있습니다. 항상 $select을 사용하여 검색 작업의 속성을 제한하는 것이 가장 좋습니다. 따라서, 이 방식을 사용하여 최상의 수행을 확보하고 필요 이상의 데이터를 검색하지 않도록 하십시오.
Null 값이 있는 경우 단일 값 탐색 속성을 $espand 쿼리에서 반환할 수 있습니다.
참고
이 문제는 Microsoft Dynamics CRM Online 2016 업데이트 0.1 및 Microsoft Dynamics CRM 2016 업데이트 0.1에서 해결됩니다.
OData 사양에 따라, 단일 탐색 속성을 확장하고 값이 없을 때, 속성이 null 집합으로 포함되어야 합니다. 현재 동작은 속성이 JSON 응답에 포함되지 않습니다. 다음 예제에서는 계정 primarycontactid 탐색 단일 값 속성을 요청했는데 해당 탐색 속성과 연결된 연락처가 없어 값이 null입니다.
요청
GET [Organization URI]/api/data/v8.0/accounts(25DD0B31-ED8B-E511-80D2-00155D2A68D4)?$select=name&$expand=primarycontactid($select=fullname) HTTP/1.1 Accept: application/json Content-Type: application/json; charset=utf-8 OData-MaxVersion: 4.0 OData-Version: 4.0예상 응답일
HTTP/1.1 200 OK OData-Version: 4.0 { "@odata.context": " [Organization URI]/api/data/v8.0/$metadata#accounts(name,primarycontactid,primarycontactid(fullname))/$entity", "@odata.etag": "W/\"504724\"", "name": "A. Datum Corporation (sample)", "accountid": "25dd0b31-ed8b-e511-80d2-00155d2a68d4", "primarycontactid": null }실제 응답일
HTTP/1.1 200 OK OData-Version: 4.0 { "@odata.context": " [Organization URI]/api/data/v8.0/$metadata#accounts(name,primarycontactid,primarycontactid(fullname))/$entity", "@odata.etag": "W/\"504724\"", "name": "A. Datum Corporation (sample)", "accountid": "25dd0b31-ed8b-e511-80d2-00155d2a68d4" }
activitypointer에 연결된 FetchXML 쿼리가 연결된 필드를 포함하지 않을 수 있습니다
참고
이 문제는 Microsoft Dynamics CRM Online 2016 업데이트 0.1 및 Microsoft Dynamics CRM 2016 업데이트 0.1에서 해결됩니다.
activitypointer이 연결된 엔터티로 포함된 FetchXML을 이용하여 쿼리를 만들 경우, 속성 값이 null이 됩니다. 예를 들어 다음과 같은 fetchXML를 사용한다고 가정해 보겠습니다.
<fetch version="1.0"
output-format="xml-platform"
mapping="logical"
distinct="true">
<entity name="account">
<attribute name="name" />
<link-entity name="activitypointer"
from="regardingobjectid"
to="accountid"
link-type="inner">
<attribute name="subject" />
</link-entity>
</entity>
</fetch>
관련 activitypointer을 요청합니다.subject 값을 반환할 수 있습니다. 실제 값이 존재하는 경우 null 값이 반환됩니다.
요청
GET [Organization URI]/api/data/v8.0/accounts?fetchXml=%3Cfetch%20version=%221.0%22%20output-format=%22xml-platform%22%20mapping=%22logical%22%20distinct=%22true%22%3E%3Centity%20name=%22account%22%3E%3Cattribute%20name=%22name%22%20/%3E%3Clink-entity%20name=%22activitypointer%22%20from=%22regardingobjectid%22%20to=%22accountid%22%20link-type=%22inner%22%3E%3Cattribute%20name=%22subject%22%20/%3E%3C/link-entity%3E%3C/entity%3E%3C/fetch%3E HTTP/1.1 Accept: application/json OData-MaxVersion: 4.0 OData-Version: 4.0예상 응답일
HTTP/1.1 200 OK Content-Type: application/json; odata.metadata=minimal OData-Version: 4.0 { "@odata.context": " [Organization URI]/api/data/v8.0/$metadata#accounts(name)", "value": [ { "name": "A. Datum Corporation (sample)", "activitypointer1.subject": "Task Subject Value" } ] }실제 응답일
HTTP/1.1 200 OK Content-Type: application/json; odata.metadata=minimal OData-Version: 4.0 { "@odata.context": " [Organization URI]/api/data/v8.0/$metadata#accounts(name)", "value": [ { "name": "A. Datum Corporation (sample)", "activitypointer1.subject": null } ] }
추가 정보:사용자 지정 FetchXML 사용
확장된 탐색 속성 결과에 null 값 속성을 반환할 수 있습니다.
참고
이 문제는 Microsoft Dynamics CRM Online 2016 업데이트 0.1 및 Microsoft Dynamics CRM 2016 업데이트 0.1에서 해결됩니다.
확장된 속성 컬렉션을 반환하는 탐색 속성의 값이 null이면 결과에 확장된 속성이 포함되지 않습니다. 첫 번째 예제는 거래처와 관련된 연락처 중 하나에 확장된 emailaddress1 속성에 대한 null 값이 있을 경우를 보여 줍니다.emailaddress1 속성은 값이 있는 연락처에 대해서도 반환되지 않습니다.
요청
GET [Organization URI]/api/data/v8.0/accounts(25DD0B31-ED8B-E511-80D2-00155D2A68D4)?$select=name&$expand=contact_customer_accounts($select=emailaddress1,lastname,firstname) HTTP/1.1 Accept: application/json Content-Type: application/json; charset=utf-8 OData-MaxVersion: 4.0 OData-Version: 4.0예상 응답일
HTTP/1.1 200 OK Content-Type: application/json; odata.metadata=minimal OData-Version: 4.0 { "@odata.context": " [Organization URI]/api/data/v8.0/$metadata#accounts(name,contact_customer_accounts,contact_customer_accounts(emailaddress1,lastname,firstname))/$entity", "@odata.etag": "W/\"504724\"", "name": "A. Datum Corporation (sample)", "accountid": "25dd0b31-ed8b-e511-80d2-00155d2a68d4", "contact_customer_accounts": [ { "@odata.etag": "W/\"504749\"", "emailaddress1": null, "lastname": "Valdes (sample)", "firstname": "Rene", "contactid": "8bdd0b31-ed8b-e511-80d2-00155d2a68d4" }, { "@odata.etag": "W/\"503647\"", "emailaddress1": someone_l@example.com, "lastname": "Burk (sample)", "firstname": "Susan", "contactid": "91dd0b31-ed8b-e511-80d2-00155d2a68d4" } ] }실제 응답일
HTTP/1.1 200 OK Content-Type: application/json; odata.metadata=minimal OData-Version: 4.0 { "@odata.context": " [Organization URI]/api/data/v8.0/$metadata#accounts(name,contact_customer_accounts,contact_customer_accounts(emailaddress1,lastname,firstname))/$entity", "@odata.etag": "W/\"504724\"", "name": "A. Datum Corporation (sample)", "accountid": "25dd0b31-ed8b-e511-80d2-00155d2a68d4", "contact_customer_accounts": [ { "@odata.etag": "W/\"504749\"", "lastname": "Valdes (sample)", "firstname": "Rene", "contactid": "8bdd0b31-ed8b-e511-80d2-00155d2a68d4" }, { "@odata.etag": "W/\"503647\"", "lastname": "Burk (sample)", "firstname": "Susan", "contactid": "91dd0b31-ed8b-e511-80d2-00155d2a68d4" } ] }
다음 쿼리는 확장 없이 contact_customer_accounts 컬렉션 값 탐색 속성을 직접 사용하여 예상된 데이터를 반환합니다.
요청
GET [Organization URI]/api/data/v8.0/accounts(25DD0B31-ED8B-E511-80D2-00155D2A68D4)/contact_customer_accounts?$select=emailaddress1,lastname,firstname HTTP/1.1 Accept: application/json Content-Type: application/json; charset=utf-8 OData-MaxVersion: 4.0 OData-Version: 4.0응답
HTTP/1.1 200 OK Content-Type: application/json; odata.metadata=minimal OData-Version: 4.0 { "@odata.context": " [Organization URI]/api/data/v8.0/$metadata#contacts(emailaddress1,lastname,firstname)", "value": [ { "@odata.etag": "W/\"504749\"", "emailaddress1": null, "lastname": "Valdes (sample)", "firstname": "Rene", "contactid": "8bdd0b31-ed8b-e511-80d2-00155d2a68d4" }, { "@odata.etag": "W/\"503647\"", "emailaddress1": "someone_l@example.com", "lastname": "Burk (sample)", "firstname": "Susan", "contactid": "91dd0b31-ed8b-e511-80d2-00155d2a68d4" } ] }
참고 항목
Microsoft Dynamics 365 웹 API 사용
웹 API를 사용하여 Microsoft Dynamics 365 인증
웹 API 종류 및 운영
웹 API를 사용하여 작업 수행
Microsoft Dynamics 365
© 2017 Microsoft. All rights reserved. 저작권 정보