---

បង្កើតកំណត់ត្រា

ការប្រែប្រួល createTodo អនុញ្ញាតឱ្យអ្នកបង្កើតកំណត់ត្រាថ្មីនៅក្នុង Blue ជាមួយជម្រើសកំណត់កម្រិតទូលំទូលាយរួមមានវាលកំណត់ផ្ទាល់ខ្លួន, ស្លាក, ការបែងចែក, និងអ្វីៗផ្សេងទៀត។ កំណត់ត្រាអាចត្រូវបានបង្កើតនៅក្នុងបញ្ជីជាក់លាក់ឬត្រូវបានដាក់ដោយស្វ័យប្រវត្តិនៅក្នុងបញ្ជីលំនាំដើម។

ឧទាហរណ៍មូលដ្ឋាន

បង្កើតកំណត់ត្រាដែលមានតែចំណងជើង៖

mutation CreateRecord {
  createTodo(
    input: {
      title: "New Task"
    }
  ) {
    id
    title
    position
  }
}

ឧទាហរណ៍កម្រិតខ្ពស់

បង្កើតកំណត់ត្រាមួយដែលមានជម្រើសទាំងអស់ដែលអាចប្រើបាន៖

mutation CreateRecordAdvanced {
  createTodo(
    input: {
      todoListId: "clm4n8qwx000008l0g4oxdqn7"
      title: "Product Launch Planning"
      placement: TOP
      description: "<p>Complete product launch preparation including marketing materials and documentation.</p>"
      startedAt: "2025-01-15T09:00:00Z"
      duedAt: "2025-02-01T17:00:00Z"
      notify: true
      assigneeIds: ["user_123", "user_456"]
      tags: [
        { id: "tag_existing_123" }
        { title: "Priority", color: "#ff4b4b" }
        { title: "Marketing" }
      ]
      customFields: [
        {
          customFieldId: "cf_budget_123"
          value: "50000 USD"
        }
        {
          customFieldId: "cf_status_456"
          value: "In Progress"
        }
      ]
      checklists: [
        {
          title: "Pre-launch Checklist"
          position: 1
        }
      ]
    }
  ) {
    id
    uid
    title
    position
    startedAt
    duedAt
    todoList {
      id
      title
    }
    users {
      id
      fullName
    }
    tags {
      id
      title
      color
    }
  }
}

ប៉ារ៉ាម៉ែត្រ​ចូល

CreateTodoInput

ប៉ារ៉ាម៉ែត្រ	ប្រភេទ	ត្រូវការទេ	ការពិពណ៌នា
todoListId	String	ទេ	អត្តសញ្ញាណនៃបញ្ជី todo ដែលត្រូវបន្ថែមកំណត់ត្រាទៅ។ ប្រសិនបើមិនបានផ្តល់, ប្រើបញ្ជី todo ដំបូងក្នុងគម្រោង
title	String!	✅ បាទ	ចំណងជើងនៃកំណត់ត្រា (ត្រូវការ)
position	Float	ទេ	ទីតាំងផ្ទាល់ខ្លួនក្នុងបញ្ជី។ ប្រសិនបើមិនបានផ្តល់, ប្រើប៉ារ៉ាម៉ែត្រដាក់
placement	CreateTodoInputPlacement	ទេ	កន្លែងដាក់កំណត់ត្រា ប្រសិនបើទីតាំងមិនបានបញ្ជាក់ (កំពូល ឬ ក្រោម)
startedAt	DateTime	ទេ	ថ្ងៃ/ម៉ោងចាប់ផ្តើមសម្រាប់កំណត់ត្រា
duedAt	DateTime	ទេ	ថ្ងៃ/ម៉ោងកំណត់សម្រាប់កំណត់ត្រា
notify	Boolean	ទេ	ថាតើត្រូវផ្ញើការជូនដំណឹងសម្រាប់ការបង្កើតកំណត់ត្រានេះ
description	String	ទេ	មាតិកាការពិពណ៌នាអេចស្ដ្រ (នឹងត្រូវបានសម្អាត)
assigneeIds	[String!]	ទេ	អារេនៃអត្តសញ្ញាណអ្នកប្រើដែលត្រូវបានបែងចែកទៅកាន់កំណត់ត្រានេះ
checklists	[CreateChecklistWithoutTodoInput!]	ទេ	អារេនៃបញ្ជីពិនិត្យដែលត្រូវបង្កើតជាមួយកំណត់ត្រា
customFields	[CreateTodoInputCustomField]	ទេ	អារេនៃតម្លៃវាលផ្ទាល់ខ្លួន
tags	[CreateTodoTagInput!]	ទេ	អារេនៃស្លាកដែលត្រូវភ្ជាប់ទៅកាន់កំណត់ត្រា

តម្លៃ CreateTodoInputPlacement

តម្លៃ	ការពិពណ៌នា
TOP	ដាក់នៅកំពូលនៃបញ្ជី (ទីតាំងខ្ពស់បំផុត)
BOTTOM	ដាក់នៅក្រោមនៃបញ្ជី (ទីតាំងទាបបំផុត)

