ការបង្កើតគម្រោងដោយប្រើ 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
}
}
ចូរចងចាំថាត្រូវបញ្ចូលក្បាលដែលត្រូវការនៅក្នុងការស្នើសុំរបស់អ្នក៖
- `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
}
}
ពាក្យបញ្ជា `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"
}
}]
}