ការបង្កើតគម្រោងដោយប្រើ Blue API។


បង្កើតគម្រោងថ្មី

ដើម្បីបង្កើតគម្រោងថ្មី អ្នកអាចប្រើ mutation ខាងក្រោម៖

mutation {
  createProject(
    input: {
      name: "YOUR PROJECT NEW NAME"
      companyId: "YOUR COMPANY ID OR SLUG"
      description: "Project description"
      color: "#3B82F6"
      icon: "briefcase"
      category: GENERAL
    }
  ) {
    id
    name
    slug
    description
    color
    icon
    category
  }
}
icon: lightbulb

ចូរចងចាំថាត្រូវបញ្ចូលក្បាលដែលត្រូវការនៅក្នុងការស្នើសុំរបស់អ្នក៖

- `X-Bloo-Token-ID`: អត្តសញ្ញាណ API token របស់អ្នក
- `X-Bloo-Token-Secret`: សម្ងាត់ API token របស់អ្នក
- `X-Bloo-Company-ID`: អត្តសញ្ញាណក្រុមហ៊ុនរបស់អ្នក
- `Content-Type: application/json`

ឧទាហរណ៍នៃការឆ្លើយតប

នៅពេលជោគជ័យ mutation នឹងត្រឡប់មកវិញព័ត៌មានលម្អិតនៃគម្រោងដែលបានបង្កើតថ្មី៖

{
  "data": {
    "createProject": {
      "id": "newly-created-project-id",
      "name": "YOUR PROJECT NEW NAME",
      "slug": "your-project-new-name",
      "description": "Project description",
      "color": "#3B82F6",
      "icon": "briefcase",
      "category": "GENERAL"
    }
  }
}

បង្កើតពីគំរូ

ដើម្បីបង្កើតគម្រោងពីគំរូដែលមានស្រាប់ អ្នកអាចបន្ថែម templateId ដែលជាជម្រើសទៅក្នុង mutation ។

mutation {
  createProject(
    input: {
      templateId: "YOUR TEMPLATE ID OR SLUG"
      name: "YOUR PROJECT NEW NAME"
      companyId: "YOUR COMPANY ID OR SLUG"
    }
  ) {
    id
  }
}
ការបង្កើតគម្រោងពីគំរូនឹងមិនបង្កើតគម្រោងភ្លាមៗទេ។ ផ្ទុយទៅវិញ ការបង្កើតគម្រោងរបស់អ្នកនឹងត្រូវបានដាក់ក្នុងបញ្ជីរង់ចាំ។

ឧទាហរណ៍កម្រិតខ្ពស់ជាមួយគំរូ

នេះគឺជាឧទាហរណ៍ពេញលេញដែលបង្ហាញជម្រើសទាំងអស់ដែលមាននៅពេលបង្កើតពីគំរូ៖

mutation {
  createProject(
    input: {
      templateId: "marketing-template"
      name: "Q1 Marketing Campaign"
      companyId: "acme-corp"
      description: "Marketing initiatives for Q1 2024"
      color: "#10B981"
      icon: "megaphone"
      category: MARKETING
      coverConfig: {
        enabled: true
        fit: COVER
        imageSelectionType: FIRST
        source: DESCRIPTION
      }
    }
  ) {
    id
    name
    slug
    description
    color
    icon
    category
  }
}
icon: warning
ពាក្យបញ្ជា `coverConfig` បច្ចុប្បន្ននេះគ្រាន់តែអាចប្រើបាននៅពេលបង្កើតគម្រោងពីគំរូ។ សម្រាប់គម្រោងដែលបានបង្កើតពីសូន្យ អ្នកត្រូវការប្រើ mutation `editProject` បន្ទាប់ពីការបង្កើតដើម្បីកំណត់រូបភាពគ្រប់គ្រាន់។

ពិនិត្យស្ថានភាពការបង្កើត

ដើម្បីពិនិត្យស្ថានភាពនៃការបង្កើតគម្រោងរបស់អ្នកនៅក្នុងបញ្ជីរង់ចាំ អ្នកអាចប្រើសំណើខាងក្រោម៖