CreateTodoTagInput

ប៉ារ៉ាម៉ែត្រ	ប្រភេទ	ត្រូវការទេ	ការពិពណ៌នា
id	String	ទេ*	អត្តសញ្ញាណនៃស្លាកដែលមានស្រាប់ដើម្បីភ្ជាប់
title	String	ទេ*	ចំណងជើងនៃស្លាក (បង្កើតថ្មីប្រសិនបើមិនមាន)
color	String	ទេ	ពណ៌ Hex សម្រាប់ស្លាកថ្មី (លំនាំដើមគឺ #4a9fff)

*កំណត់ចំណាំ: អ្នកត្រូវផ្តល់ឬ id (សម្រាប់ស្លាកដែលមានស្រាប់) ឬ title (ដើម្បីបង្កើត/ស្វែងរកតាមចំណងជើង)

CreateTodoInputCustomField

ប៉ារ៉ាម៉ែត្រ	ប្រភេទ	ត្រូវការទេ	ការពិពណ៌នា
customFieldId	String	ទេ	អត្តសញ្ញាណនៃវាលផ្ទាល់ខ្លួន
value	String	ទេ	តម្លៃសម្រាប់វាលផ្ទាល់ខ្លួន (សូមមើលមាគ៌ាផ្នែកខាងក្រោម)

CreateChecklistWithoutTodoInput

ប៉ារ៉ាម៉ែត្រ	ប្រភេទ	ត្រូវការទេ	ការពិពណ៌នា
title	String!	✅ បាទ	ចំណងជើងនៃបញ្ជីពិនិត្យ
position	Float	ទេ	ទីតាំងនៃបញ្ជីពិនិត្យក្នុងកំណត់ត្រា

ទ្រង់ទ្រាយតម្លៃវាលផ្ទាល់ខ្លួន

នៅពេលកំណត់តម្លៃវាលផ្ទាល់ខ្លួន, ប្រើទ្រង់ទ្រាយទាំងនេះផ្អែកលើប្រភេទវាល៖

ប្រភេទវាល	ទ្រង់ទ្រាយ	ឧទាហរណ៍
CHECKBOX	"true", "1", or "checked" for checked	"true"
COUNTRY	Country name or ISO code	"United States" or "US"
CURRENCY	Amount with optional currency	"50000 USD"
DATE	YYYY-MM-DD or date range	"2025-01-15" or "2025-01-15,2025-01-20"
NUMBER	Numeric value	"42"
PERCENT	Numeric value (% optional)	"75" or "75%"
RATING	Numeric value within range	"4" (if max is 5)
PHONE	International phone format	"+1234567890"
SELECT_SINGLE	Custom field option ID	"option_123"
SELECT_MULTI	Comma-separated option IDs	"option_1,option_2"
LOCATION	Latitude,longitude	"40.7128,-74.0060"
EMAIL	Valid email address	"user@example.com"
URL	Valid URL	"https://example.com"
TEXT	Plain text value	"Any text content"

វាលឆ្លើយតប

ការប្រែប្រួលនឹងត្រឡប់មកវិញវត្ថុ Todo ជាមួយពត៌មានលម្អិតនៃកំណត់ត្រាទូលំទូលាយ៖

វាល	ប្រភេទ	ការពិពណ៌នា
id	String!	អត្តសញ្ញាណឯកតាសម្រាប់កំណត់ត្រា
uid	String!	អត្តសញ្ញាណឯកតាផ្សេងទៀត
title	String!	ចំណងជើងកំណត់ត្រា
position	Float!	ទីតាំងក្នុងបញ្ជី
done	Boolean!	ស្ថានភាពបញ្ចប់
startedAt	DateTime	ថ្ងៃ/ម៉ោងចាប់ផ្តើម
duedAt	DateTime	ថ្ងៃ/ម៉ោងកំណត់
todoList	TodoList	ព័ត៌មានលម្អិតនៃបញ្ជី todo ដែលភ្ជាប់
users	[User!]	អ្នកប្រើដែលត្រូវបានបែងចែក
tags	[Tag!]	ស្លាកដែលភ្ជាប់
checklists	[Checklist!]	បញ្ជីពិនិត្យដែលភ្ជាប់
customFields	[CustomFieldValue!]	តម្លៃវាលផ្ទាល់ខ្លួន

អាជ្ញាប័ណ្ណដែលត្រូវការ

អ្នកប្រើត្រូវតែមានការចូលប្រើគម្រោងសមស្របដើម្បីបង្កើតកំណត់ត្រា៖

កម្រិតចូល	អាចបង្កើតកំណត់ត្រា
OWNER	✅ បាទ
ADMIN	✅ បាទ
MEMBER	✅ បាទ
CLIENT	✅ បាទ
COMMENT_ONLY	❌ ទេ
VIEW_ONLY	❌ ទេ

ការប្រែប្រួលត្រូវការមាតិកាកម្រិតចូលគម្រោងរបស់អ្នកគឺ OWNER, ADMIN, MEMBER, ឬ CLIENT។ អ្នកប្រើដែលមានតួនាទី VIEW_ONLY ឬ COMMENT_ONLY មិនអាចបង្កើតកំណត់ត្រាបានទេ។

ចម្លើយកំហុស

ProjectNotFoundError

{
  "errors": [{
    "message": "Project was not found.",
    "extensions": {
      "code": "PROJECT_NOT_FOUND"
    }
  }]
}

ពេល: មិនមានបរិបទគម្រោងសម្រាប់អ្នកប្រើ។

TodoListCreateTodoLimitError

{
  "errors": [{
    "message": "Todo list has reached the maximum number of todos.",
    "extensions": {
      "code": "TODO_LIST_CREATE_TODO_LIMIT_ERROR"
    }
  }]
}

ពេល: បញ្ជី todo មានកំណត់ត្រា ១០០,០០០ កំណត់ (កម្រិតអតិបរិមា)។

TodoListNotFoundError

{
  "errors": [{
    "message": "Todo list was not found.",
    "extensions": {
      "code": "TODO_LIST_NOT_FOUND"
    }
  }]
}

ពេល: todoListId ដែលបានបញ្ជាក់មិនមានឬអ្នកប្រើមិនមានការចូលប្រើ។

CustomFieldValueParseError

{
  "errors": [{
    "message": "Invalid phone number format",
    "extensions": {
      "code": "CUSTOM_FIELD_VALUE_PARSE_ERROR"
    }
  }]
}

ពេល: តម្លៃវាលផ្ទាល់ខ្លួនមិនអាចផ្ទៀងផ្ទាត់បាន (ឧ. លេខទូរស័ព្ទមិនត្រឹមត្រូវ, ការវាយតម្លៃនៅក្រៅកម្រិត)។

កំណត់ចំណាំសំខាន់

ប្រសិទ្ធភាព

• បញ្ជី todo មួយអាចមានកំណត់ត្រាដល់ ១០០,០០០ កំណត់ត្រា
• ការបង្កើតកំណត់ត្រាធ្វើឱ្យមានដំណើរការផ្ទាំងខាងក្រោយជាច្រើន (webhooks, automations, search indexing)
• ការប្រតិបត្តិការប្រមូលគ្នាមានប្រសិទ្ធភាពជាងការបង្កើតកំណត់ត្រាដោយមួយម្តង

តុល្យភាពអាជីវកម្ម

• ការដោះស្រាយទីតាំង: ទីតាំងលំនាំដើមគឺ 65535.0 នៅពេលដែលមិនមាន position ឬ placement បានបញ្ជាក់
• តុល្យភាពថ្ងៃ:
  • ប្រសិនបើមានតែ duedAt ត្រូវបានផ្តល់, startedAt ត្រូវបានកំណត់ទៅដើមនៃថ្ងៃនោះ
  • ប្រសិនបើមានតែ startedAt ត្រូវបានផ្តល់, duedAt ត្រូវបានកំណត់ទៅតម្លៃដដែល
• ការបង្កើតស្លាក: ស្លាកថ្មីត្រូវបានបង្កើតដោយស្វ័យប្រវត្តិប្រសិនបើពួកវាមិនមានជាមួយចំណងជើង/ពណ៌ដែលបានបញ្ជាក់
• ការជ្រើសរើសបញ្ជី: ប្រសិនបើមិនមាន todoListId បានផ្តល់, បញ្ជី todo ដំបូងក្នុងគម្រោងត្រូវបានប្រើ

ផលប៉ះពាល់

ការបង្កើតកំណត់ត្រាធ្វើឱ្យមាន៖

• ការបង្កើតការចុះបញ្ជីសកម្មភាព
• ការជូនដំណឹង webhook
• ការអាប់ដេតស្វ័យប្រវត្តិនៃស្វែងរក
• ការអនុវត្តន៍ច្បាប់ស្វ័យប្រវត្តិ (ប្រសិនបើបានកំណត់)
• ការជូនដំណឹងតាមអ៊ីមែល/ច្រក (ប្រសិនបើ notify: true)
• ការគណនាវាលផ្ទាល់ខ្លួននិងរយៈពេល
• ការអ្នកវិភាគនិងការអាប់ដេតក្រាហ្វិក

ចំណុចចុងក្រោយដែលទាក់ទង

• បញ្ជីកំណត់ត្រា: ស្វែងរក todos ដើម្បីទាញយកកំណត់ត្រាដែលមានស្រាប់
• អាប់ដេតកំណត់ត្រា: ប្រើការប្រែប្រួល updateTodo ដើម្បីកែប្រែកំណត់ត្រា
• បញ្ជីវាលផ្ទាល់ខ្លួន: ស្វែងរកដើម្បីទទួលបានអត្តសញ្ញាណវាលផ្ទាល់ខ្លួនដែលមានស្រាប់
• បញ្ជីស្លាក: ស្វែងរកដើម្បីទទួលបានអត្តសញ្ញាណស្លាកដែលមានស្រាប់
• បញ្ជីបញ្ជី Todo: ស្វែងរកដើម្បីទទួលបានអត្តសញ្ញាណបញ្ជី todo ដែលមានស្រាប់