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
  }
}
Penempatan Salinan

Rekaman yang disalin akan ditempatkan di bagian bawah daftar target secara default. Untuk mengontrol penempatan, gunakan [mutasi pindah rekaman](/api/records/move-record-list).
Izin yang Diperlukan

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 diakses
  • TODO_LIST_NOT_FOUND: todoListId tidak valid atau tidak dapat diakses
  • FORBIDDEN: 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.

Asisten AI

Respon dihasilkan menggunakan AI dan mungkin mengandung kesalahan.

Bagaimana saya bisa membantu Anda?

Tanyakan apa saja tentang Blue atau dokumentasi ini.

Masukkan untuk mengirim • Shift+Masukkan untuk baris baru • ⌘I untuk membuka