Buat salinan dari rekaman yang ada sambil mempertahankan elemen data tertentu.
Salin Rekaman
Untuk membuat salinan dari rekaman yang ada sambil mempertahankan elemen tertentu, gunakan mutasi 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
]
}
)
}
Header yang Diperlukan
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"
Parameter Input
Field | Type | Required | Deskripsi |
---|---|---|---|
title | String | Tidak | Judul baru untuk rekaman yang disalin (opsional) |
todoId | String | Ya | ID dari rekaman yang akan disalin |
todoListId | String | Ya | ID dari daftar untuk membuat salinan |
options | Array | Ya | Elemen data yang disalin dari rekaman asli |
Opsi Salin
Array options
menerima nilai-nilai berikut:
Opsi | Deskripsi |
---|---|
DESCRIPTION | Menyalin deskripsi rekaman |
DUE_DATE | Menyalin tanggal jatuh tempo dan zona waktu |
CHECKLISTS | Menyalin semua checklist dan itemnya |
ASSIGNEES | Menyalin semua pengguna yang ditugaskan (difilter berdasarkan keanggotaan proyek target) |
TAGS | Menyalin semua tag yang terkait |
CUSTOM_FIELDS | Menyalin semua nilai field kustom (termasuk lampiran file) |
COMMENTS | Menyalin semua komentar dan balasan |
Contoh Respons
{
"data": {
"copyTodo": true
}
}
Rekaman yang disalin akan ditempatkan di bagian bawah daftar target secara default. Untuk mengontrol penempatan, gunakan [mutasi pindah rekaman](/api/records/move-record-list).
Anda memerlukan izin Edit (peran OWNER, ADMIN, atau MEMBER) pada proyek sumber dan target. Catatan: Pengguna dengan peran MEMBER hanya dapat menyalin rekaman dalam proyek yang sama. Penyalinan antar proyek memerlukan izin ADMIN atau OWNER. Salinan yang gagal akan mengembalikan kode kesalahan `FORBIDDEN`.
Penanganan Kesalahan
Kode kesalahan umum untuk operasi ini:
TODO_NOT_FOUND
: todoId tidak valid atau tidak dapat diaksesTODO_LIST_NOT_FOUND
: todoListId tidak valid atau tidak dapat diaksesFORBIDDEN
: Izin tidak mencukupi atau pembatasan antar proyek
Lihat Kode Kesalahan untuk referensi lengkap.
Fitur Lanjutan
Penyalinan Antar Proyek
Mutasi mendukung penyalinan rekaman antara proyek yang berbeda dengan pertimbangan berikut:
- OWNER/ADMIN: Dapat menyalin rekaman di semua proyek yang mereka akses
- MEMBER: Terbatas pada penyalinan hanya dalam proyek yang sama
- Penyaringan Penugasan: Saat menyalin antar proyek, penugasan secara otomatis difilter untuk hanya menyertakan pengguna yang memiliki akses ke proyek target
Penanganan Field Kustom
Saat menggunakan opsi CUSTOM_FIELDS
:
- Semua nilai field kustom disalin ke rekaman baru
- Lampiran file dalam field kustom diduplikasi dengan referensi penyimpanan baru
- Tipe field kustom dipertahankan dan divalidasi terhadap konfigurasi proyek target
Integrasi Automasi
Penyalinan antar proyek dapat memicu aturan automasi tambahan di proyek sumber dan target, memungkinkan manajemen alur kerja yang canggih di seluruh batas proyek.