---

Ikhtisar Template

Blue mendukung dua jenis template:

• Template Perusahaan: Dibuat oleh organisasi Anda untuk penggunaan internal
• Template Resmi: Dibuat oleh Blue untuk semua pengguna (template standar industri)

Template mempertahankan seluruh struktur proyek termasuk todo, daftar, bidang kustom, automasi, dan banyak lagi.

Daftar Template

Menggunakan Query template

query GetTemplates {
  templates(
    companyId: "company-123"
    isOfficialTemplate: false
    category: MARKETING
  ) {
    id
    name
    description
    category
    isOfficialTemplate
    icon
    color
    image {
      thumbnail
      small
    }
  }
}

Menggunakan projectList dengan Filter Template

query ListTemplates {
  projectList(
    filter: {
      companyIds: ["company-id"]
      isTemplate: true
    }
    sort: [updatedAt_DESC]
    take: 20
    skip: 0
  ) {
    items {
      id
      slug
      name
      description
      category
      isTemplate
      isOfficialTemplate
      color
      icon
      createdAt
      updatedAt
    }
    pageInfo {
      hasNextPage
      totalItems
    }
    totalCount
  }
}

Buat Proyek dari Template

Untuk membuat proyek baru dari template yang ada:

mutation CreateFromTemplate {
  createProject(
    input: {
      templateId: "template-id-or-slug"
      name: "Q1 Marketing Campaign"
      companyId: "company-id"
      description: "Marketing initiatives for Q1"
      color: "#10B981"
    }
  ) {
    id
    name
    slug
  }
}

Konversi Proyek ke Template

Ubah proyek yang ada menjadi template yang dapat digunakan kembali:

mutation ConvertToTemplate {
  convertProjectToTemplate(
    input: {
      projectId: "project-123"
      isOfficialTemplate: false
    }
  ) {
    id
    name
    isTemplate
    isOfficialTemplate
  }
}

Hapus Status Template

Ubah template kembali menjadi proyek biasa:

mutation RemoveTemplateStatus {
  removeProjectFromTemplates(projectId: "template-123") {
    id
    name
    isTemplate
  }
}

Dapatkan Template Tunggal

Ambil detail tentang template tertentu:

query GetTemplate {
  template(templateId: "template-123") {
    id
    name
    description
    category
    isOfficialTemplate
    todoLists {
      name
      todos {
        title
      }
    }
  }
}

Parameter Query

Query templates

Parameter	Tipe	Diperlukan	Deskripsi
companyId	String	Tidak	Filter template berdasarkan perusahaan. Hilangkan untuk melihat template resmi.
isOfficialTemplate	Boolean	Tidak	Tampilkan hanya template resmi Blue
category	ProjectCategory	Tidak	Filter berdasarkan kategori proyek

Input convertProjectToTemplate

Parameter	Tipe	Diperlukan	Deskripsi
projectId	String!	✅ Ya	Proyek yang akan diubah menjadi template
isOfficialTemplate	Boolean!	✅ Ya	Tandai sebagai template resmi (hanya untuk karyawan Blue)

Kategori Template

Nilai	Deskripsi
CRM	Manajemen Hubungan Pelanggan
CROSS_FUNCTIONAL	Proyek tim lintas fungsi
CUSTOMER_SUCCESS	Inisiatif keberhasilan pelanggan
DESIGN	Proyek desain dan kreatif
ENGINEERING	Rekayasa dan pengembangan
GENERAL	Proyek umum (default)
HR	Sumber Daya Manusia
IT	Teknologi Informasi
MARKETING	Kampanye pemasaran
OPERATIONS	Operasi dan logistik
PRODUCT	Manajemen produk
SALES	Penjualan dan pengembangan bisnis

Apa yang Disalin dari Template

Saat membuat proyek dari template, yang disalin adalah:

• ✅ Struktur: Semua daftar todo dan todo dengan posisinya
• ✅ Konten: Deskripsi, komentar, dan lampiran
• ✅ Organisasi: Tag, label, dan bidang kustom
• ✅ Automasi: Semua aturan dan alur kerja automasi
• ✅ Formulir: Formulir proyek dan konfigurasinya
• ✅ Dokumen: Halaman wiki dan dokumentasi
• ✅ Pengaturan: Konfigurasi sampul dan preferensi tampilan
• ✅ Peran: Definisi peran pengguna (tetapi tidak penugasan pengguna)

Tidak disalin:

• ❌ Penugasan pengguna (kecuali pencipta)
• ❌ Riwayat aktivitas
• ❌ Data pelacakan waktu
• ❌ Status selesai dari todo

Izin yang Diperlukan

Membuat Template

Tindakan	Peran yang Diperlukan
Convert project to template	Project OWNER or ADMIN
Create official template	Blue employee only
Remove template status	Project OWNER or ADMIN

Menggunakan Template

Tipe Template	Siapa yang Bisa Menggunakan
Company templates	Users in the same company
Official templates	All Blue users

Respon Kesalahan

Template Tidak Ditemukan

{
  "errors": [{
    "message": "Template not found",
    "extensions": {
      "code": "TEMPLATE_NOT_FOUND"
    }
  }]
}

Terlalu Banyak Todos

{
  "errors": [{
    "message": "This project has more than 250,000 todos and cannot be used as a template",
    "extensions": {
      "code": "TOO_MANY_TODOS"
    }
  }]
}

Catatan Penting

• Batas Ukuran: Proyek dengan lebih dari 250.000 todo tidak dapat digunakan sebagai template
• Penyalinan Asinkron: Konten template disalin di latar belakang melalui antrean pekerjaan
• Status Arsip: Mengonversi ke template secara otomatis menghapus arsip proyek
• Penghapusan Folder: Template dihapus dari folder saat dikonversi
• Kontrol Akses: Template resmi terlihat oleh semua, template perusahaan hanya untuk anggota
• Pembaruan Waktu Nyata: Berlangganan perubahan template menggunakan langganan subscribeToProject