query {
  copyProjectStatus {
    newProjectName
    isTemplate
    isActive
    queuePosition
    totalQueues
  }
}

សំណើនេះនឹងត្រឡប់មកវិញស្ថានភាពនៃការបង្កើតគម្រោងរបស់អ្នកនៅក្នុងបញ្ជីរង់ចាំ។

ប៉ារ៉ាម៉ែត្រ Input

CreateProjectInput

ប៉ារ៉ាម៉ែត្រ ប្រភេទ ត្រូវការ ការពិពណ៌នា
name String ✅ បាទ ឈ្មោះគម្រោង។ URL នឹងត្រូវបានដកចេញពីឈ្មោះ។
companyId String ✅ បាទ អត្តសញ្ញាណឬ slug របស់ក្រុមហ៊ុនដែលគម្រោងនឹងត្រូវបានបង្កើត។
description String មិនត្រូវការ ការពិពណ៌នាអំពីគម្រោង។
color String មិនត្រូវការ ពណ៌គម្រោងនៅក្នុងរូបមន្ត hex (ឧ. "#3B82F6")។
icon String មិនត្រូវការ អត្តសញ្ញាណរូបភាពសម្រាប់គម្រោង (ឧ. "briefcase", "rocket")។
category ProjectCategory មិនត្រូវការ ប្រភេទគម្រោង។ ត្រូវតែជាប្រភេទ GENERAL ប្រសិនបើមិនបានបញ្ជាក់។
templateId String មិនត្រូវការ អត្តសញ្ញាណនៃគម្រោងដែលមានស្រាប់ដើម្បីប្រើជាគំរូ។
coverConfig TodoCoverConfigInput មិនត្រូវការ ការកំណត់សម្រាប់រូបភាពគ្រប់គ្រាន់ (បច្ចុប្បន្ននេះគ្រាន់តែអាចប្រើបានជាមួយការបង្កើតដោយគំរូ)។

តម្លៃ ProjectCategory

តម្លៃ ការពិពណ៌នា
CRM គម្រោងគ្រប់គ្រងទំនាក់ទំនងអតិថិជន
CROSS_FUNCTIONAL គម្រោងក្រុមចម្រុះ
CUSTOMER_SUCCESS យុទ្ធនាការជោគជ័យអតិថិជន
DESIGN គម្រោងរចនា និងច្នៃប្រឌិត
ENGINEERING គម្រោងវិស្វកម្ម និងអភិវឌ្ឍន៍
GENERAL គម្រោងទូទៅ (លំនាំដើម)
HR គម្រោងធនធានមនុស្ស
IT គម្រោងព័ត៌មានវិទ្យា
MARKETING យុទ្ធនាការនិងការប្រកួតផ្សព្វផ្សាយ
OPERATIONS គម្រោងប្រតិបត្តិការ និងលូកស្តុក
PRODUCT គម្រោងគ្រប់គ្រងផលិតផល
SALES គម្រោងលក់ និងអភិវឌ្ឍន៍អាជីវកម្ម

TodoCoverConfigInput

ប្រសិនបើអ្នកចង់កំណត់របៀបដែលរូបភាពគ្រប់គ្រាន់ធ្វើការនៅក្នុងគម្រោងរបស់អ្នក អ្នកអាចផ្តល់ជូននូវប៉ារ៉ាម៉ែត្រ coverConfig:

ប៉ារ៉ាម៉ែត្រ ប្រភេទ ត្រូវការ ការពិពណ៌នា
enabled Boolean ✅ បាទ តើរូបភាពគ្រប់គ្រាន់ត្រូវបានបើកសម្រាប់ todo ឬអត់
fit ImageFit ✅ បាទ របៀបដែលរូបភាពគួរតែសមស្របនៅក្នុងតំបន់គ្រប់គ្រាន់
imageSelectionType ImageSelectionType ✅ បាទ រូបភាពណាដែលត្រូវជ្រើសរើសពីជម្រើសដែលមាន
source ImageSource ✅ បាទ កន្លែងដែលត្រូវយករូបភាព
sourceId String មិនត្រូវការ អត្តសញ្ញាណប្រភពជាក់លាក់ (ឧ. អត្តសញ្ញាណវាលផ្ទាល់ខ្លួន)

