특정 데이터 요소를 유지하면서 기존 레코드의 복사본을 만듭니다.
레코드 복사
기존 레코드의 복사본을 만들면서 특정 요소를 유지하려면 copyTodo
변이를 사용하세요:
mutation CopyTodo {
copyTodo(
input: {
title: "new todo"
todoId: "todo-id"
todoListId: "todo-list-id"
options: [
DESCRIPTION
DUE_DATE
CHECKLISTS
ASSIGNEES
TAGS
CUSTOM_FIELDS
COMMENTS
]
}
)
}
필수 헤더
x-bloo-token-id: "your-token-id"
x-bloo-token-secret: "your-token-secret"
x-bloo-project-id: "project-id-or-slug"
x-bloo-company-id: "company-id-or-slug"
입력 매개변수
필드 | 유형 | 필수 | 설명 |
---|---|---|---|
title | String | 아니요 | 복사된 레코드의 새 제목 (선택 사항) |
todoId | String | 예 | 복사할 레코드의 ID |
todoListId | String | 예 | 복사본을 생성할 목록의 ID |
options | Array | 예 | 원본 레코드에서 복사할 데이터 요소 |
복사 옵션
options
배열은 다음 값을 허용합니다:
옵션 | 설명 |
---|---|
DESCRIPTION | 레코드의 설명을 복사합니다 |
DUE_DATE | 마감일과 시간대를 복사합니다 |
CHECKLISTS | 모든 체크리스트와 항목을 복사합니다 |
ASSIGNEES | 모든 할당된 사용자를 복사합니다 (대상 프로젝트 멤버십에 따라 필터링됨) |
TAGS | 모든 관련 태그를 복사합니다 |
CUSTOM_FIELDS | 모든 사용자 정의 필드 값을 복사합니다 (파일 첨부 포함) |
COMMENTS | 모든 댓글과 답글을 복사합니다 |
예제 응답
{
"data": {
"copyTodo": true
}
}
복사 위치
복사된 레코드는 기본적으로 대상 목록의 맨 아래에 배치됩니다. 위치를 제어하려면 [레코드 이동 변이](/api/records/move-record-list)를 사용하세요.
복사된 레코드는 기본적으로 대상 목록의 맨 아래에 배치됩니다. 위치를 제어하려면 [레코드 이동 변이](/api/records/move-record-list)를 사용하세요.
필수 권한
소스 및 대상 프로젝트 모두에서 편집 권한 (소유자, 관리자 또는 구성원 역할)이 필요합니다. 참고: 구성원 역할 사용자는 동일한 프로젝트 내에서만 레코드를 복사할 수 있습니다. 프로젝트 간 복사는 관리자 또는 소유자 권한이 필요합니다. 복사 실패 시 `FORBIDDEN` 오류 코드가 반환됩니다.
소스 및 대상 프로젝트 모두에서 편집 권한 (소유자, 관리자 또는 구성원 역할)이 필요합니다. 참고: 구성원 역할 사용자는 동일한 프로젝트 내에서만 레코드를 복사할 수 있습니다. 프로젝트 간 복사는 관리자 또는 소유자 권한이 필요합니다. 복사 실패 시 `FORBIDDEN` 오류 코드가 반환됩니다.
오류 처리
이 작업에 대한 일반적인 오류 코드:
TODO_NOT_FOUND
: 유효하지 않거나 접근할 수 없는 todoIdTODO_LIST_NOT_FOUND
: 유효하지 않거나 접근할 수 없는 todoListIdFORBIDDEN
: 권한 부족 또는 프로젝트 간 제한
자세한 내용은 오류 코드를 참조하세요.
고급 기능
프로젝트 간 복사
이 변이는 다음과 같은 고려 사항으로 서로 다른 프로젝트 간에 레코드를 복사하는 것을 지원합니다:
- 소유자/관리자: 접근할 수 있는 모든 프로젝트 간에 레코드를 복사할 수 있습니다.
- 구성원: 동일한 프로젝트 내에서만 복사가 제한됩니다.
- 담당자 필터링: 프로젝트 간 복사 시, 담당자는 자동으로 필터링되어 대상 프로젝트에 접근할 수 있는 사용자만 포함됩니다.
사용자 정의 필드 처리
CUSTOM_FIELDS
옵션을 사용할 때:
- 모든 사용자 정의 필드 값이 새 레코드로 복사됩니다.
- 사용자 정의 필드의 파일 첨부가 새로운 저장 참조와 함께 적절하게 복제됩니다.
- 사용자 정의 필드 유형은 보존되며 대상 프로젝트의 구성에 대해 검증됩니다.
자동화 통합
프로젝트 간 복사는 소스 및 대상 프로젝트 모두에서 추가 자동화 규칙을 트리거할 수 있어 프로젝트 경계를 넘어 복잡한 워크플로우 관리를 가능하게 합니다.