43.17. Composite SObject Collections 사용
SObject Collections API는 하나의 요청에서 여러 레코드에서 작업을 실행합니다. sObject Collections를 사용하여 클라이언트와 서버 간의 왕복 수를 줄입니다. 전체 요청은 API 제한에 대한 단일 호출로 계산됩니다. 이 리소스는 API 버전 42.0 이상에서 사용할 수 있습니다. 이러한 작업에 제공된 SObject
레코드(DTO)는 AbstractDescribedSObjectBase
의 하위 클래스 인스턴스여야 합니다. 이러한 DTO 클래스 생성에 대한 자세한 내용은 Maven 플러그인 섹션을 참조하십시오. 이러한 작업은 직렬화에서 DTO를 JSON에 제공했습니다.
43.17.1. compositeRetrieveSObjectCollections 링크 복사링크가 클립보드에 복사되었습니다!
동일한 오브젝트 유형의 레코드를 하나 이상 검색합니다.
매개변수 | 유형 | 설명 | Default | 필수 항목 |
---|---|---|---|---|
ID | 문자열 또는 쉼표로 구분된 문자열 목록 | 반환할 오브젝트의 하나 이상의 ID 목록입니다. 모든 ID는 동일한 오브젝트 유형에 속해야 합니다. | x | |
필드 | 문자열 또는 쉼표로 구분된 문자열 목록 | 응답에 포함할 필드 목록입니다. 지정한 필드 이름이 유효해야 하며 각 필드에 대한 읽기 수준 권한이 있어야 합니다. | x | |
sObjectName | 문자열 |
SObject 유형(예: | x | |
sObjectClass | 문자열 | 응답을 역직렬화하는 데 사용할 DTO 클래스의 정규화된 클래스 이름입니다. |
|
43.17.2. compositeCreateSObjectCollections 링크 복사링크가 클립보드에 복사되었습니다!
최대 200개의 레코드를 추가하고 SaveSObjectResult 오브젝트 목록을 반환합니다. 혼합 SObject 유형이 지원됩니다.
매개변수 | 유형 | 설명 | Default | 필수 항목 |
---|---|---|---|---|
요청 본문 |
| 생성할 SObject 목록 | x | |
allOrNone | boolean | 오브젝트 생성이 실패할 때 전체 요청을 롤백할지(true) 요청에서 다른 오브젝트를 독립적으로 생성할지 여부를 나타냅니다. | false |
43.17.3. compositeUpdateSObjectCollections 링크 복사링크가 클립보드에 복사되었습니다!
최대 200개의 레코드를 업데이트하여 SaveSObjectResult 오브젝트 목록을 반환합니다. 혼합 SObject 유형이 지원됩니다.
매개변수 | 유형 | 설명 | Default | 필수 항목 |
---|---|---|---|---|
요청 본문 |
| 업데이트할 SObject 목록 | x | |
allOrNone | boolean | 오브젝트 업데이트가 실패할 때 전체 요청을 롤백할지(true) 요청에서 다른 오브젝트의 독립적인 업데이트를 계속할지 여부를 나타냅니다. | false |
43.17.4. compositeUpsertSObjectCollections 링크 복사링크가 클립보드에 복사되었습니다!
외부 ID 필드를 기반으로 최대 200개의 레코드를 생성하거나 업데이트하여 UpsertSObjectResult 오브젝트 목록을 반환합니다. 혼합 SObject 유형은 지원되지 않습니다.
매개변수 | 유형 | 설명 | Default | 필수 항목 |
---|---|---|---|---|
요청 본문 |
| upsert 까지의 SObject 목록 | x | |
allOrNone | boolean | 개체의 upsert가 실패할 때 전체 요청을 롤백할지(true) 요청에서 다른 오브젝트의 독립 upsert를 계속할지 여부를 나타냅니다. | false | |
sObjectName | 문자열 |
SObject 유형(예: | x | |
sObjectIdName | 문자열 | 외부 ID 필드의 이름 | x |
43.17.5. compositeDeleteSObjectCollections 링크 복사링크가 클립보드에 복사되었습니다!
최대 200개의 레코드를 삭제하여 DeleteSObjectResult 오브젝트 목록을 반환합니다. 혼합 SObject 유형이 지원됩니다.
매개변수 | 유형 | 설명 | Default | 필수 항목 |
---|---|---|---|---|
| 문자열 또는 쉼표로 구분된 문자열 목록 | 삭제할 오브젝트 ID 최대 200개의 ID 목록입니다. | x | |
| boolean | 오브젝트 삭제가 실패할 때 전체 요청을 롤백할지(true) 요청에서 다른 오브젝트의 독립적인 삭제 여부를 나타냅니다. | false |