តម្លៃ ImageFit: COVER, CONTAIN, FILL, SCALE_DOWN

តម្លៃ ImageSelectionType: FIRST (រូបភាពដំបូង), LAST (រូបភាពចុងក្រោយ)

តម្លៃ ImageSource: DESCRIPTION (ពីការពិពណ៌នាអំពី todo), COMMENTS (ពីមតិយោបល់), CUSTOM_FIELD (ពីវាលផ្ទាល់ខ្លួន)

វាលត្រឡប់

mutation createProject នឹងត្រឡប់មកវិញវត្ថុគម្រោងដែលមានវាលដែលអាចប្រើបានខាងក្រោម៖

វាល ប្រភេទ ការពិពណ៌នា
id ID! អត្តសញ្ញាណឯកតាសម្រាប់គម្រោង
name String! ឈ្មោះគម្រោង
slug String! អត្តសញ្ញាណគម្រោងដែលសមស្របសម្រាប់ URL
description String ការពិពណ៌នាគម្រោង
color String ពណ៌គម្រោងនៅក្នុងរូបមន្ត hex
icon String អត្តសញ្ញាណរូបភាព
category ProjectCategory តម្លៃ enum ប្រភេទគម្រោង
companyId String! អត្តសញ្ញាណនៃក្រុមហ៊ុន
createdAt DateTime! ម៉ោងបង្កើត
updatedAt DateTime! ម៉ោងធ្វើបច្ចុប្បន្នភាពចុងក្រោយ
archived Boolean! តើគម្រោងត្រូវបានបញ្ជីឈប់ប្រើឬអត់
isTemplate Boolean! តើនេះជាគម្រោងគំរូឬអត់

ចំណាំ៖ អ្នកអាចស្នើសុំការបញ្ចូលគ្នារវាងវាលទាំងនេះក្នុងការឆ្លើយតបរបស់អ្នក។

ចំណាំសំខាន់

  • អ្នកត្រូវតែមាន OWNER, ADMIN, ឬ MEMBER កម្រិតចូលដំណើរការទៅក្រុមហ៊ុនដើម្បីបង្កើតគម្រោង
  • នៅពេលបង្កើតពីគំរូ គំរូមិនអាចមានចំនួន todo ឡើងលើ 250,000
  • អ្នកប្រើប្រាស់ដែលបង្កើតត្រូវបានកំណត់ជាអ្នក OWNER នៃគម្រោង
  • ឈ្មោះគម្រោងត្រូវបានកាត់ចេញពីសន្លឹកទទេដោយស្វ័យប្រវត្តិ
  • ប៉ារ៉ាម៉ែត្រ coverConfig បច្ចុប្បន្ននេះគ្រាន់តែអាចប្រើបាននៅពេលបង្កើតពីគំរូ

ការឆ្លើយតបកំហុស

ក្រុមហ៊ុនមិនបានរកឃើញ

{
  "errors": [{
    "message": "Company not found",
    "extensions": {
      "code": "NOT_FOUND"
    }
  }]
}

គំរូមិនបានរកឃើញ

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

គំរូធំលើស

{
  "errors": [{
    "message": "Template cannot have more than 250000 todos",
    "extensions": {
      "code": "VALIDATION_ERROR"
    }
  }]
}

អនុញ្ញាតមិនត្រូវបានអនុញ្ញាត

{
  "errors": [{
    "message": "You do not have permission to create projects in this company",
    "extensions": {
      "code": "FORBIDDEN"
    }
  }]
}

ជំនួយក្រុមហ៊ុន AI

ការឆ្លើយតបត្រូវបានបង្កើតឡើងដោយប្រើ AI ហើយអាចមានកំហុស។

ខ្ញុំអាចជួយអ្នកបានយ៉ាងដូចម្តេច?

សូមសួរអ្វីក៏បានអំពី Blue ឬឯកសារនេះ។

ចូលដើម្បីផ្ញើ • Shift+Enter សម្រាប់បន្ទាត់ថ្មី • ⌘I ដើម្បីបើក