웹 API를 사용하여 엔터티 연결 및 연결 해제

아티클
10/31/2017

게시 날짜: 2017년 1월

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

몇 가지 메서드로 엔터티를 연결하고 연결 해제할 수 있습니다. 업데이트를 만드는지 아니면 업데이트하는지 및 참조된 엔터티 또는 참조하는 엔터티의 컨텍스트에서 작동하는지 여부에 따라 적용하는 메서드가 다릅니다.

이 항목의 내용

컬렉션 값 탐색 속성에 대한 참조를 추가합니다.

엔터티에 대한 참조 삭제

단일 값 탐색 속성의 참조 변경

만들 때 엔터티 연결

업데이트 시 엔터티 연결

컬렉션 값 탐색 속성에 대한 참조를 추가합니다.

다음 예제는 opportunityid 값 00000000-0000-0000-0000-000000000001로 기존 영업 기회 엔터티를 accountid 00000000-0000-0000-0000-000000000002 값을 갖는 거래처 앤터티용 컬렉션 값 opportunity_customer_accounts 탐색 속성에 연결하는 방법을 보여 줍니다. 이것은 1:N 관계이지만 N:N 관계에 대해서도 동일한 작업을 수행할 수 있습니다.

요청

POST cc_WebAPI_ServiceURI/accounts(00000000-0000-0000-0000-000000000002)/opportunity_customer_accounts/$ref HTTP/1.1 
Content-Type: application/json 
Accept: application/json 
OData-MaxVersion: 4.0 
OData-Version: 4.0

{
"@odata.id":"cc_WebAPI_ServiceURI/opportunities(00000000-0000-0000-0000-000000000001)"
}

응답

HTTP/1.1 204 No Content
OData-Version: 4.0

엔터티에 대한 참조 삭제

DELETE 요청을 사용하여 엔터티에 대한 참조를 삭제합니다. 수행 방법은 컬렉션 값 탐색 속성을 참조하는지 아니면 단일 값 탐색 속성을 참조하는지에 따라 다릅니다.

요청
컬렉션 값 탐색 속성의 경우 다음을 사용합니다.

DELETE cc_WebAPI_ServiceURI/accounts(00000000-0000-0000-0000-000000000002)/opportunity_customer_accounts/$ref?$id=cc_WebAPI_ServiceURI/opportunities(00000000-0000-0000-0000-000000000001) HTTP/1.1
Accept: application/json
OData-MaxVersion: 4.0
OData-Version: 4.0

또는 이 방법을 사용합니다.

DELETE cc_WebAPI_ServiceURI/accounts(00000000-0000-0000-0000-000000000002)/opportunity_customer_accounts(00000000-0000-0000-0000-000000000001)/$ref HTTP/1.1
Accept: application/json
OData-MaxVersion: 4.0
OData-Version: 4.0

요청
단일 값 탐색 속성의 경우, $id 쿼리 문자열 매개 변수를 삭제합니다.

DELETE cc_WebAPI_ServiceURI/opportunities(00000000-0000-0000-0000-000000000001)/customerid_account/$ref HTTP/1.1
Accept: application/json
OData-MaxVersion: 4.0
OData-Version: 4.0

응답
어느 쪽이든 성공적인 응답의 경우 204 상태를 갖습니다.
```
HTTP/1.1 204 No Content
OData-Version: 4.0
```

단일 값 탐색 속성의 참조 변경

다음 패턴으로 PUT 요청을 사용하여 단일 값 탐색 속성의 값을 설정하면 엔터티를 연결할 수 있습니다.

요청

PUT cc_WebAPI_ServiceURI/opportunities(00000000-0000-0000-0000-000000000001)/customerid_account/$ref HTTP/1.1
Content-Type: application/json
Accept: application/json
OData-MaxVersion: 4.0
OData-Version: 4.0

{
 "@odata.id":"cc_WebAPI_ServiceURI/accounts(00000000-0000-0000-0000-000000000002)"
}

응답

HTTP/1.1 204 No Content
OData-Version: 4.0

만들 때 엔터티 연결

한 번 작업으로 관련 엔터티를 만듭니다.에 설명된 대로 깊은 삽입을 사용하여 관계와 함께 새 엔터티를 만들 수 있습니다.

업데이트 시 엔터티 연결

기본 업데이트에서 설명된 것과 동일한 Message를 사용하여 업데이트 시 엔터티를 연결할 수 있지만, 단일 값 탐색 속성의 값을 설정하려면 @odata.bind 주석을 사용해야 합니다. 다음 예제에서는 customerid_account 단일 값 탐색 속성을 사용하여 영업 기회에 연결된 거래처를 변경합니다.

요청

PATCH cc_WebAPI_ServiceURI/opportunities(00000000-0000-0000-0000-000000000001) HTTP/1.1
Content-Type: application/json
Accept: application/json
OData-MaxVersion: 4.0
OData-Version: 4.0

{
 "customerid_account@odata.bind":"cc_WebAPI_ServiceURI/accounts(00000000-0000-0000-0000-000000000002)"
}

응답

HTTP/1.1 204 No Content
OData-Version: 4.0

참고 항목

Microsoft Dynamics 365

다음을 통해 공유

웹 API를 사용하여 엔터티 연결 및 연결 해제

이 항목의 내용

컬렉션 값 탐색 속성에 대한 참조를 추가합니다.

엔터티에 대한 참조 삭제

단일 값 탐색 속성의 참조 변경

만들 때 엔터티 연결

업데이트 시 엔터티 연결

참고 항목

추가 리소스