다음을 통해 공유

Xrm.WebApi.online.executeMultiple(클라이언트 API 참조)

작업, 함수 또는 CRUD 작업의 컬렉션을 실행합니다.

비고

이 메서드는 온라인 모드(Xrm.WebApi.online)에 대해서만 지원됩니다.

트랜잭션에서 여러 요청을 실행하려면 변경 집합을 이 메서드에 매개 변수로 전달해야 합니다. 변경 집합 은 트랜잭션에서 실행되는 작업의 컬렉션을 나타냅니다. 개별 요청과 변경 집합을 이 메서드의 매개 변수로 함께 전달할 수도 있습니다.

비고

  • 변경 집합의 일부로 읽기 작업(여러 함수 검색, 검색 및 Web API 함수)을 포함할 수 없습니다. OData v4 사양에 따라 다릅니다.
  • 요청에는 최대 1,000개의 개별 요청이 포함될 수 있으며 다른 일괄 처리를 포함할 수 없습니다. 추가 정보: 일괄 처리 작업을 실행합니다.

Syntax

여러 요청을 실행합니다.

var requests = [req1, req2, req3];
Xrm.WebApi.online.executeMultiple(requests).then(successCallback, errorCallback);

트랜잭션에서 여러 요청을 실행합니다.

이 경우 req1트랜잭션에서 실행됩니다req2req3.

var changeSet = [req1, req2, req3];
var requests = [changeSet];
Xrm.WebApi.online.executeMultiple(requests).then(successCallback, errorCallback);

트랜잭션에서 개별 요청과 여러 요청을 혼합하여 실행합니다.

이 경우 req1트랜잭션 req2req3 에서 실행되지만 req4req5 개별적으로 실행됩니다.

var changeSet = [req1, req2, req3];
var requests = [req4, req5, changeset];
Xrm.WebApi.online.executeMultiple(requests).then(successCallback, errorCallback);

매개 변수

이름 유형 필수 Description
requests 객체 배열 Yes 다음 형식 중 하나의 배열입니다.

각 개체가 Web API 엔드포인트에 대해 실행하려는 작업, 함수 또는 CRUD 요청인 개체입니다. 각 개체는 실행할 작업, 함수 또는 CRUD 요청에 대한 메타데이터를 정의할 수 있는 getMetadata 메서드 를 노출합니다. execute 메서드는 이러한 유형의 매개 변수를 허용합니다.

변경 집합 의 각 개체가 앞에서 설명한 대로 변경 집합(개체 배열)입니다. 이 경우 변경 집합에 지정된 모든 요청 개체가 트랜잭션에서 실행됩니다.

구문 섹션에서 요청 예제를 찾습니다.
successCallback 기능 아니오 작업이 성공적으로 실행될 때 호출할 함수입니다. 응답 개체의 배열이 함수에 전달됩니다. 반환 값 참조
errorCallback 기능 아니오 작업이 실패할 때 호출하는 함수입니다. 다음 속성을 가진 개체가 전달됩니다.
- errorCode:수. 오류 코드는 양의 10진수입니다. 예를 들어 문서화된 오류 코드는 다음과 같이 0x800403332147746611반환됩니다.
- message:문자열. 문제를 설명하는 오류 메시지입니다.

반환 값

성공하면 개체 배열이 포함된 프라미스를 반환합니다 successCallback. 개체에는 다음과 같은 속성이 있습니다.

이름 유형 필수 Description
json 약속 아니오 JSON 형식의 응답 본문입니다.
text 약속 아니오 일반 텍스트 형식의 응답 본문입니다.
headers Object Yes 응답 헤더입니다.
ok 불리언 (Boolean) Yes 요청이 성공했는지 여부를 나타냅니다.
status Number Yes 응답 상태 코드의 숫자 값입니다. 예: 200
statusText String Yes 응답 상태 코드에 대한 설명입니다. 예: OK
type String Yes 응답 유형입니다. 값은 빈 문자열(기본값), arraybuffer, blob, documentjson및 text.
url String Yes Web API 엔드포인트로 전송된 작업, 함수 또는 CRUD 요청의 요청 URL입니다.

Xrm.WebApi

  • Last updated on